ServiceMax Bulk Upsert-Aktivität

Einführung

Eine ServiceMax Aktivität Bulk Upsert unter Verwendung ihrer ServiceMax-Verbindung, aktualisiert sowohl eine große Anzahl vorhandener Datensätze als auch fügt eine große Anzahl neuer Datensätze in ServiceMax ein und ist als Ziel für die Verwendung von Daten in einem Operation vorgesehen.

Die Bulk Upsert-Aktivität sollte nur verwendet werden, wenn Sie keine Transformation benötigen, um Daten vor Erreichen des Ziels zu ändern, da ServiceMax Bulk-Aktivitäten nicht mit Transformations verwendet werden können. Wenn Sie eine Transformation benötigen, verwenden Sie die ServiceMax Upsert-Aktivität.

Die Bulk Upsert-Aktivität erfordert die Verwendung eines externen ID-Felds. Informationen zum Erstellen eines externen ID-Felds in Salesforce finden Sie unter Erstellen einer externen Salesforce-ID für Jitterbit.

Die Bulk Upsert-Aktivität wird verwendet, um Daten zu aktualisieren, wenn bereits ein Datensatz vorhanden ist, und um einen Datensatz zu erstellen, wenn dies nicht der Fall ist. Wenn Sie stattdessen nur neue Datensätze in großen Mengen einfügen möchten, verwenden Sie eine ServiceMax Bulk Insert-Aktivität oder wenn Sie vorhandene Datensätze basierend auf der ID des Objekts in Salesforce massenweise aktualisieren möchten, verwenden Sie eine ServiceMax Massenaktualisierung-Aktivität.

Die ServiceMax-Massenaktivitäten verwenden die SOAP-basierte Salesforce Bulk API. Weitere Informationen finden Sie unter Voraussetzungen und unterstützte API Versionen.

Erstellen einer ServiceMax Bulk Upsert-Aktivität

Eine Instanz einer ServiceMax Bulk Upsert-Aktivität wird aus einer ServiceMax-Verbindung erstellt mithilfe des Aktivitätstyps Bulk Upsert.

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äts- oder Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene ServiceMax Bulk Upsert-Aktivität kann von diesen Orten aus bearbeitet werden:

• Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).

• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Konfigurieren einer ServiceMax Bulk Upsert-Aktivität

Befolgen Sie diese Schritte, um eine ServiceMax Aktivität Bulk Upsert zu konfigurieren:

• Schritt 1: Geben Sie einen Namen ein und wählen Sie ein Objekt aus
  Geben Sie einen Namen für die Aktivität an und wählen Sie ein Objekt aus, das beim Massen-Upserting von Daten verwendet werden soll.

• Schritt 2: Geben Sie eine externe ID an
  Wählen Sie ein vorhandenes ServiceMax Feld aus, das Harmony als externe ID zum Verknüpfen von Datensätzen verwenden soll.

• Schritt 3: Geben Sie das Schema an
  Laden Sie eine CSV-Datei hoch oder wählen Sie eine aus. Dadurch wird das im letzten Schritt zu verwendende Schema bereitgestellt.

• Schritt 4: Kopfzeilen zuordnen
  Ordnen Sie die Quelldatei-Header aus der CSV-Datei den gewünschten ServiceMax Feldern der Datensätze zu, die per Massen-Upserting eingefügt werden sollen.

Schritt 1: Geben Sie einen Namen ein und wählen Sie ein Objekt aus

In diesem Schritt geben Sie einen Namen für die Aktivität ein und wählen ein Objekt aus, das beim Massen-Upserting von Daten verwendet werden soll.

• Name: Geben Sie einen Namen ein, der zur Identifizierung der ServiceMax Bulk Upsert-Aktivität verwendet werden soll. Der Name muss für jede ServiceMax Bulk Upsert-Aktivität eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

• Wählen Sie die Objektreferenz: Verwenden Sie die Dropdown-Liste, um ein ServiceMax-Standard- oder benutzerdefiniertes Objekt zum Massen-Upsert von Daten auszuwählen. Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet.

  Notiz

  Wenn die Liste nicht mit verfügbaren Objekten gefüllt ist, beachten Sie die folgenden Tipps zur Fehlerbehebung:

  • Die ServiceMax Verbindung ist möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

  • Ein Salesforce Passwort, das erweiterte ASCII-Zeichen wie £ verwendet, kann beim Abrufen von Daten während der Aktivitätskonfiguration den folgenden Fehler verursachen:

    Invalid username, password, security token; or user locked out. [INVALID_LOGIN]
    

    In diesem Fall kann der Verbindungstest trotzdem erfolgreich sein. Wenn Sie diesen Fehler während der Aktivitätskonfiguration erhalten und Sonderzeichen im Passwort verwenden, versuchen Sie, das Passwort zu ändern.

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol um Objekte vom ServiceMax Endpoint neu zu laden. Dies kann nützlich sein, wenn Sie vor Kurzem Objekte zu Salesforce hinzugefügt haben.

• 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: Externe ID angeben

In diesem Schritt wählen Sie ein vorhandenes ServiceMax Feld aus, das Harmony als externe ID zum Verknüpfen von Datensätzen verwenden soll.

• Externe ID: Verwenden Sie das Dropdown-Menü, um das vorhandene ServiceMax-Feld auszuwählen, das Harmony als externe ID zum Verknüpfen von Datensätzen verwenden soll. Informationen zum Erstellen eines externen ID-Felds in Salesforce finden Sie unter Erstellen einer externen ServiceMax-ID für Jitterbit.

  Warnung

  Das als externe ID verwendete Feld sollte für jeden Datensatz einen eindeutigen Wert haben. Wenn Sie mehrere Datensätze mit demselben externen ID-Wert haben, wird eine Fehlerantwort von ServiceMax zurückgegeben und der Bulk-Upsert schlägt für die Datensätze mit doppelten IDs fehl.

• 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 3: Angeben des Schema

Laden Sie in diesem Schritt eine CSV-Datei hoch oder wählen Sie eine aus. Die CSV-Datei enthält das Schema, das in Schritt 4: Kopfzeilen zuordnen verwendet werden soll.

• Schema angeben: Eine hochgeladene oder vorhandene CSV-Datei definiert das Schema, das in der Anforderung verwendet wird. Dieses Schema wird als Teil der ServiceMax Massenaktivität zum Erstellen von Zuordnungen im nächsten Schritt verwendet. Wählen Sie eine der beiden folgenden Optionen aus.

  Notiz

  Schemata für ServiceMax Massenaktivitäten sind immer Teil der Aktivität und können nie in einer Transformation definiert werden, da Transformations nicht in einem Operation verwendet werden können, der über eine ServiceMax Massenaktivität verfügt.

  • Gespeichertes Schema verwenden: Wählen Sie diese Option, um ein vorhandenes Schema auszuwählen, das zuvor im aktuellen Projekt definiert wurde.

    • Gespeicherte Schemas: Verwenden Sie die Dropdown-Liste, um ein vorhandenes Schema zur Wiederverwendung auszuwählen.

    • Schema anzeigen: Nachdem ein vorhandenes hochgeladenes Schema ausgewählt wurde, können Sie das Schema direkt im Textbereich unter der Dropdown-Liste anzeigen. Obwohl ein gespeichertes Schema nicht bearbeitet werden kann, kann dieser Textbereich kopiert werden mit Control+C (Windows oder Linux) oder Command+C (macOS). Dieser Textbereich dient nur zur Anzeige vorhandener hochgeladener Schemata und nicht für flat, hierarchisch oder gespiegelt benutzerdefinierte Schemata.

    • Validierung: Validierungsinformationen werden unterhalb des Textbereichs bereitgestellt und basieren auf der Dateierweiterung des gespeicherten Schema.

  • Neues Schema bereitstellen: Wählen Sie diese Option, um ein neues Schema zu definieren, indem Sie eine Datei hochladen oder manuell eines in den Textbereich eingeben.

    • Schemaname: Geben Sie in das obere Textfeld einen Namen für das Schema ein, einschließlich der Dateierweiterung. Wenn keine Dateierweiterung angegeben ist, wird die Datei standardmäßig als CSV behandelt. Wenn Sie eine Datei hochladen, können Sie dieses Feld leer lassen, da der Name nach dem Laden der Datei eingetragen wird.

    • Datei hochladen: Klicken Sie auf diese Schaltfläche, um ein Dialogfeld zu öffnen, in dem Sie ein Schema aus einer Datei laden können, auf die vom aktuellen Computer aus zugegriffen werden kann:

      • Datei: Mit der Schaltfläche Durchsuchen können Sie nach einer Flatfile mit einem Header suchen, der im aktuellen Projekt noch nicht verwendet wurde. Es können Dateien mit einer Größe von bis zu 5 MB hochgeladen werden.

        Warnung

        Wenn Sie versuchen, eine Datei mit demselben Namen wie eine vorhandene Datei hochzuladen, die bereits im Projekt definiert ist, werden Sie in einem Dialogfeld gefragt, ob Sie die vorhandene Datei überschreiben möchten. Wenn Sie auf Fortfahren klicken, wird die Datei an allen Stellen, an denen sie im Projekt verwendet wird, durch die neue Datei mit demselben Namen ersetzt. Wenn Sie die Datei nicht überschreiben möchten, klicken Sie auf Abbrechen und ändern Sie die Datei dann manuell, sodass sie einen Namen hat, der noch nicht verwendet wird. Versuchen Sie dann erneut, sie hochzuladen.

      • Laden: Klicken Sie auf diese Schaltfläche, um das Schema aus der Datei zu laden. Beachten Sie, dass einige Daten während der Verarbeitung konvertiert werden können, wie unter Schemaverarbeitung beschrieben..

      • Abbrechen: Klicken Sie auf Abbrechen, um das Dialogfeld Schemadatei hochladen ohne zu speichern zu schließen.

    • Schema anzeigen/bearbeiten: Nachdem ein Schema geladen wurde, können Sie es direkt im Textbereich unter der Schaltfläche Datei hochladen anzeigen oder bearbeiten. Eine andere Möglichkeit besteht darin, ein Schema manuell in diesen Bereich einzugeben oder einzufügen, ohne ein Schema aus einer Datei zu laden.

    • Validierung: Wenn Sie ein Schema bearbeiten, werden Validierungsinformationen unterhalb des Textbereichs bereitgestellt, wobei alle Fehler zeilenweise gemeldet werden. Das heißt, nach der Behebung eines Fehlers in einer Zeile werden möglicherweise weitere zu behebende Syntaxfehler für nachfolgende Zeilen gemeldet. Die Validierung basiert auf der Dateierweiterung des bereitgestellten Schema.

• 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: Überschriften zuordnen

In diesem Schritt ordnen Sie die Quelldatei-Header aus der CSV-Datei zu, die in Schritt 3: Bereitstellen des Schema bereitgestellt wurde zu den gewünschten ServiceMax Feldern der Datensätze, die per Massen-Upserting eingefügt werden sollen.

• Kopfzeilen zuordnen: Dieser Schritt dient dazu, Felder in der Quelldatei spaltenweise denen in der ServiceMax Massenzielaktivität zuzuordnen. Um eine Zuordnung abzuschließen, ziehen Sie ein Quellfeld links in ein Zielfeld rechts. Wenn Felder zugeordnet sind, wird der Hintergrund orange und eine Linie wird zwischen den zugeordneten Feldern gezeichnet. Um eine Zuordnung zu entfernen, klicken Sie entweder auf das Quellfeld oder das Zielfeld.

  • Kopfzeilen der Quelldatei: Die linke Seite zeigt die Kopfzeilen für die Spalten in der im vorherigen Schritt bereitgestellten Datei.

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Überschriften zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet.

    • Zuordnung importieren: Um eine zuvor exportierte Zuordnung zu importieren, klicken Sie auf den Link Zuordnung importieren und geben Sie anschließend im angezeigten Dialogfeld Ihre Daten ein:

      • Dateityp: Verwenden Sie die Dropdown-Liste, um das Format der Zuordnungsdatei auszuwählen:

        • JDL: Wählen Sie JDL, um eine Datei zu verwenden, die aus einem Design Studio Operation exportiert wurde (aus der Design Studio Option zum Zuordnungen in Datei speichern, beschrieben unter Transformation in Salesforce Massenverarbeitungsassistent für Upsert-Aktion).

        • JSON: Wählen Sie JSON, um eine Datei zu verwenden, die exportiert wurde aus Integration Studio mithilfe des unten beschriebenen Links Mapping exportieren.

      • Datei: Klicken Sie rechts auf die Schaltfläche Durchsuchen, um eine Datei auszuwählen, die das Mapping enthält.

      • Hochladen: Klicken Sie nach Auswahl einer Datei auf Hochladen, um das Mapping hochzuladen.

        Warnung

        Die hochgeladene Zuordnung überschreibt alle vorhandenen Zuordnungen, sofern vorhanden.

      • Abbrechen: Klicken Sie auf Abbrechen, um den Importdialog zu schließen, ohne eine Zuordnung hochzuladen.

    • Zuordnung exportieren: Um eine vorhandene Zuordnung zu exportieren, klicken Sie auf den Link Zuordnung exportieren. Dadurch wird der Downloadvorgang in Ihrem Browser gestartet. Die exportierte Datei ist im JSON-Format. Jede Feldzuordnung enthält den Quellfeldnamen, den Zielfeldnamen und den Quellindex.

      Notiz

      Exportierte Bulk-Aktivitätszuordnungen können nicht als Transformation importiert werden und können nur über den oben beschriebenen Link Import Mapping importiert werden.

  • Salesforce Felder: Auf der rechten Seite werden die Spaltennamen in Salesforce angezeigt, die für die Zuordnung verfügbar sind.

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Überschriften zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet.

    • Automap: Klicken Sie auf den Link Automap, um Quell- und Zielfeldnamen zuzuordnen, die exakt übereinstimmen (unabhängig von Groß- und Kleinschreibung) und identische Datentypen aufweisen. Automatisch zugeordnete Felder ergänzen alle vorhandenen Zuordnungen, die beibehalten werden.

    • Neu beginnen: Klicken Sie auf den Link Neu beginnen, um alle Zuordnungen zu löschen.

• 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.

Nächste Schritte

Nachdem Sie eine ServiceMax -Bulk-Upsert-Aktivität konfiguriert haben, können Sie sie wie unten beschrieben innerhalb einer Operation verwenden. Nachdem Sie eine Operation mit einer ServiceMax-Aktivität auf einem privaten Agenten ausgeführt haben, können Sie die Erfolgs- und Fehlerdateien des Vorgangs herunterladen.

Schließen Sie den Operation

Nachdem Sie eine ServiceMax Bulk Upsert-Aktivität konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie weitere Aktivitäten oder Tools hinzufügen und konfigurieren als Operation. Sie können auch die Operation konfigurieren, die die Möglichkeit umfassen, Operationen zu verketten, die sich im gleichen 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.

ServiceMax Bulk Upsert-Aktivitäten können als Ziel mit dem Salesforce-Bulk-Zielmuster verwendet werden. Andere Muster sind bei Verwendung von ServiceMax Bulk Upsert-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Operation Validity Seite.

Vorgänge, die eine ServiceMax Aktivität enthalten, können nur eine ServiceMax Aktivität haben und können keine anderen Aktivitäten enthalten, mit Ausnahme derjenigen, die mit der API verknüpft sind, Datenbank, Dateifreigabe, FTP, HTTP, Lokaler Speicher, Temporärer Speicher oder Variable-Anschlüsse.

Eine ServiceMax Aktivität kann nur in einer einzigen Operation als Operation Schritt verwendet werden. Das heißt, Sie können nicht mehrere Male in anderen Operationen auf dieselbe Aktivität verweisen. Stattdessen können Sie eine Kopie einer ServiceMax-Aktivität erstellen, um sie an anderer Stelle zu verwenden (siehe Komponentenwiederverwendung).

Darüber hinaus muss das im Operation verwendete dateibasierte Ziel ein Flatfile-Format mit einem Header und nur den folgenden Datentypen verwenden:

Base64 - Boolesch - Datumsformate - Doppelt - Ganze Zahl - Salesforce ID - Schnur

Bei Vorgängen, die ServiceMax-Aktivitäten verwenden, können auch Operation so konfiguriert werden, dass sie bei einem SOAP Fehler ausgelöst werden - einem Fehler, der durch ein falsches Nachrichtenformat, eine falsche Header-Verarbeitung oder eine Inkompatibilität verursacht wird. Vorgangsaktionen können so konfiguriert werden, dass nach Auftreten eines SOAP Fehlers eine Operation Durchführen oder eine Email gesendet wird. Anweisungen zum Auslösen einer Aktion bei einem SOAP Fehler finden Sie unter Vorgangsaktionen.

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

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

Anzeigen von Erfolgs- und Fehlerdateien

Wenn Sie einen Operation ausführen, der eine ServiceMax-Aktivität auf einem privaten Agenten enthält stehen Erfolgs- und Fehlerdateien auf der Seite Runtime Operations der Management Console zum Download bereit. Wählen Sie den entsprechenden Operation in der Tabelle Runtime-Vorgänge aus und klicken Sie im unteren Bereich des Bildschirms auf die Tab Aktivitätsprotokolle, um Download-Links für die Dateien anzuzeigen, sofern verfügbar:

• Datei erfolgreich heruntergeladen: Wenn Sie den Operation auf einem privaten Agenten ausführen, klicken Sie auf den Link Herunterladen, um die Erfolgsaufzeichnungen als CSV-Datei zu speichern.

• Download-Fehlerdatei: Wenn Sie den Operation auf einem privaten Agenten ausführen, klicken Sie auf den Link Herunterladen, um die Fehleraufzeichnungen als CSV-Datei zu speichern.

Hinweis

Standardmäßig werden Erfolgs- und Fehlerdateien nach 14 Tagen automatisch vom Jitterbit File Cleanup Service aus dem privaten Agenten gelöscht. Die Anzahl der Tage, für die die Dateien gespeichert werden, kann durch Bearbeiten des [Resultfiles] im Abschnitt jitterbit.conf Datei. Sie können die Aufbewahrungsregeln für Erfolgs- und Fehlerdateien auch ändern, indem Sie die Jitterbit-Dateibereinigungsdienstregeln für private Agenten bearbeiten.

Der Download von Aktivitätsprotokollen ist für Cloud-Agenten deaktiviert. Wenn die Links sichtbar sind, erhalten Sie beim Versuch eines Downloads eine Fehlermeldung.