Importation de données dans Workfront à l’aide d’un modèle de démarrage rapide
Les Kickstarts sont des classeurs Excel spécialement formatés que vous pouvez renseigner avec les données à importer dans Workfront. Adobe Workfront fournit un modèle Kickstart que vous pouvez utiliser pour ce faire, comme expliqué dans la section Importateur de données Kickstart.
Ce processus est divisé en trois tâches principales :
- Premièrement, vous exportez un modèle Kickstart sous forme de fichier de feuille de calcul.
- Deuxièmement, vous remplissez la feuille de calcul avec vos données.
- Enfin, vous importez la feuille de calcul renseignée dans Workfront.
Chacune de ces procédures est décrite dans l’ordre approprié dans le présent article.
Conditions d’accès
Vous devez disposer des accès suivants pour effectuer les étapes décrites dans cet article :
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
---|---|
Formule Adobe Workfront | Tous |
Licence Adobe Workfront |
Nouveau : Standard ou Actuel : formule |
Configurations des niveaux d’accès | System Administrator |
Pour plus d’informations sur le contenu de ce tableau, voir Conditions d’accès requises dans la documentation Workfront.
Limites
Vous pouvez importer un grand nombre d’objets dans Workfront à l’aide d’un modèle Kickstart. Toutefois, tenez compte des restrictions suivantes :
- L’import de données de cette manière ne met pas à jour les informations sur les enregistrements déjà présents dans Workfront.
- Vous ne pouvez importer que les nouveaux enregistrements et leurs informations.
- N’importez pas plus de 2 000 enregistrements à la fois pour vous assurer que l’import n’expire pas.
Exporter un modèle Kickstart sous la forme d’un fichier de feuille de calcul
Lorsque vous exportez un modèle Kickstart, vous recevez un classeur de feuille de calcul Excel vierge. Une fois la feuille de calcul téléchargée sur votre ordinateur, vous pouvez l’utiliser pour remplir vos informations, puis les réimporter dans Workfront.
Pour exporter un modèle Kickstart, procédez comme suit :
-
Cliquez sur l’icône Menu principal dans le coin supérieur droit d’Adobe Workfront, ou (si disponible), cliquez sur l’icône Menu principal dans le coin supérieur gauche, puis cliquez sur Configuration .
-
Cliquez sur Système > Importer des données (Kickstarts).
-
Sélectionnez les types d’information à inclure.
Chaque option sélectionnée représente un ensemble de plusieurs onglets dans la feuille de calcul exportée. Par exemple, si vous sélectionnez l’option Rapport, tous les objets nécessaires à la création d’un rapport seront inclus dans la feuille de calcul (vues, filtres, regroupements, rapports).
Vous pouvez utiliser tous les types d’objets répertoriés ci-dessous pour importer des données dans Workfront. (La seule exception concerne l’option Niveaux d’accès. La feuille de données des niveaux d’accès d’un export est fournie à titre de référence ; elle vous permet d’attribuer un niveau d’accès à un nouveau compte d’utilisateur ou d’utilisatrice par son ID.)
Le modèle de chacun des types d’objet peut être exporté dans les formats de fichiers suivants et contient les feuilles suivantes :
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 32-row-3 33-row-3 34-row-3 layout-auto Objet Exporte en tant que Feuilles dans la feuille de calcul exportée Tableau de bord
Tous les tableaux de bord du système peuvent être exportés. Vous pouvez sélectionner jusqu’à 100 tableaux de bord spécifiques dans un seul export.
Exporte sous forme de fichier ZIP. Paramètre
Texte descriptif
Option de paramètre
Groupe de paramètres
Paramètre de catégorie
Catégorie
Rapport
Section d'onglet de portail
Tableau de bord
Préférences
Rapport
Tous les rapports du système peuvent être exportés. Vous pouvez sélectionner jusqu’à 100 rapports spécifiques au sein d’une seule exportation.
Le démarrage rapide ne prend pas en charge les filtres ou les regroupements en mode texte. Pour réussir l’exportation, les filtres et les regroupements de rapports doivent être basculés en mode standard.
Exporte sous forme de fichier ZIP. Paramètre
Texte descriptif
Option de paramètre
Groupe de paramètres
Paramètre de catégorie
Catégorie
Rapport
Préférences
Approbation Exporte sous forme de fichier Excel. Approbateur d'étape
Étape d’approbation
Approbation
Processus d’approbation
Préférences
Données personnalisées Exporte sous forme de fichier Excel. Paramètre
Texte descriptif
Option de paramètre
Groupe de paramètres
Paramètre de catégorie
Catégorie
Préférences
Type de frais Exporte sous forme de fichier Excel. Type de frais
Préférences
Type d’heure Exporte sous forme de fichier Excel. Type d’heure
Préférences
Equipe Exporte sous forme de fichier Excel. Membre d'équipe
Equipe
Préférences
l’utilisateur ou de l’utilisatrice Exporte sous forme de fichier Excel. Pour afficher la liste complète des options, cliquez sur Plus d’options. l’utilisateur ou de l’utilisatrice
Préférences
Niveau d’accès Exporte sous forme de fichier Excel. Niveau d’accès
Préférences
Affectation Exporte sous forme de fichier Excel. Affectation
Préférences
Entreprise Exporte sous forme de fichier Excel. Entreprise
Préférences
Modèle d'e-mail Exporte sous forme de fichier Excel. Modèle d'e-mail
Préférences
Frais Exporte sous forme de fichier Excel. Dépense
Préférences
Page externe Exporte sous forme de fichier Excel. Page externe
Préférences
Filtre Exporte sous forme de fichier ZIP. Filtre
Préférences
Groupe Exporte sous forme de fichier Excel. Groupe
Préférences
Regroupement Exporte sous forme de fichier ZIP. Regroupement
Préférences
Heure Exporte sous forme de fichier Excel. Heure
Préférences
Problème Exporte sous forme de fichier Excel. Problème
Préférences
Fonction Exporte sous forme de fichier Excel. Fonction
Préférences
Chemin jalonné Exporte sous forme de fichier Excel. Jalon
Chemin jalonné
Préférences
Note Exporte sous forme de fichier Excel. Note
Préférences
Portfolio Exporte sous forme de fichier Excel. Portfolio
Préférences
Projet Exporte sous forme de fichier Excel. File d'attente
Projet
Règle de transmission
Rubrique de file d'attente
Préférences
Estimation de ressources Exporte sous forme de fichier Excel. Estimation de ressources
Préférences
Risque Exporte sous forme de fichier Excel. Risque
Préférences
Type de risque Exporte sous forme de fichier Excel. Type de risque
Préférences
Carte de score Exporte sous forme de fichier Excel. Question sur la carte de score
Option de la carte de résultats
Carte de score
Préférences
Tâche Exporte sous forme de fichier Excel. Tâche
Préférences
Modèle Exporte sous forme de fichier Excel. File d'attente
Modèle
Règle de transmission
Rubrique de file d'attente
Préférences
Modèle d'affectation Exporte sous forme de fichier Excel. Modèle d'affectation
Préférences
Tâche de modèle Exporte sous forme de fichier Excel. Tâche de modèle
Préférences
Feuille de temps Exporte sous forme de fichier Excel. Profil de feuille de temps
Feuille de temps
Préférences
Afficher Exporte sous forme de fichier ZIP. Afficher
Préférences
-
Cliquez sur Télécharger.
-
Continuez avec Remplir le modèle de feuille de calcul avec vos données pour remplir la feuille de calcul de modèle vierge avec vos informations.
Remplir le modèle de feuille de calcul avec vos données populate-the-spreadsheet-template-with-your-data
Vue d’ensemble des onglets (feuilles de données) inclus dans la feuille de calcul
Lorsque vous ouvrez un modèle Kickstart vierge, plusieurs onglets (feuilles de données) sont disponibles. Ils dépendent des objets que vous avez sélectionnés pour le téléchargement. Chacun représente un objet dans l’application, tel que le projet, les tâches, les heures, le tableau de bord et les personnes :
Lorsque vous ouvrez l’un de ces onglets, la ligne 2 affiche les champs de chaque objet pouvant être défini au cours d’une importation. Dans un en-tête de colonne, après le mot « set », le nom du champ s’affiche tel qu’il apparaît dans la base de données. Ces champs se comportent comme des en-têtes de colonne.
- Ne supprimez pas la première ligne vide d’une feuille de calcul Kickstart.
- Ne supprimez, ne modifiez pas et ne réorganisez pas ces champs (en-têtes de colonne) de quelque manière que ce soit. Par exemple, ne modifiez pas leur ordre ou leur nom.
- Ajoutez des valeurs à chaque champ qui s’affiche en gras dans l’en-tête de colonne. Il s’agit des champs obligatoires.
- Certains champs, y compris setResourceRevenue et setEnteredByID, sont générés automatiquement par le système. Si vous saisissez des données pour ces champs dans la feuille de calcul, le processus Kickstart l’emportera lors du chargement de la feuille de calcul.
Importer un enregistrement import-a-record
Chaque ligne de la feuille correspond à un objet unique.
-
Ajoutez des informations dans la colonne isNew :
-
Si l’objet que vous importez est nouveau, saisissez TRUE pour importer les données dans la ligne. Cette valeur est sensible à la casse et doit toujours être saisie en majuscules.
-
Si l’objet se trouve déjà dans Workfront, saisissez FALSE dans la colonne isNew pour ignorer la ligne. Cette valeur est sensible à la casse et doit toujours être saisie en majuscules.
- Les enregistrements qui existent déjà dans Workfront ne sont pas mis à jour.
- Si vous avez téléchargé un modèle contenant des données provenant de Workfront, la valeur FALSE est déjà indiquée pour les objets existants.
- Si vous avez téléchargé un modèle vierge, il n’est pas nécessaire d’ajouter de nouvelles lignes pour les objets existants.
-
-
Ajoutez des informations dans la colonne ID de l’une des manières suivantes :
-
Si l’objet que vous importez est nouveau (et que vous avez saisi TRUE dans la colonne isNew), saisissez n’importe quel numéro pour l’ID. Ce nombre doit être unique dans la feuille de calcul. Par exemple, si vous importez trois objets, vous pouvez leur attribuer respectivement les identifiants 1, 2 et 3.
-
Si l’objet existe déjà dans Workfront (et que la valeur FALSE est indiquée dans la colonne isNew) et que vous importez de nouvelles informations sur les objets existants, l’ID doit être le GUID alphanumérique existant dans Workfront pour cet objet.
note tip TIP Pour découvrir le GUID unique d’un objet dans Workfront, vous pouvez créer un rapport pour cet objet et ajouter la colonne ID au rapport. La valeur de chaque objet de cette colonne correspond au GUID de l’objet. - Les enregistrements qui existent déjà dans Workfront ne sont pas mis à jour.
- Si vous avez téléchargé un modèle avec des données, les objets existants contiennent déjà le GUID en tant qu’ID.
- Vous pouvez importer un nouvel objet en fonction d’un objet existant en remplaçant FALSE par TRUE dans la colonne isNew, en modifiant l’ID et en ajustant les données avant l’import.
-
Lorsque vous importez un projet, vous devez indiquer un ID de groupe.
- Si le groupe existe déjà dans Workfront, vous devez ajouter son ID unique au champ setGroupID pour le projet.
- Si le groupe n’existe pas dans Workfront, vous pouvez ajouter la feuille de groupe GROUP dans votre fichier d’import, définir le champ isNew sur TRUE dans la feuille de groupe, puis indiquer un ID numérique pour le nouveau groupe dans la colonne ID. Le champ setGroupID pour le nouveau projet doit correspondre à l’ID numérique pour le nouveau groupe.
Exemple : pour un projet, la valeur affichée dans la colonne setGroupID doit correspondre à l’un des éléments suivants :
- GUID d’un groupe existant dans votre instance Workfront.
- Valeur (nombre) dans la colonne ID de la feuille de groupe GROUP si vous créez un groupe au cours de l’import.
-
-
Saisissez des valeurs pour les champs obligatoires et pour les autres champs que vous souhaitez renseigner lors de l’import.
-
(Facultatif) Pour ajouter des données personnalisées, procédez comme suit :
-
Créez une colonne pour chaque champ personnalisé que vous souhaitez inclure dans le processus d’import.
-
Nommez chaque nouvelle colonne en fonction de son champ personnalisé correspondant comme suit : DE:[Nom du champ personnalisé tel qu’il apparaît dans Workfront]. Par exemple, vous pouvez créer le champ personnalisé suivant : « DE:Departments » (Services).
-
Dans la colonne setCategoryID, saisissez le GUID du formulaire personnalisé existant sur lequel réside ce champ personnalisé. Ce champ est obligatoire lors de l’import de données personnalisées.
-
Si vous devez ajouter plusieurs valeurs de données dans un champ personnalisé (comme des cases d’option, des cases à cocher ou des listes), utilisez le délimiteur de données personnalisées à barre verticale « | » répertorié dans l’onglet Préférences pour séparer les valeurs.
Exemple : saisissez A|D sous la colonne DE:Departments pour renseigner les services A et D dans votre formulaire personnalisé.
-
Inclure des dates include-dates
Workfront peut traiter la plupart des formats de date. Cependant, vous devez vous assurer que la colonne de date de la feuille de calcul est formatée en tant que date. L’import échoue si la colonne est formatée en tant que général, nombre ou texte.
Workfront accepte également que l’heure soit incluse avec la date.
Par exemple : 07/10/2022 01:30 ou 07/10/2022 1:00 PM (au format 12 heures).
Si vous ne mettez pas d’heure avec la date, Workfront effectue l’une des opérations suivantes :
- Workfront suppose que l’heure est 12:00 AM (minuit). Pour que le résultat de la date soit visible, le fuseau horaire du système doit correspondre à votre fuseau horaire.
- S’il se trouve sur un objet associé à un planning, l’heure est décalée au premier moment autorisé par le planning.
Utiliser des caractères génériques use-wildcards
Vous pouvez utiliser les caractères génériques suivants lorsque vous renseignez votre feuille de calcul de modèle Kickstart :
Lorsqu’il est utilisé dans un champ setDate, ce caractère générique fixe la date à minuit le jour de l’import du Kickstart.
Vous pouvez modifier le caractère générique en utilisant la syntaxe standard autorisée avec le caractère générique sur un filtre.
Exemple : si vous souhaitez qu’un projet commence le lundi de la semaine où il est importé, quel que soit le jour où vous effectuez l’import, vous pouvez utiliser $$TODAYbw. La date de début prévue de votre projet est alors fixée au dimanche à 00h00. Comme le planning du projet n’autorise probablement pas le travail à ce moment-là, il commencera lundi matin à 9h00.
Lorsqu’il est utilisé dans un champ setDate, ce caractère générique définit la date en fonction du moment où vous créez l’enregistrement lors de l’import du Kickstart.
Vous pouvez modifier le caractère générique en utilisant la syntaxe standard autorisée avec le caractère générique sur un filtre.
Exemple : si vous souhaitez qu’un projet démarre 3 heures après son import, vous pouvez utiliser $$NOW+3h.
Ce caractère générique a été ajouté spécifiquement pour les imports des utilisateurs et utilisatrices Kickstart. La création d’un compte Workfront génère la création d’un utilisateur ou d’une utilisatrice disposant d’un niveau d’accès à l’administration du système. Le nom d’utilisateur ou d’utilisatrice attribué à l’administration par défaut peut être utilisé comme préfixe lors de la création d’autres utilisateurs et d’autres utilisatrices dans le compte.
Les noms d’utilisateur ou d’utilisatrice doivent être uniques pour toute la clientèle. Cette option est très utile lorsque vous avez plusieurs personnes avec des noms d’utilisateur ou d’utilisatrice très courants, tels que John Smith, dont le nom d’utilisateur peut être « jsmith ». En ajoutant l’affectation du nom d’utilisateur ou d’utilisatrice en préfixe au nom par défaut affecté à l’administration, vous garantissez que chaque nom d’utilisateur ou d’utilisatrice est unique (par exemple : $$CUSTOMER.jsmith).
Conseil : pour vous assurer que les noms d’utilisateur ou d’utilisatrice sont uniques à l’échelle du système, saisissez l’adresse e-mail de la personne dans le champ setUsername.
Substitution des noms d’attribut pour les identifiants attribute-name-substitution-for-ids
Même si l’usage des identifiants est préférable lorsque cela est possible, il n’est pas toujours pratique de les transférer d’une feuille à l’autre lors de la configuration de la valeur d’un setAttributeID. Vous pouvez référencer des valeurs par nom en modifiant simplement l’en-tête de colonne.
Exemples :
-
Import de projet
Lors de l’import de projets, définissez les setGroupID des projets en allant sur la feuille de groupe GROUP, en notant les ID de groupe respectifs et en les collant dans les cellules correctes (colonne setGroupID) sur la feuille de projet PROJ.
Cette méthode fonctionne bien avec quelques groupes et projets ; cependant, elle devient impraticable lorsque le nombre de projets et de groupes augmente.
Pour substituer le nom de l’attribut dans l’exemple décrit ci-dessus, vous devez remplacer l’en-tête de colonne setGroupID par le nom #setGroupID GROUP. Vous pouvez ensuite référencer le groupe de chaque projet par nom.
note note NOTE L’option permettant d’utiliser la substitution du nom d’attribut est limitée aux références pour les enregistrements existants uniquement. Vous ne pouvez pas utiliser la substitution de nom pour les objets que vous créez dans le même import. -
Import d’utilisateur ou d’utilisatrice
Lors de l’import d’utilisateurs et d’utilisatrices, renseignez le setRoleID à partir de la liste de rôles de l’onglet de rôle ROLE.
Certains ID de rôle concernent des enregistrements déjà présents dans le compte, tandis que d’autres sont créés lors de l’import.
Pour les nouveaux enregistrements d’utilisateurs et d’utilisatrices affectés aux rôles existants, vous pouvez utiliser la substitution de nom. Pour les nouveaux enregistrements d’utilisateurs et d’utilisatrices affectés aux rôles nouvellement importés, il est impossible d’utiliser la substitution de nom.
Voici comment utiliser les deux méthodes sur le même fichier d’import :
-
Ajoutez une colonne dans la feuille de calcul située à gauche de la colonne setRoleID.
-
Donnez à la nouvelle colonne le nom #setRoleID ROLE.
-
Pour les affectations de rôle aux enregistrements existants, saisissez les noms de rôle dans la colonne au nom #setRoleID ROLE.
Pour les affectations de rôles aux nouveaux enregistrements de rôle, saisissez l’ID que vous avez affecté dans la feuille de « rôle ROLE » dans « setRoleID ».
-
Importer des données de feuille de calcul dans Workfront
Une fois que vous avez renseigné les données du modèle Excel, vous pouvez les charger dans Workfront.
L’import rapide prend en charge les types de fichiers suivants :
-
Excel (.xls ou .xlsx)
-
Fichier compressé (.ZIP) (contenant uniquement des fichiers .xlsx ou .xls)
note note NOTE Vous devez utiliser un fichier .ZIP lors de l’import de feuilles de calcul Excel qui référencent les objets suivants : - Rapports
- Documents
- Avatars
- Afficher, filtrer ou regrouper des fichiers de propriétés
Lors de l’utilisation d’un fichier d’import compressé, le fichier .ZIP doit porter le même nom que le fichier .xlsx ou .xls, et tous les fichiers doivent être au même niveau de structure (pas de dossiers).
Pour importer les données de feuille de calcul du modèle dans Workfront, procédez comme suit :
-
Cliquez sur l’icône Menu principal dans le coin supérieur droit d’Adobe Workfront, ou (si disponible), cliquez sur l’icône Menu principal dans le coin supérieur gauche, puis cliquez sur Configuration .
-
Cliquez sur Système > Importer des données (Kickstarts).
-
Dans la section Charger des données avec la feuille de calcul Kickstart, cliquez sur Choisir un fichier, puis parcourez et sélectionnez la feuille de calcul renseignée.
-
Cliquez sur Charger.
Si le chargement du fichier Excel prend plus de 5 minutes dans Workfront, l’application expire et Workfront ne peut pas charger le fichier.
Essayez d’importer vos données en lots d’objets plus petits.
-
(Le cas échéant) Si vous utilisez Workfront Fusion, vous pouvez désormais activer vos FLO ou scénarios.