Integration Service
latest
false
Importante :
Este contenido se ha traducido mediante traducción automática. Los paquetes de conectores disponibles en Integration Service están traducidos con traducción automática.
Guía de usuario de Integration Service
Automation CloudAutomation Cloud Public Sector
Last updated 19 de jul. de 2024

Crear tu conector a partir de una definición de API

Crear un nuevo conector

  1. Si seleccionas Iniciar desde una definición de API, debes proporcionar la definición de API:

    • Desde un archivo local: carga una colección Postman o Swagger.
    • Desde una URL: introduce una URL de archivo, como https://petstore.swagger.io/v2/swagger.json.


  2. Haz clic en Continuar.

Configura tu conector

  1. En la ventana Confirmar importación, puedes:

    • Cambia el nombre del proveedor, el nombre de la aplicación y el nombre del conector.
    • Modifica los recursos que quieres utilizar en tu conector personalizado. Todos los recursos disponibles se habilitan automáticamente; deshabilite los que desea excluir.

      • Utiliza la barra de búsqueda para buscar un recurso específico.

    • Haz clic en Crear.

      docs image

  2. Aparecerá la ventana Configuración.
  3. En la pestaña Información puedes configurar los siguientes campos:

    • Nombre : se refleja en la clave del conector.
    • Tipo de API: este campo está deshabilitado por defecto, ya que actualmente solo se admite REST.
    • Categorías : puedes seleccionar entre las categorías disponibles, como Inteligencia artificial o Marketing, o crear la tuya propia.
    • Descripción: introduce una descripción para tu conector.
    • Icono : haz clic en Navegar para cargar una imagen desde tu ordenador. Se admiten todos los tipos de imágenes, pero recomendamos utilizar un SVG cuadrado.
  4. La vista previa del catálogo muestra cómo aparecerá tu conector personalizado en el catálogo de conectores de Integration Service.
  5. Haz clic en Guardar.

    docs image

Configurar la API base

En la pestaña API base , se configura la URL base para la API y la paginación de la aplicación:

  • URL base : se rellena automáticamente con el valor declarado en la creación del conector.
  • Tipo de paginación: las opciones disponibles en el menú desplegable son: Inicio de página con 1, Inicio de página con 0, Desplazamiento, Personalizado. Si la documentación del proveedor no proporciona ningún detalle sobre la paginación, mantenga el valor predeterminado.
  • Paginación máxima : el valor predeterminado es 100. Si la documentación del proveedor no proporciona ningún detalle sobre la paginación, mantenga el valor predeterminado.
  • Encabezado de tipo de contenido : este campo está deshabilitado de forma predeterminada, ya que actualmente solo se admite application/json .
  • Aceptar encabezado : este campo está deshabilitado de forma predeterminada, ya que actualmente solo se admite application/json .


Establecer el método de autenticación

En la pestaña Autenticación , configuras el tipo de autenticación para tu conector. Consulta más información sobre las opciones compatibles en Tipos de autenticación.

Pruebe su conexión

Una vez que hayas completado la configuración de autenticación, selecciona Añadir conexión en el menú desplegable:

Si tu conexión es correcta, el estado se actualiza a Conectado.

Recursos

El Creador de conectores genera la lista de recursos en función de la definición de la API proporcionada. El menú de la izquierda muestra la lista de recursos disponibles, organizados en grupos.



  1. Haz clic en Más opciones docs image menú de botones para configurar aún más cada método. Puedes:
    • Añadir método : abre la ventana Crear nuevo recurso .
    • Permitir eliminación de método : activa un icono Eliminar para cada recurso del grupo.
    • Editar ruta : edita la ruta del recurso. Por ejemplo: [BASE URL]/pet = https://petstore.swagger.io/v2/pet
    • Eliminar : elimina un grupo de recursos. Un mensaje le advierte que la operación no se puede deshacer.
    • Duplicar : abre la ventana Duplicar recurso , donde puedes editar la ruta, elegir un nombre para mostrar y seleccionar métodos.


  2. También puedes Crear un nuevo grupo de recursos de dos maneras:

    • En blanco: configura los siguientes campos:
      • Ruta : [Base URL]/[path]
      • Nombre para mostrar
      • Seleccionar métodos: Obtener, Obtener por ID, Publicar, Poner, Parchear, Eliminar


    • Desde cURL: introduce un comando cURL.

Configura tus recursos

Cuando seleccionas un recurso, se muestra la siguiente ventana:



Dependiendo del método de recurso que selecciones, estarán disponibles las siguientes pestañas de configuración: Parámetros, Campos de respuesta/solicitud, Paginación, Búsqueda.

Parámetros

Por ejemplo, las cuatro pestañas están disponibles para los métodos GET. Para los métodos POST, solo se pueden ver las pestañas Parámetros, Campos de solicitud y Campos de respuesta.

En Parámetros, puedes ver la lista de parámetros disponibles para el recurso seleccionado, añadir nuevos parámetros o importar parámetros de un recurso existente.

Los parámetros enumerados en esta tabla son los que usará en Studio al crear automatizaciones con su conector personalizado.

El objeto mascota corresponde al grupo de recursos mascota, y los campos disponibles son los establecidos para el recurso GETBYID:



Campos de respuesta y solicitud
Nota:

Los objetos de matriz anidados no son compatibles actualmente.

Los campos Respuesta y Solicitud para cada recurso se generan automáticamente al enviar una solicitud.

En cada pestaña respectiva, puede editar o eliminar cualquier campo. Si haces clic en el icono Editar , se muestra la siguiente ventana de configuración:



En la pestaña Campos de respuesta/solicitud , también están disponibles las siguientes opciones:

  • Casilla de verificación Sobrescribir al enviar solicitud : si se selecciona, al ejecutar una solicitud de envío, se regenera la lista de campos. No selecciones esta opción si has añadido nuevos campos a tu recurso.
  • Botón de opciones adicionales :

    Opción

    Lo que hace

    Actualizar la clave raíz de respuesta

    Defina la clave de respuesta cuando trabaje con matrices anidadas en la respuesta.

    Eliminar todos los campos para el método

    Elimina todos los campos del método seleccionado.

    Generar a partir de carga útil

    Utilice una carga útil de muestra de la documentación de servicio o una llamada a la API para generar los campos de recursos.

  • Botón Añadir fila : añade nuevos campos al recurso.

Haga clic en el icono de Columnas visibles para agregar o eliminar columnas en la tabla de campos.



Cada color de la columna Métodos corresponde a un método concreto: Obtener, Obtener por ID, Publicar, Colocar, Parchear, Eliminar.



Paginación

Habilita la paginación para un recurso si esperas una respuesta de lista. Si habilitas la paginación, también necesitarás definir la clave raíz de respuesta en la pestaña de configuración, para las listas anidadas.

Buscar

Activa la casilla de verificación Habilitar búsqueda para permitir la configuración de la búsqueda para un recurso.

Después de configurar todo lo que necesitas, puedes continuar con .

  • Crear un nuevo conector
  • Configura tu conector
  • Configurar la API base
  • Establecer el método de autenticación
  • Pruebe su conexión
  • Recursos

¿Te ha resultado útil esta página?

Obtén la ayuda que necesitas
RPA para el aprendizaje - Cursos de automatización
Foro de la comunidad UiPath
Uipath Logo White
Confianza y seguridad
© 2005-2024 UiPath. Todos los derechos reservados.