SAP ERP

El conector SAP ERP te permite realizar operaciones de inserción, eliminación, actualización y lectura en datos de SAP ERP.

Antes de comenzar

Antes de usar el conector SAP ERP, realiza las siguientes tareas:

• En tu proyecto de Google Cloud, haz lo siguiente:
  • Otorga el rol de IAM roles/connectors.admin al usuario que configura el conector.
  • Otorga los siguientes roles de IAM a la cuenta de servicio que deseas usar para el conector:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor
    • roles/storage.objectViewer

    Una cuenta de servicio es un tipo de Cuenta de Google especial que representa a un usuario no humano que debe autenticarse y tener autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crear una. Para obtener más información, consulta Crea una cuenta de servicio.

  • Habilita los siguientes servicios:
    • secretmanager.googleapis.com (API de Secret Manager)
    • connectors.googleapis.com (API de conectores)

    Para comprender cómo habilitar servicios, consulta Habilita servicios.

  Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.

Configura el conector

Para configurar el conector, debes crear una conexión a tu fuente de datos (sistema de backend). Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, sigue estos pasos:

1. En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.

   Ir a la página Conexiones

2. Haz clic en + Crear nuevo para abrir la página Crear conexión.
3. En la sección Ubicación, elige la ubicación para la conexión.
   1. Región: selecciona una ubicación de la lista desplegable.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

   2. Haz clic en Siguiente.
4. En la sección Detalles de la conexión, completa lo siguiente:
   1. Conector (Connector): Selecciona SAP ERP en la lista desplegable de conectores disponibles.
   2. Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
   3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.

      Los nombres de las conexiones deben cumplir con los siguientes criterios:

      • Los nombres de las conexiones pueden usar letras, números o guiones.
      • Las letras deben estar en minúsculas.
      • Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
      • Los nombres de las conexiones no pueden superar los 63 caracteres.
   4. De manera opcional, ingresa una Descripción para la conexión.
   5. De manera opcional, habilita Cloud Logging.
   6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
   7. Si quieres usar la conexión para suscripciones a eventos, selecciona Habilitar suscripción a eventos. Cuando seleccionas esta opción, se muestran las siguientes opciones:
      • Habilitar la suscripción a eventos con entidad y acciones: Selecciona esta opción para usar la conexión para la suscripción a eventos y las operaciones del conector (entidades y acciones).
      • Habilitar solo suscripción a eventos: Selecciona esta opción para usar la conexión solo para la suscripción a eventos. Si seleccionas esta opción, haz clic en Siguiente y, luego, configura la suscripción al evento.
   8. Cliente: el cliente que se autentica en el sistema SAP
   9. System Id: El ID del sistema o R3Name del sistema SAP es una string con un máximo de tres caracteres. A menudo, se usa en conexiones de balanceo de cargas.
   10. Número de sistema: Es el número por el que se define el sistema de destino. Se usa cuando se configura la propiedad de conexión del host.
   11. ID del proyecto: Es el ID del proyecto de Google Cloud en el que reside el bucket de GCS que contiene el archivo jar de SAP JCo.
   12. Bucket: Es el nombre del bucket que contiene los archivos sapjco3.jar y libsapjco3.so.
   13. ID del objeto del jar de Jaco: Es el ID del objeto del jar de JCo.
   14. ID del objeto de libsapjco3: Es el ID de objeto del archivo jar libsapjco3.
   15. Modo de tabla: Selecciona la tabla de SAP que se mostrará como vista.
   16. ID de objeto SNC_LIB: Es el ID de objeto de la biblioteca de SNC.
   17. Nombre de PSE: Es el nombre del archivo de entorno de seguridad personal (PSE) aplicable al bucket. Un archivo PSE almacena el par de claves pública y privada, además de los certificados X.509 en una estructura ASN.1.
   18. Grupo: Es el nombre del grupo para el inicio de sesión. Por lo general, esto se especifica cuando el sistema SAP usa balanceadores de cargas.
   19. Servidor de mensajes: Es el nombre del servidor de mensajes que se usará cuando se establezca la conexión con el sistema SAP que usa balanceadores de cargas.
   20. Función de lectura de tabla: Nombre de la función que se usará para leer las tablas. Para obtener más información, consulta Usa una función de tabla de lectura personalizada.
   21. Connection schema (Esquema de conexión): Selecciona un esquema de conexión que se usará para conectarse a tu sistema SAP.
   22. System ID: Es el ID del sistema o el R3Name del sistema SAP. Puedes ingresar un máximo de 3 caracteres.
   23. Contraseña de SNC: Selecciona el secreto de Secret Manager correspondiente a la contraseña de la biblioteca de SNC.
   24. Versión del secreto: Selecciona la versión del secreto.
   25. Modo SNC: Selecciona esta opción si quieres habilitar SNC para la autenticación entre Integration Connectors y tu sistema SAP.
   26. Nombre del SNC: Ingresa un nombre para la conexión del SNC.
   27. SNC qop: Selecciona un nivel de protección. Los siguientes son los niveles admitidos:
       • 1: Solo aplica autenticación.
       • 2: Aplica la protección de la integridad. Esto también incluye la protección de autenticación.
       • 3. Aplica la protección de la privacidad. Esto también incluye protección de la integridad y la autenticación.
       • 8: Aplica la protección predeterminada.
       • 9: Aplica la protección máxima.
   28. Nombre del socio de SNC: Ingresa el nombre de SNC del servidor de la aplicación.
   29. Modo de consulta: Selecciona las tablas de SAP que se deben mostrar como vistas.
   30. Vistas navegables: Ingresa una lista de vistas separadas por comas que se mostrarán. Por ejemplo, ViewA,ViewB,ViewC
   31. Nivel de verbosidad: Ingresa el nivel de verbosidad para el registro. Los valores admitidos van del 1 al 5. Un valor más alto significa que habrá más detalles disponibles en los registros.
   32. De manera opcional, configura los parámetros de nodo de conexión:
       • Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
       • Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.

       Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.

   Nota: Puedes personalizar los valores de los nodos de conexión solo si eres un cliente de pago por uso.
   33. De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
   34. Haz clic en Siguiente.
5. En la sección Destinos, ingresa los detalles del host remoto (sistema de backend) al que deseas conectarte.
   1. Tipo de destino: Selecciona un Tipo de destino.
      • Selecciona Dirección de host en la lista para especificar el nombre de host o la dirección IP del destino.
      • Si deseas establecer una conexión privada con tus sistemas de backend, selecciona Adjunto de extremo en la lista y, luego, selecciona el adjunto de extremo requerido en la lista Adjunto de extremo.
        Nota: Para comprender cómo crear un adjunto de extremo, consulta Adjunto de servicio de PSC y adjunto de extremo. Después de crear el adjunto de extremo, será visible en la lista Adjunto de extremo.

      Si deseas establecer una conexión pública a tus sistemas de backend con seguridad adicional, puedes considerar configurar direcciones IP de salida estáticas para tus conexiones y, luego, configurar tus reglas de firewall para incluir en la lista de entidades permitidas solo las direcciones IP estáticas específicas.

      Para ingresar destinos adicionales, haz clic en +Agregar destino.

   2. Haz clic en Siguiente.
6. En la sección Autenticación, ingresa los detalles de autenticación.
   1. Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.

      La conexión SAP ERP admite los siguientes tipos de autenticación:

      • Nombre de usuario y contraseña

   Para comprender cómo configurar estos tipos de autenticación, consulta Configura la autenticación.

   2. Haz clic en Siguiente.
7. Si habilitaste la suscripción al evento, aparecerá la sección Event Subscription Details en la página de creación de conexión. Para comprender cómo configurar los detalles de la suscripción a eventos, consulta Cómo configurar la suscripción a eventos.
8. Revisa: Revisa tus detalles de conexión y autenticación.
9. Haz clic en Crear.

Configura la autenticación

Ingresa los detalles según la autenticación que desees usar.

• Nombre de usuario y contraseña
  • Username: Nombre de usuario para el conector
  • Contraseña: Secreto de Secret Manager que contiene la contraseña asociada con el conector.

Configurar para la suscripción al evento

Si habilitaste la suscripción al evento, ingresa los siguientes valores en la sección Detalles de suscripción al evento:

1. Selecciona uno de los siguientes tipos de autenticación para el objeto de escucha de eventos.
   Nota: Antes de configurar la autenticación, asegúrate de tener el extremo del objeto de escucha de eventos, que estará disponible después de crear la conexión. Para ver el extremo, ve a la página Todas las conexiones y haz clic en la conexión que deseas ver. El extremo se muestra en la sección Detalles de la conexión.
   • Autenticación de Google. Si habilitas esta opción, sigue los pasos que se indican en Autenticación mediante tokens web JSON 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 de la Clave de API. Si seleccionas esta opción, deberías haber creado una clave de API y, luego, guardada la clave como un secreto de Secret Manager. Para obtener más información, consulta Cómo crear una clave de API.
2. Ingresa el nombre del campo del tipo de evento. Este campo identifica el tipo de evento asociado con la solicitud de evento entrante.

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

3. Select Enable private connectivity for secured connectivity between your backend application and your connection. If you select this option, you must perform additional configuration steps after creating the connection. For more information, see Private connectivity for event subscription.
4. Enter the dead-letter configuration. If you configure dead-letter, the connection writes the unprocessed events to the specified Pub/Sub topic. Enter the following details:
   1. Dead-letter project ID: The Google Cloud project ID where you have configured the dead-letter Pub/Sub topic.
   2. Dead-letter topic: The Pub/Sub topic where you want to write the details of the unprocessed event.

Tip: To understand how you can use event subscription in your integrations, see SAP ERP trigger.

Entities, operations, and actions

All the Integration Connectors provide a layer of abstraction for the objects of the connected application. You can access an application's objects only through this abstraction. The abstraction is exposed to you as entities, operations, and actions.

Note: You can view the entities, operations, and actions of a connector in the Connectors task.

• Entity: An entity can be thought of as an object, or a collection of properties, in the connected application or service. The definition of an entity differs from a connector to a connector. For example, in a database connector, tables are the entities, in a file server connector, folders are the entities, and in a messaging system connector, queues are the entities.

  However, it is possible that a connector doesn't support or have any entities, in which case the Entities list will be empty.

• Operation: An operation is the activity that you can perform on an entity. You can perform any of the following operations on an entity:
  • List
  • Get
  • Create
  • Update
  • Delete

  Selecting an entity from the available list, generates a list of operations available for the entity. For a detailed description of the operations, see the Connectors task's entity operations. However, if a connector doesn't support any of the entity operations, such unsupported operations aren't listed in the Operations list.

• Action: An action is a first class function that is made available to the integration through the connector interface. An action lets you make changes to an entity or entities, and vary from connector to connector. Normally, an action will have some input parameters, and an output parameter. However, it is possible that a connector doesn't support any action, in which case the Actions list will be empty.

Note: All entities and actions will have a schema associated with them. For example, an action schema will have the parameter details such as; the parameter names, and its corresponding data type. The schema (metadata) for entities and actions is fetched by the connection at runtime from your backend. If there are any updates to the schema, such updates won't be automatically reflected in your existing connections; you must manually refresh the schema. To refresh the schema for a connection, open the Connection details page of the connection, and then click Refresh connection schema.

System limitations

The SAP ERP connector can process 7 transactions per second, per node, and throttles any transactions beyond this limit. By default, Integration Connectors allocates 2 nodes (for better availability) for a connection.

For information on the limits applicable to Integration Connectors, see Limits.

Note: The number of Integration Connectors nodes will autoscale dynamically based on your usage. However, if you want to reserve capacity for large volumes without waiting for autoscaling, you can adjust the minimum node value for a connection. More nodes are required to process more transactions for a connection. Conversely, fewer nodes are required if a connection processes fewer transactions. To configure the node values, do the following:

• If you are a pay-as-you-go customer, configure the minimum and maximum node value in the edit connection page.
• If you are a subscription based customer, contact support.

The maximum transactions that a node can handle depends on various factors. So, before adjusting the minimum nodes for better throughput, it is recommended you check if your backend systems are set up optimally to handle the required traffic.

Connection configuration samples

This section lists the sample values for the various fields that you would configure when creating the connection.

ApplicationServer connection type

The following table lists the sample configuration values for the ApplicationServer connection type. Refer to the connection creation interface in the console to know the mandatory and optional fields.

Field name	Sample value
Region	us-central1
Connector	SAP ERP
Connector Version	1
Connector Name	saperp-applicationserver-conn
Description	NA
Service Account	[e-mail]
Client	800
System Number	00
Project ID	xxxx-gcp-project
Bucket	sap-erp-bucket
Jco Jar object ID	sapjco3.jar
libsapjco3 object ID	libsapjco3.so
Table Mode	TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
Read Table Function	Z_CUSTOM_READ_TABLE
Connection Scheme	ApplicationServer
System Id	SA1
Query Mode	NA
Browsable Views	NA
Verbosity Level	5
Minimum number of nodes	2
Maximum number of nodes	50
Host Address	10.30.X.XX or Router string of an external SAP system.
Authentication	User Password
Username	12345
Password	xyz@12345
versions	1

GroupServer connection type

The following table lists the sample configuration values for the GroupServer connection type. Refer to the connection creation interface in the console to know the mandatory and optional fields.

Field name	Sample value
Region	us-central1
Connector	SAP ERP
Connector Version	1
Connector Name	saperp-GroupServer-conn
Description	NA
Service Account	[e-mail]
Client	800
System Number	00
Project ID	xxxx-gcp-project
Bucket	sap-erp-bucket
Jco Jar object ID	sapjco3.jar
libsapjco3 object ID	libsapjco3.so
Table Mode	TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
Group	PUBLIC
Message Server	10.30.X.XX
Read Table Function	Z_CUSTOM_READ_TABLE
Connection Scheme	GroupServer
System Id	SA1
Query Mode	NA
Browsable Views	NA
Verbosity Level	5
Minimum number of nodes	2
Maximum number of nodes	50
Host Address	10.30.X.XX or Router String of External SAP System.
Authentication	User Password
Username	12345
Password	xyz@12345
versions	1

X509 certificate connection type

The following table lists the sample configuration values for the X509 certificate connection type. Refer to the connection creation interface in the console to know the mandatory and optional fields.

Field name	Sample value
Region	us-central1
Connector	SAP ERP
Connector Version	1
Connector Name	saperp-X509Certificate-conn
Description	NA
Service Account	[e-mail]
Client	800
System Number	00
Project ID	xxxx-gcp-project
Bucket	sap-erp-bucket
Jco Jar object ID	sapjco3.jar
libsapjco3 object ID	libsapjco3.so
Table Mode	TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
SNC_LIB object ID	libsapcrypto.so
PSE Name to create cred_v2 file	EHP8_GCP_SA1.pse
Read Table Function	Z_CUSTOM_READ_TABLE
Connection Scheme	ApplicationServer
System Id	SA1
SNC passcode	xyz@gcp
SNC Mode	A boolean determining if you are using SNC. Set this to true to use SNC.
SNC Name	p:CN=EHP8_GCP_SA1, OU=IT, O=CSW, C=DE
SNC Qop	3
SNC PartnerName	p:CN=SA1, OU=I0020070395, OU=SAP Web AS, O=SAP Trust Community, C=DE
Query Mode	NA
Browsable Views	NA
Verbosity Level	5
Minimum number of nodes	2
Maximum number of nodes	50
Host Address	10.30.X.XX or Router String of External SAP System.
Authentication	X509Certificate Based Authentication
X509Certificate	The X509 certificate may be specified using a file path pointing to a file containing an X509 certificate in PEM format, a PEM blob beginning with the "-----BEGIN ..." header, or a PEM blob without the "-----BEGIN ..." header.
versions	1

Actions

This section lists the actions supported by the connector. To understand how to configure the actions, see Action examples.

Note: The results of all the actions will be available as a JSON response in the Connectors task's connectorOutputPayload response parameter after you run your integration.

BAPI_MATERIAL_SAVEDATA action

This action let you perform specific tasks. For example, you can use it to create or change material master data in SAP ERP.

Input parameters of the BAPI_MATERIAL_SAVEDATA action

Parameter Name	Data Type	Required	Description
HEADDATA	String	Yes	The input parameter HEADDATA.
CLIENTDATA	String	Yes	The input parameter CLIENTDATA.
CLIENTDATAX	String	Yes	The input parameter CLIENTDATAX.
MATERIALDESCRIPTION	String	Yes	The table MATERIALDESCRIPTION.

Output parameters of the BAPI_MATERIAL_SAVEDATA action

This action returns the status 200 (OK) if the action is successful.

For example on how to configure the BAPI_MATERIAL_SAVEDATA action, see Action examples.

ZFM_GCP_MULTIDATA_TAB action

This action let users perform specific tasks. For example, you can create multi datatype data in SAP ERP.

Input parameters of the ZFM_GCP_MULTIDATA_TAB action

Parameter Name	Data Type	Required	Description
ReturnTables	String	Yes	A comma separated list that specifies which tables in the function module should be output. If not specified, all returned tables will be output.
T_TABLE	String	Yes	The table T_TABLE.
IM_INPUT_1	String	Yes	The input parameter IM_INPUT_1.
IM_INPUT_2	String	Yes	The input parameter IM_INPUT_2.

Output parameters of the ZFM_GCP_MULTIDATA_TAB action

This action returns the status 200 (OK) if the action is successful.

For example on how to configure the ZFM_GCP_MULTIDATA_TAB action, see Action examples.

PushIDoc Action

This action let you perform specific tasks. For example, you can transfer data from SAP to an external system.

Input parameters of the PushIDoc action

Parameter Name	Data Type	Required	Description
FileType	String	Yes	The file type.The allowed values are XML, IDoc.
Mode	String	Yes	The transfer mode.The allowed values are Sync, ASync.
Content	String	Yes	Content of the file.

Output parameters of the PushIDoc action

This action returns the status 200 (OK) if the action is successful.

For example on how to configure the PushIDoc action, see Action examples.

ExecuteCustomQuery action

This action lets you execute a custom query.

To create a custom query, follow these steps:

1. Follow the detailed instructions to add a connectors task.
2. When you configure the connector task, in the type of action you want to perform, select Actions.
3. In the Action list, select Execute custom query, and then click Done.

   

4. Expand the Task input section, and then do the following:
   1. In the Timeout after field, enter the number of seconds to wait till the query executes.

      Default value: 180 seconds.

   2. In the Maximum number of rows field, enter the maximum number of rows to be returned from the database.

      Default value: 25.

   3. To update the custom query, click Edit Custom Script. The Script editor dialog opens.

      

   4. In the Script editor dialog, enter the SQL query and click Save.

      You can use a question mark (?) in a SQL statement to represent a single parameter that must be specified in the query parameters list. For example, the following SQL query selects all rows from the Employees table that matches the values specified for the LastName column:

      SELECT * FROM Employees where LastName=?

      Nota: Se admiten las declaraciones de lenguaje de manipulación de datos (DML) y lenguaje de definición de datos (DDL).
   5. Si usaste signos de interrogación en tu consulta en SQL, debes agregar el parámetro. Para ello, haz clic en + Agregar nombre del parámetro en cada signo de interrogación. Mientras se ejecuta la integración, estos parámetros reemplazan los signos de interrogación (?) en la consulta en SQL de forma secuencial. Por ejemplo, si agregaste tres signos de interrogación (?), debes agregar tres parámetros en orden de secuencia.

      

      Para agregar parámetros de consulta, haz lo siguiente:

      1. En la lista Tipo, selecciona el tipo de datos del parámetro.
      2. En el campo Valor, ingresa el valor del parámetro.
      3. Para agregar varios parámetros, haz clic en + Agregar parámetro de consulta.

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

   Ejemplos de acciones

   Ejemplo: crea un registro

   En este ejemplo, se crea un registro metrial con la acción BAPI_MATERIAL_SAVEDATA.

   1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
   2. Selecciona la acción BAPI_MATERIAL_SAVEDATA y haz clic en Listo.
   3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, luego, ingresa 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: Actualiza un registro

   En este ejemplo, se actualiza un registro metrial mediante la acción BAPI_MATERIAL_SAVEDATA.

   1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
   2. Selecciona la acción BAPI_MATERIAL_SAVEDATA y haz clic en Listo.
   3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 ejecuta 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 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: Borra un registro

   En este ejemplo, se borra un registro metrial con la acción BAPI_MATERIAL_SAVEDATA.

   1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
   2. Selecciona la acción BAPI_MATERIAL_SAVEDATA y haz clic en Listo.
   3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 ejecuta 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_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: Crea datos de tipos de multidatos

   En este ejemplo, se crean datos de tipos de datos múltiples con la acción ZFM_GCP_MULTIDATA_TAB.

   1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
   2. Selecciona la acción ZFM_GCP_MULTIDATA_TAB y haz clic en Listo.
   3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 ejecuta correctamente, el parámetro de respuesta connectorOutputPayload 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: Envía un IDoc

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

   1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
   2. Selecciona la acción PushIDoc y haz clic en Listo.
   3. En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 de respuesta connectorOutputPayload de la tarea PushIDoc 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: enumera 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 de la lista Entity.
   3. Selecciona la operación List y, luego, haz clic en Listo.
   4. De manera opcional, en la sección Entrada de tarea de la tarea Conectores, puedes filtrar tu conjunto de resultados especificando una cláusula de filtro. Especifica el valor de la cláusula de filtro siempre entre comillas simples (').

   Ejemplo: Obtén 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 de la lista Entity.
   3. Selecciona la operación Get y, luego, haz clic en Listo.
   4. En la sección Entrada de tarea de la tarea Conectores, haz clic en EntityId y, luego, ingresa 0001 en el campo Valor predeterminado.

      Aquí, 0001 es un ID de registro único en la entidad T001.

   Lee datos de gran tamaño

   Muchas veces, es posible que el conector ERP de SAP tenga que leer grandes datos del backend de SAP. En esta sección, se describe el enfoque que debes seguir para leer datos de gran tamaño.

   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 cada fila de datos en el búfer y, por lo tanto, no puedes seleccionar más columnas que la cantidad que cabe en este búfer. Si seleccionas más de 512 bytes, se producirá la excepción DATA_BUFFER_EXCEEDED cuando se ejecute la integración, lo que indica que excediste el tamaño máximo del búfer permitido por fila y que debes seleccionar menos columnas.

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

   Usa una función de tabla de lectura personalizada

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

   Crea una RFC_READ_TABLE personalizada en tu backend de SAP

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

   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 grupo de funciones nuevo 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 Attributes de la página SAP, selecciona Remote Enabled Module.
   3. En la pestaña Tables, establece el parámetro DATA en CHAR8000 (es posible que debas hacer clic con el botón derecho y, luego, en Display -> Change).
   4. En la pestaña Código fuente, ingresa el código RFC de tabla de lectura personalizado. Como referencia, consulta muestra Z_CUSTOM_RFC_TABLE_function.txt.
   5. Haz clic en Guardar.
   6. Define las importaciones, tablas y excepciones como se documenta en la tabla de lectura personalizada proporcionada.
   7. Activa el módulo de funciones.
   Nota: Una vez completados los pasos anteriores, en la cadena de conexión, establece el campo ReadTableFunction en Z_CUSTOM_RFC_TABLE o el nombre del módulo de función creado en los pasos anteriores.

   Tabla de lectura personalizada de 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 está diseñada para la versión 7.52 de ABAP y versiones posteriores. Es similar a la función Z_CUSTOM_RFC_TABLE, pero aprovecha las nuevas palabras clave disponibles en ABAP 7.52 para realizar la paginación dentro de la base de datos en lugar de hacerlo en la secuencia de comandos de ABAP. Esto hace que la paginación sea mucho más eficiente y mejora el rendimiento cuando se trabaja con tablas grandes. Se recomienda usar Z_CUSTOM_RFC_TABLE_752 RFC cuando sea posible.

   Usar Terraform para crear conexiones

   Puedes usar el recurso de Terraform para crear una conexión nueva.

   Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

   Si quieres ver una plantilla de Terraform de muestra para crear conexiones, consulta la plantilla de muestra.

   Cuando creas esta conexión con Terraform, debes configurar las siguientes variables en tu archivo de configuración de Terraform:

   Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
   cliente	STRING	Verdadero	El cliente que se autentica en el sistema SAP
   grupo	STRING	Falso	El grupo de inicio de sesión en uso. Por lo general, esto solo debe especificarse cuando se conecta a un sistema SAP que usa balanceo de cargas.
   message_server	STRING	Falso	El servidor de mensajes debe especificarse cuando se establece una conexión a un sistema SAP que usa balanceo de cargas.
   read_table_function	STRING	Falso	La función que se usa para leer los datos de la tabla.
   connection_scheme	ENUM	Falso	Especifica si te conectas a un sistema SAP con un servidor de mensajes (GroupServer) o sin uno (ApplicationServer). Los valores admitidos son ApplicationServer y GroupServer.
   system_id	STRING	Falso	El ID del sistema o R3Name del sistema SAP es una cadena con un máximo de tres caracteres. A menudo, se usa en conexiones de balanceo de cargas.
   system_number	STRING	Verdadero	El número por el cual se define el sistema de destino. Se usa cuando se configura la propiedad de conexión del host.
   project_id	STRING	Verdadero	El ID del proyecto de Google Cloud en el que reside el bucket de Cloud Storage que contiene el archivo jar de SAP JCo.
   bucket	STRING	Verdadero	El nombre del bucket que contiene los archivos sapjco3.jar y libsapjco3.so
   sapjco3_jar	STRING	Verdadero	El ID del objeto de sapjco3.jar
   libsapjco3_so	STRING	Verdadero	El ID del objeto de libsapjco3.so
   snc_lib	STRING	Falso	El ID del objeto de la biblioteca de SNC
   snc_mode	BOOLEAN	Falso	Un valor booleano que determina si usas SNC. Configúralo como verdadero para usar SNC.
   snc_name	STRING	Falso	Una entrada opcional con el nombre de tu conexión SNC.
   snc_qop	ENUM	Falso	La calidad de protección de tu conexión de SNC.Los valores válidos son 1, 2, 3, 8 o 9, que corresponden a los siguientes niveles de protección: 1 Solo aplica autenticación. 2 Aplicar protección de la integridad (autenticación) 3 Aplica protección de la privacidad (integridad y autenticación). 8 Aplica la protección predeterminada. 9 Aplique la máxima protección Los valores admitidos son 1, 2, 3, 8, 9.
   snc_partner_name	STRING	Falso	El nombre de SNC del servidor de aplicaciones. Esta es una entrada obligatoria cuando se usa SNC.
   query_mode	ENUM	Falso	Determina qué tablas de SAP se mostrarán como vistas, si corresponde. Los valores admitidos son Global, Local, All y None.
   table_mode	ENUM	Falso	Determina qué tablas de SAP se mostrarán como vistas, si corresponde. Los valores admitidos son los siguientes: TransparentApplication, TransparentCustomer, TransparentSystem, Pooled, Cluster, All, None.
   verbosidad	STRING	Falso	El nivel de verbosidad para la conexión varía de 1 a 5. El nivel de verbosidad más alto registrará todos los detalles de la comunicación (solicitud,respuesta y certificados SSL).

   Usa la conexión de SAP ERP en una integración

   Después de crear la conexión, estará disponible en Apigee Integration y Application Integration. Puedes usar la conexión en una integración a través de la tarea Conectores.

   • Para comprender cómo crear y usar la tarea Conectores en la integración de Apigee, consulta Tarea Conectores.
   • Para comprender cómo crear y usar la tarea Conectores en Application Integration, consulta la Tarea Conectores.

   Obtén ayuda de la Comunidad de Google Cloud

   Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.

   ¿Qué sigue?

   • Obtén información sobre cómo suspender y reanudar una conexión.
   • Aprende a supervisar el uso del conector.
   • Aprende a ver los registros del conector.