Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Âncora
_GoBack
_GoBack
Image RemovedSynthesis Director



Image Added



DIRECTOR - Manual de Integración 1.0


Manual de

...

Integración SD Server – SD Agent

...



Painel
borderColor#E4E3E3
bgColor#ffffff
titleColor#ffffff
borderWidth1px
titleBGColor#704581
titleREVISIONES


Expandir
titleExpandir revisiones


Fecha

Versión

Cambios – Motivo

21/02/2017

1.0

Creación del documento

22/02/2017

1.1

Agregación del apartado Tipos de Operación

23/02/2017

1.2

Agregación del parámetro dbbackup en la operación Install

08/03/2017

1.3

Agregación de los ACK en las operaciones de Update e Install
Modificación de los códigos en los Anexos

10/03/2017

1.4

Agregación de campos en las respuestas de SD Agent sobre el sistema de la terminal

18/05/2017

1.5

Se agregó el manejo de scripts por changeSetID

22/05/2016

1.6

Re-estructuración de contenido
Agregado de integración con maven

08/08/2017

1.7

Eliminación de mensaje "status" del DirectorServer al agente.
Agregado de compañía, tienda y terminal en mensajes de "update" e "install"

16/08/2017

1.8

Agregado de:

  • HTTPS
  • Utilización de token en la mensajería entre agente y server
  • Referencia a clases que representan la mensajería
  • Pasaje de datos enviados en URL al BODY del POST en formato JSON

08/09/2017

1.9

Soporte Base de datos Hyper Sonic

05/10/2017

1.10

Agregado de explicación de archivo "ignore.txt"

22/03/20181.11

Agregado de propiedad agentVersion para indicar la versión del agente
Explicación de uso de comando status

...




Painel
borderColor#E4E3E3
titleColor#ffffff
borderWidth1
titleBGColor#704581
titleCONTENIDO


Expandir
titleExpandir contenido
Índice
styledist


1. Introducción

1.1 Acerca de este documento

...

Nota

Notas:

  • Para Microsoft SQL Server se usa como fin de comando la sentencia GO
  • Para Oracle se usa como fin de comando el carácter ";" o bien el formato de Stored Procedure
  • Para Hyper Sonic se usa como fin de comando el carácter ";"
  • Todos los comandos SQL dentro de un ChangetSet se ejecutan dentro de una transacción SQL. Si una sentencia falla se hará Rollback. Se debe notar que las capacidades de Rollback serán dadas por el motor de base de datos utizado. Por ejemplo, no en todos los motores de BBDD funciona un rollback de un comando ALTER TABLE.

...

  • TABLE.



Se adjuntan ejemplos tanto para MSSQLServer, Oracle y Hyper Sonic:

View file
namehsqldb-sql-store.sql
height250
View file
namemssql-sql-store.sql
height250
View file
nameoracle-sql-store.sql
height250


  • Iniciar la solución

El agente ejecuta el shell script indicado en el parámetro application.command.start

...

  
ColecciónCampoDescripción


companyId

Id de la compañía del retail. Se carga por configuración 


listeningPort

Puerto de la terminal donde se encuentra el SD Agent. Se carga por configuración 


date

Fecha y hora de envío. Formato aaaammddHHmmssSUTC, donde S es el símbolo positivo o negativo y UTC es el huso horario en formato hhmm 


deviceType

Categoría de la terminal. Se carga por configuración 


terminalId

Terminal de la tienda de la compañía del retail. Se carga por configuración 


storeId

Id de la tienda de la compañía del retail. Se carga por configuración 


host

Nombre de la terminal donde se encuentra el SD Agent 


ip

IP de la terminal donde se encuentra el SD Agent


agentVersionIndica la versión de software del agente


token

Un token que luego Director Server usará para enviar los comandos hacia el agente.
Sirve principalmente como medida adicional de seguridad.
Se aconseja renovar el token cada X cantidad de tiempo (12hs por ejemplo) o cada X cantidad de mensajes. 


tokenExp

Fecha y hora de expiración del token. Formato aaaammddHHmmssSUTC, donde S es el símbolo positivo o negativo y UTC es el huso horario en formato hhmm

product

status

Informa el estado de SD Agent. Ver tabla 6.1.1 Códigos de Estado de SD Agent 


detail

Mensaje adicional y detallado de la tarea 


appIsRunning

Informa si el Producto STS está en funcionamiento o está detenido. Valores posibles: true/false. El chequeo es según el Producto STS. Ejemplo, chequeo de puerto, control de proceso en ejecución, etc 


taskUUID

Identificador de la tarea enviado por SD Server.
Solo se envía cuando el mensaje de status representa el estado de ejecución de una tarea, en ese caso se debe utilizar el taskUUID que el SD Server envió originalmente. 


taskStatus

Informa el código del estado de la tarea. Ver tabla 6.1.3 Códigos de Estado de Tarea
Solo se envía cuando 


task

Código de la tarea. Ver tabla 6.1.2 Códigos de Tarea 


version

Versión del Producto STS. Si no se efectúo previamente una instalación se envía 0 


code

Código del Producto STS. Se carga por configuración 


description

Descripción del Producto STS. Se carga por configuración 


isAlivePort

Chequeo del puerto para POS. Se encuentra en desuso 


lastInstall

Fecha y hora de la última instalación del Producto STS. Formato aaaammddHHmmssSUTC, donde S es el símbolo positivo o negativo y UTC es el huso horario en formato hhmm. En caso de que nunca se haya instalado una versión, se envía el formato estándar 19700101 


lastUpdate

Fecha y hora de la última sincronización del Producto STS. Formato aaaammddHHmmssSUTC, donde S es el símbolo positivo o negativo y UTC es el huso horario en formato hhmm. En caso de que nunca se haya sincronizado una versión, se envía el formato estándar 19700101 


synchronizedVersion

Informa la última versión sincronizada del Producto STS 


free memory

Memoria libre (en Bytes) en la terminal, reportada por la JVM Oracle

info

measureunit

Unidad de medida que se informan los valores. Por defecto en Bytes 


free disk

Disco libre (en Bytes) en la terminal, de la unidad donde se ejecuta el agente 


total memory

Capacidad total de memoria (en Bytes) en la terminal, reportada por la JVM Oracle 


total disk

Capacidad total del disco (en Bytes) en la terminal, de la unidad donde se ejecuta el agente 


java.version

Versión de Java RuntimeEnvironment 


java.vendor

Proveedor de Java RuntimeEnvironment 


java.arch

Tamaño de la plataforma 


os.name

Nombre del sistema operativo 


os.version

Versión del sistema operativo 


os.arch

Arquitectura del sistema operativo 


Otros valores del tipo "clave-valor"

Estos valores serán procesados por director server e incluidos como información adicional de la terminal.

Las claves aquí utilizadas deberán ser dadas de alta en la BBDD de Director para poder mostrarlas correctamente en la consola de monitoreo.

La "clave" debe seguir el siguiente formato.

IdGrupo.NombrePropiedad donde

IdGrupo permite agrupar las propiedades según algun criterio de agrupación (hardware, sistema, etc)
NombrePropiedad es el nombre de la propiedad que se quiere visualizar

Ejemplo:
"bridgePOS.logged.user":"SUSER"
"promo.map.version":"1.0"

 

 

 




Detalle del uso del “Status”

...

  1. Periódicamente cada X cantidad de tiempo para informar el estado del agente, de la aplicación, etc. En este caso y a modo aclaratorio
    1. status”, siempre enviar 00, indicando que el agente está disponible.
    2. taskUUID”, en blanco porque no hay tarea
    3. task”, en blanco porque no hay tarea
    4. taskStatus”, en blanco porque no hay tarea
    5. detail”, en blanco porque no hay tarea, o bien, una descripción que simplemente se podrá apreciar en el log de DirectorServer
  2. Cuando el DirectorServer solicitó realizar una acción (sincronizar o actualizar). Cada acción supone la ejecución de una serie de pasos o tareas. Entonces se espera que la ejecución de cada tarea implique enviar un mensaje al servidor para indicar el estado de ejecución de dicha a tarea. Los datos obligatorios en éste caso son:
    1. “status”, para indicar si está sincronización o actualizando
    2. “taskUUID”, para indicar el ID de la tarea. Este dato lo envió previamente el server.
    3. “task”, para indicar que tarea se está realizando. Ej: deteniendo app, haciendo backup, etc
    4. “taskStatus”, para indicar el estado de ejecución de la tarea antes idnicada.
    5. “detail”, para dar más detalle de la tarea. Ej: si dio error, entonces indicar una descripción del error. Si no hay error, por ejemplo info de un directorio, de una tarea, etc. En todos los caso, el mismo se mostrará en consola

...


Parte del mensaje de status

...


Error indicado por agente al instalar

...