Desarrollar dentro de Sage X3 nunca fue tan sencillo

POR QUÉ Sage X3 CON AELIS

Recursos gratuitos propios

Ponemos todos nuestros recursos a disposición del cliente:
  • Comunicación continua (Te mantenemos informado de todas las actualizaciones y cambios legislativos sobre tu producto)
  • Webinars
  • Vídeos de procedimientos
  • Manuales de Producto
  • Portal eLearning
  • Formaciones gratuitas
  • Campus Sage

Ecosistema de integración

 

Diferentes ecosistemas de integración

Tanto estándares actuales como nuevas tecnologías:

Guías para desarrolladores (Web pública)

Sage pone a disposición del público su web para desarrolladores donde encontrarán toda la información necesaria para autogestionarse su integración:

Integración Simplificada

Distintos tipos de API para adecuarse a distintas necesidades y requisitos​:

Constante evolución Tecnológica

Actualizaciones cada vez más sencillas y en menor tiempo

A través de:

Un nuevo sistema de parches acumulativos

 Ayudaremos a nuestros clientes a estar al día siempre con la última versión:

  • Tener la última tecnología por razones de rendimiento y seguridad.
  • Cumplir con las últimas regulaciones y requisitos legales.
  • Simplificar actualizaciones de específicos y personalizaciones.
  • Realizar cambios oportunos para la evolución del negocio.
  • Entrega de un único archivo de parches para ir a la última versión.

Una Plataforma de Testeo Automático (ATP)

Conseguiremos:

Mejorar la calidad, reducir costes y tiempo:

  • Simplifica las actualizaciones y configuraciones de Sage X3.
  • Cubre más escenarios.
  • Amplia la capacidad de pruebas minimizando las pruebas manuales para evitar errores.
  • Proporciona monitoreo continuo de los sistemas ERP ayudando a encontrar y resolver problemas.
  • Soporta actualizaciones continuas regulares.
  • Automatiza la gestión de la calidad incluyendo pruebas de regresión completas.
  • Simplifica la entrega de correcciones cuando sea necesario.
  • Ayudar a BPs a agilizar testeos de funcionalidad, verticales y específicos.
Aumentar la eficiencia:

  • Libera recursos para pruebas de procesos manuales y repetitivos.
  • Mejora la motivación y eficacia del probador.
  • Pruebas de usuario enfocadas a tareas críticas para el negocio.
  • Automatiza tareas de pruebas regulares y mundanas.
  • Optimiza el tiempo de revisión para disminuir tiempos de parada.
  • Identifica conflictos con específicos y optimizar las actualizaciones.

 

Alianzas tecnológicas al día

GESTOR DE IMPORTACIONES/EXPORTACIONES

X3 proporciona una infraestructura integral para respaldar las importaciones y exportaciones. Las plantillas, los objetos y los datos se combinan para brindar acceso a la aplicación de una manera simple pero flexible.

Las importaciones y exportaciones se rigen por plantillas , que definen la interfaz entre un objeto y el mundo exterior. Se describen los campos y tablas de datos, junto con información sobre la estructura de los datos externos.

A través de las plantillas, los datos se pueden enviar a un objeto X3. Un objeto se define mediante un grupo de tablas y pantallas, así como la lógica empresarial estándar asociada con los campos y la actualización, incluidas las reglas de entrada y la validación. Representan la entidad completa y se utilizan en X3 para proporcionar una definición coherente para la entrada, desde la interfaz de usuario hasta la importación.

Hay dos formas de transmitir datos para importaciones y exportaciones:

Los archivos de datos brindan la capacidad de entregar grandes cantidades de datos para ser procesados ​​en una sola sesión.

El flujo general de importación / exportación de archivos se puede describir mediante los siguientes pasos:

1.Determine la ubicación del archivo.

2.Seleccione un objeto.

3.Defina una plantilla.

4.Configure los datos para la transcripción, si es necesario.

5.Importe o exporte los datos.

 

Los servicios web se pueden utilizar para transmitir cargas útiles más pequeñas con mucha frecuencia, proporcionando una integración más directa.

WEB SERVICES (SOAP)

Se proporcionan servicios web SOAP estándar para gestionar estas operaciones. Utilizan los grupos de conexiones del servicio web SOAP estándar y se pueden llamar desde cualquier programa que pueda:
  • Conéctese al servidor de servicios web SOAP integrado en la plataforma X3.
  • Autenticarse con los métodos de autenticación disponibles.
  • Envíe un mensaje SOAP normalizado como se indica en la guía del servicio web SOAP y reciba la respuesta.
Los servicios web SOAP utilizados son subprogramas asociados con los servicios web. Sus nombres son los siguientes:

Realizar una importación

El servicio web de importación contiene los siguientes argumentos:

Los parámetros enviados son:
  • El código de la plantilla ( BPC por ejemplo)
  • Una bandera de almacenamiento temporal de importación / exportación (  o NO ) para enviar las líneas erróneas en el espacio de almacenamiento temporal de importación / exportación
  • Una matriz de criterios (filtros expresados ​​en lenguaje X3 como: BPCSTA = 1 )
  • Una bandera de ejecución ( REALTIME o BATCH )
  • Un carácter utilizado como separador de registros en el feed de datos devuelto.

 

Obtener información sobre una tarea por lotes

Después de realizar una importación o exportación con la opción LOTE, se puede consultar el estado del trabajo del servidor por lotes con este servicio web.

Este servicio web contiene los siguientes argumentos:

Los parámetros enviados son:
  • El tipo de tarea por lotes ( IMPORTAR EXPORTAR)
  • El ID de solicitud devuelto por el servicio web de importación o exportación por lotes (12345 por ejemplo)
  • Una banderaNO) para obtener el archivo de registro devuelto
Los parámetros de SOAP devueltos son:
  • El estado (1 = OK, 0 = errores)
  • El archivo de registro producido por la exportación como una matriz de una estructura que contiene un estado (1 = advertencia, 3 = error) y el mensaje de texto correspondiente.
Los valores devueltos son:
  • Un valor numérico que contiene el estado de la tarea con los siguientes valores:

Ø1 = en espera

Ø2 = En curso

Ø3 = Terminado

Ø4 = En espera

Ø5 = Muerto

Ø6 = cancelado

Ø7 = Error

Ø8 = Vencido

Ø9 = Advertencia

  • Un texto que contiene el mensaje correspondiente (en espera, en curso, etc.)
  • Un clob que contiene el archivo devuelto si el tipo es EXPORTAR y si la tarea finaliza con o sin errores o advertencias.
  • Un clob que contiene el archivo de seguimiento si se solicitó.
  • El estado del servicio web (0 = OK, de lo contrario es un error)
  • Un mensaje si ocurrió un error.

GRAPHQL API

Un servicio fácil de usar, seguro y altamente funcional para crear integraciones de aplicaciones con capacidad de respuesta en tiempo real.

Visión general

GraphQL, un lenguaje para ejecutar consultas y modificar datos. Es nuestra tecnología preferida para crear API y permitir el desarrollo de aplicaciones integradas de Sage X3.

Elegimos GraphQL porque consideramos que ofrece más flexibilidad a la comunidad de desarrolladores de Sage X3 que otras arquitecturas API, por ejemplo:
  • Cuando envía una consulta GraphQL a la API web de Sage X3, obtendrá exactamente lo que solicita, ni más ni menos.
  • Mientras que las API REST típicas necesitarían acceso a varias URL, la API web Sage X3 le permite obtener todos los datos que necesita en una sola solicitud, desde un punto final.
  • GraphQL nos permite hacer evolucionar la API sin versiones: se pueden agregar nuevos campos sin romper las consultas existentes, y los campos redundantes pueden quedar obsoletos y ocultos.

Recursos

SageX3 dispone de 4 guías interactivas publicas, para facilitar el acceso a la información y su integración con terceros a sus clientes:

API DE INTEGRACION DE DATOS (REST)

La API de integración de datos está diseñada para funcionar solo con la configuración de nube X3 de múltiples inquilinos. Los siguientes recursos y guías están destinados a proporcionar una referencia rápida para que los desarrolladores intercambien datos con este tipo de configuración a través de API Gateway.

Un medio simple y seguro de almacenar y compartir archivos para controlar el intercambio secuencial de datos a intervalos definidos.

Visión general

Nuestra API de integración de datos basada en REST permite a los desarrolladores automatizar la infraestructura existente de importación / exportación de archivos X3, al facilitar el transporte seguro de archivos de datos.

Al proporcionar un medio simple de almacenar y compartir archivos para controlar el intercambio secuencial de datos a intervalos definidos, la API es ideal para administrar trabajos de importación de lotes pequeños y operaciones de integración de datos a gran escala.

¿Cómo funciona?

Importación de datos a X3 

  • La API carga archivos de datos a un punto final seguro
  • Los archivos se validan, verifican los virus y se descargan automáticamente a la carpeta de importación de X3

Exportación de datos desde X3

    • Los datos se exportan a archivos en la carpeta de exportación X3
    • El proceso de sincronización carga los archivos exportados a un punto final seguro
    • Las API enumeran, descargan y eliminan archivos exportados desde el punto final

Herramientas que utiliza

API de Autenticación

Aplicación de Muestra

Para ayudar a comenzar rápidamente con el desarrollo de su propia aplicación, proporcionamos una aplicación de muestra que cubre las llamadas API básicas de integración de datos a la aplicación X3.

En esta sección, creará una aplicación simple usando Node.js que cargará un archivo a una configuración X3 y descargará un archivo exportado por una configuración X3:

FAQ´s

¿Qué es un dossier en X3?

Un dossier es una estructura que almacena datos relacionados con un conjunto de empresas dispuestas a compartir las mismas tablas comunes (socios comerciales, productos) y tener la capacidad de crear informes agregando los datos de grupos de empresas con consultas a la base de datos en un solo esquema. Se implementa como un usuario de base de datos único con un conjunto de tablas que almacenan parámetros y datos del usuario.

¿Qué es un alcance en la API X3?

Como desarrollador, cuando crea una solicitud de emparejamiento, debe aprobar un Scope. El alcance representa la autorización que se asociará con sus tokens de acceso. Debe incluir la lista de API que desea consumir. En realidad, estas API son:

  • api.dataIngestion
  • api.dataDelivery

Nota: API relacionada con la gestión de tokens, la lista de dossieres no forma parte del alcance, ya que es un requisito para que el desarrollador tenga acceso a ella.

¿Qué pasa con los dossieres?

El usuario final agregará el dossier al alcance en X3. Cuando revisa su solicitud de emparejamiento, selecciona los dossieres X3 con las que desea asociar su token de acceso.

Hay 2 formas de conocer el dossier al que puede acceder una vez que tenga sus tokens:

]1) Revisar el alcance devuelto por la API del token

2) Llamar a la API del dossier, ya que solo los dossieres autorizados serán parte de la respuesta.

¿Qué es un punto final de API regional en X3?

Al final del proceso de emparejamiento, si el punto final de la API regional que está utilizando no está asociado a la configuración del cliente, un parámetro llamado punto final estará presente en la devolución de llamada que le proporciona el código de acceso para convertir en tokens. La aplicación de terceros tiene que usar este punto final para más llamadas en lugar de su punto final de API raíz regional conocido.

¿Por qué la API de integración de datos tiene 2 pasos para subir un archivo?

Nuestra arquitectura en la nube se basa actualmente en Amazon AWS y todos los archivos cargados están en tránsito en los almacenamientos S3 antes de aterrizar en la configuración del cliente X3. Este servicio nos permite cargar un archivo de gran tamaño (350 MB). Es por eso que usamos la URL de carga preestablecida del servicio AWS S3. En el proceso de desarrollo, el desarrollador solo necesita seguir la URL de la primera llamada para encadenar estos 2 pasos.

El segundo paso (utilizando una URL de AWS S3 preestablecida) lo administra AWS S3; luego, la política actual de AWS S3 es que puede cargar el archivo tantas veces como desee durante toda la vida útil de esta URL (1h). La llamada de carga con URL preestablecida siempre devuelve 200 cuando se ejecuta con éxito. Sin embargo, recuerde que la última versión se copiará a la configuración X3.

Es responsabilidad del desarrollador administrar el proceso de carga correctamente (de lo contrario, no hay garantía sobre qué versión se copiará a X3).

Límite máximo de tamaño de archivo para la API de integración de datos

La API de integración de archivos permite que las aplicaciones de terceros carguen archivos en X3. El archivo cargado se analizará en busca de cualquier amenaza de seguridad y se almacenará en el almacenamiento X3 correspondiente. Solo se permiten archivos de texto y su tamaño no puede exceder los 350 MB.

CAPTURAS Sage X3

La plataforma de Sage X3 dispone internamente de tecnologías de integración, sin limite de usuarios ni de transacciones.

 

También de un diccionario de tablas, para facilitar a los integradores y desarrolladores el significado en diferentes idiomas:

De un diccionario de campos, para facilitar a los integradores y desarrolladores el significado en diferentes idiomas

Y de un Asistente de Guías de Importación y Exportación, que facilita la gestión de mapeos y procesos:

¿Quieres saber más?

Pulsa AQUI y descubre Sage X3. el ERP más completo que cubre las necesidades de desarrollo de tu empresa.

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos requeridos están marcados *

Publicar comentario