SAP ERP

Configurar la suscripción a eventos

Si habilitas la suscripción a eventos, debes configurar el SDK de ABAP. Para obtener información sobre cómo configurar el SDK de ABAP, consulta la descripción general del SDK de ABAP para Google Cloud.

Introduzca los siguientes valores en la sección Detalles de la suscripción a eventos:

1. Selecciona uno de los siguientes tipos de autenticación para el receptor de eventos.
   • Autenticación de Google. Si habilitas esta opción, sigue los pasos que se indican en Autenticar mediante JSON Web Tokens para configurar la autenticación del SDK de ABAP. Además, asegúrate de que la cuenta de servicio tenga el rol roles/connectors.listener, cuyo token de acceso se usa para la autenticación.
   • Autenticación con clave de API Si selecciona esta opción, debe haber creado una clave de API y, a continuación, haber guardado la clave como secreto de Secret Manager. Para obtener más información, consulta el artículo Crear una clave de API.
2. Escriba el nombre del campo de tipo de evento. Este campo identifica el tipo de evento asociado a la solicitud de evento entrante.

   {
   "event_type": "user.created",
   ...
   // other request fields
   ...
   }

3. Selecciona Habilitar conectividad privada para establecer una conexión segura entre tu aplicación backend y tu conexión. Si seleccionas esta opción, debes seguir unos pasos de configuración adicionales después de crear la conexión. Para obtener más información, consulta Conectividad privada para la suscripción a eventos.
4. Introduce la configuración de la cola de mensajes fallidos. Si configura mensajes fallidos, la conexión escribe los eventos no procesados en el tema de Pub/Sub especificado. Introduzca los siguientes detalles:
   1. ID de proyecto de mensajes fallidos: el ID del proyecto de Google Cloud en el que has configurado el tema de mensajes fallidos de Pub/Sub.
   2. Tema de mensajes fallidos: el tema de Pub/Sub en el que quieres escribir los detalles del evento no procesado.

Ejemplos de configuración de conexiones

En las siguientes secciones se indican los valores de ejemplo de los distintos campos cuando se crea la conexión SAP ERP, así como los parámetros necesarios para los diferentes tipos de conexión.

Conectarse a un sistema SAP distribuido

Si te conectas a un sistema SAP distribuido, como un sistema que usa el balanceo de carga, debes especificar las siguientes propiedades de conexión adicionales. Un administrador puede obtener estas propiedades de conexión en la pestaña Conexión del cuadro de diálogo Propiedades de entrada del sistema en el sistema SAP.

• ID de sistema: especifica el valor que has obtenido de la propiedad SystemId. El ID de sistema es el ID de sistema o R3Name del sistema SAP. El ID del sistema es una cadena de tres caracteres como máximo.
• Servidor de mensajes: cuando te conectas a un sistema SAP que usa el balanceo de carga, debes especificar el campo Servidor de mensajes. Asigna a esta propiedad el valor que has obtenido de la propiedad MessageServer del sistema SAP. Además, añade al principio del valor del campo Message Server el valor del cuadro SAProuter.
• Grupo: asigna a esta propiedad el valor que has obtenido de la propiedad Group/Server. La propiedad Group especifica el grupo de inicio de sesión que se está usando. El valor predeterminado es PUBLIC.

Conectarse a un servidor de aplicaciones personalizado

Si te conectas a un sistema SAP con un servidor de aplicaciones dedicado o personalizado, debes especificar las siguientes propiedades de conexión adicionales. Un administrador puede obtener estas propiedades de conexión del sistema SAP.

• ID de sistema: especifica el valor que has obtenido de la propiedad SystemId. Es el ID del sistema o el nombre R3 del sistema SAP. El ID del sistema es una cadena de tres caracteres como máximo.
• Host: especifica el valor que has obtenido del servidor de aplicaciones.

  Especifica el nombre de host del sistema de destino. Este valor puede ser un nombre de host normal, una dirección IP o una dirección de router SAP.

• Número de sistema: especifica el valor que has obtenido de la propiedad SystemNumber.

  La propiedad SystemNumber define el sistema de destino.

Configurar conexiones de red seguras

Si el administrador ha configurado la comunicación de red segura (SNC), debe definir las siguientes propiedades adicionales. En el sistema SAP, puede obtener las siguientes propiedades de la cadena de conexión SNC en la pestaña Red del cuadro de diálogo Propiedades de entrada del sistema.

• Modo SNC: si la casilla "Activar conexiones de red seguras" está habilitada en SAP, asigna el valor True a la propiedad de conexión Modo SNC. De lo contrario, defina la propiedad de conexión del modo SNC como False.

  La propiedad de conexión SNCMode es un valor booleano que determina si estás usando SNC. El valor predeterminado es "False".

• SNC PartnerName: el parámetro SNC PartnerName especifica el nombre SNC del servidor de aplicaciones. Por ejemplo: p:CN=IDS, OU=IT, O=CSW, C=DE
• Nombre de SNC: opcional. La propiedad SNCName especifica el nombre de la conexión SNC. Define esta propiedad para asegurarte de que se usa el nombre SNC correcto para la conexión.
• SNC Qop: asigna a esta propiedad la opción seleccionada en la sección Configuración de red segura. Por ejemplo, si se selecciona la opción Integridad, asigna el valor 3 a la propiedad SNCQop.

  La propiedad SNCQop especifica el nivel (o la calidad) de protección de datos. Si no se especifica esta propiedad, se le asigna el valor entero -1. Los valores válidos son 1, 2, 3, 8 o 9, que corresponden a los niveles de protección.

• ID de objeto SNC_Lib: define esta propiedad en la ruta y el nombre de archivo de tu biblioteca SNC. Especifica la ruta completa a la biblioteca de seguridad que estés usando, como C:\Secude\secude.xll..

Tipo de conexión ApplicationServer

Para la conectividad del servidor de aplicaciones, Private Service Connect y el balanceador de carga deben configurarse con la IP del sistema SAP y el puerto 33XX en el grupo de endpoints de red (NEG) y la comprobación de estado. Donde XX es el número del sistema o de la instancia del sistema SAP utilizado. En la siguiente tabla se muestran los valores de configuración de ejemplo del tipo de conexión ApplicationServer. Consulta la interfaz de creación de conexiones de la consola para saber qué campos son obligatorios y cuáles opcionales.

Tipo de conexión del servidor de mensajes (servidor de grupo)

• Private Service Connect y el balanceador de carga deben configurarse con la IP del sistema SAP en los puertos 33XX y 36XX en el grupo de endpoints de red (NEG) y la comprobación de estado. Donde XX es el número del sistema o de la instancia del sistema SAP utilizado.
• Debes crear una zona DNS en Cloud DNS y asignar el adjunto de endpoint del servidor de aplicaciones, que está configurado en el puerto 33XX, con el nombre de host del sistema SAP.
• Solo puedes conectarte a un sistema SAP con un servidor de mensajes (servidor de grupo) si el servidor de mensajes devuelve la dirección del nombre de dominio completo (FQDN) del servidor de aplicaciones. No puedes conectarte a un sistema SAP con un servidor de mensajes (servidor de grupo) si el servidor de mensajes devuelve la dirección IP.
• El servidor de mensajes debe responder con el DNS de los servidores de aplicaciones a los que la aplicación necesita conectarse cuando la aplicación lo solicite.
• El DNS de los servidores de aplicaciones debe ser único y no debe utilizarlo ningún otro sistema SAP.
• En la aplicación SAP, las IPs de adjuntos de endpoint de los servidores de aplicaciones y de mensajes deben mantenerse en los parámetros gw/alternative_hostnames.
  1. Ve a la transacción RZ10 y crea una entrada para el parámetro "gw/alternative_hostname" en el perfil de instancia.
  2. Asigna el valor 1 al parámetro ms/lg\_with\_hostname para configurar las versiones del servidor de mensajes de SAP anteriores a la 7.53 para que devuelvan nombres de host. Las versiones 7.53 y posteriores devuelven nombres de host de forma predeterminada.
  3. Reinicia la aplicación SAP para que los parámetros surtan efecto.

En la siguiente tabla se muestran los valores de configuración de ejemplo del tipo de conexión Group Server:

Tipo de conexión de certificado X509

Para las comunicaciones de red seguras (SNC) con conectividad X509, Private Service Connect y el balanceador de carga deben configurarse con la IP del sistema SAP y el puerto 48XX en el grupo de endpoints de red (NEG) y la comprobación de estado. Donde XX es el número del sistema o de la instancia del sistema SAP utilizado. En la siguiente tabla se muestran los valores de configuración de ejemplo del tipo de conexión X509 certificate. Consulta la interfaz de creación de conexiones de la consola para saber qué campos son obligatorios y cuáles opcionales.

Configurar SNC en un sistema Linux

Antes de iniciar SNC en un sistema Linux, asegúrate de que tienes los siguientes archivos:

• El archivo de certificado del sistema SAP, como SA1cert.crt.
• La versión de archivo SAPCAR adecuada para generar el archivo .PSE, como SAPCAR.exe.
• El .SAR file que contiene los archivos DLL de las bibliotecas de libsapcrypto.so y sapgenpse, como SAPCRYPTOLIBP_*.SAR.

1. Crea un directorio llamado snc en la ubicación que quieras y copia todos los archivos mencionados anteriormente en el directorio. En este caso, el directorio snc se crea en la ubicación /home/admin/snc. Usa un terminal, una máquina virtual o un cliente SSH, como PuTTY, para crear el directorio.
2. Ejecuta el siguiente comando para extraer el archivo SAR y los archivos binarios sapgenpse y libsapcrypto.so: ./SAPCAR.exe -xvf SAPCRYPTOLIBP_8524-20011697.SAR.
3. Genera el archivo PSE con el comando ./sapgenpse get_pse -p EHP8_GCP_SA1.pse -x google,123.

   Se te pedirá que introduzcas el nombre del PSE con el siguiente formato: CN=EHP8_GCP_SA1, OU=IT, O=CSW, C=DE. En este caso, EHP8_GCP_SA1 es el nombre que has proporcionado tú y el PSE.

   También se te pedirá que introduzcas una CONTRASEÑA, que funciona como contraseña y que debes anotar para futuras consultas.

   El PSE de SNC contiene la información de seguridad del servidor que se utiliza para proteger la conexión SNC. Esta información incluye la clave pública y privada del servidor, así como la lista de certificados correspondiente.

   Si aparece un error, como SECUDIR is not set, ejecuta el siguiente comando: SECUDIR=/home/admin/snc; export SECUDIR.

4. Exporta el certificado de cliente del archivo PSE que acabas de crear: ./sapgenpse export_own_cert -o EHP8_GCP_SA1.crt -p EHP8_GCP_SA1.pse -x google,123. Este comando genera el certificado de cliente EHP8_GCP_SA1.crt, que contiene la clave pública de la identidad SNC.

   Aquí debes indicar el nombre del certificado. Te recomendamos que el nombre del PSE y el del certificado de cliente sean iguales.

5. Vincule el certificado del sistema al PSE: ./sapgenpse maintain_pk -a SA1cert.crt -p EHP8_GCP_SA1.pse. De esta forma, se asocia el certificado del sistema SAP (SA1cert.crt) al PSE local.
6. Importa el certificado de cliente en el sistema SAP con la ayuda del equipo de BASIS y asigna el usuario al tipo de conexión de certificado X509.

Los nombres de los archivos creados en los pasos anteriores, los nombres de los archivos subidos al bucket de almacenamiento de destino y los nombres de los archivos especificados en la configuración de la conexión deben ser idénticos para garantizar una integración y un acceso a los datos adecuados.

Archivos obligatorios en el segmento de Cloud Storage

Los siguientes archivos deben almacenarse en el segmento de Cloud Storage para facilitar la comunicación segura entre los sistemas y los servicios de SAP. Google Cloud Estos archivos son esenciales para establecer conexiones de confianza, habilitar el cifrado y admitir las bibliotecas de comunicación criptográfica y Java de SAP:

• EHP8_GCP_SA1.crt: es el certificado público que se usa para establecer una conexión de confianza desde el sistema SAP a Google Cloud. Asegura la autenticidad de la cuenta de servicio que se comunica.
• EHP8_GCP_SA1.pse: El archivo PSE almacena la clave privada y la información del certificado necesarios para la comunicación segura en el entorno de SAP NetWeaver. Este archivo es fundamental para las conexiones basadas en SSL/TLS.
• SA1cert.crt: certificado adicional, posiblemente para la verificación de una AC intermedia o raíz, que se usa para completar la cadena de confianza durante la validación del certificado. De esta forma, SAP puede verificar la autenticidad de la cuenta de servicio de GCP o de los endpoints relacionados.
• libsapcrypto.so: El archivo de objeto compartido de la biblioteca criptográfica de SAP (entornos Linux o Unix) es necesario para habilitar la comunicación segura (SSL, SNC) en SAP. Proporciona funciones criptográficas, como el cifrado y la gestión de certificados.
• libsapjco3.so: archivo de biblioteca nativo de SAP Java Connector (JCo). Esto es esencial para permitir que las aplicaciones o el middleware basados en Java se comuniquen con los sistemas SAP.
• sapgenpse: herramienta de línea de comandos de SAP que se usa para gestionar archivos PSE, certificados y operaciones criptográficas. Esta utilidad es fundamental para generar y mantener identidades seguras en entornos SAP.
• sapjco3.jar: archivo Java para SAP Java Connector. Esto permite que las aplicaciones Java llamen a funciones de SAP mediante llamadas a funciones remotas (RFC). Es necesario para cualquier integración basada en Java con SAP.

Configuración de SAP GUI

Sigue estos pasos para importar el certificado generado por el cliente:

1. Inicia sesión en SAP GUI y abre el código de transacción STRUST.
2. Ve a SNC (SAPCRYPTOLIB).
3. En algunos sistemas, es posible que tengas que cambiar al modo Display Change. Haz clic en el botón Importar situado en la parte inferior de la página.
4. Busca y selecciona un nombre de PSE de cliente válido. Seleccione el formato de archivo Binario.
5. Haz clic en Añadir a la lista de certificados y en Guardar.

Ajustes de SAP para X.509

El certificado debe asignarse a las siguientes tablas:

1. Inicia sesión en SAP GUI y abre el código de transacción SM30.
2. Asigna el certificado a la tabla VSNCSYSACL siguiendo estos pasos:
   1. Abre la tabla VSNCSYSACL para realizar tareas de mantenimiento.
   2. Elige el tipo de área de trabajo externa como E.
   3. Elige Nuevas entradas.
   4. Introduce los siguientes datos en los campos correspondientes:
      • ID del sistema: el nombre del sistema SAP.
      • Nombre SNC: el nombre del sujeto asociado al certificado de cliente (añade p: antes del certificado)
        Ejemplo: p:CN=QAEHP8ER8, OU=IT, O=CSW, C=DE.
   5. Guarda los datos.
3. Asigna el certificado a la tabla VUSREXTID siguiendo estos pasos:
   1. Abre la tabla VUSREXTID para realizar tareas de mantenimiento.
   2. Elige el área de trabajo DN.
   3. Elige Nuevas entradas.
   4. Introduce los datos en los campos correspondientes tal como se explica a continuación:
      • Usuario: introduce el ID de usuario al que se debe asignar el certificado.
      • Número de secuencia: introduce el número de cliente de SAP.
      • Nombre SNC: introduce el nombre del asunto asociado al certificado de cliente.
        Ejemplo: CN=QAEHP8ER8, OU=IT, O=CSW, C=DE
      • Activado: selecciona esta opción
   5. Guarda los datos.
4. Repite el mismo proceso con X.

Configuración de la asignación de usuarios

1. Inicia sesión en SAP GUI y abre el código de transacción SU01.
2. En el campo de usuario, introduce el nombre de usuario de SAP al que quieras conceder permisos para ejecutar las funciones de SNC.
3. Haz clic en el icono Cambiar.
4. Haga clic en la pestaña SNC.
5. En el campo Nombre SNC, introduce el nombre distintivo del PSE del cliente con el prefijo p:, como en el ejemplo siguiente.
   Ejemplo: p:CN=QAEHP8ER8, OU=IT, O=CSW, C=DE
6. Haz clic en Aceptar y, luego, en Guardar. Aparecerá un mensaje que indica que se ha determinado el nombre canónico.

Si la conexión SNC no se activa después de completar todos los pasos, haz lo siguiente:

• Asegúrate de que la IP de la conexión del endpoint se añade al parámetro de perfil de SAP gw/alternative_hostnames.
• En el caso de las conexiones SNC a sistemas SAP locales, SAP Gateway suele escuchar en el puerto 48XX, donde XX es el número de instancia.

SNC Name y PartnerName deben empezar por el prefijo p: cuando se especifiquen en la configuración de la conexión.

Autenticación con certificado X509: importa el certificado de cliente que se ha generado anteriormente y que ya está disponible en el sistema SAP.

Entidades, operaciones y acciones

Todos los conectores de integración proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se te muestra como entidades, operaciones y acciones.

• Entidad: una entidad se puede considerar como un objeto o un conjunto de propiedades en la aplicación o el servicio conectados. La definición de una entidad varía de un conector a otro. Por ejemplo, en un conector de base de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; y en un conector de sistema de mensajería, las colas son las entidades.

  Sin embargo, es posible que un conector no admita o no tenga ninguna entidad. En ese caso, la lista Entities estará vacía.

• Operación: una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Mostrar
  • Obtener
  • Crear
  • Actualizar
  • Eliminar

  Al seleccionar una entidad de la lista disponible, se genera una lista de operaciones disponibles para la entidad. Para ver una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea Connectors. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, esas operaciones no admitidas no se mostrarán en la lista Operations.

• Acción: una acción es una función de primera clase que se pone a disposición de la integración a través de la interfaz del conector. Una acción te permite hacer cambios en una o varias entidades y varía de un conector a otro. Normalmente, una acción tendrá algunos parámetros de entrada y un parámetro de salida. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Acciones

En esta sección se proporciona información sobre los RFCs y se enumeran las acciones admitidas por el conector. Para saber cómo configurar las acciones, consulta los ejemplos de acciones.

Usar RFCs

En esta sección se proporciona información sobre las RFCs necesarias y sobre cómo usarlas.

RFCs obligatorios

Si no se cumplen alguna de las RFCs obligatorias, es posible que algunas o todas las funciones no funcionen. El código T SE37 se puede usar para ver los módulos de funciones disponibles en SAP.

El conector SAP ERP usa los siguientes RFCs.

• DDIF_FIELDINFO_GET
• RFC_GET_FUNCTION_INTERFACE
• RFC_GET_STRUCTURE_DEFINITION
• RFC_GET_SYSTEM_INFO
• RFC_GET_UNICODE_STRUCTURE
• RFC_READ_TABLE
• SLDAG_CHECK_FOR_UNICODE

Leer grandes cantidades de datos

En esta sección se describe el enfoque que debe seguir para leer grandes cantidades de datos de su backend de SAP.

El conector de SAP ERP usa la función SAP RFC_READ_TABLE para obtener datos de las tablas de SAP. Esta función tiene un tamaño fijo de 512 bytes. Puede almacenar en búfer cada fila de datos, por lo que no puedes seleccionar más columnas de las que cabrían en este búfer. Si selecciona más de 512 bytes, se producirá la excepción DATA_BUFFER_EXCEEDED al ejecutar la integración, lo que indica que ha superado el tamaño máximo de búfer permitido por fila y que debe seleccionar menos columnas.

Para solucionar este problema, puedes incluir el código de un Custom RFC_READ_TABLE, que es similar al SAP RFC_READ_TABLE, pero con un búfer más grande para solucionar el problema de DATA_BUFFER_EXCEEDED.

Usar una función de lectura de tabla personalizada

El conector admite un Custom RFC_READ_TABLE similar a SAP RFC_READ_TABLE, pero tiene un búfer más grande para poder solucionar el problema DATA_BUFFER_EXCEEDED.

Crear un RFC_READ_TABLE personalizado en tu backend de SAP

Sigue los pasos que se indican a continuación para usar la RFC_READ_TABLE personalizada de ejemplo.

1. Usa la función RFC_READ_TABLE como plantilla para la nueva función: selecciona el código de transacción SE37 y el grupo de funciones SDTX, y copia RFC_READ_TABLE en un nuevo grupo de funciones o en tu grupo de funciones de trabajo. En este ejemplo, RFC_READ_TABLE se copia en Z_CUSTOM_RFC_TABLE.
2. En la pestaña Atributos de la página SAP, selecciona Módulo habilitado para acceso remoto.
3. En la pestaña Tablas, asigna el valor CHAR8000 al parámetro DATA (puede que tengas que hacer clic con el botón derecho y, a continuación, en Mostrar > Cambiar).
4. En la pestaña Source Code (Código fuente), introduzca el código RFC de la tabla de lectura personalizada. Para obtener información, consulta el ejemplo de función Z_CUSTOM_RFC_TABLE.txt.
5. Haz clic en Guardar.
6. Define las importaciones, las tablas y las excepciones tal como se documenta en la tabla de lectura personalizada proporcionada.
7. Activa el módulo de funciones.

Tabla de lectura personalizada para ABAP 7.52

Si usas ABAP 7.52 o una versión posterior, consulta el ejemplo Z_CUSTOM_RFC_TABLE_function_ABAP752.txt. La función de ejemplo se ha diseñado para la versión 7.52 de ABAP y versiones posteriores. Es similar a la función Z_CUSTOM_RFC_TABLE, pero aprovecha las palabras clave disponibles recientemente en ABAP 7.52 para realizar la paginación en la base de datos en lugar de en la propia secuencia de comandos de ABAP. De esta forma, la paginación es mucho más eficiente y se mejora el rendimiento al trabajar con tablas grandes. Se recomienda usar el Z_CUSTOM_RFC_TABLE_752 RFC siempre que sea posible.

Acceso a la función RFC_READ_TABLE

En esta sección se proporciona información sobre el rol que se debe asignar a un usuario de SAP para acceder a la función RFC_READ_TABLE. Esta función es un módulo de funciones habilitado de forma remota que permite el acceso de lectura genérico a tablas arbitrarias.

Para que las tablas se incluyan en Entidades al configurar la tarea de conectores de SAP ERP, debe usar la función RFC_READ_TABLE en el nivel de conexión de SAP ERP y tener autorización para acceder a la función R/3 RFC_READ_TABLE.

Añade la autorización S_TABU_DIS para la actividad 03 (visualización) y el grupo de autorizaciones "SC" para la función RFC_READ_TABLE.

Estas son algunas de las limitaciones técnicas de RFC_READ_TABLE:

• Solo se pueden leer las tablas con tipos de datos sencillos. No se admiten los campos STRING ni XSTRING.
• La anchura máxima de línea es de 512 caracteres.
• El número de registros devueltos está limitado por los umbrales de memoria.

Acción BAPI_MATERIAL_SAVEDATA

Esta acción te permite realizar tareas específicas. Por ejemplo, puede usarla para crear o cambiar datos maestros de materiales en SAP ERP.

Parámetros de entrada de la acción BAPI_MATERIAL_SAVEDATA

Parámetros de salida de la acción BAPI_MATERIAL_SAVEDATA

Esta acción devuelve el estado 200 (OK) si se realiza correctamente.

Para ver un ejemplo de cómo configurar la acción BAPI_MATERIAL_SAVEDATA, consulte Ejemplos de acciones.

Acción ZFM_GCP_MULTIDATA_TAB

Esta acción permite a los usuarios realizar tareas específicas. Por ejemplo, puedes crear datos de varios tipos en SAP ERP.

Parámetros de entrada de la acción ZFM_GCP_MULTIDATA_TAB

Parámetros de salida de la acción ZFM_GCP_MULTIDATA_TAB

Esta acción devuelve el estado 200 (OK) si se realiza correctamente.

Para ver un ejemplo de cómo configurar la acción ZFM_GCP_MULTIDATA_TAB, consulte Ejemplos de acciones.

PushIDoc Action

Esta acción te permite realizar tareas específicas. Por ejemplo, puedes transferir datos de SAP a un sistema externo.

Parámetros de entrada de la acción PushIDoc

Parámetros de salida de la acción PushIDoc

Esta acción devuelve el estado 200 (OK) si se realiza correctamente.

Para ver un ejemplo de cómo configurar la acción PushIDoc, consulta Ejemplos de acciones.

Acción ExecuteCustomQuery

Esta acción te permite ejecutar una consulta personalizada.

Para crear una consulta personalizada, sigue estos pasos:

1. Sigue las instrucciones detalladas para añadir una tarea de conectores.
2. Cuando configure la tarea del conector, en el tipo de acción que quiera realizar, seleccione Acciones.
3. En la lista Acción, selecciona Ejecutar consulta personalizada y, a continuación, haz clic en Hecho.

   

4. Despliega la sección Entrada de la tarea y, a continuación, haz lo siguiente:
   1. En el campo Tiempo de espera tras, introduce el número de segundos que deben transcurrir hasta que se ejecute la consulta.

      Valor predeterminado: 180 segundos.

   2. En el campo Número máximo de filas, introduzca el número máximo de filas que se devolverán de la base de datos.

      Valor predeterminado: 25.

   3. Para actualizar la consulta personalizada, haz clic en Editar secuencia de comandos personalizada. Se abrirá el cuadro de diálogo Editor de secuencias de comandos.

      

   4. En el cuadro de diálogo Editor de secuencias de comandos, introduce la consulta de SQL y haz clic en Guardar.

      Puedes usar un signo de interrogación (?) en una instrucción SQL para representar un único parámetro que debe especificarse en la lista de parámetros de la consulta. Por ejemplo, la siguiente consulta SQL selecciona todas las filas de la tabla Employees que coinciden con los valores especificados en la columna LastName:

      SELECT * FROM Employees where LastName=?

   5. Si has usado signos de interrogación en tu consulta SQL, debes añadir el parámetro haciendo clic en + Añadir nombre de parámetro por cada signo de interrogación. Durante la ejecución de la integración, estos parámetros sustituyen secuencialmente los signos de interrogación (?) de la consulta de SQL. Por ejemplo, si has añadido tres signos de interrogación (?), debes añadir tres parámetros en orden de secuencia.

      

      Para añadir parámetros de consulta, siga estos pasos:

      1. En la lista Tipo, seleccione el tipo de datos del parámetro.
      2. En el campo Valor, introduzca el valor del parámetro.
      3. Para añadir varios parámetros, haga clic en + Añadir parámetro de consulta.

   La acción Ejecutar consulta personalizada no admite variables de matriz.

Si se ejecuta correctamente, esta acción devuelve el estado 200 (OK) con un cuerpo de respuesta que contiene los resultados de la consulta.

Ejemplos de acciones

Ejemplo: crear un registro

En este ejemplo se crea un registro de material mediante la acción BAPI_MATERIAL_SAVEDATA.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción BAPI_MATERIAL_SAVEDATA y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009001\",\"IND_SECTOR\":\"M\",\"MATL_TYPE\":\"HALB\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA" : "{\"MATL_GROUP\":\"00107\",\"BASE_UOM\":\"KG\"}",
   "CLIENTDATAX" : "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
   "MATERIALDESCRIPTION" : "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Google\"}"
   }

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea BAPI_MATERIAL_SAVEDATA tendrá un valor similar al siguiente:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9001 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9001",
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Ejemplo: actualizar un registro

En este ejemplo se actualiza un registro de material mediante la acción BAPI_MATERIAL_SAVEDATA.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción BAPI_MATERIAL_SAVEDATA y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"IND_SECTOR\":\"A\",\"MATL_TYPE\":\"FHMI\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA": "{\"MATL_GROUP\":\"013\",\"BASE_UOM\":\"ST\"}",
   "CLIENTDATAX": "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
   "MATERIALDESCRIPTION": "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Googlecloud\"}"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea BAPI_MATERIAL_SAVEDATA tendrá un valor similar al siguiente:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9000 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Ejemplo: eliminar un registro

En este ejemplo se elimina un registro de material mediante la acción BAPI_MATERIAL_SAVEDATA.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción BAPI_MATERIAL_SAVEDATA y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA": "{\"DEL_FLAG\":\"X\"}",
   "CLIENTDATAX": "{\"DEL_FLAG\":\"X\"}"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea BAPI_MATERIAL_SAVEDATA tendrá un valor similar al siguiente:

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Ejemplo: crear datos de varios tipos

En este ejemplo se crean datos de varios tipos de datos mediante la acción ZFM_GCP_MULTIDATA_TAB.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción ZFM_GCP_MULTIDATA_TAB y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "T_TABLE": "{\"ZACCP\":\"111\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
   "IM_INPUT_1": "{\"ZACCP\":\"222\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
   "IM_INPUT_2": "{\"ZSTRING\": \"HI Google\",\"ZSSTRING\": \"HI Google How are you\"}"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea ZFM_GCP_MULTIDATA_TAB tendrá un valor similar al siguiente:

[{
"EX_OUTPUT_1_ZACCP": 222,
"EX_OUTPUT_1_ZCHAR": "CHARACTER1",
"EX_OUTPUT_1_ZCLNT": "100",
"EX_OUTPUT_1_ZCUKY": "INR",
"EX_OUTPUT_1_ZCURR": 200,
"EX_OUTPUT_1_ZDATS": "2023-12-13",
"EX_OUTPUT_1_ZRAW": "01010008010101050401",
"EX_OUTPUT_1_ZTIMS": "10:30:56",
"EX_OUTPUT_1_ZUNIT": "11",
"EX_OUTPUT_1_ZINT4P": 45,
"EX_OUTPUT_1_ZINT4": 54,
"EX_OUTPUT_1_ZLRAW": "0101000801010105040100030101010300040000\u0000",
"EX_OUTPUT_2_ZSTRING": null,
"EX_OUTPUT_2_ZSSTRING": null,
"RESULT_TABLE": null,
"T_TABLE_ZACCP": null,
"T_TABLE_ZCHAR": null,
"T_TABLE_ZCLNT": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZRAW": null,
"T_TABLE_ZLANG": null,
"T_TABLE_ZNUMC": null,
"T_TABLE_ZPREC": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZCURR": null,
"EX_OUTPUT_1_ZDATS": null,
"EX_OUTPUT_1_ZDEC": null,
"EX_OUTPUT_1_ZQUAN": null,
"T_TABLE_ZNUMC": 110,
"T_TABLE_ZPREC": 3,
"T_TABLE_ZQUAN": 188,
"T_TABLE_ZRAW": "01010008010101050401",
"T_TABLE_ZTIMS": "10:30:56",
"T_TABLE_ZUNIT": "11"
}]

Ejemplo: enviar un IDoc

En este ejemplo se envía un IDoc al ERP de SAP.

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción PushIDoc y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
   "Content": "\n\n\n EDI_DC40\n 800\n 0000000008604824\n 740\n 53\n 2\n \n MATMAS05\n MATMAS\n ZLS_QA23\n LS\n ZLS_QA23\n SAPSA1\n LS\n SA1CLNT800\n 20230218\n 232556\n\n\n 005\n 000000000000000012\n 20170328\n 42039\n 20170727\n 42039\n KLVC\n FERT\n M\n 02\n BG\n 000\n 002\n 0.000\n 0.000\n KGM\n 0.000\n 0001\n 0.000\n 0.000\n 0.000\n 0.000\n 0.000\n",
   "FileType": "XML",
   "Mode": "ASync"
   }

. Si la acción se realiza correctamente, el parámetro connectorOutputPayload responsePushIDoc de la tarea tendrá un valor similar al siguiente:

[{
"Result": "Success",
"Message": "Push IDoc success"
}]

Ejemplos de operaciones de entidades

En esta sección se muestra cómo realizar algunas de las operaciones de entidad en este conector.

Ejemplo: listar todos los registros

En este ejemplo se enumeran todos los registros de la entidad T001.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona T001 en la lista Entity.
3. Selecciona la operación List y, a continuación, haz clic en Hecho.
4. Opcionalmente, en la sección Entrada de tarea de la tarea Conectores, puedes filtrar el conjunto de resultados especificando una cláusula de filtro. Especifica siempre el valor de la cláusula de filtro entre comillas simples (').

Ejemplo: obtener un registro de una entidad

En este ejemplo se obtiene un registro con el ID especificado de la entidad T001.

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona T001 en la lista Entity.
3. Selecciona la operación Get y, a continuación, haz clic en Hecho.
4. En la sección Entrada de tarea de la tarea Conectores, haga clic en EntityId y, a continuación, introduzca 0001 en el campo Valor predeterminado.

   En este caso, 0001 es un ID de registro único de la entidad T001.