La tâche Firestore – Document Get vous permet de récupérer le contenu d'un seul document Firestore. Par défaut, la tâche Firestore – Document Get récupère le dernier instantané de document de votre base de données Firestore.
Conçu pour le scaling automatique et les hautes performances, Firestore est une base de données de documents NoSQL qui simplifie le développement d'applications.
Avant de commencer
Effectuez les tâches suivantes dans votre projet Google Cloud avant de configurer la tâche Firestore – Document Get :
- Activez l'API Cloud Firestore (
firestore.googleapis.com). -
Créez un profil d'authentification. Apigee Integration se connecte à un point de terminaison d'authentification à l'aide d'un profil d'authentification pour la tâche Firestore - Document Get.
Pour en savoir plus sur l'attribution de rôles ou d'autorisations supplémentaires à un compte de service, consultez la section Attribuer, modifier et révoquer les accès.
Configurer la tâche Firestore – Document Get
- Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
- Cliquez sur Développer > Intégrations.
- Sélectionnez une intégration existante ou créez-en une en cliquant sur Créer une intégration.
Si vous créez une intégration :
- Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
- Dans la liste des régions compatibles, sélectionnez une région pour l'intégration.
- Cliquez sur Créer.
La page de conception d'intégration s'affiche.
- Dans la barre de navigation de la page de conception d'intégration, cliquez sur +Ajouter une tâche ou un déclencheur > Tâches pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément Firestore - Document Get et placez-le dans le concepteur d'intégration.
- Cliquez sur l'élément Firestore – Document Get dans le concepteur pour ouvrir le volet de configuration de la tâche Firestore – Document Get.
- Accédez à Authentification, puis sélectionnez un profil d'authentification existant que vous souhaitez utiliser.
Facultatif. Si vous n'avez pas créé de profil d'authentification avant de configurer la tâche, cliquez sur + Nouveau profil d'authentification et suivez les étapes mentionnées dans la section Créer un profil d'authentification.
- Accédez à l'Entrée de la tâche et configurez les champs d'entrée affichés à l'aide du tableau Paramètres d'entrée de la tâche suivant.
Les modifications apportées aux champs d'entrée sont enregistrées automatiquement.
Paramètres d'entrée de la tâche
Le tableau suivant décrit les paramètres d'entrée de la tâche Firestore – Document Get :
| Propriété | Type de données | Description |
|---|---|---|
| Région | String | Emplacement de la base de données Firestore. Par exemple, us-central1. |
| ProjectsId | Chaîne | L'ID de votre projet Google Cloud. |
| DatabasesId | String | ID de la base de données Firestore. |
| DocumentsId | String | Chemin d'accès ou emplacement du document Firestore. |
Pour plus d'informations sur les paramètres de requête facultatifs disponibles, consultez la section Paramètres de requête.
Résultat de la tâche
La tâche Firestore – Document Get renvoie les données du document au format encodé en base64. Vous devez décoder la valeur encodée en base64 pour obtenir la chaîne de sortie.
Stratégie de traitement des erreurs
Une stratégie de traitement des erreurs d'une tâche spécifie l'action à effectuer si celle-ci échoue en raison d'une erreur temporaire. Pour en savoir plus sur l'utilisation et les différents types de stratégies de traitement des erreurs, consultez la page Stratégies de traitement des erreurs.
Étapes suivantes
- Ajoutez des arêtes et conditions d'arêtes.
- Testez et publiez votre intégration.
- Configurez un déclencheur.
- Ajoutez une tâche de mappage de données.
- Consultez toutes les tâches des services Google Cloud.