Le modèle Load Data to Wdata introduit des données dans une table Wdata en remplaçant un ensemble de données existant ou en en ajoutant un nouveau. Ce modèle est le plus souvent utilisé dans le cadre d'une chaîne existante, mais il peut être ajouté à tout flux de travail nécessitant le téléchargement d'un jeu de données dans une table.
Exigences
- La table Wdata cible doit être créée avant d'exécuter cette chaîne.
- Ce modèle est composé de trois chaînes. Chaque chaîne doit être publiée séparément dans votre espace de travail.
- Le nom du fichier doit comporter une extension .csv ou .tsv. Par exemple : "Nom_de_fichier_Exemple.csv" : "Nom_de_fichier_Exemple.csv".
- La taille maximale recommandée pour un jeu de données est de 300 mégaoctets. En savoir plus sur les recommandations relatives à la taille des fichiers.
Trouver le modèle
Le modèle Load Data to WData se trouve dans la section Workiva Chains de l'écran Templates.
Voici comment le trouver :
- Dans Chain Builder, allez dans l'onglet Templates .
- Sélectionnez Workiva Chains dans le menu du haut.
- Recherchez Load Data to Wdata | Primary Chain en haut à droite et ouvrez le modèle.
-
Après avoir localisé le modèle, cliquez sur New Chain pour le déployer dans votre espace de travail.
Note : Une fois configurée, chaque chaîne de ce modèle doit être publiée dans l'espace de travail.
Configurer le modèle
Ce modèle se compose de trois chaînes : la chaîne primaire, une chaîne de remplacement des données et une chaîne d'ajout de nouvelles données. Lorsque la chaîne primaire est déployée dans votre espace de travail, les deux chaînes enfants (Ajouter/Remplacer) sont automatiquement déployées avec elle.
Voici un examen plus approfondi de chaque chaîne :
- Chaîne primaire: Cette chaîne détermine s'il existe un jeu de données dans votre table qui porte le même nom que le jeu de données chargé par la chaîne. Si un jeu de données correspondant est trouvé, la chaîne capture des informations sur le jeu de données correspondant et, en fonction de l'entrée d'exécution "Méthode de chargement" que vous avez configurée pour la chaîne parentale, redirige ces données vers l'une des deux chaînes enfant.
-
Chaîne de remplacement des données: Cette chaîne supprime l'ensemble de données correspondant de votre table et le remplace par un nouveau. Si une erreur se produit pendant l'exécution et que l'option de retour en arrière est sélectionnée, la chaîne supprimera automatiquement le nouveau jeu de données et reviendra au jeu de données qui devait être remplacé.
-
Chaîne d'ajout d'un nouveau jeu de données: Cette chaîne crée un nouveau jeu de données et l'importe dans votre table. Le nouveau jeu de données doit avoir un nom de fichier unique qui n'est pas utilisé actuellement par d'autres jeux de données dans le tableau.
Lors de l'ajout de cet ensemble de chaînes à une chaîne existante, les entrées d'exécution de la chaîne primaire doivent être configurées dans le nœud "Run Chain". Les chaînes enfants ne nécessitent aucune modification ou configuration.
Vos paramètres devraient ressembler à ceci :
Variables
| Type | Nom | Objectif |
| Variable de l'espace de travail | wsv-WdataLoadWarningThreshold (seuil d'avertissement pour la charge de données) |
Cette variable agit comme une limite souple sur la taille du fichier de votre ensemble de données. Tout ensemble de données dépassant le seuil choisi déclenchera un avertissement. Le temps de traitement augmentant avec la taille du fichier, les petits ensembles de données peuvent être traités beaucoup plus rapidement. La taille de fichier recommandée indique clairement que votre ensemble de données peut approcher la limite de taille de fichier de Wdata. Lorsqu'un avertissement est déclenché, vous pouvez envisager de remanier votre fichier ou d'explorer d'autres options pour tenir compte du fichier plus volumineux. Taille de fichier recommandée: 150MB-200MB |
| Variable chaîne dynamique | Résultat de la chaîne dcv | Il permet de connaître l'état de la chaîne à différents stades. Cette disposition est obligatoire et ne doit pas être modifiée. |
Entrées en cours d'exécution
| Entrée de durée d’exécution | Objectif | Type de champ | Obligatoire |
| ID du tableau |
Saisissez l'ID de la table Wdata vers laquelle le jeu de données sera téléchargé. Cet identifiant sera également utilisé pour déterminer s'il existe des ensembles de données en double dans la table. Nous recommandons d'utiliser des variables d'espace de travail pour stocker l'ID de la table, ce qui permet d'utiliser le modèle dans plusieurs processus. |
Texte | Oui |
| Nom du fichier |
Le nom du jeu de données qui sera importé dans la table Wdata. Le nom du fichier indique à la chaîne les données à remplacer. Les exigences en matière de nom de fichier varient en fonction de la chaîne sélectionnée :
Note: Le nom du fichier doit inclure l'extension .csv ou .tsv. Par exemple : "Nom_de_fichier_Exemple.csv" |
Texte | Oui |
| Fichier de données |
Le fichier de données qui sera importé dans le tableau. L'extension doit être .csv ou .tsv. Note: Le fichier de données peut utiliser n'importe quel délimiteur de table Wdata pris en charge. |
Fichier | Oui |
| Méthode de chargement |
Détermine si le fichier doit remplacer un jeu de données existant ou être ajouté en tant que nouveau jeu de données. Options :
|
Menu déroulant |
Oui |
| Retour en arrière |
En cas d'erreur, les modifications sont annulées et l'ensemble de données original est réimporté. La valeur par défaut est True. Uniquement applicable à la méthode de chargement Remplacer le jeu de données. |
Booléen (Vrai/Faux) |
Non |
Dépannage
Pour consulter l'historique de l'exécution de la chaîne, y compris les erreurs :
- Allez sur l'onglet Monitor dans Chain Builder.
-
Survolez le point d'interrogation pour afficher l'état de l'exécution de la chaîne.
Si votre chaîne a déclenché une erreur ou n'a pas mis à jour les données correctes, procédez aux vérifications suivantes :
- Vérifiez que les trois chaînes ont été publiées dans votre espace de travail. Chaque chaîne doit être publiée séparément.
- Assurez-vous que votre jeu de données utilise un délimiteur pris en charge et que le nom du fichier comporte une extension .csv ou .tsv ("Nom_de_fichier_Exemple.csv").
- Lorsque vous utilisez la méthode de chargement Replace Dataset, vérifiez que le nom du fichier correspond au nom du fichier existant dans votre table Wdata. S'il ne correspond pas, la chaîne ajoutera simplement un nouveau fichier à votre tableau sans remplacer l'ancien.
- Inversement, lorsque vous utilisez la méthode de chargement Add New Dataset, vérifiez que le nom du fichier n'est pas utilisé ailleurs dans la table Wdata. La chaîne échouera si un nom de fichier se chevauchant est utilisé.
- Assurez-vous que la subvention OAuth2 associée à la connexion Workiva dispose d'un accès approprié.
- Lors de la saisie de l'ID du tableau, assurez-vous que l'ID a été saisi dans son intégralité et qu'il n'y a pas d'espaces vides en début ou en fin de texte.
- Vérifier les variables d'horodatage de la durée d'exécution. Ils ne doivent pas être utilisés dans les noms de fichiers, car ils créent un nom de fichier unique pour chaque ensemble de données, ce qui signifie que la chaîne ne sera pas en mesure d'identifier les ensembles de données correspondants dans votre tableau.
Correspondance des colonnes et autres modifications de la chaîne
Si vous rencontrez des problèmes avec les en-têtes de colonnes lors de l'importation de données, vous pouvez utiliser data prep ou d'autres commandes.
Optionnel : Marquage des ensembles de données importés
Le balisage est pris en charge lors de l'importation d'ensembles de données, mais nous recommandons de déployer un ensemble supplémentaire de chaînes à partir du modèle avant d'apporter des modifications à l'original. Une fois modifiée, la chaîne sera probablement difficile à réutiliser pour d'autres tables, à moins que les ensembles de données de ces tables n'utilisent les mêmes balises.
Pour ajouter un marquage à une chaîne :
- Ajoutez les entrées d'exécution suivantes pour chacune des trois chaînes déployées à partir de ce modèle :
- Clé d'identification (champ de texte)
- Tag-Value (champ de texte)
- Modifiez le site Primary Chain pour transmettre les entrées d'exécution à chaque événement "Run Chain" :
- Dans les chaînes Replace Dataset Chain et Add New Dataset Chain, modifiez le nœud de commande "Import New Dataset" afin d'accepter les données d'exécution des balises.
Une fois cette opération terminée, les ensembles de données importés seront étiquetés avec la clé et la valeur d'étiquetage fournies.