Weitere Informationen finden Sie unter Unterstützte Connectors für Application Integration.

Aufgabe „Firestore – Dokument abrufen“

Vorschau

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Mit der Aufgabe Firestore – Dokument abrufen können Sie den Inhalt eines einzelnen Firestore-Dokuments abrufen. Standardmäßig wird mit der Aufgabe Firestore – Dokument abrufen der neueste Dokument-Snapshot aus Ihrer Firestore-Datenbank abgerufen.

Firestore ist eine NoSQL-Dokumentdatenbank, die auf Autoscaling, hohe Leistung und einfache Anwendungsentwicklung ausgelegt ist.

Hinweise

Führen Sie die folgenden Aufgaben in Ihrem Google Cloud-Projekt aus, bevor Sie die Aufgabe Firestore – Dokument abrufen konfigurieren:

1. Cloud Firestore API aktivieren (firestore.googleapis.com).

   Cloud Firestore API aktivieren

2. Authentifizierungsprofil erstellen. Application Integration verwendet ein Authentifizierungsprofil, um eine Verbindung zu einem Authentifizierungsendpunkt für die Aufgabe Firestore – Document Get (Firestore – Dokumentabruf) herzustellen.

   Informationen zum Zuweisen zusätzlicher Rollen oder Berechtigungen für ein Dienstkonto finden Sie unter Zugriff auf Ressourcen erteilen, ändern und entziehen.

Die Aufgabe „Firestore – Dokument abrufen“ konfigurieren

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zu „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrationen.

   Die Seite Integrationen wird angezeigt. Dort sind alle Integrationen aufgeführt, die im Google Cloud-Projekt verfügbar sind.

3. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration erstellen, um eine neue zu erstellen.

   Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

   1. Geben Sie im Bereich Integration erstellen einen Namen und eine Beschreibung ein.
   2. Wählen Sie eine Region für die Integration aus.
      Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
   3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit in der Symbolleiste der Verknüpfung im Bereich Integrationsübersicht ändern oder aktualisieren.
      Hinweis: Die Option zum Auswählen eines Dienstkontos wird nur angezeigt, wenn Sie die Integrationsverwaltung für die ausgewählte Region aktiviert haben.
   4. Klicken Sie auf Erstellen.

   Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Aufgaben, um die Liste der verfügbaren Aufgaben und Connectors aufzurufen.
5. Klicken Sie auf das Element Firestore – Dokument abrufen und platzieren Sie es im Integrationseditor.
6. Klicken Sie im Designer auf das Element Firestore – Dokument abrufen, um den Konfigurationsbereich der Aufgabe Firestore – Dokument abrufen aufzurufen.
7. Rufen Sie die Authentifizierung auf und wählen Sie ein vorhandenes Authentifizierungsprofil aus, das Sie verwenden möchten.

   Optional. Wenn Sie vor der Konfiguration der Aufgabe kein Authentifizierungsprofil erstellt haben, klicken Sie auf + Neues Authentifizierungsprofil und folgen Sie der Anleitung unter Neues Authentifizierungsprofil erstellen.

8. Wechseln Sie zu Aufgabeneingabe und konfigurieren Sie die angezeigten Eingabefelder mit der folgenden Tabelle Aufgabeneingabeparameter.

   Änderungen an den Eingabefeldern werden automatisch gespeichert.

Aufgabeneingabeparameter

In der folgenden Tabelle werden die Eingabeparameter der Aufgabe Firestore – Dokument abrufen beschrieben:

Attribut	Datentyp	Beschreibung
Region	String	Speicherort der Firestore-Datenbank. Beispiel: us-central1.
ProjectsId	String	Ihre Google Cloud-Projekt-ID.
DatabasesId	String	ID der Firestore-Datenbank.
DocumentsId	String	Pfad oder Speicherort des Firestore-Dokuments. Gültiges Format: document/collection. Beispiel: users/alovelace. Weitere Informationen finden Sie unter Firestore-Datenmodell.

Aufgabenausgabe

Die Aufgabe Firestore – Dokument abrufen gibt die Dokumentdaten im base64-codierten Format zurück. Für den Ausgabestring müssen Sie den base64-codierten Wert decodieren.

Tipp: Sie können Daten mit dem base64-Befehl unter Linux bzw. macOS oder dem Base64.exe-Befehl unter Windows mit base64 codieren oder decodieren. Programmier- und Skriptsprachen enthalten in der Regel Bibliotheken für die base64-Codierung. Beispiele für Befehlszeilen zu base64 decodieren finden Sie in der Cloud Text-to-Speech-Dokumentation.

Fehlerbehebungsstrategie

Eine Strategie zur Fehlerbehandlung für eine Aufgabe legt die Aktion fest, die ausgeführt werden soll, wenn die Aufgabe aufgrund eines temporären Fehlers fehlschlägt. Informationen zur Verwendung einer Fehlerbehandlungsstrategie und zu den verschiedenen Arten von Fehlerbehandlungsstrategien finden Sie unter Strategien zur Fehlerbehebung.

Kontingente und Limits

Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.

Nächste Schritte

• Edges und Edge-Bedingungen hinzufügen
• Integration testen und veröffentlichen
• Trigger konfigurieren
• Aufgabe „Datenabgleich“ hinzufügen
• Alle Aufgaben für Google Cloud-Dienste ansehen