Importation en bloc de requêtes

Importez en bloc des requêtes dans un projet si vous devez éviter la saisie manuelle - et chronophage - des données ou si vous devez les faire migrer à partir d'un autre système.

Vous pouvez également mettre à jour plusieurs requêtes simultanément à l'aide de sessions dans l'assistant d'importation en bloc. Pour plus d'informations, consultez la section Mettre à jour en bloc les requêtes existantes.

Fonctionnement

Vous ouvrez une nouvelle session Assistant d'importation en bloc et téléchargez le modèle Excel depuis la page Assistant d'importation en bloc dans la barre de lancement. Vous préparez les données dans le modèle et vous chargez le modèle dans la page Assistant d'importation en bloc.

Vous pouvez charger en bloc les requêtes dans les projets ou dans un composant au sein d'un projet, comme un objectif, une description, etc.

Où se trouvent les requêtes chargées ?

Lorsque vous avez chargé les requêtes, les données figurent dans :

• l'onglet Requêtes ;
• l'application Outil de suivi des tâches ;
• le composant au sein du projet comme l'objectif, la description, etc (si targetType et targetId sont mentionnés dans le modèle). Pour plus d'informations, consultez la section Préparer les données dans le modèle.

Avant de commencer

Avant de commencer à importer des requêtes, vous devez créer un projet au moyen de l'Assistant d'importation en bloc en remplissant la feuille de calcul Projects ou depuis l'interface utilisateur.

Flux de travail

Autorisations

Seuls les admins système peuvent charger en bloc les ressources Diligent One depuis l'assistant d'importation en bloc.

Mettre à jour en bloc de nouvelles requêtes

Ouvrir une nouvelle session Assistant d'importation en bloc et télécharger le modèle Excel

1. Ouvrez la Barre de lancement.

   Remarque

   Si votre entreprise utilise plusieurs instances dans la barre de lancement, assurez-vous que la bonne instance est active.

2. Sélectionnez Paramètres de la plateforme > Organisation.

   Si vous ne voyez pas l’option Organisation, le compte que vous avez utilisé pour vous connecter ne dispose pas de privilèges d’admin.

3. Sous Assistant d'importation en bloc, cliquez sur Gérer les ressources en bloc.

   Une nouvelle session Assistant d'importation en bloc commence et l'ID de session est ajouté à l'URL.

   Attention

   Commencez toujours une nouvelle session pour ajouter de nouvelles ressources, sans quoi vous risquez de perdre les données précédemment chargées.

   En savoir plus

   Par exemple : vous souhaitez importer 200 entités en deux lots (100 + 100). Si vous chargez les lots l'un après l'autre dans la même session, les données chargées dans le premier lot seront remplacées par les données du deuxième lot après le chargement de celui-ci. Pour éviter de perdre ces données, chargez le premier lot au cours d'une session et commencez-en une nouvelle pour le lot suivant. De la même manière, commencez une nouvelle session pour ajouter d'autres nouvelles ressources.

   Remarque

   Vous pouvez reprendre une session passée pour mettre à jour les données précédemment chargées. Pour en savoir plus, consultez la rubrique Fonctionnalité de mise à jour dans l'assistant d'importation en bloc.

4. Sous Sélectionner une ressource, dans le type de ressource, sélectionnez Toutes les ressources.

5. Cliquez sur Télécharger le modèle .xlsx.

   Le modèle Excel est enregistré sur votre ordinateur local.

Préparer les données dans le modèle

1. Ouvrez le modèle téléchargé (HighBond_Template.xlsx) et accédez à la feuille de calcul Requests.
2. Copiez et collez ou saisissez vos données dans le modèle. Pour obtenir de l'aide concernant la saisie des données, consultez la rubrique Astuces pour préparer le contenu.
   Remarque

   • Si vous utilisez l'Add-In pour Excel, assurez-vous que l'option ACL Add-In est désactivée avant de modifier le modèle Excel. Pour apprendre à le faire, consultez la rubrique Configuration de l'Add-in pour Excel.
   • Ne modifiez pas le nom de la feuille de calcul ni des champs. Ces noms sont sensibles à la casse et ne doivent pas être modifiés.
   • Le nombre maximal de lignes pouvant être chargées simultanément s'élève à 2 000 (toutes feuilles de calcul comprises).

   Champ	Description
   referenceId obligatoire	Indique un ID unique pour la ressource. Il doit être unique pour chaque ligne de la feuille de calcul. Il peut contenir une combinaison de texte et de nombres et sa longueur maximale ne doit pas dépasser 255 caractères. Ce champ est la clé primaire de chaque ligne dans le modèle. Vous aurez besoin de cette clé si vous voulez à nouveau mettre à jour cette ressource. Important Vous pouvez utiliser des ID de référence pour associer rapidement des ressources entre elles. Par exemple, vous pouvez créer un projet et un objectif associé à ce projet dans le même chargement. Il vous suffit pour cela de créer un lien entre le projet et l'objectif en indiquant referenceId dans le champ requis. Pour en savoir plus sur l'association des ressources Diligent One dans l'assistant d'importation en bloc, consultez Utiliser des ID de référence pour associer des ressources dans l'assistant d'importation en bloc. Remarque Des ID de référence sont nécessaires lorsque vous ajoutez ou mettez à jour des ressources à l'aide de l'assistant d'importation en bloc. Ils ne sont pas disponibles lorsque vous ajoutez/mettez à jour les ressources à partir de l'interface utilisateur de Diligent One.
   ccContacts	Indique les ID d'e-mail des utilisateurs devant remplir la requête. Astuce Vous pouvez ajouter plusieurs ID d'e-mail séparés par une virgule.
   description obligatoire	Décrit les informations demandées, comme le nom du document, le numéro de version ou le département où vous pourriez vous attendre à les trouver. Astuce Utiliser des balises HTML pour formater le texte. Par exemple : <b>, <i>, <ol>, <ul>. Pour obtenir des informations sur les requêtes, consultez Demander de la documentation.
   dueDate	Indique la date à laquelle la requête doit être remplie. La date doit être au format AAAA-MM-JJ.
   emailMessage	Permet de personnaliser le corps de l'e-mail.
   emailSubject	Permet de personnaliser la ligne de l'objet de l'e-mail.
   owner obligatoire sous condition	Indique le nom de la personne en charge de remplir la requête. Dans l'idéal, il est adapté pour ajouter des utilisateurs non Diligent One à ce champ. Ce champ devient obligatoire si ownerUser reste vide.
   ownerEmail obligatoire sous condition	Indique l'ID d'e-mail de la personne en charge de remplir la requête. Dans l'idéal, il est adapté pour ajouter des utilisateurs non Diligent One à ce champ.
   ownerUser obligatoire sous condition	Indique l'ID d'utilisateur (UID) ou l'ID d'e-mail de la personne en charge de remplir la requête. Découvrez comment obtenir l'UID d'un utilisateur. Vous ne pouvez pas ajouter d'utilisateurs non Diligent One à ce champ. Ce champ devient obligatoire si owner reste vide. Notez que le fait d'indiquer ownerUser remplace toute valeur fournie dans les champs owner et ownerEmail. Remarque Assurez-vous que l'utilisateur que vous souhaitez ajouter à ce champ a déjà été affecté au projet / cadre respectif. Pour en savoir plus sur l'attribution des rôles utilisateur, voir Affecter des rôles utilisateur dans les projets et les cadres
   position	Indique l'ordre dans lequel la requête s'affiche.
   projectId obligatoire	Indique l'ID du projet où cette requête doit être placée. Par exemple :  https://stark.projects.highbond.com/audits/ 90305/dashboard, où 90305 correspond à l'ID du projet. Remarque Dans ce champ, vous pouvez également fournir l'ID de référence d'un nouveau projet que vous avez ajouté dans le modèle actuel. De cette façon, la requête est associée au projet au moment du chargement du modèle. Pour en savoir plus sur l'association des ressources Diligent One dans l'assistant d'importation en bloc, consultez Utiliser des ID de référence pour associer des ressources dans l'assistant d'importation en bloc.
   received	Indique le statut de la requête : True : Reçu. False : Ouvert. La valeur par défaut est False.
   requestorUser obligatoire	Indique l'ID utilisateur (UID) ou l'ID d'e-mail de la personne demandant la documentation. Découvrez comment obtenir l'UID d'un utilisateur.
   sendRecurrentNotifications	Indique s'il est nécessaire d'envoyer un e-mail au propriétaire de la requête et aux personnes en copie selon un calendrier récurrent indiqué. True : envoie l'e-mail selon un calendrier récurrent. False : désactive le calendrier d'e-mail. Pour plus d'informations sur les rappels récurrents, consultez la rubrique Envoyer des rappels de requête récurrents.
   ccUsers	Indique l'ID utilisateur (UID) ou l'ID d'e-mail des utilisateurs internes qui appartiennent à l'organisation en charge de l'exécution de la requête. Découvrez comment obtenir l'UID d'un utilisateur.
   targetType	Indique le type de composant où cette requête doit être placée. Le type de cible doit être l'un des suivants : projects project_files objectives narratives risks controls walkthroughs control_test_plans control_tests issues walkthrough_summaries project_plannings project_results risk_control_matrices testing_rounds la valeur par défaut est projets. Important Utilisez la terminologie exacte telle qu'indiquée ci-dessus. Remarque Utilisez uniquement les valeurs par défaut anglaises pour ce champ. Les valeurs anglaises personnalisées et les valeurs localisées (non anglaises) ne sont pas prises en charge dans Assistant d'importation en bloc. Pour plus d'informations sur l'ID cible à utiliser selon le composant, consultez Type de cible et ID cible des composants du projet
   targetId obligatoire	Indique l'ID de la ressource où cette requête doit être placée. Vous pouvez trouver l'ID de ressource dans l'URL. Par exemple :  https://stark.projects.highbond.com/audits/ 90305/objectives/94778, où 90305 correspond à l'ID du projet et 94778 à l'ID de l'objectif. Dans le champ targetId, vous pouvez effectuer l'une des opérations suivantes : indiquez l'ID projet si vous voulez placer le problème sous le projet (ce sera le même ID que clui mentionné dans le champ projectId). indiquez l'ID composant (ID objectif dans l'exemple ci-dessus) si vous voulez placer le problème sous le composant d'un projet. Remarquez que l'ID projet doit être mentionné dans le champ projectId. Pour plus d'informations sur l'ID cible à utiliser selon le composant, consultez Type de cible et ID cible des composants du projet

3. Enregistrez et fermez le modèle.

Astuces pour préparer le contenu

La préparation de contenu implique de :

• de copier-coller vos données sources dans les modèles Excel ;
• de saisir des données, si nécessaire, dans le modèle Excel.
• d'enregistrer le modèle en cours de préparation pour le chargement en bloc.

Utiliser des ID de référence pour associer des ressources dans l'assistant d'importation en bloc

Reference ID est un champ dans le modèle Excel de l'assistant d'importation en bloc. Il s'agit du premier champ de toutes les feuilles de calcul et il est disponible pour toutes les ressources. Il sert d'identifiant unique pour chaque enregistrement de la feuille de calcul.

Les ID de référence vous permettent d'associer rapidement des ressources Diligent One entre elles. Par exemple, vous pouvez créer un projet ainsi qu'un objectif associé au projet dans la même importation. Il vous suffit pour cela d'indiquer referenceId dans le champ requis.

Type de cible et ID cible des composants du projet

La section suivante indique le type de cible et l'ID cible pour le composant de projet respectif.

En fonction du composant de l'emplacement de la requête, utilisez le type de cible et la ID appropriés dans le modèle Excel.

Charger les données

Effectuez l'une des actions suivantes :

• Glissez-déposez le modèle dans la fenêtre du navigateur.
• Cliquez sur Sélectionner depuis votre ordinateur et sélectionnez le modèle mis à jour à partir de votre ordinateur.

  Un seul modèle Excel peut être chargé à la fois (chaque fichier est validé séparément).

Résultat Un message de réussite ou d'échec s'affiche en fonction du résultat du processus et la dernière session est mise à jour dans la table Sessions.

Sessions dans l'assistant d'importation en bloc

Une session dans l'assistant d'importation en bloc est une série d'interactions de l'utilisateur pour importer des ressources Diligent One. Chaque session d'utilisateur est enregistrée dans la table Sessions.

La table Sessions contient les informations suivantes.

Nom de champ	Description
Sessions Web	Affiche la liste de toutes les sessions Web. Une session Web désigne une session réalisée à l'aide de l'interface utilisateur Assistant d'importation en bloc. Une nouvelle session commence dès que vous ouvrez la page Assistant d'importation en bloc.
Sessions API	Affiche la liste des sessions API. Une session API désigne une session réalisée à l'aide d'une plateforme d'API, telle que Postman.
Actualiser	Recharge le tableau des sessions.
ID de session	Identificateur de session. Dans les sessions Web, vous pouvez cliquer sur l'ID de session pour accéder à une session particulière et celui-ci est concaténé à l'URL. Par exemple : https://stark.bulkimporter.highbond.com/import/bcc1e04e-4cd3-46d2-a8be-0b9083baccdc, où bcc1e04e-4cd3-46d2-a8be-0b9083baccdc est l'ID de la session. Remarque Les ID de session Web et API se ressemblent, veillez donc à ne pas les intervertir pour éviter toute erreur.
Date	Affiche la date et l'heure de la session. Vous pouvez trier la date dans l'ordre croissant ou décroissant.
Chargé par	Affiche le nom de l'utilisateur.
Statut	Affiche le statut du chargement : réussite ou échec. Vous pouvez cliquer sur le statut pour voir tous les détails du chargement.
Nom de fichier	Affiche le nom du modèle / du journal d'erreurs chargé. Par exemple : HighBond_Template.xlsx, ErrorLog.xlsx. Modèle Vous pouvez cliquer sur le modèle et le télécharger pour corriger les données précédemment chargées. Journal d'erreurs Un journal d'erreurs est généré lorsqu'un chargement échoue. Vous pouvez consulter le journal d'erreurs pour rectifier les erreurs et charger à nouveau le modèle. Remarque Le modèle et le journal d'erreurs sont disponibles pour téléchargement pendant une période pouvant aller jusqu'à 18 mois à compter de la date de chargement. Le lien pour télécharger le modèle est disponible pour les sessions de l'assistant d'importation en bloc à partir du 13 mai 2022. Vous ne pouvez pas télécharger le modèle pour les sessions antérieures à cette date.

Mettre à jour en bloc les requêtes existantes

Vous pouvez également mettre à jour plusieurs éléments simultanément à l'aide de sessions dans l'assistant d'importation en bloc.

Dépannage

Vous pouvez télécharger le journal d'erreurs et le consulter dans la table Sessions. Comprenez les erreurs courantes du chargement en bloc et découvrez comment les résoudre.

Le tableau suivant répertorie les erreurs pouvant apparaître lors du chargement du modèle.

Erreur	Solution(s)
Il peut y avoir plus de 2 000 lignes dans le fichier chargé (toutes feuilles de calcul comprises).	Supprimez les lignes supplémentaires du modèle et rechargez-le.
Les champs obligatoires peuvent être vides ou manquants dans le fichier chargé.	Assurez-vous que tous les champs obligatoires (identifiables grâce à des noms de colonne rouge et orange dans le modèle) sont remplis. Remarque Si vous ne fournissez pas de données dans les champs obligatoires, la ligne n'est pas traitée.
Le format de date peut être incorrect	Assurez-vous que les données dans les champs texte sont valides et ne dépassent pas la longueur maximale : 255 caractères. Les champs texte enrichi ne présentent pas de limite de nombre de caractères.
Les valeurs de données peuvent être non valides ou peuvent ne pas correspondre aux valeurs de la liste déroulante.	Par exemple : la valeur des champs received et sendRecurrentNotifications dans la feuille Requests doivent avoir la valeur True ou False.
Les champs non valides dans le modèle.	N'ajoutez pas de nouveaux champs au modèle . Ne supprimez pas les champs du modèle.
Le modèle peut ne pas être au format prévu	Assurez-vous que le format de fichier est .xlsx.
Noms de feuille de calcul non valide.	Ne modifiez pas le nom de la feuille de calcul.
La session peut avoir expirée.	Actualisez la page et essayez à nouveau le chargement.
L'ID de session n'est peut-être pas valide.	Vérifiez que vous utilisez un ID de session Web.