Conexión Acumatica v2

Introducción

Una conexión de Acumatica, creada usando el conector Acumatica v2, establece acceso a Acumatica. Estas actividades, una vez configuradas, interactúan con Acumatica a través de la conexión.

Crear o editar una conexión de Acumatica

Se crea una nueva conexión de Acumatica v2 utilizando el conector de Acumatica v2 desde una de estas ubicaciones:

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La página Conexiones globales (consulte Crear un extremo global en Conexiones globales).

Se puede editar una conexión Acumatica v2 existente desde estas ubicaciones:

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestaña Componentes del panel Proyecto).
• La página Conexiones globales (vea Editar un extremo global en Conexiones globales)

Configurar una conexión de Acumatica

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de conexión de Acumatica v2.

• Nombre de la conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Acumatica v2 y no debe contener barras diagonales (/) o dos puntos (:) Este nombre también se utiliza para identificar el extremo de Acumatica v2, que se refiere tanto a una conexión específica como a sus actividades.

• URL: Ingrese la URL.

• Esquema de autorización: Seleccione el esquema de autorización, uno de los siguientes:

  • Básico

    • Usuario: Ingrese el usuario.

    • Contraseña: Ingrese la contraseña.

  • OAuth

    • Iniciar OAuth: Seleccione la configuración de OAuth, una de las siguientes:

      • DESACTIVADO

        • Token de acceso OAuth: Ingrese el token de acceso OAuth.

      • REFRESCARSE

      • ACTUALIZACIÓN

        • Token de acceso OAuth: Ingrese el token de acceso OAuth.

    • Id. de cliente OAuth: Ingrese el ID de cliente OAuth.

    • Secreto de cliente OAuth: Ingrese el secreto de cliente OAuth.

    • URL de devolución de llamada: Ingrese la URL de devolución de llamada.

    • Token de actualización de OAuth: Ingrese el token de actualización de OAuth.

  • OAuthImplicit

    • Id. de cliente OAuth: Ingrese el ID de cliente OAuth.

    • Secreto de cliente OAuth: Ingrese el secreto de cliente OAuth.

  • Contraseña OAuth

    • Usuario: Ingrese el usuario.

    • Contraseña: Ingrese la contraseña.

    • Id. de cliente OAuth: Ingrese el ID de cliente OAuth.

    • Secreto de cliente OAuth: Ingrese el secreto de cliente OAuth.

• Esquema: Seleccione el esquema, uno de los siguientes:

  • OData

    • Empresa: Ingrese la empresa.

  • ODataV4

    • Empresa: Ingrese la empresa.

  • DESCANSO

    • Versión del Extremo: Ingrese la versión del extremo. Versiones hasta 24.200.001 son compatibles.

    • Nombre del Extremo: Ingrese el nombre del extremo.

• Usar configuración de proxy: Seleccione para usar configuración de proxy de agente privado.

• Configuraciones avanzadas: Al seleccionar esta opción, se muestra la tabla Propiedades de configuraciones avanzadas, que permite agregar propiedades de configuración adicionales como pares clave-valor.

  • Añadir: Añade una fila a la tabla. Introduce un par clave-valor para cada propiedad.
  • Enviar: Guarda el par clave-valor en la tabla. Visible al pasar el cursor sobre una fila en modo de edición.
  • Descartar: Descarta una nueva fila o cualquier edición realizada en una fila existente. Visible al pasar el cursor sobre una fila en modo de edición.
  • Editar: Permite editar un par clave-valor existente. Visible al pasar el cursor sobre una fila existente.
  • Eliminar: Elimina la fila de la tabla. Visible al pasar el cursor sobre una fila existente.
  • Borrar todo: Elimina todas las filas de la tabla.

  Importante

  Los campos de la tabla Propiedades de configuraciones avanzadas muestran el icono de variable Solo en modo de edición. Para que los valores de las variables de estos campos se rellenen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

  Los campos de la tabla Propiedades de Configuraciones Avanzadas no admiten el uso de variables para pasar JSON sin procesar. Si su caso de uso no permite definir JSON sin procesar directamente en los campos, escape el contenido JSON antes de pasarlo con una variable. Por ejemplo, escape {"success": "true"};se convierte {\"success\": \"true\"};.

• Prueba: Haga clic para verificar la conexión con la configuración especificada. Al probar la conexión, los agentes del grupo de agentes asociado al ambiente actual descargan la última versión del conector. Este conector permite suspender la descarga de la última versión mediante la política Deshabilitar actualización automática del conector política de la organización.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de la conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrarla sin guardar. Un mensaje le pedirá que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminarla permanentemente del proyecto y cerrarla (consulte Dependencias de componentes, eliminación y eliminación). Un mensaje te pedirá que confirmes que deseas eliminar la conexión.

Configurar conexiones OAuth

Este conector admite una conexión mediante OAuth mediante propiedades de configuración específicas. Tras seleccionar un esquema de autenticación que incluya Iniciar OAuth, podrá especificar la configuración en los campos que se muestran.

Este conector admite dos escenarios. En ambos casos, deberá usar una herramienta de externo (como Postman o una herramienta similar) para obtener el o los tokens de acceso necesarios del extremo involucrado. Ambos escenarios funcionan solo con grupos de un solo agente. Estos son grupos de agentes que consisten en un solo agente.

• Escenario 1: Usar un token de acceso OAuth que caduca después de un período de tiempo determinado.

  Con esta configuración, se proporciona un token de acceso OAuth con una duración determinada, según lo determine el extremo. El conector usará el token para establecer la conexión. Sin embargo, la conexión dejará de funcionar una vez que caduque el token de acceso. Para configurar el conector, configure estas propiedades:

  Propiedad de configuración	Valor
  Iniciar OAuth	OFF
  Token de acceso OAuth	Establezca el valor del token de acceso OAuth obtenido del extremo

• Escenario 2: Usar un token de acceso OAuth combinado con un token de actualización OAuth para habilitar la actualización automática del acceso.

  Con esta configuración, el conector usará un token de actualización para obtener un nuevo token de acceso una vez que el token de acceso actual haya expirado. Generalmente, este es el mejor método para configurar OAuth.

  Debe proporcionar un token de acceso OAuth y un token de actualización OAuth, según lo determine el extremo específico. Para configurar el conector, configure estas propiedades para usar estos tokens:

  Propiedad de configuración	Valor
  Iniciar OAuth	REFRESH
  Token de acceso OAuth	Establezca el valor del token de acceso OAuth obtenido del extremo
  Token de actualización de OAuth	Establezca el valor del token de actualización de OAuth obtenido del extremo

Próximos pasos

Después de crear una conexión de conector de Acumatica, coloque un tipo de actividad en el tela de diseño para crear instancias de actividad que se utilizarán como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones de menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulte Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

• Consulta: Recupera registros de una tabla en Acumatica y está destinado a ser utilizado como fuente en una operación.

• Crear: Inserta un registro en una tabla en Acumatica y está destinado a ser utilizado como destino en una operación.

• Actualizar: Actualiza un registro en una tabla en Acumatica y está destinado a ser utilizado como objetivo en una operación.

• Borrar: Elimina un registro de una tabla en Acumatica y está destinado a ser utilizado como objetivo en una operación.

• Ejecutar: Ejecuta un procedimiento en Acumatica y está destinado a ser utilizado como objetivo en una operación.