Salesforce Einstein Analytics Ladeaktivität

Einführung

Eine Salesforce Einstein Analytics Aktivität Laden unter Verwendung ihrer Salesforce Einstein Analytics Verbindung, platziert ein Objekt in Salesforce CRM Analytics und soll als Ziel zum Verbrauchen von Daten in einer Operation verwendet werden.

Erstellen einer Salesforce Einstein Analytics Ladeaktivität

Eine Instanz einer Salesforce Einstein Analytics Load-Aktivität wird aus einer Salesforce Einstein Analytics Verbindung erstellt mithilfe des Aktivitätstyps Load.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Salesforce Einstein Analytics Aktivität Laden kann an diesen Stellen bearbeitet werden:

• Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Konfigurieren einer Salesforce Einstein Analytics Ladeaktivität

Führen Sie die folgenden Schritte aus, um eine Salesforce Einstein Analytics Aktivität Laden zu konfigurieren:

• Schritt 1: Geben Sie einen Namen ein und legen Sie die App-Einstellungen fest
  Geben Sie einen Namen für die Aktivität an und geben Sie die vorhandene oder neue App (Ordner) an, in die Daten hochgeladen werden sollen.

• Schritt 2: Datensatzeinstellungen angeben
  Geben Sie den vorhandenen oder neuen Datensatz an, um Daten hochzuladen.

• Schritt 3: Wählen Sie die Upload-Methode
  Wählen Sie den Upload-Ansatz zwischen einer Rohdatei oder einer direkten Zuordnung aus einer Transformation.

• Schritt 4: Überprüfen Sie die Datenschemata
  Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt.

Schritt 1: Geben Sie einen Namen ein und legen Sie die App-Einstellungen fest

Geben Sie in diesem Schritt einen Namen für die Aktivität an und geben Sie die vorhandene oder neue App (Ordner) an, in die Daten hochgeladen werden sollen. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Die in diesem Schritt der Konfiguration einer Salesforce Einstein Analytics Aktivität Laden verwendete Schnittstelle hängt von der ausgewählten Option Vorhandene oder Neue App ab:

• Vorhandene App verwenden: Bei dieser Option wählen Sie aus einer Liste von Apps aus, die von der Salesforce Instanz bereitgestellt werden.
• App erstellen, falls sie nicht existiert: Bei dieser Option geben Sie den Namen einer neuen App ein, die in der Salesforce Instanz erstellt werden soll.

Vorhandene App verwenden

Wenn Vorhandene App verwenden für Vorhandene oder neue App ausgewählt ist, wird diese Schnittstelle angezeigt:

• Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede Salesforce Einstein Analytics Load-Aktivität eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :.

• Vorhandene oder neue App: Geben Sie die zu verwendende vorhandene oder neue App an, entweder Vorhandene App verwenden oder App erstellen, falls nicht vorhanden.

  • Vorhandene App verwenden: Bei dieser Option wählen Sie aus einer Liste von Apps aus, die von der Salesforce Instanz bereitgestellt werden.
  • App erstellen, falls nicht vorhanden: Bei dieser Option geben Sie den Namen einer neuen App ein, die in der Salesforce Instanz erstellt werden soll.

• Ordner auswählen: Wählen Sie eine vorhandene App aus. Wenn keine vorhanden ist, müssen Sie entweder zu App erstellen, falls nicht vorhanden: wechseln oder manuell eine neue App in Salesforce CRM Analytics erstellen.

• Speichern und beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

• Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

App erstellen, falls sie nicht existiert

Wenn App erstellen, falls nicht vorhanden für Vorhandene oder neue App ausgewählt ist, wird diese Schnittstelle angezeigt:

• Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede Salesforce Einstein Analytics Load-Aktivität eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :.

• Vorhandene oder neue App: Geben Sie die zu verwendende vorhandene oder neue App an, entweder Vorhandene App verwenden oder App erstellen, falls nicht vorhanden.

  • Vorhandene App verwenden: Bei dieser Option wählen Sie aus einer Liste von Apps aus, die von der Salesforce Instanz bereitgestellt werden.
  • App erstellen, falls nicht vorhanden: Bei dieser Option geben Sie den Namen einer neuen App ein, die in der Salesforce Instanz erstellt werden soll.

• App-Name: Der Name der neuen App.

• Speichern und beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

• Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Festlegen der Dataset-Einstellungen

Geben Sie in diesem Schritt den vorhandenen oder neuen Datensatz an, in den Daten hochgeladen werden sollen. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Die in diesem Schritt der Konfiguration einer Salesforce Einstein Analytics Aktivität Laden verwendete Schnittstelle hängt von der ausgewählten Option Vorhandenen oder neuen Datensatz verwenden ab:

• Einen vorhandenen Datensatz verwenden: Bei dieser Option wählen Sie aus einer Liste von Datensätzen aus, die von der Salesforce Instanz bereitgestellt werden. Die angezeigten Datensätze sind mit der im vorherigen Schritt ausgewählten App verknüpft.
• Datensatz erstellen, falls nicht vorhanden: Bei dieser Option geben Sie den Namen eines neuen Datensatzes ein, der in der Salesforce Instanz erstellt werden soll.

Einen vorhandenen Datensatz verwenden

Wenn für Vorhandenen oder neuen Datensatz verwenden die Option Vorhandenen oder neuen Datensatz verwenden ausgewählt ist, wird diese Schnittstelle angezeigt:

• Vorhandenen oder neuen Datensatz verwenden: Geben Sie an, ob ein vorhandener oder neuer Datensatz verwendet werden soll, entweder Vorhandenen Datensatz verwenden oder Datensatz erstellen, falls nicht vorhanden.

  • Vorhandenen Datensatz verwenden: Bei dieser Option wählen Sie aus einer Liste von Datensätzen aus, die von der Salesforce Instanz bereitgestellt werden. Die angezeigten Datensätze sind mit der im vorherigen Schritt ausgewählten App verknüpft.
  • Datensatz erstellen, falls nicht vorhanden: Bei dieser Option geben Sie den Namen eines neuen Datensatzes ein, der in der Salesforce Instanz erstellt werden soll.

• Datensatz auswählen: Wählen Sie einen vorhandenen Datensatz basierend auf der im vorherigen Schritt ausgewählten App aus. Wenn keiner vorhanden ist, müssen Sie entweder zu Datensatz erstellen, falls nicht vorhanden: wechseln oder manuell einen neuen Datensatz in Salesforce CRM Analytics erstellen.

• Operation: Geben Sie die Operation an, die auf den vorhandenen Datensatz angewendet werden soll, entweder Überschreiben, Anhängen, Upsert oder Löschen. Überschreiben ist standardmäßig ausgewählt.

• Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

• Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Datensatz erstellen, falls nicht vorhanden

Wenn für Vorhandenen oder neuen Datensatz verwenden die Option Datensatz erstellen, falls nicht vorhanden ausgewählt ist, wird diese Schnittstelle angezeigt:

• Vorhandenen oder neuen Datensatz verwenden: Geben Sie an, ob ein vorhandener oder neuer Datensatz verwendet werden soll, entweder Vorhandenen Datensatz verwenden oder Datensatz erstellen, falls nicht vorhanden.

  • Vorhandenen Datensatz verwenden: Bei dieser Option wählen Sie aus einer Liste von Datensätzen aus, die von der Salesforce Instanz bereitgestellt werden. Die angezeigten Datensätze sind mit der im vorherigen Schritt ausgewählten App verknüpft.
  • Datensatz erstellen, falls nicht vorhanden: Bei dieser Option geben Sie die Informationen für einen neuen Datensatz ein, der in der Salesforce Instanz erstellt werden soll.

• Zu erstellender Datensatzname: Der Name des neuen Datensatzes.

• Beschreibung: Die Beschreibung des neuen Datensatzes.

• Numerischer Standardwert: Der Standardwert für numerische Felder im neuen Datensatz. Dieser Wert wird gesetzt auf 0 standardmäßig. Weitere Informationen finden Sie unter Referenz zum externen Datenmetadatenformat in der Salesforce Dokumentation.

• Numerische Genauigkeit: Die maximale Anzahl von Ziffern, die für numerische Felder im neuen Datensatz zulässig sind. Dieser Wert muss zwischen 1 Und 18 inklusive und ist eingestellt auf 2 standardmäßig. Weitere Informationen finden Sie unter Referenz zum externen Datenmetadatenformat in der Salesforce Dokumentation.

• Numerische Skala: Die Anzahl der Ziffern rechts vom Dezimalkomma in numerischen Feldern im neuen Datensatz. Dieser Wert sollte kleiner sein als der in Numerische Genauigkeit festgelegte Wert und wird auf 2 standardmäßig. Weitere Informationen finden Sie unter Referenz zum externen Datenmetadatenformat in der Salesforce Dokumentation.

• Datumsformat: Geben Sie das Datumsformat an, das im neuen Datensatz verwendet werden soll. Das Format ist eingestellt auf yyyy-MM-dd standardmäßig, aber neue Optionen können basierend auf Richtlinien zur Formatierung von Datumsangaben hinzugefügt werden in der Salesforce Dokumentation.

• Metadatenfelder des Datensatzes: Geben Sie die Metadatenfelder an, die in den mit dem neuen Datensatz verknüpften Upload einbezogen werden sollen.

  Wichtig

  Felder in der Tabelle Metadatenfelder des Datensatzes zeigen das Variablensymbol nur im Bearbeitungsmodus. Damit die Variablenwerte dieser Felder zur Laufzeit ausgefüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 sein.

• Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

• Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. In einer Meldung werden Sie aufgefordert zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Upload-Methode auswählen

Wählen Sie in diesem Schritt den Upload-Ansatz zwischen einer Rohdatei oder einer direkten Zuordnung aus einer Transformation. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

• Ansatz: Wählen Sie den zu verwendenden Upload-Ansatz aus, entweder Datei oder Direkte Zuordnung. Diese Einstellung wirkt sich auf das resultierende Schema aus.

• Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

• Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 4: Überprüfen der Datenschemata

Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

In diesen Unterabschnitten werden die Anforderungs- und Antwortstrukturen für jede Kombination aus Ansatz und Phasentyp beschrieben:

• Dateiansatz
• Direkter Mapping-Ansatz

Diese Aktionen sind bei jedem Ansatz verfügbar:

• Datenschemata: Diese Datenschemata werden von benachbarten Transformations übernommen und beim Transformation erneut angezeigt.

  Notiz

  Die in einer Transformation bereitgestellten Daten haben Vorrang vor der Aktivitätskonfiguration.

  Der Salesforce Einstein Analytics Konnektor verwendet die Salesforce SOAP API. Informationen zu den Schema und -feldern finden Sie in der API -Dokumentation.

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Salesforce Einstein Analytics Endpoint neu zu generieren. Diese Aktion generiert ein Schema auch an anderen Stellen im gesamten Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

• Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

• Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

• Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Dateiansatz

Wenn der Ansatz Datei ist, bestehen die Anforderungs- und Antwortdatenschemata aus diesen Knoten und Feldern:

• Anfrage

  Anfrageschemafeld/-knoten	Hinweise
  loadRequest	Knoten, der die Ladeanforderung darstellt.
  data	Mit der Ladeanforderung verknüpfte Daten.
  metadata	Erforderliche Metadaten, die mit der Ladeanforderung verknüpft sind. Weitere Informationen finden Sie unter Salesforce Metadatenformat.

• Antwort

  Antwortschemafeld/-knoten	Hinweise
  loadResponse	Knoten, der die Lastreaktion darstellt.
  id	Mit der Ladeantwort verknüpfte ID.
  errors	Knoten, der Fehler in der Lastantwort darstellt.
  item	Knoten, der einen einzelnen Fehler darstellt.
  errorCode	Mit einem Fehler verbundener Code.
  errorMessage	Mit einem Fehler verbundene Meldung.

Direkter Mapping-Ansatz

Wenn der Ansatz Direktes Mapping ist, bestehen die Anforderungs- und Antwortdatenschemata aus diesen Knoten und Feldern:

• Anfrage

  Anfrageschemafeld/-knoten	Hinweise
  loadRequest	Knoten, der die Ladeanforderung darstellt.
  dataset	Knoten, der den Datensatz in der Ladeanforderung darstellt.
  item	Knoten, der ein Datensatzelement darstellt.
  field	Ein benanntes Feld, das mit dem Datensatz verknüpft ist.
  metadata	Erforderliche Metadaten, die mit der Ladeanforderung verknüpft sind. Weitere Informationen finden Sie unter Salesforce Metadatenformat.

• Antwort

  Antwortschemafeld/-knoten	Hinweise
  loadResponse	Knoten, der die Lastreaktion darstellt.
  id	Mit der Ladeantwort verknüpfte ID.
  errors	Knoten, der Fehler in der Lastantwort darstellt.
  item	Knoten, der einen einzelnen Fehler darstellt.
  errorCode	Mit einem Fehler verbundener Code.
  errorMessage	Mit einem Fehler verbundene Meldung.

Salesforce Metadatenformat

Die Lade-Aktivität erfordert Metadaten (im Anforderungsschema metadata Feld), um Daten in Salesforce CRM Analytics zu laden.

Ein Beispiel für korrekt formatierte Metadaten:

{
    "fileFormat": {
        "charsetName": "UTF-8",
        "numberOfLinesToIgnore": 0
    },
    "objects": [
        {
            "connector": "Jitterbit",
            "description": "",
            "fullyQualifiedName": "Record",
            "label": "Record",
            "name": "Record",
            "fields": [
                {
                    "description": "",
                    "fullyQualifiedName": "Record.Name",
                    "label": "Name",
                    "name": "Name",
                    "isSystemField": false,
                    "defaultValue": "",
                    "isUniqueId": false,
                    "isMultiValue": false,
                    "type": "Text",
                    "precision": null,
                    "scale": null,
                    "format": ""
                },
                {
                    "description": "",
                    "fullyQualifiedName": "Record.Id",
                    "label": "Id",
                    "name": "Id",
                    "isSystemField": false,
                    "defaultValue": "",
                    "isUniqueId": false,
                    "isMultiValue": false,
                    "type": "Text",
                    "precision": null,
                    "scale": null,
                    "format": ""
                }
            ]
        }
    ]
}

Detaillierte Informationen zu allen möglichen Metadatenfeldern finden Sie unter Referenz zum externen Datenmetadatenformat in der Salesforce Dokumentation.

Nächste Schritte

Nachdem Sie eine Salesforce Einstein Analytics Ladeaktivität konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation konfigurieren, die die Möglichkeit umfassen, Vorgänge zu verketten, die sich im selben oder in unterschiedlichen Workflows befinden.

Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü in Connector-Grundlagen.

Salesforce Einstein Analytics Load-Aktivitäten können mit diesen Operation als Ziel verwendet werden:

• Transformation
• Zwei-Transformationsmuster (als erstes oder zweites Ziel)

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, einsetzen und ausführen den Operation und validieren Sie das Verhalten durch Überprüfen der Operation.