Avec une solution connectée Workiva, il y a plusieurs façons de mettre à jour les données dans une feuille de calcul Workiva. Lors de l'utilisation de Wdata, une connexion entrante peut être créée pour rafraîchir les données d'une feuille de calcul à partir d'une requête Wdata. Dans cet article, nous explorons l'utilisation des chaînes pour mettre à jour les données d'une feuille de calcul à l'aide des commandes Write Sheet Data et Overwrite Sheet Data.
Entrées de commande communes
Les commandes d'écriture de données de feuilles et d'écrasement de données de feuilles ont plusieurs entrées qui sont les mêmes pour les deux commandes.
Écrire les données de la feuille
La commande d'écriture des données de la feuille est utilisée de préférence lorsqu'il s'agit de mettre à jour des régions spécifiques d'une feuille tout en préservant les données dans d'autres régions de la feuille. Le tableau suivant décrit le comportement d'effacement pour chaque format de région spécifié.
| Mettre en forme | Exemple | Effet |
| Adresse d'une seule cellule | B2 |
Mise à jour d'une seule cellule de la feuille, sans impact sur les valeurs des autres cellules. Ce format est non recommandé à moins d'écrire la valeur d'une seule cellule. Si le fichier de données contient plus d'un seul point de données, la commande échouera lors de l'utilisation de ce format. |
| Adresse de la cellule de départ, pas de cellule ou de colonne de fin | B2: |
Mise à jour de la feuille à partir de l'adresse de la cellule de départ. Les valeurs de la feuille situées à gauche (colonne) et au-dessus (ligne) de l'adresse de la cellule de départ sont conservées ; toutes les autres valeurs sont effacées, même si le fichier de données ne contient pas de valeurs de cellule dans la ligne ou la colonne. |
| Adresse de la cellule de départ, colonne de fin sans ligne de fin | B2:D |
Mise à jour de la feuille à partir de l'adresse de la cellule de départ. Les valeurs de la feuille situées à gauche (colonne) et au-dessus (ligne) de l'adresse de la cellule de départ sont conservées ; toutes les autres valeurs sont effacées, même si le fichier de données ne contient pas de valeurs de cellule dans la ligne ou la colonne. |
| Adresse de la cellule de départ, adresse de la cellule d'arrivée | B2:D5 |
Remplace toutes les cellules de la plage spécifiée. Note: Si la plage spécifiée dans la commande est plus petite (moins de lignes ou de colonnes) que le fichier de données en cours de chargement, la commande échouera. |
Effacer les données de la feuille
La commande d'écrasement des données de la feuille est utilisée de préférence lorsqu'il faut effacer un bloc entier dans une feuille. Le tableau suivant décrit le comportement d'effacement pour chaque format de cellule de départ spécifié.
| Mettre en forme | Exemple | Effet |
| Adresse d'une seule cellule | B2 |
Les valeurs de la feuille situées à gauche (colonne) et au-dessus (ligne) de l'adresse de la cellule de départ sont conservées ; toutes les autres valeurs de la feuille sont effacées et les données du fichier de données sont écrites à partir de l'adresse de la cellule spécifiée. |
| Adresse de la cellule de départ, pas de cellule ou de colonne de fin | B2: |
Les valeurs de la feuille situées à gauche (colonne) et au-dessus (ligne) de l'adresse de la cellule de départ sont conservées ; toutes les autres valeurs de la feuille sont effacées et les données du fichier de données sont écrites à partir de l'adresse de la cellule spécifiée. |
| Adresse de la cellule de départ, colonne de fin sans ligne de fin | B2:D |
Ce format n'est pas pris en charge par et entraînera une erreur d'exécution de la commande. |
| Adresse de la cellule de départ, adresse de la cellule d'arrivée | B2:D5 |
Les valeurs de la feuille situées à gauche (colonne) et au-dessus (ligne) de l'adresse de la cellule de départ sont conservées ; toutes les autres valeurs de la feuille sont effacées et les données du fichier de données sont écrites à partir de l'adresse de la cellule spécifiée. La largeur (colonnes) et la hauteur (lignes) du fichier de données ne sont pas pertinentes. |
Essayez-le
Un modèle de chaîne et une feuille de calcul de test ont été créés pour vous permettre de voir les résultats de chacun des formats de cellule de départ/région ci-dessus. A tester :
- Téléchargez la feuille de calcul de test à partir de ce lien (25 KB) et importez dans votre espace de travail.
- Créer une chaîne de test en utilisant Utiliser les chaînes pour mettre à jour une feuille de calcul Workiva Modèle trouvé dans 4. Quick Start Guides -> Enablement & Usage Examples Dossier Template.
- Il est recommandé de faire correspondre l'ID de la feuille de calcul à la variable de modèle et à la variable de chaîne .
- Mettez à jour l'ID de la feuille de calcul Variable de la chaîne avant d'exécuter la chaîne dans votre espace de travail.
- Assurez-vous que l'utilisateur de la connexion de Workiva Chains dispose de file:write scope et que l'utilisateur a été assigné à la feuille de calcul importée.
- Exécutez la chaîne et examinez les résultats. Les résultats attendus sont décrits sur la feuille Expected Results de la feuille de calcul importée.