Scénario de lancement : importer des champs personnalisés à plusieurs options dans Workfront

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 .

Développez System dans le menu de gauche, puis cliquez sur Export Data (Kick-Starts).

Sélectionnez Données personnalisées dans la section Éléments à inclure.

Exemple d’image dans l’environnement de prévisualisation :

Exemple d’image dans l’environnement de production :

Choisissez fichier .xlsx dans la section Format de téléchargement.

Cliquez sur Télécharger. Un fichier .xlsx est téléchargé sur votre ordinateur. Accédez-y et ouvrez-le.

Examinez le fichier téléchargé et notez les détails suivants :

• Le fichier contient plusieurs feuilles. Vous n’aurez peut-être pas besoin de connaître les informations contenues dans chaque feuille, mais vous utiliserez certaines feuilles pour importer vos informations. Prenez le temps de vous familiariser avec leur contenu, et en particulier avec le format du contenu dans chaque feuille.
• Accordez une attention particulière aux noms des colonnes et au format d’affichage des données de chaque colonne.
• Vous ne devez pas modifier les noms ou l’ordre des colonnes dans aucune des feuilles. Les en-têtes de colonne indiquent les champs que vous devez remplir avec vos informations, dans chaque ligne. Si l’en-tête de colonne s’affiche en gras, il s’agit d’un champ obligatoire. Vous devez donc y inclure des informations.

• Conservez le fichier téléchargé à des fins de référence ultérieure et passez à la section suivante.

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 .

Développez Système dans le menu de gauche.

Cliquez sur Importer des données (lancement).

Dans la zone Télécharger une feuille de calcul de démarrage rapide vide, cochez la case Données personnalisées et cliquez sur Télécharger.

Exemple d’image dans l’environnement de prévisualisation :

Exemple d’image dans l’environnement de production :

Un fichier de lancement vierge est téléchargé sur votre ordinateur.

Ouvrez la feuille de calcul Excel que vous avez téléchargée dans la section précédente et remarquez qu’il y a plusieurs feuilles. Chaque feuille représente un objet dans l’application.

note info
INFO
Par exemple : Paramètre (qui fait référence à un champ personnalisé), Option de paramètre(qui fait référence à l’option Champ personnalisé), Catégorie (qui fait référence à un formulaire personnalisé).
Vous devez écrire les noms des objets et leurs attributs au format pris en charge par la base de données Workfront.
Pour plus d’informations sur la signification de ces objets, voir Glossaire de la terminologie Adobe Workfront.
Pour plus d’informations sur les noms des objets dans la base de données Workfront, voir Explorateur d’API.

Assurez-vous que les informations suivantes sont correctement formatées :

• La première ligne de chaque feuille doit rester vide, sinon l’import génère une erreur.

• Les en-têtes de colonne de chaque feuille représentent les attributs des objets qui peuvent être définis lors d’un import. Tous les en-têtes de colonne doivent rester dans l’ordre où ils se trouvent lorsque vous exportez la feuille. Ils ne peuvent pas être renommés.

• Les en-têtes de colonne en gras sont des champs obligatoires qui doivent avoir une valeur.

  note tip
  TIP
  Certaines colonnes sont obligatoires, bien qu’elles ne soient pas en gras. Par exemple, les colonnes isNew et ID ne sont pas en gras, mais il s’agit de champs obligatoires.

Sélectionnez la feuille **PARAM Parameter** et ajoutez des informations sur les nouveaux champs personnalisés dans les colonnes obligatoires suivantes :

• isNew = saisissez TRUE dans cette colonne pour chaque ligne qui représente un nouveau champ personnalisé. Cela indique que le champ est nouveau et qu’il n’existe pas dans Workfront.

  note tip
  TIP
  Si une ligne représente un champ existant déjà dans Workfront, vous devez saisir isNew = FALSE.

• ID = doit être un nombre unique pour chaque ligne qui représente un nouveau champ. Vous pouvez utiliser n’importe quel nombre commençant par 1, à condition que chaque nouveau champ ait un numéro unique.

• setDataType = pour chaque ligne représentant un nouveau champ, saisissez le type de données pris en charge par le champ. Le type de données doit être renseigné tel qu’il apparaîtrait dans la base de données. Sélectionnez l’un des types de données suivants :

  • NMBR pour un nombre
  • CURC pour une devise
  • TEXT pour du texte

• **setDisplaySize**= la taille d’affichage (« setDisplaySize ») pour les champs personnalisés de plusieurs options est toujours 0.

• setDisplayType = pour chaque ligne représentant un nouveau champ, saisissez le type d’affichage du champ. Le type d’affichage doit être renseigné tel qu’il apparaîtrait dans la base de données.

  Pour les champs personnalisés à plusieurs options, sélectionnez l’une des options suivantes :

  • MULT pour une liste déroulante à sélection multiple
  • SLCT pour une liste déroulante
  • RDIO pour des cases d’option
  • CHCK pour des cases à cocher

  note tip
  TIP
  Pour connaître le type de données et le type d’affichage, reportez-vous à la section Explorateur d’API, développez l’objet Paramètre et recherchez ces attributs sous l’onglet champs.

• setName = saisissez le nom des champs personnalisés tel que vous souhaitez qu’il s’affiche dans Workfront.

  note info
  INFO
  Par exemple, nous pouvons importer deux champs personnalisés, appelés Marque, un champ de case à cocher et Médias, un champ de case d’option.

• Les colonnes setName et setValue contiennent généralement les mêmes informations et doivent refléter les noms souhaités dans l’interface Workfront pour votre nouveau champ.

La valeur d’un champ est le nom qui apparaît dans les rapports, par exemple, tandis que le nom s’affiche dans les formulaires personnalisés associés aux objets.

Pour plus d’informations, voir Création d’un formulaire personnalisé.

Sélectionnez la feuille POPT Parameter Options et ajoutez des informations sur les options de chaque champ personnalisé dans les colonnes obligatoires suivantes :

• isNew = saisissez TRUE dans cette colonne pour chaque ligne qui représente une nouvelle option de champ.

  note tip
  TIP
  Si une ligne représente une option existante, vous devez saisir isNew = FALSE.

• ID = doit être un nombre unique pour chaque ligne qui représente une nouvelle option. Vous pouvez utiliser n’importe quel nombre commençant par 1, à condition que chaque nouvelle option ait un numéro unique.

• setIsDefault = saisissez TRUE pour les options que vous souhaitez afficher par défaut, et FALSE pour toutes les autres options, pour chaque champ. Par exemple, nous voulons que Nike soit l’option par défaut pour Marque et Impression l’option par défaut pour Médias.

  note tip
  TIP
  Vous ne pouvez avoir qu’une seule option par défaut pour chaque champ.

• setParameterID = les options correspondant au champ personnalisé Marque comportent un setParameterID de 1 et les options correspondant au Média ont un setParameterID ​de 2. Les feuilles PARAM et POPT se croisent pour indiquer quelles options appartiennent à quel champ personnalisé.

• setDisplayOrder= la colonne d’ordre d’affichage indique l’ordre dans lequel les options s’afficheront dans votre champ personnalisé. Vous pouvez commencer par 1 et continuer par ordre croissant pour toutes les options, quels que soient les champs auxquels elles appartiennent. L’important ici est d’avoir des nombres uniques pour chaque option.

• Les colonnes setLabel et **setValue** contiennent généralement les mêmes informations et doivent refléter les noms souhaités dans l’interface d’utilisation de Workfront. La valeur d’une option est le nom qui s’affiche dans les rapports, par exemple, tandis que le libellé s’affiche dans les formulaires personnalisés lorsqu’il est associé à un objet. Pour plus d’informations, voir Création d’un formulaire personnalisé.

• setIsHidden = saisissez TRUE si vous souhaitez que l’une des options soit masquée.

(Facultatif) Si vous souhaitez également créer un formulaire personnalisé dans lequel vous pourrez ajouter les nouveaux champs ultérieurement, sélectionnez la feuille CTGY Category et mettez à jour les colonnes requises suivantes pour les informations de formulaire personnalisées :

• isNew = saisissez TRUE dans cette colonne pour chaque ligne qui représente un nouveau formulaire personnalisé.
• ID = saisissez un nombre unique pour chaque ligne représentant un nouveau formulaire. Vous pouvez utiliser n’importe quel nombre commençant par 1, à condition que chaque nouvelle option ou ligne ait un numéro unique.
• setGroupID = ajoutez l’ID de groupe de votre groupe interne, ou tout autre groupe du système dont vous souhaitez que les membres aient accès à ce formulaire. Champ obligatoire.

Pour découvrir l’ID d’un groupe, vous pouvez créer un rapport Groupe et ajouter l’ID dans la vue ou accédez à un groupe et recherchez l’URL du groupe. L’identifiant de groupe se trouve dans l’URL de la page du groupe. Par exemple, si l’URL du groupe est https://companyName.my.workfront.com/group/575b000800467a6f66e747932c807464/members, l’identifiant de groupe est 575b000800467a6f66e747932c807464.

• setCatObjCode ​= il s’agit du code d’objet du type d’objet pour lequel vous souhaitez que le formulaire soit créé. Saisissez un code parmi les options suivantes :

  • CMPY pour l‘entreprise
  • TASK pour la tâche
  • PROJ pour le projet
  • PORT pour le portfolio
  • PRGM pour le programme
  • USER pour l’utilisateur ou utilisatrice
  • DOCU pour le document
  • OPTASK pour le problème
  • EXPNS pour les frais
  • ITRN pour l’itération
  • BILL pour les enregistrements de facturation
  • GROUP pour le groupe

  note note
  NOTE
  Dans le cas des formulaires à plusieurs objets, saisissez le premier objet que vous sélectionnez lors de la création d’un formulaire dans l’interface d’utilisation. Par exemple, définissez setCatObjCode sur TASK, si vous voulez sélectionner Tâche dans l’interface de Workfront, puis Problème, Portfolio, etc., mais que vous ne souhaitez pas que le formulaire soit disponible pour les projets.

• setName = nom du formulaire personnalisé tel que vous souhaitez le voir apparaître dans l’interface de Workfront.

  

Enregistrez la feuille de calcul au format .xls ou .xlsx sur votre ordinateur. Votre feuille de calcul Excel est remplie et prête à être importée dans Workfront.

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 (Démarrages).

Cliquez sur Choisir un fichier sous la section Charger des données avec une feuille de calcul Kickstart.

Recherchez la feuille de calcul Excel que vous avez préparée sur votre ordinateur et sélectionnez-la lorsque vous la trouvez. Lorsque Workfront reconnaît le fichier, le bouton Télécharger devient bleu.

Cliquez sur Charger.

Une notification indiquant que l’importation a réussi s’affiche. Selon le volume d’informations que vous importez, cette étape peut prendre quelques secondes à une minute.

Les nouveaux champs et formulaires personnalisés se trouvent désormais dans votre système Workfront. Vous pouvez les trouver dans la zone Formulaires personnalisés de Configuration.

Pour plus d’informations sur l’ajout de champs aux formulaires personnalisés, voir Création d’un formulaire personnalisé.

(Le cas échéant) Si l’import a échoué, vous recevez un message d’erreur signalant le problème. Essayez d’identifier le champ, la feuille et le numéro de ligne dans lesquels le problème s’est produit, corrigez les informations du fichier Excel, puis essayez de réimporter le fichier.

(Le cas échéant) Selon le problème, comme indiqué dans le message d’erreur, certaines informations ont peut-être déjà été importées. Vous devez effectuer l’une des opérations suivantes avant de pouvoir réimporter la feuille :

• Supprimez les informations importées de Workfront à partir de la zone Formulaires personnalisés, puis apportez la correction indiquée par le message d’erreur.
• Indiquez qu’un champ ou un formulaire se trouve déjà dans le système pour les champs ou formulaires déjà importés, puis apportez la correction.
  Pour indiquer qu’un champ ou un formulaire personnalisé se trouve déjà dans Workfront, vous devez vous assurer que le champ inNew est marqué comme FALSE dans les feuilles contenant des informations sur le formulaire (CTGY) ou le champ (PARAM) dans la feuille de démarrage de l’import.