Erstellen einer Jitterbit-Entität in Design Studio

Einführung

Auf dieser Seite wird beschrieben, wie eine Jitterbit-Entität erstellt und bearbeitet wird. 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 bereitstellen.

Erstellen einer Jitterbit-Entität

1. Öffnen Sie Ihr Projekt in der Anwendung Design Studio. Der Bildschirm Erste Schritte sollte ungefähr wie das folgende Bild aussehen:

   

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

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

2. Wenn Sie Neue Jitterbit-Entität auswählen, wird der Bildschirm Typ im Jitterbit-Entitätsassistenten gestartet:

   

   • 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 beim Arbeiten im Jitterbit Entity Wizard bei jedem 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. Dieser Bildschirm bietet die Möglichkeit, einen vorhandenen Endpoint auszuwählen oder einen neuen Endpoint für die Entität zu erstellen. Die Bildschirme und Schritte zum Erstellen eines neuen Endpoint unterscheiden sich, je nachdem, ob Sie als Entitätstyp eine Datenbank oder SAP ausgewählt haben. Schritt 3.a. enthält 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.

      

      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 diese verfügbar ist.
         2. Wählen Sie Neu erstellen, falls die erforderliche Datenbankquelle im Projekt nicht verfügbar ist.

      2. Wenn Sie eine vorhandene Datenbankquelle auswählen, sollte derselbe Bildschirm wie unten gezeigt angezeigt werden, allerdings mit bereits ausgefüllten Feldern für Verbindungsparameter. 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 einer neuen Datenbankquelle angezeigt werden, wie im Bild unten dargestellt. Befolgen Sie in diesem Fall die unter dem Bild beschriebenen Schritte.

         

         • Name: Geben Sie im Feld Name einen geeigneten Namen für den Endpoint ein. Der Standardwert 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 Bildschirm Objekt im 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.

      

      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 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 angezeigt werden, wie im Bild unten dargestellt. Befolgen Sie in diesem Fall die unter dem Bild beschriebenen Schritte.

         

         • 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 wurde, sollte durch Auswahl von Weiter der Bildschirm Objekt im Jitterbit Entity Wizard angezeigt werden. In diesem Schritt können Sie bestimmte Tabellen in Ihrer Datenbank oder SAP - Endpoint auswählen:

   

   • 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. In diesem Beispiel ist Nur Tabellen ausgewählt.

   • Klicken Sie auf -Schaltfläche, um die Liste der verfügbaren Objekte oder Tabellen anzuzeigen:
     

     • Klicken Sie auf den Namen des Objekts oder der Tabelle in der Liste, um den erforderlichen 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 Wizard sollte ähnlich wie das unten gezeigte Bild angezeigt werden. In diesem Schritt werden bestimmte Felder ausgewählt, um den Datensatz zu definieren.

   

   • Suchen: Geben Sie teilweise oder vollständige Feldnamen in das Feld Suchen 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 in 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 Feld Suchen eingeben und aus jeder resultierenden Liste mehrere Felder auswählen. In diesem Beispiel wurden die Wörter Stadt, Post, Adresse, Name, Land und Kunde in das Feld Suchen 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 aller abwählen: Klicken Sie auf die Schaltfläche Auswahl aller abwählen, 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 JDML-Entity-Bildschirm im Jitterbit-Entity-Assistenten sollte ähnlich wie das unten gezeigte Bild aussehen. In diesem Schritt wird der Entity-Name definiert und das primäre ID-Feld definiert:

   

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

   • Entitätsname: Geben Sie im Feld Entitätsname den Namen ein, den Sie verwenden möchten. 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-Feld auszuwählen und als eindeutigen Schlüssel festzulegen, der die Entität oder das neue Objekt identifiziert. 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 Fortfahren, 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 in der oberen rechten Ecke des Bildschirms „Jitterbit-Entitäten“ ein 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:

   

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 Projektelemente-Bereich auf der linken Seite des Design Studio 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:

   

5. Um die Primär-ID zu ändern, klicken Sie auf das Kontrollkästchen, das der aktuellen Primär-ID zugeordnet ist, um zunächst das Kontrollkästchen zu deaktivieren und die vorhandene Primär-ID aus dem Datensatz zu entfernen. Klicken Sie auf das Kontrollkästchen, das der neuen Primär-ID zugeordnet ist, um das neue ID-Feld im Datensatz zu definieren.

6. Klicken Sie auf Speichern 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 -Schaltfläche. Das Popup-Fenster Felder auswählen wird geöffnet:

   

   • Suchen: Geben Sie teilweise oder vollständige Feldnamen in das Feld Suchen 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 in 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 Feld Suchen eingeben und aus jeder resultierenden Liste mehrere Felder auswählen.

   • Kontrollkästchen „Ausgewählte Felder immer anzeigen“: Klicken Sie auf dieses Kontrollkästchen, um weiterhin alle zuvor ausgewählten Felder anzuzeigen, während Sie durch mehrere Feldlisten blättern.

   • 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.
   • Wenn alle erforderlichen Felder ausgewählt wurden, klicken Sie auf OK, um das Popup zu schließen.
   • Klicken Sie auf Speichern -Symbol in der Symbolleiste in der oberen rechten Ecke der Tab „Jitterbit-Entitäten“, um die Änderungen zu speichern.