DocumentationWorkfrontGuide Workfront

Nouveautés de l’API version 15

Last update: Tue Nov 07 2023 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. L’API version 15 comprend les modifications suivantes à partir de la version 14.

Ressources ajoutées

Initiative (INITIV)

L’objet Initiative crée des estimations dans le planificateur de scénarios de Workfront pour le type et le nombre de rôles de tâche, les coûts fixes et l’avantage planifié.

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

Champs directs

  • customerID

    C'est un objet interne.

  • durée

    Durée entre endDate et startDate.

  • endDate

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

  • entryByID

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

  • ID

    ID associé à l’action.

  • initiativeID

    ID associé à l’initiative.

  • lastPublishedDate

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

  • name

    Nom de l’initiative

  • planID

    ID du plan associé à l’initiative.

  • planName

    Nom du plan associé à l’initiative.

  • projectID

    Identifiant du projet associé à l’initiative.

  • scénarioID

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

  • startDate

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

Champs de référence

  • client

  • entryBy

  • projet

Champs principaux

  • ID

  • name

  • objCode

Opérations

  • COUNT

  • GET

  • RAPPORT

  • 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 tâches Workfront directement à des objets d’un produit logiciel externe. L’objet ObjectIntegration représente ce lien.

Champs directs

  • customerID

    C'est 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

    Le 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
  • client
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

  • autoCalcScheduleHours

  • ID

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

  • ID

  • objCode

UserApproval (USRAPV)

Champs directs

  • approverID

  • customerID

  • ID

  • requestsDate

  • requestorID

  • status

  • userID

Champs de référence

  • approbateur

  • client

  • demandeur

  • user

Champs principaux

  • ID

  • objCode

Champs par défaut

  • approverID

  • requestorID

  • status

  • userID

Actions

  • valider

  • rejeter

Opérations

  • AJOUTER

  • COUNT

  • DELETE

  • GET

  • RAPPORT

  • 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 utilisateurs et décrit le jeu d’autorisations AccessLevel qui déterminent ce à quoi l’utilisateur 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 (Éditer les équipes sur lesquelles je travaille)

    • EDIT_TEAMS_I_GROUP_ADMIN (Éditer les équipes dans les groupes que je gère (administrateurs de groupe uniquement)

  • forbiddenActions (string[])

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Éditer les équipes sur lesquelles je travaille)

    • EDIT_TEAMS_I_GROUP_ADMIN (Éditer les équipes dans les groupes que je gère (administrateurs de groupe uniquement)

  • secondaryActions (string[])

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Éditer les équipes sur lesquelles je travaille)

    • EDIT_TEAMS_I_GROUP_ADMIN (Éditer les équipes dans les groupes que je gère (administrateurs de groupe uniquement)

AccessRequest (ACSREQ)

Si un utilisateur n’a pas accès à un objet Workfront dont il a besoin, il 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 (Éditer les équipes sur lesquelles je travaille)

    • EDIT_TEAMS_I_GROUP_ADMIN (Éditer les équipes dans les groupes que je gère (administrateurs de groupe 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 utilisateurs peuvent partager les projets qu’ils créent.

Champs directs

  • coreAction (string[])

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Éditer les équipes sur lesquelles je travaille)

    • EDIT_TEAMS_I_GROUP_ADMIN (Éditer les équipes dans les groupes que je gère (administrateurs de groupe uniquement)

  • forbiddenActions (string[])

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Éditer les équipes sur lesquelles je travaille)

    • EDIT_TEAMS_I_GROUP_ADMIN (Éditer les équipes dans les groupes que je gère (administrateurs de groupe uniquement)

  • secondaryActions (string[])

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Éditer les équipes sur lesquelles je travaille)

    • EDIT_TEAMS_I_GROUP_ADMIN (Éditer les équipes dans les groupes que je gère (administrateurs de groupe uniquement)

Validation (APPROBATION)

Un élément de travail donné, tel qu’une tâche, un document ou une feuille de temps, peut exiger qu’un superviseur ou un autre utilisateur signe l’élément de travail. Un objet Approval représente l’action de déconnexion d’un élément de travail.

Champs directs
  • resourcePlannerBudgetedHours
Champs de référence

  • initiative

    Ajout de .

    L’objet Initiative crée des estimations dans le planificateur de scénarios de Workfront pour le type et le nombre de rôles de tâche, les coûts fixes et l’avantage planifié.

  • issueDef

    Ajout de .

  • taskDef

    Ajout de .

Champs de collection

  • objectIntegrations

    Ajout de .

    Dans certains cas, il est possible de lier des tâches Workfront directement à des objets d’un produit 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 de .

    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, TÂCHE, OPTASK, UTILISATEUR, DOCU, EXPNS, ITRN, BILL, GROUPE

Champs de collection

  • objTypes (string[])

    Ajout de .

    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, TÂCHE, OPTASK, UTILISATEUR, DOCU, EXPNS, ITRN, BILL, GROUPE

CategoryParameter (CTGYPA)

Champs directs

  • hideFormulaFromDescription

    Ajout de .

  • journaledObjCodes

    Ajout de .

  • rawCustomExpression

    Ajout de .

CustomerPreferences (CUSTPR)

Un objet CustomerPreferences représente l’ensemble des préférences définies par un client 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 à 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 Documents personnels. 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 matériel écrit, des images ou d’autres formes d’informations).

Pour plus d’informations sur les versions de document, voir Télécharger une nouvelle version d’un document.

Champs directs

  • externalIntegrationType

    Ajout de la valeur suivante :

    • SHAREPOINT_V2 (SharePoint (API Graph))

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

Groupe (GROUP)

Un objet Group représente un ensemble d’utilisateurs et d’équipes. Les groupes représentent souvent la structure du Ministère.

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 Forms personnalisées aux objets de groupe.

  • isActive

    Il s’agit d’un paramètre booléen dont la valeur est true si un objet est actif et false dans le cas contraire. Les objets définis sur Actif s’affichent dans des menus déroulants et des champs de type avant et peuvent être associés à d’autres objets.

Champs de référence

Les champs suivants ont été ajoutés :

  • approbateur

  • client

  • demandeur

  • user

Champs de collection

Les champs suivants ont été ajoutés :

  • objectCategories

  • objectIntegrations

    Dans certains cas, il est possible de lier des tâches Workfront directement à des objets d’un produit 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 dont la valeur est true si un objet est actif et false dans le cas contraire. Les objets définis sur Actif s’affichent dans des menus déroulants et des champs de type avant et peuvent être associés à d’autres objets.

Actions

Les champs suivants ont été ajoutés :

  • calculateDataExtension

    Cette action recalcule les expressions dans les champs de formulaire personnalisés.

  • completeGroupInfo

  • linkExternalObject

  • unlinkExternalObject

JournalEntry (JRNLE)

L’objet JournalEntry peut être configuré pour consigner des informations sur des champs d’objet spécifiques chaque fois que ces champs sont modifiés. Lorsqu’un champ est configuré pour être consigné dans le cadre de l’objet d’entrée de journal, 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 (SharePoint (API Graph))

      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 service d’assistance. Modifier les commandes, les requêtes et les bogues 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 de Portfolio est un ensemble de projets qui rivalisent pour les mêmes ressources, généralement de l’argent ou des personnes pour les compléter.

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 une composante essentielle 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 de Workfront pour le type et le nombre de rôles de tâche, les coûts fixes et l’avantage planifié.

  • issueDef

  • taskDef

Champs de collection

  • objectIntegrations

    Dans certains cas, il est possible de lier des tâches Workfront directement à des objets d’un produit 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 Aide Desk pour permettre aux utilisateurs de lui envoyer des problèmes.

Pour plus d’informations sur les files d’attente de requête, voir Création d’une file d’attente de requête.

Champs directs

  • requestorCoreAction

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Éditer les équipes sur lesquelles je travaille)

    • EDIT_TEAMS_I_GROUP_ADMIN (Éditer les équipes dans les groupes que je gère (administrateurs de groupe uniquement)

  • requestorForbiddenActions

    Ajout des valeurs possibles suivantes :

    • EDIT_TEAMS_I_AM_ON (Éditer les équipes sur lesquelles je travaille)

    • EDIT_TEAMS_I_GROUP_ADMIN (Éditer les équipes dans les groupes que je gère (administrateurs de groupe uniquement)

ScoreCardQuestion (SCOREQ)

Un objet ScoreCardQuestion représente une question qui a été ajoutée à une Fiche d’évaluation. Ces questions sont généralement définies par le responsable du Portfolio et leurs réponses permettent au responsable de comprendre dans quelle mesure un projet s’aligne sur les objectifs du portefeuille.

Pour plus d’informations sur les questions de la Fiche d’évaluation, voir Création d’une Fiche d’évaluation.

Champs directs

  • displayType

    Ajout de la valeur possible WIDGET (Widget)

Tâche (TÂCHE)

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

Champs de collection

  • objectIntegrations

    Dans certains cas, il est possible de lier des tâches Workfront directement à des objets d’un produit logiciel externe. L’objet ObjectIntegration représente ce lien.

Modèle (TMPL)

Un objet Template représente un modèle pour un 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

Feuille de calcul (TSHET)

Un objet de feuille de temps représente une feuille de temps virtuelle qui permet aux utilisateurs de saisir les heures réelles travaillées pour les tâches, les projets et les types d’heures de surcharge.

Champs principaux

Le champ suivant a été supprimé :

  • objCode

Vue (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 statut)

    • OPTASK_STATUS_UPDATE (Mise à jour statut)

    • PROJ_STATUS_UPDATE (Mise à jour statut)

    • PROJECT_TIMEENTRY (Mise à jour statut)

    • DLIST (Liste détaillée)

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

Mise à jour (MISE À JOUR)

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

Champs directs

  • updateType

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

Utilisateur (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 (Demande de BAT d’un document)

    • DUV (Permet d’afficher un document)

Travail (WORK)

Un objet de travail est une interface commune dont Task et OpTask héritent tous deux et partagent le code commun entre les deux.

Champs de collection

  • objectIntegrations

    Dans certains cas, il est possible de lier des tâches Workfront directement à des objets d’un produit logiciel externe. L’objet ObjectIntegration représente ce lien.

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