API de datos SAP - Automate_Evolve - Automate_Studio_Manager - Latest

Guía del usuario de Automate Evolve

Product type
Software
Portfolio
Integrate
Product family
Automate
Product
Automate > Automate Studio Manager
Automate > Automate Evolve
Version
Latest
Language
Español (España)
Product name
Automate Evolve
Title
Guía del usuario de Automate Evolve
Copyright
2024
First publish date
2018
Last updated
2024-09-06
Published on
2024-09-06T16:08:58.460208

API de datos SAP permite cargar y descargar datos de SAP. La API está disponible para Evolve y Studio Manager. La API expone la carga útil JSON y otros detalles (por ejemplo, SAP, la configuración de ejecución, etc.) para publicar datos en SAP. El ROI se sincronizará para todos los entornos (desarrollo, control de calidad y producción) pero la facturación solo se efectuará para el sistema de producción.

Nota:

La API de datos SAP no admite scripts encadenados ni múltiples. La API de datos SAP solo admite una única transacción. La web de Evolve y el worker de servicio no admiten transacciones basadas en GUI Scripting, por lo que tampoco son compatibles con la API de datos SAP. No se admiten consultas con criterios IN que utilicen rutas de archivo dinámicas para datos fijos o definidos por el usuario.

Requisitos previos

Estos son los dos requisitos previos para usar esta función:

  1. Debe activarse la licencia de la API de datos SAP en el sistema Evolve.

  2. El valor de la clave SapIntegrationAPIEnable debe establecerse en True.

Una vez que la licencia se haya activado correctamente, la aplicación también configurará la variable del sistema SapIntegrationAPIEnable y la establecerá como True de forma automática en la configuración avanzada (Administración → Sistema → Configuración avanzada). Para deshabilitar la función de SAP, establezca este valor en False.

Solo los administradores globales pueden añadir y administrar licencias. La licencia de integración de SAP es la licencia necesaria para la API de datos SAP; el tipo puede ser de suscripción (por niveles) o de suscripción (por volumen). La clave de configuración avanzada SapIntegrationAPIEnable solo puede habilitarse si el usuario tiene un tipo de SKU de licencia de integración de SAP válido. La API de integración de SAP está protegida con la puerta de enlace de API y su mecanismo de autenticación compatible.

Puede acceder a la API de datos SAP desde Evolve. Para obtener información sobre cómo guardar las soluciones de las API de datos SAP en Evolve, la configuración de aprobación de las API de SAP y la adición y actualización de las API de SAP desde la pestaña Soluciones, consulte la API de datos SAP con Evolve.

Puede crear scripts para la API de datos SAP y enviar los scripts a Evolve mediante Studio. Consulte la API de datos SAP con Studio para obtener más información.

Nota:

  • Utilice el “ErrorCode” de la respuesta de la API, en lugar del campo “Mensaje”. Para algunos códigos de error, los datos en el campo Mensaje pueden estar en inglés y, para otros, en el idioma predeterminado del usuario.

  • Según el estándar JSON, “\” no es una cadena válida ya que el validador JSON no admite el carácter “\”. Por lo tanto, debe añadir “\\” para reconocer los datos de “\”.

  • Para el soporte de cualquier carácter de escape de JSON, debe usar “\” antes del carácter de escape.

Por ejemplo: “\n” y “\t” pasará a través del validador JSON, pero se reemplazará por un espacio en blanco. Por lo tanto, deberá volver a añadir los caracteres \\n y \\t.

Para acceder a cualquier API, se requiere el prefijo de ruta. El prefijo de ruta es una combinación de la URL de Evolve y de palabras clave específicas.

Para la URL de Evolve, el usuario debe proporcionar el número de puerto, a menos que no sea el predeterminado. Por ejemplo, si tenemos un sitio de Evolve en el puerto 80 predeterminado, podemos utilizar las dos direcciones URL de Evolve para acceder a la API.

  • http://cha-de-vstpnx1.wsdt.local:80/svr/api/v1/Processextn/GetAllAssignments

  • http://cha-de-vstpnx1.wsdt.local/svr/api/v1/Processextn/GetAllAssignments.

Para las tres opciones de seguridad, hay que utilizar los siguientes prefijos de ruta para acceder a la API:

Secreto de cliente: «<URL de Evolve>/svr»

Token seguro: «<URL de Evolve>/svr»

Certificado: «<URL de Evolve>/svrc»

Nota:

En el caso de la API de datos SAP, cuando el usuario selecciona una solución para ver la URL de la solución de API de datos SAP, esta aparece como “<BaseURL/GatewayURL>/api/v1/SAPIS”

URLBase/URLDePuertaDeEnlace es el prefijo de ruta.

URLBase: URL de Evolve

URLDePuertaDeEnlace: «svr» para Clave secreta de cliente y Token seguro, y «svrc» para Certificado.

Cuerpo de solicitud y respuesta

Para cargar y descargar datos de SAP mediante la API de datos SAP, la estructura del cuerpo de solicitud y respuesta será la siguiente:

Solicitud:

El cuerpo de solicitud contiene lo siguiente:

Nombre Tipo Restricción Descripción
SolutionDetail JObject Obligatorio

Información sobre la solución con los siguientes parámetros:

  • SolutionName: Nombre de la solución de API de datos SAP.

    Tipo: string.

    Restricción: necesaria.

  • LibraryName: Nombre de la biblioteca de la solución de API de datos SAP.

    Tipo: string.

    Restricción: necesaria.

  • SolutionName: Nombre de la aplicación de la solución de API de datos SAP.

    Tipo: string.

    Restricción: necesaria.

 

RunParameter JObject Obligatorio Define los datos que deben validarse o publicarse en SAP. Consulte el ejemplo de carga útil de entrada para conocer los detalles del campo. Los datos que se definan dependerán de cada ejecución específica.
SapDetails JObject Obligatorio

Contiene información sobre la solución con los siguientes parámetros:

  • ConnectionName: Nombre de la conexión de SAP en la que se va a ejecutar la API.

    Tipo: string.

    Restricción: necesaria.

  • EvolveUser: Nombre del usuario que ejecutará la API de datos SAP. El usuario de Evolve debe tener el rol Originador.

    Tipo: string.

    Restricción: necesaria.

    Ejemplo: wse\\username

    (wse es el dominio,

    username es el nombre del usuario).

  • SAPUser: Nombre de usuario de SAP para realizar la conexión de SAP.

    Tipo: string.

    Restricción: opcional.

  • SAPPassword: Contraseña del usuario de SAP.

    Tipo: string.

    Restricción: opcional.

  • SAPLanguage: Valor del idioma de SAP que se enviará al establecer la conexión de SAP en un idioma determinado.

    Tipo: string.

    Restricción: opcional.

  • WindowsCredentials: Nombre de usuario y contraseña para la autenticación de Windows si la autenticación debe hacerse con credenciales de Windows.

    Tipo: JObject del nombre de usuario y la contraseña. Consulte el ejemplo de carga útil de entrada.

    Restricción: opcional.

Se aconseja guardar las credenciales de SAP o las credenciales de Windows en Evolve con el usuario de Evolve, de modo que la contraseña de texto sin formato no se transmita en la llamada de red mientras se ejecuta la API a través de un cliente de terceros.

RequestParameter JObject -

Contiene información sobre los siguientes parámetros:

  • Validate: Este valor se establece en True si solo se requiere que los datos se validen (los datos no deben publicarse en SAP).

    Tipo: boolean.

    Restricción: opcional.

Respuesta:

El cuerpo de respuesta contiene lo siguiente:

Nombre Tipo Restricción Descripción
RunResponse JObject -

Contiene información sobre la ejecución realizada con los siguientes parámetros:

  • Success: Devuelve True si la ejecución ha sido correcta; de lo contrario devuelve False.

    Tipo: boolean.

  • LogField: La información de LogField es similar a los detalles que obtenemos en el campo Log después de la ejecución desde el cliente de Studio.

    Tipo: string.

  • RunResult: Objeto Json que contiene los campos devueltos por SAP asignados como campos de descarga. Consulte el ejemplo de carga útil de salida para conocer los detalles.

    Tipo: JObject (este campo cambia de valor según el resultado devuelto de la ejecución).

 

Error:

El cuerpo de error contiene lo siguiente:

Nombre Tipo Restricción Descripción
Matriz fija para las especificaciones del error. Jarray -

Contiene información sobre la ejecución realizada con los siguientes parámetros:

  • ErrorCode: Devuelve el código de error en caso de error de ejecución.

    Tipo: string.

  • Message: Devuelve el mensaje correspondiente al código de error devuelto.

    Tipo: string.

  • errorParameters: Si la excepción tiene otros detalles que no forman parte de «Message», esos detalles formarán parte de «errorParameters». En caso contrario, se devolverá null.

    Tipo: matriz de cadenas.

Ejemplo de solicitud y respuesta

Especificación de API para Transaction

La carga útil muestra una lista combinada de carga útil de entrada, salida y error.

Formato de fecha y número

Se selecciona el formato de fecha ISO, ya que es conocido y ampliamente utilizado. Se utiliza en diferentes idiomas y es muy adecuado para convertirlo al formato de perfil de usuario de SAP.

El siguiente formato de fecha y número se pasa en la carga útil de la API de SAP. Se valida el formato de fecha y número.

Formato de fecha (“aaaa-MM-dd”), por ejemplo (2021-06-09)

Formato decimal (99999999.999), por ejemplo (12345.678)

Uso de la carga útil de entrada y salida: En el caso de Transaction y BAPI, el usuario debe elegir la carga útil de entrada para publicar los datos en SAP y la carga útil de salida para descargar los datos de SAP.

La carga útil de error es común para Transaction, BAPI y Query, y muestra el error al usuario.

Ejemplo de solicitud:

Carga útil de solicitud

{ "SolutionDetail": { "SolutionName": "string", "LibraryName": "string", "AppName": "string" }, "RunParameter": { "Material_Number": "string", "Material_Description__Short_Text_": "string", "Gross_Weight": "0.0", "Net_Weight": "0.0" } , "SapDetails": { "ConnectionName": "string", "EvolveUser": "string", "SAPUser": "string", "SAPPassword": "string", "SAPLanguage": "string", "WindowsCredentials": { "UserName": "string", "Password": "string" } }, "RequestParameter": { "Validate": "bool" } } 

Ejemplo de respuesta:

Carga útil de respuesta

{ "RunResponse":{ "Success": "bool", "LogField": "string", "RunResult": { "Base_Unit_of_Measure": "string", "Material_Group": "string", "Weight_Unit": "string" } } } 

Ejemplo de error:

Carga útil de error

[ { "ErrorCode": "string", "Message": "string", "errorPrameters": [{"string"}] } ] 

Especificación de API para Query

La carga útil muestra una lista combinada de carga útil de entrada, salida y error.

Uso de la carga útil de entrada y salida: En el caso de Query, el usuario tiene que elegir la carga útil de entrada para pasar los campos de criterios del generador de cláusulas y la carga útil de salida se usará para descargar los datos de SAP.

La carga útil de error es común para Transaction, BAPI y Query, y muestra el error al usuario.

Ejemplo de solicitud:

Carga útil de solicitud

{ "SolutionDetail": { "SolutionName": "string", "LibraryName": "string", "AppName": "string" }, "RunParameter": { "MAKT_Language_Key": { "EqualToOp1": "string" } }, "SapDetails": { "ConnectionName": "string", "EvolveUser": "string", "SAPUser": "string", "SAPPassword": "string", "SAPLanguage": "string", "WindowsCredentials": { "UserName": "string", "Password": "string" } }, "RequestParameter": { "RecordCount": "0", "GetRecordsCountOnly": "bool" } }

Ejemplo de respuesta:

Carga útil de respuesta

{ "RunResponse":{ "Success": "bool", "LogField": "string", "RecordCount": "0", "RunResult": [{ "MARA_Material_Number": "string", "MAKT_Language_Key": "string", "MAKT_Material_Description__Short_Text_": "string", "MARA_Gross_Weight": "string", "MARA_Net_Weight": "string" }] } } 

Ejemplo de error:

Carga útil de error

[ { "ErrorCode": "string", "Message": "string", "errorPrameters": [{"string"}] } ]