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:
- Escribe un nombre y una descripción en el diálogo Crear integración.
- En la lista de regiones compatibles, elige Región para la integración.
- 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:
- 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.
- 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
oBoolean
. - 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.
- 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.
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 compatibles, consulta Tipos de datos compatibles y funciones de asignación.
- Configura la Salida:
- 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.
- 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:
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
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 |
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 salidaB
en la primera fila, la variableB
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
yTO_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.