/

Verbindungen

Verbindungen werden verwendet, um Zoho Books mit Drittanbietern zu verbinden, um authentifizierte Daten zu erhalten. Um eine Verbindung einzurichten, müssen Sie einen Verbindungsnamen, einen AuthentifizierungsTyp sowie weitere Angaben angeben. In Zoho Books können Sie mehrere Verbindungen erstellen.

AUF DIESER SEITE

Verbindungen einrichten

Sie können eine Verbindung im Deluge-Editor-Seiten einrichten. So geht es:

  • Gehe zu der Deluge-Editor-Seite, auf der du ein neues benutzerdefiniertes Skript erstellen möchtest.
  • Klicke im oberen rechten Bereich des Editors auf Verbindungen.
  • Klicke in dem folgenden Popup auf Zu Verbindungen gehen.
  • Du wirst zur Seite Verbindungen erstellen weitergeleitet.
  • Wenn du bereits Verbindungen erstellt hast, erscheint die Liste aller verbundenen Anwendungen auf der folgenden Seite. Um eine neue Verbindung zu erstellen, klicke auf das +-Symbol neben Verbindungen hinzufügen im oberen rechten Bereich der Seite.
  • Von dort kannst du den Typ der Verbindung auswählen, den du erstellen möchtest.

Einblick: Die Verbindungsoption ist derzeit in benutzerdefinierten Funktionen, benutzerdefinierten Buttons und Planern in Zoho Books verfügbar.


Arten von Verbindungen

Es gibt zwei Arten von Verbindungen in der Seite „Verbindungen erstellen“:

  • Vordefinierte Verbindungen
  • Benutzerdefinierte Verbindungen

Vordefinierte Verbindungen

Die vordefinierten Verbindungen findest du im Tab Deine Dienstleistung wählen. Vordefinierte Verbindungen sind die Drittanbieter, mit denen Zoho Books bereits verbunden ist. Du musst hierfür nur die grundlegenden Angaben eingeben, die zur Einrichtung der Verbindung erforderlich sind.

Vordefinierte Verbindungen erstellen

  • Gehe zu der Deluge-Editor-Seite.
  • Klicke im oberen rechten Bereich des Editors auf Verbindungen.
  • Klicke auf Zu Verbindungen gehen.
  • Wählen Sie die Anwendung aus, mit der Sie verbinden möchten, im Tab Deine Dienstleistung wählen.
Vordefinierte Verbindungen
  • Gib den Verbindungsnamen ein, den du verwenden möchtest.
  • Wähle den Zweck aus, wenn erforderlich, abhängig von den Voraussetzungen der Anwendung.
Neue vordefinierte Verbindung
  • Aktiviere die Option Anmeldedaten des Anwenders verwenden, wenn du möchtest, dass jeder Benutzer seine eigenen Anmeldedaten verwendet, um das Skript auszuführen. Deaktiviere diese Option, wenn du möchtest, dass alle Benutzer deiner Organisation die Anmeldedaten des Benutzers verwenden, der die Verbindung erstellt und authentifiziert hat.

  • Klicke auf Erstellen und Verbinden.

  • Erscheint eine Anmeldeseite oder eine Seite, die zusätzliche Informationen erfordert.

  • Erlaube dem Verbindungssystem den Zugriff.


Custom Connections

Anpassbare Verbindungen können im Benutzerdefinierte Dienst-Tab gefunden werden. Wenn Sie mit anderen Drittanbieter-Diensten verbinden möchten, die nicht in der Kategorie „Pick Your Service“ aufgelistet sind, können Sie diese im Bereich Benutzerdefinierte Dienste erstellen. Sie müssen dabei bestimmte Angaben wie den Authentifizierungs-Typ, die Authentifizierungs-Spezifikationen und den Verbindungs-Namen der Anwendung eingeben, die verbunden werden soll.

Anpassbare Verbindungen erstellen

Um eine Verbindung zu einem Benutzerdefinierten Dienst zu erstellen, müssen Sie folgende Schritte durchführen (unter der Annahme, dass OAuth 2 als Authentifizierungsprotokoll verwendet wird):

  • Ein OAuth-Klient in Zoho Accounts registrieren
  • Eine Verbindung mit den Details des neu registrierten Clients erstellen
OAuth-Klient registrieren:

Ein neuer OAuth-Klient kann im Developer-Console registriert werden. Die Schritte zur Registrierung des Clients werden im Hilfe dokument bereitgestellt. Während der Registrierung wird Ihnen eine Umleitung (redirect URL) gefragt. Geben Sie bitte die folgende URL ein: https:/deluge.zoho.com/delugeauth/callback.

Verbindung erstellen:

Sobald ein Klient registriert wurde, müssen Sie zum Benutzerdefinierte Dienst-Tab wechseln und die erforderlichen Angaben eingeben, um die Verbindung zu erstellen:

FelderBeschreibung
DienstnameDer Name des Diensts, zu dem Sie verbinden möchten.
AuthentifizierungsartDas Protokoll, das für die Authentifizierung verwendet wird.
Param-TypDer Authentifizierungsparameter, der während der API-Aufrufe bei der Verbindung hinzugefügt wird.
Client-IDDie eindeutige Identifikation des Clients. Dies kann bei der Registrierung des Clients abgerufen werden.
Client-SecretEin Geheimnis, das vom OAuth-Klienten verwendet wird, um sich beim Autorisierungs-Server zu authentifizieren. Dies kann bei der Registrierung des Clients abgerufen werden.
Authorisierungs-URLDie URL der Seite, die die ausgewählten Berechtigungen auflistet. Diese Seite fordert den Benutzer auf, die Berechtigung zu erteilen, um den Zugriff auf die Benutzerdaten zu delegieren.
Access-Token-URLDie URL, die verwendet wird, um Access-Tokens aus Refresh-Tokens zu generieren.
Refresh-Token-URLDie URL, die verwendet wird, um Refresh-Tokens zu generieren.
VerbindungsnamenDer Name der Verbindung. Der Linkname wird aus dem Verbindungsnamen abgeleitet und wird anschließend in benutzerdefinierten Skripten verwendet.
BerechtigungenDie von Ihnen angeforderten Berechtigungen an den Drittanbieter-Dienst. Sie müssen eine durch Komma getrennte Liste der OAuth-Berechtigungen des Drittanbieter-Apps angeben. Es ist die Liste der Aktionen, die Sie zugreifen möchten.
Neue anpassbare Verbindung
  • Aktivieren Sie die Option Benutzeranmeldedaten verwenden, wenn Sie möchten, dass jeder Benutzer seine eigenen Anmeldedaten verwendet, um das Skript auszuführen. Deaktivieren Sie diese Option, wenn Sie möchten, dass alle Benutzer Ihrer Organisation die Anmeldedaten des Benutzers verwenden, der die Verbindung erstellt und authentifiziert hat.
  • Nach Eingabe aller Angaben klicken Sie auf Erstellen und Verbinden.
  • Ein Popup-Fenster mit der in der Verbindung angegebenen Authorisierungs-URL öffnet sich und fordert die Berechtigungen des Drittanbieter-Apps nach den spezifizierten Berechtigungen an.
  • Klicken Sie auf Akzeptieren, um die Berechtigung zu erteilen.

Die Verbindung wurde nun authentifiziert und ist bereit zum Gebrauch.


Verwendung von Verbindungen in benutzerdefinierten Skripten

Sobald eine Verbindung vom Administrator authentifiziert wurde, kann sie in benutzerdefinierten Skripten verwendet werden. Auf der Seite mit den Verbindungsdetails, wo die Verbindungen erstellt wurden, finden Sie einen Code-Auszug, der zeigt, wie diese Verbindung verwendet werden kann, um mit dem Drittanbieter-Dienst zu kommunizieren.

Code Snippet Sie können diesen Codeausschnitt an den entsprechenden Stellen im deluge-Skript kopieren und einfügen. Deluge

Hat dieses Dokument Ihnen geholfen?
Ja
Nein

Vielen Dank für Ihre Rückmeldung!