Zum Inhalt springen

App Builder Connector in Jitterbit App Builder

Übersicht

App Builder Connector ist eine Funktion, die zwei verschiedene App Builder Instanzen miteinander verbindet und als Regel behandelt, die Tabelle importiert und verwendet.

Als Entwickler können Sie den App Builder Connector verwenden, um zwei verschiedene Instanzen zu verbinden, die in derselben Umgebung (Lokal) ausgeführt werden, oder über zwei verschiedene Umgebungen hinweg über HTTP (Remote). Schritte zum Konfigurieren von lokalen und Remote App Builder Connectoren finden Sie in diesem Artikel.

Falls Sie ein App Builder LP-Abhängigkeitsszenario lösen möchten, empfehlen wir die Verwendung der Funktion Table Inheritance oder Extend Table und nicht den App Builder Connector für diesen Zweck. Die Funktion Extend Table ermöglicht es Ihnen, einfach Tabellen auszuwählen, die Sie von anderen Datenquellen auf derselben Instanz oder Umgebung verwenden möchten, und erstellt keine Abhängigkeit von anderen Apps, wenn Sie Ihre App LP bündeln und bereitstellen möchten.

Ein Beispiel für das App Builder LP-Abhängigkeitsszenario:
Sie haben zwei App Builder Datenquellen auf derselben Instanz oder Umgebung und möchten zwischen Datenquelle A und Datenquelle B verknüpfen. Falls Ihre App Datenquelle A verwendet und Sie eine Tabelle aus Datenquelle B verwenden möchten, und Sie dann eine Version von App A bereitstellen müssen, die nur 1 Tabelle aus App B verwendet, müssen Sie sowohl App A als auch B bündeln und bereitstellen. Auch hier wird empfohlen, diesen Szenariotyp mithilfe von erweiterten Tabellen zu lösen. Dies ist eine viel einfachere und bessere Lösung.

Warnung

Es wird grundsätzlich nicht empfohlen, dass Kunden eigenständig mit App Builder Connectoren arbeiten, ohne vorher ihren dedizierten Jitterbit Berater oder Kontakt zu konsultieren.

Lokaler App Builder Connector

Der lokale App Builder Connector kann verwendet werden, um eine Verbindung von einer relationalen Datenquelle zu einer anderen innerhalb derselben Umgebung herzustellen.

1. Erstellen eines lokalen App Builder Connectors

  • Klicken Sie in der IDE auf Data Servers
  • Klicken Sie im Panel „Data Servers" auf + Server
  • Benennen Sie Ihre Serververbindung
    • Best Practice ist es, den Server als Local App Builder zu benennen
  • Wählen Sie den Typ App Builder im Abschnitt „Server Settings"
  • Wählen Sie den App Builder Typ Local
  • Klicken Sie auf Save

2. Erstellen einer Datenquelle mit dem lokalen App Builder Connector

  • Klicken Sie in der IDE auf Data Servers
  • Klicken Sie, um den Eintrag Local App Builder im Panel „Data Servers" auszuwählen
  • Klicken Sie im Panel „Data Sources" auf die Schaltfläche + Source
  • Klicken Sie auf + Create Database
  • Benennen Sie Ihre Datenquelle im Feld Database Name
    • Best Practice ist es, die Datenquelle wie folgt zu benennen: [Datenquelle, mit der Sie sich verbinden] ([Anwendung, die den Connector verwendet])
      • Beispiel: Falls Sie einen lokalen Connector für Northwinds erstellen und ihn mit einer Anwendung namens „My Application" verbinden, würde der Name lauten: Northwinds (My Application)

  • Wählen Sie die Datenquelle aus, mit der Sie eine Verbindung herstellen möchten, im Feld Database Name

    Hinweis

    Sie müssen eine relationale Datenbank auswählen. Eine öffentliche Tabelle/ein Datenobjekt ist in der Datenquelle erforderlich, damit diese als Datenbank ausgewählt werden kann.

  • Klicken Sie auf Next

  • Überprüfen Sie die vorgeschlagenen Aktualisierungen und klicken Sie auf Done

Hinweis

Wir empfehlen, jedes Mal eine andere Datenquelle zu erstellen, wenn Sie Ihre Anwendung mit einer anderen relationalen Datenbank verbinden möchten.

Beispiel: Falls Sie zwei Anwendungen haben und einen lokalen App Builder Connector verwenden möchten, um sich mit Northwinds zu verbinden, würden Sie zwei Datenquellen erstellen. Nach unserer Benennungskonvention würden diese lauten:

  • Northwinds (My Application 1)
  • Northwinds (My Application 2)

3. Öffentlichen Zugriff auf die Tabellen/Geschäftsobjekte aktivieren, die Sie in Ihrem Connector verwenden möchten

  • Navigieren Sie zur App Workbench für die App, die Sie verwenden möchten
  • Klicken Sie auf die Kachel Business Layer Rules
  • Wählen Sie die App Data Source aus, um die Datenquelle widerzuspiegeln, die Tabellen enthält, die Sie mit Public Access markieren möchten
  • Markieren Sie alle Tabellen oder Business Rules, die Sie in Ihrem Connector verwenden möchten, als Public
    • Um eine Tabelle als Public zu markieren, klicken Sie auf das Symbol Open Record > klicken Sie auf More > Edge Case > aktivieren Sie in der Gruppe Public Access die Optionen Allow Read und/oder Allow Write
    • Um eine Business Rule als Public zu markieren, doppelklicken Sie auf die Rule, um zur Seite Rule Definition zu navigieren > klicken Sie auf More > Edge Case > aktivieren Sie in der Feldgruppe Allow Public Access die Optionen Read und/oder Write
      • Read ermöglicht es Ihnen, die Daten in dieser Tabelle/diesem Objekt zu lesen
      • Write ermöglicht es Ihnen, die Daten in dieser Tabelle/diesem Objekt zu ändern

Hinweis

Wir empfehlen dringend, die öffentliche Tabelle/das Business Object nicht zu ändern, nachdem es öffentlich gemacht und in einem Connector verwendet wurde. Weitere Informationen finden Sie im Abschnitt Einschränkungen unten.

4. Tabellen/Business Objects in Ihren Connector importieren

  • Navigieren Sie zur IDE und klicken Sie auf Data Servers
  • Klicken Sie, um den Eintrag Local App Builder aus dem Bereich Data Servers auszuwählen
  • Klicken Sie auf die Schaltfläche Details im Bereich Data Sources
  • Klicken Sie auf die Schaltfläche Import und dann erneut auf Import unter Import Capabilities, um alle Tabellen zu importieren, die Sie als öffentlich markiert haben, ODER geben Sie den Tabellennamen/Business Object-Namen im Feld Import Pattern ein, um nur eine Teilmenge der öffentlichen Tabellen/Business Objects zu importieren
  • Klicken Sie auf Proceed und ein Hintergrund-Job wird ausgeführt, um die Aufgabe auszuführen

5. Fügen Sie Ihren lokalen App Builder Connector als Datenquelle zu Ihrer Anwendung hinzu

  • Navigieren Sie zur App Workbench für die App, die Sie ändern möchten
  • Klicken Sie auf die Kachel Data Sources
  • Klicken Sie auf + Source
  • Wählen Sie Link to existing source aus
  • Klicken Sie auf Next
  • Suchen Sie die in Schritt 2 erstellte benannte Datenquelle und klicken Sie auf Link Source
  • Überprüfen Sie das vorgeschlagene Update und klicken Sie auf Done
  • Navigieren Sie zur App Workbench für die App, die Sie ändern möchten
  • Klicken Sie auf die Schaltfläche Data Sources
  • Klicken Sie, um die relationale Datenbank auszuwählen, mit der Sie eine Verknüpfung erstellen möchten
  • Klicken Sie auf die Schaltfläche Link Sources für die ausgewählte Datenquelle
  • Klicken Sie auf Create und wählen Sie die Local App Builder Connector-Datenquelle aus, die Sie in Schritt 6 zu Ihrer Anwendung hinzugefügt haben
  • Klicken Sie auf das Häkchen, um den Datensatz zu speichern

Hinweis

Dies ermöglicht es Ihnen, Tabellen und Business Objects aus der lokalen App Builder-Datenquelle in Business Rules und XP CRUD Rules zu verwenden, die in der relationalen Datenbank erstellt werden.

Dies ermöglicht es Ihnen auch, XP CRUD Rules mit der Quelldatenquelle der relationalen Datenbank und der Zieldatenquelle Ihrer lokalen App Builder-Datenquelle zu erstellen. Diese XP CRUD Rules müssen in der relationalen Datenbank erstellt werden.

  • Navigieren Sie zur App Workbench für die App, die Sie ändern möchten
  • Klicken Sie auf die Schaltfläche Data Sources
  • Klicken Sie, um den Local App Builder Connector auszuwählen, mit dem Sie eine Verknüpfung erstellen möchten
  • Klicken Sie auf die Schaltfläche Link Sources für die ausgewählte Datenquelle
  • Klicken Sie auf Create und wählen Sie die relationale Datenquelle aus, mit der Sie eine Verbindung herstellen möchten
  • Klicken Sie auf das Häkchen, um den Datensatz zu speichern

Hinweis

Dies ermöglicht es Ihnen, Tabellen und Business Objects aus der relationalen Datenbank in Business Rules und XP CRUD Rules zu verwenden, die im lokalen App Builder Connector erstellt werden.

Dies ermöglicht es Ihnen auch, XP CRUD Rules mit der Quelldatenquelle der lokalen Vinyl-Datenquelle und der Zieldatenquelle Ihrer relationalen Datenquelle zu erstellen. Diese XP CRUD Rules müssen in der relationalen Datenbank erstellt werden.

Remote Connector

Der Remote App Builder Connector kann verwendet werden, um eine Verbindung von einer App Builder-Umgebung zu einer anderen über HTTP herzustellen.

1. Das freizugebende Objekt mit dem App Builder Connector erstellen

  • Navigieren Sie zur App Workbench aus der App, die Sie freigeben möchten
  • Klicken Sie auf + Rule
  • Weisen Sie einen Namen für die Regel zu. Beispiel: Customer (Remote)
  • Legen Sie den Purpose fest. Beispiel: Business Object
  • Bestätigen Sie das Target. Beispiel: Customer
  • Klicken Sie auf Create
  • Klicken Sie auf der Registerkarte Tables auf select, um die Spalten auszuwählen, die angezeigt werden sollen
  • Gehen Sie zu More > Edge Case
  • Aktivieren Sie unter Allow Public Access das Kontrollkästchen für Read und/oder Write nach Bedarf
  • Klicken Sie auf Proceed

2. Remote App Builder-Verbindungen aktivieren

  • Navigieren Sie zur IDE
  • Klicken Sie auf die Schaltfläche Additional Settings
  • Klicken Sie auf die Schaltfläche Remote App Builder Connections
  • Aktivieren Sie das Kontrollkästchen in der Spalte Allow für die Anwendung, für die Sie Remote App Builder Connections zulassen möchten
  • Klicken Sie auf Proceed

3. Bestätigen Sie, dass ein API-Schlüssel-Sicherheitsanbieter konfiguriert ist

  • Navigieren Sie zur IDE
  • Klicken Sie auf die Schaltfläche Security Providers
  • Bestätigen Sie, dass ein aktivierter API Key-Sicherheitsanbieter konfiguriert ist. Falls nicht, muss einer konfiguriert werden.
  • Weitere Informationen finden Sie unter Security provider - API key

4. Eine Rolle zum Freigeben des Objekts erstellen

  • Navigieren Sie zur App Workbench für die App
  • Klicken Sie auf die Kachel Roles
  • Klicken Sie auf + Role
  • Weisen Sie einen Namen zu. Beispiel: Remote Connector
  • Klicken Sie auf Save
  • Klicken Sie auf die Schaltfläche + Permission
  • Wählen Sie das in Schritt 1 erstellte Objekt aus
  • Klicken Sie auf das Häkchen, um zu speichern

Hinweis

Weitere Informationen zu Rollen finden Sie unter Privileges & permissions.

5. Eine Gruppe und einen Benutzer erstellen

  • Navigieren Sie zur IDE
  • Klicken Sie auf die Schaltfläche User Management
  • Wählen Sie die Navigationsregisterkarte Groups aus
  • Klicken Sie auf + Group
  • Weisen Sie einen Namen zu. Beispiel: Remote Connector
  • Klicken Sie auf Manage Priviledges > Create
  • Wählen Sie Application als Type aus
  • Wählen Sie die entsprechende Application aus dem Menü aus. Beispiel: Global Imports
  • Klicken Sie auf Save
  • Klicken Sie auf Create
  • Wählen Sie Application als Type aus
  • Wählen Sie die entsprechende Application aus dem Menü aus. Beispiel: App Builder
  • Klicken Sie auf die Schaltfläche Grant, die für die im vorherigen Schritt ausgewählte Anwendung angezeigt wird
  • Klicken Sie auf die Schaltfläche Grant für den App Builder Remote Connector
  • Klicken Sie auf die Navigationsregisterkarte Users und klicken Sie auf + User
  • Weisen Sie einen User Name zu. Beispiel: RemoteConnector
  • Klicken Sie auf Save
  • Klicken Sie auf die Schaltfläche More und wählen Sie Keys aus
  • Klicken Sie auf die Schaltfläche Create
  • Wählen Sie API Key als Provider aus und klicken Sie auf Save
  • Kopieren Sie den generierten Key-Wert in die Zwischenablage.
  • Klicken Sie auf + Membership
  • Wählen Sie die erstellte Group (Remote Connector) aus und klicken Sie auf das Häkchen, um zu speichern

Vorsicht

Der generierte Key-Wert kann nach dem Verlassen des Bildschirms Generate Key nicht mehr abgerufen werden. Falls der Wert verloren geht, müssen Sie einen neuen Key-Wert generieren.

6. Setup aus der Remote-Umgebung

  • Navigieren Sie zu der Remote-Umgebung, mit der Sie sich verbinden möchten
  • Gehen Sie zur App Workbench aus der App, mit der Sie sich verbinden möchten
  • Klicken Sie auf die Kachel Data Sources
  • Klicken Sie auf + Source
  • Wählen Sie New Connection aus und klicken Sie auf Next
  • Wählen Sie Other als Connection Category aus
  • Suchen Sie App Builder und wählen Sie es aus, klicken Sie auf Next
  • Weisen Sie einen Server Name zu. Beispiel: Remote
  • Bestätigen Sie, dass App Builder Type auf Remote eingestellt ist
  • Fügen Sie den in Schritt 5 kopierten Api Key-Wert ein
  • Geben Sie den Url-Wert für die andere Umgebung ein, mit der Sie sich verbinden. Beispiel: https://example.com
  • Klicken Sie auf Next, Next
  • Klicken Sie auf Import Schema für die Tabellen, Ansichten und gespeicherten Prozeduren, mit denen Sie sich verbinden möchten
  • Klicken Sie auf Next und überprüfen Sie die vorgeschlagenen Updates, klicken Sie dann auf Done
  • Wählen Sie Remote App Builder Connector Data Source aus, klicken Sie dann auf Logic
  • Klicken Sie auf das Symbol Results für einen Eintrag, um zu bestätigen, dass Daten angezeigt werden
  • Testen Sie die Bearbeitung eines Datensatzes, speichern Sie ihn, navigieren Sie zurück zur anderen Umgebung und bestätigen Sie, dass die Aktualisierung jetzt angezeigt wird

Einschränkungen und Hinweise

  • App Builder Connector unterstützt Reach nicht
  • App Builder Connector unterstützt Audit, aber Audit muss in der zugrunde liegenden Tabelle aktiviert sein, damit es funktioniert
  • Für Local App Builder Connector müssen beide Datenbanken relationale Datenbanken sein und in der gleichen Serverumgebung vorhanden sein.
  • Für Local App Builder Connector müssen Sie die Tabellen/Business Objects manuell synchron halten, wenn Sie Spalten zu öffentlichen Tabellen oder Business Objects hinzufügen/ändern.

Hinweis

Best Practice ist es, neue Business Objects zu erstellen, die nur für App Builder Connector verwendet werden. Nach dem Importieren des Objekts sollten Sie das öffentliche Objekt nur bei Bedarf ändern. Falls Sie es ändern, stellen Sie sicher, dass Sie die gleiche Änderung auch im Local App Builder Connector vornehmen.

Fehlerbehebung

403 Forbidden-Fehler

Wenn Sie eine 403 Forbidden-Fehlermeldung mit App Builder Connector erhalten, überprüfen Sie, ob Sie Ihrem Benutzer die Rolle "App Builder Remote Connector" zugewiesen haben. Informationen zur Konfiguration finden Sie im Abschnitt „Gruppe und Benutzer erstellen" dieses Artikels.

Vollständige Fehlerdetails:

Response status code does not indicate success
at void Vinyl.Business.Application.Events.RemoteEventRunner.AssertSuccessStatusCode(HttpResponseMessage response, string uri, EventTableRef eventTableRef)
at async Task<EventTableRef> Vinyl.Business.Application.Events.RemoteEventRunner.Invoke(EventTableRef eventTableRef, VinylConnectorEndpoint connectorEndpoint)
at async Task<EventTableRef> Vinyl.Business.Application.Events.RemoteEventRunner.InvokeCountAsync(EventTableRef eventTableRef)
at async Task<EventTableRef> Vinyl.DataSource.VinylConnector.VinylConnectorDataSourceServerHandler.CountPublicDataSourcesAsync(EventContext eventContext)
at async Task Vinyl.DataSource.VinylConnector.VinylConnectorDataSourceServerHandler.PingAsync(EventContext eventContext, CancellationToken cancellationToken)
at async Task Vinyl.DataSource.Plugins.DataSourceManagement.PingDataSourceServer.InvokeAsync(ValidationRule validationRule, EventInputRow input)

Reason
Forbidden
Status
403
Uri
https://{{App BuilderRootURI}}/connector/v1/count
Remote DataSourceId
19b4051a-b959-4b0c-9bd4-98b7cf2be132
Remote Table Name
DataSource_Public
Remote Event Name
null
Source
Vinyl.Business

Weitere Informationen zur Fehlerbehebung finden Sie in den folgenden Abschnitten im App Builder-Fehlerbehebungsleitfaden: