Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

✕

Diese Dokumentation gilt für Version 4 und höher von App Builder, dem neuen Namen für Vinyl. Hier gelangen Sie zur Vinyl-Dokumentation.

✕

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 Umfeld (Lokal) oder über zwei verschiedene Umgebungen hinweg über HTTP (Remote) ausgeführt werden. Schritte zur Konfiguration lokaler und Remote-App Builder Connectors finden Sie in diesem Artikel.

Wenn Sie versuchen, ein App Builder LP-Abhängigkeitsszenario zu lösen, empfehlen wir Ihnen, die Tabellenvererbung oder Tabellenerweiterung-Funktion und verwenden Sie nicht den 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 in derselben Umfeld befinden, und es entsteht keine Abhängigkeit von anderen Apps, wenn Sie Ihre App LP bündeln und versenden möchten.

Ein Beispiel für das App Builder LP-Abhängigkeitsszenario:
Sie haben zwei App Builder Datenquellen, die sich auf derselben Instanz oder Umfeld befinden, und Sie möchten Datenquelle A und Datenquelle B verbinden. 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 eine 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.

Warnung

Es wird grundsätzlich keinem Kunden empfohlen, selbst mit App Builder Connectors zu arbeiten, ohne sich vorher mit seinem zuständigen Jitterbit-Berater oder-Kontakt zu beraten.

Lokaler App Builder Konnektor

Mit dem Local App Builder Connector kann innerhalb derselben Umfeld eine Verbindung von einer relationalen Datenquelle zu einer anderen hergestellt werden.

1. Erstellen eines lokalen App Builder Konnektors

  • Klicken Sie in der IDE auf Datenserver
  • Klicken Sie im Bereich „Datenserver“ auf + Server
  • Benennen Sie Ihre Serververbindung
    • Die bewährte Namenskonvention besteht darin, den Server „Local App Builder“ zu nennen.
  • Wählen Sie den Typ App Builder aus dem Abschnitt Servereinstellungen
  • Wählen Sie den App Builder-Typ Lokal
  • Klicken Sie auf Speichern

2. Erstellen einer Datenquelle mit dem lokalen App Builder Connector

  • Klicken Sie in der IDE auf Datenserver
  • Klicken Sie, um den Eintrag Local App Builder aus dem Bereich „Datenserver“ auszuwählen.
  • 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 Namenskonvention 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, mit der Sie eine Verbindung herstellen möchten.

    Hinweis

    Sie müssen eine relationale Datenbank auswählen. Die Datenquelle benötigt eine öffentliche Tabelle/ein öffentliches Datenobjekt, damit sie als Datenbank ausgewählt werden kann.

  • Klicken Sie auf Weiter.

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

Notiz

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

Beispiel: Wenn Sie zwei Anwendungen haben und eine lokale App Builder Verbindung für die Verbindung mit Northwinds verwenden möchten, erstellen Sie zwei Datenquellen. Gemäß unserer Namenskonvention wären dies:

  • Northwinds (Meine Bewerbung 1)
  • Northwinds (Meine Bewerbung 2)

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 Geschäftsschichtregeln
  • Wählen Sie die App-Datenquelle aus, um die Datenquelle mit den Tabellen anzuzeigen, die Sie mit „Öffentlicher Zugriff“ markieren.
  • 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

Hinweis

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

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

  • Navigieren Sie zur IDE und klicken Sie auf Datenserver
  • Klicken Sie, um den Eintrag Local App Builder aus dem Bereich „Datenserver“ auszuwählen.
  • 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 zu Ihrer Anwendung hinzu

  • 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 in Schritt 2 erstellte Datenquelle und klicken Sie auf Quelle verknüpfen
  • Überprüfen Sie das vorgeschlagene Update und klicken Sie auf Fertig
  • 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 für die ausgewählte Datenquelle auf die Schaltfläche Quellen verknüpfen
  • Klicken Sie auf Erstellen und wählen Sie die Local App Builder Connector-Datenquelle aus, die Sie Ihrer Anwendung in Schritt 6 hinzugefügt haben.
  • Klicken Sie auf das Häkchen, um den Datensatz zu speichern

Hinweis

Dadurch können Sie Tabellen und Geschäftsobjekte aus der lokalen Vinyl-Datenquelle in Geschäftsregeln und XP-CRUD-Regeln verwenden, die in der relationalen Datenbank erstellt wurden.

Dadurch können Sie auch XP-CRUD-Regeln mit der Quelldatenquelle der relationalen Datenbank und der Zieldatenquelle Ihrer lokalen Vinyl-Datenquelle erstellen. Diese XP-CRUD-Regeln 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 Datenquellen
  • Klicken Sie, um den Local App Builder Connector auszuwählen, mit dem Sie eine Verknüpfung 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

Hinweis

Dadurch können Sie Tabellen und Geschäftsobjekte aus der relationalen Datenbank in Geschäftsregeln und XP-CRUD-Regeln verwenden, die im lokalen Vinyl-Connector erstellt wurden.

Dadurch können Sie auch XP-CRUD-Regeln mit der Quelldatenquelle der lokalen Vinyl-Datenquelle und der Zieldatenquelle Ihrer relationalen Datenquelle erstellen. Diese XP-CRUD-Regeln müssen in der relationalen Datenbank erstellt werden.

Remote-Anschluss

Mit dem Remote App Builder Connector kann eine Verbindung von einer App Builder Umfeld zu einer anderen über HTTP hergestellt werden.

1. Erstellen Sie das zu teilende Objekt mit dem App Builder Connector

  • Navigieren Sie von der App, die Sie freigeben möchten, zur App Workbench
  • Klicken Sie auf + Regel
  • Weisen Sie der Regel einen Namen zu. 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 > Edge Case
  • Aktivieren Sie unter Öffentlichen Zugriff zulassen die Option Lesen und/oder Schreiben, je nachdem, was zutrifft
  • Klicken Sie auf Weiter

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 Zulassen für die Anwendung, für die Sie Remote-App Builder Verbindungen zulassen möchten
  • 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
  • Stellen Sie sicher, dass ein aktivierter * API Schlüssel*-Sicherheitsanbieter konfiguriert ist. Falls nicht, muss einer konfiguriert werden.
  • Siehe Sicherheitsanbieter - API Schlüssel für weitere Informationen

4. Erstellen Sie eine Rolle zum Freigeben 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. 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 zum Speichern auf das Häkchen

Hinweis

Weitere Informationen zu Rollen finden Sie unter Berechtigungen und Berechtigungen.

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. 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 im vorherigen Schritt ausgewählte Anwendung angezeigt wird
  • Klicken Sie auf die Schaltfläche Gewähren für den App Builder Remote Connector
  • 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

Achtung

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

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 Sonstige als Verbindungskategorie
  • Suchen und wählen Sie App Builder aus und klicken Sie auf Weiter
  • Weisen Sie einen Servernamen zu. Beispiel: Remote
  • Bestätigen Sie, dass App Builder Type auf Remote eingestellt ist
  • Fügen Sie den in Schritt 5 kopierten API-Schlüssel-Wert ein
  • 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 Updates. Klicken Sie dann auf Fertig
  • Wählen Sie Remote App Builder Connector-Datenquelle und klicken Sie dann 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 den Local App Builder Connector müssen beide Datenbanken relationale Datenbanken sein und in der gleichen Umfeld vorhanden sein.
  • Wenn Sie beim Local App Builder Connector Spalten zu öffentlichen Tabellen oder Geschäftsobjekten hinzufügen/ändern, müssen Sie die Tabellen/Geschäftsobjekte manuell synchronisieren.

Notiz

Es empfiehlt sich, neue Business-Objekte zu erstellen, die ausschließlich für den App Builder Connector verwendet werden. Nach dem Importieren des Objekts sollten Sie das öffentliche Objekt nur bei Bedarf ändern. Wenn Sie es ändern, achten Sie darauf, die gleiche Änderung auch im lokalen App Builder Connector vorzunehmen.

Fehlerbehebung

403 verbotener Fehler

Wenn Sie beim App Builder Connector die Fehlermeldung „403 Forbidden“ 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