Consulta los conectores compatibles para Application Integration.

Tarea Asignación de datos

La tarea de Asignación de datos te permite realizar asignaciones de variables en tu integración, obtener y establecer propiedades de objetos json y aplicar funciones de transformación anidadas a valores. Las variables pueden ser variables de integración o de tareas.

Por ejemplo, puedes asignar valores de la variable de integración X a una variable de tarea Y o desde 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 Cómo usar variables en Application Integration.

Configura la tarea Asignación de datos

Para configurar una tarea de Asignación de datos, sigue estos pasos:

En la consola de Google Cloud, ve a la página Application Integration.
Ir a Application Integration
En el menú de navegación, haz clic en Integraciones.
Aparecerá la página Integraciones con todas las integraciones disponibles en el proyecto de Google Cloud.
Selecciona una integración existente o haz clic en Crear integración para crear una nueva.
Si creas una integración nueva, haz lo siguiente:
1. Ingresa un nombre y una descripción en el panel Create Integration.
2. Selecciona una región para la integración.
  Nota: En el menú desplegable Regiones, solo se enumeran las regiones aprovisionadas en el proyecto de Google Cloud. Para aprovisionar una región nueva, haz clic en Habilitar región. Consulta Habilita una región nueva para obtener más información.
3. Selecciona una cuenta de servicio para la integración. Puedes 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 en la barra de herramientas de integración.
  Nota: La opción de seleccionar una cuenta de servicio solo se muestra si habilitaste la administración de integraciones para la región seleccionada.
4. Haz clic en Crear.
Esto abrirá la integración en la página del editor de integración.
En la barra de navegación del editor de integración, haz clic en Tasks para ver la lista de tareas disponibles.
Haz clic y coloca el elemento Asignación de datos en el editor de integración.
Haz clic en el elemento Asignación de datos en el diseñador para ver el panel de configuración de la tarea Asignación de datos.
Haz clic en Abrir el Editor de asignación de datos para ver los valores predeterminados de la tarea y agregar una asignación nueva. Para obtener pasos detallados sobre cómo agregar una asignación, consulta Agrega una asignación.
Para obtener más información sobre el editor de asignación de datos, consulta Descripción general de la asignación de datos.

Agrega una asignación

Para agregar una asignación, sigue estos pasos:

En el panel de configuración de la tarea de Asignación de datos, haz clic en Abrir el Editor de asignaciones de datos.
Configura la Entradade la asignación:
Entrada: Fuente de la entrada de asignación de datos. El origen puede ser un valor literal, una función base o una variable de entrada con funciones de asignación.
1. Arrastra una variable o su subcampo de la lista Variables al chip Entrada. Para ver los subcampos disponibles de una variable, haz clic en (Expandir) junto a esa variable en la lista Variables.
2. Como alternativa, en la fila Entrada fila, haz clic en Variable o valor y haz lo siguiente:
  - Selecciona Variable para buscar y usar una variable existente. Para crear una nueva variable, haz clic en + Agregar variable nueva e ingresar el nombre y el tipo de datos de la nueva variable.
  - Selecciona Vaue para ingresar un valor literal de tipo string, integer, double o Boolean.
  - Selecciona Función para buscar y usar una función base.
    Una función base se usa para recuperar o generar valores durante la ejecución de una integración. Por ejemplo, genera un UUID aleatorio o recupera la región de integración actual. Para obtener información sobre las funciones base compatibles, consulta Funciones base compatibles.
  - Haz clic en Guardar.
3. Haz clic en + (Agregar una función) en cualquier variable de entrada, valor o función base en el campo Entrada para agregar 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 más 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 agregar una función anidada, haz clic en + (Agregar una función) junto al parámetro de la función. Para quitar o borrar la función agregada más reciente, haz clic en -(Borrar función anterior).
  - Para agregar, quitar o cambiar una función entre una expresión de asignación, haz clic en una función y selecciona Agregar función, Quitar función o Cambiar función respectivamente desde el menú desplegable.
  - Para quitar una variable dentro de una expresión de asignación, haz clic en (Remove) junto a la fila de la variable.
  - Para quitar toda la fila de Entrada, haz clic en (Borrar) en la fila.
Configura la Salida:
Salida: Variable de destino para la salida de la asignación de datos. Las variables de destino se pueden usar para la asignación en filas de entrada posteriores.
1. Arrastra una variable de la lista Variables al chip Salida. Si la variable no está disponible, haz clic en Crear una nueva para configurar el nombre y el tipo de datos de la nueva variable. De manera opcional, puedes hacer clic en la variable de resultado y seleccionar si deseas usarla como resultado de la integración o como entrada para otra integración.
2. Para quitar la variable de resultado, haz clic en (Clear).
(Opcional) Para borrar una fila de asignación, haz clic en (Borrar esta asignación).
Cierra el Editor de asignación de datos una vez que se complete la asignación. Los cambios se guardarán automáticamente.

Puedes ver la asignación de datos completa desde el panel de configuración de la tarea de Asignación de datos, como se muestra en la siguiente imagen:

Imagen que muestra el editor asignación de datos

Tipos de datos admitidos y funciones de asignación

Apigee Integration admite los siguientes tipos de datos para variables en la tarea Asignación de datos:

String y array de strings
Números enteros y array de números enteros
Doble y array doble
Booleano y array booleano
JSON

En la siguiente tabla, se enumeran las funciones de asignación de datos disponibles para cada tipo de datos.

Tipo de dato	Funciones de asignación compatibles
Booleano	AND, EQUALS, NAND, NOR, NOT, OR, TO_JSON, TO_STRING, XNOR, XOR
Array booleano	APPEND, APPEND_ALL, CONTAINS, FILTER, FOR_EACH, GET, REMOVE, REMOVE_AT, SET, SIZE, TO_JSON, TO_SET
Double	ADD, DIVIDE, CEIL, EQUALS, EXPONENT, GREATER_THAN, GREATER_THAN_EQUAL_TO, FLOOR, LESS_THAN, LESS_THAN_EQUAL_TO, MOD, MULTIPLY, ROUND, SUBTRACT, TO_JSON, TO_STRING
Array doble	APPEND, APPEND_ALL, AVG, CONTAINS, FILTER, FOR_EACH, GET, MAX, MIN, REMOVE, REMOVE_AT, SET, SIZE, SUM, TO_JSON, TO_SET
Integer	ADD, DIVIDE, EPOCH_TO_HUMAN_READABLE_TIME, EQUALS, EXPONENT, GREATER_THAN, GREATER_THAN_EQUAL_TO, LESS_THAN, LESS_THAN_EQUAL_TO, MOD, MULTIPLY, SUBTRACT, TO_DOUBLE, TO_JSON, TO_STRING
Array de números enteros	APPEND, APPEND_ALL, AVG, CONTAINS, FILTER, FOR_EACH, GET, MAX, MIN, REMOVE, REMOVE_AT, SET, SIZE, SUM, TO_JSON, TO_SET
JSON	APPEND_ELEMENT, FLATTEN, FILTER, FOR_EACH, GET_ELEMENT, GET_PROPERTY, MERGE_ARRAY, REMOVE_PROPERTY, RESOLVE_TEMPLATE TO_BOOLEAN TO_BOOLEAN_ARRAY TO_DOUBLE TO_DOUBLE_ARRAY TO_INT TO_INT_ARRAY TO_STRING TO_STRING_ARRAY
String	CONCAT, CONTAINS, DECODE_BASE64_STRING, EQUALS, EQUALS_IGNORE_CASE, LENGTH, REPLACE_ALL, RESOLVE_TEMPLATE, SPLIT, SUBSTRING, TO_BASE_64, TO_BOOLEAN, TO_DOUBLE, TO_INT, TO_JSON, TO_LOWERCASE, TO_UPPERCASE
Arreglo de strings	APPEND, APPEND_ALL, CONTAINS, FILTER, FOR_EACH, GET, REMOVE, REMOVE_AT, SET, SIZE, TO_JSON, TO_SET

Para obtener más información sobre cada una de las funciones de asignación de datos, consulta la Referencia de funciones de asignación de datos.

Funciones base compatibles

En la siguiente tabla, se enumeran las funciones base de asignación de datos disponibles:

Data type	Funciones base compatibles
Integer	NOW_IN_MILLIS
Array de números enteros	INT_LIST
String	GENERATE_UUID, GET_EXECUTION_ID, GET_INTEGRATION_NAME, GET_INTEGRATION_REGION, GET_PROJECT_ID

Para obtener más información sobre cada una de las funciones base de asignación de datos, consulta la Referencia de funciones de asignación de datos.

prácticas recomendadas

Usar la tarea de asignación de datos puede ser un método potente para transformar y pasar variables clave a diversas tareas en la integración. Estas son algunas sugerencias para tener en cuenta cuando compilas la integración:

Las asignaciones se ejecutan en secuencia desde arriba hacia abajo. Es decir, si la variable de entrada A se asigna a una variable de salida B en la primera fila, la variable B está disponible para la asignación en las filas posteriores.
En cada fila, el tipo de datos de la fila Input debe coincidir con el tipo de datos de la fila Output. Para convertir tipos, usa funciones de transformación, como TO_STRING y TO_INT.
No hay limitaciones en cuanto a la longitud de las cadenas de transformación. Sin embargo, depurar varias transformaciones en cadena puede ser difícil. Recomendamos mantener las transformaciones de entrada legibles y dividir las complejas en varias asignaciones.
Si una asignación requiere un valor de resguardo, establece uno para la asignación. Si no proporcionas un valor de resguardo, la asignación muestra un error cuando el valor o la transformación de entrada muestra un valor null.
Cuando borres una variable, asegúrate de borrar cualquier asignación que la contenga.

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

Consideraciones

Para las variables JSON, basadas en un esquema JSON, Application Integration interpreta la propiedad secundaria de la variable como un tipo de JSON en los siguientes casos:

Si el tipo de propiedad secundaria específica “null”. Por ejemplo:

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

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

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

En estos casos, con las funciones de asignación de datos, debes convertir explícitamente las variables secundarias en el tipo deseado.

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

Ejemplo 1

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

Application Integration interpreta dbIntegers como un tipo de JSON y dbBooleans como un tipo de BOOLEAN_ARRAY.

Para convertir dbIntegers, usa lo siguiente:

dbIntegers.TO_INT_ARRAY()

Ejemplo 2

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

Application Integration reconoce a dbId y dbStatus como tipos de JSON, pero dbId es un parámetro que puede tomar un solo valor doble o un valor nulo, y dbStatus es un parámetro que puede tomar un valor booleano único o nulo.

Para convertir dbId y dbStatus, usa lo siguiente:

dbId.TO_DOUBLE()

dbStatus.TO_BOOLEAN()

Ejemplo 3

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

Application Integration reconoce dbString como un tipo de cadena.

Estrategia de manejo de errores

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