Diferencia entre revisiones de «PSDelivery»

De ITC Soluciones SA
Ir a la navegación Ir a la búsqueda
imported>Nicolas
imported>Gustavon
 
(No se muestran 2 ediciones intermedias del mismo usuario)
Línea 10: Línea 10:
 
}}
 
}}
  
== PSDelivery Cliente ==
+
== PSDelivery Cliente para Windows OS==
PSDelivery es la pieza de software que permite comunicarse ya sea con un [[Berkana|Servidor Berkana]] o a un [[GEBO|Servidor GEBO]] para enviar la transacción que se desea validar y permite recibir la respuesta de validación en el momento. La función de PSDelivery Cliente es encriptar los archivos y establecer la comunicación que se monta sobre TCP/IP por Internet.
+
 
 +
=== Alcance del Documento ===
 +
 
 +
Los Procedimientos descriptos en el presente documento hacen referencia a: Requerimientos, Instalación y Configuración de '''PSDelivery''' '''para Entornos Windows/Linux.'''
 +
 
 +
== Definición ==
 +
 
 +
'''PSDelivery''' es la pieza de software que permite comunicarse ya sea con un [[Berkana|Servidor Berkana]] o a un [[GEBO|Servidor GEBO]] para enviar la transacción a validar. Permite recibir la respuesta de validación en el momento.
 +
 
 +
Está desarrollado en '''lenguaje JAVA''' por lo cual tiene la ventaja de que '''es multiplataforma''' y puede correr en Sistemas Operativos Windows o Linux.
 +
La comunicación se monta sobre TCP/IP por Internet con archivos encriptados.
  
 
== PSDelivery ==
 
== PSDelivery ==
[[Imagen:PSDeliveryHome.png]]
+
[[Imagen:psdelivery2_home_app.png]]
  
=== Funcionamiento ===
+
En la imagen se muestra un cliente PSDelivery corriendo en Windows OS. La Licencia configurada es CPKCP8K0. Se esperan tx en la carpeta local c:\estandar\tx
El Cliente PSDelivery escucha permanentemente en un directorio o carpeta (Directorio de trabajo), en el cual la aplicación de carga de datos dejará los archivos que se envían para ser validados. Una vez que los archivos son enviados al Financiador, el Cliente PSDelivery se queda a la espera de una respuesta, la cual, al momento de llegar, es entregada a la aplicación del prestador y la muestra y/o imprime.
+
 
 +
=== Requerimientos para la Instalación ===
 +
'''En entornos Windows''', verificar si está instalada alguna versión de Java.
 +
Caso contrario proceder a la descarga e instalación de la última versión desde el sitio oficial.
 +
{| class="wikitable"
 +
|-
 +
! Link de descarga
 +
|-
 +
| https://www.java.com/es/download/ie_manual.jsp
 +
|}
 +
 
 +
'''Observación'''
 +
 
 +
'''En el caso de disponer de una Interfaz Grafica en Linux'''
 +
 
 +
Se procede a instalar desde la consola con el siguiente comando:
 +
{| class="wikitable"
 +
|-
 +
! Comando
 +
|-
 +
| sudo apt install default-jre
 +
|}
 +
 
 +
Si no disponemos de Linux con Interfaz Gráfica, la opción es realizar la Instalación de PSDeliveryFinder bajo Linux
 +
 
 +
== Instalación y Configuración ==
 +
 
 +
=== Instalación ===
 +
El primer paso que debemos realizar es:
 +
* Copiar el contenido de la carpeta de destino PsDelivery  en la ruta C:\Program Files (x86)\ITC Soluciones
 +
 
 +
{| class="wikitable"
 +
|-
 +
! Ejemplo
 +
|-
 +
| C:\Program Files (x86)\ITC Soluciones\PsDelivery2
 +
|}
 +
[[Imagen:carpeta_destino2.png]]
 +
 
 +
=== Configuración ===
 +
Para configurar la aplicación existen dos formas:
 +
 +
a.- '''Desde la consola Windows'''
 +
Ejecutar el siguiente comando en una terminal Windows:
 +
{| class="wikitable"
 +
|-
 +
! Comando en Consola
 +
|-
 +
| java -jar PSDelivery-1.0-0.jar CONFIG
 +
|}
 +
[[Imagen:Config consola win.png]]
 +
 
 +
'''Carpeta de intercambio:''' es la hacia donde van a apuntar las transacciones (es necesario apuntar hasta la carpeta "tx"), ej: "c:\estandar\tx"
  
=== IPs y Puertos ===
+
'''URL TX:''' Es la dirección a donde van a apuntar las transacciones que van a ser procesadas. Al día de hoy la URL en producción es: https://psd.cloud.itcsoluciones.ar/psdeliveryrest/
La comunicación con el validador la realiza el Cliente PSDelivery por Internet e intentará conectarse con:
 
  
IP 200.47.62.201 (data center)<br>
+
'''Licencias''': campo en donde se carga la licencia.
IP 190.15.198.197 (data center de contingencia)<br>
 
  
Y los puertos:
+
Una vez configurado es necesario oprimir el botón "'''Guardar'''" para que los cambios tengan efecto y se guarden en la carpeta de intercambio los archivo .prm y .emp**
  
TCP 8315 u 8316<br>
 
  
El uso de los puertos es solo saliente, por lo que no es necesario que el firewall tenga abierto ningún puerto entrante.
+
b.- '''Otra Forma posible''' para configurar la aplicación en Windows, es Editar el archivo '''config.json''' con un editor de textos dentro del directorio local. La configuración de PSDelivery, en comparación con la de su antecesor [[Sitel_Cliente|Sitel Cliente]], es "libre" en cuanto a los parámetros de Empresa y/o Actividad, como así también de URL/IP y su respectivo Puerto, ya que se pueden modificar manualmente los parámetros con los que deseamos trabajar.
  
== Configuración ==
+
{| class="wikitable"
La configuración de PSDelivery es mediante el archivo '''config.json''', el cual tiene el siguiente formato:
+
|-
 +
! Editar archivo json
 +
|-
 +
| {"intercambio":"C:\\estandar\\tx","empresas":[{"codigo":"11","licencia":"CPKCP8K0","cuit":"30546741253","sigla":"OSDE","uso_csc":"1","nombre":"Organización de Servicios Directos Empresarios"},{"codigo":"26","licencia":"CPKCP8K0","cuit":"30654855168","sigla":"SWISS","uso_csc":"0","nombre":"SWISS MEDICAL S.A."},"url":"https:\/\/psd.cloud.itcsoluciones.ar\/psdeliveryrest","licencias":["CPKCP8K0"]}
 +
|}
  
Ejemplo de '''config.json''': <pre>{"intercambio":"/home/share/data/tx","empresas":[{"codigo":"36","cuit":"30550194283","nombre":"ServeSalud"},{"codigo":"26","cuit":"30654855168","nombre":"SWISS"},{"codigo":"11","cuit":"30546741253","nombre":"OSDE"}],"url":"ws:\/\/valideti.itcsoluciones.com:81\/gebo_m1\/gebo","licencias":["CPKCP8K0","PRUEBA01","PRUEBA00"]}</pre>
+
[[Imagen:editando json.png]]
  
 +
== Ejecución de PSDelivery ==
  
=== Detalle de Configuración (config.json) ===
+
'''Para ejecutar la aplicación bajo Windows, se puede realizar de dos formas:'''
La configuración de PSDelivery, en comparación con la de su antecesor [[Sitel_Cliente|Sitel Cliente]], es "libre" en cuanto a los parámetros de Empresa y/o Actividad, como así también de URL/IP y su respectivo Puerto, ya que se pueden modificar manualmente los parámetros con los que deseamos trabajar.
 
  
<b>intercambio</b>: corresponde al "Directorio de Trabajo", es decir, donde se crearán los directorios "Terminales", lugar donde la aplicación de carga de datos dejará los archivos pertenecientes a la Transacción. Desde ese directorio, PSDelivery tomará los archivos y en ese mismo directorio es donde dejará la respuesta. Siempre se debe posicionar en el directorio que contiene a los subdirectorios TermXX o termXX. Si la unidad donde se encuentra esta estructura de directorios es un servidor de red, se deberá seleccionar la misma. Opera con la metodología "TX", la que permite un manejo más ágil en instalaciones donde hay muchas terminales. Con esta metodología, en lugar de crear una carpeta fija para cada terminal de trabajo, es posible crear terminales con nombres aleatorios, indicar en el directorio ''TX'' el nombre de la terminal creada y destruir la terminal aleatoria al terminal. De esta manera no hay que mantener un árbol de terminales.
+
1-  Ejecutar desde consola el contenido del archivo psdelivery.sh
  
<b>empresas</b>: en este campo se agregan los datos de las empresa que se utilizarán. Como se ve en el ejemplo, los datos de cada Empresa van entre "llaves" y cada dato se separa por "comas". ejemplo: "empresas":[{"codigo":"36","cuit":"30550194283","nombre":"ServeSalud"},{"codigo":"26","cuit":"30654855168","nombre":"SWISS"},{"codigo":"11","cuit":"30546741253","nombre":"OSDE"}]
+
{| class="wikitable"
 +
|-
 +
! Consola Windows
 +
|-
 +
| START javaw -jar -Xms1024m -Xmx1024m PSDelivery-1.0-0.jar
 +
|}
  
<b>url</b>: en este campo se coloca la URL/IP a la que se apunta la transacción.
+
2-  Doble click en el el archivo PSDelivery-1.0-0.jar
  
<b>licencias</b>: aquí se colocan la o las Licencias que se deseen, según el lugar de atención (Usuario) requiera.
+
{| class="wikitable"
 +
|-
 +
! Doble Click
 +
|-
 +
| PSDelivery-1.0-0.jar
 +
|}
  
=== Archivo de LOG ===
+
== Funcionamiento de PSDelivery ==
El archivo de log de PSDelivery es '''psdelivery.log''' y se encuentra dentro del directorio de la Aplicación.
 
  
=== Iniciar PSDelivery ===
+
El Cliente PSDelivery escucha permanentemente en un directorio o carpeta (Directorio de trabajo), en el cual la aplicación de carga de datos dejará los archivos que se envían para ser validados. Una vez que los archivos son enviados al Financiador, el Cliente PSDelivery se queda a la espera de una respuesta, la cual, al momento de llegar, es entregada a la aplicación del prestador y la muestra y/o imprime.
Para poner en ejecución a PSDelivery, debemos correr el script "psdelivery.sh", que se encuentra en el directorio de la Aplicación. De esta manera, se levanta con los parámetros configurados previamente en "config.json" y deja su log en "psdelivery.log".
 
  
=== Hacer una transacción con PSDelivery ===
+
== Visualización del archivo Log de las Tx realizadas ==
Para realizar una Transacción utilizando PSDelivery, se debe colocar el set de archivos en el directorio "upload" de una determinada Terminal y luego el archivo cuyo nombre se corresponde con el de la Terminal en cuestión, en el Directorio "tx". Esto es el "método TX".
 
  
'''Transacción copiando un archivo:'''  
+
Para visualizar el log se utiliza '''Kibana''' que es una interfaz Open-Source para visualizar datos.
#Crear los archivos _svl.0 y cualquier otro que requiera el formato y copiarlos en un directorio '''upload''' por ejemplo '''/home/operador/terms/termZy3UiD/upload/'''
 
#Crear un archivo llamado '''termZy3UiD''' (para el ejemplo) y lo copia en el directorio '''tx''', para el ejemplo, /home/operador/terms/tx/
 
#Poolea el directorio /home/operador/terms/termZy3UiD/ hasta encontrar el archivo [[Estado.rsp|estado.rsp]] (que indicará el resultado de la transacción a nivel de comunicación).
 
#Aplicación procesa la respuesta del directorio '''download''' y elimina los archivos [[Estado.rsp|estado.rsp]] y existentes en el directorio '''download'''
 
  
La estructura de directorio tiene que tener la siguiente forma:
+
El log para acceder visualizar las TXs se llama "'''default'''"
<pre>
 
sitel-+--tx
 
|
 
+--term01
 
| |
 
| +--upload
 
| +--download
 
|
 
+--term02
 
| |
 
| +--upload
 
| +--download
 
...
 
</pre>
 
  
Supongamos que esta estructura se encuentra en /var/samba/sitel. Los directorios de las terminales y sus carpetas pueden crearse dinámicamente, es decir, ser creados y destruidos en cada transacción por la aplicación cliente (esto evita tener que hacer un mantenimiento del mismo generando un directorio para cada terminal). El mecanismo para hacer una transacción es el siguiente:
+
Dentro de la interfaz acceder al menú -> Kibana -> Discover
#La aplicación cliente crea los archivos propios de la transacción en el directorio de "upload" correspondiente a la terminal. Por ejemplo:<br>/var/samba/sitel/term01/upload/_svl.1<br>/var/samba/sitel/term01/upload/_svl.2
 
#La aplicación cliente crea el archivo _svl.0 en el directorio de "upload" correspondiente a la terminal. Por ejemplo:<br>/var/samba/sitel/term01/upload/_svl.0
 
#La aplicación cliente dispara la transacción creando en el directorio tx un archivo (no importa su contenido, puede estar vacío) cuyo nombre sea el nombre del directorio de la terminal. En este ejemplo:<br>/var/samba/sitel/tx/term01
 
#La aplicación cliente espera el resultado de la transacción, esperando a que aparezca el archivo [[Estado.rsp|estado.rsp]] en el directorio de la terminal. Por ejemplo:<br>/var/samba/sitel/term01/estado.rsp
 
#Cuando aparezca el archivo [[Estado.rsp|estado.rsp]] la transacción ha finalizado. Los archivos de respuesta (en caso de haber sido exitosa la comunicación) estarán en el directorio de "download" correspondiente a la terminal. Por ejemplo: /var/samba/sitel/term01/download/.
 
  
Para más detalles sobre la espera del archivo [[Estado.rsp|estado.rsp]] y la forma de interpretar el contenido del archivo [[Estado.rsp|estado.rsp]] [[Homologar#Intercambio_de_Archivos_Planos|consultar aquí]].
+
{| class="wikitable"
 +
|-
 +
! Kibana
 +
|-
 +
| http://192.168.10.181/app/home#/
 +
|}
 +
[[Imagen:Kibana.png]]
  
 
== Bajar PSDelivery ==
 
== Bajar PSDelivery ==

Revisión actual del 19:17 6 abr 2021


SitelCliente Icono.png
Cliente PSDelivery
Release status: estable

Implementación

Aplicación residente

Descripción

App de comunicaciones

Autor(es)

Patricia Arrambide (original), - Marcos Ricco (mantenimiento) - Francisco Louzan (Mantenimiento)

Ultima Versión

3.8.13 (2016-03-03) (Win) Sitel Cliente versionado

Licencia

No necesita licencia

Download

PSDelivery Instalador Completo


PSDelivery Cliente para Windows OS

Alcance del Documento

Los Procedimientos descriptos en el presente documento hacen referencia a: Requerimientos, Instalación y Configuración de PSDelivery para Entornos Windows/Linux.

Definición

PSDelivery es la pieza de software que permite comunicarse ya sea con un Servidor Berkana o a un Servidor GEBO para enviar la transacción a validar. Permite recibir la respuesta de validación en el momento.

Está desarrollado en lenguaje JAVA por lo cual tiene la ventaja de que es multiplataforma y puede correr en Sistemas Operativos Windows o Linux. La comunicación se monta sobre TCP/IP por Internet con archivos encriptados.

PSDelivery

Psdelivery2 home app.png

En la imagen se muestra un cliente PSDelivery corriendo en Windows OS. La Licencia configurada es CPKCP8K0. Se esperan tx en la carpeta local c:\estandar\tx

Requerimientos para la Instalación

En entornos Windows, verificar si está instalada alguna versión de Java. Caso contrario proceder a la descarga e instalación de la última versión desde el sitio oficial.

Link de descarga
https://www.java.com/es/download/ie_manual.jsp

Observación

En el caso de disponer de una Interfaz Grafica en Linux

Se procede a instalar desde la consola con el siguiente comando:

Comando
sudo apt install default-jre

Si no disponemos de Linux con Interfaz Gráfica, la opción es realizar la Instalación de PSDeliveryFinder bajo Linux

Instalación y Configuración

Instalación

El primer paso que debemos realizar es:

  • Copiar el contenido de la carpeta de destino PsDelivery en la ruta C:\Program Files (x86)\ITC Soluciones
Ejemplo
C:\Program Files (x86)\ITC Soluciones\PsDelivery2

Archivo:Carpeta destino2.png

Configuración

Para configurar la aplicación existen dos formas:

a.- Desde la consola Windows Ejecutar el siguiente comando en una terminal Windows:

Comando en Consola
java -jar PSDelivery-1.0-0.jar CONFIG

Config consola win.png

Carpeta de intercambio: es la hacia donde van a apuntar las transacciones (es necesario apuntar hasta la carpeta "tx"), ej: "c:\estandar\tx"

URL TX: Es la dirección a donde van a apuntar las transacciones que van a ser procesadas. Al día de hoy la URL en producción es: https://psd.cloud.itcsoluciones.ar/psdeliveryrest/

Licencias: campo en donde se carga la licencia.

Una vez configurado es necesario oprimir el botón "Guardar" para que los cambios tengan efecto y se guarden en la carpeta de intercambio los archivo .prm y .emp**


b.- Otra Forma posible para configurar la aplicación en Windows, es Editar el archivo config.json con un editor de textos dentro del directorio local. La configuración de PSDelivery, en comparación con la de su antecesor Sitel Cliente, es "libre" en cuanto a los parámetros de Empresa y/o Actividad, como así también de URL/IP y su respectivo Puerto, ya que se pueden modificar manualmente los parámetros con los que deseamos trabajar.

Editar archivo json
{"intercambio":"C:\\estandar\\tx","empresas":[{"codigo":"11","licencia":"CPKCP8K0","cuit":"30546741253","sigla":"OSDE","uso_csc":"1","nombre":"Organización de Servicios Directos Empresarios"},{"codigo":"26","licencia":"CPKCP8K0","cuit":"30654855168","sigla":"SWISS","uso_csc":"0","nombre":"SWISS MEDICAL S.A."},"url":"https:\/\/psd.cloud.itcsoluciones.ar\/psdeliveryrest","licencias":["CPKCP8K0"]}

Editando json.png

Ejecución de PSDelivery

Para ejecutar la aplicación bajo Windows, se puede realizar de dos formas:

1- Ejecutar desde consola el contenido del archivo psdelivery.sh

Consola Windows
START javaw -jar -Xms1024m -Xmx1024m PSDelivery-1.0-0.jar

2- Doble click en el el archivo PSDelivery-1.0-0.jar

Doble Click
PSDelivery-1.0-0.jar

Funcionamiento de PSDelivery

El Cliente PSDelivery escucha permanentemente en un directorio o carpeta (Directorio de trabajo), en el cual la aplicación de carga de datos dejará los archivos que se envían para ser validados. Una vez que los archivos son enviados al Financiador, el Cliente PSDelivery se queda a la espera de una respuesta, la cual, al momento de llegar, es entregada a la aplicación del prestador y la muestra y/o imprime.

Visualización del archivo Log de las Tx realizadas

Para visualizar el log se utiliza Kibana que es una interfaz Open-Source para visualizar datos.

El log para acceder visualizar las TXs se llama "default"

Dentro de la interfaz acceder al menú -> Kibana -> Discover

Kibana
http://192.168.10.181/app/home#/

Kibana.png

Bajar PSDelivery


Ver Manuales Clientes