Tutoriel : création d'une intégration entre un fichier local et salesforce.com

IBM® Cast Iron Express vous permet de créer et d'exécuter des intégrations. Ce tutoriel décrit la méthode de création d'une intégration entre un fichier local et salesforce.com. Vous pouvez rapidement définir l'intégration, puis charger les données via une opération unique.

Etape 1 : Création de l'intégration

Après vous être connecté sur Cast Iron Express, cliquez surIntégrations. Dans la vue Intégrations, créez une intégration en sélectionnant les noeuds finaux source et cible.

Conseil : Vous pouvez cliquer sur Sauvegarder à intervalles réguliers pendant le processus de création et de définition d'intégration. De cette façon, votre travail n'est pas perdu en cas de problème de navigateur ou de déconnexion de Cast Iron Express suite à une période d'inactivité.

Pour les besoins de ce tutoriel, sélectionnez Fichier local en tant que source et salesforce.com en tant que cible.

Panneau des noeuds finaux source et cible

Cliquez sur l'option de nouvelle intégration vide, qui apparaît sous la sélection cible.

Une intégration apparaît ; les zones Source, Transformation et Cible doivent être définies. Les chiffres indiquent la séquence de définition d'intégration :
  1. Définition du noeud final source
  2. Définition du noeud final cible
  3. Définition de la transformation, via le mappage des données entre le noeud final source et le noeud final cible

Panneau Intégrations

Etape 2 : Configuration des noeuds finaux

Dans l'en-tête Source, cliquez sur Editer.

La vue de configuration du noeud final source apparaît.

Cliquez sur l'option de sélection de fichier, puis choisissez le fichier local à partir duquel vous souhaiter charger les données. Le fichier doit être un fichier délimité.

Pour les besoins de ce tutoriel, nous utiliserons le fichier accounts.csv.

Ce fichier contient des informations sur le compte, ainsi qu'une zone appelée "id", qui identifie de façon unique chaque enregistrement du fichier. Le contenu du fichier accounts.csv est le suivant :
id,name,streetAddress,city,postcode,phoneNumber
0,AcmeCo,10 Downing Street,London,SW1A 2AA,02012345678
1,MyOtherCompany,221b Baker Street,London,SW2B 3FG,020654321

Fenêtre de source

Si vous souhaitez sélectionner un autre fichier, cliquez sur Modifier.

Cliquez sur l'option de chargement des zones, puis vérifiez les informations sur le fichier sélectionné (elles sont générées automatiquement). Vérifiez le caractère délimiteur utilisé dans le fichier, par exemple.

Pour les besoins de ce tutoriel, le fichier accounts.csv utilise une virgule comme caractère délimiteur. Les autres zones peuvent conserver leurs valeurs par défaut.

Fenêtre Zones disponibles

Cliquez sur Continuer pour afficher toutes les zones disponibles au sein du fichier sélectionné.

Zones source disponibles

Sélectionnez les zones à partir desquelles vous souhaitez charger les données. Par défaut, toutes les zones sont sélectionnées.

Pour les besoins de ce tutoriel, nous utiliserons toutes les zones sélectionnées.

Une fois que vous avez terminé, cliquez sur Terminé.

Le noeud final source est défini pour cette intégration.

Vous revenez ensuite à la vue d'intégrations ; les zones source sélectionnées sont affichées.

Zones sélectionnées dans le noeud final source

Vous pouvez maintenant définir le noeud final cible.

Dans l'en-tête Cible, cliquez sur Editer. Entrez les données d'identification permettant de se connecter à salesforce.com.

Ces données sont validées : si elles sont correctes, vous êtes connecté au compte salesforce.com. Les objets métier disponibles utilisés dans l'intégration sont répertoriés.

Pour les besoins de ce tutoriel, sélectionnez Compte dans la liste d'objets. La description de l'objet Compte s'affiche dans la sous-fenêtre des zones disponibles, qui présente toutes les zones de cet objet.
Remarque : Vous pouvez sélectionner les zones qui vous intéressent et que vous inclure pour rapatrier les données à partir du fichier local. Il n'est pas nécessaire d'intégrer la totalité de l'objet, mais uniquement les zones qui sont pertinentes pour votre définition d'intégration.

L'option Opérations vous permet de spécifier le contexte des données que vous souhaitez inclure dans votre intégration.

Pour ce tutoriel, sélectionnez l'opération Mettre à jour objets. Lorsque l'intégration s'exécutera, elle mettra automatiquement à jour toutes les zones Compte sélectionnées sur salesforce.com.

Sélectionnez les zones Compte requises, comme illustré dans la capture d'écran suivante :

Zones disponibles au niveau du noeud final cible

Une fois que vous avez terminé, cliquez sur Terminé.

Le noeud final cible est défini pour cette intégration.

Vous revenez ensuite à la vue d'intégrations. L'intégration est mise à jour sur salesforce.com, à l'aide des zones cible sélectionnées.

Les noeuds finaux source et cible définis s'affichent dans la présentation de l'intégration

Dans cette présentation, vous pouvez à présent voir les zones source et cible prêtes à être mappées.

Etape 3 : Définition de la transformation

Pour terminer l'intégration, vous devez mapper les zones de la source vers la cible.

Reliez les zones source et cible selon vos besoins. Pour chaque zone source, cliquez sur le point d'ancrage, puis cliquez sur le point d'ancrage cible correspondant.

Pour les besoins de ce tutoriel, vous devez mapper les données des zones source aux zones cible, comme l'illustre la capture d'écran suivante. Il n'est pas nécessaire de définir des fonctions sur les données en cours.

Définition des transformations

La définition de ces fonctions et des transformations plus complexes est couverte dans le tutoriel relatif aux transformations.

Entrez un nom représentatif de l'intégration. Par exemple, Comptes de fichiers source pour le compte salesforce.com.

Ajout d'un nom d'intégration

Sauvegardez l'intégration en cliquant sur Sauvegarder. Ensuite, cliquez sur Fermer pour revenir à la vue Intégrations.

La vue Intégrations contient toutes les intégrations définies, accompagnées de leur état en cours.

Intégrations et leur état en cours

Etape 4 : Exécution de l'intégration

Maintenant que l'intégration a été définie, vous devez exécuter l'intégration afin de copier les données du noeud final source vers le noeud final cible.

Cliquez sur Exécuter (à droite de l'intégration créée).

L'intégration est exécutée, et les données sont chargées dans l'objet salesforce.com à partir du fichier local source, au cours d'une opération unique.

L'état de l'intégration est modifié en Exécution en cours :

Vue de l'intégration

Vous pouvez cliquer surActivités > Activité d'intégration pour afficher les activités d'intégration récentes de Cast Iron Express. Les activités les plus récentes s'affichent en haut de la liste.

Pour ce tutoriel, la capture d'écran suivante illustre les informations d'intégration complètes.

Flux d'activités

Pour vérifier si l'intégration a bien été exécutée, accédez au système cible et vérifiez l'arrivée des données.

Une fois l'intégration exécutée, un message s'affiche temporairement dans la partie inférieure de la vue : il confirme que l'intégration a abouti.

Message d'intégration




Commentaires | Notices


Icône d'horodatage Dernière révision: Friday, November 1, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.api.omniapps.doc/tut_creatingalocalfileintegration.html