DokumentationWorkfrontWorkfront-Handbuch

Neue Funktionen in API Version 15

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

Erstellt für:

  • Developer

Adobe Workfront hat die API-Version 15 am 14. Juni 2022 veröffentlicht. API Version 15 enthält die folgenden Änderungen gegenüber Version 14.

Hinzugefügte Ressourcen

Initiative (INITIV)

Das Objekt Initiative erstellt im Workfront-Szenario-Planer Schätzungen für die Art und Anzahl der Arbeitsplatzrollen, die Festkosten und den geplanten Nutzen.

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

Direkte Felder

  • customerID

    Dies ist ein internes Objekt.

  • Dauer

    Die Zeitspanne zwischen endDate und startDate.

  • endDate

    Das geplante Abschlussdatum für die Initiative.

  • enterByID

    Die ID, die dem Benutzer zugeordnet ist, der die Anfrage gesendet hat.

  • ID

    Die mit der Aktion verknüpfte ID

  • initiativeID

    Die mit der Initiative verknüpfte ID.

  • lastPublishedDate

    Das Datum der letzten Veröffentlichung der Initiative im Workfront-Szenario-Planer.

  • name

    Der Name der Initiative

  • planID

    Die Kennung des mit der Initiative verknüpften Plans.

  • planName

    Der Name des mit der Initiative verknüpften Plans.

  • projectID

    Die Kennung des mit der Initiative verknüpften Projekts.

  • scenarioID

    Die Kennung des Szenarios im Workfront-Szenario-Planer, der mit der Initiative verknüpft ist.

  • startDate

    Das geplante Startdatum der Initiative.

Referenzfelder

  • customer

  • enterBy

  • Projekt

Kernfelder

  • ID

  • name

  • objCode

Vorgänge

  • COUNT

  • GET

  • BERICHT

  • SEARCH

IssueDef (ISSDEF)

Das IssueDef -Objekt stellt einen Satz von Daten zum Format von Problemen dar. Dieses Objekt kann an Projekte oder Vorlagen angehängt werden und betrifft die Probleme, die diesem Projekt oder dieser Vorlage hinzugefügt werden.

Direkte Felder

  • ID

  • isInlineAddEnabled

Kernfelder

  • ID

  • objCode

ObjectIntegration (OBJINT)

In einigen Fällen ist es möglich, Workfront-Arbeitselemente direkt mit Objekten in einem externen Softwareprodukt zu verknüpfen. Das ObjectIntegration -Objekt stellt diese Verknüpfung dar.

Direkte Felder

  • customerID

    Dies ist ein internes Objekt.

  • entryDate

    Datum und Uhrzeit der Eingabe der ObjectIntegration im Workfront-System.

  • ID

    Die eindeutige Workfront-ID des bestimmten ObjectIntegration-Objekts.

  • integrationType

    Die externe Software, mit der das ObjectIntegration-Objekt eine Verknüpfung erstellt. Mögliche Werte sind:

    • JIRA

    • SALESFORCE

    • ANAPLAN

  • linkedObjectID

  • objID

    Das Objekt in Workfront, mit dem die ObjectIntegration verknüpft ist.

  • objObjCode

    Der Objektcode des Objekts in Workfront, mit dem die ObjectIntegration verknüpft ist.

  • param1

  • param2

  • param3

  • URL

Referenzfelder
  • customer
Kernfelder

  • ID

  • objCode

TaskDef (TSKDEF)

Das TaskDef-Objekt stellt einen Satz von Daten zum Aufgabenformat dar. Dieses Objekt kann an Projekte oder Vorlagen angehängt werden und wirkt sich auf die Aufgaben aus, die diesem Projekt oder dieser Vorlage hinzugefügt werden.

Direkte Felder

  • autoCalcPlannedHours

  • ID

Referenzfelder
  • defaultApprovalProcess
Sammlungsfelder
  • objectCategories
Kernfelder

  • ID

  • objCode

UserApproval (USRAPV)

Direkte Felder

  • approveID

  • customerID

  • ID

  • requedDate

  • requestorID

  • status

  • userID

Referenzfelder

  • Genehmiger

  • customer

  • Anfragender

  • Benutzer

Kernfelder

  • ID

  • objCode

Standardfelder

  • approveID

  • requestorID

  • status

  • userID

Aktionen

  • approve

  • reject

Vorgänge

  • HINZUFÜGEN

  • COUNT

  • DELETE

  • GET

  • BERICHT

  • SEARCH

Entfernte Ressourcen

Für API Version 15 wurden keine Ressourcen entfernt.

Geänderte Ressourcen

AccessLevel (ACSLVL)

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

Direkte Felder

  • fieldAccessPrivileges (string[])

    Die folgenden möglichen Werte wurden hinzugefügt:

    • VTMAWMG (Teams anzeigen, die mit meinen Gruppen verbunden sind)

    • VALLTM (Alle Teams anzeigen)

AccessLevelPermissions (ALVPER)

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

  • coreAction (string[])

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, in denen ich bin)

    • EDIT_TEAMS_I_GROUP_ADMIN (Teams in von mir verwalteten Gruppen bearbeiten (nur Gruppenadministratoren))

  • forbiddenActions (string[])

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, in denen ich bin)

    • EDIT_TEAMS_I_GROUP_ADMIN (Teams in von mir verwalteten Gruppen bearbeiten (nur Gruppenadministratoren))

  • secondaryActions (string[])

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, in denen ich bin)

    • EDIT_TEAMS_I_GROUP_ADMIN (Teams in von mir verwalteten Gruppen bearbeiten (nur Gruppenadministratoren))

AccessRequest (ACSREQ)

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

  • action (Zeichenfolge)

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, in denen ich bin)

    • EDIT_TEAMS_I_GROUP_ADMIN (Teams in von mir verwalteten Gruppen bearbeiten (nur Gruppenadministratoren))

  • autoShareAction (Zeichenfolge)

    Der folgende mögliche Wert wurde hinzugefügt:

    • WDL

AccessRule (ACSRUL)

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

Direkte Felder

  • coreAction (string[])

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, in denen ich bin)

    • EDIT_TEAMS_I_GROUP_ADMIN (Teams in von mir verwalteten Gruppen bearbeiten (nur Gruppenadministratoren))

  • forbiddenActions (string[])

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, in denen ich bin)

    • EDIT_TEAMS_I_GROUP_ADMIN (Teams in von mir verwalteten Gruppen bearbeiten (nur Gruppenadministratoren))

  • secondaryActions (string[])

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, in denen ich bin)

    • EDIT_TEAMS_I_GROUP_ADMIN (Teams in von mir verwalteten Gruppen bearbeiten (nur Gruppenadministratoren))

Genehmigung (GENEHMIGUNG)

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
  • resourcePlannerBudgetedHours
Referenzfelder

  • Initiative

    Hinzugefügt.

    Das Objekt Initiative erstellt im Workfront-Szenario-Planer Schätzungen für die Art und Anzahl der Arbeitsplatzrollen, die Festkosten und den geplanten Nutzen.

  • issueDef

    Hinzugefügt.

  • taskDef

    Hinzugefügt.

Sammlungsfelder

  • objectIntegrations

    Hinzugefügt.

    In einigen Fällen ist es möglich, Workfront-Arbeitselemente direkt mit Objekten in einem externen Softwareprodukt zu verknüpfen. Das ObjectIntegration -Objekt stellt diese Verknüpfung dar.

Kategorie (KG)

Ein Category -Objekt ist ein benutzerdefiniertes Formular.

Direkte Felder

  • catObjCode (Zeichenfolge)

    Der folgende mögliche Wert wurde hinzugefügt:

    • GRUPPE (Gruppe)

  • objTypes (string[])

    Hinzugefügt.

    Dieser Parameter ist ein Array möglicher Objekte, an die das benutzerdefinierte Formular angehängt werden kann. Es wurde hinzugefügt, um die Möglichkeit zu unterstützen, ein benutzerdefiniertes Formular an mehrere Objekttypen anzuhängen.

    Mögliche Werte:

    CMPY, PORT, PRGM, PROJ, TASK, OPTASK, USER, DOCU, EXPNS, ITRN, BILL, GROUP

Sammlungsfelder

  • objTypes (string[])

    Hinzugefügt.

    Dieser Parameter ist ein Array möglicher Objekte, an die das benutzerdefinierte Formular angehängt werden kann. Es wurde hinzugefügt, um die Möglichkeit zu unterstützen, ein benutzerdefiniertes Formular an mehrere Objekttypen anzuhängen.

    Mögliche Werte:

    CMPY, PORT, PRGM, PROJ, TASK, OPTASK, USER, DOCU, EXPNS, ITRN, BILL, GROUP

CategoryParameter (CTGYPA)

Direkte Felder

  • hideFormulaFromDescription

    Hinzugefügt.

  • journaledObjCodes

    Hinzugefügt.

  • rawCustomExpression

    Hinzugefügt.

CustomerPreferences (CUSTPR)

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

Direkte Felder

  • name

    Die folgenden Werte wurden hinzugefügt:

    • password:sharePointV2IntegrationEnabled (SharePoint (Graph API)-Integration aktiviert)

      Dieser Wert unterstützt die aktualisierte Sharepoint-Integration.

    • project.mgmt:default.project.allowcreatewithouttemplate (Benutzern erlauben, Projekte ohne Vorlage zu erstellen)

    • project.mgmt:taskissue.delegate (config.taskissue.delegate)

DocumentFolder (DOCFDR)

Dokumente können in Ordner unterteilt werden. Sie können persönliche Ordner in Ihrem Bereich "Dokumente"erstellen. Das DocumentFolder-Objekt stellt einen dieser Ordner dar.

Das DocumentFolder-Objekt hat das Flag hinzugefügt SHARABLE.

DocumentVersion (DOCV)

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

    Der folgende Wert wurde hinzugefügt:

    • SHAREPOINT_V2 (SharePoint (Graph API))

      Dieser Wert unterstützt die aktualisierte Sharepoint-Integration.

Gruppe (GRUPPE)

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

Weitere Informationen zu Gruppen finden Sie unter Gruppen vs. Teams.

Das Group -Objekt hat die Markierung hinzugefügt DATA_EXTENDIBLE

Direkte Felder

Die folgenden Felder wurden hinzugefügt:

  • categoryID

    Eine Kategorie ist ein benutzerdefiniertes Formular. Dieser Parameter wurde hinzugefügt, um die Möglichkeit zu unterstützen, benutzerdefinierte Forms zu Gruppenobjekten hinzuzufügen.

  • isActive

    Dies ist ein boolescher Parameter mit dem Wert true , wenn ein Objekt aktiv ist, und false , wenn dies nicht der Fall ist. Objekte, die auf "Aktiv"eingestellt sind, werden in Dropdown-Menüs und Typvorlagenfeldern angezeigt und können an andere Objekte angehängt werden.

Referenzfelder

Die folgenden Felder wurden hinzugefügt:

  • Genehmiger

  • customer

  • Anfragender

  • Benutzer

Sammlungsfelder

Die folgenden Felder wurden hinzugefügt:

  • objectCategories

  • objectIntegrations

    In einigen Fällen ist es möglich, Workfront-Arbeitselemente direkt mit Objekten in einem externen Softwareprodukt zu verknüpfen. Das ObjectIntegration -Objekt stellt diese Verknüpfung dar.

Standardfelder

Das folgende Feld wurde hinzugefügt:

  • isActive

    Dies ist ein boolescher Parameter mit dem Wert true , wenn ein Objekt aktiv ist, und false , wenn dies nicht der Fall ist. Objekte, die auf "Aktiv"eingestellt sind, werden in Dropdown-Menüs und Typvorlagenfeldern angezeigt und können an andere Objekte angehängt werden.

Aktionen

Die folgenden Felder wurden hinzugefügt:

  • calculateDataExtension

    Durch diese Aktion werden die Ausdrücke in benutzerdefinierten Formularfeldern neu berechnet.

  • completeGroupInfo

  • linkExternalObject

  • unlinkExternalObject

JournalEntry (JRNLE)

Das JournalEntry -Objekt kann so eingerichtet werden, dass bei jeder Änderung dieser Felder Informationen über bestimmte Objektfelder protokolliert werden. Wenn ein Feld so eingerichtet ist, dass es als Teil des Journaleintragsobjekts protokolliert wird, wird bei jeder Änderung dieses Felds ein entsprechender Journaleintrag erstellt.

Direkte Felder

changeType

Der folgende Wert wurde hinzugefügt:

  • DW (Download)

LinkedFolder (LNKFDR)

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 aus externen Anwendungen.

Direkte Felder

  • externalIntegrationType

    Der folgende Wert wurde hinzugefügt:

    • SHAREPOINT_V2 (SharePoint (Graph API))

      Dieser Wert unterstützt die aktualisierte Sharepoint-Integration.

OpTask/Problem (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.

Aktionen

Die folgenden Aktionen wurden hinzugefügt:

  • bulkMoveWithOptions

  • getRequestPath

Die folgende Aktion wurde geändert:

  • copyIssue

    Feld hinzugefügt parentID

Parameter (PARAM)

Ein Parameter -Objekt ist ein benutzerdefiniertes Feld.

Direkte Felder

Das folgende Feld wurde hinzugefügt:

  • fieldDefinition

Die folgenden Felder wurden geändert:

  • dataType

    Der mögliche Wert wurde hinzugefügt WIDGET (Widget)

    Dieser Wert unterstützt die Verwendung von Bildern in benutzerdefinierten Formularen.

  • displayType

    Der mögliche Wert wurde hinzugefügt WIDGET (Widget)

    Dieser Wert unterstützt die Verwendung von Bildern in benutzerdefinierten Formularen.

Portfolio (HAFEN)

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.

Sammlungsfelder
  • objectIntegrations
Aktionen

  • linkExternalObject

  • unlinkExternalObject

Programm (PRGM)

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

Sammlungsfelder
  • objectIntegrations
Aktionen

  • linkExternalObject

  • unlinkExternalObject

Projekt (PROJ)

Projekte sind Arbeitselemente in Workfront und stellen einen Hauptbaustein dar, wie Workfront Menschen bei der Arbeit unterstützt. Ein Projektobjekt stellt eine Gruppe von Aufgaben mit einem gemeinsamen, spezifischen Ziel dar.

Direkte Felder
  • resourcePlannerBudgetedHours
Referenzfelder

  • Initiative

    Das Objekt Initiative erstellt im Workfront-Szenario-Planer Schätzungen für die Art und Anzahl der Arbeitsplatzrollen, die Festkosten und den geplanten Nutzen.

  • issueDef

  • taskDef

Sammlungsfelder

  • objectIntegrations

    In einigen Fällen ist es möglich, Workfront-Arbeitselemente direkt mit Objekten in einem externen Softwareprodukt zu verknüpfen. Das ObjectIntegration -Objekt stellt diese Verknüpfung dar.

QueueDef (QUED)

Ein QueueDef-Objekt stellt eine Warteschlange dar. Hierbei handelt es sich um ein Projekt, das in den Help Desk-Bereich veröffentlicht wurde, um Benutzern die Möglichkeit zu geben, Probleme an sie zu senden.

Weitere Informationen zu Anforderungswarteschlangen finden Sie unter Erstellen einer Anforderungswarteschlange.

Direkte Felder

  • requestorCoreAction

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, in denen ich bin)

    • EDIT_TEAMS_I_GROUP_ADMIN (Teams in von mir verwalteten Gruppen bearbeiten (nur Gruppenadministratoren))

  • requestorForbiddenActions

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, in denen ich bin)

    • EDIT_TEAMS_I_GROUP_ADMIN (Teams in von mir verwalteten Gruppen bearbeiten (nur Gruppenadministratoren))

ScoreCardQuestion (SCOREQ)

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

  • displayType

    Der mögliche Wert wurde hinzugefügt WIDGET (Widget)

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.

Sammlungsfelder

  • objectIntegrations

    In einigen Fällen ist es möglich, Workfront-Arbeitselemente direkt mit Objekten in einem externen Softwareprodukt zu verknüpfen. Das ObjectIntegration -Objekt stellt diese Verknüpfung dar.

Vorlage (TMPL)

Ein Template -Objekt stellt ein Muster für ein Projekt dar. Projekte können aus Vorlagen erstellt werden, um Zeit zu sparen. Eine Vorlage enthält ein Team und Aufgaben, die in jedes aus der Vorlage erstellte Projekt kopiert werden.

Referenzfelder

  • issueDef

  • taskDef

Datenblatt (TSHET)

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

Kernfelder

Das folgende Feld wurde entfernt:

  • objCode

Anzeigen (UIVIEW)

Direkte Felder

  • uiviewType

    Die folgenden möglichen Werte wurden entfernt:

    • FOUR_COL (Vierspaltiges Layout)

    • UPDATES (Updates)

    • UPDATESTOOLBAR_FEED (Updates)

    • WORKINGON (Ich arbeite an)

    • CUSTOMDATA (Benutzerdefinierte Daten)

    • CUSTOMDATA_UPDATE (Benutzerdefinierte Daten aktualisieren)

    • STATUS_UPDATE (Status-Update)

    • OPTASK_STATUS_UPDATE (Status-Update)

    • PROJ_STATUS_UPDATE (Status-Update)

    • PROJECT_TIMEENTRY (Status-Update)

    • DLIST (Detailliste)

    • DLIST_SECTION (Abschnitt "Detailliste")

Aktualisieren (AKTUALISIEREN)

Arbeitselemente in Workfront können aktualisiert werden, damit Benutzer über den aktuellen Status informiert werden. Ein Update -Objekt stellt eine dieser Aktualisierungen dar. Aktualisierungen können von Benutzern eingegeben oder vom Workfront-System erstellt werden.

Direkte Felder

  • updateType

    Der mögliche Wert wurde hinzugefügt documentVersionDownload (enum.updatetypeenum.documentversiondownload)

Benutzer (BENUTZER)

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

Referenzfelder
  • userApproval
Aktionen

  • getUsersAvailableTime

  • resetRopgPassword

UserNote (USRNOT)

Ein UserNote -Objekt ist eine Benachrichtigung.

Direkte Felder

  • eventType

    Die folgenden möglichen Werte wurden hinzugefügt:

    • DUP (Testversand eines Dokuments angefordert)

    • DUV (Zulassen der Anzeige eines Dokuments)

Arbeit (ARBEIT)

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

Sammlungsfelder

  • objectIntegrations

    In einigen Fällen ist es möglich, Workfront-Arbeitselemente direkt mit Objekten in einem externen Softwareprodukt zu verknüpfen. Das ObjectIntegration -Objekt stellt diese Verknüpfung dar.

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