Importation en bloc de cadres

Importez en bloc des cadres si vous voulez éviter la saisie manuelle de données chronophage ou migrer des données d'un autre système.

Vous pouvez également mettre à jour plusieurs cadres 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 cadres existants.

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.

Où se trouvent les cadres chargés ?

Une fois que avez chargé les cadres, les données sont disponibles dans :

l'application Cadres

Flux de travail

Autorisations

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

Charger en bloc de nouveaux cadres

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 l'organisation > 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, sélectionnez l'une des options suivantes dans le type de ressource :

   • Cadres > Types de projets Afin de créer des cadres par type de projet. Le modèle est dynamique et contient les configurations intégrées du type de projet sélectionné. Cette option vous permet de créer plusieurs ressources Diligent One (projets, cadres, objectifs, risques, contrôles et atténuations) en fonction du type de projet.
   • Toutes les ressources Afin d'importer en bloc toutes les ressources en même temps : projets, cadres, objectifs, risques, contrôles, atténuations, problèmes, actions, requêtes, entités et cartes de conformité. Le modèle est statique et prend un certain temps à remplir, car vous devez définir manuellement la configuration des 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é et accédez à la feuille de calcul Frameworks. S'il s'agit d'un modèle dynamique, le nom de la feuille de calcul est une combinaison de la ressource et de son ID de type de projet. Par exemple : Frameworks-85692.
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.
   name obligatoire	Indique un nom descriptif pour le cadre. La longueur maximale contient 120 caractères. Pour obtenir des informations sur les cadres, consultez la rubrique Gérer des informations à l'aide de cadres .
   description	Indique la description détaillée du cadre. Astuce Utiliser des balises HTML pour formater le texte. Par exemple : <b>, <i>, <ol>, <ul>.
   background	Indique les circonstances contextuelles du cadre.
   purpose	Indique les résultats prévus, les buts ou objectifs du cadre.
   projectTypeId obligatoire (modèle statique uniquement)	Indique le type de projet associé au cadre. L'ID du type de projet est disponible dans l'URL lorsque vous accédez à ce type de projet. Par exemple : https://stark.projects.highbond.com/ audit_types/36245/description, où 36245 correspond à l'ID du type de projet. Pour en savoir plus, consultez la rubrique Flux de travail et types de projets.
   scope	Indique les points qui sont couverts par le cadre
   riskAssurance	Indique le statut de la fonctionnalité Assurance du risque pour le cadre. True : activé. False : désactivé. La valeur par défaut est False. Pour en savoir plus, consultez Premiers pas avec l'assurance du risque.
   entities	Indique les ID des entités marquées pour les éléments du cadre. Vous pouvez retrouver l'ID de l'entité dans l'URL lorsque vous accédez à une entité. Par exemple : https://stark.projects.highbond.com/ auditable_entities/33055, où 33055 est l'ID de l'entité. Vous pouvez fournir plusieurs ID séparés par des virgules. Remarque Dans ce champ, vous pouvez également fournir l'ID de référence d'une nouvelle entité que vous avez ajoutée dans le modèle actuel. De cette façon, le cadre est associé à l'entité 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. Pour en savoir plus sur les entités, consultez Configurer l'étiquetage des entités.
   folderName	Indique le nom du dossier du cadre.
   customAttributes_1_term - customAttributes_n_term	Indique les champs des attributs personnalisés 1 à n. Les attributs personnalisés dans le modèle Excel dépendent du type de modèle, comme suit : Cadres > Types de projets : par défaut, le modèle contiendra les champs d'attributs personnalisés définis dans le type de projet. Toutes les ressources : vous devez vérifier et remplir manuellement les champs d'attributs personnalisés (les conditions et la valeur). Le modèle contiendra une paire de valeur et de condition d'attribut personnalisé, et vous pouvez en ajouter neuf autres. Pour cela, respectez la même convention d'appellation en ajoutant un compteur, par exemple : customAttributes_2_term, customAttributes_2_value, etc. Les attributs personnalisés d'un projet, d'un cadre et de leurs composants sont définis dans le type de projet. Pour plus d'informations sur les attributs personnalisés, consultez Personnaliser les termes, les champs et les notifications.
   customAttributes_1_value - customAttributes_n_value	Indique les valeurs des attributs personnalisés 1 à n. Les attributs personnalisés dans le modèle Excel dépendent du type de modèle, comme suit : Cadres > Types de projets : par défaut, le modèle contiendra les champs d'attributs personnalisés définis dans le type de projet. Toutes les ressources : vous devez vérifier et remplir manuellement les champs d'attributs personnalisés (les conditions et la valeur). Le modèle contiendra une paire de valeur et de condition d'attribut personnalisé, et vous pouvez en ajouter neuf autres. Pour cela, respectez la même convention d'appellation en ajoutant un compteur, par exemple : customAttributes_2_term, customAttributes_2_value, etc. Les attributs personnalisés d'un projet, d'un cadre et de leurs composants sont définis dans le type de projet. Pour plus d'informations sur les attributs personnalisés, consultez Personnaliser les termes, les champs et les notifications. Remarque Si une valeur commence par un crochet ou contient une virgule, un point-virgule ou un saut de ligne, placez cette valeur entre guillemets doubles (" "). Par exemple : "[2021]", "Premier, deuxième actif", "Cela est important ; ça aussi". Dans le cas d'un champ à choix multiple, vous pouvez ajouter plusieurs valeurs en les séparant par une virgule. Dans le cas d'un champ à liste déroulante ou à choix multiple, vérifiez que les valeurs sont exactement identiques à celles spécifiées dans les options.

   Remarque

   Dans le cas d'un champ de liste déroulante du modèle dynamique, les options de cette liste apparaissent uniquement pour la première ligne. Afin qu'elles apparaissent pour d'autres lignes, copiez la première ligne et collez-la dans les lignes souhaitées.

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.

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 cadres existants

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.