QuickBooks Connector OAuth 2.0 erstellt einen Endpoint in Jitterbit Design Studio

Bevor Sie mit den Schritten auf dieser Seite beginnen, sollten Sie diese Einrichtungsaktivitäten bereits abgeschlossen haben, um Harmony Zugriff auf Ihre QuickBooks Online-Instanz zu gewähren:

• QuickBooks Konnektor OAuth 2.0 erstellt QuickBooks App
• Jitterbit Design Studio unter Windows installieren oder Jitterbit Design Studio auf macOS installieren
• Installieren Sie einen Windows Agenten oder Einen Linux Agenten installieren

An diesem Punkt sollten Sie über alle Informationen verfügen, die Sie benötigen, um mit der Arbeit in Harmony zu beginnen. Auf dieser Seite wird beschrieben, wie Sie mit dem Harmony QuickBooks Connector einen Endpoint in Jitterbit Design Studio erstellen.

Endpoint

1. Öffnen Sie die Anwendung Design Studio, Version 8.29.2 oder höher. Melden Sie sich mit den Anmeldeinformationen an, die Sie beim Beitritt zu Ihrer Organisation während des Anmeldevorgangs über die Harmony-Website erstellt haben.

2. Der Bildschirm „Erste Schritte“ sollte angezeigt werden. Dort können Sie verschiedene Aufgaben ausführen. Für diesen Schritt erstellen wir ein neues Projekt. Klicken Sie im unteren Tab des Bildschirms „Erste Schritte“ auf Neues Projekt.

   1. Wählen Sie einen passenden Namen für Ihr neues Projekt und wählen Sie dann weitere Einstellungen aus, die für Ihre Organisation geeignet sind. Für dieses Beispiel nennen wir unser Projekt „QuickBooks New OAuth 2“.
   2. Wenn Sie Design Studio zum ersten Mal verwenden, können Sie alle Standardwerte akzeptieren.
   3. Wenn Sie Design Studio bereits zuvor verwendet haben, möchten Sie möglicherweise die ausgewählten Einstellungen entsprechend ändern.

   4. Klicken Sie auf die Schaltfläche Erstellen.

      

3. Sobald Ihr neues Projekt erstellt wurde, sollte Ihr Bildschirm dem unten gezeigten Bild ähneln. Ganz links im Design Studio werden die verschiedenen Teile Ihrer Integration angezeigt: Operationen, Transformations usw. Scrollen Sie auf der linken Seite nach unten, bis Sie die Kategorie Konnektoren sehen. Doppelklicken Sie auf den QuickBooks-Konnektor, damit die zugrunde liegenden Aktivitäten sichtbar werden.

   

4. Klicken Sie dann mit der rechten Maustaste auf QuickBooks Endpoints, wie im Bild unten zu sehen, und wählen Sie Neuer QuickBooks Endpoint aus der Liste.

   

5. Auf der rechten Seite des Bildschirms sollte in Ihrem Arbeitsbereich eine neue Tab mit dem Namen QuickBooks Endpoints angezeigt werden. Hier richten Sie die Möglichkeit ein, Harmony mit Ihrer QuickBooks Sandbox-Instanz zu verbinden, indem Sie die Werte verwenden, die zuvor in dieser Dokumentation abgerufen wurden.

   

   1. Geben Sie im Feld Name einen geeigneten Namen für den Endpoint ein. Für dieses Beispiel nennen wir unseren Endpoint „Neuer QuickBooks Endpoint“.
   2. Wählen Sie das Optionsfeld OAuth2. Auf der Tab werden nun die spezifischen Datenfelder angezeigt, die zum Erstellen eines QuickBooks OAuth 2.0- Endpoint erforderlich sind.
   3. Realm-ID: Die Realm-ID wird im QuickBooks OAuth 2.0 Playground generiert, wie in QuickBooks-Connector OAuth 2.0 - QuickBooks App erstellen beschrieben.
      • Kehren Sie zum geöffneten Browserfenster zurück, in dem die OAuth 2.0 Playground-Seite angezeigt wird.
      • Kopieren Sie die Realm-ID aus dem Browserfenster und fügen Sie sie in das Feld Realm-ID auf der Tab Neuer QuickBooks Endpoint in Design Studio ein, wie im Bild oben gezeigt.
   4. *Autorisierungscode: *Der Autorisierungscode wird im QuickBooks OAuth 2.0 Playground generiert, wie in QuickBooks-Connector OAuth 2.0 - QuickBooks App erstellen beschrieben.
      • Kehren Sie zum geöffneten Browserfenster zurück, in dem die OAuth 2.0 Playground-Seite angezeigt wird.
      • Kopieren Sie den Autorisierungscode aus dem Browserfenster und fügen Sie ihn in das Feld Autorisierungscode auf der Tab Neuer QuickBooks Endpoint in Design Studio ein, wie im Bild oben gezeigt.
   5. Client-ID: Die Client-ID wird während der Erstellung der QuickBooks-App generiert, wie in QuickBooks-Connector OAuth 2.0 - QuickBooks App erstellen beschrieben.
      • Kehren Sie zum geöffneten Browserfenster zurück, in dem die OAuth 2.0 Playground-Seite angezeigt wird.
      • Klicken Sie im Menü oben auf der Seite auf Meine Apps.
      • Wählen Sie die App aus, die Sie während der Test- und Entwicklungsphase speziell zum Einrichten des Harmony QuickBooks Connectors erstellt haben.
      • Klicken Sie auf die Tab Schlüssel.
      • Die Entwicklungsschlüssel werden oben auf der Seite angezeigt.
      • Klicken Sie auf die Schaltfläche Kopieren rechts neben der Client-ID auf der Tab Schlüssel und fügen Sie sie in das Feld Client-ID auf der Tab Neuer QuickBooks Endpoint in Design Studio ein, wie im Bild oben gezeigt.
   6. Client Secret: Das Client Secret wird während der Erstellung der QuickBooks-App generiert, wie in QuickBooks-Connector OAuth 2.0 - QuickBooks App erstellen beschrieben.
      • Kehren Sie zum geöffneten Browserfenster zurück, in dem die Entwicklungsschlüssel angezeigt werden.
      • Klicken Sie auf die Schaltfläche Kopieren rechts neben dem Client Secret auf der Tab Schlüssel und fügen Sie ihn in das Feld Client Secret auf der Tab Neuer QuickBooks Endpoint in Design Studio ein, wie im Bild oben gezeigt.
   7. URL: Dieser Wert ist die URL der QuickBooks-Sandbox Umfeld oder der QuickBooks - Umfeld, je nachdem, welche Sie verwenden. Er kann kopiert und in Ihr URL Textfeld eingefügt werden, wie im Bild oben gezeigt:
      • Sandbox-Umgebung: https://sandbox-quickbooks.api.intuit.com/v3/company
   8. Wenn alle erforderlichen Werte eingegeben wurden, klicken Sie in der Symbolleiste in Design Studio auf das Symbol „Speichern**“.
   9. Die Verbindung sollte getestet werden, um sicherzustellen, dass alles richtig eingerichtet ist. Klicken Sie dazu auf die Schaltfläche Verbindung testen. Das folgende Popup sollte angezeigt werden, sobald Harmony erfolgreich eine Verbindung zu QuickBooks hergestellt hat.
   10. Die obige Meldung bestätigt, dass die neu erstellte Sandbox-Verbindung gültig ist und funktioniert. Wenn die Verbindung nicht erfolgreich ist, sollten die angegebenen Werte doppelt überprüft werden, um sicherzustellen, dass keine zusätzlichen Leerzeichen vorhanden sind oder ein Wert nicht vollständig kopiert und in eine der Verbindungseigenschaften eingefügt wurde.

Konfigurieren der Verbindung zur QuickBooks Sandbox auf mehreren Agenten

Wenn Ihre private Agentengruppe mehr als einen privaten Agenten enthält, führen Sie die folgenden Schritte aus:

1. QuickBooks erstellt diese Datei, wenn die Verbindung erfolgreich ist: „C:\ProgramData\qbdata\qbdata.properties“. Diese Datei wird nur auf einem der privaten Agenten in der Agentengruppe erstellt, aber die Datei ist notwendig, damit QuickBooks mit jedem Agenten kommunizieren kann.
2. Durchsuchen Sie jeden privaten Agenten innerhalb der Agentengruppe, um festzustellen, auf welchem Agenten sich die Datei „qbdata.properties“ befindet.
3. Kopieren Sie den gesamten Ordner „\qbdata“ in den Ordner „c:\ProgramData“ auf jedem der verbleibenden Agenten innerhalb der Agentengruppe. Dadurch kann jeder Agent innerhalb der Agentengruppe mit QuickBooks kommunizieren.

Nächster Schritt: Sobald Ihr Harmony Endpoint erfolgreich eine Verbindung zu Ihrer QuickBooks Sandbox-Instanz hergestellt hat, besteht Ihr nächster Schritt darin, die entsprechenden Aktivitäten zu erstellen, um Ihre QuickBooks Online-Instanz in andere Programme und Anwendungen zu integrieren.

QuickBooks Konnektor - Abfrage

QuickBooks Konnektor - Aktivitäten erstellen

QuickBooks Konnektor - Aktivitäten aktualisieren

QuickBooks Konnektor - Aktivitäten löschen

Endpoint

Wenn Sie bereit sind, Ihre Integration in eine Umfeld zu bringen, befolgen Sie die unten aufgeführten Schritte, um einen Endpoint in Design Studio zu erstellen.

1. Öffnen Sie die Anwendung Design Studio, Version 8.29.2 oder höher. Wählen Sie auf der Tab Letzte Projekte ein vorhandenes QuickBooks Projekt aus und klicken Sie auf die Schaltfläche Öffnen, oder klicken Sie auf die Tab Neues Projekt und erstellen Sie ein neues Projekt.
2. Scrollen Sie auf der linken Seite des Design Studio nach unten, bis Sie die Kategorie Konnektoren sehen. Doppelklicken Sie auf den QuickBooks-Konnektor, damit die zugrunde liegenden Aktivitäten sichtbar werden.
3. Klicken Sie mit der rechten Maustaste auf QuickBooks Endpoints und wählen Sie Neuer QuickBooks Endpoint aus der Liste.
4. Auf der rechten Seite des Bildschirms sollte in Ihrem Arbeitsbereich eine neue Tab mit dem Namen QuickBooks Endpoints angezeigt werden. Hier richten Sie die Möglichkeit ein, Harmony mit Ihrer QuickBooks Produktionsinstanz zu verbinden, indem Sie die Werte verwenden, die zuvor in dieser Dokumentation abgerufen wurden.
   1. Geben Sie im Feld Name einen geeigneten Namen für den Endpoint ein. Für dieses Beispiel nennen wir unseren Endpoint „QuickBooks Production“.
   2. Wählen Sie das Optionsfeld OAuth2. Auf der Tab werden nun die spezifischen Datenfelder angezeigt, die zum Erstellen eines QuickBooks OAuth 2.0- Endpoint erforderlich sind.
   3. Realm-ID: Die Realm-ID wird im QuickBooks OAuth 2.0 Playground generiert, wie in QuickBooks-Connector OAuth 2.0 - QuickBooks App erstellen beschrieben.
      • Kehren Sie zum geöffneten Browserfenster zurück, in dem die OAuth 2.0 Playground-Seite angezeigt wird.
      • Kopieren Sie die Realm-ID aus dem Browserfenster und fügen Sie sie in das Feld Realm-ID auf der Tab QuickBooks Endpoint in Design Studio ein, wie im Bild oben gezeigt.
   4. Autorisierungscode: Der Autorisierungscode wird im QuickBooks OAuth 2.0 Playground generiert, wie in QuickBooks-Connector OAuth 2.0 - QuickBooks App erstellen beschrieben.
      • Kehren Sie zum geöffneten Browserfenster zurück, in dem die OAuth 2.0 Playground-Seite angezeigt wird.
      • Kopieren Sie den Autorisierungscode aus dem Browserfenster und fügen Sie ihn in das Feld Autorisierungscode auf der Tab QuickBooks Endpoint in Design Studio ein, wie im Bild oben gezeigt.
   5. Client-ID: Die Client-ID wird während der Erstellung der QuickBooks-App generiert, wie in QuickBooks-Connector OAuth 2.0 - QuickBooks App erstellen beschrieben.
      • Kehren Sie zum geöffneten Browserfenster zurück, in dem die OAuth 2.0 Playground-Seite angezeigt wird.
      • Klicken Sie im Menü oben auf der Seite auf Meine Apps.
      • Wählen Sie die App aus, die Sie während der Test- und Entwicklungsphase speziell zum Einrichten des Harmony QuickBooks Connectors erstellt haben.
      • Klicken Sie auf die Tab Schlüssel.
      • Scrollen Sie nach unten zum Abschnitt Produktionsschlüssel.
      • Klicken Sie auf der Registerkarte Schlüssel rechts neben der Client-ID auf die Tab Anzeigen. Die Client-ID wird angezeigt.
      • Klicken Sie auf die Schaltfläche Kopieren rechts neben der Client-ID und fügen Sie sie in das Feld Client-ID auf der Tab QuickBooks Endpoint in Design Studio ein, wie im Bild oben gezeigt.
   6. Client Secret: Das Client Secret wird während der Erstellung der QuickBooks-App generiert, wie in QuickBooks-Connector OAuth 2.0 - QuickBooks App erstellen beschrieben.
      • Kehren Sie zum geöffneten Browserfenster zurück, in dem der Abschnitt Produktionsschlüssel angezeigt wird.
      • Klicken Sie auf der Registerkarte Schlüssel rechts neben dem Client Secret auf die Tab Anzeigen. Das Client Secret wird angezeigt.
      • Klicken Sie auf die Schaltfläche Kopieren rechts neben dem Client Secret und fügen Sie es in das Feld Client Secret auf der Tab QuickBooks Endpoint in Design Studio ein, wie im Bild oben gezeigt.
   7. URL: Dieser Wert ist die URL der QuickBooks-Sandbox Umfeld oder der QuickBooks - Umfeld, je nachdem, welche Sie verwenden. Er kann kopiert und in Ihr URL Textfeld eingefügt werden, wie im Bild oben gezeigt:
5. Produktionsumgebung: https://quickbooks.api.intuit.com/v3/company
6. Wenn alle erforderlichen Werte eingegeben wurden, klicken Sie in der Symbolleiste in Design Studio auf das Symbol „Speichern**“.
7. Die Verbindung sollte getestet werden, um sicherzustellen, dass alles richtig eingerichtet ist. Klicken Sie dazu auf die Schaltfläche Verbindung testen. Das folgende Popup sollte angezeigt werden, sobald Harmony erfolgreich eine Verbindung zu QuickBooks hergestellt hat.
8. Die obige Meldung bestätigt, dass die neu erstellte Produktionsverbindung gültig ist und funktioniert. Wenn die Verbindung nicht erfolgreich ist, sollten die angegebenen Werte noch einmal überprüft werden, um sicherzustellen, dass keine zusätzlichen Leerzeichen vorhanden sind oder ein Wert nicht vollständig kopiert und in eine der Verbindungseigenschaften eingefügt wurde.

Konfigurieren der Verbindung zur QuickBooks-Produktion auf mehreren Agenten

Wenn Ihre private Agentengruppe mehr als einen privaten Agenten enthält, führen Sie die folgenden Schritte aus:

1. QuickBooks erstellt diese Datei, wenn die Verbindung erfolgreich ist: „C:\ProgramData\qbdata\qbdata.properties“. Diese Datei wird nur auf einem der privaten Agenten in der Agentengruppe erstellt, aber die Datei ist notwendig, damit QuickBooks mit jedem Agenten kommunizieren kann.
2. Durchsuchen Sie jeden privaten Agenten innerhalb der Agentengruppe, um festzustellen, auf welchem Agenten sich die Datei „qbdata.properties“ befindet.
3. Kopieren Sie den gesamten Ordner „\qbdata“ in den Ordner „c:\ProgramData“ auf jedem der verbleibenden Agenten innerhalb der Agentengruppe. Dadurch kann jeder Agent innerhalb der Agentengruppe mit QuickBooks kommunizieren.