QuickBooks Konnektor Aktivitäten im Jitterbit Design Studio erstellen

Bevor Sie neue QuickBooks Daten aus Jitterbit erstellen können, müssen Sie einen QuickBooks Endpoint in Jitterbit Studio erstellt haben (siehe QuickBooks-Connector OAuth 1.0a - Endpoint erstellen oder QuickBooks Connector 2.0 - Endpoint erstellen). Jetzt, da Jitterbit Zugriff auf Ihre QuickBooks Online-Instanz hat, können Sie vier Hauptaktivitäten mit Ihren QuickBooks Daten durchführen: Abfragen, Erstellen, Aktualisieren oder Löschen.

Auf dieser Seite geht es um das Erstellen neuer QuickBooks Daten. Als Beispiel wird das Erstellen eines neuen QuickBooks Kunden über eine XML-Datei mit Jitterbit verwendet. Diese Schritte sind unterteilt in den Beginn der Erstellungsaktivität, das Definieren der Operationskomponenten und das Bereitstellen und Ausführen der Operation.

Erstellen einer QuickBooks Operation

1. Innerhalb Ihres Projekts in Jitterbit Studio gibt es mehrere Möglichkeiten, eine neue QuickBooks Erstellungsaktivität zu starten. Jede der folgenden Optionen startet den QuickBooks Erstellungsassistenten, der Sie durch den Vorgang führt.

   • Gehen Sie zu Datei > Neu > Konnektoren > Neues QuickBooks erstellen.
   • Klicken Sie in der Baumstruktur links unter Konnektoren mit der rechten Maustaste auf die Kategorie QuickBooks und wählen Sie dann Neues QuickBooks erstellen.
   • Doppelklicken Sie in der Baumstruktur links unter Konnektoren auf die Kategorie QuickBooks, klicken Sie dann mit der rechten Maustaste auf QuickBooks-Erstellungsaktivitäten und wählen Sie Neues QuickBooks-Erstellen.
   • Klicken Sie in der oberen Symbolleiste auf das Verbindungssymbol (orangefarbenes Puzzleteil) . Wählen Sie im Popup QuickBooks und dann QuickBooks erstellen.

2. Der Endpoint-Bildschirm des QuickBooks Erstellungsassistenten fordert Sie auf, den Endpoint auszuwählen, in dem Sie neue Daten erstellen möchten. Sie sollten bereits Endpoints in QuickBooks-Connector OAuth 1.0a - Endpoint erstellen eingerichtet haben oder QuickBooks Connector 2.0 - Endpoint erstellen. Wählen Sie den entsprechenden Endpoint aus, z. B. einen Sandbox- oder Endpoint. Klicken Sie nach Abschluss auf Weiter.

   Notiz

   Das in dieser Dokumentation verwendete Beispiel erstellt einen neuen Kunden in einem QuickBooks Sandbox-Konto. Um auf Ihre Sandbox zuzugreifen, gehen Sie zu https://developer.intuit.com/ und melden Sie sich bei Ihrem QuickBooks Online-Konto an. Sobald Sie angemeldet sind, gehen Sie zu Dokumente & Tools > Sandbox > Zu Unternehmen gehen für die Sandbox, die Sie verwenden möchten.

   

3. Der Objekt-Bildschirm des QuickBooks Erstellungsassistenten fordert Sie auf, das Objekt auszuwählen, in dem Sie neue Daten erstellen möchten. In diesem Beispiel haben wir bei der Erstellung der QuickBooks Online-App die Buchhaltungs-API verwendet und müssen daher nur ein Objekt auswählen: Buchhaltung. Klicken Sie auf das Objekt und dann auf Weiter, um fortzufahren.

4. Der Komponenten-Bildschirm des QuickBooks Erstellungsassistenten zeigt alle Komponenten an, die für die Erstellung neuer Daten in Ihrer verbundenen QuickBooks Instanz verfügbar sind. Für die Zwecke dieser exemplarischen Vorgehensweise erstellen wir einen neuen Kunden und wählen daher die Kundenkomponente aus. Klicken Sie dann auf die Schaltfläche Fertigstellen.

5. Jitterbit Studio erstellt dann eine QuickBooks API Anforderungs- und-Antwortstruktur, die die Datenerstellung innerhalb Ihrer verbundenen QuickBooks Online-Instanz ermöglicht. In Studio sollte eine neue Tab mit dem Namen QuickBooks-Erstellungsaktivitäten angezeigt werden. Sie können Ihre Erstellungsaktivität hier bei Bedarf umbenennen; in unserem Beispiel heißt unsere „Customer QuickBooks Create“.

   Klicken Sie auf das +-Symbol ganz rechts in den Strukturansichten „Anforderung“ und „Antwort“, um alle Elemente innerhalb der jeweiligen Struktur zu erweitern. Wenn nun jede Seite erweitert ist, sollte nun ein Bildschirm angezeigt werden, der dem unten gezeigten Bild ähnelt.

6. Klicken Sie anschließend auf demselben Bildschirm auf die Schaltfläche Operation erstellen unter In einer Integration verwenden in der oberen rechten Ecke. Dadurch wird die Jitterbit Operation erstellt, die neue Kundendaten in QuickBooks erstellt.

7. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Aktivität „Erstellen“ enthält. Speichern Sie Ihre Operation, indem Sie entweder auf das Symbol für eine einzelne Festplatte klicken, um nur diese Operation zu speichern, oder auf das Symbol für mehrere Festplatten, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass das Sternchen auf der Tab „Operationen“ und der Titel der Operation verschwinden, da Ihre neue Aktivität „Erstellen“ jetzt erstellt und in Ihrem Projekt gespeichert ist.

Definieren der Operation

Jetzt müssen wir die anderen Komponenten der Operation definieren, die in der grafischen Darstellung erscheinen, einschließlich Quelle, Anforderung, Antwort und Ziel. Für die Zwecke dieser Anleitung stellen wir die folgenden Beispiele als Referenz zur Verfügung: Jitterpak QuickBooksExample.jpk und zugehörige Dateien in QuickBooksSampleRequestFiles.zip .

• Quelle: Im Beispiel ist das folgende XML eine Eingabeaufforderung zum Erstellen eines neuen Kunden mit den unten angegebenen Feldwerten:

  CustomerCreateRequest.xml

  <?xml version="1.0" encoding="utf-8"?>
  <ns:INPUT xmlns:ns="urn:qboln-res:document:qboln:oln:functions">
    <Customer>
       <GivenName>Peter1</GivenName>
      <MiddleName></MiddleName>
      <FamilyName>Hynes1</FamilyName>
      <CompanyName>Soft Tech1</CompanyName>
      <DisplayName>Soft Tech1</DisplayName>
      <PrintOnCheckName>SoftTech LLC</PrintOnCheckName>
      <Active>true</Active>
      <PrimaryPhone>
        <FreeFormNumber>7678907676</FreeFormNumber>
        <Default>true</Default>
      </PrimaryPhone>
      <Mobile>
        <FreeFormNumber>8678907676</FreeFormNumber>
      </Mobile>
      <Fax>
         <FreeFormNumber>9678907676</FreeFormNumber>
        <Default>true</Default>
      </Fax>
      <PrimaryEmailAddr>
        <Address>softtech@test.com</Address>
        <Default>true</Default>
      </PrimaryEmailAddr>
      <WebAddr>
        <URI>http://stech.com</URI>
        <Default>true</Default>
      </WebAddr>
      <BillAddr>
        <Line1>456 Chinna Street</Line1>
        <City>Tracy</City>
        <Country>USA</Country>
        <CountryCode>011</CountryCode>
        <CountrySubDivisionCode>767</CountrySubDivisionCode>
        <PostalCode>95391</PostalCode>
        <PostalCodeSuffix>7878</PostalCodeSuffix>
        <Note>Billing Address</Note>
      </BillAddr>
      <ShipAddr>
        <Line1>456 Chinna Street</Line1>
        <City>Tracy</City>
        <Country>str1234</Country>
        <CountryCode>USA</CountryCode>
        <CountrySubDivisionCode>767</CountrySubDivisionCode>
        <PostalCode>95391</PostalCode>
        <PostalCodeSuffix>7878</PostalCodeSuffix>
        <Note>Shipping Address</Note>
      </ShipAddr>
    </Customer>
  </ns:INPUT>
  

  Um die XML-Datei zu verwenden, doppelklicken Sie zuerst auf das Quellsymbol und wählen Sie dann einen neuen Quelltyp aus. Für dieses Beispiel verwenden wir einen privaten Agenten mit lokalen Dateien aktiviert, und wählen Sie daher als Typ „Lokale Datei“ aus und navigieren Sie dann zum Speicherort. Wenn Sie die Beispieldateien verwenden, ist der Ordner „C:\projects\quickbooks“ und die Datei abrufen ist „CustomerCreateRequest.xml“.

• Ziel: Doppelklicken Sie auf das Zielsymbol. Im Beispiel geben wir die neuen Daten aus QuickBooks in eine XML-Datei aus, um sicherzustellen, dass sie erstellt wurden. Dazu wählen wir erneut den Typ „Lokale Datei“ und navigieren zu einem Speicherort auf dem privaten Agenten, an dem wir die Daten speichern möchten. Im Beispiel ist der Ordner „C:\projects\quickbooks“ und der Dateiname „CustomerCreateResponse.xml“.

• Anfrage: Doppelklicken Sie auf das Anfragesymbol und wählen Sie Neue Transformation erstellen. Oder klicken Sie auf der Tab QuickBooks Aktivitäten erstellen auf die Schaltfläche Anfrage erstellen. Dadurch wird der Transformation geöffnet, der Sie durch die Erstellung der Anfrage führt.

  1. Wählen Sie auf dem ersten Bildschirm Name den oben verwendeten Quelltyp aus. Für das Beispiel haben wir XML gewählt. Belassen Sie das Ziel auf der Standardeinstellung.
  2. Wählen Sie auf dem nächsten Bildschirm Quelle die Schaltfläche Vorhandene XML-Struktur auswählen. Wählen Sie in der Dropdown-Liste „QuickBooks Schemas“ aus. Wählen Sie dann „QuickBooksCreateRequest.xsd“ als Strukturdatei aus. Klicken Sie auf dem nächsten Bildschirm auf Fertigstellen.

  3. Die Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Klicken Sie auf das + unten auf der Quell- und der Zielseite, um die Elemente in jedem Baum zu erweitern. Klicken Sie dann auf das Symbol „Automatische Zuordnung“, das unter der Zielseite des Baums angezeigt wird:

     

     Ihr Mapping-Bildschirm sollte nun ungefähr wie der folgende aussehen:

     

• Antwort: Doppelklicken Sie auf das Antwortsymbol und wählen Sie Neue Transformation erstellen. Oder klicken Sie auf der Tab QuickBooks Aktivitäten erstellen auf die Schaltfläche Antwort erstellen. Dadurch wird der Transformation geöffnet, der Sie durch die Erstellung der Antwort führt.

  1. Wählen Sie auf dem ersten Bildschirm Name den oben verwendeten Zieltyp aus. Für das Beispiel haben wir XML gewählt. Belassen Sie die Quelle auf der Standardeinstellung.
  2. Wählen Sie auf dem nächsten Bildschirm Quelle die Schaltfläche Vorhandene XML-Struktur auswählen. Wählen Sie in der Dropdown-Liste „QuickBooks Schemas“ aus. Wählen Sie dann „QuickBooksCreateResponse.xsd“ als Strukturdatei aus. Klicken Sie auf dem nächsten Bildschirm auf Fertigstellen.

  3. Die Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Klicken Sie auf das + unten auf der Quellseite und der Zielseite, um die Elemente in jedem Baum zu erweitern. Klicken Sie auf den Ordner „OUTPUT“ und ziehen Sie ihn von der linken Seite (Quellseite) in den Ordner „OUTPUT“ auf der rechten Seite (Zielseite). Ihr Zuordnungsbildschirm sollte nun ungefähr wie unten aussehen.

     

Bereitstellen und Ausführen der Operation

Nachdem die QuickBooks Erstellungsaktivität vollständig eingerichtet ist, können wir den Vorgang einsetzen und ausführen.

Klicken Sie auf der Tab „Operationen“ auf „Bereitstellen“ -Symbol. Klicken Sie dann auf Ausführen , um die Operation zur Ausführung in die Warteschlange zu stellen.

Im unteren Teil des Bildschirms sollte der Operationsmonitor anzeigen, dass Ihre Operation erfolgreich ausgeführt wurde. Wenn nicht, können Sie auf das Statussymbol doppelklicken, um alle Protokollmeldungen anzuzeigen.

Sie sollten jetzt auch die neu erstellten Daten aus der QuickBooks Ausgabe an das von Ihnen angegebene Ziel sehen. Für das Beispiel wird die Datei jetzt in „C:\projects\quickbooks\CustomerCreateResponse.xml“ erstellt:

<ns:OUTPUT xmlns:ns="urn:qboln-res:document:qboln:oln:functions">
    <ns:Customer>
        <ns:Id>58</ns:Id>
        <ns:SyncToken>0</ns:SyncToken>
        <ns:MetaData>
            <ns:CreateTime>2016-10-04T13:44:06-06:00</ns:CreateTime>
            <ns:LastUpdatedTime>2016-10-04T13:44:06-06:00</ns:LastUpdatedTime>
        </ns:MetaData>
        <ns:GivenName>Peter1</ns:GivenName>
        <ns:FamilyName>Hynes1</ns:FamilyName>
        <ns:FullyQualifiedName>Soft Tech1</ns:FullyQualifiedName>
        <ns:CompanyName>Soft Tech1</ns:CompanyName>
        <ns:DisplayName>Soft Tech1</ns:DisplayName>
        <ns:PrintOnCheckName>SoftTech LLC</ns:PrintOnCheckName>
        <ns:Active>1</ns:Active>
        <ns:PrimaryPhone>
            <ns:FreeFormNumber>7678907676</ns:FreeFormNumber>
        </ns:PrimaryPhone>
        <ns:Mobile>
            <ns:FreeFormNumber>8678907676</ns:FreeFormNumber>
        </ns:Mobile>
        <ns:Fax>
            <ns:FreeFormNumber>9678907676</ns:FreeFormNumber>
        </ns:Fax>
        <ns:PrimaryEmailAddr>
            <ns:Address>softtech@test.com</ns:Address>
        </ns:PrimaryEmailAddr>
        <ns:WebAddr>
            <ns:URI>http://stech.com</ns:URI>
        </ns:WebAddr>
        <ns:DefaultTaxCodeRef>2</ns:DefaultTaxCodeRef>
        <ns:Taxable>1</ns:Taxable>
        <ns:BillAddr>
            <ns:Id>96</ns:Id>
            <ns:Line1>456 Chinna Street</ns:Line1>
            <ns:City>Tracy</ns:City>
            <ns:Country>USA</ns:Country>
            <ns:CountrySubDivisionCode>767</ns:CountrySubDivisionCode>
            <ns:PostalCode>95391</ns:PostalCode>
        </ns:BillAddr>
        <ns:ShipAddr>
            <ns:Id>97</ns:Id>
            <ns:Line1>456 Chinna Street</ns:Line1>
            <ns:City>Tracy</ns:City>
            <ns:Country>str1234</ns:Country>
            <ns:CountrySubDivisionCode>767</ns:CountrySubDivisionCode>
            <ns:PostalCode>95391</ns:PostalCode>
        </ns:ShipAddr>
        <ns:Job>0</ns:Job>
        <ns:BillWithParent>0</ns:BillWithParent>
        <ns:Balance>0</ns:Balance>
        <ns:BalanceWithJobs>0</ns:BalanceWithJobs>
        <ns:CurrencyRef name="United States Dollar">USD</ns:CurrencyRef>
        <ns:PreferredDeliveryMethod>Print</ns:PreferredDeliveryMethod>
    </ns:Customer>
</ns:OUTPUT>

Wenn Sie außerdem Ihr QuickBooks-Konto überprüfen, sollten Sie den neu erstellten Kunden finden.