Portail de support Workiva

À partir de Chain Builder, vous pouvez utiliser ces modèles de chaînes qui, ensemble, simplifient la transmission des données environnementales, sociales et de gouvernance (ESG) ou de durabilité :

• 1a. Restauration par progression ESG | Principal | Commencer ici
• 1b. Restauration par progression ESG | Actualiser les connexions et le statut
• 1c. Restauration par progression ESG | Actualiser la connexion | Exécution

Conseil : Si vous créez trois chaînes à partir de ces modèles, vous n'exécuterez que la première chaîne créée, qui les exécute toutes automatiquement.

Note : Ces chaînes ne reprennent que les feuilles de calcul de collecte de données - et non a Programme de développement durable. Pour savoir comment reporter des valeurs dans un programme, consultez le site . Reporter et gérer les années de déclaration dans le programme de développement durable.

Lorsque vous exécutez des chaînes créées à partir de ces modèles, elles fonctionnent ensemble pour archiver et importer automatiquement l'ensemble des données de l'année précédente dans un tableau. Lorsque vous exécutez les chaînes, vous pouvez également choisir d’effectuer les opérations suivantes :

• Actualiser les connexions de la feuille de calcul source avant d’importer le jeu de données, par exemple pour s’assurer que les valeurs sont les plus récentes
• Effacer les valeurs dans la feuille de calcul source (sauf celles liées aux sources ou aux destinations), par exemple pour préparer la collecte de données de l’année suivante

Note : ces chaînes remplacent automatiquement tout jeu de données de la même période dans le tableau Wdata connecté. Si une erreur se produit lors de l’importation du nouveau jeu de données, le tableau revient au jeu de données précédent.

Conditions préalables

Les chaînes créées à partir de ces modèles nécessitent des connecteurs spécifiques pour exécuter leurs commandes.

Avant de créer des chaînes à partir de ces modèles, configurez ces connecteurs dans le Générateur de chaînes :

• Connecteur Workiva
• Connecteur Chaînes Workiva
• Connecteur Transformation tabulaire
• Connecteur JSON
• Connecteur Guidon
• Connecteur Utilitaires de fichiers
• Connecteur Requête HTTP

Note : tous les connecteurs utilisés dans les chaînes de ces modèles utilisent le CloudRunner par défaut. Aucun GroundRunner n’est nécessaire.

Note : pour exécuter ses commandes, le connecteur Requête HTTP a besoin de l’ID client et du secret de l’accord OAuth créés pour l’utilisateur d’intégration du connecteur Workiva. Assurez-vous que l’accord OAuth a la portée appropriée.

Étape 1. Configuration des fichiers Workiva

Les chaînes créées à partir de ces modèles nécessitent une configuration spécifique des fichiers Workiva pour les données de durabilité. Avant d'exécuter les chaînes de ces modèles, configurez les fichiers Workiva pour collecter et reporter les données :

1. Dans les feuilles de calcul, identifiez la feuille de collecte de données utilisée pour les rapports sur le développement durable.
2. Dans Wdata, créez un tableau qui utilise la feuille de calcul comme un jeu de données connecté et enregistrez l’ID de la table lorsque vous exécutez les chaînes.
3. Dans la feuille de calcul, ajoutez une feuille pour suivre le statut d’actualisation de la connexion sortante au tableau Wdata et enregistrez le nom de la feuille pour l’utiliser lorsque vous exécutez les chaînes. 
4. Créez une requête à exécuter lorsque les chaînes archivent des données :
   • Utilisez le tableau Wdata connecté à la feuille de calcul de la collecte de données comme source de données.
   • Dans la requête, incluez un paramètre à sélection multiple pour l’année, avec le même type de données que la colonne Année du tableau.
   • Enregistrez l’ID de la requête pour pouvoir exécuter les chaînes.

Étape 2. Déterminer les valeurs des variables et des entrées de durée d’exécution

Pour permettre aux chaînes de travailler avec plusieurs espaces de travail, elles utilisent des variables pour identifier l’utilisateur d’intégration et les environnements pour le connecteur Workiva. Dans le Générateur de chaînes, créez ces variables d’espace de travail :

Lorsque vous exécutez la chaîne créée à partir du site 1a. Modèle Restauration par progression ESG | Principal | Commencer ici, il demande des entrées de durée d’exécution pour identifier les fichiers Workiva avec lesquels interagir et identifier le jeu de données :

Étape 3. Créer les chaînes

Pour créer les chaînes nécessaires à l'avancement de la collecte des données, utilisez le site 1a. Restauration par progression ESG | Principal | Commencer ici :

1. A partir de Modèles dans Générateur de chaînes, ouvrez la modèle 1a. Restauration par progression ESG | Principal | Commencer ici et cliquez sur Nouvelle chaîne.
2. Entrez un nom pour aider à identifier la chaîne.
   
3. Sélectionnez l’environnement qui utilisera la chaîne et cliquez sur Suivant.
4. Pour la variable dcv-clearSuccess, entrez le nom dvc-clearSuccess et cliquez sur Suivant.
   
5. Pour chaque connexion, sélectionnez le connecteur à utiliser et cliquez sur Chaîne suivante.

   Note : pour chaque connecteur, utilisez le CloudRunner par défaut.

   
6. Configurez chaque variable et cliquez sur Suivant.
   
   

   Variable	Type de variable	Nouvelle variable
   wsv-ClientID	Espace de travail	Sélectionnez wsv-ClientID.
   cv-TimeToCheck	Chaîne	cv-TimeToCheck
   wsv-ClientSecret	Espace de travail	Sélectionnez wsv-ClientSecret.
   dcv-RefreshStatus	Dynamique de la chaîne	dcv-RefreshStatus
   wsv-BaseURL-IAM	Espace de travail	Sélectionnez wsv-BaseURL-IAM.
   wsv-BaseURL-OC	Espace de travail	Sélectionnez wsv-BaseURL-OC.

7. Pour chaque connexion, sélectionnez le connecteur à utiliser et cliquez sur Chaîne suivante.

   Note : pour chaque connecteur, utilisez le CloudRunner par défaut.

8. Configurez chaque variable et cliquez sur Suivant.
   

   Variable	Type de variable	Nouvelle variable
   dcv-srcStatus	Dynamique de la chaîne	dcv-srcStatus
   wsv-ClientID	Espace de travail	Sélectionnez wsv-ClientID.
   dcv-destStatus	Dynamique de la chaîne	dcv-destStatus
   wsv-ClientSecret	Espace de travail	Sélectionnez wsv-ClientSecret.
   wsv-BaseURL-Wdata	Espace de travail	Sélectionnez wsv-BaseURL-Wdata.
   wsv-BaseURL-IAM	Espace de travail	Sélectionnez wsv-BaseURL-IAM.

9. Pour chaque connexion, sélectionnez le connecteur à utiliser et cliquez sur Soumettre.

   Note : pour chaque connecteur, utilisez le CloudRunner par défaut.

Étape 4. Publier les chaînes

Note : pour faciliter l’installation, le modèle Actualiser les connexions et le statut a un événement Exécuter la chaîne. Avant de publier les chaînes créées à partir des modèles, supprimez l’événement extérieur Exécuter la chaine.

1. Dans Chaînes, pour la chaîne créée à partir du modèle Actualiser les connexions et le statut, sélectionnez Modifier.
   
2. Sélectionnez l’événement Exécuter la chaîne - Supprimer et cliquez sur Supprimer et Supprimer.
   
3. Cliquez sur Publier et Publier.
4. Dans Chaînes, pour la chaîne créée à partir du modèle Principal, sélectionnez Modifier.
5. Cliquez sur Publier et Publier.
6. Dans Chaînes, pour la chaîne créée à partir du modèle Exécution, sélectionnez Modifier.
7. Cliquez sur Publier et Publier.

Exécuter les chaînes

Archiver vos données et préparer la collecte de données de l'année suivante :

1. Dans le Générateur de chaînes, à partir de Chaînes, sélectionnez Exécuter pour la chaîne créée à partir du modèle 1a.Restauration par progression ESG | Principal | Commencer ici.
   
2. Cliquez sur Exécuter avec des entrées et entrez les entrées de données d’exécution :
   
   

   Entrée de durée d’exécution	Valeur
   Collecte des données - ID du tableau de restauration par progression	Entrez l’ID du tableau Wdata dans lequel vous souhaitez importer le jeu de données.
   Collecte de données - ID de requête de restauration par progression	Entrez l’ID de la requête à exécuter pour archiver les données.
   Année PY	Entrez l’année des données à archiver.
   Valeur de la balise	Entrez le nom du jeu de données archivé. Note : avec l’entrée Année PY, cette entrée crée le nom de fichier du jeu de données [Valeur de la balise]_[Année PY].csv. Par exemple, une Année PY 2021 et une Valeur de la balise Archivé créent le nom de fichier Archivé_2021.csv.
   Actualiser les connexions des feuilles avant l’archivage des données	Indiquez s’il faut actualiser les connexions sortantes de la feuille de calcul vers le tableau Wdata avant l’exécution de la requête de restauration par progression, par exemple pour mettre à jour le jeu de données avant l’archivage.
   Statut-NomFeuille	Entrez le nom de la feuille qui suit le statut d’actualisation des connexions sortantes de la feuille de calcul vers le tableau Wdata.
   RefreshExecution-ChainName	Entrez le nom de la chaîne créée à partir du modèle Restauration par progression ESG | Actualiser la connexion | Exécution.
   Effacer la colonne Valeur de la feuille de calcul	Indiquez s’il faut supprimer les valeurs d’entrée de la feuille de calcul dans le cadre de la restauration par progression. Note : les valeurs sans lien source ou de destination seront supprimées.

3. Pour garantir les valeurs les plus récentes avant l'importation de l'ensemble de données, sélectionnez Actualiser les connexions avant l'archivage des données.
   
   Si vous sélectionnez cette option, les chaînes actualisent les connexions sortantes du tableur et suivent leur état d'actualisation dans une feuille de contrôle :
   • Dans Status-SheetName, entrez le nom de la feuille de calcul source où les chaînes peuvent enregistrer le statut d’actualisation des connexions sortantes.
   • Dans RefreshExecution-ChainName, entrez le nom de la chaîne créée à partir du modèle Restauration par progression ESG | Actualiser la connexion | Exécution.

   Conseil : l’actualisation peut prendre quelques minutes, en fonction du nombre de connexions sortantes de la feuille de calcul. Pour ajuster le temps d’attente, modifiez l’événement Suspendre la chaîne de la chaîne créée à partir du modèle 1b. Restauration par progression ESG | Actualiser les connexions et le statut.

4. Pour supprimer les valeurs d'entrée de la feuille de calcul source dans le cadre de l'archivage, par exemple pour préparer la collecte de données de l'année suivante, sélectionnez Effacer la colonne des valeurs de la feuille de calcul.
   
   

   Note : La chaîne conserve toutes les valeurs liées à une source ou à une destination. Vous ne pouvez pas récupérer les valeurs supprimées de la feuille de calcul. Nous vous recommandons de ne sélectionner cette option que pour le dernier récapitulatif de l’année, afin de préparer la feuille de calcul pour la collecte des données de l’année suivante.

   Conseil : Par défaut, la chaîne supprime les valeurs à partir de la ligne 2 des feuilles de la feuille de calcul. Pour modifier ceci, modifiez la propriété Région de la commande Effacer les données de la feuille.

5. Cliquez sur Démarrer.