DocumentationWorkfrontGuide Workfront

Nouveautés de la version 15 de l’API

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

Créé pour :

  • Développeur

Adobe Workfront a publié l’API version 15 le 14 juin 2022. La version 15 de l’API présente les changements suivants par rapport à la version 14.

Ressources ajoutées

Initiative (INITIV)

L’objet Initiative crée des estimations dans le planificateur de scénarios Workfront pour le type et le nombre de fonctions, les coûts fixes et le bénéfice prévu.

Pour plus d’informations sur les initiatives, voir Vue d’ensemble des initiatives dans le planificateur de scénarios.

Champs directs

  • customerID

    Il s’agit d’un objet interne.

  • duration

    Durée entre endDate et startDate.

  • endDate

    Date d’achèvement prévue de l’initiative.

  • entryByID

    Identifiant associé à l’utilisateur ou l’utilisatrice qui a envoyé la demande.

  • ID

    Identifiant associé à l’action

  • initiativeID

    Identifiant associé à l’initiative.

  • lastPublishedDate

    Date de la dernière publication de l’initiative dans le planificateur de scénarios Workfront.

  • name

    Nom de l’initiative

  • planID

    Identifiant du plan associé à l’initiative.

  • planName

    Nom du plan associé à l’initiative.

  • projectID

    Identifiant du projet associé à l’initiative.

  • scenarioID

    Identifiant du scénario dans le planificateur de scénarios Workfront associé à l’initiative.

  • startDate

    Date de début prévue de l’initiative.

Champs de référence

  • customer

  • enteredBy

  • project

Champs principaux

  • ID

  • name

  • objCode

Opérations

  • COUNT

  • GET

  • REPORT

  • SEARCH

IssueDef (ISSDEF)

L’objet IssueDef représente un ensemble de données concernant le format des problèmes. Cet objet peut être associé à des projets ou des modèles et affecte les problèmes ajoutés à ce projet ou modèle.

Champs directs

  • ID

  • isInlineAddEnabled

Champs principaux

  • ID

  • objCode

ObjectIntegration (OBJINT)

Dans certains cas, il est possible de lier des éléments de travail Workfront directement aux objets d’un logiciel externe. L’objet ObjectIntegration représente ce lien.

Champs directs

  • customerID

    Il s’agit d’un objet interne.

  • entryDate

    Date et heure auxquelles l’intégration ObjectIntegration a été saisie dans le système Workfront.

  • ID

    Identifiant Workfront unique de l’objet ObjectIntegration spécifique.

  • integrationType

    Logiciel externe avec lequel l’objet ObjectIntegration crée un lien. Les valeurs possibles sont les suivantes :

    • JIRA

    • SALESFORCE

    • ANAPLAN

  • linkedObjectID

  • objID

    Objet dans Workfront auquel ObjectIntegration est associé.

  • objObjCode

    Code d’objet de l’objet dans Workfront auquel ObjectIntegration est associé.

  • param1

  • param2

  • param3

  • URL

Champs de référence
  • customer
Champs principaux

  • ID

  • objCode

TaskDef (TSKDEF)

L’objet TaskDef représente un ensemble de données concernant le format des tâches. Cet objet peut être associé à des projets ou des modèles et affecte les tâches ajoutées à ce projet ou modèle.

Champs directs

  • autoCalcPlannedHours

  • ID

Champs de référence
  • defaultApprovalProcess
Champs de collection
  • objectCategories
Champs principaux

  • ID

  • objCode

UserApproval (USRAPV)

Champs directs

  • approverID

  • customerID

  • ID

  • requestedDate

  • requestorID

  • status

  • userID

Champs de référence

  • approver

  • customer

  • requestor

  • user

Champs principaux

  • ID

  • objCode

Champs par défaut

  • approverID

  • requestorID

  • status

  • userID

Actions

  • approve

  • reject

Opérations

  • ADD

  • COUNT

  • DELETE

  • GET

  • REPORT

  • SEARCH

Ressources supprimées

Aucune ressource n’a été supprimée pour l’API version 15.

Ressources modifiées

AccessLevel (ACSLVL)

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 Niveaux d’accès.

Champs directs

  • fieldAccessPrivileges (string[])

    Ajout des valeurs possibles suivantes :

    • VTMAWMG (Afficher les équipes associées à mes groupes)

    • VALLTM (Afficher toutes les équipes)

AccessLevelPermissions (ALVPER)

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

  • coreAction (string[])

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Modifier les équipes auxquelles j’appartiens)

    • EDIT_TEAMS_I_GROUP_ADMIN (Modifier les équipes dans les groupes que je gère (administrateurs et administratrices de groupes uniquement))

  • forbiddenActions (string[])

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Modifier les équipes auxquelles j’appartiens)

    • EDIT_TEAMS_I_GROUP_ADMIN (Modifier les équipes dans les groupes que je gère (administrateurs et administratrices de groupes uniquement))

  • secondaryActions (string[])

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Modifier les équipes auxquelles j’appartiens)

    • EDIT_TEAMS_I_GROUP_ADMIN (Modifier les équipes dans les groupes que je gère (administrateurs et administratrices de groupes uniquement))

AccessRequest (ACSREQ)

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

  • action (string)

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Modifier les équipes auxquelles j’appartiens)

    • EDIT_TEAMS_I_GROUP_ADMIN (Modifier les équipes dans les groupes que je gère (administrateurs et administratrices de groupes uniquement))

  • autoShareAction (string)

    Ajout de la valeur possible suivante :

    • WDL

AccessRule (ACSRUL)

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

  • coreAction (string[])

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Modifier les équipes auxquelles j’appartiens)

    • EDIT_TEAMS_I_GROUP_ADMIN (Modifier les équipes dans les groupes que je gère (administrateurs et administratrices de groupes uniquement))

  • forbiddenActions (string[])

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Modifier les équipes auxquelles j’appartiens)

    • EDIT_TEAMS_I_GROUP_ADMIN (Modifier les équipes dans les groupes que je gère (administrateurs et administratrices de groupes uniquement))

  • secondaryActions (string[])

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Modifier les équipes auxquelles j’appartiens)

    • EDIT_TEAMS_I_GROUP_ADMIN (Modifier les équipes dans les groupes que je gère (administrateurs et administratrices de groupes uniquement))

Approval (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
  • resourcePlannerBudgetedHours
Champs de référence

  • initiative

    Ajout.

    L’objet Initiative crée des estimations dans le planificateur de scénarios Workfront pour le type et le nombre de fonctions, les coûts fixes et le bénéfice prévu.

  • issueDef

    Ajout.

  • taskDef

    Ajout.

Champs de collection

  • objectIntegrations

    Ajout.

    Dans certains cas, il est possible de lier des éléments de travail Workfront directement aux objets d’un logiciel externe. L’objet ObjectIntegration représente ce lien.

Catégorie (CTGY)

Un objet Category est un formulaire personnalisé.

Champs directs

  • catObjCode (string)

    Ajout de la valeur possible suivante :

    • GROUP (Groupe)

  • objTypes (string[])

    Ajout.

    Ce paramètre est un tableau d’objets possibles auxquels le formulaire personnalisé peut être joint. Il a été ajouté pour prendre en charge la possibilité de joindre un formulaire personnalisé à plusieurs types d’objets.

    Valeurs possibles :

    CMPY, PORT, PRGM, PROJ, TASK, OPTASK, USER, DOCU, EXPNS, ITRN, BILL, GROUP

Champs de collection

  • objTypes (string[])

    Ajout.

    Ce paramètre est un tableau d’objets possibles auxquels le formulaire personnalisé peut être joint. Il a été ajouté pour prendre en charge la possibilité de joindre un formulaire personnalisé à plusieurs types d’objets.

    Valeurs possibles :

    CMPY, PORT, PRGM, PROJ, TASK, OPTASK, USER, DOCU, EXPNS, ITRN, BILL, GROUP

CategoryParameter (CTGYPA)

Champs directs

  • hideFormulaFromDescription

    Ajout.

  • journaledObjCodes

    Ajout.

  • rawCustomExpression

    Ajout.

CustomerPreferences (CUSTPR)

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 suivantes :

    • password:sharePointV2IntegrationEnabled (Intégration (API Graph) SharePoint activée)

      Cette valeur prend en charge l’intégration SharePoint mise à jour.

    • project.mgmt:default.project.allowcreatewithouttemplate (Autoriser les utilisateurs et utilisatrices à créer des projets sans utiliser de modèle)

    • project.mgmt:taskissue.delegate (config.taskissue.delegate)

DocumentFolder (DOCFDR)

Les documents peuvent être organisés en dossiers. Vous pouvez créer des dossiers personnels dans votre zone personnelle Documents. L’objet DocumentFolder représente l’un de ces dossiers.

L’objet DocumentFolder a ajouté l’indicateur SHARABLE.

DocumentVersion (DOCV)

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 de documents, voir Charger une nouvelle version d’un document.

Champs directs

  • externalIntegrationType

    Ajout de la valeur suivante :

    • SHAREPOINT_V2 ((API Graph) SharePoint)

      Cette valeur prend en charge l’intégration SharePoint mise à jour.

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.

Pour plus d’informations sur les groupes, voir Groupes et équipes.

L’objet Group a ajouté l’indicateur DATA_EXTENDIBLE.

Champs directs

Les champs suivants ont été ajoutés :

  • categoryID

    Une catégorie est un formulaire personnalisé. Ce paramètre a été ajouté pour prendre en charge la possibilité d’ajouter des formulairess personnalisés aux objets Group.

  • isActive

    Il s’agit d’un paramètre booléen qui a la valeur true si un objet est actif et false s’il ne l’est pas. Les objets définis comme actifs apparaissent dans les menus déroulants et les champs de saisie et peuvent être attachés à d’autres objets.

Champs de référence

Les champs suivants ont été ajoutés :

  • approver

  • customer

  • requestor

  • user

Champs de collection

Les champs suivants ont été ajoutés :

  • objectCategories

  • objectIntegrations

    Dans certains cas, il est possible de lier des éléments de travail Workfront directement aux objets d’un logiciel externe. L’objet ObjectIntegration représente ce lien.

Champs par défaut

Le champ suivant a été ajouté :

  • isActive

    Il s’agit d’un paramètre booléen qui a la valeur true si un objet est actif et false s’il ne l’est pas. Les objets définis comme actifs apparaissent dans les menus déroulants et les champs de saisie et peuvent être attachés à d’autres objets.

Actions

Les champs suivants ont été ajoutés :

  • calculateDataExtension

    Cette action recalcule les expressions dans les champs des formulaires personnalisés.

  • completeGroupInfo

  • linkExternalObject

  • unlinkExternalObject

JournalEntry (JRNLE)

L’objet JournalEntry peut être configuré pour enregistrer des informations sur des champs d’objet spécifiques chaque fois que ces champs sont modifiés. Lorsqu’un champ est configuré pour être enregistré dans le cadre de l’objet JournalEntry, une entrée de journal correspondante est créée chaque fois que ce champ est modifié.

Champs directs

changeType

Ajout de la valeur suivante :

  • DW (Téléchargement)

LinkedFolder (LNKFDR)

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

    Ajout de la valeur suivante :

    • SHAREPOINT_V2 ((API Graph) SharePoint)

      Cette valeur prend en charge l’intégration SharePoint mise à jour.

OpTask / Problème (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.

Actions

Les actions suivantes ont été ajoutées :

  • bulkMoveWithOptions

  • getRequestPath

L’action suivante a été modifiée :

  • copyIssue

    Champ ajouté parentID

Paramètre (PARAM)

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

Champs directs

Le champ suivant a été ajouté :

  • fieldDefinition

Les champs suivants ont été modifiés :

  • dataType

    Ajout de la valeur possible WIDGET (Widget)

    Cette valeur prend en charge l’utilisation d’images dans les formulaires personnalisés.

  • displayType

    Ajout de la valeur possible WIDGET (Widget)

    Cette valeur prend en charge l’utilisation d’images dans les formulaires personnalisés.

Portfolio (PORT)

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.

Champs de collection
  • objectIntegrations
Actions

  • linkExternalObject

  • unlinkExternalObject

Programme (PRGM)

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

Champs de collection
  • objectIntegrations
Actions

  • linkExternalObject

  • unlinkExternalObject

Projet (PROJ)

Les projets sont des éléments de travail dans Workfront et sont un bloc de création essentiel de la façon dont Workfront aide les personnes à travailler. Un objet Projet représente un groupe de tâches avec un objectif commun et spécifique.

Champs directs
  • resourcePlannerBudgetedHours
Champs de référence

  • initiative

    L’objet Initiative crée des estimations dans le planificateur de scénarios Workfront pour le type et le nombre de fonctions, les coûts fixes et le bénéfice prévu.

  • issueDef

  • taskDef

Champs de collection

  • objectIntegrations

    Dans certains cas, il est possible de lier des éléments de travail Workfront directement aux objets d’un logiciel externe. L’objet ObjectIntegration représente ce lien.

QueueDef (QUED)

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

  • requestorCoreAction

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Modifier les équipes auxquelles j’appartiens)

    • EDIT_TEAMS_I_GROUP_ADMIN (Modifier les équipes dans les groupes que je gère (administrateurs et administratrices de groupes uniquement))

  • requestorForbiddenActions

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Modifier les équipes auxquelles j’appartiens)

    • EDIT_TEAMS_I_GROUP_ADMIN (Modifier les équipes dans les groupes que je gère (administrateurs et administratrices de groupes uniquement))

ScoreCardQuestion (SCOREQ)

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

  • displayType

    Ajout de la valeur possible WIDGET (Widget)

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 de collection

  • objectIntegrations

    Dans certains cas, il est possible de lier des éléments de travail Workfront directement aux objets d’un logiciel externe. L’objet ObjectIntegration représente ce lien.

Modèle (TMPL)

Un objet Template représente un modèle de projet. Les projets peuvent être créés à partir de modèles pour gagner du temps. Un modèle contient une équipe et des tâches qui seront copiées dans tout projet créé à partir du modèle.

Champs de référence

  • issueDef

  • taskDef

Timesheet (TSHET)

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.

Champs principaux

Le champ suivant a été supprimé :

  • objCode

View (UIVIEW)

Champs directs

  • uiviewType

    Les valeurs possibles suivantes ont été supprimées :

    • FOUR_COL (Mise en page Quatre colonnes)

    • UPDATES (Mises à jour)

    • UPDATESTOOLBAR_FEED (Mises à jour)

    • WORKINGON (En train de travailler sur)

    • CUSTOMDATA (Données personnalisées)

    • CUSTOMDATA_UPDATE (Mettre à jour les données personnalisées)

    • STATUS_UPDATE (Mise à jour du statut)

    • OPTASK_STATUS_UPDATE (Mise à jour du statut)

    • PROJ_STATUS_UPDATE (Mise à jour du statut)

    • PROJECT_TIMEENTRY (Mise à jour du statut)

    • DLIST (Liste détaillée)

    • DLIST_SECTION (Section de liste détaillée)

Update (UPDATE)

Les éléments de travail dans Workfront peuvent être mis à jour afin de tenir les utilisateurs et utilisatrices informés du statut actuel. Un objet Update représente l’une de ces mises à jour. Les mises à jour peuvent être saisies par les utilisateurs et utilisatrices ou créées par le système Workfront.

Champs directs

  • updateType

    Ajout de la valeur possible documentVersionDownload (enum.updatetypeenum.documentversiondownload)

Utilisateur ou 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 de référence
  • userApproval
Actions

  • getUsersAvailableTime

  • resetRopgPassword

UserNote (USRNOT)

Un objet UserNote est une notification.

Champs directs

  • eventType

    Ajout des valeurs possibles suivantes :

    • DUP (a demandé que vous relisiez un document)

    • DUV (vous autorise à afficher un document)

Work (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 de collection

  • objectIntegrations

    Dans certains cas, il est possible de lier des éléments de travail Workfront directement aux objets d’un logiciel externe. L’objet ObjectIntegration représente ce lien.

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