DocumentationWorkfrontGuide Workfront

Nouveautés de la version 12 de l’API

Last update: Tue Sep 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur

Workfront a publié la version 12 de l’API le 12 novembre 2020. La version 12 de l’API présente les changements suivants par rapport à la version 11.

Ressources ajoutées

Les ressources suivantes sont nouvelles dans la version 12 de l’API Workfront.

Un objet BreadCrumb représente un élément dans la hiérarchie parent/enfant d’un élément de travail Adobe Workfront. Les chemins de navigation indiquent comment un élément de travail s’intègre à la structure plus vaste des portfolios, projets, problèmes et tâches.

Pour plus d’informations sur les chemins de navigation dans Workfront, voir Vue d’ensemble des chemins de navigation dans la nouvelle expérience Adobe Workfront

  • getObjectHierarchy

RichTextParameterValue richtextparametervalue

Les champs de texte enrichi sont désormais disponibles sur un plus grand nombre d’objets. L’objet RichTextParameterValue a été ajouté à Workfront pour prendre en charge cette disponibilité.

Pour plus d’informations, voir Champs de texte enrichi dans l’API Adobe Workfront.

  • ID
  • ID
  • objCode

Ressources supprimées

Aucune ressource n’a été supprimée pour la version 12 de l’API.

Ressources modifiées

Les ressources suivantes ont été modifiées pour la version 12 de l’API Workfront.

AccessLevel accesslevel

Un objet AccessLevel est associé à des personnes et décrit le jeu d’autorisations AccessLevelPermissions qui déterminent ce à quoi la personne peut accéder.

Pour plus d’informations sur les niveaux d’accès, voir Fonctionnement des niveaux d’accès.

AccessLevelPermissions accesslevelpermissions

Un objet AccessLevelPermissions représente une autorisation spécifique d’accès, de création ou de modification d’un objet Workfront. Ces autorisations peuvent ensuite être associées à un niveau d’accès.

Champs directs

AccessRequest accessrequest

Si une personne n’a pas accès à un objet Workfront dont elle a besoin, elle peut demander l’accès à cet objet. L’objet AccessRequest représente cette requête.

Champs directs

AccessRule accessrule

Un objet AccessRule représente un jeu de règles dans les niveaux d’accès personnalisés qui détermine comment les personnes peuvent partager les projets qu’elles créent.

Champs directs

ActivityLog activitylog

Un objet ActivityLog est une liste complète de toutes les activités qui ont eu lieu dans un compte Workfront Proof donné.

Opérations

L’opération suivante a été supprimée de l’objet ActivityLog :

  • ADD

AnnouncementAttachment announcementattachment

Un objet AnnouncementAttachment représente un fichier qui a été joint à une annonce Workfront.

Pour en savoir plus sur les pièces jointes aux annonces, voir Envoyer des annonces.

Champs directs

  • fileExtension

    Ajout des valeurs possibles :

    • qdoc (enum.fileextension.qdoc)

    • qslides (enum.fileextension.qslides)

    • qsheet (enum.fileextension.qsheet)

Approbation approval

Un élément de travail donné, tel qu’une tâche, un document ou une feuille de temps, peut exiger qu’une personne en charge de la supervision ou une autre personne valide l’élément de travail. Un objet Approbation représente l’action de validation d’un élément de travail.

Champs directs

  • backlogOrder

    Suppression des indicateurs suivants :

    • DYNAMIC,

    • LAZY_READ,

    • NOT_GROUPABLE

  • groupID

    Les indicateurs suivants ont été ajoutés.

    • AUTO_LOAD,

    • DYNAMIC,

    • READ_ONLY

  • workEffort

    Ce champ a été ajouté et indique si la réalisation d’une tâche demande à la personne un effort quotidien petit, moyen ou grand. Les valeurs possibles sont les suivantes :

    • 1 (petit)

    • 2 (moyen)

    • 3 (grand)

    Pour plus d’informations sur l’effort de travail dans Workfront, voir Vue d’ensemble de l’effort de travail.

CalendarSection calendarsection

Une section de calendrier est un rapport de calendrier.

Pour plus d’informations sur les rapports de calendrier, voir Vue d’ensemble des rapports de calendrier.

Champs directs

Les champs suivants ont été ajoutés à l’objet CalendarSection pour prendre en charge la nouvelle fonctionnalité d’utilisation de dates personnalisées dans les rapports de calendrier.

Pour plus d’informations, voir Utiliser des champs de date personnalisés dans un rapport de calendrier.

  • customDate

  • customEndDateParameterID

  • customStartDateParameterID

  • ignoreActualDates

Entreprise company

Un objet Company représente une organisation composée d’un ensemble de personnes.

Pour plus d’informations sur les entreprises, voir Créer et modifier des entreprises.

Champs directs

  • groupID

    ID du groupe auquel l’entreprise est associée.

Champs de référence

  • groupe

    Groupe auquel l’entreprise est associée. L’association d’une entreprise à un groupe permet à l’administrateur ou administratrice de groupes d’étendre l’accès et les autorisations du groupe à l’entreprise.

Client customer

Un objet Customer représente une organisation qui utilise une instance de Workfront.

Actions

  • productEnabled

    Cette action prend un argument CustomerProductTypeEnum et renvoie un booléen qui indique si le client ou la cliente a un compte pour ce produit.

CustomerPreferences customerpreferences

Un objet CustomerPreferences représente l’ensemble des préférences définies par un client ou une cliente pour son instance de Workfront.

Champs directs

  • name

    Ajout des valeurs possibles :

    • password:zoomInegrationEnabled (Activer l’intégration Zoom dans le flux de mises à jour)
    • password:quipIntegrationEnabled (config.general.quip.enabled)

Document document

Un objet Document représente un fichier (tel que du matériel écrit, des images ou d’autres formes d’informations).

Actions

  • createLinkedProofVersion

    Ajouté(e)(s)

DocumentVersion documentversion

Un objet DocumentVersion représente une version spécifique d’un fichier (comme du contenu écrit, des images ou d’autres formes d’informations).

Pour plus d’informations sur les versions des documents, voir Charger une nouvelle version d’un document.

Champs directs

  • externalIntegrationType

    Valeur possible supprimée :

    • QUIP (Quip)

  • proofDecision

    Ajouté(e)(s)

Actions

Les actions suivantes ont été ajoutées à l’objet Document :

  • getDocumentReviewerDecision

    Cette action prend l’argument documentVersonID (chaîne) et renvoie une carte indiquant la décision du réviseur ou de la réviseuse.

  • setDocumentReviewerDecision

    Cette action prend les arguments suivants :

    • documentVersionID (string)

    • reviewerDecision (string)

    • comment (string)

Groupe group

Un objet Group représente un ensemble d’utilisateurs et utilisatrices et d’équipes. Les groupes représentent souvent la structure des services.

Champs directs

  • businessLeaderID

    ID de la personne à la tête de l’entreprise affectée au groupe.

Champs de référence

  • businessLeader

    Personne à la tête de l’entreprise affectée au groupe. La ou le responsable commercial est la personne qui prend des décisions commerciales pour le groupe.

    Pour plus d’informations sur les personnes à la tête d’une entreprise, voir la section Vue d’ensemble des personnes à la tête d’une entreprise.

Actions

  • assignMultiple

    Cette action prend les arguments suivants :

    • userIDs (string[])

    • roleIDs (string[])

    • teamID (string)

  • getGroupMembers

  • updateMembersList

    Cette action prend les arguments suivants :

    • newMemberIDs (string[])

    • removedMemberDs (string[])

LinkedFolder linkedfolder

Un objet LinkedFolder représente un dossier lié à un fournisseur de documents externe, tel que Google Drive ou Dropbox.

Pour plus d’informations sur les dossiers liés, voir Lier des documents à partir d’applications externes.

Champs directs

  • externalIntegrationType

    Valeur possible supprimée :

    • QUIP (Quip)

TâcheOp optask

Un objet OpTask est généralement appelé Problème. Un problème est un élément de travail qui indique généralement qu’un problème empêche la réalisation d’une tâche ou d’un projet. Il peut également s’agir d’une demande de centre d’assistance. Les ordres de modification, les requêtes et les bugs sont également des problèmes.

Champs directs

  • backlogOrder

    L’ordre indique la position d’une tâche ou d’une histoire dans la liste d’attente Agile.

    Ce champ a supprimé les indicateurs suivants :

    • DYNAMIC,
    • LAZY_READ,
    • NOT_GROUPABLE :
Actions

Ces actions ont ajouté l’argument status pour prendre en charge la nouvelle fonctionnalité du bouton Démarrer, qui modifie le statut d’un élément de travail lorsqu’une personne clique sur le bouton pour indiquer qu’elle a commencé à travailler sur l’élément.

Pour plus d’informations, voir Remplacer le bouton Travailler sur ce projet par un bouton Démarrer.

  • acceptWork

  • unacceptWork

Paramètre parameter

Un objet de paramètre est un champ personnalisé.

La ressource Paramètre a ajouté l’indicateur SHARABLE.

Pour plus d’informations sur les champs personnalisés, voir Créer ou modifier un formulaire personnalisé dans Créer ou modifier un formulaire personnalisé.

Champs directs
Champs de collection

  • accessRules

    Ajouté(e)(s)

Champs par défaut

  • label

    Ajouté(e)(s)

Portfolio portfolio

Un objet Portfolio est un ensemble de projets qui rivalisent pour les mêmes ressources, généralement de l’argent ou des personnes pour les mener à bien.

Pour plus d’informations sur les portfolios, voir Vue d’ensemble des portfolios dans Adobe Workfront.

Champs directs

  • groupID

    ID du groupe auquel le portfolio est associé.

Champs de référence

  • groupe

    Groupe auquel le portfolio est associé.

Programme program

Un objet de programme est un sous-ensemble de projets d’un portfolio, où des projets similaires peuvent être regroupés.

Champs directs

  • groupID

    ID du groupe auquel le programme est associé.

Champs de référence

  • groupe

    Groupe auquel le programme est associé.

QueueDef queuedef

Un objet QueueDef représente une file d’attente, qui est un projet qui a été publié dans la zone Centre d’assistance pour permettre aux utilisateurs et utilisatrices de lui soumettre des problèmes.

Pour plus d’informations sur les files d’attente des demandes, voir Créer une file d’attente des demandes.

Champs directs

ScheduledReport scheduledreport

Un objet ScheduledReport représente un rapport qui a été configuré pour être diffusé.

Champs directs

  • format

    Ajout des valeurs possibles :

    • qdoc (enum.fileextension.qdoc)

    • qslides (enum.fileextension.qslides)

    • qsheet (enum.fileextension.qsheet)

ScoreCardQuestion scorecardquestion

Un objet ScoreCardQuestion représente une question qui a été ajoutée à une carte de performance. Ces questions sont généralement définies par la personne gestionnaire du portfolio et leurs réponses lui permettent de comprendre dans quelle mesure un projet s’aligne sur les objectifs du portfolio.

Pour plus d’informations sur les questions relatives aux cartes de performance, voir Créer une carte de performance.

Champs directs

Tâche task

Un objet Task représente un élément de travail qui doit être exécuté comme une étape vers la réalisation d’un objectif final (achèvement d’un projet).

Champs directs

  • workEffort

    Ce champ a été ajouté et indique si la réalisation d’une tâche demande à la personne un effort quotidien petit, moyen ou grand. Les valeurs possibles sont les suivantes :

    • 1 (petit)

    • 2 (moyen)

    • 3 (grand)

    Pour plus d’informations sur l’effort de travail dans Workfront, voir Vue d’ensemble de l’effort de travail.

Actions

Ces actions ont ajouté l’argument status pour prendre en charge la nouvelle fonctionnalité du bouton Démarrer, qui modifie le statut d’un élément de travail lorsqu’une personne clique sur le bouton pour indiquer qu’elle a commencé à travailler sur l’élément.

Pour plus d’informations, voir Remplacer le bouton Travailler sur ce projet par un bouton Démarrer.

  • acceptWork

  • unacceptWork

Equipe team

Un objet Team est un ensemble d’utilisateurs et d’utilisatrices pouvant être affectés à un élément de travail.

Champs directs

Les champs suivants ont été ajoutés à la ressource Équipe :

  • groupID

    Ce champ associe une équipe à un groupe. Cela permet d’identifier l’équipe comme faisant partie du groupe et permet à l’équipe d’administration du groupe de gérer les équipes.

  • workOnItStatusChange

    Il s’agit d’un paramètre booléen qui indique si le bouton Travailler sur cette tâche de l’équipe a été configuré à la manière d’un bouton Démarrer. Lorsqu’une personne membre de l’équipe clique sur le bouton Démarrer pour commencer à travailler sur un élément de travail, le statut de l’élément passe de Nouveau à un statut configuré dans les paramètres de l’équipe.

  • Les champs suivants permettent de spécifier des statuts personnalisés pour le bouton Démarrer sur les éléments de travail individuels.

    • workOnItOpTaskBugReportStatuses

    • workOnItOpTaskChangeOrderStatuses

    • workOnItOpTaskIssueStatuses

    • workOnItOpTaskRequestStatuses

      workOnItTaskStatuses

    Pour plus d’informations sur le bouton Démarrer, voir la section Remplacer le bouton Travailler sur cette tâche par un bouton Démarrer.

Champs de référence

Le champ suivant a été ajouté à la ressource Équipe :

  • group

TemplateTask templatetask

Un objet TemplateTask représente une tâche qui fait partie d’un modèle. Les tâches de modèle deviennent des tâches dans le projet où le modèle est utilisé.

Pour plus d’informations sur les tâches modèles, voir la section Modifier une tâche de modèle.

Champs directs

  • workEffort

    Ce champ a été ajouté et indique si la réalisation d’une tâche demande à la personne un effort quotidien petit, moyen ou grand. Les valeurs possibles sont les suivantes :

    • 1 (petit)

    • 2 (moyen)

    • 3 (grand)

    Pour plus d’informations sur l’effort de travail dans Workfront, voir la section Vue d’ensemble de l’effort de travail.

Feuille de temps timesheet

Un objet Timesheet représente une feuille de temps virtuelle qui permet aux utilisateurs et utilisatrices de saisir les heures effectives travaillées pour les tâches, les projets et les types d’heures supplémentaires.

Pour plus d’informations sur les feuilles de temps, voir la section Vue d’ensemble des feuilles de temps.

Champs principaux

Le champ suivant a été supprimé de la ressource Feuille de temps :

  • objcode

Mettre à jour

Champs directs

l’utilisateur ou de l’utilisatrice user

Un objet User représente une personne disposant d’un compte dans Workfront qui peut se connecter et interagir avec le système.

Champs directs

Les champs suivants ont été ajoutés à la ressource Utilisateur ou utilisatrice :

  • actualDeactivationDate

    Il s’agit de la date et de l’heure auxquelles la personne a été désactivée.

    Pour plus d’informations sur les personnes désactivées, voir Désactiver ou réactiver une personne.

  • alignAccessType

    Ce champ indique l’accès de la personne aux Objectifs Workfront. Les valeurs possibles sont les suivantes :

    • Pas d’accès

    • Afficher

    • Modifier

Actions

L’action suivante a été ajoutée à la ressource Utilisateur ou utilisatrice :

  • getUserAccessPermissionsByObjCode

    Cette action prend en compte les arguments suivants :

    • ids (string)

    • objCode (string)

Travail work

Un objet Work est une interface commune dont Task et OpTask héritent tous deux et qui partage le code commun entre les deux.

Champs directs

  • backlogOrder

    L’ordre indique la position d’une tâche ou d’une histoire dans la liste d’attente Agile.

    Ce champ a supprimé les indicateurs suivants :

    • DYNAMIC,

    • LAZY_READ,

    • NOT_GROUPABLE

  • groupID

    Ce champ a ajouté les indicateurs suivants :

    • AUTO_LOAD,

    • DYNAMIC,

    • READ_ONLY

  • workEffort

    Ce champ a été ajouté et indique si la réalisation d’une tâche demande à la personne un effort quotidien petit, moyen ou grand. Les valeurs possibles sont les suivantes :

    • 1 (petit)

    • 2 (moyen)

    • 3 (grand)

    Pour plus d’informations sur l’effort de travail dans Workfront, voir Vue d’ensemble de l’effort de travail.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43