Neue Funktionen in der API-Version 12
Erstellt für:
- Entwickler
Workfront hat API Version 12 am 12. November 2020 veröffentlicht. API Version 12 enthält die folgenden Änderungen gegenüber Version 11
Ressourcen hinzugefügt
Die folgenden Ressourcen sind neu in der Workfront-API-Version 12.
Brotkrume
Ein BreadCrumb-Objekt stellt ein Element in der übergeordneten/untergeordneten Hierarchie eines Adobe Workfront-Arbeitselements dar. Breadcrumbs geben 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 in der neuen Adobe Workfront-Version
- getObjectHierarchy
RichTextParameterValue
Rich-Text-Felder sind jetzt für mehr Objekte verfügbar. Das RichTextParameterValue-Objekt wurde zu Workfront hinzugefügt, um diese Verfügbarkeit zu unterstützen.
Weitere Informationen finden Sie unter Rich-Textfelder in der Adobe Workfront-API.
- ID
- 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.
Zugriffsebene
Ein AccessLevel-Objekt ist Benutzern zugeordnet und beschreibt den Satz von AccessLevelPermissions, die bestimmen, auf was Benutzer zugreifen können.
Weitere Informationen zu Zugriffsebenen finden Sie unter von Zugriffsebenen.
ZugriffsebeneBerechtigungen
Ein AccessLevelPermissions-Objekt stellt eine bestimmte Berechtigung zum Zugreifen auf, Erstellen oder Ändern eines Workfront-Objekts dar. Diese Berechtigungen können dann mit einer Zugriffsebene verknüpft werden.
-
coreAction
Die folgenden möglichen Werte wurden hinzugefügt:
-
PLANNED_HOURS_CONTOURING
Benutzende mit einer Zugriffsebene, die diese Berechtigung enthält, können geplante Stunden im Workload-Balancer aktualisieren.
Weitere Informationen finden Sie unter Aktualisieren der geplanten Stunden bei der Verwaltung von Benutzerzuweisungen in Verwalten von Benutzerzuweisungen im Workload Balancer.
-
ADD_TO_CUSTOM_FORMS
Ein Benutzer mit einer Zugriffsebene, die diese Berechtigung enthält, kann benutzerdefinierten Formularen Felder hinzufügen.
Weitere Informationen finden Sie unter Erstellen oder Bearbeiten eines benutzerdefinierten Formulars.
-
EDIT_SYSTEMWIDE
Benutzende mit einer Zugriffsebene, die diese Berechtigung enthält, können ein benutzerdefiniertes Feld systemweit für den Löschzugriff freigeben.
-
-
forbiddenActions
Die folgenden möglichen Werte wurden hinzugefügt:
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
-
secondaryActions
Die folgenden möglichen Werte wurden hinzugefügt:
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
Zugriffsanforderung
Wenn ein(e) Benutzende® keinen Zugriff auf ein Objekt in Workfront hat, das er/sie benötigt, kann er/sie Zugriff auf dieses Objekt anfordern. Das AccessRequest-Objekt stellt diese Anforderung dar.
-
Handlung
Die folgenden möglichen Werte wurden hinzugefügt:
-
PLANNED_HOURS_CONTOURING
Benutzende mit einer Zugriffsebene, die diese Berechtigung enthält, können geplante Stunden im Workload-Balancer aktualisieren.
Weitere Informationen finden Sie unter Aktualisieren der geplanten Stunden bei der Verwaltung von Benutzerzuweisungen in Verwalten von Benutzerzuweisungen im Workload Balancer.
-
ADD_TO_CUSTOM_FORMS
Ein Benutzer mit einer Zugriffsebene, die diese Berechtigung enthält, kann benutzerdefinierten Formularen Felder hinzufügen.
Weitere Informationen finden Sie unter Erstellen oder Bearbeiten eines benutzerdefinierten Formulars.
-
EDIT_SYSTEMWIDE
Benutzende mit einer Zugriffsebene, die diese Berechtigung enthält, können ein benutzerdefiniertes Feld systemweit für den Löschzugriff freigeben.
-
Zugriffsregel
Ein AccessRule-Objekt stellt einen Regelsatz in benutzerdefinierten Zugriffsebenen dar, der bestimmt, wie Benutzer erstellte Projekte freigeben können.
-
coreAction
Die folgenden möglichen Werte wurden hinzugefügt:
-
PLANNED_HOURS_CONTOURING
Benutzende mit einer Zugriffsebene, die diese Berechtigung enthält, können geplante Stunden im Workload-Balancer aktualisieren.
Weitere Informationen finden Sie unter Aktualisieren der geplanten Stunden bei der Verwaltung von Benutzerzuweisungen in Verwalten von Benutzerzuweisungen im Workload Balancer.
-
ADD_TO_CUSTOM_FORMS
Ein Benutzer mit einer Zugriffsebene, die diese Berechtigung enthält, kann benutzerdefinierten Formularen Felder hinzufügen.
Weitere Informationen finden Sie unter Erstellen oder Bearbeiten eines benutzerdefinierten Formulars.
-
EDIT_SYSTEMWIDE
Benutzende mit einer Zugriffsebene, die diese Berechtigung enthält, können ein benutzerdefiniertes Feld systemweit für den Löschzugriff freigeben.
-
-
forbiddenActions
Die folgenden möglichen Werte wurden hinzugefügt:
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
-
secondaryActions
Die folgenden möglichen Werte wurden hinzugefügt:
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
ActivityLog
Ein ActivityLog-Objekt ist eine vollständige Liste aller Aktivitäten, die in einem bestimmten Workfront Proof-Konto stattgefunden haben.
Der folgende Vorgang wurde aus dem ActivityLog-Objekt entfernt:
- HINZUFÜGEN
Anhang für die Ankündigung
Ein Ankündigungs-Attachment-Objekt stellt eine Datei dar, die an eine Workfront-Ankündigung angehängt wurde.
Weitere Informationen zu Ankündigungs-Anhängen finden Sie unter Ankündigungen senden
-
fileExtension
Hinzugefügte mögliche Werte:
-
qdoc (enum.fileExtension.qdoc)
-
qslides (enum.fileExtension.qslides)
-
qsheet (enum.fileExtension.qsheet)
-
Genehmigung
Für ein bestimmtes Arbeitselement, z. B. eine Aufgabe, ein Dokument oder eine Arbeitszeittabelle, kann es erforderlich sein, dass ein Verantwortlicher oder ein anderer Benutzer das Arbeitselement abzeichnet. Ein Validierungsobjekt stellt die Aktion des Abzeichnens eines Arbeitselements dar.
-
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 und gibt an, ob ein Benutzer einen kleinen, mittleren oder großen täglichen Aufwand benötigt, um eine Aufgabe abzuschließen. Mögliche Werte sind:
-
1 (Klein)
-
2 (Medium)
-
3 (Groß)
Weitere Informationen zum Work Effort in Workfront finden Sie unter Work Effort - Übersicht.
-
Kalenderabschnitt
Ein Kalenderabschnitt ist ein Kalenderbericht.
Weitere Informationen zu Kalenderberichten finden Sie unter Übersicht über Kalenderberichte.
Die folgenden Felder wurden zum CalendarSection -Objekt hinzugefügt, um die neue Funktionalität der Verwendung benutzerdefinierter Datumsangaben in Kalenderberichten zu unterstützen.
Weitere Informationen finden Sie unter Verwenden benutzerdefinierter Datumsfelder in einem Kalenderbericht.
-
customDate
-
customEndDateParameterID
-
customStartDateParameterID
-
ignoreActualDates
Firma
Ein Unternehmensobjekt stellt eine Organisation dar, die aus einer Sammlung von Personen besteht.
Weitere Informationen zu Unternehmen finden Sie unter Erstellen und Bearbeiten von Unternehmen.
-
groupID
Die ID der Gruppe, mit der die Firma verknüpft ist.
-
Gruppe
Die Gruppe, mit der die Firma verknüpft ist. Durch das Verknüpfen einer Firma mit einer Gruppe kann der Gruppenadministrator den Gruppenzugriff und die Gruppenberechtigungen für die Firma erweitern.
Kunde
Ein Customer-Objekt stellt eine Organisation dar, die eine Instanz von Workfront verwendet.
-
productEnabled
Bei dieser Aktion wird ein CustomerProductTypeEnum-Argument verwendet und ein boolescher Wert zurückgegeben, der angibt, ob dieser Kunde über ein Konto für dieses Produkt verfügt.
Kundenpräferenzen
Ein CustomerPreferences-Objekt stellt den Satz von Voreinstellungen dar, die ein Kunde für seine Workfront-Instanz festgelegt hat.
-
name
Hinzugefügte mögliche Werte:
- password:zoomIntegrationEnabled (Zoom-Integration im Aktualisierungsverlauf aktivieren)
- password:quipIntegrationEnabled (config.general.quip.enabled)
Dokument
Ein Dokumentobjekt, das eine Datei darstellt (z. B. geschriebenes Material, Bilder oder andere Informationsformen).
-
createLinkedProofVersion
Hinzugefügt
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 Hochladen einer neuen Version eines Dokuments.
-
externalIntegrationType
Entfernte möglichen Wert:
- QUIP (Quip)
-
proofDecision
Hinzugefügt
Die folgenden Aktionen wurden zum Dokumentobjekt hinzugefügt.
-
getDocumentReviewerDecision
Diese Aktion verwendet das documentVersionID-Argument (Zeichenfolge) und gibt eine Zuordnung zurück, die die Entscheidung der Überprüfenden angibt.
-
setDocumentReviewerDecision
Diese Aktion verwendet die folgenden Argumente:
-
documentVersionID (Zeichenfolge)
-
reviewerDecision (Zeichenfolge)
-
Kommentar (Zeichenfolge)
-
Gruppe
Ein Gruppenobjekt steht für eine Gruppe von Benutzern und Teams. Gruppen repräsentieren oft die Abteilungsstruktur.
-
businessLeaderID
Die ID des Business Leaders, der der Gruppe zugewiesen wurde.
-
Business Leader
Der der Gruppe zugewiesene Business Leader. Ein Business Leader ist jemand, der geschäftliche Entscheidungen für die Gruppe trifft.
Weitere Informationen über Business Leader finden Sie unter Business Leader - Übersicht.
-
assignMultiple
Diese Aktion verwendet die folgenden Argumente:
-
userIDs (string[])
-
roleIDs (Zeichenfolge[])
-
teamID (Zeichenfolge)
-
-
getGroupMembers
-
updateMembersList
Diese Aktion verwendet die folgenden Argumente:
-
newMemberIDs (string[])
-
removedMemberDs (Zeichenfolge[])
-
LinkedFolder
Ein LinkedFolder-Objekt stellt einen Ordner dar, der über einen externen Dokumentanbieter verknüpft ist, z. B. Google Drive oder Dropbox.
Weitere Informationen zu verknüpften Ordnern finden Sie unter Verknüpfen von Dokumenten aus externen Anwendungen.
-
externalIntegrationType
Entfernte möglichen Wert:
- QUIP (Quip)
OpTask
Ein OpTask-Objekt wird im Allgemeinen als Problem bezeichnet. Ein Problem ist ein Arbeitselement, das normalerweise darauf hinweist, dass ein Problem vorliegt, das den Abschluss einer Aufgabe oder eines Projekts verhindert. Ein Problem kann auch eine Helpdesk-Anfrage sein. Änderungsanforderungen, -anfragen und -fehler sind ebenfalls Probleme.
-
backlogOrder
Reihenfolge gibt die Position einer Aufgabe oder Story im Agile-Rückstand an.
Dieses Feld entfernte die folgenden Flags:
- DYNAMISCH,
- LAZY_READ,
- NOT_GROUPABLE:
Diese Aktionen haben den Argumentstatus hinzugefügt, um die neue Funktion der Schaltfläche Starten zu unterstützen. Damit wird der Status eines Arbeitselements geändert, wenn ein Benutzer auf die Schaltfläche klickt, um anzugeben, dass er mit der Bearbeitung des Elements begonnen hat.
Weitere Informationen finden Sie unter Schaltfläche „Bearbeiten“ durch eine Schaltfläche „Starten“.
-
acceptedWork
-
unacceptedWork
Parameter
Ein Parameter-Objekt ist ein benutzerdefiniertes Feld.
Die Parameterressource hat das Flag SHARABLE hinzugefügt.
Weitere Informationen zu benutzerdefinierten Feldern finden Sie unter Erstellen oder Bearbeiten eines benutzerdefinierten Formulars in Erstellen oder Bearbeiten eines benutzerdefinierten Formulars.
-
dataType
Zusätzlicher möglicher Wert:
-
RICH (Rich Text)
Weitere Informationen finden Sie unter Rich-Textfelder in der Adobe Workfront-API.
-
-
displayType
Zusätzlicher möglicher Wert:
-
RICH (Textfeld mit Formatierung)
Weitere Informationen finden Sie unter Rich-Textfelder in der Adobe Workfront-API.
-
-
label
Hinzugefügt
-
accessRules
Hinzugefügt
-
label
Hinzugefügt
Portfolio
Ein Portfolio-Objekt ist eine Sammlung von Projekten, die um dieselben Ressourcen konkurrieren, normalerweise Geld oder Personen, um sie abzuschließen.
Weitere Informationen zu Portfolios finden Sie unter Übersicht über das Portfolio in Adobe Workfront.
-
groupID
Die ID der Gruppe, mit der das Portfolio verknüpft ist.
-
Gruppe
Die Gruppe, mit der das Portfolio verknüpft ist.
Programm
Ein Programmobjekt ist eine Teilmenge von Projekten innerhalb eines Portfolios, in dem ähnliche Projekte gruppiert werden können.
-
groupID
Die ID der Gruppe, mit der das Programm verknüpft ist.
-
Gruppe
Die Gruppe, mit der das Programm verknüpft ist.
QueueDef
Ein QueueDef -Objekt stellt eine Warteschlange dar. Dabei handelt es sich um ein Projekt, das im Helpdesk-Bereich veröffentlicht wurde, um Benutzenden die Übermittlung von Problemen zu ermöglichen.
Weitere Informationen zu Anfrage-Warteschlangen finden Sie unter Erstellen einer Anfrage-Warteschlange.
-
RequestorCoreAction
Die folgenden möglichen Werte wurden hinzugefügt:
-
PLANNED_HOURS_CONTOURING
Benutzende mit einer Zugriffsebene, die diese Berechtigung enthält, können geplante Stunden im Workload-Balancer aktualisieren.
Weitere Informationen finden Sie unter Aktualisieren der geplanten Stunden bei der Verwaltung von Benutzerzuweisungen in Verwalten von Benutzerzuweisungen im Workload Balancer.
-
ADD_TO_CUSTOM_FORMS
Ein Benutzer mit einer Zugriffsebene, die diese Berechtigung enthält, kann benutzerdefinierten Formularen Felder hinzufügen.
Weitere Informationen finden Sie unter Erstellen oder Bearbeiten eines benutzerdefinierten Formulars.
-
EDIT_SYSTEMWIDE
Benutzende mit einer Zugriffsebene, die diese Berechtigung enthält, können ein benutzerdefiniertes Feld systemweit für den Löschzugriff freigeben.
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
-
Geplanter Bericht
Ein ScheduledReport-Objekt stellt einen Bericht dar, der für die Bereitstellung geplant wurde.
-
format
Hinzugefügte mögliche Werte:
-
qdoc (enum.fileExtension.qdoc)
-
qslides (enum.fileExtension.qslides)
-
qsheet (enum.fileExtension.qsheet)
-
ScoreCardQuestion
Ein ScoreCardQuestion-Objekt stellt eine Frage dar, die zu einer Scorecard hinzugefügt wurde. Diese Fragen werden in der Regel vom Portfoliomanager bestimmt und ihre Antworten geben dem Portfolio die Möglichkeit zu verstehen, wie gut ein Projekt mit den Portfoliozielen übereinstimmt.
Weitere Informationen zu Scorecard-Fragen finden Sie unter Erstellen einer Scorecard.
-
displayType
Zusätzlicher möglicher Wert: RICH (Textfeld mit Formatierung)
Weitere Informationen finden Sie unter Rich-Textfelder in der Adobe Workfront-API.
Aufgabe
Ein Aufgabenobjekt stellt ein Arbeitselement dar, das als Schritt zum Erreichen eines endgültigen Ziels (Fertigstellen eines Projekts) ausgeführt werden muss.
-
workEffort
Dieses Feld wurde hinzugefügt und gibt an, ob ein Benutzer einen kleinen, mittleren oder großen täglichen Aufwand benötigt, um eine Aufgabe abzuschließen. Mögliche Werte sind:
-
1 (Klein)
-
2 (Medium)
-
3 (Groß)
Weitere Informationen zum Work Effort in Workfront finden Sie unter Work Effort - Übersicht.
-
Diese Aktionen haben den Argumentstatus hinzugefügt, um die neue Funktion der Schaltfläche Starten zu unterstützen. Damit wird der Status eines Arbeitselements geändert, wenn ein Benutzer auf die Schaltfläche klickt, um anzugeben, dass er mit der Bearbeitung des Elements begonnen hat.
Weitere Informationen finden Sie unter Schaltfläche „Bearbeiten“ durch eine Schaltfläche „Starten“.
-
acceptedWork
-
unacceptedWork
Team
Ein Team-Objekt ist eine Sammlung von Benutzern, die einem Arbeitselement zugewiesen werden können.
Die folgenden Felder wurden der Team-Ressource hinzugefügt:
-
groupID
Dieses Feld verknüpft ein Team mit einer Gruppe. Dadurch wird das Team als Teil der Gruppe identifiziert und der Gruppenadministrator kann die Teams verwalten.
-
workOnItStatusChange
Dies ist ein boolescher Parameter, der angibt, ob die Schaltfläche „Bearbeiten“ des Teams als Schaltfläche „Starten“ 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 Team-Einstellungen konfigurierten Status.
-
In den folgenden Feldern können Sie benutzerdefinierte Status für die Schaltfläche „Starten“ für die einzelnen Arbeitselemente angeben.
-
workOnItOpTaskBugReportStatuses
-
workOnItOpTaskChangeOrderStatuses
-
workOnItOpTaskIssueStatuses
-
workOnItOpTaskRequestStatuses
workOnItTaskStatuses
Weitere Informationen über die Schaltfläche „Starten“ finden Sie Ersetzen der Schaltfläche „Bearbeiten“ durch eine Schaltfläche „Starten“.
-
Das folgende Feld wurde der Team-Ressource hinzugefügt:
- group
Vorlagenaufgabe
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 Bearbeiten einer Vorlagenaufgabe.
-
workEffort
Dieses Feld wurde hinzugefügt und gibt an, ob ein Benutzer einen kleinen, mittleren oder großen täglichen Aufwand benötigt, um eine Aufgabe abzuschließen. Mögliche Werte sind:
-
1 (Klein)
-
2 (Medium)
-
3 (Groß)
Weitere Informationen zum Work Effort in Workfront finden Sie unter Work Effort - Übersicht.
-
Arbeitszeittabelle
Ein Arbeitszeittabellen-Objekt stellt eine virtuelle Arbeitszeitkarte dar, mit der Benutzende tatsächliche Arbeitsstunden für Aufgaben, Projekte und allgemeine Stundentypen eingeben können.
Weitere Informationen zu Arbeitszeittabellen finden Sie unter Arbeitszeittabellen - Übersicht
Das folgende Feld wurde aus der Arbeitszeittabellen-Ressource entfernt:
- objCode
Aktualisieren
-
updateType
Die folgenden möglichen Werte wurden hinzugefügt:
-
initiativeAdd (enum.updateTypeEnum.initiativeAdd)
-
initiativeEdit (enum.updateTypeEnum.initiativeEdit)
Weitere Informationen zu Initiativen finden Sie unter Initiativen - Übersicht im Szenario-Planer.
-
Benutzerin oder Benutzer
Ein Benutzerobjekt stellt eine Person mit einem Konto in Workfront dar, die sich anmelden und mit dem System interagieren kann.
Die folgenden Felder wurden der Benutzerressource 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 Deaktivieren oder Reaktivieren eines Benutzers.
-
alignAccessType
In diesem Feld wird der Zugriff der Benutzenden auf Workfront-Ziele angezeigt. Mögliche Werte sind:
-
Kein Zugriff
-
Anzeigen
-
Bearbeiten
-
Die folgende Aktion wurde zur Benutzerressource hinzugefügt:
-
getUserAccessPermissionsByObjectCode
Diese Aktion verwendet die folgenden Argumente
-
IDs (Zeichenfolge)
-
objCode (Zeichenfolge)
-
Arbeit
Ein Arbeitsobjekt ist eine gemeinsame Schnittstelle, die sowohl von Task als auch von OpTask erbt wird und gemeinsamen Code zwischen den beiden verwendet.
-
backlogOrder
Reihenfolge gibt die Position einer Aufgabe oder Story im Agile-Rückstand an.
Dieses Feld entfernte die folgenden Flags:
-
DYNAMISCH,
-
LAZY_READ,
-
NOT_GROUPABLE
-
-
groupID
Dieses Feld fügte die folgenden Flags hinzu:
-
AUTO_LOAD,
-
DYNAMISCH,
-
READ_ONLY
-
-
workEffort
Dieses Feld wurde hinzugefügt und gibt an, ob ein Benutzer einen kleinen, mittleren oder großen täglichen Aufwand benötigt, um eine Aufgabe abzuschließen. Mögliche Werte sind:
-
1 (Klein)
-
2 (Medium)
-
3 (Groß)
Weitere Informationen zum Work Effort in Workfront finden Sie unter Work Effort - Übersicht.
-