ServiceMax Query-Aktivität in Jitterbit Studio

Einführung

Eine ServiceMax Query-Aktivität verwendet ihre ServiceMax-Verbindung und fragt Daten aus ServiceMax ab. Sie ist als Quelle konzipiert, um Daten in einem Vorgang bereitzustellen.

ServiceMax Query-Aktivität erstellen

Eine Instanz einer ServiceMax Query-Aktivität wird aus einer ServiceMax-Verbindung mit dem Aktivitätstyp Query erstellt.

Um eine Aktivitätsinstanz zu erstellen, zieht man den Aktivitätstyp auf die Design-Canvas oder kopiert den Aktivitätstyp und fügt ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Aktivitäts- oder Tool-Instanz erstellen in Komponentenwiederverwendung.

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

• Die Design-Canvas (siehe Komponentenaktionsmenü in Design-Canvas).

• Die Registerkarte Komponenten des Projektbereichs (siehe Komponentenaktionsmenü in Projektbereich – Registerkarte „Komponenten").

ServiceMax Query-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine ServiceMax Query-Aktivität zu konfigurieren:

• Schritt 1: Namen eingeben und Objekte auswählen
  Geben Sie einen Namen für die Aktivität ein und wählen Sie die abzufragenden Objekte aus.

• Schritt 2: Felder auswählen und Bedingungen erstellen
  Erstellen Sie die Abfrageanweisung entweder automatisch durch Auswahl von Feldern und Angabe von Bedingungen oder manuell durch direkte Eingabe einer Abfrageanweisung.

• Schritt 3: Datenschemas überprüfen
  Alle vom Endpunkt generierten Request- oder Response-Schemas werden angezeigt.

Schritt 1: Namen eingeben und Objekte auswählen

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie die abzufragenden Objekte aus.

• Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

  • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

• Name: Geben Sie einen Namen ein, um die ServiceMax Query-Aktivität zu identifizieren. Der Name muss für jede ServiceMax Query-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

• Objekt(e) auswählen: Dieser Bereich zeigt die im ServiceMax-Endpunkt verfügbaren Objekte an:

  • Kopieren: Klicken Sie auf das Symbol Aktivitätskonfiguration kopieren, um die vorhandene Konfiguration dieses Schritts und Schritt 2 in die Zwischenablage zu kopieren. Das Kopieren ist nur aktiviert, nachdem eine Abfrage in Schritt 2 mit der Schaltfläche Abfrage testen validiert wurde.

  • Einfügen: Klicken Sie auf das Symbol Aktivitätskonfiguration einfügen, um eine vorhandene Konfiguration einzufügen, die aus diesem Schritt oder Schritt 2 kopiert wurde. Wenn Sie versuchen, eine Abfrage einzufügen, wird ein Bestätigungsdialog angezeigt, der angibt, dass alle vorhandenen Konfigurationen in den Schritten 1 und 2 überschrieben werden.

    Tipp

    Die Schaltflächen Kopieren und Einfügen können auch über verschiedene Instanzen der ServiceMax Query-Aktivität hinweg verwendet werden.

  • Ansicht: Verwenden Sie das Dropdown-Menü, um die Objektliste nach allen Objekten, Standardobjekten oder benutzerdefinierten Objekten zu filtern. Standardmäßig werden alle Objekte angezeigt.

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

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol , um Objekte vom ServiceMax-Endpunkt neu zu laden. Dies ist hilfreich, wenn Sie kürzlich Objekte zu ServiceMax hinzugefügt haben, die in der Liste Objekt(e) auswählen noch nicht sichtbar sind.

• Objekt(e) auswählen: Die Liste der Objekte wird in einer Spalte auf der linken Seite angezeigt. Klicken Sie auf das Objekt, um es zur Liste auf der rechten Seite hinzuzufügen. Aus der Liste auf der linken Seite kann nur ein primäres Objekt ausgewählt werden.

  Hinweis

  Wenn die Liste nicht mit verfügbaren Objekten gefüllt wird, ist die ServiceMax-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

• Zugehörige Objekt(e) auswählen: Optional können Sie untergeordnete oder übergeordnete Objekte in die Abfrage einbeziehen, indem Sie das Kontrollkästchen neben jedem zugehörigen Objekt aktivieren, das einbezogen werden soll. Dies wird als Beziehungsabfrage bezeichnet.

  Hinweis

  Die Auswahl zugehöriger Objekte ist auf unmittelbare untergeordnete Elemente und Vorgänger bis zu 5 Ebenen beschränkt. Dies umfasst übergeordnete Elemente eines untergeordneten Elements, schließt aber ein untergeordnetes Element eines untergeordneten Elements oder ein anderes untergeordnetes Element eines übergeordneten Elements nicht ein.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol , um Felder in den zugehörigen Objekten für diese Aktivität vom Salesforce-Endpunkt neu zu laden. Vorhandene Auswahlen in Zugehörige Objekt(e) auswählen bleiben nur erhalten, wenn diese Objekte in Schritt 2 verwendet werden. Alle Objekte, die in Schritt 2 nicht verwendet werden, haben ihre Auswahl gelöscht.

• Felder in der Vorschau anzeigen: Um eine Vorschau der Felder für ein bestimmtes Objekt anzuzeigen, klicken Sie direkt auf den Objektnamen unter Zugehörige Objekt(e) auswählen. Beachten Sie, dass das Aktivieren der Feldvorschau unabhängig davon ist, welche Feldkontrollkästchen ausgewählt sind. Das heißt, Sie können eine Vorschau der Felder für Objekte anzeigen, unabhängig davon, ob diese ausgewählt sind.

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

• Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Felder auswählen und Bedingungen erstellen

In diesem Schritt erstellen Sie die Abfrageanweisung entweder automatisch, indem Sie Felder auswählen und Bedingungen angeben, oder manuell, indem Sie eine Abfrageanweisung direkt eingeben. Sie müssen die Abfrage testen, um sicherzustellen, dass sie gültig ist, bevor Sie zum nächsten Schritt übergehen.

• Felder auswählen und Bedingungen erstellen: Dieser Abschnitt zeigt Felder für die ausgewählten Objekte an, die am ServiceMax-Endpunkt verfügbar sind. Objekte, die im vorherigen Schritt ausgewählt wurden, werden fett angezeigt.

  • Suche: Geben Sie einen beliebigen Wert aus einer Spalte in das Suchfeld ein, um die Liste der Felder zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Die aufgelisteten Ergebnisse werden bei jedem Tastendruck in Echtzeit gefiltert.

  • Alle auswählen: Wenn Sie das Suchfeld zum Filtern verwenden, können Sie dieses Kontrollkästchen verwenden, um alle sichtbaren Felder auf einmal auszuwählen (Objekte und reduzierte Felder werden nicht ausgewählt).

  • Felder auswählen: Aktivieren Sie die Kontrollkästchen der Felder, die Sie in die Abfrage einbeziehen möchten, um sie automatisch zur SOQL-Anweisung auf der rechten Seite hinzuzufügen. Wenn Sie das Suchfeld nicht verwenden, können Sie auch ein ganzes Objekt auswählen, um alle seine Felder auf einmal auszuwählen.

• SOQL-Anweisung: Wenn Sie Felder auswählen, wird die Abfrageanweisung im Textfeld oben rechts automatisch mit dem Objekt und den ausgewählten Feldern gefüllt. Um eine benutzerdefinierte SOQL-Anweisung zu verwenden, nehmen Sie nach Bedarf Änderungen in diesem Textfeld vor. Informationen zur Strukturierung einer benutzerdefinierten SOQL-Anweisung finden Sie in der Salesforce-Dokumentation zu SOQL SELECT-Syntax.

• Gelöschte Zeilen einschließen: Aktivieren Sie dieses Kontrollkästchen, um Zeilen einzuschließen, die in ServiceMax als gelöscht markiert sind. (Dies gilt sowohl beim Testen der Abfrage als auch zur Laufzeit.)

• Kopieren: Klicken Sie auf das Symbol Aktivitätskonfiguration kopieren, um die vorhandene Konfiguration dieses Schritts und Schritt 2 in die Zwischenablage zu kopieren. Das Kopieren ist nur möglich, nachdem eine Abfrage in Schritt 2 mit der Schaltfläche Abfrage testen validiert wurde.

• Einfügen: Klicken Sie auf das Symbol Aktivitätskonfiguration einfügen, um eine vorhandene Konfiguration einzufügen, die aus diesem Schritt oder Schritt 2 kopiert wurde. Wenn Sie versuchen, eine Abfrage einzufügen, wird ein Bestätigungsdialog angezeigt, der darauf hinweist, dass alle vorhandenen Konfigurationen in den Schritten 1 und 2 überschrieben werden.

  Tipp

  Die Schaltflächen Kopieren und Einfügen können auch über verschiedene Instanzen der ServiceMax-Aktivität Abfrage hinweg verwendet werden.

• Abfrage testen: Klicken Sie auf diese Schaltfläche, um zu überprüfen, ob die Abfrage gültig ist. Wenn die Abfrage nicht gültig ist, werden relevante Fehlermeldungen angezeigt. Die Abfrage muss gültig sein, um die Schaltfläche Weiter zu aktivieren.

• WHERE-Klausel (Optional): Um eine WHERE-Klausel hinzuzufügen, verwenden Sie die folgenden Felder als Eingabe, um die Klausel zu konstruieren, oder geben Sie die Klausel manuell in das untere Textfeld ein. Nach dem Hinzufügen einer WHERE-Klausel müssen Sie die Abfrage zunächst mit der Schaltfläche Abfrage testen testen, um die Schaltfläche Weiter zu aktivieren.

  • Objekt: Feld: Verwenden Sie das Dropdown-Menü, um ein Feld aus den ausgewählten Objekten auszuwählen.

  • Operator: Verwenden Sie das Dropdown-Menü, um den entsprechenden Operator auszuwählen. Die Liste der verfügbaren Operatoren hängt vom Datentyp des ausgewählten Felds ab.

    Vergleich
    =	Gleich
    !=	Nicht gleich
    <	Kleiner als
    <=	Kleiner als oder gleich
    >	Größer als
    >=	Größer als oder gleich
    LIKE	Ähnlich
    IN	IN
    NOT IN	NOT IN
    INCLUDES	Gilt nur für Mehrfachauswahl-Picklists
    EXCLUDES	Gilt nur für Mehrfachauswahl-Picklists

    Logisch
    AND	TRUE, wenn beide linke und rechte Ausdrücke TRUE sind
    OR	TRUE, wenn entweder der linke oder der rechte Ausdruck TRUE ist
    NOT	TRUE, wenn der rechte Ausdruck FALSE ist

  • Wert: Geben Sie den gewünschten Wert ein, der mit den Dropdown-Auswahlen verwendet werden soll. Wenn der Wert eine Zeichenkette ist, schließen Sie den Wert in einfache Anführungszeichen ein, um das von ServiceMax verwendete Format zu entsprechen.

    Vorsicht

    Wenn Sie globale Variablen in einer WHERE-Klausel verwenden, müssen Sie einen Standardwert angeben, damit die Abfrage zum Testen gültig ist (mit der Schaltfläche Abfrage testen), da globale Variablen ihren Wert zur Laufzeit erhalten (siehe Standardwert definieren in Globale Variablen).

  • Hinzufügen: Klicken Sie auf den Link , um die Klausel automatisch basierend auf den Dropdown-Auswahlen und dem eingegebenen Wert zu konstruieren. Die automatisch konstruierte Klausel wird im unteren Textfeld angezeigt.

  Tipp

  Um mehrere Bedingungen zur Klausel hinzuzufügen, wiederholen Sie den Vorgang, indem Sie weitere Auswahlen hinzufügen. Beachten Sie, dass Sie möglicherweise einen logischen Operator wie AND oder OR hinzufügen müssen, um die zusätzlichen Bedingungen zu berücksichtigen.

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

• Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken. Wenn Sie eine WHERE-Klausel hinzugefügt haben, müssen Sie die Abfrage mit der Schaltfläche Abfrage testen testen, um die Schaltfläche Weiter zu aktivieren.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Überprüfen Sie die Datenschemas

In diesem Schritt werden alle vom Endpunkt generierten Request- oder Response-Schemas angezeigt:

• Datenschema: Das Response-Datenschema wird angezeigt. Wenn der Vorgang eine Transformation verwendet, werden die Datenschemas später während des Transformationszuordnungsprozesses erneut angezeigt, wo Sie Zielfelder mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können.

  Die verwendete Version der Salesforce-API hängt von der Jitterbit-Agent-Version ab, die Sie verwenden. Unter Voraussetzungen und unterstützte API-Versionen finden Sie Links zur Dokumentation der Schemafelder.

  Hinweis

  Um ein Datenschema in einer vorhandenen Aktivität zu aktualisieren, müssen Sie alle Konfigurationsschritte der Aktivität erneut durchlaufen und mindestens eine Änderung vornehmen (z. B. ein Zeichen am Ende des Aktivitätsnamens hinzufügen und entfernen), um eine Aktualisierung des Schemas zu erzwingen.

• Plugin(s) hinzufügen: Plugins sind von Jitterbit oder Benutzern bereitgestellte Anwendungen, die die nativen Funktionen von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie, um diesen Abschnitt zu erweitern, und aktivieren Sie das Kontrollkästchen neben dem zu verwendenden Plugin. Weitere Anweisungen zur Verwendung von Plugins, einschließlich Details zum Festlegen erforderlicher Variablen, die vom Plugin verwendet werden, finden Sie unter Plugins, die zu einer Aktivität hinzugefügt wurden.

• Zurück: Klicken Sie, 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, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer ServiceMax-Aktivität vom Typ Abfrage können Sie diese wie unten beschrieben in einem Vorgang verwenden. Nach dem Ausführen eines Vorgangs, der eine ServiceMax-Aktivität auf einem privaten Agent enthält, können Sie die Erfolgs- und Fehlerdateien des Vorgangs herunterladen.

Schließen Sie den Vorgang ab

Nach der Konfiguration einer ServiceMax-Aktivität vom Typ Abfrage schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgansschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen eines Vorgangs konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktionsmenü für Aktivitäten in Connector-Grundlagen.

ServiceMax-Aktivitäten vom Typ Abfrage können mit diesen Vorgangsmustern verwendet werden:

• Archivierungsmuster (als Quelle)
• Transformationsmuster (als Quelle)
• Zwei-Ziel-Archivierungsmuster (als erste oder zweite Quelle)
• Zwei-Transformationsmuster (als erste oder zweite Quelle)

Wenn eine ServiceMax Query als Quellaktivität verwendet wird, ist eine Zielaktivität erforderlich.

Ein Vorgang kann nur eine ServiceMax-Aktivität enthalten. Die Aktivität, die Daten von einer ServiceMax Query-Aktivität empfängt, muss einem der folgenden Connectoren zugeordnet sein: API, Database, File Share, FTP, HTTP, Local Storage, Temporary Storage oder Variable.

Eine ServiceMax-Aktivität kann als Vorgangsschritt nur in einem einzelnen Vorgang verwendet werden. Das heißt, man kann nicht auf dieselbe Aktivität mehrfach innerhalb anderer Vorgänge verweisen. Stattdessen kann man eine Kopie einer ServiceMax-Aktivität zur Verwendung an anderer Stelle erstellen (siehe Component reuse).

Andere Muster sind mit ServiceMax Query-Aktivitäten nicht zulässig. Siehe die Validierungsmuster auf der Seite Operation validity.

Wenn man innerhalb einer Transformation die Option zum Spiegeln eines Schemas verwendet, das von einer nicht-Bulk-ServiceMax-Aktivität bereitgestellt wird, wird das resultierende gespiegelte Schema automatisch mit einem zusätzlichen Root-Knoten namens records erstellt, mit untergeordneten Knoten, die das Schema spiegeln. Wenn Felder innerhalb der untergeordneten Knoten zugeordnet werden, wird der Knoten zu einem Loop-Knoten, um alle Datensätze durchlaufen zu können (siehe Loop nodes unter Data structures).

Vorgänge, die ServiceMax-Aktivitäten verwenden, können auch Vorgangsaktionen konfigurieren, die bei einem SOAP-Fehler ausgelöst werden – ein Fehler, der sich aus einem falschen Nachrichtenformat, einer Kopfzeilenverarbeitung oder einer Inkompatibilität ergibt. Vorgangsaktionen können so konfiguriert werden, dass sie einen Vorgang ausführen oder eine E-Mail senden, nachdem ein SOAP-Fehler auftritt. Anweisungen zum Auslösen einer Aktion bei SOAP-Fehler finden Sie unter Operation actions.

Um die Aktivität mit Scripting-Funktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Scripting-Funktion.

Wenn alles bereit ist, stellen Sie den Vorgang bereit und führen Sie ihn aus und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.

Erfolgs- und Fehlerdateien anzeigen

Wenn Sie einen Vorgang mit einer ServiceMax-Aktivität auf einem private agent ausführen, sind Erfolgs- und Fehlerdateien zum Download auf der Runtime-Seite der Management Console verfügbar. Wählen Sie den relevanten Vorgang in der Tabelle Runtime aus und klicken Sie auf die Registerkarte Activity Logs im unteren Bereich des Bildschirms, um Download-Links für die Dateien anzuzeigen, falls verfügbar:

• Download Success File: Wenn Sie den Vorgang auf einem private agent ausführen, klicken Sie auf den Link Download, um die erfolgreichen Datensätze als CSV-Datei zu speichern.

• Download Failure File: Wenn Sie den Vorgang auf einem private agent ausführen, klicken Sie auf den Link Download, um die fehlgeschlagenen Datensätze als CSV-Datei zu speichern.