DokumentationWorkfrontWorkfront-Handbuch

Neue Funktionen in der API-Version 12

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

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 breadcrumb

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 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 accesslevel

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 accesslevelpermissions

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.

Direkte Felder

  • coreAction

    Die folgenden möglichen Werte wurden hinzugefügt:

  • 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 accessrequest

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.

Direkte Felder

Zugriffsregel accessrule

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

Direkte Felder

  • coreAction

    Die folgenden möglichen Werte wurden hinzugefügt:

  • 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 activitylog

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

Vorgänge

Der folgende Vorgang wurde aus dem ActivityLog-Objekt entfernt:

  • HINZUFÜGEN

Anhang für die Ankündigung announcementattachment

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

Direkte Felder

  • fileExtension

    Hinzugefügte mögliche Werte:

    • qdoc (enum.fileExtension.qdoc)

    • qslides (enum.fileExtension.qslides)

    • qsheet (enum.fileExtension.qsheet)

Genehmigung approval

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.

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 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 calendarsection

Ein Kalenderabschnitt ist ein Kalenderbericht.

Weitere Informationen zu Kalenderberichten finden Sie unter Übersicht über Kalenderberichte.

Direkte Felder

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 company

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.

Direkte Felder

  • groupID

    Die ID der Gruppe, mit der die Firma verknüpft ist.

Referenzfelder

  • 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 customer

Ein Customer-Objekt stellt eine Organisation dar, die eine Instanz von Workfront verwendet.

Aktionen

  • 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 customerpreferences

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

Direkte Felder

  • name

    Hinzugefügte mögliche Werte:

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

Dokument document

Ein Dokumentobjekt, das eine Datei darstellt (z. B. geschriebenes 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 Hochladen einer neuen Version eines Dokuments.

Direkte Felder

  • externalIntegrationType

    Entfernte möglichen Wert:

    • QUIP (Quip)

  • proofDecision

    Hinzugefügt

Aktionen

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 group

Ein Gruppenobjekt steht für eine Gruppe von Benutzern und Teams. Gruppen repräsentieren oft die Abteilungsstruktur.

Direkte Felder

  • businessLeaderID

    Die ID des Business Leaders, der der Gruppe zugewiesen wurde.

Referenzfelder

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

Aktionen

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

Direkte Felder

  • externalIntegrationType

    Entfernte möglichen Wert:

    • QUIP (Quip)

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

Direkte Felder

  • 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:
Aktionen

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

Direkte Felder
Sammlungsfelder

  • accessRules

    Hinzugefügt

Standardfelder

  • label

    Hinzugefügt

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

Direkte Felder

  • groupID

    Die ID 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 innerhalb eines Portfolios, in dem ähnliche Projekte gruppiert werden können.

Direkte Felder

  • groupID

    Die ID 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. 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.

Direkte Felder

Geplanter Bericht scheduledreport

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

Direkte Felder

  • format

    Hinzugefügte mögliche Werte:

    • qdoc (enum.fileExtension.qdoc)

    • qslides (enum.fileExtension.qslides)

    • qsheet (enum.fileExtension.qsheet)

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

Direkte Felder

Aufgabe task

Ein Aufgabenobjekt stellt ein Arbeitselement dar, das als Schritt zum Erreichen eines endgültigen Ziels (Fertigstellen eines Projekts) ausgeführt werden muss.

Direkte Felder

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

Aktionen

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 team

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

Direkte Felder

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

Referenzfelder

Das folgende Feld wurde der Team-Ressource hinzugefügt:

  • group

Vorlagenaufgabe 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 Bearbeiten einer Vorlagenaufgabe.

Direkte Felder

  • 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 timesheet

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

Kernfelder

Das folgende Feld wurde aus der Arbeitszeittabellen-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 Initiativen - Übersicht im Szenario-Planer.

Benutzerin oder Benutzer user

Ein Benutzerobjekt 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 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

Aktionen

Die folgende Aktion wurde zur Benutzerressource hinzugefügt:

  • getUserAccessPermissionsByObjectCode

    Diese Aktion verwendet die folgenden Argumente

    • IDs (Zeichenfolge)

    • objCode (Zeichenfolge)

Arbeit work

Ein Arbeitsobjekt ist eine gemeinsame Schnittstelle, die sowohl von Task als auch von OpTask erbt wird und gemeinsamen Code zwischen den beiden verwendet.

Direkte Felder

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

recommendation-more-help