Supporto didattico: Creazione di un'integrazione da file locale a salesforce.com

È possibile creare ed eseguire integrazioni con IBM® Cast Iron Express. Questo supporto didattico descrive come creare un'integrazione da un file locale a salesforce.com. È possibile definire rapidamente l'integrazione e caricare i propri dati in un'unica operazione.

Passo 1: Creare l'integrazione

Una volta eseguito l'accesso a Cast Iron Express, fare clic su Integrazioni. Con la vista Integrazioni aperta, creare un'integrazione selezionando gli endpoint di origine e di destinazione.

Suggerimento: Durante la creazione e la definizione di un'integrazione, è possibile che si desideri fare clic su Salva ad intervalli regolari. Il lavoro non viene perso in caso di problemi relativi al browser Web o in caso di disconnessione da Cast Iron Express a causa di inattività.

Per questo supporto didattico, selezionare File locale come origine e salesforce.com come destinazione.

Pannello degli endpoint di origine e destinazione

Fare clic su Nuova integrazione vuota, al di sotto della selezione Destinazione.

Viene visualizzata una struttura di integrazione, in cui è necessario definire Origine, Trasformazione e Destinazione. I numeri indicano la sequenza di definizione dell'integrazione:
  1. Definire l'endpoint di origine
  2. Definire l'endpoint di destinazione
  3. Definire la trasformazione associando il percorso dei dati dall'endpoint di origine all'endpoint di destinazione

Pannello Integrazioni

Passo 2: Configurare gli endpoint

Nell'intestazione Origine, fare clic su Modifica.

Viene visualizzata la vista di configurazione dell'endpoint di origine.

Fare clic su Seleziona file e scegliere il file locale da cui si desidera caricare i dati. Il file deve essere delimitato.

Per questo supporto didattico, viene utilizzato un file denominato accounts.csv.

Il file contiene alcune informazioni sull'account e contiene un campo denominato "id" che identifica in modo univoco ciascuno dei record dell'account nel file. Il contenuto del file accounts.csv utilizzato è riportato di seguito:
id,name,streetAddress,city,postcode,phoneNumber
0,AcmeCo,10 Downing Street,London,SW1A 2AA,02012345678
1,MyOtherCompany,221b Baker Street,London,SW2B 3FG,020654321

Finestra Origine

Se si desidera selezionare un file differente, fare clic su Modifica.

Fare clic su Carica campi e verificare i dettagli generati automaticamente relativi al file selezionato. Ad esempio, il carattere delimitatore utilizzato nel file.

Per questo supporto didattico, il file accounts.csv utilizza la virgola come carattere delimitatore. Per i campi rimanenti, è possibile lasciare i valori predefiniti.

Finestra Campi disponibili

Fare clic su Continua per visualizzare tutti i campi disponibili all'interno del file selezionato.

Campi di origine disponibili selezionati

Selezionare i campi da cui si desidera caricare i dati. Per impostazione predefinita, sono selezionati tutti i campi.

Per questo supporto didattico, vengono utilizzati tutti i campi selezionati.

Una volta completate le operazioni, fare clic su Operazione eseguita.

L'endpoint di origine è definito per questa integrazione.

Tornare alla panoramica sull'integrazione; i campi di origine selezionati sono visualizzati.

Campi selezionati nell'endpoint di origine

È ora possibile definire l'endpoint di destinazione.

Nell'intestazione Destinazione, fare clic su Modifica. Immettere le credenziali richieste per accedere a salesforce.com.

Tali credenziali vengono convalidate e, se corrette, viene eseguito l'accesso all'account salesforce.com. Vengono elencati gli oggetti di business disponibili che è possibile utilizzare nell'integrazione.

Per questo supporto didattico, dall'elenco degli oggetti, selezionare Account. La descrizione dell'oggetto Account è visualizzata nella sezione Campi disponibili, che mostra tutti i campi nell'oggetto Account.
Nota: È possibile selezionare i campi in cui si desidera caricare i dati dal file locale. Non è necessario integrare l'intero oggetto, solo i campi necessari per la definizione dell'integrazione.

Utilizzare l'opzione Operazioni per specificare il contesto dell'operazione relativa ai dati desiderata per la propria integrazione.

Per questo supporto didattico, selezionare Aggiorna oggetti come operazione. Quando l'integrazione è in esecuzione, i campi Account selezionati in salesforce.com vengono aggiornati automaticamente.

Selezionare i campi Account richiesti come illustrato nella figura riportata di seguito:

Campi disponibili nell'endpoint di destinazione

Una volta completate le operazioni, fare clic su Operazione eseguita.

L'endpoint di destinazione è definito per questa integrazione.

Viene visualizzata la panoramica sull'integrazione. L'integrazione viene aggiornata con i campi della destinazione selezionati in salesforce.com.

Gli endpoint di origine e di destinazione definiti sono visualizzati nella panoramica sull'integrazione

Nella panoramica sull'integrazione, è possibile visualizzare i campi di origine e di destinazione pronti per l'associazione.

Passo 3: Definire la trasformazione

Per completare l'integrazione, è necessario associare i campi dall'origine alla destinazione.

Collegare i campi di origine e di destinazione come richiesto. Per ciascun campo di origine, fare clic sul punto di ancoraggio, quindi fare clic sul punto di ancoraggio del campo di destinazione corrispondente.

In questo supporto didattico, i dati dai campi di origine vengono associati ai campi di destinazione come illustrato nella seguente figura. Non è richiesto di definire le funzioni sui dati.

Definizione delle trasformazioni

La definizione di funzioni e trasformazioni più complesse è illustrata nel supporto didattico relativo alle trasformazioni.

Immettere un nome significativo e rappresentativo dell'integrazione. Ad esempio, Account file locale ad account salesforce.com.

Aggiunta di un nome dell'integrazione

Salvare l'integrazione completata facendo clic su Salva. Quindi, fare clic su Chiudi per tornare alla vista Integrazioni.

La vista Integrazioni elenca tutte le integrazioni definite ed il relativo stato corrente.

Integrazioni e relativi stati correnti

Passo 4: Eseguire l'integrazione

Ora che l'integrazione è stata definita, è necessario eseguirla per copiare i dati dall'endpoint di origine all'endpoint di destinazione.

Fare clic su Esegui, a destra dell'integrazione creata.

L'integrazione viene eseguita ed i dati vengono caricati dal file locale di origine definito all'oggetto salesforce.com di destinazione definito in un'unica operazione.

Lo stato dell'integrazione passa a In esecuzione:

Vista Integrazione

È possibile fare clic su Attività > Attività di integrazione per visualizzare le attività di integrazione di Cast Iron Express recenti. Le attività più recenti sono visualizzate nella parte superiore dell'elenco.

Per questo supporto didattico, l'immagine riportata di seguito mostra i dettagli relativi all'integrazione completata.

Feed attività

Per verificare che l'integrazione sia stata eseguita correttamente, passare al sistema di destinazione e verificare che i dati siano disponibili.

Quando l'integrazione viene completata, nella parte inferiore della vista viene visualizzato un messaggio che indica che l'integrazione è stata eseguita correttamente.

Messaggio di integrazione