SAP Ariba Procurement

El conector de SAP Ariba Procurement te permite realizar operaciones de inserción, actualización y lectura en los datos de SAP Ariba Procurement.

Versiones compatibles

Este conector admite las APIs de REST de SAP Ariba Procurement.

Antes de comenzar

En tu proyecto de Google Cloud, realiza las siguientes tareas:

  • Asegúrate de que la conectividad de red esté configurada. Para obtener más información, consulta Conectividad de red.
  • Otorga el rol de IAM roles/connectors.admin al usuario que configura el conector.
  • Otorga los roles de IAM roles/secretmanager.viewer y roles/secretmanager.secretAccessor a la cuenta de servicio que deseas usar para el conector.
  • Habilita secretmanager.googleapis.com (API de Secret Manager) y connectors.googleapis.com (API de Connectors). Para obtener más información, consulta Cómo habilitar servicios.

Configura el conector

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, haz lo siguiente:

  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, completa lo siguiente:
    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: Selecciona SAP Ariba Procurement en la lista de conectores disponibles.
    2. Versión del conector: Selecciona la versión del conector de la lista de versiones disponibles.
    3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión. El nombre de la conexión puede contener letras minúsculas, números o guiones. El nombre debe comenzar con una letra y terminar con una letra o un número, y no debe superar los 49 caracteres.
    4. Descripción: Ingresa una descripción para la instancia de conexión.
    5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
    6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
    7. ANID: Especifica tu ID de red de SAP Ariba.
    8. Clave de API: Ingresa la clave de la aplicación de OAuth para la autenticación.
    9. Reino: Ingresa el reino de SAP Ariba para la conexión.
    10. API: Ingresa la API de SAP Ariba desde la que se recuperarán los datos.
    11. Centro de datos: Ingresa la ubicación geográfica en la que se alojan los datos de tu cuenta.
    12. Entorno: Ingresa el entorno de SAP Ariba al que deseas conectarte.
    13. 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.

    14. + AGREGAR ETIQUETA: Haz clic aquí para agregar una etiqueta a la conexión en forma de un par clave-valor.
    15. Haz clic en Siguiente.
  5. 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 de SAP Ariba Procurement admite los siguientes tipos de autenticación:

      • Credenciales de cliente de OAuth 2.0

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

    2. Haz clic en Siguiente.
  6. Revisa: Revisa tus detalles de conexión y autenticación.
  7. Haz clic en Crear.

Configura la autenticación

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

  • OAuth 2.0, credenciales de cliente
    • ID de cliente: Ingresa el ID de cliente de la aplicación que creaste.
    • Secreto del cliente: Ingresa el secreto de Secret Manager que contiene el secreto del cliente para la app conectada que creaste.
    • Versión del secreto: Selecciona la versión del secreto para el secreto del cliente.
    • Enable Authentication Override: Habilita esta opción para la anulación de autenticación.

Muestras de configuración de conexión

En esta sección, se enumeran los valores de muestra para los distintos campos que configuras cuando creas la conexión.

OAuth 2.0: Tipo de conexión de credenciales de cliente

Nombre del campo Detalles
Ubicación europe-west1
Conector SAP Ariba Procurement
Versión del conector 1
Nombre de la conexión gcp-sapariba-procurement-po-supplier
Habilita Cloud Logging Sí
Cuenta de servicio my-service-account@my-project.iam.gserviceaccount.com
Nivel de registro Depuración
ANID AN11234322444-T
Clave de API gaTawAf8m3gtAs8gPyUbU9Be1eLXbvFq
Dominio 745628447-T
API PurchaseOrdersSupplierAPI-V1
Centro de datos EE.UU.
Entorno PROBAR
Cantidad mínima de nodos 2
Cantidad máxima de nodos 50
Autenticación Credenciales de cliente de OAuth 2.0
ID de cliente 4c71c4d4-d7e9-494e-807f-9dead41abc6f
Secreto del cliente projects/617888503870/secrets/AribaProcurement/versions/10
Versión del Secret 10

Limitaciones del sistema

El conector de SAP Ariba Procurement puede procesar un máximo de 3 transacciones por segundo, por nodo, y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para una mejor disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Usa la conexión de SAP Ariba Procurement en una integración

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

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

Acciones

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

Acción CreateChildElementSchema

Esta acción crea un archivo de esquema para un array de documentos en la plantilla de vista.

Parámetros de entrada de la acción CreateChildElementSchema

Nombre del parámetro Tipo Acepta transmisiones de salida Descripción
ViewTemplateName String Falso Es el nombre de una plantilla de vista existente.
ChildElement String Falso Elemento secundario o array de documentos en la plantilla de vista en notación de puntos, como LineItems.SplitAccountings.
TableName String Falso Nombre de la tabla nueva, como View_LineItems_SplitAccountings.
Nombre del archivo String Falso Nombre del archivo del esquema generado. Puede ser una ruta de acceso relativa o absoluta a la ubicación de guardado deseada.
FileStream String Verdadero Es una instancia de una transmisión de salida en la que se escriben los datos del archivo.

Para ver un ejemplo sobre cómo configurar la acción CreateChildElementSchema, consulta Ejemplos.

Acción CreateSchema

Crea un archivo de esquema para la tabla o vista especificada.

Parámetros de entrada de la acción CreateSchema

Nombre del parámetro Tipo Acepta transmisiones de salida Descripción
TableName String Falso Nombre de la tabla nueva.
Nombre del archivo String Falso Nombre del archivo del esquema generado. Puede ser una ruta de acceso relativa o absoluta a la ubicación de guardado deseada.
FileStream String Falso Es una instancia de una transmisión de salida en la que se escriben los datos del archivo.

Para ver un ejemplo sobre cómo configurar la acción CreateSchema, consulta Ejemplos.

Ejemplos de acciones

En esta sección, se muestra cómo realizar algunos de los ejemplos de acciones en este conector.

Ejemplo: Crea un esquema de elementos secundarios

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción CreateChildElementSchema y haz clic en Listo.
  3. En la sección Entrada de tarea de la tarea connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
  "ViewTemplateName": "InvoiceReconciliation_SAP_createdRange",
  "ChildElement": "Payments",
  "TableName": "View_LineItems_SplitAccountings"
}

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

    [
  {
    "FileData": "",
    "Result": "success"
  }
]

Ejemplo: Crea un esquema

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción CreateSchema y haz clic en Listo.
  3. En la sección Entrada de tarea de la tarea connectors, haz clic en connectorInputPayload y, luego, ingresa un valor similar al siguiente en el campo Default Value: 
    {
  "TableName": "Views"
}

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

    [
  {
    "FileData": "",
    "Result": "success"
  }
]

Ejemplos de operaciones de entidades

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

Ejemplo: Enumera todos los pedidos

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Orders en la lista Entity.
  3. Selecciona la operación List y haz clic en Listo.
  4. En la sección Entrada de tarea de la tarea conectores, puedes establecer la cláusula de filtro según los requisitos del cliente.

    5. Debes usar comillas simples ("'") para incluir el valor de un filterClause. Puedes usar filterClause para filtrar registros según las columnas.

Ejemplo: Enumera todos los conceptos

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona LineItems en la lista Entity.
  3. Selecciona la operación List y haz clic en Listo.
  4. En la sección Task Input de la tarea connectors, puedes establecer la filterClause según los requisitos del cliente.

Ejemplo: Obtén los detalles de un pedido

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Orders en la lista Entity.
  3. Selecciona la operación Get y haz clic en Listo.
  4. Establece entityId en "DO240", que es la clave que se pasará. Para establecer el entityId, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "DO240" en el campo Input Value y elige entityId como variable local.

    5. Debes pasar el valor de entityId directamente, como "DO240". Aquí, "DO240" es el valor único de la clave primaria.

    Si pasar un solo entityId arroja un error debido a la presencia de dos claves compuestas, puedes usar filterClause para pasar el valor, como DocumentNumber='DO240'.

Ejemplo: Obtén los detalles de una línea de pedido

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona LineItems en la lista Entity.
  3. Selecciona la operación Get y haz clic en Listo.
  4. Establece filterClause en LineNumber='1' AND DocumentNumber='DO240', que son las claves compuestas que se pasarán. Para configurar filterClause, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "LineNumber='1' AND DocumentNumber='DO240'" en el campo Input Value y elige filterClause como variable local.

Ejemplo: Crea una vista

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Views en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige entityId, connectorInputPayload o filterClause como variable local. 
    {
  "ViewTemplateName": "TestView1754629881645",
  "Status": "published",
  "FilterExpressions": "[{\"name\":\"ExampleFilter\",\"field\":\"UniqueName\",\"op\":\"IN\",\"defaultValue\":[\"P011\"]}]",
  "DocumentType": "DirectOrder",
  "SelectAttributes": "[\"SubmitDate\"]"
}

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "Success": true
}

Ejemplo: Actualiza una vista

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Views en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value. 
    {
  "Status": "published"
}
  5. Establece el entityId en Data Mapper como el ID de las vistas. Para establecer el entityId, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y elige entityId, connectorInputPayload o filterClause como variable local.

    En lugar de especificar entityId, también puedes establecer filterClause en TestView = '1754629881645'.

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
}

    Un objeto JSON vacío {}en la respuesta indica que la operación de actualización se realizó correctamente.

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?