Verbindungen

Dieser Abschnitt hilft Ihnen beim Einrichten von Verbindungen, die für den Zugriff auf codierte Automatisierungs-APIs von Diensten aus erforderlich sind, die Verbindungen verwenden.

Um eine solche Verbindung einzurichten, erstellen Sie zunächst eine Verbindung im Integration Service. Die Verbindungen, die Sie im Integration Service erstellen, sind in der gleichen Organisation und im gleichen Mandanten wie die codierte Automatisierung zugänglich, in der Sie arbeiten. Sie können das connections -Objekt verwenden, um auf die Verbindungen zuzugreifen, die Sie zuvor im Integration Service erstellt haben, und dann auf die entsprechenden codierten Automatisierungs-APIs zugreifen.

Nachdem Sie die Automatisierung fertig gestellt und im Orchestrator veröffentlicht haben, haben Sie die Möglichkeit, die ursprünglichen Verbindungskonfigurationen, die Sie im Code vorgenommen haben, zu überschreiben.

Voraussetzungen

Erstellen Sie eine Verbindung im Integration Service:

1. Wechseln Sie zu Integration Service und navigieren Sie zu Connections.
2. Wählen Sie Verbindung hinzufügen aus und erstellen Sie eine Verbindung für eine der folgenden Anwendungen:
   • Google Drive
   • Gmail
   • Google Sheets

Schritte

1. Öffnen Sie eine vorhandene codierte Automatisierung von derselben Organisation und demselben Mandanten, wo Sie Ihre Verbindung ursprünglich erstellt haben.

2. Im Textkörper Execute() geben Sie connections ein und drücken Sie dann Strg + Leertaste, um die verfügbaren Verbindungen anzuzeigen.

   Je nach der Anwendung, für die Sie zuvor die connection erstellt haben, können Sie aus den folgenden Verbindungstypen wählen:

   • Drive
   • Gmail
   • GoogleSheets

3. Konfigurieren Sie Ihre Verbindung weiter, indem Sie den Namen des Orchestrator-Ordners und des Unterordners sowie die gewünschte Verbindungsadresse hinzufügen. Verwenden Sie Unterstreichungen, um diese Informationen zu trennen.

   Beispielsweise würde eine Gmail-Verbindung für den Ordner My Workspace und den Unterordner My Gmail Worskapce im Orchestrator sowie für die Adresse [e-mail] im Code geschrieben werden als: connections.Gmail.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com.

Empfehlung

Es wird empfohlen, Ihre Verbindungen in einem Schritt zu erstellen, um potenzielle Fehler zu vermeiden. Es wird auch empfohlen, eine Variable für die Verbindung zu erstellen. So vermeiden Sie, dass jede Instanz der Verbindung in Ihrer Automatisierung aktualisiert wird, wenn Änderungen im Integration Service erfolgen. Verwenden Sie den folgenden Ansatz:

var myGmailConnection = connections.Gmail.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com;

Vermeiden Sie das Erstellen Ihrer Verbindungen in zwei separaten Schritten:

var myGmailConnection = connections.Gmail;
myGmailConnection.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com;

4. Sobald Sie die connection festgelegt haben, können Sie über diese connection auf die relevanten codierten Automatisierungs-APIs zugreifen, die für einen Dienst spezifisch sind.

   Wenn Sie beispielsweise eine Gmail-Verbindung mit var myGmailConnection = connections.Gmail.My_Workspace_john_doe_gmail.com eingerichtet haben, können Sie die codierte Automatisierungs-API des Dienstes mit myGmailConnection verwenden.

Überschreiben der Verbindung im Orchestrator

1. Veröffentlichen Sie Ihr Projekt im Orchestrator.
2. Wechseln Sie zum Orchestrator-Feed, in dem Sie das Projekt veröffentlicht haben.
3. Wechseln Sie zum veröffentlichten Prozess und wählen Sie Bearbeiten aus.
4. Wählen Sie in der Prozesskonfiguration die codierte Automatisierung aus, die Ihre konfigurierte Verbindung als Einstiegspunkt enthält.
5. Suchen Sie in den Paketanforderungen den entsprechenden Verbindungstyp für Ihre codierte Automatisierung und wählen Sie ihn aus. Achten Sie darauf, den Verbindungstyp für Ihre codierte Automatisierung auszuwählen, da auch Verbindungen für XAML-Dateien in Ihrem Projekt in der Liste angezeigt werden.
6. Ermitteln Sie die Kontoadresse, die Sie mit der Verbindung bei der Ausführung assoziieren möchten, und wählen Sie sie aus.