Zum Inhalt springen

App Builder-Connector in Jitterbit App Builder

Übersicht

Der App Builder-Connector ist eine Funktion, mit der eine Anwendung Tabellen und Geschäftsobjekte aus einer anderen App Builder-Anwendung oder aus einer völlig separaten App Builder-Umgebung nutzen kann, als wären sie Teil ihrer eigenen Datenquelle, ohne die zugrunde liegenden Daten zu duplizieren.

Welche Variante verwendet wird, hängt davon ab, wo sich die andere Anwendung befindet:

  • Ein lokaler Connector verbindet zwei Datenquellen auf demselben App Builder-Server. Wenn der Server beispielsweise sowohl eine Northwinds-Datenquelle als auch eine separate My Application hostet und My Application Daten aus Northwinds lesen (und optional schreiben) muss, bietet ein lokaler Connector My Application direkten Zugriff auf die Tabellen von Northwinds, ohne diese Daten in die eigene Datenbank von My Application zu kopieren. Da beide Anwendungen auf demselben Server ausgeführt werden, verwaltet App Builder die Verbindung intern: Es sind kein Netzwerkaufruf und kein separater Authentifizierungsschritt erforderlich.

  • Ein Remote-Connector verbindet zwei völlig separate App Builder-Umgebungen, jede mit ihrer eigenen URL, über HTTP. Beispielsweise die Verbindung des App Builder-Servers einer Organisation mit einer anderen App Builder-Installation, ob es sich um eine separate Umgebung, die Installation eines anderen Kunden oder eine andere unabhängig gehostete Instanz handelt. Da die Verbindung über das Netzwerk zu einer separaten, gesicherten App Builder-Instanz führt, erfolgt die Authentifizierung mit einem API-Schlüssel, genauso wie bei jedem anderen externen REST-Client.

Diese Seite behandelt:

Darüber hinaus enthält diese Seite auch einen Abschnitt Einschränkungen mit bekannten Beschränkungen, die vor der Nutzung des App Builder-Connectors zu beachten sind, und einen Abschnitt Fehlerbehebung mit häufigen Fehlern und deren Lösungen.

Warnung

Wir empfehlen, sich vor der eigenständigen Konfiguration eines App Builder-Connectors mit einem dedizierten Jitterbit-Berater zu beraten.

Lokaler App Builder-Connector

Ein lokaler App Builder-Connector ermöglicht es einer Anwendung auf dem App Builder-Server, Tabellen und Geschäftsobjekte, die sich in der Datenquelle einer anderen Anwendung auf demselben Server befinden, direkt zu nutzen, ohne die Daten zu kopieren oder eine Netzwerkauthentifizierung einzurichten. Wenn beispielsweise My Application Daten lesen muss, die sich in der Northwinds-Datenquelle befinden, beide auf demselben Server gehostet, bietet ein lokaler Connector My Application direkten Zugriff auf die öffentlichen Tabellen von Northwinds.

Dieser Abschnitt behandelt:

Erwägen Sie stattdessen Extend Table

Wenn nur eine Tabelle aus einer anderen Datenquelle auf demselben Server abgerufen werden muss, ist Extend Table normalerweise die bessere Wahl: Im Gegensatz zu einem lokalen Connector ist es nicht erforderlich, beide Apps zusammen zu bündeln und zu versenden, wenn eine Veröffentlichung erfolgt.

Schritt 1: Erstellen eines lokalen App Builder-Connectors

Richten Sie den App Builder-Connector-Server ein, damit App Builder Anfragen für diese Verbindung lokal statt über HTTP leitet:

  1. Wählen Sie IDE > Data Servers.
  2. Klicken Sie auf + Server im Panel Data Servers. Das Dialogfeld Server wird geöffnet. Geben Sie die folgenden Werte ein:

    Server dialog

    • Name: Geben Sie Ihrer Serververbindung einen Namen. Jitterbit empfiehlt Local App Builder.
    • Type: Wählen Sie App Builder Connector.
    • App Builder Type: Wählen Sie Local.
  3. Klicken Sie auf Save und schließen Sie das Dialogfeld.

Step 2: Öffentlichen Zugriff auf die Tabellen und Business Objects aktivieren, die Sie in Ihrem Connector verwenden möchten

Eine Tabelle oder Regel muss als Public gekennzeichnet sein, bevor ein Connector sie verwenden kann:

  1. Navigieren Sie zur App Workbench für die App, die Sie verwenden möchten.
  2. Kennzeichnen Sie die Tabellen oder Regeln, die Sie in Ihrem Connector verwenden möchten, als Public:

    • So kennzeichnen Sie eine Tabelle als öffentlich:

      1. Gehen Sie zur Registerkarte Tables.
      2. Suchen Sie die gewünschte Tabelle im Panel Tables und klicken Sie auf das Symbol zum Bearbeiten oder doppelklicken Sie auf die Zeile. Die Seite Table Definition für diese Tabelle wird geöffnet.
      3. Klicken Sie im Panel Table auf More > Edge Case. Das Dialogfeld Edge Case Settings wird geöffnet:

        Edge Case Settings dialog

      4. Aktivieren Sie in der Feldgruppe Public Access je nach Bedarf Allow Read und/oder Allow Write.

    • So kennzeichnen Sie eine Regel als öffentlich:

      1. Gehen Sie zur Registerkarte Rules.
      2. Suchen Sie die gewünschte Regel im Panel Rules und klicken Sie auf das Symbol zum Bearbeiten oder doppelklicken Sie auf die Zeile. Der Rule Builder für diese Regel wird geöffnet.
      3. Klicken Sie im Panel Rule auf More > Edge Case. Das Dialogfeld Edge Case Settings wird geöffnet:

        Edge Case Settings dialog 2

      4. Aktivieren Sie in der Feldgruppe Allow Public Access die Option Read, um das Lesen der Daten der Regel zu ermöglichen, und/oder Write, um Änderungen zu ermöglichen.

Hinweis

Es wird dringend empfohlen, eine öffentliche Tabelle oder ein Business Object nicht zu ändern, nachdem es öffentlich gemacht und in einem Connector verwendet wurde. Weitere Informationen finden Sie unter Limitations.

Step 3: Erstellen Sie eine Datenquelle mit dem lokalen App Builder Connector

Nachdem der Connector-Server eingerichtet und Ihre Objekte als öffentlich gekennzeichnet sind, erstellen Sie eine Datenquelle, die auf die spezifische Anwendung verweist, deren Daten Sie verwenden möchten:

  1. Gehen Sie zu IDE > Data Servers.
  2. Wählen Sie im Panel Data Servers die Option Local App Builder.
  3. Klicken Sie auf + Source. Ein Assistent wird angezeigt, der Sie durch den Prozess führt:

    Choose Database wizard

  4. Wählen Sie eine Datenbank aus, auf der eine Datenquelle erstellt werden soll. Die Datenquelle wird mit dem gleichen Namen wie die Datenbank erstellt. Klicken Sie auf Next.

    Hinweis

    Die relationale Datenbank, die Sie suchen, muss mindestens eine öffentliche Tabelle oder Regel haben (siehe Step 2); andernfalls ist sie nicht auswählbar.

  5. Wählen Sie im nächsten Schritt des Assistenten aus, welche Tabellen, Ansichten und gespeicherten Prozeduren in die neu erstellte Quelle importiert werden sollen, oder klicken Sie auf Import All, um alles zu importieren. Klicken Sie auf Next.

  6. Der Assistent zeigt eine Zusammenfassung der neuen Datenquelle an. Klicken Sie auf Done. Die neue Datenquelle wird nun unter + Source aufgelistet.
  7. (Empfohlen) Es ist eine bewährte Methode, die Datenquelle nach der Konvention [Data Source You're Connecting to] ([Application Using the Connector]) umzubenennen. Beispielsweise würde ein lokaler Connector für Northwinds, der sich mit einer Anwendung namens My Application verbindet, den Namen Northwinds (My Application) haben. Führen Sie diese Schritte aus, um Ihre Datenquelle umzubenennen:

  8. Klicken Sie auf das Symbol Neues Fenster auf der Kachel der Datenquelle oder doppelklicken Sie auf die Kachel selbst. Das Dialogfeld App Builder Connector wird geöffnet:

    ![App Builder Connector-Dialogfeld](/_download/images/app-builder/connect/app-builder-connector-dialog.png){style="width: 600px"}
    
    1. Klicken Sie auf Bearbeiten. Das Dialogfeld Data Storage Layer wird geöffnet:

      Data Storage Layer-Dialogfeld

    2. Klicken Sie erneut auf Bearbeiten. Geben Sie einen geeigneten Namen in das Feld Data Source Name ein.

    3. Klicken Sie auf Speichern.

Tipp

Erstellen Sie jedes Mal eine separate Datenquelle, wenn Sie eine Anwendung mit einer anderen relationalen Datenbank verbinden möchten, anstatt sie anwendungsübergreifend wiederzuverwenden. Wenn zwei Anwendungen beispielsweise beide eine lokale Verbindung zu Northwinds benötigen, erstellen Sie zwei Datenquellen nach der obigen Namenskonvention: Northwinds (My Application 1) und Northwinds (My Application 2).

Schritt 4: Tabellen und Geschäftsobjekte in Ihren Connector importieren

Wenn Sie die obigen Schritte der Reihe nach befolgt haben, wurden die öffentlichen Tabellen und Regeln beim Erstellen der Datenquelle importiert. Fahren Sie mit Schritt 5 fort. Wenn Sie die Datenquelle jedoch erstellt haben, bevor Sie den öffentlichen Zugriff auf die benötigten Tabellen und Regeln zugelassen haben, können Sie diese jetzt importieren.

  1. Gehen Sie zu IDE > Data Servers.
  2. Wählen Sie im Panel Data Servers die Option Local App Builder aus.
  3. Klicken Sie im seitlichen Panel auf das Symbol Neues Fenster auf der Kachel der Datenquelle oder doppelklicken Sie auf die Kachel selbst. Das Dialogfeld App Builder Connector wird geöffnet:

    App Builder Connector-Dialogfeld Importieren

  4. Klicken Sie in Data Storage Layer auf Importieren. Das Dialogfeld Import Schema wird geöffnet:

    Dialogfeld „Import Schema"

    • Um jede Tabelle zu importieren, die Sie als öffentlich gekennzeichnet haben, klicken Sie erneut auf Importieren unter Import Capabilities.

    • Um nur eine Teilmenge zu importieren, geben Sie zunächst einen Tabellen- oder Geschäftsobjektnamen in das Feld Import Pattern ein und klicken dann auf Importieren unter Import Capabilities.

  5. Klicken Sie auf Fortfahren. App Builder führt einen Hintergrund-Job aus, um den Import abzuschließen.

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

Die Datenquelle, die Sie in Schritt 3 erstellt haben, existiert auf dem Server, aber Ihre Anwendung kann sie erst verwenden, wenn Sie sie explizit als Quelle hinzufügen:

  1. Navigieren Sie zur App Workbench für die App, die Sie ändern möchten.
  2. Gehen Sie zur Registerkarte Data Sources.
  3. Klicken Sie im Panel Data Sources auf + Source. Das Dialogfeld Add a Source to your application wird geöffnet.
  4. Wählen Sie Link to existing source aus und klicken Sie dann auf Next.
  5. Suchen Sie die Datenquelle, die Sie in Schritt 3 erstellt haben, und klicken Sie auf Link 1 Source.
  6. Überprüfen Sie das vorgeschlagene Update und klicken Sie auf Done.

Durch das Verknüpfen von Quellen können Sie datenquellenübergreifende Regeln in beide Richtungen erstellen:

  • Um Regeln mit der relationalen Datenbank als Quelle und Ihrer lokalen App Builder Connector-Datenquelle als Ziel zu erstellen:

    1. Navigieren Sie zur App Workbench für die App, die Sie ändern möchten.
    2. Gehen Sie zur Registerkarte Data Sources.
    3. Wählen Sie die relationale Datenbank aus, mit der Sie eine Verknüpfung herstellen möchten. Das seitliche Panel wird mit den entsprechenden Optionen gefüllt.
    4. Klicken Sie in der Feldgruppe Business Logic Layer auf Link Sources. Das Dialogfeld Linked Data Sources wird geöffnet.
    5. Klicken Sie auf Create und wählen Sie dann die lokale App Builder Connector-Datenquelle aus, die Sie Ihrer Anwendung in Schritt 5 hinzugefügt haben.
    6. Klicken Sie auf das Häkchen , um den Datensatz zu speichern.

Nachdem die Verbindung hergestellt ist, können Sie Tabellen und Business Objects aus der lokalen App Builder-Datenquelle in Business Rules und XP CRUD-Regeln verwenden, die in der relationalen Datenbank erstellt wurden, einschließlich XP CRUD-Regeln, deren Quelldatenquelle die relationale Datenbank ist und deren Zieldatenquelle Ihre lokale App Builder-Datenquelle ist. Erstellen Sie diese XP CRUD-Regeln in der relationalen Datenbank.

  • Um Regeln in die entgegengesetzte Richtung zu erstellen, mit Ihrem lokalen App Builder-Connector als Quelle und der relationalen Datenbank als Ziel:

    1. Navigieren Sie zur App Workbench für die App, die Sie ändern möchten.
    2. Gehen Sie zur Registerkarte Data Sources.
    3. Wählen Sie den lokalen App Builder-Connector aus, den Sie verknüpfen möchten. Das seitliche Bedienfeld wird mit seinen Optionen gefüllt.
    4. Klicken Sie in der Feldgruppe Business Logic Layer auf Link Sources. Das Dialogfeld Linked Data Sources wird geöffnet.
    5. Klicken Sie auf Create und wählen Sie dann die relationale Datenquelle aus, mit der Sie sich verbinden möchten.
    6. Klicken Sie auf das Häkchen, um den Datensatz zu speichern.

    Nachdem die Verbindung hergestellt ist, können Sie Tabellen und Business Objects aus der relationalen Datenbank in Business Rules und XP CRUD-Regeln verwenden, die im lokalen App Builder-Connector erstellt wurden, einschließlich XP CRUD-Regeln, deren Quelldatenquelle die lokale App Builder-Datenquelle ist und deren Zieldatenquelle Ihre relationale Datenquelle ist. Erstellen Sie diese XP CRUD-Regeln im lokalen App Builder-Connector.

Remote-Connector

Ein Remote-Connector ermöglicht es einer Anwendung in einer App Builder-Umgebung, ein freigegebenes Objekt aus einer völlig separaten App Builder-Umgebung zu verwenden, die unter ihrer eigenen URL erreichbar ist, über HTTP. Im Gegensatz zu einem lokalen Connector teilen sich die beiden Umgebungen keinen Server, daher müssen sie sich explizit mithilfe eines API-Schlüssels authentifizieren. Die folgenden Schritte geben ein Objekt zunächst in der Quellumgebung frei und verbinden sich dann von der Remote-Umgebung aus damit.

Dieser Abschnitt behandelt:

Schritt 1: Das freizugebende Objekt mit App Builder-Connector erstellen

Bevor eine Remote-Umgebung Daten von dieser abrufen kann, benötigen Sie etwas zum Freigeben. Dieser Schritt erstellt eine Regel, die genau definiert, was verfügbar gemacht wird:

  1. Navigieren Sie zur App Workbench für die App, die Sie freigeben möchten, und gehen Sie dann zur Registerkarte Rules.
  2. Klicken Sie auf + Rule. Der Rule Builder wird geöffnet:

    • Name: Weisen Sie einen Namen für die Regel zu. Beispiel: Customer (Remote).
    • Purpose: Wählen Sie Business Object aus.
    • Target: Wählen Sie eine Zieltabelle für die Regel aus. Beispiel: Customer.
  3. Klicken Sie auf Create.

  4. Wählen Sie im Bedienfeld Tables die Spalten aus, die Sie freigeben möchten.
  5. Gehen Sie im Bedienfeld Rule zu More > Edge Case. Das Dialogfeld Edge Case Settings wird geöffnet:

    Edge Case Settings-Dialogfeld 2

  6. Aktivieren Sie unter Allow Public Access Read und/oder Write je nach Bedarf, damit die Remote-Umgebung auf das Objekt zugreifen kann.

  7. Klicken Sie auf Proceed.

Schritt 2: Remote App Builder-Verbindungen aktivieren

Ein Objekt freizugeben ist allein nicht ausreichend: Die Anwendung muss auch explizit berechtigt sein, Remote-Connector-Anfragen zu akzeptieren, und seit App Builder 4.67 mit den Anbietern verknüpft sein, die diese authentifizieren dürfen:

  1. Gehen Sie zu IDE > Zusätzliche Einstellungen.
  2. Klicken Sie im Bereich Konfigurieren auf Remote Connector. Das Dialogfeld Datenquellen wird geöffnet:

    Dialogfeld „Datenquellen"

  3. Aktivieren Sie das Kontrollkästchen in der Spalte Zulassen für die Anwendung, für die Sie Remote-Verbindungen zulassen möchten.

  4. Klicken Sie auf Fortfahren oder das Häkchen .
  5. (Seit App Builder 4.67.) Klicken Sie auf die Schaltfläche Authentifizierung konfigurieren für die Anwendung. Das Dialogfeld Authentifizierungsanbieter wird geöffnet. Fügen Sie die API-Schlüssel-, HTTP- oder Autorisierungsserver-Anbieter hinzu, die Sie für die Authentifizierung der Remote-Connector-Anfragen zulassen möchten. Siehe Endpunkt konfigurieren für die genauen Schritte.

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

Die Remote-Umgebung authentifiziert sich bei dieser mit einem API-Schlüssel. Bestätigen Sie daher, dass dieser Sicherheitsanbieter vorhanden und aktiviert ist, bevor Sie einen generieren:

  1. Gehen Sie zu IDE > Sicherheitsanbieter.
  2. Bestätigen Sie, dass ein aktivierter API-Schlüssel-Sicherheitsanbieter konfiguriert ist. Falls nicht, konfigurieren Sie einen (siehe Sicherheitsanbieter – API-Schlüssel für weitere Informationen).

Schritt 4: Erstellen Sie eine Rolle zum Freigeben des Objekts

Die Schritte 4 bis 6 sind eine empfohlene Best Practice, keine Anforderung: Sie beschränken den Zugriff der Remote-Umgebung auf nur das Objekt, das Sie freigeben, indem Sie eine dedizierte Rolle, Gruppe und einen Benutzer erstellen und dann den API-Schlüssel für diesen Benutzer generieren. Wenn Sie diese überspringen und stattdessen einen API-Schlüssel für einen vorhandenen Benutzer generieren und die Datenquelle dieses Benutzers keine konfigurierten Rollen hat, gewährt der Schlüssel Zugriff auf jedes Objekt, das Sie in Schritt 1 mit Lesen zulassen und/oder Schreiben zulassen gekennzeichnet haben, nicht nur auf das, das Sie hier freigeben.

  1. Navigieren Sie zur App Workbench für die App, und gehen Sie dann zur Registerkarte Rollen. Wenn die App mehr als eine Datenquelle hat, wählen Sie die Datenquelle aus, zu der das freigegebene Objekt gehört, aus dem Datenquellenmenü oben auf der Seite.
  2. Klicken Sie auf + Rolle (siehe unten):

    Registerkarte „Rollen"

  3. Das Dialogfeld Rolle wird geöffnet. Weisen Sie einen Namen für die Rolle zu. Beispiel: Remote Connector.

  4. Klicken Sie auf Speichern. Der Bereich Berechtigungen wird verfügbar:

    Dialogfeld „Rolle"

  5. Klicken Sie auf + Berechtigung, wählen Sie das Objekt aus, das Sie in Schritt 1 erstellt haben, und aktivieren Sie dann Lesen, Einfügen, Aktualisieren und/oder Löschen nach Bedarf.

  6. Klicken Sie auf das Häkchen , um zu speichern.

Hinweis

Weitere Informationen zu Rollen finden Sie unter Berechtigungen und Privilegien.

Schritt 5: Erstellen Sie eine Gruppe und gewähren Sie ihr Zugriff

Erstellen Sie eine dedizierte Gruppe, mit der sich die Remote-Umgebung authentifiziert:

  1. Navigieren Sie zu IDE > Benutzerverwaltung, und wählen Sie dann die Registerkarte Gruppen:

    Seite „Gruppen"

  2. Klicken Sie auf + Gruppe. Das Dialogfeld Gruppe wird geöffnet:

    Dialogfeld „Gruppe"

  3. Weisen Sie einen Namen zu. Beispiel: Remote Connector.

  4. Klicken Sie auf Speichern.
  5. Klicken Sie auf Berechtigungen verwalten. Die Bereiche Berechtigungen und Rollen werden geöffnet.
  6. Klicken Sie im Bereich Berechtigungen auf Erstellen. Das Dialogfeld Berechtigung wird geöffnet:

    Dialogfeld „Berechtigung"

    • Typ: Wählen Sie Anwendung.
    • Anwendung: Wählen Sie die Anwendung aus, die das Objekt enthält, das Sie freigeben. Beispiel: Global Imports.
  7. Klicken Sie auf Speichern.

  8. Suchen Sie im Bereich Rollen die Rolle, die Sie in Schritt 4 erstellt haben, und klicken Sie auf Gewähren.

Hinweis

Die Remote-Umgebung benötigt auch die integrierte Rolle App Builder Remote Connector, auf die unter 403 forbidden error verwiesen wird. Falls diese noch nicht gewährt wurde, suchen Sie sie auf und klicken Sie im gleichen Roles-Panel auch für diese auf Grant.

Schritt 6: Benutzer erstellen, API-Schlüssel generieren und zum Projekt hinzufügen

Erstellen Sie einen dedizierten Benutzer für die Remote-Umgebung zur Authentifizierung und generieren Sie die Anmeldedaten für die Verbindung:

  1. Wählen Sie die Registerkarte Users aus:

    Users page

  2. Klicken Sie auf + User. Das Dialogfeld User wird geöffnet:

    User dialog

  3. Weisen Sie einen User Name zu. Beispiel: RemoteConnector.

  4. Klicken Sie auf Save.
  5. Klicken Sie auf More > Keys.
  6. Klicken Sie auf Create. Das Dialogfeld Generate Key wird geöffnet:

    Generate Key dialog

  7. Wählen Sie API Key als Provider aus und klicken Sie auf Save.

  8. Kopieren Sie den generierten Key-Wert in die Zwischenablage.

    Vorsicht

    Der generierte Schlüsselwert kann nicht mehr abgerufen werden, wenn Sie den Generate Key-Bildschirm verlassen. Falls Sie ihn verlieren, müssen Sie einen neuen generieren.

  9. Klicken Sie auf + Membership, wählen Sie das Projekt aus, das Sie in Schritt 5 erstellt haben, und klicken Sie auf das Häkchen zum Speichern.

Schritt 7: Verbindung von der Remote-Umgebung einrichten

Alle bisherigen Schritte fanden in der Umgebung statt, die das Objekt freigegeben hat. Dieser letzte Schritt wechselt zur Remote-Umgebung und nutzt die gerade erstellten Anmeldedaten, um die Verbindung herzustellen:

  1. Navigieren Sie zur Remote-Umgebung, von der aus Sie eine Verbindung herstellen möchten, gehen Sie dann zur App Workbench für die App, mit der Sie eine Verbindung herstellen möchten, und wählen Sie die Registerkarte Data Sources aus.
  2. Klicken Sie auf + Source. Ein Assistent wird geöffnet, um Sie zu unterstützen.
  3. Wählen Sie im ersten Bildschirm des Assistenten New Connection aus und klicken Sie auf Next.
  4. Wählen Sie Other als Connection Category aus, suchen Sie dann nach App Builder Connector und wählen Sie es aus:

    Choose Connection Type screen

  5. Klicken Sie auf Next. Der Assistent überspringt den Schritt Choose Provider für diesen Verbindungstyp und geht direkt zu Create Connection.

  6. Geben Sie die folgenden Werte ein:

    Create New Connection screen

    • Server Name: Weisen Sie einen Namen zu. Beispiel: Remote.
    • App Builder Type: Bestätigen Sie, dass dies auf Remote eingestellt ist.
    • Url: Geben Sie die URL der Umgebung ein, mit der Sie eine Verbindung herstellen. Beispiel: https://example.com.
    • Api Key: Fügen Sie den Schlüsselwert ein, den Sie in Schritt 6 kopiert haben.
  7. Klicken Sie auf Next und durchlaufen Sie dann die verbleibenden Schritte des Assistenten (Choose Database, Import Schema und Summary), um die Datenbank auszuwählen, die Tabellen, Ansichten und gespeicherten Prozeduren zu importieren, mit denen Sie eine Verbindung herstellen möchten, und bestätigen Sie die neue Verbindung.

  8. Wählen Sie die Remote-App-Builder-Connector-Datenquelle aus und klicken Sie auf Logic.
  9. Klicken Sie auf das Results-Symbol für einen Eintrag, um zu bestätigen, dass Daten angezeigt werden.
  10. Testen Sie die Verbindung: Bearbeiten Sie einen Datensatz und speichern Sie ihn, kehren Sie dann zur anderen Umgebung zurück und bestätigen Sie, dass die Aktualisierung auch dort angezeigt wird.

Einschränkungen

Beachten Sie die folgenden Einschränkungen bei der Arbeit mit App Builder Connector:

  • App Builder Connector unterstützt Reach nicht.
  • App Builder Connector unterstützt Full audit, aber Full audit muss in der zugrunde liegenden Tabelle aktiviert sein, damit es funktioniert.
  • Bei einem lokalen App Builder Connector müssen beide Datenbanken relationale Datenbanken sein und auf der gleichen Server-Umgebung vorhanden sein.
  • Bei einem lokalen App Builder Connector müssen Sie, wenn Sie Spalten in einer öffentlichen Tabelle oder einem Business Object hinzufügen oder ändern, die entsprechenden Tabellen oder Business Objects auf jeder Seite manuell synchron halten.

Hinweis

Wir empfehlen, dedizierte Business Objects zur Verwendung mit dem App Builder Connector zu erstellen, anstatt vorhandene wiederzuverwenden. Nachdem Sie ein Object importiert haben, ändern Sie das öffentliche Object nur bei Bedarf. Falls Sie es ändern, nehmen Sie die gleiche Änderung an seinem Gegenstück im lokalen App Builder Connector vor.

Fehlerbehebung

403 Forbidden-Fehler

  • Symptom: Das Verbinden mit einer Remote App Builder-Umgebung über den App Builder Connector gibt einen 403 Forbidden-Fehler zurück.

  • Mögliche Ursache: Das für den Connector konfigurierte Benutzerkonto hat in der App Builder-Quellumgebung nicht die Rolle App Builder Remote Connector erhalten.

  • Lösung: Weisen Sie diesem Benutzer die Rolle App Builder Remote Connector zu. Konfigurationsschritte finden Sie unter Schritt 5: Gruppe erstellen und Zugriff gewähren des Remote Connectors.

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 unter App Builder Connector: Generierter API-Schlüssel kann nach Verlassen des Bildschirms nicht abgerufen werden im App Builder-Fehlerbehebungsleitfaden.