Consulta los conectores compatibles para la integración de aplicaciones.

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 Usa variables en Application Integration.

Configura la tarea Asignación de datos

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

  1. En la consola de Google Cloud, ve a la página Application Integration.

    Ir a Application Integration

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

    Aparecerá la página Integraciones con una lista de todas las integraciones disponibles en el proyecto de Google Cloud.

  3. 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.
    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 la integración.
    4. Haz clic en Crear.

    Esto abrirá la integración en la página del editor de integración.

  4. En la barra de navegación del editor de integración, haz clic en Tasks para ver la lista de tareas y conectores disponibles.
  5. Haz clic y coloca el elemento Asignación de datos en el editor de integración.
  6. 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.
  7. 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:

  1. En el panel de configuración de la tarea de Asignación de datos, haz clic en Abrir el Editor de asignaciones de datos.
  2. Configura la Entradade la 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 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.

      • Para quitar una variable dentro de una expresión de asignación, haz clic en (Remove) junto a la fila de variables.
      • Para quitar toda la fila de Entrada, haz clic en (Borrar) en la fila.
  3. Configura la Salida:
    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).
  4. (Opcional) Para borrar una fila de asignación, haz clic en (Borrar esta asignación).
  5. 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 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 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"
      }
    }
  }
}
 La integración de aplicaciones 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
    }
  }
}
 Application 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 un valor 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.

Cuotas y límites

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

¿Qué sigue?