Après avoir installé votre complément et vous être connecté à votre compte Octoboard, vous pouvez commencer à travailler avec les requêtes de données.
Pour ajouter une requête, utilisez l'option Nouvelle requête de la liste déroulante des requêtes indiquée ci-dessous :
Lorsqu'elle est ajoutée pour la première fois, la requête ne pourra pas s'exécuter ni récupérer de données, car elle nécessitera une configuration supplémentaire telle qu'une connexion de données valide. Après avoir ajouté une connexion, vous pourrez configurer les paramètres de la requête.
L'interface vous informera si certains paramètres sont manquants. Suivez les instructions à l'écran pour ajouter les options de configuration requises. Dans cet exemple, la nouvelle requête nécessite la définition d'une connexion avant de pouvoir être exécutée :
Une fois que vous avez créé une requête, elle apparaîtra à deux endroits dans l'interface.
Tout d'abord, vous pouvez voir toutes les requêtes dans le contrôle déroulant affiché sur cette capture d'écran :
Vous pouvez utiliser le contrôle déroulant pour trouver des requêtes et sélectionner n'importe quelle requête à laquelle vous avez accès. Si une requête n'appartient pas à votre organisation Octoboard, elle sera marquée en lecture seule. Vous la verrez toujours dans le contrôle déroulant, mais une image d'avertissement sera affichée à côté du nom de la requête.
Deuxièmement, vous pouvez voir toutes vos requêtes dans l'onglet OctoboardQueries du document Google Sheets.
L'onglet OctoboardQueries doit d'abord être créé. Pour créer l'onglet, sélectionnez l'option Gérer les requêtes dans le menu du document Google Sheets, comme indiqué ci-dessous :
Si vous avez un document Google Sheets avec plusieurs requêtes existantes, vous pouvez sélectionner une requête à modifier de l'une des manières suivantes :
Sélectionnez une requête dans le contrôle déroulant comme expliqué précédemment. Une fois que vous avez sélectionné une requête, les contrôles complémentaires seront remplis avec les paramètres de configuration de la requête que vous pouvez commencer à modifier.
Vous pouvez également sélectionner une requête pour la modifier en trouvant les données de la requête dans le document Google Sheets et en cliquant sur n'importe quelle cellule de données de cette requête. Une fois que vous avez fait cela, le complément affichera un message vous demandant de confirmer la sélection de la requête :
Cliquez sur le bouton CHARGER LA REQUÊTE pour confirmer la sélection de la requête.
Enfin, vous pouvez sélectionner une requête en cliquant sur une ligne de requête dans l'onglet OctoboardQueries. Vous serez à nouveau invité à confirmer votre sélection comme indiqué sur la capture d'écran suivante :
Si vous confirmez la nouvelle sélection de requête tout en modifiant une requête existante dans le complément, toutes les modifications apportées à la requête existante (le cas échéant) seront ignorées.
Une fois que vous avez configuré une requête, vous pouvez l'exécuter (exécuter la requête et récupérer des données à partir de la connexion sélectionnée). Pour ce faire, sélectionnez une cellule dans votre document Google Sheets et cliquez sur le lien EXÉCUTER indiqué ci-dessous :
Vous pouvez continuer à modifier et à exécuter la requête jusqu'à ce que vous obteniez la configuration de requête qui vous convient. Une fois satisfait des résultats, vous pouvez enregistrer la requête en utilisant l'option ENREGISTRER. Une requête n'est pas ajoutée au système tant qu'elle n'est pas enregistrée. Vous serez invité à enregistrer votre requête après chaque exécution réussie, comme indiqué ici :
Il existe plusieurs options qui vous aideront à organiser vos requêtes et à récupérer des données. Utilisez les liens sous le contrôle déroulant des requêtes pour accéder à des fonctionnalités telles que le renommage de requête, la suppression, l'annulation des modifications et d'autres fonctionnalités.
Toutes les requêtes que vous créez peuvent être exécutées et mises à jour automatiquement par le système à intervalles réguliers. Pour configurer des mises à jour planifiées, utilisez l'onglet Planification de l'extension.
Les requêtes peuvent être exécutées toutes les heures, tous les jours, toutes les semaines ou tous les mois à l'heure configurée. Comme indiqué dans l'interface, l'exécution d'une requête à une heure précise ne peut pas être garantie car cela dépendra de la charge sur le système.