DokumentationWorkfrontWorkfront-Handbuch

Neue Funktionen in API Version 12

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

Erstellt für:

  • Developer

Workfront hat die API-Version 12 am 12. November 2020 veröffentlicht. API Version 12 enthält die folgenden Änderungen gegenüber Version 11

Hinzugefügte Ressourcen

Die folgenden Ressourcen sind in Workfront API Version 12 neu.

Ein BreadCrumb-Objekt stellt ein Element in der übergeordneten/untergeordneten Hierarchie eines Adobe Workfront-Arbeitselements dar. Breadcrumbs zeigen an, wie ein Arbeitselement in die größere Struktur von Portfolios, Projekten, Projekten und Aufgaben passt.

Weitere Informationen zu Breadcrumbs in Workfront finden Sie unter Breadcrumbs-Übersicht im neuen Adobe Workfront-Erlebnis

Aktion

  • getObjectHierarchy

RichTextParameterValue richtextparametervalue

Rich-Text-Felder sind jetzt für weitere Objekte verfügbar. Das RichTextParameterValue -Objekt wurde zu Workfront hinzugefügt, um diese Verfügbarkeit zu unterstützen.

Weitere Informationen finden Sie unter Rich-Text-Felder in der Adobe Workfront-API.

Direkte Felder

  • ID

Kernfelder

  • ID
  • objCode

Entfernte Ressourcen

Für API Version 12 wurden keine Ressourcen entfernt.

Geänderte Ressourcen

Die folgenden Ressourcen wurden für die Workfront API Version 12 geändert.

AccessLevel accesslevel

Ein AccessLevel -Objekt ist mit Benutzern verknüpft und beschreibt den Satz von AccessLevelPermissions, der bestimmt, auf welchen Benutzer zugreifen können.

Weitere Informationen zu Zugriffsebenen finden Sie unter Funktionsweise von Zugriffsstufen.

AccessLevelPermissions accesslevelpermissions

Ein AccessLevelPermissions -Objekt stellt eine spezifische Berechtigung zum Zugreifen auf, Erstellen oder Ändern eines Workfront-Objekts dar. Diese Berechtigungen können dann einer Zugriffsebene zugeordnet werden.

Direkte Felder

AccessRequest accessrequest

Wenn ein Benutzer keinen Zugriff auf ein Objekt in Workfront hat, das er benötigt, kann er den Zugriff auf dieses Objekt anfordern. Das AccessRequest -Objekt stellt diese Anforderung dar.

Direkte Felder

AccessRule accessrule

Ein AccessRule -Objekt stellt einen Regelsatz in benutzerdefinierten Zugriffsebenen dar, der bestimmt, wie Benutzer erstellte Projekte freigeben können.

Direkte Felder

ActivityLog activitylog

Ein ActivityLog-Objekt ist eine vollständige Liste aller Aktivitäten, die in einem bestimmten Workfront-Testkonto stattgefunden haben.

Vorgänge

Der folgende Vorgang wurde aus dem ActivityLog-Objekt entfernt:

  • HINZUFÜGEN

AnnouncementAttachment announcementattachment

Ein AnnouncementAttachment -Objekt stellt eine Datei dar, die an eine Workfront-Ankündigung angehängt wurde.

Weitere Informationen zu Ankündigungsanlagen finden Sie unter Mitteilungen senden

Direkte Felder

  • fileExtension

    Mögliche Werte wurden hinzugefügt:

    • qdoc (enum.fileextension.qdoc)

    • qslide (enum.fileextension.qslide)

    • qsheet (enum.fileextension.qsheet)

Genehmigung approval

Ein bestimmtes Arbeitselement, wie z. B. eine Aufgabe, ein Dokument oder ein Timesheet, kann vorschreiben, dass ein Supervisor oder ein anderer Benutzer das Arbeitselement abzeichnet. Ein Approval-Objekt stellt die Aktion zum Abmelden eines Arbeitselements dar.

Direkte Felder

  • backlogOrder

    Die folgenden Flags wurden entfernt:

    • DYNAMISCH,

    • LAZY_READ,

    • NOT_GROUPABLE

  • groupID

    Die folgenden Flags wurden hinzugefügt

    • AUTO_LOAD,

    • DYNAMISCH,

    • READ_ONLY

  • workEffort

    Dieses Feld wurde hinzugefügt. Es zeigt an, ob ein Benutzer einen kleinen, mittleren oder großen täglichen Arbeitsaufwand für die Ausführung einer Aufgabe benötigt. Mögliche Werte sind:

    • 1 (Klein)

    • 2 (Mittel)

    • 3 (groß)

    Weitere Informationen zu den Arbeitsbemühungen in Workfront finden Sie unter Übersicht über den Arbeitsaufwand.

CalendarSection calendarsection

Ein Kalenderabschnitt ist ein Kalenderbericht.

Weitere Informationen zu Kalenderberichten finden Sie unter Kalenderberichte - Übersicht.

Direkte Felder

Die folgenden Felder wurden zum CalendarSection -Objekt hinzugefügt, um die neue Funktion zur Verwendung benutzerdefinierter Datumswerte in Kalenderberichten zu unterstützen.

Weitere Informationen finden Sie unter Verwenden benutzerdefinierter Datumsfelder in einem Kalenderbericht.

  • customDate

  • customEndDateParameterID

  • customStartDateParameterID

  • ignoreActualDates

Firma company

Ein Unternehmensobjekt stellt eine Organisation dar, die aus einer Personensammlung besteht.

Weitere Informationen zu Unternehmen finden Sie unter Erstellen und Bearbeiten von Unternehmen.

Direkte Felder

  • groupID

    Die Kennung der Gruppe, mit der das Unternehmen verknüpft ist.

Referenzfelder

  • Gruppe

    Die Gruppe, mit der das Unternehmen verbunden ist. Wenn Sie ein Unternehmen mit einer Gruppe verknüpfen, kann der Gruppenadministrator den Gruppenzugriff und die Gruppenberechtigungen auf das Unternehmen erweitern.

Kunde customer

Ein Kundenobjekt stellt eine Organisation dar, die eine Instanz von Workfront verwendet.

Aktionen

  • productEnabled

    Diese Aktion akzeptiert ein CustomerProductTypeEnum -Argument und gibt einen booleschen Wert zurück, der angibt, ob dieser Kunde über ein Konto für dieses Produkt verfügt.

CustomerPreferences customerpreferences

Ein CustomerPreferences -Objekt stellt den Satz von Voreinstellungen dar, die ein Kunde für seine Instanz von Workfront festgelegt hat.

Direkte Felder

  • name

    Mögliche Werte wurden hinzugefügt:

    • password:zoomIntegrationEnabled (Zoom-Integration im Aktualisierungsstream aktivieren)
    • password:quipIntegrationEnabled (config.general.quip.enabled)

Dokument document

Ein Dokumentobjekt stellt eine Datei dar (z. B. schriftliches Material, Bilder oder andere Informationsformen).

Aktionen

  • createLinkedProofVersion

    Hinzugefügt

DocumentVersion documentversion

Ein DocumentVersion -Objekt stellt eine bestimmte Version einer Datei dar (z. B. geschriebenes Material, Bilder oder andere Informationsformen).

Weitere Informationen zu Dokumentversionen finden Sie unter Eine neue Version eines Dokuments hochladen.

Direkte Felder

  • externalIntegrationType

    Mögliche Werte wurden entfernt:

    • QUIP (Quip)

  • proofDecision

    Hinzugefügt

Aktionen

Die folgenden Aktionen wurden dem Dokumentobjekt hinzugefügt.

  • getDocumentReviewerDecision

    Diese Aktion akzeptiert das documentVersonID-Argument (Zeichenfolge) und gibt eine Zuordnung zurück, die die Entscheidung des Validierers angibt.

  • setDocumentReviewerDecision

    Diese Aktion akzeptiert die folgenden Argumente:

    • documentVersionID (string)

    • reviewerDecision (Zeichenfolge)

    • comment (string)

Gruppe group

Ein Group -Objekt stellt eine Gruppe von Benutzern und Teams dar. Gruppen repräsentieren oft die Struktur der Abteilungen.

Direkte Felder

  • businessLeaderID

    Die Kennung des der Gruppe zugewiesenen Business Leaders.

Referenzfelder

  • businessLeader

    Der der Gruppe zugewiesene Business Leader. Ein Business Leader ist jemand, der Geschäftsentscheidungen für die Gruppe trifft.

    Weitere Informationen zu Unternehmensführern finden Sie unter Übersicht über Business Leader.

Aktionen

  • assignMultiple

    Diese Aktion akzeptiert die folgenden Argumente:

    • userIDs (string[])

    • roleIDs (string[])

    • teamID (Zeichenfolge)

  • getGroupMembers

  • updateMembersList

    Diese Aktion akzeptiert die folgenden Argumente:

    • newMemberIDs (string[])

    • removedMemberDs (string[])

LinkedFolder linkedfolder

Ein LinkedFolder-Objekt stellt einen Ordner dar, der von einem externen Dokumentenanbieter wie Google Drive oder Dropbox verknüpft ist.

Weitere Informationen zu verknüpften Ordnern finden Sie unter Verknüpfen von Dokumenten mit externen Anwendungen.

Direkte Felder

  • externalIntegrationType

    Mögliche Werte wurden entfernt:

    • QUIP (Quip)

OpTask optask

Ein OpTask-Objekt wird häufig als Problem bezeichnet. Ein Problem ist ein Arbeitselement, das normalerweise anzeigt, dass ein Problem vorliegt, das die Fertigstellung einer Aufgabe oder eines Projekts verhindert. Ein Problem kann auch eine Helpdesk-Anfrage sein. Änderungen bei Bestellungen, Anforderungen und Fehlern sind ebenfalls Probleme.

Direkte Felder

  • backlogOrder

    Die Reihenfolge gibt die Position einer Aufgabe oder Geschichte im Agile-Backlog an.

    In diesem Feld wurden die folgenden Flags entfernt:

    • DYNAMISCH,
    • LAZY_READ,
    • NOT_GROUPABLE:
Aktionen

Mit diesen Aktionen wurde der Argumentstatus hinzugefügt, um die neue Schaltfläche Start zu unterstützen, die den Status eines Arbeitselements ändert, wenn ein Benutzer auf die Schaltfläche klickt, um anzuzeigen, dass er mit der Bearbeitung des Elements begonnen hat.

Weitere Informationen finden Sie unter Ersetzen der Schaltfläche "Work On It"durch die Schaltfläche Start.

  • acceptWork

  • unacceptWork

Parameter parameter

Ein Parameter -Objekt ist ein benutzerdefiniertes Feld.

Die Ressource Parameter hat das Flag SHARABLE hinzugefügt.

Weitere Informationen zu benutzerdefinierten Feldern finden Sie unter Benutzerdefiniertes Formular erstellen oder bearbeiten in Benutzerdefiniertes Formular erstellen oder bearbeiten.

Direkte Felder
Sammlungsfelder

  • accessRules

    Hinzugefügt

Standardfelder

  • label

    Hinzugefügt

Portfolio portfolio

Ein Portfolio-Objekt ist eine Sammlung von Projekten, die um die gleichen Ressourcen konkurrieren, in der Regel um Geld oder Personen, um sie zu vervollständigen.

Weitere Informationen zu Portfolios finden Sie unter Übersicht über Portfolio in Adobe Workfront.

Direkte Felder

  • groupID

    Die Kennung der Gruppe, mit der das Portfolio verknüpft ist.

Referenzfelder

  • Gruppe

    Die Gruppe, mit der das Portfolio verknüpft ist.

Programm program

Ein Programmobjekt ist eine Teilmenge von Projekten in einem Portfolio, in dem ähnliche Projekte gruppiert werden können.

Direkte Felder

  • groupID

    Die Kennung der Gruppe, mit der das Programm verknüpft ist.

Referenzfelder

  • Gruppe

    Die Gruppe, mit der das Programm verknüpft ist.

QueueDef queuedef

Ein QueueDef-Objekt stellt eine Warteschlange dar. Hierbei handelt es sich um ein Projekt, das in den Help Desk-Bereich veröffentlicht wurde, damit Benutzer Probleme an dieses Objekt senden können.

Weitere Informationen zu Anforderungswarteschlangen finden Sie unter Erstellen einer Anforderungswarteschlange.

Direkte Felder

ScheduledReport scheduledreport

Ein ScheduledReport -Objekt stellt einen Bericht dar, der für die Bereitstellung konfiguriert wurde.

Direkte Felder

  • format

    Mögliche Werte wurden hinzugefügt:

    • qdoc (enum.fileextension.qdoc)

    • qslide (enum.fileextension.qslide)

    • qsheet (enum.fileextension.qsheet)

ScoreCardQuestion scorecardquestion

Ein ScoreCardQuestion -Objekt stellt eine Frage dar, die einer Scorecard hinzugefügt wurde. Diese Fragen werden in der Regel vom Portfolio-Manager bestimmt und ihre Antworten ermöglichen es dem Manager zu verstehen, wie gut ein Projekt mit den Portfoliozielen übereinstimmt.

Weitere Informationen zu Scorecard-Fragen finden Sie unter Scorecard erstellen.

Direkte Felder

Aufgabe task

Ein Task -Objekt stellt ein Arbeitselement dar, das als Schritt zum Erreichen eines endgültigen Ziels (zum Abschließen eines Projekts) ausgeführt werden muss.

Direkte Felder

  • workEffort

    Dieses Feld wurde hinzugefügt. Es zeigt an, ob ein Benutzer einen kleinen, mittleren oder großen täglichen Arbeitsaufwand für die Ausführung einer Aufgabe benötigt. Mögliche Werte sind:

    • 1 (Klein)

    • 2 (Mittel)

    • 3 (groß)

    Weitere Informationen zu den Arbeitsbemühungen in Workfront finden Sie unter Übersicht über den Arbeitsaufwand.

Aktionen

Mit diesen Aktionen wurde der Argumentstatus hinzugefügt, um die neue Schaltfläche Start zu unterstützen, die den Status eines Arbeitselements ändert, wenn ein Benutzer auf die Schaltfläche klickt, um anzuzeigen, dass er mit der Bearbeitung des Elements begonnen hat.

Weitere Informationen finden Sie unter Ersetzen der Schaltfläche "Work On It"durch die Schaltfläche Start.

  • acceptWork

  • unacceptWork

Team team

Ein Team-Objekt ist eine Sammlung von Benutzern, die einem Arbeitselement zugewiesen werden können.

Direkte Felder

Die folgenden Felder wurden der Ressource Team hinzugefügt:

  • groupID

    In diesem Feld wird ein Team mit einer Gruppe verknüpft. Dadurch wird das Team als Teil der Gruppe identifiziert und der Gruppenadministrator kann die Teams verwalten.

  • workOnItStatusChange

    Dies ist ein boolescher Parameter, der anzeigt, ob die Schaltfläche "Arbeit an diesem Team"als Schaltfläche "Start"konfiguriert wurde. Wenn ein Mitglied des Teams auf die Schaltfläche Starten klickt, um mit der Arbeit an einem Arbeitselement zu beginnen, ändert sich der Status des Elements von Neu in einen in den Teameinstellungen konfigurierten Status.

  • Mit den folgenden Feldern können Sie benutzerdefinierte Status für die Schaltfläche Start für die einzelnen Arbeitselemente angeben.

    • workOnItOpTaskBugReportStatuses

    • workOnItOpTaskChangeOrderStatuses

    • workOnItOpTaskIssueStatuses

    • workOnItOpTaskRequestStatuses

      workOnItTaskStatuses

    Weitere Informationen zur Schaltfläche Start finden Sie unter Ersetzen der Schaltfläche "Work On It"durch die Schaltfläche Start.

Referenzfelder

Das folgende Feld wurde der Ressource Team hinzugefügt:

  • Gruppe

TemplateTask templatetask

Ein TemplateTask -Objekt stellt eine Aufgabe dar, die Teil einer Vorlage ist. Vorlagenaufgaben werden zu Aufgaben im Projekt, in dem die Vorlage verwendet wird.

Weitere Informationen zu Vorlagenaufgaben finden Sie unter Vorlagenaufgabe bearbeiten.

Direkte Felder

  • workEffort

    Dieses Feld wurde hinzugefügt. Es zeigt an, ob ein Benutzer einen kleinen, mittleren oder großen täglichen Arbeitsaufwand für die Ausführung einer Aufgabe benötigt. Mögliche Werte sind:

    • 1 (Klein)

    • 2 (Mittel)

    • 3 (groß)

    Weitere Informationen zu den Arbeitsbemühungen in Workfront finden Sie unter Übersicht über den Arbeitsaufwand.

Arbeitszeittabelle timesheet

Ein Timesheet-Objekt stellt eine virtuelle Timecard dar, mit der Benutzer die tatsächlichen Arbeitsstunden für Aufgaben, Projekte und Hochtypen eingeben können.

Weitere Informationen zu Timesheets finden Sie unter Timesheets - Übersicht

Kernfelder

Das folgende Feld wurde aus der Timesheet-Ressource entfernt:

  • objcode

Aktualisieren

Direkte Felder

  • updateType

    Die folgenden möglichen Werte wurden hinzugefügt:

    • initiativeAdd (enum.updatetypeenum.initiativeadd)

    • initiativeEdit (enum.updatetypeenum.initiativeedit)

    Weitere Informationen zu Initiativen finden Sie unter Übersicht über Initiativen im Szenario-Planer.

Benutzerin oder Benutzer user

Ein User -Objekt stellt eine Person mit einem Konto in Workfront dar, die sich anmelden und mit dem System interagieren kann.

Direkte Felder

Die folgenden Felder wurden der Ressource Benutzer hinzugefügt:

  • actualDeactivationDate

    Dies stellt das Datum und die Uhrzeit dar, zu der ein Benutzer deaktiviert wurde.

    Weitere Informationen zu deaktivierten Benutzern finden Sie unter Benutzer deaktivieren oder reaktivieren.

  • alignAccessType

    In diesem Feld wird der Zugriff des Benutzers auf Workfront-Ziele angezeigt. Mögliche Werte sind:

    • Kein Zugriff

    • Anzeigen

    • Bearbeiten

Aktionen

Die folgende Aktion wurde der Ressource Benutzer hinzugefügt:

  • getUserAccessPermissionsByObjCode

    Diese Aktion akzeptiert die folgenden Argumente

    • id (string)

    • objCode (Zeichenfolge)

Arbeit work

Ein Work-Objekt ist eine gemeinsame Schnittstelle, die sowohl von Task als auch von OpTask übernommen wird und gemeinsamen Code für beide verwendet.

Direkte Felder

  • backlogOrder

    Die Reihenfolge gibt die Position einer Aufgabe oder Geschichte im Agile-Backlog an.

    In diesem Feld wurden die folgenden Flags entfernt:

    • DYNAMISCH,

    • LAZY_READ,

    • NOT_GROUPABLE

  • groupID

    In diesem Feld wurden die folgenden Flags hinzugefügt:

    • AUTO_LOAD,

    • DYNAMISCH,

    • READ_ONLY

  • workEffort

    Dieses Feld wurde hinzugefügt. Es zeigt an, ob ein Benutzer einen kleinen, mittleren oder großen täglichen Arbeitsaufwand für die Ausführung einer Aufgabe benötigt. Mögliche Werte sind:

    • 1 (Klein)

    • 2 (Mittel)

    • 3 (groß)

    Weitere Informationen zu den Arbeitsbemühungen in Workfront finden Sie unter Übersicht über den Arbeitsaufwand.

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