DocumentationWorkfrontGuide Workfront

Nouveautés de la version 17 de l’API

Last update: Thu Oct 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur

Adobe Workfront a publié la verison 17 de l’API le 12 octobre 2023. La versions 17 de l’API comprend les modifications suivantes par rapport à la version 16.

Ressources ajoutées

ExternalDocument (EXTDOC)

Un objet ExternalDocument est un document ou une autre ressource numérique qui se trouve chez un fournisseur de stockage de documents externe à Workfront. Ces ressources peuvent être liées à 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

  • customer

  • utilisateur

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.

Baseline (BLIN)

Les niveaux de référence sont des instantanés de ce à quoi ressemblaient les performances d’un projet à un moment donné dans le temps. Elles stockent des informations clés sur le projet, telles que les dates clés et la progression, ainsi que les valeurs des coûts et des revenus.

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

BillingRecord (BILL)

Un objet BillingRecord enregistre les revenus, 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.

Entreprise (CMPY)

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

Champs directs

  • defaultInterface

    Supprimés

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

    Cela permet à une organisation de faire de la nouvelle expérience d’accueil la nouvelle expérience par défaut de ses utilisateurs et utilisatrices.

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

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 d’exchange 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.

Expense (EXPNS)

Les dépenses représentent les coûts non liés à la main-d’œuvre qui peuvent être engagés pendant la durée de vie d’un projet.

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

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

  • defaultInterface

    Supprimés

Hour (HOUR)

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

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

Iteration (ITRN)

Un objet Iteration 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 Iteration a supprimé l’indicateur INLINE_EDITABLE.

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

    • Ajout d’un approbateur ou d’une approbatrice (AAA)
    • Ajout d’un réviseur ou d’une réviseuse (AAR)
    • Suppression du réviseur ou de la réviseuse (ARR)
    • Suppression de l’approbateur ou de l’approbatrice (ARA)
    • Décision approuvée (ADA)
    • Décision approuvée avec des modifications (ADC)
    • La décision doit être retravaillée (ADN)
    • Décision révoquée (MARC)
    • Modification de l’approbateur ou de l’approbatrice (AAC)
    • Modification du réviseur ou de la réviseuse (ARC)
    • Révision terminée (RDC)
    • Révision révoquée (RDR)
    • Publier (PUB)

Kanban Board (KNBNBD)

Un panorama Kanban est utilisé pour suivre les tâches dans un environnement agile.

L’objet Panorama Kanban 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 centre d’assistance. Les ordres de modification, les requêtes et les bugs 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 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.

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

ProjectUser (PRTU)

Un objet ProjectUser représente une personne associée à un projet spécifique.

Champs directs

  • ID

    Ajout.

Champs principaux

  • ID

    Ajout.

Taux (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 tarifaire :

  • deleteRateForRole

  • editRatesForRole

  • getUsedClassifierIds

  • setRatesFromRateCard

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

  • classifierID
  • currencyCode
  • sourceRateCardID

Risque (RISK)

Un objet Risk représente un événement possible qui peut empêcher un projet de se terminer dans les délais ou dans le respect un budget. Lors de la phase de planification, des risques sont ajoutés aux projets pour identifier les obstacles potentiels avant l’approbation d’un travail.

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

Rôle/Fonction (ROLE)

Un objet Rôle (fonction) représente une capacité fonctionnelle ou un ensemble de compétences qu’un utilisateur ou une utilisateur peut remplir, tel que Designer ou Chef ou Cheffe de produits.

Champs directs

  • defaultInterface

    Supprimés

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

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

Team (TEAMOB)

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

Champs directs

  • defaultInterface

    Supprimés

TeamMember (TEAMMB)

Un objet TeamMember est une personne associée à une équipe spécifique.

Champs directs

  • ID

    Ajout.

Champs principaux

  • ID

    Ajout.

TemplateUser (TMTU)

Champs directs

  • ID

    Ajout.

Champs principaux

  • ID

    Ajout.

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 directs

  • objCode

    Supprimés

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

  • changeType

    Ajout des valeurs suivantes :

    • Ajout d’un approbateur ou d’une approbatrice (assetapprovalAddApprover)
    • Ajout d’un réviseur ou d’une réviseuse (assetapprovalAddReviewer)
    • Suppression de l’approbateur ou de l’approbatrice (assetapprovalRemoveApprover)
    • Suppression du réviseur ou de la réviseuse (assetapprovalRemoveReviewer)
    • Décision approuvée (assetapprovalDecisionApproval)
    • La décision doit être retravaillée (assetapprovalDecisionNeedsWork)
    • Décision approuvée avec des modifications (assetapprovalDecisionApprovalChanges)
    • Décision révoquée (assetapprovalDecisionRevoked)
    • Modification de l’approbateur ou de l’approbatrice (assetapprovalApproverChanged)
    • Modification du réviseur ou de la réviseuse (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 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.

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 ou une utilisatrice peut consacrer chaque jour à travailler sur le projet (hors heures supplémentaires). Une valeur de 1 signifie que l’utilisateur ou l’utilisatrice peut passer 100 % de son temps à travailler sur un projet.

Champs de collection
  • userLocations

UserGroups (USRGPS)

Champs directs

  • ID

    Ajout.

Champs principaux

  • ID

    Ajout.

UserNote (USRNOT)

Un objet UserNote est une notification.

Champs directs

  • changeType

    Ajout des valeurs suivantes :

    • Le document a besoin de votre approbation (AAA).
    • Le document a besoin d’être examiné (AAR).
    • Le document n’a plus besoin de votre approbation (ARA).
    • Le document n’a plus besoin d’être examiné (ARR).
    • Le document a besoin de l’approbation de (utilisateur ou utilisatrice) (ATA).
    • Le document a besoin d’être examiné par (utilisateur ou utilisatrice) (ATR).
    • Le document n’a plus besoin de l’approbation de (utilisateur ou utilisatrice) (RTA).
    • Le document n’a plus besoin d’être examiné par (utilisateur ou utilisatrice) (RTR).
    • Document approuvé (ADA)
    • Document approuvé avec des modifications (ADC)
    • Le document a besoin d’être retravaillé (ADN).
    • (Utilisateur ou utilisatrice) a marqué (document) comme approuvé. Votre approbation n’est plus nécessaire. (AAN)
    • (Utilisateur ou utilisatrice) a marqué (document) comme approuvé avec des modifications. Votre approbation n’est plus nécessaire. (ACN)
    • (Utilisateur ou utilisatrice) a marqué (document) comme devant être retravaillé. Votre approbation n’est plus nécessaire. (AWN)
    • Le document a besoin d’être examiné maintenant plutôt que d’être approuvé (AAC).
    • Le document a besoin d’être approuvé maintenant plutôt que d’être examiné (ADN).
    • Document examiné (RDC)
    • Document examiné (TRC)
    • (Utilisateur ou utilisatrice) a examiné (document) et l’a signalé comme terminé. Votre examen n’est plus nécessaire. (TRN)

UserRole (USRROL)

Champs directs

  • ID

    Ajout.

Champs principaux

  • ID

    Ajout.

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