Zoho Books mit „ IBM App Connect Enterprise “ verwenden

Zoho Books ist eine Komplettlösung für Unternehmen jeder Größe, die ihre Finanzen unternehmensweit verwalten. Das System automatisiert zahlreiche Finanzprozesse, darunter Kreditoren- und Debitorenbuchhaltung, Zeiterfassung, Gehaltsabrechnung, Transaktionsmanagement, Bestandskontrolle und Bankgeschäfte.

Die folgenden Schritte zeigen Ihnen, wie Sie eine Verbindung zu einem Zoho Books-Konto herstellen und einen Zoho Books-Anfrageknoten mithilfe der Konnektorerkennung konfigurieren. Sie können ein ähnliches Verfahren anwenden, um einen Zoho-Books-Eingabeknoten so zu konfigurieren, dass er Zoho Books auf Eingaben überwacht, indem Sie einen Fluss erstellen, der einen Zoho-Books-Eingabeknoten enthält, und ihn über die Konnektorerkennung konfigurieren.

1. Erstellen Sie im „ IBM App Connect Enterprise “-Toolkit einen Ablauf, der einen „Zoho Books Request“-Knoten enthält.
2. Wählen Sie den Knoten Zoho Books Request im Fluss aus, um die Knoteneigenschaften im Editor anzuzeigen.
3. Klicken Sie auf der Registerkarte Basic auf Launch Connector Discovery.
   Es wird ein Fenster angezeigt, in dem Sie den Namen des Richtlinienprojekts und die Tresorraumdetails angeben, die bei der Erkennung des Connectors verwendet werden sollen.
4. Geben Sie die Details des Richtlinienprojekts und des Tresors an, die bei der Ermittlung des Connectors verwendet werden sollen:
   1. Geben Sie im Feld Richtlinienprojekt das Richtlinienprojekt an, das zum Speichern der Richtlinien verwendet wird, die während der Erkennung des Connectors erstellt werden.
      Alternativ können Sie auch ein neues Richtlinienprojekt erstellen, indem Sie auf Neu klicken und dann den Namen des neuen Richtlinienprojekts angeben. Klicken Sie anschließend auf Fertigstellen.
   2. Geben Sie den Tresor an, der bei der Erkennung des Anschlusses verwendet werden soll. Standardmäßig werden Anmeldeinformationen, die während der Erkennung des Connectors verwendet werden, in einem externen Verzeichnistresor gespeichert, der ein App Connect Enterprise Tresor ist, der von jedem Integrationsserver verwendet werden kann. Alternativ können Sie die Anmeldedaten in einem Integrationsserver-Datenspeicher speichern, der im Arbeitsverzeichnis des Integrationsservers angelegt wird und nur von diesem speziellen Integrationsserver verwendet werden kann.
      Um den Tresor anzugeben, der für die Speicherung der Anmeldeinformationen verwendet werden soll, führen Sie die Schritte im Abschnitt Verwenden des Assistenten zur Verbindungserkennung in einem der folgenden Themen aus:

      • Konfigurieren eines externen Verzeichnistresors
      • Konfigurieren eines Integrationsserver-Datenspeichers
   3. Geben Sie in das Feld Tresorschlüssel den Tresorschlüssel ein, der für den Zugriff auf die im Tresor gespeicherten Anmeldeinformationen verwendet wird. Der Tresorschlüssel muss mindestens 8 Zeichen lang sein.
   4. Optional: ' Standardmäßig werden der angegebene Tresorstandort und der Tresorschlüssel als Voreinstellungen im Toolkit gespeichert, so dass die Werte beim Start von Connector Discovery voreingestellt sind. Wenn Sie nicht möchten, dass die Einstellungen gespeichert werden, deaktivieren Sie die Option Speichern in den Tresoreinstellungen.
5. Klicken Sie auf Erkennung starten, um den Assistenten für die Erkennung des Zoho Books-Connectors zu starten.
   Das Fenster Connector Discovery wird angezeigt. Wenn bestehende Zoho Books-Verbindungen (Konten) verfügbar sind, wird eine Liste dieser Verbindungen angezeigt. Wenn es keine bestehenden Verbindungen gibt, wird der Status des Zoho-Books-Connectors als " Not connected angezeigt.
   • Wenn eine oder mehrere Zoho Books-Verbindungen (Konten) vorhanden sind, führen Sie die folgenden Schritte aus:
     1. Wählen Sie die Verbindung (das Konto), die Sie verwenden möchten, indem Sie darauf klicken.
     2. Klicken Sie auf den gewünschten Objekttyp und wählen Sie dann die Aktion aus, die Sie für das Objekt durchführen möchten. Um zum Beispiel SMS-Kampagnen aus Zoho Books abzurufen, klicken Sie auf Kontenplan und dann auf Kontenplan abrufen.
   • Wenn es keine bestehenden Verbindungen (Konten) gibt, führen Sie die folgenden Schritte aus:
     1. Klicken Sie auf den gewünschten Objekttyp und wählen Sie dann die Aktion aus, die Sie für dieses Objekt durchführen möchten. Um zum Beispiel SMS-Kampagnen aus Zoho Books abzurufen, klicken Sie auf Kontenplan und dann auf Kontenplan abrufen.
     2. Klicken Sie auf Verbinden.
        Es wird ein Fenster angezeigt, in dem Sie die Verbindungsdaten für Ihr Zoho Books-Konto eingeben. Geben Sie die folgenden Informationen in den Verbindungsassistenten ein:

        • Server URL : Geben Sie URL für den API-Server an, der Laufzeitaufrufe durchführt.
        • Token-Basis URL : Der Token-Wert URL im Verhältnis zum Server URL. Wählen Sie einen Server URL als Basis für das Token URL aus.
        • Organisations-ID: Geben Sie Ihre Organisations-ID an. In Zoho Books wird Ihr Unternehmen als eine Organisation bezeichnet. Sie können die Organisations-ID auf der Seite Organisationen verwalten in der Verwaltungskonsole abrufen.
        • Client-ID der Anwendung: Geben Sie die eindeutige Client-Kennung an, die für die Authentifizierung verwendet werden soll.
        • Anwendungs-Client-Geheimnis: Geben Sie das Client-Geheimnis an, das für die Authentifizierung verwendet werden soll.
        • Zugriffstoken: Das Zugriffstoken, das für den Zugriff auf die Zoho Books APIs verwendet wird.
        • Auffrischungs-Token: Geben Sie das Aktualisierungs-Token an, das aus der Client-ID der Anwendung und dem Client-Geheimnis generiert wird.
        • Selbstsignierte Zertifikate zulassen: Wählen Sie True oder False aus dem Dropdown-Menü.
        • Server- URL überschreiben : Erforderlich, wenn Sie mithilfe des privaten Netzwerkclients eine Verbindung zu einem Endpunkt in einem privaten Netzwerk herstellen möchten oder wenn Sie die Server- URL überschreiben möchten. Geben Sie einen Überschreibungswert für den Host und den Anschluss für den Anschluss im Format " <http or https>://<host_name>:<port> an. Wenn Sie den privaten Netzwerk-Client nicht verwenden oder keine Überschreibung benötigen, lassen Sie dieses Feld leer.
        • Proxy-Name : Wählen Sie den Namen des Proxys aus oder geben Sie ihn ein, den „ App Connect “ für die Weiterleitung der Connector-Aufrufe verwenden soll. Dieses Feld ist nur erforderlich, wenn Anrufe über einen Proxy geleitet werden müssen. Bei der Verwendung des „ IBM App Connect Enterprise “-Toolkits sollte der Proxy-Name in folgender Form angegeben werden: {PolicyProjectName}:HTTPProxyPolicyName
     3. Klicken Sie auf Verbinden.

     Weitere Informationen zum Ermitteln dieser Verbindungsdaten finden Sie unter „Verwendung von IBM App Connect mit Zoho Books“ in der Dokumentation zu Continuous Delivery (CD) unter IBM App Connect in containers.

6. Legen Sie die erforderlichen Verbindungseigenschaften im Assistenten fest.
   Sie können auch Eigenschaften festlegen, die die maximale Anzahl der abzurufenden Datensätze und die bei Überschreiten dieser Grenze zu ergreifenden Maßnahmen angeben.
7. Klicken Sie auf Speichern, wenn Sie die Eigenschaften im Assistenten für die Verbindungsfindung festgelegt haben.
   Die Anmeldedaten für die Verbindung zu Zoho Books werden im Tresor gespeichert, während die übrigen Verbindungsdaten in der Zoho Books-Richtlinie hinterlegt sind. Die Werte der Eigenschaften, die Sie im Assistenten festgelegt haben, werden an den Knoten „Zoho Books Request“ im „ IBM App Connect Enterprise -Toolkit “ zurückgegeben.
8. Wenn Sie die Suche abgeschlossen und die Eigenschaftswerte gespeichert haben, beenden Sie den Assistenten für die Verbindungssuche, indem Sie auf das X in der oberen rechten Ecke des Fensters klicken oder Alt+F4 drücken.
9. Zurück zur Bearbeitung des Knotens „Zoho Books-Anfrage“ im „ IBM App Connect Enterprise “-Toolkit.
   Die Konnektoreigenschaften, die im Assistenten für die Konnektorerkennung (Schritt 6) festgelegt wurden, sind nun im Eigenschaftseditor auf dem Knoten Zoho Books-Anfrage sichtbar. Auf der Registerkarte Basis werden die Werte der Aktions- und Objekteigenschaften angezeigt, die Sie im Assistenten festgelegt haben. Wenn Sie beispielsweise im Assistenten „Kontenplan > Kontenplan abrufen“ ausgewählt haben, werden auf der Registerkarte „Grundlegend“ des Knotens die folgenden Eigenschaften angezeigt:

   • Aktion - ' RETRIEVEALL
   • Objekt - ' getChartofaccounts_model

   Die Werte der Eigenschaften Aktion und Objekt werden in schreibgeschütztem Format angezeigt. Wenn Sie diese Werte ändern möchten, können Sie dies tun, indem Sie erneut auf Connector-Ermittlung starten klicken und im Assistenten für die Connector-Ermittlung neue Werte festlegen.

   Die Eigenschaft Schemabasisname gibt den Basisnamen der Schemadateien an, die das Format der Anfrage- und Antwortnachrichten beschreiben, die vom Zoho Books-Connector gesendet und empfangen werden. Der Schemabasisname wird automatisch festgelegt, wenn Sie die Ermittlung für den Knoten zum ersten Mal ausführen, und basiert auf dem aktuellen Flussnamen und dem Knotennamen. Wenn Sie diese Eigenschaft manuell einstellen, bevor Sie die Suche zum ersten Mal ausführen, wird der von Ihnen eingestellte Wert verwendet. Wenn Sie die Schemas nach der Ermittlung umbenennen, müssen Sie diese Eigenschaft so bearbeiten, dass sie mit dem Schemabasisnamen übereinstimmt, der von den umbenannten Schemas im Projekt verwendet wird. Wenn Sie diese Eigenschaft nach der Ermittlung ändern, müssen Sie entweder die Schemanamen umbenennen, damit sie übereinstimmen, oder die Ermittlung erneut durchführen.

   Abhängig von der Aktion, die während der Ermittlung ausgewählt wurde, generiert der Assistent für die Verbindungsermittlung entweder ein Anforderungsschema und ein Antwortschema oder nur ein Antwortschema. Ein Anforderungsschema wird nur erstellt, wenn die ausgewählte Aktion und das ausgewählte Objekt eine Anforderungsnachricht erfordern. Das generierte Anforderungsschema wird für die Validierung der Anforderungsnachricht verwendet. Wenn die Aktion " RETRIEVE oder " DELETE war, wird nur das Antwortschema vom Konnektor zurückgegeben.

   Die generierten Schemadateien werden dem Projekt hinzugefügt und können von einem Mapping-Knoten für die Transformation von Eingabe- oder Ausgabedaten verwendet werden. Der vollständige Dateiname des Schemas ergibt sich aus dem Basisnamen des Schemas (z. B. " gen/zohobooks.Zoho_Books_Request), dem entweder " response.schema.json oder " request.schema.json angehängt wird. Sie können das Schema öffnen, indem Sie auf Anforderungsschema öffnen oder Antwortschema öffnen klicken.

10. Überprüfen Sie, ob die Eigenschaftseinstellungen des Knotens " Zoho Books-Anfrage " korrekt sind, und speichern Sie dann den Nachrichtenfluss.
11. Auf der Registerkarte " Verbindung" des Knotens " Zoho Books-Anfrage " zeigt die Eigenschaft " Richtlinie" den Namen der Richtlinie an, die die Details der für die Verbindung zu verwendenden Sicherheitsidentität enthält. Die Police hat einen Typ von ' Zoho Books.
    Weitere Informationen finden Sie in den Nutzungsbedingungen von Zoho Books.
12. Optional: Legen Sie auf der Registerkarte " Verbindung" die Eigenschaft "Timeout" fest, um die Zeit (in Sekunden) anzugeben, die der Knoten auf die Verarbeitung des Vorgangs durch Zoho Books wartet.
13. Die Registerkarte " Filter des Knotens " Zoho Books Anfrage enthält Eigenschaften, die steuern, wie der Nachrichtenfluss die Daten auswählt. Die Anfangswerte dieser Eigenschaften werden von den Eigenschaftswerten übernommen, die für den Zoho Books-Connector im Assistenten für die Connector-Ermittlung festgelegt wurden, einschließlich der Eigenschaften der Filteroptionen und aller Bedingungen, die festgelegt wurden (wie in Schritt 6 beschrieben). Wenn Sie dann zum Assistenten für die Verbindungsfindung zurückkehren und die Werte von Eigenschaften ändern (z. B. durch Hinzufügen neuer Bedingungen), werden diese Aktualisierungen in den Eigenschaften des Knotens berücksichtigt.

    Die Eigenschaften der Filteroptionen steuern, welche Objekte bei der Ausführung des Zoho Books-Anfrageknotens bearbeitet werden sollen. Die Eigenschaften des Filterlimits steuern die maximale Anzahl der abzurufenden Elemente und die Aktion, die bei Überschreitung des Limits durchgeführt werden soll.

    Sie können die Werte ändern, indem Sie im Abschnitt Filteroptionen neben dem zu ändernden Wert auf Bearbeiten klicken und die im Abschnitt Filtergrenzen eingestellten Eigenschaftswerte ändern.

    Bei den Eigenschaftswerten kann es sich entweder um Textwerte oder um ESQL- oder XPATH-Ausdrücke handeln, die aus dem Inhalt der Nachricht aufgelöst werden, die bei der Ausführung an den Zoho Books Request-Knoten übergeben wird.

14. Legen Sie auf der Registerkarte " Anfrage" die Eigenschaft " Datenort" fest, um den Ort in der Struktur der eingehenden Nachricht anzugeben, der die in Zoho Books zu erstellenden Objektdaten enthält. Diese Daten bilden die Anfrage, die vom Zoho-Books-Anfrageknoten an das Zoho-Books-System gesendet wird.
15. Legen Sie auf der Registerkarte " Ergebnis" die Eigenschaft "Speicherort der Ausgabedaten " fest, um den Speicherort im Baum der Ausgabemeldung anzugeben, der die Daten des in Zoho Books erstellten Datensatzes enthalten soll.
16. Standardmäßig werden Anforderungsnachrichten anhand des Anforderungsschemas validiert, das während der Erkennung des Connectors erstellt wurde. Sie können die Validierung von Anfragen deaktivieren oder die Validierungseinstellungen ändern, indem Sie die Validierungseigenschaften des Knotens " Zoho Books Request" verwenden.
17. Speichern Sie den Nachrichtenfluss.