Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

Erstellen einer Jitterbit-Entität in Design Studio

Einführung

Diese Seite beschreibt das Erstellen und Bearbeiten einer Jitterbit-Entität. Eine Jitterbit-Entität wird verwendet, um einen OData Dienst zu erstellen. Die Entität definiert eine Datenbank oder einen SAP Endpoint, Tabellen und Felder, die die Daten an einen OData Dienst.

Tipp

  • Sie müssen Design Studio verwenden (nicht Integration Studio), um eine Jitterbit-Entität zu erstellen.
  • Jitterbit-Entitäten befinden sich innerhalb eines Projekts. Bevor Sie eine Jitterbit-Entität erstellen können, müssen Sie die Anweisungen zum Erstellen eines neuen Projekts befolgen. in Design Studio.
  • Ein Projekt kann mehrere Jitterbit-Entitäten enthalten.

Erstellen einer Jitterbit-Entität

  1. Öffnen Sie Ihr Projekt in der Anwendung Design Studio. Der Bildschirm Erste Schritte sollte ähnlich wie im folgenden Bild angezeigt werden:

    Anhang

    • Das Panel auf der linken Seite des Design Studio listet die Projektelemente auf, die Sie zum Erstellen Ihrer Integration verwenden werden, z. B. Operationen, Transformations, Scripts, usw. Scrollen Sie im Fenster nach unten zu Jitterbit-Entitäten.

    • Klicken Sie mit der rechten Maustaste auf Jitterbit-Entitäten und wählen Sie im Dropdown-Menü Neue Jitterbit-Entität aus.

  2. Durch Auswahl von Neue Jitterbit-Entität wird der Bildschirm Typ im Jitterbit-Entitätsassistenten geöffnet:

    attachment

    • Auswählen Jitterbit-Entitätstyp:

      • Datenbank: Wählen Sie „Datenbank“, wenn die Daten, auf die Sie zugreifen möchten, in einer Datenbank wie SQL Server, Oracle, MySQL usw. gespeichert sind.
      • SAP: Wählen Sie SAP, wenn die Daten, auf die Sie zugreifen möchten, in einem SAP System gespeichert sind.
    • Klicken Sie unten auf dem Bildschirm auf Weiter, um fortzufahren. Klicken Sie im Jitterbit-Entity-Assistenten in einem beliebigen Schritt auf Zurück, um zum vorherigen Schritt zurückzukehren und Änderungen vorzunehmen, oder klicken Sie auf Abbrechen, um den Assistenten zu beenden, ohne die Entität zu speichern.

  3. Der Bildschirm „Endpoint“ im Jitterbit Entity Wizard sollte wie unten dargestellt angezeigt werden. Hier können Sie einen vorhandenen Endpoint auswählen oder einen neuen Endpoint für die Entität erstellen. Die Bildschirme und Schritte zum Erstellen eines neuen Endpoint unterscheiden sich je nach ausgewählter Datenbank oder SAP als Entitätstyp. Schritt 3.a. beschreibt die Anweisungen zum Konfigurieren eines Endpoint. Scrollen Sie nach unten zu Schritt 3.b., um die Anweisungen zum Konfigurieren eines SAP Endpoint zu erhalten.

    1. Datenbankentität: Wenn Sie „Datenbank“ als Entitätstyp ausgewählt haben, sollte der Assistent den Bildschirm Quelle auswählen anzeigen.

      Anhang

      1. Verfügbare Quellen: Klicken Sie auf Auswählen oder Neu erstellen, um die Liste der in Ihrem Projekt verfügbaren Datenbankquellen anzuzeigen.

        1. Wählen Sie eine vorhandene Datenbankquelle aus der Dropdown-Liste aus, falls verfügbar. 2. Wählen Sie Neu erstellen, falls die gewünschte Datenbankquelle im Projekt nicht verfügbar ist.
      2. Wenn Sie eine vorhandene Datenbankquelle auswählen, sollte derselbe Bildschirm wie unten dargestellt angezeigt werden, allerdings sind die Felder für die Verbindungsparameter bereits ausgefüllt. Klicken Sie in diesem Fall unten auf dem Bildschirm auf Weiter, um zum Bildschirm Objekt des Assistenten zu gelangen. Scrollen Sie nach unten zu Schritt 4, um mit der Konfiguration der Entität fortzufahren.

      3. Wenn Sie Neu erstellen auswählen, werden die Felder zum Erstellen einer neuen Datenbankquelle wie in der Abbildung unten angezeigt. Folgen Sie in diesem Fall den Schritten unter der Abbildung.

        attachment

        • Name: Geben Sie im Feld Name einen geeigneten Namen für den Endpoint ein. Die Standardeinstellung ist „Neue Quelle“.
        • Typ: Der Typ wird basierend auf Ihrer Auswahl im vorherigen Schritt automatisch als Datenbank ausgewählt.
        • Verbindungsparameter: Die Anweisungen zum Konfigurieren einer Datenbankquelle sind in Datenbankquelle beschrieben. Weitere Referenzen finden Sie auch in Quellen und Ziele.
        • Sobald die Datenbankquelle konfiguriert ist, klicken Sie unten auf dem Bildschirm auf Weiter, um zum Objekt-Bildschirm des Assistenten zu gelangen. Scrollen Sie nach unten zu Schritt 4, um mit der Konfiguration der Entität fortzufahren.
    2. SAP Entität: Wenn Sie SAP als Entitätstyp ausgewählt haben, sollte der Assistent den Bildschirm SAP Endpoint auswählen anzeigen.

      Anhang

      1. Verfügbare SAP Endpoints: Klicken Sie auf Auswählen oder Neu erstellen, um die Liste der in Ihrem Projekt verfügbaren SAP Endpoints anzuzeigen.
        1. Wählen Sie einen vorhandenen SAP Endpoint aus der Dropdown-Liste aus, sofern verfügbar.
        2. Wählen Sie Neu erstellen, wenn der erforderliche SAP Endpoint im Projekt nicht verfügbar ist.
      2. Wenn Sie eine vorhandene SAP Quelle auswählen, sollte derselbe Bildschirm wie unten dargestellt angezeigt werden, wobei die Felder für die Verbindungsparameter bereits ausgefüllt sind. Klicken Sie in diesem Fall unten auf dem Bildschirm auf Weiter, um zum Bildschirm Objekt im Assistenten zu gelangen. Scrollen Sie nach unten zu Schritt 4, um mit der Konfiguration der Entität fortzufahren.
      3. Wenn Sie „Neu erstellen“ auswählen, sollten die Felder zum Erstellen eines neuen SAP Endpoint wie in der Abbildung unten dargestellt angezeigt werden. Befolgen Sie in diesem Fall die unter der Abbildung beschriebenen Schritte.

        Anhang

        • Name: Geben Sie im Feld Name einen geeigneten Namen ein. Der Standardwert ist Neuer SAP Endpoint.
        • Verbindungsparameter: Die Anweisungen zum Konfigurieren eines SAP Endpoint sind in SAP -Connector Endpoint beschrieben
        • Sobald der SAP Endpoint konfiguriert ist, klicken Sie unten auf dem Bildschirm auf „Weiter“, um fortzufahren.
  4. Sobald die Datenbankquelle oder der SAP Endpoint konfiguriert ist, sollte durch Klicken auf Weiter der Objekt-Bildschirm im Jitterbit Entity Wizard angezeigt werden. In diesem Schritt können Sie bestimmte Tabellen in Ihrer Datenbank oder SAP Endpoint auswählen:

    Anhang

    • Name enthält: Geben Sie Zeichen in das Feld Name enthält ein, um die Abfrage zu filtern. Im Beispiel haben wir KNA1 eingegeben, um nach Kundentabellen zu filtern. Lassen Sie das Feld Name enthält leer, um alle verfügbaren Objekte oder Tabellen anzuzeigen.
    • Objekttyp: Wählen Sie den Objekttyp aus der Dropdown-Liste aus. In diesem Beispiel ist Nur Tabellen ausgewählt.
    • Klicken Sie auf den Anhang-Schaltfläche, um die Liste der verfügbaren Objekte oder Tabellen anzuzeigen:
      attachment

      • Klicken Sie in der Liste auf den Namen des Objekts oder der Tabelle, um den gewünschten Datensatz zu erstellen. In diesem Beispiel wird die Tabelle KNA1 ausgewählt, die die Kundenstammdaten enthält. Klicken Sie auf Weiter, um fortzufahren.
  5. Der Bildschirm Felder & Filter im Jitterbit-Entity-Assistent sollte ähnlich wie in der unten gezeigten Abbildung aussehen. In diesem Schritt werden bestimmte Felder ausgewählt, um den Datensatz zu definieren.

    attachment

    • Suchen: Geben Sie im Feld Suchen teilweise oder vollständige Feldnamen ein, um die Liste der in einer bestimmten Kategorie verfügbaren Felder anzuzeigen. Lassen Sie das Feld Suchen leer, um alle im zuvor ausgewählten Objekt oder der Tabelle verfügbaren Felder anzuzeigen.
      • Klicken Sie auf das zugehörige Kontrollkästchen, um jedes Feld auszuwählen, das in den Datensatz aufgenommen werden soll.
      • Sie können mehrere Feldnamen in das Suchfeld eingeben und aus jeder Ergebnisliste mehrere Felder auswählen. In diesem Beispiel wurden die Wörter „Ort“, „Postleitzahl“, „Adresse“, „Name“, „Land“ und „Kunde“ in das Suchfeld eingegeben und aus jeder Liste mehrere Felder ausgewählt.
    • Immer ausgewählte Felder anzeigen: Aktivieren Sie dieses Kontrollkästchen, um beim Durchlaufen mehrerer Feldlisten weiterhin alle zuvor ausgewählten Felder anzuzeigen.
    • Alles auswählen: Klicken Sie auf die Schaltfläche Alles auswählen, um alle in der Tabelle enthaltenen Felder auszuwählen und in den Datensatz aufzunehmen.
    • Auswahl aufheben: Klicken Sie auf die Schaltfläche Auswahl aufheben, um alle in der Tabelle enthaltenen Felder aus dem Datensatz zu entfernen.
    • Basisfilter (optional): Sie können in der rechten Spalte des Bildschirms auch einen für Ihre Datenbank oder SAP System spezifischen Basisfilter eingeben, um Ihre Daten zu filtern.
    • Wenn alle erforderlichen Felder ausgewählt wurden, klicken Sie auf Weiter, um fortzufahren.
  6. Der Bildschirm JDML-Entität im Jitterbit-Entitätsassistenten sollte ähnlich wie unten abgebildet aussehen. In diesem Schritt werden der Entitätsname und das primäre ID-Feld definiert:

    Anhang

    • Jitterbit hat basierend auf den vorherigen Auswahlen eine neue Entität erstellt.

    • Entitätsname: Geben Sie den gewünschten Namen in das Feld Entitätsname ein. In diesem Beispiel heißt die Entität Kunden.

      Notiz

      Der Entitätsname muss aus einem einzigen Wort bestehen. Verbraucher, die auf die API zugreifen, können den Namen ebenfalls sehen.

    • ID: Klicken Sie auf das zugehörige Kontrollkästchen, um ein Feld als Primäre ID und als eindeutigen Schlüssel zur Identifizierung der Entität oder des neuen Objekts auszuwählen. In diesem Beispiel wird das Feld Kunde_1 als eindeutiger Schlüssel ausgewählt.

      Notiz

      • Wenn kein ID-Feld ausgewählt ist, wird eine Popup-Fehlermeldung angezeigt: „Es ist kein ID-Feld definiert. Möchten Sie fortfahren?“ Klicken Sie auf Weiter, um das Popup zu schließen und die Entität ohne definierte ID abzuschließen, oder klicken Sie auf Abbrechen, um zum Assistentenbildschirm zurückzukehren.
      • Wenn die Entität ohne definiertes ID-Feld fertiggestellt wird, wird oben rechts im Bildschirm „Jitterbit-Entitäten“ der Status „Warnung“ angezeigt. Die Popup-Meldung lautet: „Validierungsprobleme. Es ist kein ID-Feld definiert.“
      • Wenn die zurückgegebenen Daten doppelte Datensätze mit demselben primären ID-Wert oder Datensätze ohne primäre ID-Werte enthalten, werden diese Daten möglicherweise zur Laufzeit übersprungen.
    • Klicken Sie auf Fertig, um fortzufahren.

  7. Die Tab Jitterbit-Entitäten wird ähnlich wie in diesem Bild angezeigt:

    Anhang

  8. Nächster Schritt: Weitere Informationen zum Konfigurieren eines OData Dienstes finden Sie unter OData-Dienstkonfiguration.

Bearbeiten einer Jitterbit-Entität

  1. Öffnen Sie das Projekt, das die Entität enthält, in Design Studio.
  2. Scrollen Sie im Projektelementbereich auf der linken Seite des Design Studio nach unten zu Jitterbit-Entitäten.
  3. Klicken Sie mit der rechten Maustaste auf den Namen der Entität, die Sie bearbeiten möchten. Wählen Sie im Dropdown-Menü Öffnen aus.
  4. Die Tab „Jitterbit-Entitäten“ wird ähnlich wie in diesem Bild angezeigt:

    Anhang

  5. Um die Primär-ID zu ändern, aktivieren Sie das Kontrollkästchen neben der aktuellen Primär-ID. Deaktivieren Sie das Kontrollkästchen und entfernen Sie die vorhandene Primär-ID aus dem Datensatz. Aktivieren Sie das Kontrollkästchen neben der neuen Primär-ID, um das neue ID-Feld im Datensatz zu definieren.

  6. Klicken Sie auf die Schaltfläche „Speichern attachment** Symbol in der Symbolleiste in der oberen rechten Ecke der Tab „Jitterbit-Entitäten“.
  7. Um Felder zum Datensatz hinzuzufügen oder daraus zu entfernen, klicken Sie auf das Anhang-Schaltfläche. Das Popup-Fenster Felder auswählen wird geöffnet:

    Anhang

    • Suchen: Geben Sie im Feld Suchen teilweise oder vollständige Feldnamen ein, um die Liste der in einer bestimmten Kategorie verfügbaren Felder anzuzeigen. Lassen Sie das Feld Suchen leer, um alle im zuvor ausgewählten Objekt oder der Tabelle verfügbaren Felder anzuzeigen.

      • Klicken Sie auf das zugehörige Kontrollkästchen, um die einzelnen Felder auszuwählen, die in den Datensatz aufgenommen werden sollen.
      • Sie können im Feld Suchen mehrere Feldnamen eingeben und aus jeder Ergebnisliste mehrere Felder auswählen.
    • Kontrollkästchen „Ausgewählte Felder immer anzeigen“: Aktivieren Sie dieses Kontrollkästchen, um beim Durchlaufen mehrerer Feldlisten weiterhin alle zuvor ausgewählten Felder anzuzeigen.

    • Alles auswählen: Klicken Sie auf die Schaltfläche Alles auswählen, um alle in der Tabelle enthaltenen Felder auszuwählen und in den Datensatz aufzunehmen.
    • Auswahl aufheben: Klicken Sie auf die Schaltfläche Auswahl aufheben, um alle in der Tabelle enthaltenen Felder aus dem Datensatz zu entfernen.
    • Sobald alle erforderlichen Felder ausgewählt sind, klicken Sie auf OK, um das Popup zu schließen.
    • Klicken Sie auf Speichern attachment-Symbol in der Symbolleiste in der oberen rechten Ecke der Tab „Jitterbit-Entitäten“, um die Änderungen zu speichern.