DocumentationWorkfrontGuide Workfront

Nouveautés de l’API version 17

Last update: Tue Nov 07 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Developer

Adobe Workfront a publié l’API version 17 le 12 octobre 2023. L’API version 17 comprend les modifications suivantes à partir de la version 16.

Ressources ajoutées

ExternalDocument (EXTDOC)

Un objet ExternalDocument est un document ou une autre ressource numérique qui se trouve dans un fournisseur de stockage de documents externe à Workfront. Ces ressources peuvent être liées à et depuis Workfront.

Champs directs

  • dateModified

  • description

  • documentProviderID

  • poste

  • fileType

  • iconURL

  • ID

  • name

  • path

  • providerType

  • readOnly

  • size

  • thumbnailURL

Champs principaux

  • dateModified

  • description

  • documentProviderID

  • poste

  • fileType

  • iconURL

  • ID

  • isGoogleRootItem

  • isTeamDriveItem

  • name

  • objCode

  • path

  • providerType

  • readOnly

  • size

  • thumbnailURL

  • value

Champs par défaut

  • ID

  • name

  • objCode

Actions

  • browseListWithLinkAction

  • getDocumentDownloadUrl

  • getRootFolderID

  • getRootFolderIDFromDB

  • linkExternalDocumentObjects

  • setLinkedFolderMetadata

Requêtes

  • browseList

  • getFolderMetaData

  • searchExternalDocuments

Opérations
  • SEARCH

UserLocation (USRLOC)

Champs directs

  • classifierID

  • customerID

  • endDate

  • ID

  • isCurrent

  • startDate

  • userID

Champs de référence

  • client

  • user

Champs principaux

  • ID

  • objCode

Ressources supprimées

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

Ressources modifiées

Les ressources suivantes ont été modifiées pour l’API version 17.

Ligne de base (BLIN)

Les lignes de base sont des instantanés de ce à quoi ressemblaient les performances d’un projet à un moment donné dans le temps. Ils stockent des informations clés sur le projet, telles que les dates clés, l’avancement, les coûts et les valeurs de recettes.

L’objet Baseline a supprimé l’indicateur INLINE_EDITABLE.

BillingRecord (BILL)

Un objet BillingRecord enregistre les recettes, les heures ou les dépenses qui peuvent être facturées. Ces informations peuvent être utilisées pour créer des factures dans un système comptable externe.

L’objet BillingRecord a supprimé l’indicateur INLINE_EDITABLE.

Société (CMPY)

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

Champs directs

  • defaultInterface

    Supprimé

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 de la valeur possible "config.defaultToNewHomeDescription" (customer:config.defaultToNewHome)>/p?

    Cela permet à une entreprise de faire de la nouvelle expérience d’accueil la nouvelle expérience par défaut pour ses utilisateurs.

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).

Champs directs

  • externalIntegrationType

    Ajout de la valeur possible "Frame.io" (FRAMEIO)

  • fileType

    Ajout de la valeur possible "enum.filetype.site" (site)

ExchangeRate (EXRATE)

Un objet ExchangeRate représente un taux de change de devise configuré dans Workfront. Les objets ExchangeRate ne sont pas dynamiques.

Champs directs

Les champs suivants ont été ajoutés :

  • endDate

  • startDate

Actions

  • getCustomerCurrencies

    Ajout de .

Dépenses (EXPNS)

Les dépenses représentent les frais non liés au travail qui pourraient être engagés pendant la durée de vie d'un projet.

L’objet Frais a supprimé l’indicateur INLINE_EDITABLE.

Groupe (GROUP)

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

Champs directs

  • defaultInterface

    Supprimé

Heure (HEURE)

Un objet Hour représente une heure consignée par un utilisateur sur une feuille de temps.

L’objet Heure a supprimé l’indicateur INLINE_EDITABLE.

Itération (ITRN)

Un objet Itération représente une seule itération Agile. Les itérations sont des périodes discrètes utilisées pour planifier et compléter des histoires Agile.

L’objet Itération a supprimé l’indicateur INLINE_EDITABLE.

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 des valeurs possibles suivantes :

    • Ajout de l’approbateur (AAA)
    • Ajout d’un réviseur (AAR)
    • Suppression du réviseur (ARR)
    • Approbateur supprimé (ARA)
    • Décision approuvée (ADA)
    • Décision approuvée avec modifications (ADC)
    • Les besoins de décision fonctionnent (ADN)
    • Décision révoquée (MARC)
    • Approbateur modifié (AAC)
    • Réviseur modifié (ARC)
    • Révision terminée (RDC)
    • Révision révoquée (RDR)
    • Publier (PUB)

Kanban Board (KNBNBD)

Un panorama Kanban est utilisé pour effectuer le suivi des tâches dans un environnement agile.

L’objet Kanban Board a supprimé l’indicateur INLINE_EDITABLE.

LinkedFolder (LNKFDR)

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

Champs directs

  • externalIntegrationType

    Ajout de la valeur possible "Frame.io (FRAMEIO)

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.

L’objet Problème a supprimé l’indicateur INLINE_EDITABLE.

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.

L’objet Projet a supprimé l’indicateur INLINE_EDITABLE.

ProjectUser (PRTU)

Un objet ProjectUser représente un utilisateur associé à un projet spécifique.

Champs directs

  • ID

    Ajout de .

Champs principaux

  • ID

    Ajout de .

Rate (RATE)

Un objet Rate représente un taux de facturation dans Workfront.

L’objet Rate a supprimé l’indicateur. INLINE_EDITABLE.

Actions

Les actions suivantes ont été ajoutées pour prendre en charge la fonctionnalité Carte de taux :

  • deleteRateForRole

  • editRatesForRole

  • getUsedClassifierIds

  • setRatesFromRateCard

La variable setRatesForRole L’action a été modifiée pour ajouter les champs suivants :

  • classifierID
  • currencyCode
  • sourceRateCardID

Risque (RISQUE)

Un objet Risk représente un événement possible qui peut empêcher la fin d’un projet à temps ou dans les limites du budget. Lors de la phase de planification, des risques sont ajoutés aux projets pour identifier les obstacles potentiels avant l’approbation des travaux.

L'objet Risk a retiré l'indicateur INLINE_EDITABLE.

Rôle/Rôle de tâche (RÔLE)

Un objet Rôle (rôle de tâche) représente une capacité fonctionnelle ou un ensemble de compétences qu’un utilisateur peut remplir, tel que Designer ou Gestionnaire de produits.

Champs directs

  • defaultInterface

    Supprimé

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).

L’objet Task a supprimé l’indicateur INLINE_EDITABLE.

Équipe (TEAMOB)

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

Champs directs

  • defaultInterface

    Supprimé

TeamMember (TEAMMB)

Un objet TeamMember est un utilisateur associé à une équipe spécifique.

Champs directs

  • ID

    Ajout de .

Champs principaux

  • ID

    Ajout de .

TemplateUser (TMTU)

Champs directs

  • ID

    Ajout de .

Champs principaux

  • ID

    Ajout de .

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 directs

  • objCode

    Supprimé

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

  • changeType

    Ajout des valeurs suivantes :

    • Ajout de l’approbateur (assetapprovalAddApprover)
    • Ajout d’un réviseur (assetapprovalAddReviewer)
    • Approbateur supprimé (assetapprovalRemoveApprover)
    • Suppression du réviseur (assetapprovalRemoveReviewer)
    • Décision approuvée (assetapprovalDecisionApproval)
    • La décision doit fonctionner (assetapprovalDecisionNeedsWork)
    • Décision approuvée avec modifications (assetapprovalDecisionApprovalChanges)
    • Décision révoquée (assetapprovalDecisionRevoked)
    • Approbateur modifié (assetapprovalApproverChanged)
    • Réviseur modifié (assetapprovalReviewerChanged)
    • Révision terminée (assetapprovalReviewerDecisionComplete)
    • Révision révoquée (assetapprovalReviewerDecisionRevoked)
    • Erreur d'envoi de document externe (externalDocumentSendError)
    • Version du document publiée (documentVersionPublish)
    • Workflow du dossier lié (linkedFolderWorkflow)

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.

L’objet User a supprimé l’indicateur INLINE_EDITABLE.

Champs directs

  • workTime

    Ce champ a été ajouté. Il s’agit d’un nombre compris entre 0 et 1 qui représente le pourcentage de temps qu’un utilisateur peut consacrer chaque jour à des tâches de projet (sans frais généraux). Une valeur de 1 signifie que l’utilisateur peut passer 100 % de son temps à travailler sur un projet.

Champs de collection
  • userLocations

UserGroups (USRGPS)

Champs directs

  • ID

    Ajout de .

Champs principaux

  • ID

    Ajout de .

UserNote (USRNOT)

Un objet UserNote est une notification.

Champs directs

  • changeType

    Ajout des valeurs suivantes :

    • Le document nécessite votre approbation (AAA)
    • Le document nécessite votre révision (AAR).
    • Document n’a plus besoin de votre approbation (ARA)
    • Document n’a plus besoin de votre révision (ARR)
    • Approbation requise du document (ATA) par l’utilisateur
    • Examen des besoins du document (utilisateur) (ATR)
    • Document n’a plus besoin de la validation (RTA) de l’utilisateur
    • Le document n’a plus besoin de révision (RTR) (utilisateur).
    • Document approuvé (ADA)
    • Document approuvé avec modifications (ADC)
    • Travail sur les documents nécessaires (ADN)
    • (Utilisateur) a marqué (document) comme approuvé. Votre approbation n’est plus nécessaire. (AAN)
    • (Utilisateur) a marqué (document) comme approuvé avec les modifications. Votre approbation n’est plus nécessaire. (ACN)
    • (Utilisateur) a marqué (document) comme le travail nécessaire. Votre approbation n’est plus nécessaire. (AWN)
    • Le document a besoin de votre révision maintenant plutôt que de votre approbation (AAC).
    • Le document a besoin de votre approbation maintenant plutôt que d'une révision (ADN).
    • Document révisé (RDC)
    • Document révisé (TRC)
    • (Utilisateur) a examiné (document) comme terminé. Votre examen n’est plus nécessaire. (TRN)

UserRole (USRROL)

Champs directs

  • ID

    Ajout de .

Champs principaux

  • ID

    Ajout de .

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