SAP SuccessFactors Abfrageaktivität

Einführung

Eine SAP SuccessFactors Abfrage-Aktivität, die ihre SAP SuccessFactors-Verbindung verwendet, ruft Objektdaten aus SAP SuccessFactors ab und ist als Quelle gedacht, um Daten in einem Vorgang bereitzustellen.

Erstellen einer SAP SuccessFactors Abfrageaktivität

Eine Instanz einer SAP SuccessFactors Abfrage-Aktivität wird aus einer SAP SuccessFactors-Verbindung unter Verwendung des Abfrage-Aktivitätstyps 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 SAP SuccessFactors Abfrage-Aktivität kann von diesen Orten aus bearbeitet werden:

• Die Entwurfsfläche (siehe Komponentenaktionsmenü in Entwurfsfläche).
• Der Komponenten-Tab im Projektbereich (siehe Komponentenaktionsmenü in Projektbereich Komponenten-Tab).

Konfigurieren einer SAP SuccessFactors Abfrageaktivität

Befolgen Sie diese Schritte, um eine SAP SuccessFactors Abfrage-Aktivität 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 ein und wählen Sie ein Objekt aus.

• Schritt 2: Wählen Sie ein Unterobjekt aus
  Wählen Sie ein Unterobjekt aus.

• Schritt 3: Definieren Sie eine Filterzeichenfolge
  Legen Sie Bedingungen für eine Abfrage zu den ausgewählten Objekten fest.

• Schritt 4: Überprüfen Sie die Datenschemas
  Alle Anforderungs- oder Antwortschemas werden angezeigt.

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

In diesem Schritt geben Sie einen Namen für die Aktivität ein und wählen ein Objekt aus. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

• Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede SAP SuccessFactors Abfrage-Aktivität einzigartig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

• Wählen Sie ein Objekt aus: In diesem Abschnitt werden die in der SAP SuccessFactors-Schnittstelle verfügbaren Objekte angezeigt.

  • Ausgewähltes Objekt: Nachdem ein Objekt ausgewählt wurde, wird es hier aufgelistet.

  • Suche: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Objekte aus der Schnittstelle beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Objekte aus der SAP SuccessFactors-Schnittstelle neu zu laden. Dies kann nützlich sein, wenn Objekte zu SAP SuccessFactors hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Objekttabelle verwendet werden.

  • Ein Objekt auswählen: Klicken Sie innerhalb der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Objekt auszuwählen. Es kann nur ein Objekt ausgewählt werden. Die Informationen, die für jedes Objekt verfügbar sind, werden von der SAP SuccessFactors-Schnittstelle abgerufen:

    • Name: Der Name des Objekts

  Tipp

  Wenn die Tabelle nicht mit verfügbaren Objekten gefüllt wird, könnte die SAP SuccessFactors-Verbindung nicht erfolgreich sein. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

• 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: Nach dem Vornehmen von Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Wählen Sie ein Unterobjekt

In diesem Schritt wählen Sie ein Unterobjekt aus. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

• Wählen Sie ein Unterobjekt: In diesem Abschnitt werden die im SAP SuccessFactors-Endpunkt verfügbaren Unterobjekte angezeigt.

  • Ausgewähltes Objekt: Das im vorherigen Schritt ausgewählte Objekt wird hier aufgelistet.

  • Ausgewähltes Unterobjekt: Nach der Auswahl eines Unterobjekts wird es hier aufgelistet.

  • Suche: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Unterobjekte zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn Unterobjekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Unterobjekte vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Unterobjekte vom SAP SuccessFactors-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Unterobjekte zu SAP SuccessFactors hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der in der Konfiguration angezeigten Unterobjekte verwendet werden.

  • Auswählen eines Unterobjekts: Klicken Sie innerhalb der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Unterobjekt auszuwählen. Es kann nur ein Unterobjekt ausgewählt werden. Die für jedes Unterobjekt verfügbaren Informationen werden vom SAP SuccessFactors-Endpunkt abgerufen:

    • Name: Der Name des Unterobjekts.

    • Beschreibung: Die Beschreibung des Unterobjekts.

  Tipp

  Wenn die Tabelle nicht mit verfügbaren Unterobjekten gefüllt wird, könnte die SAP SuccessFactors-Verbindung nicht erfolgreich sein. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

• 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 mit dem nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

• Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Definieren Sie eine Filterzeichenfolge

In diesem Schritt wird eine Filterzeichenfolge für eine Abfrage unter Verwendung verfügbarer Objektfelder und Abfrageeinstellungen definiert. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

Die in diesem Schritt der Konfiguration einer SAP SuccessFactors Abfrage-Aktivität verwendete Benutzeroberfläche hängt vom ausgewählten Tab ab:

• Basis: Diese Option ermöglicht es Ihnen, die Filterzeichenfolge mit geführten Feldern zu erstellen.

• Erweitert: Diese Option blendet die geführten Felder aus und ermöglicht es Ihnen, die Filterzeichenfolge direkt zu ändern.

Basis

Wenn der Tab Basis ausgewählt ist, wird diese Benutzeroberfläche angezeigt:

• Objektfelder: Wählen Sie die Felder aus, die in der Abfrage basierend auf der ausgewählten Objektklasse verwendet werden sollen.

  • Suche: Geben Sie einen Teil eines Feldnamens in das Suchfeld ein, um die Liste der Felder für das ausgewählte Objekt zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Die aufgelisteten Ergebnisse werden in Echtzeit mit jedem Tastendruck gefiltert.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Felder des Objekts vom SAP SuccessFactors-Endpunkt neu zu laden.

  • Alle in der Objektklasse 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.

  • Felder auswählen: Wählen Sie die Kontrollkästchen der Felder aus, die Sie in die Abfrage einbeziehen möchten, damit sie automatisch zur Filterzeichenfolge hinzugefügt werden. Sie können auch alle Felder auf einmal mit dem übergeordneten Kontrollkästchen auswählen.

  • Seitenzahl: Geben Sie eine Seitenzahl ein, um die Ergebnis-Paginierung zu aktivieren. Die Anzahl der Ergebnisse auf einer Seite wird die angegebene Größe nicht überschreiten. Ein Link zur nächsten Seite der Ergebnisse wird ebenfalls in der Antwort enthalten sein.

  • Anzahl einbeziehen: Wählen Sie aus, um die Anzahl der Ergebnisse aus einer Abfrage als Teil der Antwort einzubeziehen.

  • Volltextsuche: Geben Sie Suchbegriffe ein, um nach Objekten in der ausgewählten Objektklasse zu suchen. Der SAP SuccessFactors-Endpunkt verarbeitet, wie die Suche für eine Objektklasse interpretiert wird.

  • Überspringen: Geben Sie eine Anzahl von Ergebnissen an, die in der Abfrageantwort übersprungen werden sollen.

  • Top: Geben Sie eine maximale Anzahl von Ergebnissen an, die Sie in der Abfrageantwort erhalten möchten.

  • Bedingte Klauseln: Um Bedingungen hinzuzufügen, verwenden Sie diese Felder als Eingabe, um die Klauseln zu erstellen, die dann in der Filterzeichenfolge erscheinen.

    • Objekt: Verwenden Sie das Dropdown-Menü, um die Objektklasse auszuwählen, die für die Bedingung verwendet werden soll.

    • Feld: Verwenden Sie das Dropdown-Menü, um das Feld aus der Objektklasse auszuwählen, das für die Bedingung verwendet werden soll.

    • Operator: Verwenden Sie das Dropdown-Menü, um einen geeigneten Operator auszuwählen:

      Vergleich
      Gleich
      Größer als
      Größer als oder gleich
      Kleiner als
      Kleiner als oder gleich

    • Wert: Geben Sie den gewünschten Wert ein, um ihn mit den vorherigen Dropdown-Auswahlen zu vergleichen.

    • Entfernen: Klicken Sie auf das Löschsymbol , um die Bedingung aus der Tabelle zu entfernen.

    • Hinzufügen: Klicken Sie, um eine neue Bedingung zur Tabelle und Filterzeichenfolge hinzuzufügen.

    • Alle Entfernen: Klicken Sie, um alle Bedingungen aus der Tabelle und Filterzeichenfolge zu entfernen.

  • Filterzeichenfolge: Während Sie die anderen Felder im Tab Basis ausfüllen, wird die Filterzeichenfolgenanweisung in diesem Textfeld automatisch mit den ausgewählten Feldern, Bedingungen und Abfrageoptionen ausgefüllt.

    Wichtig

    Aufgrund einer Einschränkung des Connectors schlägt die Operation zur Laufzeit fehl, wenn mehr als ein Filter in der Filterzeichenfolge vorhanden ist.

• Abfrage testen: Klicken Sie, um die Abfrage zu validieren.

• 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 mit dem nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie 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 vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Erweitert

Wenn der Tab Erweitert ausgewählt ist, wird diese Schnittstelle angezeigt:

• Objektfelder: Wählen Sie die Felder aus, die in der Abfrage basierend auf der ausgewählten Objektklasse verwendet werden sollen.

  • Seitenanzahl: Geben Sie eine Seitenanzahl ein, um die Ergebnis-Paginierung zu aktivieren. Die Anzahl der Ergebnisse auf einer Seite wird bis zur angegebenen Größe insgesamt sein. Ein Link zur nächsten Seite der Ergebnisse wird ebenfalls in der Antwort enthalten sein.

  • Filter-String: Bearbeiten Sie die Filter-String-Anweisung direkt.

    Wichtig

    Aufgrund einer Einschränkung des Connectors schlägt die Operation zur Laufzeit fehl, wenn mehr als ein Filter im Filter-String vorhanden ist.

  • Testabfrage: Klicken Sie, um die Abfrage zu validieren. Wenn die Abfrage gültig ist, wird eine Stichprobe von bis zu 10 Datensätzen, die aus der Abfrage abgerufen wurden, in einer Tabelle angezeigt. Wenn die Abfrage ungültig ist, werden relevante Fehlermeldungen angezeigt. Wenn Sie den Filter-String im Erweiterten Modus bearbeiten, muss die Abfrage gültig sein und über diese Schaltfläche validiert werden, um die Schaltfläche Weiter zu aktivieren.

• 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 mit dem nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie 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 vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 4: Überprüfen der Datenschemas

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

• Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen übernommen und während der Transformationszuordnung erneut angezeigt.

  Der SAP SuccessFactors-Connector verwendet die SAP SuccessFactors HXM Suite OData API v2. Weitere Informationen zu den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.

  Die Abfrage-Aktivität verwendet JSON in ihrem Antwortschema.

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Schemata vom SAP SuccessFactors-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, z. B. in einer angrenzenden Transformation.

• 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: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine SAP SuccessFactors Abfrage-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration des Vorgangs, indem Sie andere Aktivitäten oder Werkzeuge als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Vorgänge 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. Für Details siehe Aktivitätsaktionsmenü in Connector-Grundlagen.

SAP SuccessFactors Abfrage-Aktivitäten können als Quelle mit diesen Vorgangsmustern verwendet werden:

• Transformationsmuster
• Zwei-Ziel-Archivmuster (nur als erste Quelle)
• Zwei-Ziel-HTTP-Archivmuster (nur als erste Quelle)
• Zwei-Transformationsmuster (nur als erste Quelle)

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, führen Sie die Bereitstellung und Ausführung der Operation durch und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.