ServiceMax Bulk Query-Aktivität

Einführung

Eine ServiceMax Bulk Query-Aktivität, die ihre ServiceMax-Verbindung verwendet, fragt eine große Anzahl von Datensätzen aus ServiceMax ab und ist dazu gedacht, als Quelle für die Bereitstellung von Daten in einem Vorgang verwendet zu werden.

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

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

Erstellen einer ServiceMax Bulk Query-Aktivität

Eine Instanz einer ServiceMax Bulk Query-Aktivität wird aus einer ServiceMax-Verbindung unter Verwendung des Aktivitätstyps Bulk Query erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Weitere Einzelheiten finden Sie unter Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

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

• Der Entwurfsfläche (siehe Komponentenaktionsmenü in Entwurfsfläche).

• Der Komponenten-Tab im Projektbereich (siehe Komponenten-Aktionsmenü im Projektbereich Komponenten-Tab).

Konfigurieren einer ServiceMax Bulk Query-Aktivität

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

• Schritt 1: Geben Sie einen Namen ein und wählen Sie Objekte aus
  Geben Sie einen Namen für die Aktivität ein und wählen Sie die Objekte aus, die in großen Mengen abgefragt werden sollen.

• Schritt 2: Wählen Sie Felder aus und erstellen Sie Bedingungen
  Erstellen Sie die Abfrageanweisung entweder automatisch, indem Sie Felder auswählen und Bedingungen festlegen, oder manuell, indem Sie direkt eine Abfrageanweisung eingeben.

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

In diesem Schritt geben Sie einen Namen für die Aktivität ein und wählen die Objekte aus, die in großen Mengen abgefragt werden sollen.

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

• Wählen Sie Objekt(e) aus: In diesem Abschnitt werden die in der ServiceMax-Verbindung verfügbaren Objekte angezeigt:

  • Kopieren: Klicken Sie auf das Kopieren der Aktivitätskonfiguration-Symbol, um die vorhandene Konfiguration sowohl dieses Schrittes als auch von Schritt 2 in Ihre 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 Einfügen der Aktivitätskonfiguration-Symbol, 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 Bulk Query-Aktivität hinweg verwendet werden.

  • Ansicht: Verwenden Sie das Dropdown-Menü, um die Liste der Objekte, die Bulk Query unterstützen, auf alle Objekte, Standardobjekte oder benutzerdefinierte Objekte zu filtern. Standardmäßig werden alle Objekte angezeigt.

  • Suche: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol , um Objekte vom ServiceMax-Endpunkt neu zu laden. Dies ist nützlich, 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: Klicken Sie auf ein Objekt aus der Liste der Objekte, um es auszuwählen. Es kann nur ein Objekt ausgewählt werden.

    Hinweis

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

    • Die ServiceMax-Verbindung könnte nicht erfolgreich sein. 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 den folgenden Fehler beim Abrufen von Daten während der Aktivitätskonfiguration verursachen:

      Ungültiger Benutzername, Passwort, Sicherheitstoken; oder Benutzer gesperrt. [INVALID_LOGIN]
      

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

• Speichern & Beenden: Wenn aktiviert, klicken Sie, 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 fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

• Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht 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 durch Auswahl von Feldern und Festlegung von Bedingungen oder manuell durch direkte Eingabe einer Abfrageanweisung. Sie müssen die Abfrage testen, um sicherzustellen, dass sie gültig ist, bevor Sie zum nächsten Schritt übergehen.

• Felder auswählen & Bedingungen erstellen: Dieser Abschnitt zeigt die Felder für das/die ausgewählte(n) Objekt(e), die im ServiceMax-Endpunkt verfügbar sind. Objekte, die im vorherigen Schritt ausgewählt wurden, werden fett dargestellt.

  • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Felder zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Die aufgelisteten Ergebnisse werden in Echtzeit mit jedem Tastendruck gefiltert.

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

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

• SOQL-Anweisung: Während Sie Felder auswählen, wird die Abfrageanweisung im oberen rechten Textfeld automatisch mit dem Objekt und den ausgewählten Feldern ausgefüllt. Um eine benutzerdefinierte SOQL-Anweisung zu verwenden, nehmen Sie bei Bedarf Änderungen in diesem Textfeld vor. Für Hinweise zur Strukturierung einer benutzerdefinierten SOQL-Anweisung siehe die Dokumentation von Salesforce zur SOQL SELECT-Syntax.

• Kopieren: Klicken Sie auf das Kopieren der Aktivitätskonfiguration-Symbol, um die vorhandene Konfiguration sowohl dieses Schrittes als auch von Schritt 1 in Ihre Zwischenablage zu kopieren. Das Kopieren ist nur möglich, nachdem eine Abfrage mit der Abfrage testen-Schaltfläche validiert wurde.

• Einfügen: Klicken Sie auf das Einfügen der Aktivitätskonfiguration-Symbol, um eine vorhandene Konfiguration einzufügen, die von diesem Schritt oder Schritt 1 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 Kopieren- und Einfügen-Schaltflächen können auch in verschiedenen Instanzen der ServiceMax Bulk Query-Aktivität verwendet werden.

• Abfrage testen: Klicken Sie auf diese Schaltfläche, um zu validieren, ob die Abfrage gültig ist. Wenn die Abfrage gültig ist, wird eine Stichprobe von 10 Datensätzen, die aus der Abfrage abgerufen wurden, in einer Tabelle angezeigt, die der unten gezeigten ähnlich ist. Die Abfrage muss gültig sein, um die Weiter-Schaltfläche zu aktivieren. Wenn die Abfrage ungültig ist, werden relevante Fehlermeldungen angezeigt.

• WHERE-Klausel (Optional): Um eine WHERE-Klausel hinzuzufügen, verwenden Sie die untenstehenden Felder als Eingabe, um die Klausel zu erstellen, oder geben Sie die Klausel manuell im unteren Textfeld ein. Nach dem Hinzufügen einer WHERE-Klausel müssen Sie zuerst die Abfrage mit der Abfrage testen-Schaltfläche testen, um die Weiter-Schaltfläche 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/die entsprechenden Operatoren auszuwählen. Die Liste der verfügbaren Operatoren hängt vom Datentyp des ausgewählten Feldes ab.

    Vergleich
    =	Gleich
    !=	Ungleich
    <	Kleiner als
    <=	Kleiner oder gleich
    >	Größer als
    >=	Größer oder gleich
    LIKE	Wie
    IN	IN
    NOT IN	NICHT IN
    INCLUDES	Gilt nur für Mehrfachauswahl-Listen
    EXCLUDES	Gilt nur für Mehrfachauswahl-Listen

    Logisch
    UND	WAHR, wenn sowohl der linke als auch der rechte Ausdruck WAHR sind
    ODER	WAHR, wenn entweder der linke oder der rechte Ausdruck WAHR ist
    NICHT	WAHR, wenn der rechte Ausdruck FALSCH ist

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

    Vorsicht

    Wenn Sie globale Variablen in einer WHERE-Klausel verwenden, müssen Sie einen Standardwert angeben, damit die Abfrage für Tests gültig ist (mit der Schaltfläche Testabfrage), da globale Variablen ihren Wert zur Laufzeit erhalten (siehe Definieren Sie einen Standardwert in Globalen Variablen).

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

  Tipp

  Um mehrere Bedingungen zur Klausel hinzuzufügen, wiederholen Sie den Vorgang, indem Sie zusätzliche Auswahlen hinzufügen. Beachten Sie, dass Sie möglicherweise einen logischen Operator wie UND oder ODER 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.

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

• Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Nächste Schritte

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

Vervollständigen Sie die Operation

Nachdem Sie eine ServiceMax Bulk Query-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration der Operation, indem Sie andere Aktivitäten oder Tools als Operation Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Operationen zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Weitere Einzelheiten finden Sie im Aktivitätsaktionsmenü in Connector-Grundlagen.

ServiceMax Bulk Query-Aktivitäten können als Quelle mit dem ServiceMax Bulk-Quellmuster verwendet werden. Andere Muster sind bei der Verwendung von ServiceMax Bulk Query-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite Betriebsvalidität.

Operationen, die eine ServiceMax-Aktivität enthalten, können nur eine ServiceMax-Aktivität haben und dürfen keine anderen Aktivitäten enthalten, außer denen, die mit den API, Datenbank, Dateifreigabe, FTP, HTTP, Lokalen Speicher, Temporären Speicher oder Variablen -Konnektoren verbunden sind.

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

In addition, das dateibasierte Ziel, das in der Operation verwendet wird, muss ein Flachdateiformat mit einem Header und nur den folgenden Datentypen verwenden:

• Base64
• Boolean
• Datumsformate
• Double
• Integer
• Salesforce-ID
• String

Operationen, die ServiceMax-Aktivitäten verwenden, können auch Betriebsaktionen konfiguriert haben, die bei einem SOAP-Fehler ausgelöst werden — ein Fehler, der aus einem falschen Nachrichtenformat, der Header-Verarbeitung oder Inkompatibilität resultiert. Betriebsaktionen können so konfiguriert werden, dass sie eine Operation ausführen oder eine Email senden, nachdem ein SOAP-Fehler aufgetreten ist. Für Anweisungen zum Auslösen einer Aktion bei einem SOAP-Fehler siehe Betriebsaktionen.

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

Wenn du bereit bist, deploye und führe die Operation aus und validiere das Verhalten, indem du die Betriebsprotokolle überprüfst.

Erfolg- und Fehlerdateien anzeigen

Wenn du eine Operation mit einer ServiceMax-Aktivität auf einem privaten Agenten ausführst, sind Erfolg- und Fehlerdateien zum Download auf der Runtime Operations-Seite der Management Console verfügbar. Wähle die relevante Operation in der Runtime Operations-Tabelle aus und klicke auf die Registerkarte Activity Logs im unteren Bereich des Bildschirms, um Download-Links für die Dateien anzuzeigen, falls verfügbar:

• Erfolg Datei herunterladen: Wenn du die Operation auf einem privaten Agenten ausführst, klicke auf den Download-Link, um die Erfolgsdatensätze als CSV-Datei zu speichern.

• Fehler Datei herunterladen: Wenn du die Operation auf einem privaten Agenten ausführst, klicke auf den Download-Link, um die Fehlerdatensätze als CSV-Datei zu speichern.

Aktivitätsprotokoll-Downloads sind für Cloud-Agenten deaktiviert. Wenn die Links sichtbar sind, erhalten Sie eine Fehlermeldung, wenn Sie versuchen, einen Download durchzuführen.