Consulta i connettori supportati per Application Integration.

Attività mappatura dei dati

L'attività Mappatura dei dati ti consente di eseguire assegnazioni di variabili nell'integrazione, recuperare e impostare le proprietà degli oggetti JSON e applicare funzioni di trasformazione nidificate ai valori. Le variabili possono essere variabili di integrazione o variabili di attività.

Ad esempio, puoi assegnare valori da una variabile di integrazione X a una variabile attività Y o da una variabile attività Y a un'integrazione la variabile X. Per ulteriori informazioni sulle variabili nell'integrazione delle applicazioni, consulta Utilizzare le variabili nell'integrazione delle applicazioni.

Configura l'attività di mappatura dei dati

Per configurare un'attività di mappatura dei dati:

  1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

    Vai ad Application Integration

  2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

    Viene visualizzata la pagina Integrazioni, in cui sono elencate tutte le integrazioni disponibili nel progetto Google Cloud.

  3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

    Se stai creando una nuova integrazione:

    1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
    2. Seleziona una regione per l'integrazione.
    3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli dell'account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo dell'integrazione nella barra degli strumenti di integrazione.
    4. Fai clic su Crea.

    Viene visualizzata l'integrazione nell'editor di integrazione.

  4. Nella barra di navigazione dell'editor di integrazione, fai clic su Attività per visualizzare l'elenco di attività e connettori disponibili.
  5. Fai clic sull'elemento Mappatura dei dati e posizionalo nell'editor dell'integrazione.
  6. Fai clic sull'elemento Mappatura dei dati nel designer per visualizzare l'attività Mappatura dei dati di configurazione del deployment.
  7. Fai clic su Apri editor di mappatura dei dati per visualizzare i valori predefiniti dell'attività e aggiungere una nuova mappatura. Per la procedura dettagliata sull'aggiunta di una mappatura, vedi Aggiungere una mappatura.

    Per ulteriori informazioni sul layout dell'editor di mappatura dati, consulta Panoramica della mappatura dei dati.

Aggiungere una mappatura

Per aggiungere una mappatura, segui questi passaggi:

  1. Nel riquadro di configurazione dell'attività di mappatura dei dati, fai clic su Apri editor mappatura dati.
  2. Configura l'input della mappatura:
    1. Trascina una variabile o il relativo campo secondario dall'elenco Variabili alla riga Input. Per visualizzare i sottocampi disponibili di una variabile, fai clic su (Espandi) accanto alla variabile nell'elenco Variabili.
    2. In alternativa, nella riga Input, fai clic su Variabile o Valore e attieniti alla procedura seguente:
      • Seleziona Variabile per cercare e utilizzare una variabile esistente. Per creare una nuova variabile, fai clic su + Aggiungi nuova variabile e inserisci il nome e il tipo di dati della nuova variabile.
      • Seleziona Valore per inserire un valore letterale di tipo string, integer, double o Boolean.
      • Seleziona Funzione per cercare e utilizzare una funzione di base.

        Una funzione di base viene utilizzata per recuperare o generare valori durante l'esecuzione di un'integrazione. Ad esempio, la generazione di un UUID casuale o il recupero della regione di integrazione attuale. Per informazioni sulle funzioni di base supportate, vedi Funzioni di base supportate.

      • Fai clic su Salva.
    3. Fai clic su + (Aggiungi una funzione) su qualsiasi variabile di input, valore o funzione di base nella riga Input per aggiungere una funzione di mappatura dall'elenco delle funzioni di mappatura disponibili. Una funzione di mappatura può avere uno o più parametri. Ogni parametro può inoltre avere un valore, una variabile o una funzione base seguita da una catena di funzioni di mappatura.
      • Per aggiungere una funzione nidificata, fai clic su + (Aggiungi una funzione) accanto al parametro della funzione. Analogamente, per rimuovere o eliminare la funzione aggiunta più di recente, fai clic su - (Elimina funzione precedente).
      • Per aggiungere, rimuovere o modificare una funzione tra un'espressione di mappatura e l'altra, fai clic su una funzione e seleziona rispettivamente Aggiungi funzione, Rimuovi funzione o Modifica funzione dal menu a discesa.

        • Per saperne di più sulle funzioni di mappatura, consulta le funzioni di mappatura.

        Per informazioni sulle funzioni di mappatura supportate, consulta Tipi di dati e funzioni di mappatura supportati.

      • Per rimuovere una variabile all'interno di un'espressione di mappatura, fai clic su (Rimuovi) accanto alla riga della variabile.
      • Per rimuovere l'intera riga Input, fai clic su (Cancella) nella riga.
  3. Configura la mappatura di Output:
    1. Trascina una variabile dall'elenco Variabili alla riga Output. Se la variabile non è disponibile, fai clic su Crea una nuova per configurare il nome e il tipo di dati della nuova variabile. Se vuoi, puoi fare clic sulla variabile di output e scegliere se utilizzarla come output dell'integrazione o come input per un'altra integrazione.
    2. Per rimuovere la variabile di output, fai clic su (Cancella).
  4. (Facoltativo) Per eliminare una riga di mappatura, fai clic su (Elimina questa mappatura).
  5. Una volta completata la mappatura, chiudi Data Mapping Editor. Eventuali modifiche verranno salvate automaticamente.

La mappatura dei dati completata può essere visualizzata nel riquadro di configurazione dell'attività Mappatura dei dati, come mostrato nell'immagine seguente:

immagine che mostra l'editor di mappatura dei dati immagine che mostra l'editor di mappatura dei dati

Funzioni di mappatura e tipi di dati supportati

L'integrazione Apigee supporta i seguenti tipi di dati per le variabili nell'attività Mappatura dei dati:

  • Stringa e array di stringhe
  • Array di numeri interi e interi
  • Array doppio e doppio
  • Booleano e array booleano
  • JSON
Nella tabella seguente sono elencate le funzioni di mappatura dei dati disponibili per ogni tipo di dati.
Tipo di dati Funzioni di mappatura supportate
Booleano AND, EQUALS, NAND, NOR, NOT, OR, TO_JSON, TO_STRING, XNOR, XOR
Matrice booleana APPEND, APPEND_ALL, CONTAINS, FILTER, FOR_EACH, GET, REMOVE, REMOVE_AT, SET, SIZE, TO_JSON, TO_SET
Doppio 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 doppio APPEND, APPEND_ALL, AVG, CONTAINS, FILTER, FOR_EACH, GET, MAX, MIN, REMOVE, REMOVE_AT, SET, SIZE, SUM, TO_JSON, TO_SET
Numero intero AGGIUNGI, DIVIDI, EPOCH_TO_HUMAN_READABLE_TIME, UGUALI, ESPONENTE, GREATER_THAN, GREATER_THAN_EQUAL_TO, LESS_THAN, LESS_THAN_EQUAL_TO, MOD, MULTIPLI, SUBTRACT, TO_DOUBLE, TO_JSON, TO_STRING
Array intero APPEND, APPEND_ALL, MEDIA CONTIENE, FILTRO, FOR_EACH, RECUPERA, MAX, MIN, RIMUOVI, REMOVE_AT, IMPOSTA, DIMENSIONE, SUM, TO_JSON, TO_SET
JSON APPEND_ELEMENT, FLATTEN FILTRO, FOR_EACH, GET_ELEMENT, GET_PROPERTY, UNISCI, REMOVE_PROPERTY, RESOLVE_TEMPLATE, SET_PROPERTY, DIMENSIONE, TO_BOOLEAN, TO_BOOLEAN_ARRAY, TO_DOUBLE, TO_DOUBLE_ARRAY, TO_INT, TO_INT_ARRAY, TO_STRING, TO_STRING_ARRAY
Stringa 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
Array di stringhe APPEND, APPEND_ALL, CONTIENE, FILTRO, FOR_EACH, RECUPERA, RIMUOVI, REMOVE_AT, IMPOSTA, DIMENSIONE, TO_JSON, TO_SET
Per ulteriori informazioni su ciascuna delle funzioni di mappatura dei dati, consulta Riferimento per le funzioni di mappatura dei dati.

Funzioni di base supportate

La seguente tabella elenca le funzioni di base della mappatura dei dati disponibili:
Tipo di dati Funzioni di base supportate
Numero intero NOW_IN_MILLIS
Array intero INT_LIST
Stringa GENERATE_UUID, GET_EXECUTION_ID GET_INTEGRATION_NAME, GET_INTEGRATION_REGION, GET_PROJECT_ID
Per ulteriori informazioni su ciascuna funzione di base di mappatura dei dati, vedi Riferimento sulle funzioni di mappatura dei dati.

Best practice

L'utilizzo dell'attività Mappatura dei dati può essere un modo efficace per trasformare e trasferire a varie attività nell'integrazione. Ecco alcuni suggerimenti da tenere presenti durante la creazione dell'integrazione:

  • Le mappature vengono eseguite in sequenza dall'alto verso il basso. In altre parole, se la variabile di input A è mappata a una variabile di output B nella prima riga, la variabile B è disponibile per la mappatura nelle righe successive.
  • In ogni riga, il tipo di dati della riga Input deve corrispondere al tipo di dati della riga Output. Per eseguire la trasmissione tra tipi, utilizza funzioni di trasformazione come TO_STRING e TO_INT.
  • Non ci sono limitazioni alla lunghezza del concatenamento delle trasformazioni. Tuttavia, il debug di trasformazioni in catena di grandi dimensioni può essere difficile. Consigliamo di mantenere leggibili le trasformazioni di input e di suddividere le trasformazioni complesse in più mappature.
  • Se una mappatura richiede un valore di riserva, imposta un valore di riserva per la mappatura. Se non fornisci un valore alternativo, la mappatura restituisce un errore quando il valore di input o la trasformazione restituisce null.
  • Quando elimini una variabile, assicurati di eliminare anche le eventuali mappature che la contengono.

Per informazioni sui limiti di utilizzo che si applicano all'attività Mappatura dei dati, consulta Limiti di utilizzo.

Considerazioni

Per le variabili JSON, in base a uno schema JSON, Application Integration interpreta la proprietà secondaria della variabile come un tipo JSON nei seguenti casi:

  • Se il tipo della proprietà secondaria specifica null. Ad esempio: 
    {
  "properties": {
    "PersonID": {
      "type": [
        "double",
        "null"
      ],
      "readOnly": false
    }
  }
}
  • Se il tipo della proprietà secondaria specifica più tipi di dati. Ad esempio: 
    {
  "properties": {
    "PersonID": {
      "type": [
        "integer",
        "string",
        "number"
      ],
      "readOnly": false
    }
  }
}

In questi casi, utilizzando le funzioni di mappatura dei dati, devi convertire esplicitamente le variabili secondarie nel tipo desiderato.

Gli esempi seguenti illustrano i vari tipi di dichiarazioni di proprietà e mostrano come utilizzare le funzioni di mappatura dei dati per ottenere il tipo desiderato:

Esempio 1

{
  "type": "object",
  "properties": {
    "dbIntegers": {
      "type": "array",
      "items": {
        "type": [
          "integer",
          "null"
        ]
      }
    },
    "dbBooleans": {
      "type": [
        "array"
      ],
      "items": {
        "type": "boolean"
      }
    }
  }
}
 Application Integration interpreta dbIntegers come un tipo JSON e dbBooleans come un tipo BOOLEAN_ARRAY.

Per convertire dbIntegers, utilizza: 

dbIntegers.TO_INT_ARRAY()

Esempio 2

{
  "type": "object",
  "properties": {
    "dbId": {
      "type": [
        "number",
        "null"
      ],
      "readOnly": false
    },
    "dbStatus": {
      "type": [
        "boolean",
        "null"
      ],
      "readOnly": false
    }
  }
}
 L'integrazione delle applicazioni riconosce sia dbId che dbStatus come tipi JSON, ma dbId è un parametro che può accettare un singolo valore doppio o un valore null e dbStatus è un parametro che può accettare un singolo valore booleano o un valore null.

Per convertire dbId e dbStatus usa: 

dbId.TO_DOUBLE()
 
dbStatus.TO_BOOLEAN()

Esempio 3

{
  "type": "object",
  "properties": {
    "dbString": {
      "type": [
        "string"
      ],
      "readOnly": false
    }
  }
}
 Application Integration riconosce dbString come tipo di stringa.

Strategia di gestione degli errori

Una strategia di gestione degli errori per un'attività specifica l'azione da eseguire se l'attività non riesce a causa di un errore temporaneo. Per informazioni su come utilizzare una strategia di gestione degli errori e per conoscere i diversi tipi di strategie di gestione degli errori, consulta l'articolo Strategie di gestione degli errori.

Quote e limiti

Per informazioni su quote e limiti, consulta Quote e limiti.

Passaggi successivi