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
- Arten von Verbindungen
- Vordefinierte Verbindungen
- Benutzerdefinierte Verbindungen
- Verbindungen in benutzerdefinierten Skripten verwenden
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.

- Gib den Verbindungsnamen ein, den du verwenden möchtest.
- Wähle den Zweck aus, wenn erforderlich, abhängig von den Voraussetzungen der Anwendung.

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:
| Felder | Beschreibung |
|---|---|
| Dienstname | Der Name des Diensts, zu dem Sie verbinden möchten. |
| Authentifizierungsart | Das Protokoll, das für die Authentifizierung verwendet wird. |
| Param-Typ | Der Authentifizierungsparameter, der während der API-Aufrufe bei der Verbindung hinzugefügt wird. |
| Client-ID | Die eindeutige Identifikation des Clients. Dies kann bei der Registrierung des Clients abgerufen werden. |
| Client-Secret | Ein Geheimnis, das vom OAuth-Klienten verwendet wird, um sich beim Autorisierungs-Server zu authentifizieren. Dies kann bei der Registrierung des Clients abgerufen werden. |
| Authorisierungs-URL | Die 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-URL | Die URL, die verwendet wird, um Access-Tokens aus Refresh-Tokens zu generieren. |
| Refresh-Token-URL | Die URL, die verwendet wird, um Refresh-Tokens zu generieren. |
| Verbindungsnamen | Der Name der Verbindung. Der Linkname wird aus dem Verbindungsnamen abgeleitet und wird anschließend in benutzerdefinierten Skripten verwendet. |
| Berechtigungen | Die 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. |

- 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.
Sie können diesen Codeausschnitt an den entsprechenden Stellen im deluge-Skript kopieren und einfügen.
