App Builder Connector im Jitterbit App Builder

Übersicht

App Builder Connector ist eine Funktion zum Verbinden von zwei verschiedenen App Builder Instanzen zusammen und behandeln Sie sie wie eine Regel, importieren Sie die Tabelle und beginnen Sie, sie zu verwenden.

Als Entwickler können Sie verwenden App Builder Connector zum Verbinden zweier verschiedener Instanzen, die in derselben Umfeld (Lokal) oder über zwei verschiedene Umgebungen hinweg über HTTP (Remote) ausgeführt werden. Schritte zum Konfigurieren von Lokal und Remote App Builder In diesem Artikel werden Konnektoren bereitgestellt.

Wenn Sie versuchen, Folgendes zu lösen: an App Builder LP-Abhängigkeitsszenario empfehlen wir die Verwendung der Tabellenvererbung oder Tabellenerweiterung Funktion und nicht verwenden die App Builder Connector, um dieses Problem zu lösen. Mit der Funktion Tabelle erweitern können Sie ganz einfach Tabellen auswählen, die Sie aus anderen Datenquellen verwenden möchten, die sich auf derselben Instanz oder Umfeld befinden, und es entsteht keine Abhängigkeit von anderen Apps, wenn Sie bereit sind, Ihre App LP zu bündeln und auszuliefern.

Ein Beispiel für die App Builder LP-Abhängigkeitsszenario:
Sie haben zwei App Builder Datenquellen befinden sich auf derselben Instanz oder Umfeld 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 dann eine Version von App A ausliefern müssen, die nur 1 Tabelle aus App B verwendet, müssen Sie App A und App B bündeln und ausliefern. Auch hier ist die empfohlene Lösung für dieses Szenario die Verwendung von Erweiterten Tabellen. Dies ist eine viel einfachere und bessere Lösung.

Lokal App Builder Anschluss

Das Lokale App Builder Mithilfe eines Connectors kann innerhalb derselben Umfeld eine Verbindung von einer relationalen Datenquelle zu einer anderen hergestellt werden.

1. Erstellen eines lokalen App Builder Anschluss

• Klicken Sie in der IDE auf Datenserver
• Klicken Sie im Bereich Datenserver auf + Server
• Benennen Sie Ihre Serververbindung
  • Die bewährte Benennungskonvention besteht darin, den Server „Lokal“ zu nennen App Builder'
• Wählen Sie den Typ App Builder im Abschnitt „Servereinstellungen“
• Wählen Sie die App Builder Geben Sie Lokal ein
• Klicken Sie auf Speichern

2. Erstellen einer Datenquelle mit dem lokalen App Builder Anschluss

• Klicken Sie in der IDE auf Datenserver
• Klicken Sie, um Lokale App Builder Eintrag aus dem Bereich „Datenserver“
• Klicken Sie im Bereich „Datenquellen“ auf die Schaltfläche + Quelle
• Klicken Sie auf + Datenbank erstellen
• Benennen Sie Ihre Datenquelle im Feld Datenbankname
  • Die bewährte Benennungskonvention besteht darin, die Datenquelle wie folgt zu benennen: [Data Source You're Connecting to] ([Application using the connector])
    • Beispiel: Wenn Sie einen lokalen Connector für Northwinds erstellen und ihn mit einer Anwendung namens „Meine Anwendung“ verbinden, lautet der Name: Northwinds (Meine Anwendung)

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

  Hinweis

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

• Klicken Sie auf Weiter

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

3. Erlauben Sie den öffentlichen Zugriff auf die Tabellen/Geschäftsobjekte, 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 Fliese Business Layer Rules
• Wählen Sie die App-Datenquelle aus, um die Datenquelle mit den Tabellen anzuzeigen, die Sie mit „Öffentlicher 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 Datensatz öffnen > klicken Sie auf Mehr > Sonderfall > aktivieren Sie in der Gruppe Öffentlicher Zugriff die Optionen Lesen zulassen und/oder Schreiben zulassen.
  • Um eine Geschäftsregel als öffentlich zu markieren, doppelklicken Sie auf die Regel, um zur Seite „Regeldefinition“ zu navigieren > klicken Sie auf Mehr > Sonderfall > aktivieren Sie im Steuerelementsatz „Öffentlichen Zugriff zulassen“ die Option Lesen und/oder Schreiben
    • Lesen ermöglicht Ihnen, die Daten in dieser Tabelle/diesem Objekt zu lesen
    • Mit Schreiben können Sie das Datum in dieser Tabelle/diesem Objekt ändern.

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

• Navigieren Sie zur IDE und klicken Sie auf Datenserver
• Klicken Sie, um Lokale App Builder Eintrag aus dem Bereich „Datenserver“
• Klicken Sie im Bereich „Datenquellen“ auf die Schaltfläche „Details“
• Klicken Sie auf die Schaltfläche „Importieren“ und dann erneut auf „Importieren“ unter „Importfunktionen“, um alle Tabellen zu importieren, die Sie als öffentlich markiert haben, ODER geben Sie den Tabellennamen/Geschäftsobjektnamen in das „Importmuster“ ein, um nur eine Teilmenge der öffentlichen Tabellen/Geschäftsobjekte zu importieren
• Klicken Sie auf „Fortfahren“ und ein Hintergrundjob wird ausgeführt, um die Aufgabe auszuführen

5. Fügen Sie Ihren lokalen App Builder Connector als Datenquelle für Ihre Anwendung

• Navigieren Sie zur App Workbench für die App, die Sie ändern möchten
• Klicken Sie auf die Fliese Datenquellen
• Klicken Sie auf + Quelle
• Wählen Sie Link zu vorhandener Quelle
• Klicken Sie auf Weiter
• Suchen Sie die benannte Datenquelle, die Sie in Schritt 2 erstellt haben, und klicken Sie auf Quelle verknüpfen
• Überprüfen Sie das vorgeschlagene Update und klicken Sie auf Fertig

6. Verlinken Sie Ihre lokale App Builder Konnektor-Datenquelle zu einer relationalen Datenbank

• Navigieren Sie zur 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 eine Verknüpfung herstellen 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, die Sie in Schritt 6 zu Ihrer Anwendung hinzugefügt haben
• Klicken Sie auf das Häkchen, um den Datensatz zu speichern

7. Verknüpfen Sie Ihre relationale Datenbank mit Ihrem lokalen App Builder Anschluss

• Navigieren Sie zur App Workbench für die App, die Sie ändern möchten
• Klicken Sie auf die Schaltfläche Datenquellen
• Klicken Sie, um die lokale App Builder Connector, mit dem Sie eine Verbindung herstellen möchten
• Klicken Sie für die ausgewählte Datenquelle auf die Schaltfläche Quellen verknüpfen
• Klicken Sie auf Erstellen 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

Remote-Anschluss

Die Fernbedienung App Builder Mit dem Connector kann eine Verbindung von einem App Builder Umfeld zu einer anderen über HTTP.

1. Erstellen Sie das zu teilende Objekt mit App Builder Anschluss

• Navigieren Sie von der App, die Sie freigeben möchten, zur App Workbench
• Klicken Sie auf + Regel
• Vergeben Sie einen Namen für die Regel. Beispiel: Kunde (Remote)
• Legen Sie den Zweck fest. Beispiel: Geschäftsobjekt
• Bestätigen Sie das Ziel. Beispiel: Kunde
• Klicken Sie auf Erstellen
• Klicken Sie auf der Tab Tabellen, um die Spalten auszuwählen, die Sie anzeigen möchten.
• Gehen Sie zu Mehr > Randfall
• Aktivieren Sie unter Öffentlichen Zugriff zulassen die Option Lesen und/oder Schreiben, je nachdem, was zutrifft.
• Klicken Sie auf Weiter

2. Aktivieren Sie die Fernbedienung App Builder Anschlüsse

• Navigieren Sie zur IDE
• Klicken Sie auf die Schaltfläche Weitere Einstellungen
• Klicken Sie auf die Remote App Builder Schaltfläche „Verbindungen“
• Setzen Sie ein Häkchen in der Spalte „Zulassen**“ für die Anwendung, deren Remotezugriff Sie zulassen möchten. App Builder Verbindungen
• Klicken Sie auf Weiter

3. Bestätigen Sie, dass ein API Schlüsselsicherheitsanbieter 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. Wenn nicht, muss einer konfiguriert werden.
• Siehe Sicherheitsanbieter - API Schlüssel für weitere Informationen

4. Erstellen Sie eine Rolle zum Teilen des Objekts

• Navigieren Sie zur App Workbench für die App
• Klicken Sie auf die Fliese Rollen
• Klicken Sie auf + Rolle
• Weisen Sie einen Namen zu. 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 zum Speichern auf das Häkchen

5. Erstellen Sie eine Gruppe und einen Benutzer

• Navigieren Sie zur IDE
• Klicken Sie auf die Schaltfläche Benutzerverwaltung
• Wählen Sie die Tab Gruppen
• Klicken Sie auf + Gruppe
• Weisen Sie einen Namen zu. Beispiel: Remote Connector
• Klicken Sie auf Berechtigungen verwalten > Erstellen
• Wählen Sie Anwendung als Typ
• Wählen Sie die entsprechende Anwendung aus dem Menü. Beispiel: Global Imports
• Klicken Sie auf Speichern
• Klicken Sie auf Erstellen
• Wählen Sie Anwendung als Typ
• Wählen Sie die entsprechende Anwendung aus dem Menü. Beispiel: App Builder
• Klicken Sie auf die Schaltfläche Gewähren, die für die im vorherigen Schritt ausgewählte Anwendung angezeigt wird.
• Klicken Sie auf die Schaltfläche Gewähren für die App Builder Remote-Anschluss
• Klicken Sie auf die 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 zum Speichern auf das Häkchen

6. Einrichtung aus der Remote Umfeld

• Navigieren Sie zu der Remote-Umfeld, mit der Sie eine Verbindung herstellen möchten
• Gehen Sie von der App, die Sie verbinden möchten, zur App Workbench
• Klicken Sie auf die Fliese Datenquellen
• Klicken Sie auf + Quelle
• Wählen Sie Neue Verbindung und klicken Sie auf Weiter
• Wählen Sie Sonstiges als Verbindungskategorie
• Suchen und wählen Sie App Builder und klicken Sie auf Weiter
• Weisen Sie einen Servernamen zu. Beispiel: Remote
• Bestätigen Sie App Builder Typ ist auf Remote eingestellt
• Fügen Sie den API-Schlüssel-Wert ein, den Sie in Schritt 5 kopiert haben
• Geben Sie den URL-Wert für die andere Umfeld ein, mit der Sie eine Verbindung herstellen. Beispiel: https://example.com
• Klicken Sie auf Weiter, Weiter
• Klicken Sie auf Schema importieren für die Tabellen, Ansichten und gespeicherten Prozeduren, die Sie verbinden möchten
• Klicken Sie auf Weiter und überprüfen Sie die vorgeschlagenen Aktualisierungen, dann klicken Sie auf Fertig
• Wählen Sie Remote App Builder Connector-Datenquelle, dann klicken Sie auf Logik
• Klicken Sie auf das Symbol Ergebnisse für einen Eintrag, der angezeigt wird, um zu bestätigen, dass Sie Daten sehen
• Testen Sie die Bearbeitung eines Datensatzes, speichern Sie, navigieren Sie zurück zur anderen Umfeld und bestätigen Sie, dass Sie jetzt das Update sehen

Einschränkungen und Hinweise

• App Builder Connector unterstützt Reach nicht
• App Builder Connector unterstützt Audit, aber Audit muss für die zugrunde liegende Tabelle aktiviert sein, damit es funktioniert
• Für Lokal App Builder Connector, beide Datenbanken müssen relationale Datenbanken sein und in der gleichen Umfeld vorhanden sein.
• Für lokale App Builder Connector: Wenn Sie Spalten zu öffentlichen Tabellen oder Geschäftsobjekten hinzufügen/ändern, müssen Sie die Tabellen/Geschäftsobjekte manuell synchron halten.

Fehlerbehebung

403 verbotener Fehler

Wenn Sie eine 403 Forbidden-Fehlermeldung mit dem App Builder Connector, überprüfen Sie, ob Sie Ihrem Benutzer die Berechtigung "App Builder Rolle„Remote Connector“. 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 {{nm.ab_path}}.Business.Application.Events.RemoteEventRunner.AssertSuccessStatusCode(HttpResponseMessage response, string uri, EventTableRef eventTableRef)
at async Task<EventTableRef> {{nm.ab_path}}.Business.Application.Events.RemoteEventRunner.Invoke(EventTableRef eventTableRef, {{nm.ab_path}} ConnectorEndpoint connectorEndpoint)
at async Task<EventTableRef> {{nm.ab_path}}.Business.Application.Events.RemoteEventRunner.InvokeCountAsync(EventTableRef eventTableRef)
at async Task<EventTableRef> {{nm.ab_path}}.DataSource {{nm.ab_path}} Connector {{nm.ab_path}} ConnectorDataSourceServerHandler.CountPublicDataSourcesAsync(EventContext eventContext)
at async Task {{nm.ab_path}}.DataSource {{nm.ab_path}} Connector {{nm.ab_path}} ConnectorDataSourceServerHandler.PingAsync(EventContext eventContext, CancellationToken cancellationToken)
at async Task {{nm.ab_path}}.DataSource.Plugins.DataSourceManagement.PingDataSourceServer.InvokeAsync(ValidationRule validationRule, EventInputRow input)

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