Consulta los conectores compatibles con Application Integration.

Tarea de asignación de datos

La tarea Asignación de datos te permite asignar variables en tu integración, obtener y definir propiedades de objetos JSON, y aplicar funciones de transformación anidadas a los valores. Las variables pueden ser variables de integración o variables de tarea.

Por ejemplo, puedes asignar valores de una variable de integración X a una variable de tarea Y o de una variable de tarea Y a una variable de integración X. Para obtener más información sobre las variables en Application Integration, consulta el artículo Usar variables en Application Integration.

Configurar la tarea de asignación de datos

Para configurar una tarea de Asignación de datos, 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 info 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. Haga clic en el elemento Asignación de datos y colóquelo en el editor de integraciones.
6. Haga clic en el elemento Asignación de datos del diseñador para ver el panel de configuración de la tarea Asignación de datos.
7. Haga clic en Abrir editor de asignación de datos para ver los valores predeterminados de la tarea y añadir una nueva asignación. Para obtener instrucciones detalladas sobre cómo añadir una asignación, consulta Añadir una asignación.

   Para obtener más información sobre el diseño del editor de asignación de datos, consulta Descripción general de la asignación de datos.

Añadir una asignación

Para añadir una asignación, sigue estos pasos:

1. En el panel de configuración de la tarea Asignación de datos, haga clic en Abrir editor de asignación de datos.
2. Configure la asignación Entrada:
   1. Arrastra una variable o su subcampo de la lista Variables a la fila Entrada. Para ver los subcampos disponibles de una variable, haga clic en expand_more (Ampliar) junto a esa variable en la lista Variables.
   2. También puedes hacer clic en Variable o valor en la fila Entrada y seguir estos pasos:
      • Seleccione Variable para buscar y usar una variable. Para crear una variable, haga clic en + Añadir variable e introduzca el nombre y el tipo de datos de la nueva variable.
      • Seleccione Valor para introducir un valor literal de tipo string, integer, double o Boolean.
      • Selecciona Función para buscar y usar una función básica.

        Una función base se usa para recuperar o generar valores durante la ejecución de una integración. Por ejemplo, generar un UUID aleatorio o recuperar la región de integración actual. Para obtener información sobre las funciones base admitidas, consulta el artículo Funciones base admitidas.

      • Haz clic en Guardar.
   3. Haga clic en + (Añadir una función) en cualquier variable de entrada, valor o función base de la fila Entrada para añadir una función de asignación de la lista de funciones de asignación disponibles. Una función de asignación puede tener uno o varios parámetros. Cada parámetro puede tener un valor, una variable o una función base seguida de una cadena de funciones de asignación.
      • Para añadir una función anidada, haz clic en + (Añadir una función) junto al parámetro de la función. Del mismo modo, para quitar o eliminar la función añadida más recientemente, haz clic en - (Eliminar función anterior).
      • Para añadir, quitar o cambiar una función entre una expresión de asignación, haz clic en una función y selecciona Añadir función, Quitar función o Cambiar función en el menú desplegable.

      Para obtener más información sobre las funciones de asignación, consulta Funciones de asignación.

      Para obtener información sobre las funciones de asignación admitidas, consulta Tipos de datos y funciones de asignación admitidos.

      • Para quitar una variable de una expresión de asignación, haz clic en cancel (Quitar) junto a la fila de la variable.
      • Para quitar toda la fila Entrada, haz clic en clear (Borrar) en la fila.
3. Configure la salida de la asignación:
   1. Arrastre una variable de la lista Variables a la fila Salida. Si la variable no está disponible, haga clic en crear una para configurar el nombre y el tipo de datos de la nueva variable. Opcionalmente, puede hacer clic en la variable de salida y seleccionar si quiere usarla como salida de la integración o como entrada de otra integración.
   2. Para quitar la variable de salida, haz clic en clear Borrar.
4. (Opcional) Para eliminar una fila de asignación, haz clic en delete (Eliminar esta asignación).
5. Cierra el Editor de asignación de datos cuando hayas terminado de asignar los datos. Los cambios se guardarán automáticamente.

La asignación de datos completada se puede ver en el panel de configuración de la tarea Asignación de datos, como se muestra en la siguiente imagen:

Tipos de datos y funciones de asignación admitidos

Application Integration admite los siguientes tipos de datos para las variables de la tarea Asignación de datos:

• Cadena y array de cadenas
• Entero y matriz de enteros
• Doble y matriz doble
• Booleano y matriz booleana
• JSON

Funciones base admitidas

Prácticas recomendadas

La tarea Asignación de datos puede ser una forma eficaz de transformar y transferir variables clave a varias tareas de tu integración. A continuación, te ofrecemos algunos consejos que deberías tener presentes al crear tu integración:

• Las asignaciones se ejecutan en secuencia de arriba abajo. Es decir, si la variable de entrada A se asigna a una variable de salida B en la primera fila, la variable B se puede asignar en las filas siguientes.
• En cada fila, el tipo de datos de la fila Input debe coincidir con el tipo de datos de la fila Output. Para convertir un valor de un tipo a otro, usa funciones de transformación como TO_STRING y TO_INT.
• No hay limitaciones en la longitud de la cadena de transformaciones. Sin embargo, depurar transformaciones encadenadas de gran tamaño puede ser difícil. Te recomendamos que las transformaciones de entrada sean legibles y que dividas las transformaciones complejas en varias asignaciones.
• Si una asignación requiere un valor alternativo, defínelo. Si no proporciona un valor alternativo, la asignación devolverá un error cuando el valor de entrada o la transformación devuelvan null.
• Cuando elimines una variable, asegúrate de eliminar cualquier asignación que la contenga.

Para obtener información sobre los límites de uso que se aplican a la tarea Asignación de datos, consulta Límites de uso.

Cuestiones importantes

En el caso de las variables JSON, en función de un esquema JSON, Application Integration interpreta la propiedad secundaria de la variable como un tipo JSON en los siguientes casos:

• Si el tipo de la propiedad secundaria especifica null. Por ejemplo:

  {
    "properties": {
      "PersonID": {
        "type": [
          "double",
          "null"
        ],
        "readOnly": false
      }
    }
  }

• Si el tipo de la propiedad secundaria especifica varios tipos de datos. Por ejemplo:

  {
    "properties": {
      "PersonID": {
        "type": [
          "integer",
          "string",
          "number"
        ],
        "readOnly": false
      }
    }
  }

En estos casos, debe convertir explícitamente las variables secundarias al tipo deseado mediante las funciones de asignación de datos.

En los siguientes ejemplos se ilustran los distintos tipos de declaraciones de propiedades y se muestra cómo usar las funciones de asignación de datos para obtener el tipo deseado:

{
  "type": "object",
  "properties": {
    "dbIntegers": {
      "type": "array",
      "items": {
        "type": [
          "integer",
          "null"
        ]
      }
    },
    "dbBooleans": {
      "type": [
        "array"
      ],
      "items": {
        "type": "boolean"
      }
    }
  }
}

dbIntegers.TO_INT_ARRAY()

{
  "type": "object",
  "properties": {
    "dbId": {
      "type": [
        "number",
        "null"
      ],
      "readOnly": false
    },
    "dbStatus": {
      "type": [
        "boolean",
        "null"
      ],
      "readOnly": false
    }
  }
}

dbId.TO_DOUBLE()

dbStatus.TO_BOOLEAN()

{
  "type": "object",
  "properties": {
    "dbString": {
      "type": [
        "string"
      ],
      "readOnly": false
    }
  }
}

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.

Cuotas y límites

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

Siguientes pasos

• Consulta información sobre todas las tareas y los activadores.
• Consulta información sobre las funciones de la tarea de asignación de datos.
• Consulta cómo probar y publicar una integración.
• Consulta información sobre el tratamiento de errores.
• Consulta información sobre los registros de ejecución de integraciones.