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 Apigee Integration, consulta Usa variables en Apigee Integration.

Configura la tarea Asignación de datos

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

En la IU de Apigee, selecciona tu organización de Apigee.
Haz clic en Desarrollar > Integraciones.
Elige una integración existente o crea una nueva haciendo clic en Crear integración.
Si creas una integración nueva, haz lo siguiente:
1. Escribe un nombre y una descripción en el diálogo Crear integración.
2. En la lista de regiones compatibles, elige Región para la integración.
3. Haz clic en Crear.
Esto abrirá la integración en la página del diseñador de integración.
En la barra de navegación Diseñador de integración, haz clic en +Agregar una tarea o un activador > Tareas 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 (Quitar) junto a la fila de variable.
  - Para quitar toda la fila 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 salida, haz clic en (Borrar).
(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, REMOVE_PROPERTY, RESOLVE_TEMPLATE, SET_PROPERTY, SIZE, TO_BOOLEAN, TO_BOOLEAN_ARRAY, TO_DOUBLE, TO_DOUBLE_ARRAY, TO_INT, TO_INT_ARRAY, TO_STRING, TO_STRING_ARRAY
Cadena	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
Cadena	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 Entrada debe coincidir con el tipo de datos de la fila Salida. 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

En el caso de las variables JSON, según un esquema JSON, Apigee Integration interpreta la propiedad secundaria de la variable como un tipo 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"
      }
    }
  }
}

La integración de Apigee interpreta dbIntegers como un tipo JSON y dbBooleans como un tipo 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
    }
  }
}

Apigee Integration reconoce dbId y dbStatus como tipos JSON, pero dbId es un parámetro que puede tomar un solo valor doble o nulo y dbStatus es un parámetro que puede tomar un solo valor booleano 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
    }
  }
}

Apigee Integration reconoce dbString como un tipo de string.

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.