Consulta los conectores compatibles con Application Integration.

Editar tareas

La tarea Conectores te permite conectarte de forma rápida y segura a los distintos servicios de Google Cloud y a otras aplicaciones empresariales desde tu integración mediante los conectores predefinidos disponibles en Integration Connectors.

Para ver la lista de todos los conectores compatibles con Application Integration, consulta la referencia de conectores.

Antes de empezar

  • Asegúrate de que tienes asignado el rol de gestión de identidades y accesos Administrador de conectores (roles/connectors.admin) en tu proyecto de Google Cloud. Para obtener información sobre cómo conceder roles, consulta el artículo sobre cómo gestionar el acceso.
  • Consulta los conceptos generales de los conectores de integración.
  • Para conectarte a los servicios de Google Cloud y a otras aplicaciones empresariales mediante un conector, asegúrate de haber vinculado una cuenta de servicio gestionada por el usuario a tu integración. Si tu integración no tiene configurada una cuenta de servicio gestionada por el usuario, se usará de forma predeterminada la cuenta de servicio predeterminada (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) para la autenticación.
  • Asegúrate de que tu cuenta de servicio tenga el rol de gestión de identidades y accesos necesario. Para obtener información sobre cómo conceder roles a una cuenta de servicio, consulta el artículo sobre cómo gestionar el acceso a cuentas de servicio.

Añadir una tarea de conectores

Para añadir la tarea Connectors a tu integración, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

    Ir a Application Integration

  2. En el menú de navegación, haz clic en Integraciones.

    Aparecerá la página Integraciones, en la que se muestran todas las integraciones disponibles en el proyecto de Google Cloud.

  3. Seleccione una integración o haga clic en Crear integración para crear una.

    Si vas a crear una integración:

    1. Escribe un nombre y una descripción en el panel Crear integración.
    2. Selecciona una región para la integración.
    3. Selecciona una cuenta de servicio para la integración. Puede cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración de la barra de herramientas de integración.
    4. Haz clic en Crear. La integración que acabas de crear se abre en el editor de integraciones.

  4. En la barra de navegación del editor de integraciones, haz clic en Tareas para ver la lista de tareas y conectores disponibles.

    5. imagen que muestra la tarea de conectores

  5. Si quieres configurar una nueva conexión, haz clic en el elemento Conectores y colócalo en el editor de integraciones. A continuación, haz clic en Configurar conector para configurar la conexión.

    imagen que muestra la lista de tareas del conector imagen que muestra la lista de tareas del conector

  6. Si ya tienes una conexión, haz clic en la pestaña Conectores para ver las conexiones creadas recientemente. También puedes buscar un conector, una conexión o una tarea introduciendo el nombre en el campo Buscar.

    imagen que muestra la función de búsqueda de tareas de conectores

  7. Haga clic en el elemento Conectores configurado y colóquelo en el editor de integraciones. Para obtener información sobre cómo configurar una tarea de conector, consulta Configurar la tarea de conectores.

Configurar la tarea Connectors

Para configurar una tarea de conectores, sigue estos pasos:

  1. Haga clic en el elemento de tarea Conectores del diseñador para ver el panel de configuración de la tarea Conectores.

    También puedes hacer clic en para cambiar el nombre de la tarea.

  2. Haz clic en Configurar conector.
  3. Puedes seleccionar una conexión que ya tengas en la región o crear una nueva. Para configurar una conexión, siga estos pasos en la página Editor de tareas de conectores.

    En la siguiente imagen se muestra un diseño de ejemplo de la página Editor de tareas de conectores. Imagen que muestra el cuadro de diálogo Configurar tarea de conector Imagen que muestra el cuadro de diálogo Configurar tarea de conector

    1. En la sección Seleccionar conexión, selecciona la región de la conexión.
    2. Elige una conexión de la lista de conexiones disponibles en la región seleccionada.
    3. Haz clic en Siguiente.
    4. En la lista Tipo, selecciona Entidades o Acciones.
      • Si seleccionas Entidades, se mostrará la lista de entidades admitidas para la conexión en la sección Definir entidades o acciones. Selecciona una entidad y, a continuación, la operación que quieras realizar en esa entidad.
      • Si selecciona Acciones, la lista de acciones admitidas para la conexión se mostrará en la columna Definir entidades o acciones. Selecciona una acción para la conexión.
        • Las entidades y las acciones admitidas se basan en el tipo de conector. Para ver la lista de todos los conectores compatibles con Application Integration, consulta la referencia de conectores. Para ver las acciones y entidades admitidas de un conector, consulta la documentación específica del conector.

        Si el conector admite consultas SQL personalizadas, puede seleccionar la opción Ejecutar consulta personalizada en la lista Acciones. Para obtener información sobre cómo añadir una consulta de SQL personalizada a un conector, consulta Acción: ejecutar una consulta de SQL personalizada.

    5. Haz clic en Hecho para completar la configuración de la conexión y cerrar el panel.

Configurar variables de entrada y salida de tareas

En el panel de configuración de tareas Conectores se muestran las variables Entrada de tarea y Salida de tarea, que se generan automáticamente en función de la entidad y la operación o la acción seleccionadas en el cuadro de diálogo Configurar tarea de conector. Estas variables se pueden configurar y se puede acceder a ellas como entradas de la tarea actual o como salidas de tareas posteriores, o bien como condicionales de la integración actual.

Para configurar las variables Entrada de tarea o Salida de tarea, haz clic en la variable correspondiente para abrir el panel Configurar variable y sigue estos pasos:

  1. Introduce el valor de la variable en el campo Valor predeterminado.
  2. (Opcional) Selecciona Usar como entrada para la integración o Usar como salida para la integración.
  3. Haz clic en Guardar.

Para obtener más información sobre los parámetros de entrada y salida de la tarea Conectores, consulta Operaciones de entidades.

Configurar la anulación de la autenticación

Para habilitar la conexión de forma que acepte diferentes autenticaciones de backend de forma dinámica durante el tiempo de ejecución, asegúrate de que, en Integration Connectors, hayas seleccionado la opción Enable Authentication Override (Habilitar la anulación de la autenticación) para tu conexión.

Para configurar la anulación de la autenticación, haz lo siguiente:

  1. Haz clic en el elemento de tarea de conectores del diseñador para ver el panel de configuración de la tarea Conectores.
  2. Despliega la sección Introducción de tareas. El campo Credenciales de usuario final se asigna a una variable dynamicAuthConfig.

    Credenciales de usuario final Credenciales de usuario final

    A continuación, haz lo siguiente:

    1. Haz clic en la variable dynamicAuthConfig. Aparecerá el panel Editar variable.

      Para anular la autenticación, debes proporcionar los valores de autenticación cuando pruebes la integración.

      Editar variable dinámica de la UE Editar variable dinámica de la UE

      sigue estos pasos:

      1. En la lista Tipo de variable, selecciona Entrada de integración.
      2. En las opciones del esquema JSON, puedes verificar el tipo de autenticación configurado para la conexión. Usa este esquema para anular el valor de autenticación cuando pruebes la integración.

        Probar la integración de la anulación de autenticación Probar la integración de la anulación de autenticación

    También puedes enviar la autenticación como encabezado HTTP seleccionando la casilla Usar encabezado HTTPS para la configuración de autenticación en la sección Entrada de tarea del panel de configuración de la tarea Conectores.

    Probar la integración enviando la autenticación como encabezado HTTP Probar la integración enviando la autenticación como encabezado HTTP

Operaciones y acciones de entidades

Puedes realizar operaciones CRUD (crear, leer, actualizar y eliminar) en las entidades de un conector. Cada una de estas operaciones de entidad tiene un conjunto diferente de parámetros de entrada y salida. En la tabla siguiente se enumeran los parámetros de entrada y salida de las distintas operaciones de entidad.

Nombre de la operación Parámetros de entrada Parámetros de salida
Lista
  • listEntitiesPageSize
  • listEntitiesPageToken
  • listEntitiesSortByColumns
  • filterClause
  • connectorOutputPayload
  • listEntitiesNextPageToken
Obtener entityId connectorOutputPayload
Crear connectorInputPayload connectorOutputPayload
Actualizar
  • connectorInputPayload
  • entityId
  • filterClause
 connectorOutputPayload
Eliminar
  • entityId
  • filterClause
 N/A

Parámetros de entrada

En la siguiente tabla se describen los parámetros de entrada de las distintas operaciones de entidad.

Nombre del parámetro Tipo de datos Descripción
entityId Cadena

Identificador único de la fila a la que quieres acceder.

Normalmente, entityId es el valor de la clave principal de una tabla o un conjunto de datos. Si especifica un valor para entityId y la tabla o el conjunto de datos no tienen una columna de clave principal, la integración informa de un error de tiempo de ejecución y la tarea Conectores falla.

Por ejemplo, para obtener una fila específica de una tabla de MySQL, entityId es el valor de la clave principal de la tabla.
connectorInputPayload JSON Los datos reales que se van a añadir o actualizar en una entidad. En el siguiente ejemplo se muestra el fragmento JSON de los datos de una fila que se va a añadir a una tabla: 
{
"employee_first_name": "John",
"employee_emailID": "test-05@test.com"
}

En este ejemplo, employee_first_name y employee_emailID son los nombres de las columnas con los valores correspondientes John y test-05@test.com.
filterClause Cadena Restringe el resultado de las operaciones en función de una condición. Para obtener más información sobre cómo añadir una cláusula de filtro, consulta Añadir un filtro a una operación.
listEntitiesPageSize Entero

Especifica el número de resultados que se deben devolver en una página.

Una página es una agrupación lógica de los registros de un conjunto de resultados. El concepto de página es útil cuando se espera un gran número de registros en el conjunto de resultados. Si el conjunto de resultados es grande, es posible que la tarea Conectores falle, ya que hay un límite en el tamaño de los datos que puede procesar. Si divides el conjunto de resultados en fragmentos más pequeños, puedes evitar este problema.

Por ejemplo, si esperas 1000 registros en el conjunto de resultados, puedes definir listEntitiesPageSize en 100. Por lo tanto, cuando la tarea Connectors se ejecuta por primera vez, devuelve los primeros 100 registros, los siguientes 100 registros en la segunda ejecución y así sucesivamente.

listEntitiesPageToken Cadena

Un identificador de página (token) que te permite acceder a una página específica.

Puede obtener el valor de un token de página del parámetro de salida listEntitiesNextPageToken. Como cada página tiene un token único, puedes acceder a cualquier página del conjunto de resultados. Para entender el uso de este parámetro, consulta también la descripción del parámetro de salida listEntitiesNextPageToken.
listEntitiesSortByColumns Matriz de cadenas Nombre de la columna por la que quieres ordenar el conjunto de resultados.

Parámetros de salida

En la siguiente tabla se describen los parámetros de salida de las distintas operaciones de entidad.

Nombre del parámetro Tipo de datos Descripción
connectorOutputPayload JSON El resultado de una operación en formato JSON.
listEntitiesNextPageToken Cadena

Identificador generado por el sistema de una página. Puedes considerar el token como un puntero con el que puedes acceder a una página concreta del conjunto de resultados.

Si has dividido el conjunto de resultados en varias páginas configurando el parámetro listEntitiesPageSize, necesitas un mecanismo para desplazarte por las páginas. El parámetro de salida listEntitiesNextPageToken te permite hacer precisamente eso. Cada vez que se ejecuta la tarea Conectores, el sistema genera un token para la página siguiente y asigna el valor del token recién generado a listEntitiesNextPageToken. Después, puedes usar este token para acceder a la siguiente página del conjunto de resultados. Para acceder a la página siguiente, debe definir el parámetro de entrada listEntitiesPageToken con el valor del token de la página siguiente.

Por ejemplo, supongamos que ha definido el parámetro listEntitiesPageSize en 2 y que, cuando se ejecuta la tarea Connectors por primera vez, listEntitiesNextPageToken se define en el valor del token ChoKC2VtcGxveWVlX2lkEgkRAAAAAAAA8D8YDw==. Después, puedes asignar el valor de este token al parámetro de entrada listEntitiesPageToken para obtener la página siguiente en la ejecución posterior de la tarea Connectors.

Si el conjunto de resultados tiene un gran número de páginas, puedes usar la tarea Bucle While para obtener la página siguiente y la tarea Asignación de datos para asignar automáticamente valores de token de página al parámetro de entrada listEntitiesPageToken después de cada ejecución. Asigna listEntitiesNextPageToken de la última iteración del bucle a listEntitiesPageToken en la LIST Operation de la tarea Connectors de la iteración del bucle actual. La tarea Bucle While finaliza cuando listEntitiesNextPageToken es NULL, lo que implica que no hay más páginas.

Cláusula de filtro para operaciones de entidades

Puede restringir los registros que procesa la tarea Conectores mediante la variable Cláusula de filtro, que está disponible como Entrada de tarea. Por ejemplo, en el caso de una operación de eliminación, puede añadir una cláusula de filtro para eliminar registros con un orderId específico.

La cláusula de filtro solo se puede aplicar a las siguientes operaciones de entidad:

  • Lista
  • Eliminar
  • Actualizar

Cuando seleccionas cualquiera de estas operaciones, la sección Entrada de tarea de la tarea Conectores muestra automáticamente el campo Cláusula de filtro.

Añadir una cláusula de filtro

Para añadir una cláusula de filtro, sigue estos pasos:

  1. Haga clic en el elemento de tarea Conectores del diseñador para ver el panel de configuración de la tarea Conectores.
  2. Despliega la sección Task Input (Entrada de tarea) y haz clic en la variable de cadena filterClause(Connectors) (Cláusula de filtro [conectores]).

    Aparecerá el cuadro de diálogo Configurar variable.

  3. Introduce la cláusula de filtro (siguiendo la sintaxis de la cláusula) en el campo Valor predeterminado.
  4. Haz clic en Guardar.

Sintaxis y ejemplos de cláusulas de filtro

Una cláusula de filtro tiene el siguiente formato:

FIELD_NAME CONDITION FILTER_VALUE

Ejemplos

  • OwnerId = '0053t000007941XAAQ'
     
  • PoNumber < 2345
     
  • OrderNumber = 00110 AND StatusCode = 'Draft'
     
  • TotalAmount > 2500
     
  • ShippingPostalCode = 94043 OR ShippingPostalCode = 77002

Uso de variables en la cláusula de filtro

No puedes usar directamente una variable de integración en una cláusula de filtro. Si quieres usar una variable de integración, primero debes configurar una tarea de asignación de datos para crear una asignación entre la variable de integración y la cláusula de filtro.

En la siguiente tabla se muestra una asignación de ejemplo entre una variable de integración y la variable filterClause(Connectors):

Entrada Salida
PRIMARY_KEY_ID = ' .CONCAT(INTEGRATION_VARIABLE) .CONCAT(') filterClause(Connectors)
Donde PRIMARY_KEY_ID = ' se introduce como Valor en la fila de entrada.

Acción: ejecutar una consulta de SQL 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.

    Imagen que muestra la acción execute-custom-query Imagen que muestra la acción execute-custom-query

  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.

      Imagen que muestra custom-sql-query Imagen que muestra custom-sql-query

    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.

      Imagen que muestra la opción para añadir un parámetro de consulta Imagen que muestra la opción para añadir un parámetro de consulta

      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.

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

Actualización del esquema

Todas las entidades y acciones tendrán un esquema asociado. Por ejemplo, un esquema de acción tendrá los detalles de los parámetros, como los nombres de los parámetros y su tipo de datos correspondiente. La conexión obtiene el esquema (metadatos) de las entidades y las acciones en tiempo de ejecución de tu backend. Si se realizan cambios en el esquema, estos no se reflejarán automáticamente en las conexiones que ya tengas. Debes actualizar el esquema manualmente. Para ver el esquema actualizado en las tareas de conector que ya tengas, sigue estos pasos:
  1. En Integration Connectors, abre la página Detalles de la conexión de la conexión y, a continuación, haz clic en Actualizar esquema de conexión.
  2. En Integración de aplicaciones, debes volver a configurar la tarea del conector para la misma conexión.

Creación de conexiones insertadas

Puedes usar la tarea Conectores para crear directamente una conexión en Integration Connectors.

Antes de empezar

Crear conexión

Para crear una conexión desde Application Integration, sigue estos pasos:

  1. Haga clic en el elemento de tarea Conectores del diseñador para ver el panel de configuración de la tarea Conectores.
  2. Haz clic en Configurar conector.

    Aparecerá la página Editor de tareas de conectores.

  3. Omite el campo Región.
  4. Haz clic en Conexión y selecciona la opción Crear conexión en el menú desplegable.
  5. Siga estos pasos en el panel Crear conexión:
    1. En el paso Ubicación, elija la ubicación de la conexión.
      1. Haz clic en Región y selecciona una ubicación de la lista desplegable.
      2. Haz clic en Siguiente.
    2. En el paso Detalles de la conexión, proporcione información sobre la conexión:
      1. Conector: en la lista desplegable, selecciona el tipo de conector que quieras crear. Para obtener información sobre la lista de conectores admitidos, consulta Todos los conectores de integración.
      2. Versión del conector: elige una versión disponible del tipo de conector seleccionado en la lista desplegable.
      3. Nombre de la conexión: introduce un nombre para la instancia de conexión.
      4. (Opcional) Introduce una Descripción de la instancia de conexión.
      5. (Opcional) Marca la opción Habilitar Cloud Logging para almacenar los datos de registro de la instancia de conexión.
      6. Cuenta de servicio: selecciona una cuenta de servicio que tenga los roles necesarios.
      7. (Opcional) Haz clic en Configuración avanzada para configurar los ajustes del nodo de conexión.

        Para obtener más información, consulta la documentación de la conexión correspondiente en Integration Connectors.

      8. (Opcional) Haz clic en + AÑADIR ETIQUETA para añadir una etiqueta a la conexión en forma de par clave-valor.
      9. Haz clic en Siguiente.
    3. En el paso Autenticación, proporcione los detalles de autenticación de la conexión.
      1. Los métodos de autenticación que se rellenan durante este paso se basan en el tipo de conexión que se está creando.

        Los distintos tipos de conexión usan métodos de autenticación diferentes. Para obtener más información, consulta la sección Configurar la autenticación de la documentación de la conexión correspondiente en Integration Connectors.

      2. Haz clic en Siguiente.
    4. Revisar: revisa los detalles de la conexión y la autenticación.
    5. Haz clic en Crear.

Prácticas recomendadas

Estrategia de gestión de errores

Una estrategia de gestión de errores de una tarea especifica la acción que se debe llevar a cabo si la tarea falla debido a un error temporal. Para obtener información sobre cómo usar una estrategia de gestión de errores y conocer los diferentes tipos de estrategias de gestión de errores, consulta Estrategias de gestión de errores.

Precios

Los activadores de Cloud Pub/Sub y Salesforce no requieren que crees un conector. Sin embargo, si usas la tarea Connectors para conectarte a Pub/Sub o Salesforce, se te cobrará por el uso del conector. Para obtener información sobre los precios, consulta la página Precios de Application Integration.

Cuotas y límites

Para obtener información sobre las cuotas y los límites, consulta Cuotas y límites.

Siguientes pasos