Microaplicaciones

Integrar SAP Ariba

Realice la integración en SAP Ariba para revisar y aprobar solicitudes sin necesidad de volver a iniciar sesión.

Nota:

Ofrecemos dos plantillas para la integración de SAP Ariba. Se recomienda usar la integración HTTP más reciente para la mayoría de los casos de uso. La integración HTTP ofrece mayor capacidad para configurar la estructura de datos en caché.

Para obtener una lista completa de las microaplicaciones de SAP Ariba de uso inmediato, consulte Utilizar microaplicaciones de Ariba.

Revisar requisitos previos

Necesitará estos valores para agregar la integración HTTP en las microaplicaciones de Citrix Workspace:

  • URL base: https://openapi.ariba.com/api/approval/v1/prod
  • URL del token: https://api.ariba.com/v2/oauth/token
  • ID de cliente: El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización, llamado ID de cliente OAuth en SAP. Consulte Recopilar el ID de cliente de OAuth y la clave de aplicación.
  • Secreto del cliente: El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino, emitida por SAP.
  • Clave de API de Ariba: Conocida como la clave de aplicación, reemplaza una variable en el proceso de programación. Consulte Recopilar el ID de cliente de OAuth y la clave de aplicación.
  • Territorio de Ariba: Reemplaza una variable en el proceso de programación. Para encontrarlo, póngase en contacto con el administrador de SAP para confirmar su ID de territorio.
  • ID del último cambio de Ariba: Especifica el último cambio recibido en la respuesta anterior. La respuesta incluye todos los cambios desde este. Por ejemplo, utilice 1 si quiere cargar todos los cambios desde el principio.

Nota:

Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

  • Su organización debe estar en Estados Unidos de América o en Europa.
  • Debe tener una licencia al día de una solución SAP Ariba o de un componente de una solución Ariba Network.
  • Debe tener una cuenta de administrador de API abiertas de SAP Ariba. El administrador de SAP Ariba de su organización puede solicitar acceso al portal de desarrolladores de API abiertas de SAP Ariba desde uno de los siguientes enlaces:

  • Configure Citrix Gateway para que admita Single Sign-On para SAP Ariba, de modo que, una vez que los usuarios hayan iniciado sesión, no tengan que volver a introducir sus credenciales para registrarse. Siga las instrucciones que se indican en Configuración de Single Sign-On de Ariba. Para obtener más información acerca de la configuración de SSO, consulte Citrix Gateway Service.

Configurar la integración de SAP Ariba

  1. Inicie sesión en https://developer.ariba.com/api/ con una cuenta de administrador.
  2. En la página de bienvenida, seleccione Crear aplicación.
  3. Para crear una nueva aplicación, introduzca un Nombre de la aplicación y una Descripción y seleccione Enviar.

    Su solicitud se enviará al equipo de API abiertas de SAP Ariba para su aprobación.

Recopilar el ID de cliente de OAuth y la clave de aplicación

Una vez aprobada su solicitud (descrita en la sección anterior), recibirá un correo electrónico con el token secreto de OAuth. El equipo responsable de API abiertas de SAP Ariba configurará y habilitará el back-end con su ID de territorio de Ariba.

Nota:

No podrá continuar hasta que reciba el correo electrónico de aprobación.

  1. Inicie sesión y vaya a la página Administrar aplicaciones.
  2. Seleccione la aplicación que ha creado.
  3. Copie el ID de cliente de OAuth y la clave de aplicación.
  4. Guárdelos en un lugar seguro para usarlos cuando agregue la integración a microaplicaciones de Citrix Workspace.

Agregar la integración a las microaplicaciones de Citrix

Siga estos pasos para configurar la integración HTTP de SAP Ariba. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Se recomienda usar esta integración HTTP más reciente para la mayoría de los casos de uso. La integración HTTP ofrece mayor capacidad para configurar la estructura de datos en caché.

Siga estos pasos:

  1. En la página Integraciones de microaplicaciones, seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
  2. Elija el mosaico SAP Ariba en Integraciones.
  3. En el campo Nombre de la integración, introduzca un nombre para la misma.
  4. Introduzca los parámetros del conector.
    • Introduzca la URL base de la instancia: https://openapi.ariba.com/api/approval/v1/prod
    • Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado.
  5. Introduzca la Clave de API de Ariba. Esta clave de aplicación reemplaza una variable en el proceso de programación. Consulte Recopilar el ID de cliente de OAuth y la clave de aplicación.
  6. Introduzca el territorio de Ariba. El ID de territorio de Ariba reemplaza una variable en el proceso de programación. Para encontrarlo, póngase en contacto con el administrador de SAP para confirmar su ID de territorio.
  7. Introduzca el valor del ID del último cambio de Ariba. Especifica el último cambio recibido en la respuesta anterior. La respuesta incluye todos los cambios desde este. Por ejemplo, utilice 1 si quiere cargar todos los cambios desde el principio.
  8. En Autenticación de servicio, seleccione OAuth 2.0 en el menú Método de autenticación y complete los detalles correspondientes. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Utilice el protocolo de seguridad de OAuth 2.0 para generar tokens de solicitud/autorización para el acceso delegado. Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

    1. En el menú Flujo de tipo de concesión, seleccione Credenciales del cliente.
    2. Introduzca client_credentials como Valor de tipo de concesión.
    3. Seleccione el Encabezado de la autorización en el menú Autorización de token.
    4. En el menú Tipo de contenido de token, seleccione URL codificada del formulario.
    5. Introduzca la URL del token: https://api.ariba.com/v2/oauth/token
    6. Introduzca su ID de cliente. El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Obtendrá este y el secreto al configurar el servidor de OAuth. Consulte Recopilar el ID de cliente de OAuth y la clave de aplicación.
    7. Introduzca su Secreto del cliente. El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino. Consulte Recopilar el ID de cliente de OAuth y la clave de aplicación.
  9. Habilite la opción Limitación del índice de solicitudes. Introduzca 3 como Cantidad de solicitudes y 1 segundo como Intervalo de tiempo.
  10. En el campo Tiempo de espera de solicitud, introduzca 120.
  11. (Optativo) Habilite la opción Registro para conservar un registro de 24 horas con fines de asistencia.
  12. Seleccione Guardar para continuar.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Para obtener información completa acerca de las reglas de sincronización, la sincronización que no cumple con sus reglas de programación y las reglas de veto, consulte Sincronizar datos.

Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Ariba.

Utilizar microaplicaciones de Ariba

Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Nuestra integración de SAP Ariba incluye las siguientes microaplicaciones preconfiguradas de uso inmediato:

Aprobación de solicitudes: Permite consultar las solicitudes con detalles pendientes de aprobación, además de ofrecer la acción para aprobar.

Notificación o página Flujos de trabajo por caso de uso
Notificación Pendiente de aprobación Cuando hay una nueva petición de compra pendiente de aprobación, el aprobador recibe una notificación.
Notificación Pendiente de la próxima aprobación Cuando hay una nueva petición de compra pendiente del siguiente nivel de aprobación, el aprobador siguiente recibe una notificación.
Notificación Petición creada Cuando se crea una nueva petición, el remitente recibe una notificación con detalles.
Notificación Cambio en petición Cuando se cambia el estado de una nueva petición de compra, el remitente recibe una notificación.
Página Solicitud de aprobación Proporciona una lista de solicitudes pendientes de aprobación en la que se puede buscar y un enlace a más detalles.
Página Aprobador de detalles de solicitudes Proporciona una vista detallada de una petición con acciones para Aprobar y Denegar la solicitud.
Página Solicitante de detalles de solicitud Proporciona una vista detallada de una petición al solicitante.

Agregar la integración antigua de SAP Ariba

Agregue la integración de SAP Ariba a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo. Tras configurar esta integración en SAP Ariba, necesitará estos artefactos para agregar la integración en las microaplicaciones de Citrix Workspace:

  • URL de API
  • URL de token OAuth
  • ID de cliente de OAuth
  • Secreto de cliente de OAuth
  • Clave de la aplicación
  • ID de territorio

Siga estos pasos:

  1. En la página de descripción general de las microaplicaciones, seleccione Introducción.

    Se abrirá la página Administrar integraciones.

  2. Seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
  3. Elija el mosaico Ariba.
  4. Introduzca un nombre para la integración.

    Parámetros del conector de Ariba, URL de API, URL de token de OAuth, ID de cliente de OAuth, secreto del cliente de OAuth, clave de aplicación, ID de territorio

  5. Introduzca los parámetros del conector que recopiló en los procedimientos anteriores.
    • Introduzca las credenciales de URL de API y URL de token OAuth para la autenticación del servicio de los sistemas de destino.
    • Introduzca su ID de cliente de OAuth y el secreto de cliente.
    • Introduzca su clave de aplicación y su ID de territorio.
    • Active Sandbox si necesita que los datos se carguen en un entorno de espacio aislado o sandbox.
    • Introduzca un valor para Límite de solicitudes, máximo de solicitudes/s a los servicios de Ariba. Este campo es obligatorio y determina el número de llamadas por segundo. Hable con su representante de Ariba acerca de los límites de su instancia para configurar el valor correctamente. Recomendamos 10 llamadas/segundo o menos como tasa segura inicial si no se conoce el límite. Se puede utilizar Cero para desactivar completamente todas las limitaciones. Sin embargo, una tasa de solicitudes demasiado alta puede dar lugar a denegación de acceso.
    • Seleccione un valor para Cambiar ID, donde comienza la sincronización completa. Cuando la sincronización completa comienza a limitar la cantidad de datos que se cargan, los cambios anteriores se omiten durante el proceso. Deje este valor vacío para cargar todo.
    • (Opcional) Habilite la opción para ignorar el error 400 (solicitud incorrecta) durante la sincronización para la recuperación frente a errores de este tipo. Si se eliminan registros Ariba durante la sincronización, la API de Ariba devuelve un error, puesto que los datos solicitados ya no existen. Se genera una advertencia en el registro.
  6. Seleccione Agregar.

Se abrirá la página Integraciones de microaplicaciones con la integración agregada y sus microaplicaciones. Desde aquí, puede agregar otra integración, seguir configurando sus microaplicaciones de uso inmediato o crear una microaplicación para esta integración.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Como se puede extraer una gran cantidad de datos de la aplicación integrada y transferirla a la plataforma de microaplicaciones, le recomendamos utilizar la página Tabla para filtrar entidades relacionadas con la primera sincronización de datos y, así, acelerar la sincronización. Para obtener más información, consulte Verificar las entidades necesarias. Para obtener información completa acerca de las reglas de sincronización, la sincronización que no cumple con sus reglas de programación y las reglas de veto, consulte Sincronizar datos.

Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Ariba.

Microaplicaciones antiguas de SAP Ariba

Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Nuestra integración antigua de SAP Ariba incluye las siguientes microaplicaciones preconfiguradas de uso inmediato:

Aprobación de solicitudes: Permite consultar las solicitudes con detalles pendientes de aprobación, además de ofrecer la acción para aprobar.

Notificación o página Flujos de trabajo por caso de uso
Notificación Pendiente de aprobación (cambio) Cuando se cambian los detalles de una petición de compra pendiente de aprobación, el aprobador recibe una notificación.
Notificación Pendiente de aprobación (nuevo) Cuando hay una nueva petición de compra pendiente de aprobación, el aprobador recibe una notificación.
Notificación Cambio en petición Cuando se cambia el estado de una nueva petición de compra, el usuario recibe una notificación.
Notificación Petición creada Cuando se crea una petición de compra (es decir, se envía o se está preparando), el usuario recibe una notificación.
Página Solicitudes de aprobación Ofrece una lista personalizada de las solicitudes de aprobación y un enlace a más datos.
Página Detalles de la solicitud Ofrece una vista detallada de una petición y un botón de aprobación accionable.
Integrar SAP Ariba