Lerntext: Lokale Datei für die salesforce.com-Integration erstellen

Mit IBM® Cast Iron Express können Sie Integrationen erstellen und ausführen. Dieser Lerntext beschreibt die Erstellung einer Integration aus einer lokalen Datei in salesforce.com. Sie können die Integration schnell definieren und Ihre Daten in einer One-off-Operation hochladen.

Schritt 1: Integration erstellen

Wenn Sie sich bei Cast Iron Express angemeldet haben, klicken Sie auf die Schaltfläche Integrationen. Erstellen Sie auf der Seite Integrationen eine neue Integration, indem Sie Ihre Quellen- und Zielendpunkte auswählen.

Tipp: Klicken Sie öfters und regelmäßig auf Speichern, wenn Sie eine Integration erstellen und definieren. So geht Ihre Arbeit nicht verloren, wenn Sie auf Web-Browser-Probleme stoßen oder aus Cast Iron Express wegen Inaktivität abgemeldet werden.

Wählen Sie in diesem Lerntext Lokale Datei als Quelle und salesforce.com als Ziel aus.

Anzeige 'Quellen- und Zielendpunkte'

Klicken Sie auf Neue leere Integration, die unter der Zielauswahl angezeigt wird.

Es wird ein Integrationsentwurf angezeigt, in dem die Quelle, die Konvertierung und das Ziel definiert werden müssen. Die Zahlen kennzeichnen die Reihenfolge der Integrationsdefinition.
  1. Definieren Sie den Quellenendpunkt.
  2. Definieren Sie den Zielendpunkt.
  3. definieren Sie die Konvertierung, indem Sie den Datenpfad vom Quellenendpunkt zum Zielendpunkt zuordnen.

Anzeige 'Integrationen'

Schritt 2: Endpunkte konfigurieren

Klicken Sie im Bereich Quelle auf Bearbeiten.

Die Ansicht Konfiguration des Quellenendpunkts wird geöffnet.

Klicken Sie auf Datei auswählen und wählen Sie die lokale Datei aus, aus der Sie die Daten hochladen wollen. Die Datei muss eine Datei mit begrenzter Satzlänge sein.

In diesem Lerntext verwenden wir die Datei accounts.csv.

Diese Datei enthält einige Accountinformationen und umfasst das Feld 'id', mit dem alle Accountdatensätze eindeutig in der Datei identifiziert werden. Der Inhalt der Datei accounts.csv wird hier dargestellt:
id,name,streetAddress,city,postcode,phoneNumber
0,AcmeCo,10 Downing Street,London,SW1A 2AA,02012345678
1,MyOtherCompany,221b Baker Street,London,SW2B 3FG,020654321

Fenster 'Quelle'

Wenn Sie eine andere Datei auswählen wollen. klicken Sie auf Ändern.

Klicken Sie auf Felder laden und prüfen Sie die Details, die automatisch zu der ausgewählten Datei generiert werden. Beispielsweise das Begrenzungszeichen, das in der Datei verwendet wird.

In diesem Lerntext verwendet die Datei accounts.csv ein Komma als Begrenzungszeichen. Darüber hinaus können die Standardwerte in den verbleibenden Feldern beibehalten werden.

Fenster 'Verfügbare Felder'

Klicken Sie auf Weiter, um alle verfügbaren Felder in der ausgewählten Datei anzuzeigen.

Ausgewählte Felder für die verfügbare Quelle

Wählen Sie die Felder aus, aus denen Sie die Daten hochladen wollen. Standardmäßig sind alle Felder ausgewählt.

In diesem Lerntext verwenden wir alle ausgewählten Felder.

Klicken Sie abschließend auf Fertig.

Die Quellenendpunkt ist für diese Integration definiert.

Sie kehren zur Integrationsübersicht zurück und die ausgewählten Quellenfelder werden angezeigt.

Ausgewählte Felder im Quellenendpunkt

Sie können nun den Zielendpunkt definieren.

Klicken Sie im Bereich Ziel auf Bearbeiten. Geben Sie die Berechtigungsnachweise für das Anmelden bei salesforce.com ein.

Diese Berechtigungsnachweise werden geprüft, und (falls korrekt) werden Sie beim salesforce.com-Account angemeldet. Die verfügbaren Geschäftsobjekte, die Sie in Ihrer Integration verwenden können, werden aufgelistet.

Wählen Sie für diesen Lerntext in der Liste der Objekte Account aus. Die Beschreibung des Objekts 'Account' wird im Bereich mit den verfügbaren Feldern angezeigt, in dem alle Felder das Objekts 'Account' aufgeführt sind.
Anmerkung: Sie können die Felder auswählen, an denen Sie interessiert sind, und in die Sie Daten aus Ihrer lokalen Datei laden wollen. Sie müssen nicht das gesamte Objekt integrieren, sondern Sie können sich auf die Felder beschränken, die für Ihre Integration erforderlich sind.

Über die Option 'Operationen' können Sie den Kontext der Datenoperation angeben, die Sie für Ihre Integration benötigen.

Wählen Sie für diesen Lerntext Objekte aktualisieren als Operation aus. Wenn die Integration ausgeführt wird, werden die in salesforce.com ausgewählten Account-Felder automatisch aktualisiert.

Wählen Sie die erforderlichen Account-Felder aus (siehe folgenden Screenshot):

Verfügbare Felder im Zielendpunkt

Wenn Sie alle Angaben gemacht haben, klicken Sie auf Fertig.

Die Zielendpunkt ist für diese Integration definiert.

Sie kehren zur Integrationsübersicht zurück. Die Integration wird mit den ausgewählten Feldern für das Ziel in salesforce.com aktualisiert.

Die definierten Quellen- und Zielendpunkte werden in der Integrationsübersicht angezeigt.

In der Integrationsübersicht können Sie jetzt die Quellen- und Zielfelder sehen, die zugeordnet werden können.

Schritt 3: Konvertierung definieren

Um die Integration fertigzustellen, müssen Sie die Quellen- den Zielfeldern zuordnen.

Verbinden Sie die Quellen- und Zielfelder nach Bedarf. Klicken Sie für jedes Quellenfeld auf den Ankerpunkt und anschließend auf den entsprechenden Ankerpunkt für das Zielfeld.

In diesem Lerntext ordnen Sie die Daten von den Quellenfeldern den Zielfeldern zu, wie im folgenden Screenshot angezeigt. Sie müssen keine Funktionen für die Daten definieren.

Konvertierungen definieren

Die Definition von Funktionen und komplexeren Konvertierungen wird im Lerntext zu Konvertierungen beschrieben.

Geben Sie einen aussagekräftigen und für die Integration repräsentativen Namen ein. Beispiel: Lokale Datei-Accounts in salesforce.com-Account.

Integrationsnamen hinzufügen

Speichern Sie die abgeschlossene Integration und klicken Sie auf Speichern. Klicken Sie anschließend auf Schließen, um zur Ansicht 'Integrationen' zurückzukehren.

In der Absicht Integrationen werden alle definierten Integrationen sowie deren aktuelle Statuszustände aufgelistet.

Integrationen und ihr aktueller Status

Schritt 4: Integration ausführen

nach dem Definieren der Integration müssen Sie die Integration ausführen, um die Daten aus dem Quellenendpunkt in den Zielendpunkt zu kopieren.

Klicken Sie auf die Schaltfläche Ausführen, die rechts neben der Integration angezeigt wird, die Sie erstellt haben.

Die Integration wird ausgeführt und die Daten werden von Ihrer definierten lokalen Quellendatei zum definierten salesforce.com-Zielobjekt in einer One-off-Operation hochgeladen.

Der Status der Integration ändert sich in 'Wird ausgeführt':

Ansicht 'Integration'

Sie können auf Aktivitäten > Integrationsaktivität klicken, um die letzten Cast Iron Express-Integrationsaktivitäten anzuzeigen. Die Aktivitäten werden anschließend angezeigt; dabei wird die aktuellste Aktivität oben in der Liste aufgeführt.

In diesem Lerntext zeigt der folgende Screenshot die abgeschlossenen Integrationsdetails an.

Feed zu Aktivitäten

Um zu prüfen, ob die Integration erfolgreich ausgeführt wurde, können Sie auf dem Zielsystem überprüfen, ob die Daten eingetroffen sind.

Wenn die Integration vollständig abgeschlossen ist, wird eine Bestätigungsnachricht über die erfolgreiche Integration ebenfalls kurz im unteren Bereich der Ansicht angezeigt.

Integrationsnachricht




Feedback | Notices


Timestamp icon Letzte Aktualisierung: Friday, November 8, 2013


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