Zum Inhalt springen

App Builder Connector im Jitterbit App Builder

Übersicht

App Builder Connector ist eine Funktion, die entwickelt wurde, um zwei verschiedene App Builder-Instanzen miteinander zu verbinden und sie wie eine Regel zu behandeln, die Tabelle zu importieren und sie zu verwenden.

Als Entwickler können Sie den App Builder Connector verwenden, um zwei verschiedene Instanzen zu verbinden, die in derselben Umgebung (Local) oder über zwei verschiedene Umgebungen über HTTP (Remote) ausgeführt werden. Schritte zur Konfiguration von lokalen und Remote-App Builder-Connectors werden in diesem Artikel bereitgestellt.

Wenn Sie versuchen, ein Szenario mit einer App Builder LP-Abhängigkeit zu lösen, empfehlen wir, die Funktion Tabellenvererbung oder Tabelle erweitern zu verwenden und nicht den App Builder Connector dafür zu nutzen. Die Funktion Tabelle erweitern ermöglicht es Ihnen, Tabellen, die Sie aus anderen Datenquellen auf derselben Instanz oder Umgebung verwenden möchten, einfach auszuwählen, und schafft keine Abhängigkeit von anderen Apps, wenn Sie bereit sind, Ihre App LP zu bündeln und zu versenden.

Ein Beispiel für das Szenario mit einer App Builder LP-Abhängigkeit:
Sie haben zwei App Builder-Datenquellen, die sich auf derselben Instanz oder Umgebung befinden, und Sie möchten eine Verbindung zwischen Datenquelle A und Datenquelle B herstellen. Wenn Ihre App Datenquelle A verwendet und Sie eine Tabelle aus Datenquelle B verwenden möchten, und Sie dann eine Version von App A versenden müssen, die nur 1 Tabelle aus App B verwendet, müssen Sie sowohl App A als auch B bündeln und versenden. Auch hier ist der empfohlene Weg, um dieses Szenario zu lösen, die Verwendung von Erweiterten Tabellen. Dies ist eine viel einfachere und bessere Lösung.

Warnung

Es wird allgemein nicht empfohlen, dass Kunden eigenständig mit App Builder Connectors arbeiten, ohne zuvor 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 im IDE auf Datenserver
  • Klicken Sie im Datenserver-Bereich auf + Server
  • Benennen Sie Ihre Serververbindung
    • Die beste Praxis für die Benennung ist, den Server 'Local App Builder' zu nennen
  • Wählen Sie den Typ App Builder im Abschnitt Servereinstellungen aus
  • Wählen Sie den App Builder-Typ Local
  • Klicken Sie auf Speichern

2. Erstellen einer Datenquelle mit dem lokalen App Builder-Connector

  • Klicken Sie im IDE auf Datenserver
  • Klicken Sie auf den Eintrag Local App Builder im Datenserver-Bereich
  • Klicken Sie auf die Schaltfläche + Quelle im Bereich Datenquellen
  • Klicken Sie auf + Datenbank erstellen
  • Benennen Sie Ihre Datenquelle im Feld Datenbankname
    • Die beste Praxis für die Benennung ist, die Datenquelle wie folgt zu benennen: [Datenquelle, zu der Sie eine Verbindung herstellen] ([Anwendung, die den Connector verwendet])
      • Zum Beispiel: Wenn Sie einen lokalen Connector für Northwinds erstellen und ihn mit einer Anwendung namens My Application verbinden, wäre der Name: Northwinds (My Application)

  • Wählen Sie die Datenquelle aus, zu der Sie eine Verbindung im Feld Datenbankname herstellen möchten

    Hinweis

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

  • Klicken Sie auf Weiter

  • Überprüfen Sie die vorgeschlagenen Updates und klicken Sie auf Fertig

Hinweis

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

Zum Beispiel: Wenn Sie zwei Anwendungen haben und eine lokale App Builder-Verbindung verwenden möchten, um sich mit Northwinds zu verbinden, würden Sie zwei Datenquellen erstellen. Nach unserer Benennungskonvention wären sie:

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

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

  • Navigieren Sie zum 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, die die Datenquelle enthält, in der Sie Tabellen mit öffentlichem Zugriff markieren möchten
  • Markieren Sie alle Tabellen oder Geschäftsregeln, die Sie in Ihrem Connector verwenden möchten, als Öffentlich
    • Um eine Tabelle als Öffentlich zu markieren, klicken Sie auf das Symbol Open Record > klicken Sie auf More > Edge Case > aktivieren Sie in der Gruppe Öffentlicher Zugriff Allow Read und/oder Allow Write
    • Um eine Geschäftsregel als Öffentlich zu markieren, doppelklicken Sie auf die Regel, um zur Regeldefinitionsseite zu navigieren > klicken Sie auf More > Edge Case > aktivieren Sie im Kontrollfeld für den öffentlichen Zugriff Read und/oder Write
      • Read ermöglicht es Ihnen, die Daten in dieser Tabelle/diesem Objekt zu lesen
      • Write ermöglicht es Ihnen, das Datum in dieser Tabelle/diesem Objekt zu ändern

Hinweis

Wir empfehlen dringend, dass Sie die öffentliche Tabelle/das öffentliche Geschäftsobjekt nicht ändern, nachdem es öffentlich gemacht und in einem Connector verwendet wurde. Bitte beachten Sie den Abschnitt zu den Einschränkungen unten für weitere Informationen.

4. Importieren Sie Tabellen/Geschäftsobjekte in Ihren Connector

  • Navigieren Sie zu IDE, klicken Sie auf Data Servers
  • Klicken Sie, um den Eintrag Local App Builder im Data Servers-Bereich auszuwählen
  • Klicken Sie auf die Schaltfläche Details im Bereich Data Sources
  • Klicken Sie auf die Schaltfläche Import, und klicken Sie erneut auf Import aus den Importfähigkeiten, um alle Tabellen zu importieren, die Sie als öffentlich markiert haben ODER geben Sie den Tabellennamen/Geschäftsobjektnamen im Import Pattern ein, um nur eine Teilmenge der öffentlichen Tabellen/Geschäftsobjekte zu importieren
  • Klicken Sie auf Proceed, und ein Hintergrundjob 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 zum 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
  • Klicken Sie auf Next
  • Suchen Sie die benannte Datenquelle, die in Schritt 2 erstellt wurde, und klicken Sie auf Link Source
  • Überprüfen Sie das vorgeschlagene Update und klicken Sie auf Done
  • Navigieren Sie zum App Workbench für die App, die Sie ändern möchten
  • Klicken Sie auf die Schaltfläche Datenquellen
  • Klicken Sie, um die relationale Datenbank auszuwählen, mit der Sie verknüpfen möchten
  • Klicken Sie auf die Schaltfläche Quellen verknüpfen für die ausgewählte Datenquelle
  • Klicken Sie auf Erstellen und wählen Sie die lokale 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 Ihnen die Verwendung von Tabellen und Geschäftsobjekten aus der lokalen App Builder-Datenquelle in Geschäftsregeln und XP CRUD-Regeln, die in der relationalen Datenbank erstellt wurden.

Dies ermöglicht Ihnen auch die Erstellung von XP CRUD-Regeln mit der Quell-Datenquelle der relationalen Datenbank und der Ziel-Datenquelle Ihrer lokalen App Builder-Datenquelle. Diese XP CRUD-Regeln müssen in der relationalen Datenbank erstellt werden.

  • Navigieren Sie zum App Workbench für die App, die Sie ändern möchten
  • Klicken Sie auf die Schaltfläche Datenquellen
  • Klicken Sie, um den lokalen App Builder-Connector auszuwählen, mit dem Sie verknüpfen möchten
  • Klicken Sie auf die Schaltfläche Quellen verknüpfen für die ausgewählte Datenquelle
  • Klicken Sie auf Erstellen und wählen Sie die relationale Datenquelle aus, mit der Sie sich verbinden möchten
  • Klicken Sie auf das Häkchen, um den Datensatz zu speichern

Hinweis

Dies ermöglicht Ihnen die Verwendung von Tabellen und Geschäftsobjekten aus der relationalen Datenbank in Geschäftsregeln und XP CRUD-Regeln, die im lokalen App Builder-Connector erstellt wurden.

Dies ermöglicht Ihnen auch die Erstellung von XP CRUD-Regeln mit der Quell-Datenquelle der lokalen Vinyl-Datenquelle und der Ziel-Datenquelle Ihrer relationalen Datenquelle. Diese XP CRUD-Regeln 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. Erstellen Sie das zu teilende Objekt mit dem App Builder Connector

  • Navigieren Sie zum App Workbench der App, von der Sie teilen möchten
  • Klicken Sie auf + Regel
  • Weisen Sie der Regel einen Namen zu. Zum Beispiel: Kunde (Remote)
  • Legen Sie den Zweck fest. Zum Beispiel: Geschäftliches Objekt
  • Bestätigen Sie das Ziel. Zum Beispiel: Kunde
  • Klicken Sie auf Erstellen
  • Klicken Sie im Tab Tabellen auf auswählen, um die Spalten anzuzeigen, die Sie darstellen möchten
  • Gehen Sie zu Mehr > Randfall
  • Aktivieren Sie unter Öffentlichen Zugriff erlauben die Optionen Lesen und/oder Schreiben nach Bedarf
  • Klicken Sie auf Fortfahren

2. Aktivieren Sie Remote-App-Builder-Verbindungen

  • Navigieren Sie zur IDE
  • Klicken Sie auf die Schaltfläche Zusätzliche Einstellungen
  • Klicken Sie auf die Schaltfläche Remote-App-Builder-Verbindungen
  • Setzen Sie ein Häkchen in der Spalte Erlauben für die Anwendung, für die Sie Remote-App-Builder-Verbindungen zulassen möchten
  • Klicken Sie auf Fortfahren

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

  • Navigieren Sie zur IDE
  • Klicken Sie auf die Schaltfläche Sicherheitsanbieter
  • Bestätigen Sie, dass ein aktivierter API-Schlüssel-Sicherheitsanbieter konfiguriert ist. Andernfalls muss einer konfiguriert werden.
  • Siehe Sicherheitsanbieter - API-Schlüssel für weitere Informationen

4. Erstellen Sie eine Rolle, um das Objekt zu teilen

  • Navigieren Sie zum App Workbench für die App
  • Klicken Sie auf die Kachel Rollen
  • Klicken Sie auf + Rolle
  • Weisen Sie einen Namen zu. Zum Beispiel: Remote Connector
  • Klicken Sie auf Speichern
  • Klicken Sie auf die Schaltfläche + Berechtigung
  • Wählen Sie das in Schritt 1 erstellte Objekt aus
  • Klicken Sie auf das Häkchen, um zu speichern

Hinweis

Für weitere Informationen zu Rollen siehe Berechtigungen & Privilegien.

5. Erstellen Sie eine Gruppe und einen Benutzer

  • Navigieren Sie zur IDE
  • Klicken Sie auf die Schaltfläche Benutzermanagement
  • Wählen Sie den Navigations-Tab Gruppen
  • Klicken Sie auf + Gruppe
  • Weisen Sie einen Namen zu. Zum Beispiel: Remote Connector
  • Klicken Sie auf Berechtigungen verwalten > Erstellen
  • Wählen Sie Anwendung als Typ
  • Wählen Sie die entsprechende Anwendung aus dem Menü. Zum Beispiel: Globale Importe
  • Klicken Sie auf Speichern
  • Klicken Sie auf Erstellen
  • Wählen Sie Anwendung als Typ
  • Wählen Sie die entsprechende Anwendung aus dem Menü. Zum Beispiel: App Builder
  • Klicken Sie auf die Schaltfläche Gewähren, die für die in Schritt 1 ausgewählte Anwendung erscheint
  • Klicken Sie auf die Schaltfläche Gewähren für den App Builder Remote Connector
  • Klicken Sie auf den Navigations-Tab Benutzer und dann auf + Benutzer
  • Weisen Sie einen Benutzernamen zu. Zum Beispiel: RemoteConnector
  • Klicken Sie auf Speichern
  • Klicken Sie auf die Schaltfläche Mehr und wählen Sie Schlüssel
  • Klicken Sie auf die Schaltfläche Erstellen
  • Wählen Sie den API-Schlüssel als Anbieter und klicken Sie auf Speichern
  • Kopieren Sie den generierten Schlüssel-Wert in die Zwischenablage.
  • Klicken Sie auf + Mitgliedschaft
  • Wählen Sie die erstellte Gruppe (Remote Connector) aus und klicken Sie auf das Häkchen, um zu speichern

Vorsicht

Der generierte Schlüsselwert kann nach Verlassen des Bildschirms Schlüssel generieren nicht mehr abgerufen werden. Wenn der Wert verloren geht, müssen Sie einen neuen Schlüsselwert generieren.

6. Einrichtung aus der Remote-Umgebung

  • Navigieren Sie zu der Remote-Umgebung, mit der Sie sich verbinden möchten
  • Gehen Sie zum App Workbench der App, mit der Sie sich verbinden möchten
  • Klicken Sie auf die Kachel Datenquellen
  • Klicken Sie auf + Quelle
  • Wählen Sie Neue Verbindung und klicken Sie auf Weiter
  • Wählen Sie Andere als Verbindungskategorie
  • Suchen und wählen Sie App Builder und klicken Sie auf Weiter
  • Weisen Sie einen Servernamen zu. Zum Beispiel: Remote
  • Bestätigen Sie, dass der App Builder-Typ auf Remote eingestellt ist
  • Fügen Sie den Api-Schlüssel-Wert ein, der in Schritt 5 kopiert wurde
  • Geben Sie den Url-Wert für die andere Umgebung ein, mit der Sie sich verbinden. Zum Beispiel: https://example.com
  • Klicken Sie auf Weiter, Weiter
  • Klicken Sie auf Schema importieren für die Tabellen, Ansichten und gespeicherten Prozeduren, mit denen Sie sich verbinden möchten
  • Klicken Sie auf Weiter und überprüfen Sie die vorgeschlagenen Updates, klicken Sie dann auf Fertig
  • Wählen Sie Remote App Builder Connector Datenquelle aus und klicken Sie auf Logik
  • Klicken Sie auf das Ergebnisse-Symbol für einen Eintrag, um zu bestätigen, dass Sie Daten sehen
  • Testen Sie, ob Sie einen Datensatz bearbeiten, speichern und zur anderen Umgebung zurück navigieren können, um zu bestätigen, dass Sie nun das Update sehen

Einschränkungen und Hinweise

  • Der App Builder Connector unterstützt kein Reach
  • Der App Builder Connector unterstützt Audit, aber Audit muss auf der zugrunde liegenden Tabelle aktiviert sein, damit es funktioniert
  • Für den lokalen App Builder Connector müssen beide Datenbanken relationale Datenbanken sein und sich in der gleichen Serverumgebung befinden.
  • Für den lokalen App Builder Connector müssen Sie, wenn Sie Spalten in öffentlichen Tabellen oder Geschäftsobjekten hinzufügen/ändern, die Tabellen/Geschäftsobjekte manuell synchron halten.

Hinweis

Beste Praxis ist es, neue Geschäftsobjekte zu erstellen, die nur für den App Builder Connector verwendet werden. Sobald Sie das Objekt importiert haben, sollten Sie das öffentliche Objekt nur ändern, wenn es notwendig ist. Wenn Sie es ändern, stellen Sie sicher, dass Sie die gleiche Änderung im lokalen App Builder Connector vornehmen.

Fehlerbehebung

403 Verboten Fehler

Wenn Sie eine 403 Verboten Fehlermeldung mit dem App Builder Connector erhalten, überprüfen Sie, ob Sie Ihrem Benutzer die Rolle "App Builder Remote Connector" zugewiesen haben. Siehe den Abschnitt "Eine Gruppe und einen Benutzer erstellen" in diesem Artikel für Informationen zur Konfiguration.

Vollständige Fehlermeldung:

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