DokumentationWorkfrontWorkfront-Handbuch

Neue Funktionen in der API-Version 15

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

Erstellt für:

  • Entwickler

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

Ressourcen hinzugefügt

Initiative (INITIV)

Das Objekt Initiative erstellt im Workfront-Szenarioplaner Schätzungen für die Art und Anzahl der Aufgabengebiete, die Fixkosten und den geplanten Nutzen.

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

Direkte Felder

  • customerID

    Dies ist ein internes -Objekt.

  • duration

    Die Zeit zwischen endDate und startDate.

  • endDate

    Das geplante Abschlussdatum für die Initiative.

  • enteredByID

    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, an dem die Initiative zuletzt im Workfront Scenario Planner veröffentlicht wurde.

  • name

    Der Name der Initiative

  • planID

    Die ID des Plans, der mit der Initiative verknüpft ist.

  • planName

    Der Name des Plans, der mit der Initiative verknüpft ist.

  • projectID

    Die ID des Projekts, das der Initiative zugeordnet ist.

  • scenarioID

    Die ID des Szenarios im Workfront-Szenarioplaner, das mit der Initiative verknüpft ist.

  • startDate

    Das geplante Startdatum der Initiative.

Referenzfelder

  • Kunde

  • enteredBy

  • Projekt

Kernfelder

  • ID

  • name

  • objCode

Vorgänge

  • ANZAHL

  • GET

  • REPORT

  • SUCHE

Anfrage-Def (ISSDEF)

Das IssueDef-Objekt stellt einen Satz von Daten zum Format von Anfragen dar. Dieses Objekt kann an Projekte oder Vorlagen angehängt werden und wirkt sich auf die Probleme aus, 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 Relation dar.

Direkte Felder

  • customerID

    Dies ist ein internes -Objekt.

  • entryDate

    Datum und Uhrzeit der Eingabe der ObjectIntegration in das Workfront-System.

  • ID

    Die eindeutige Workfront-ID des spezifischen 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
  • Kunde
Kernfelder

  • ID

  • objCode

TaskDef (TSKDEF)

Das TaskDef-Objekt stellt einen Satz von Daten zum Format von Aufgaben 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
  • objectCategory
Kernfelder

  • ID

  • objCode

Benutzerzustimmung (USRAPV)

Direkte Felder

  • approverID

  • customerID

  • ID

  • requestedDate

  • RequestorID

  • status

  • userID

Referenzfelder

  • Genehmiger

  • Kunde

  • Antragsteller

  • Benutzer

Kernfelder

  • ID

  • objCode

Standardfelder

  • approverID

  • RequestorID

  • status

  • userID

Aktionen

  • Genehmigen

  • Ablehnen

Vorgänge

  • HINZUFÜGEN

  • ANZAHL

  • DELETE

  • GET

  • BERICHT

  • SUCHE

Entfernte Ressourcen

Für API-Version 15 wurden keine Ressourcen entfernt.

Geänderte Ressourcen

Zugriffsebene (ACSLV)

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

Direkte Felder

  • fieldAccessPrivileges (string[])

    Die folgenden möglichen Werte wurden hinzugefügt:

    • VTMAWMG (Meinen Gruppen zugeordnete Teams anzeigen)

    • VALLTM (Alle Teams anzeigen)

AccessLevelPermissions (ALVPER)

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 (Zeichenfolge[])

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, an denen ich mitwirke)

    • 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, an denen ich mitwirke)

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

  • secondaryActions (Zeichenfolge[])

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, an denen ich mitwirke)

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

Zugriffsanforderung (ACSREQ)

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

  • action (Zeichenfolge)

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, an denen ich mitwirke)

    • 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

Zugriffsregel (ACSRUL)

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

Direkte Felder

  • coreAction (Zeichenfolge[])

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, an denen ich mitwirke)

    • 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, an denen ich mitwirke)

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

  • secondaryActions (Zeichenfolge[])

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, an denen ich mitwirke)

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

Validierung (VALIDIERUNG)

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

  • Initiative

    hinzugefügt.

    Das Objekt Initiative erstellt im Workfront-Szenarioplaner Schätzungen für die Art und Anzahl der Aufgabengebiete, die Fixkosten 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 Relation dar.

Kategorie (CTG)

Ein Kategorieobjekt ist ein benutzerdefiniertes Formular.

Direkte Felder

  • catObjCode (Zeichenfolge)

    Der folgende mögliche Wert wurde hinzugefügt:

    • GROUP (Gruppe)

  • objTypes (Zeichenfolge[])

    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:

    KOPIEREN, PORT, PRGM, PROJ, AUFGABE, OPTASK, BENUTZER, DOKUMENT, AUSGABEN, INTERN, RECHNUNG, GRUPPE

Sammlungsfelder

  • objTypes (Zeichenfolge[])

    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:

    KOPIEREN, PORT, PRGM, PROJ, AUFGABE, OPTASK, BENUTZER, DOKUMENT, AUSGABEN, INTERN, RECHNUNG, GRUPPE

Kategorieparameter (CTGYPA)

Direkte Felder

  • hideFormulaFromDescription

    hinzugefügt.

  • journalizedObjCodes

    hinzugefügt.

  • rawCustomExpression

    hinzugefügt.

Kundenvoreinstellungen (CUSTPR)

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

Direkte Felder

  • name

    Die folgenden Werte wurden hinzugefügt:

    • password:sharePointV2IntegrationEnabled (Integration der SharePoint (Graph API) 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 Ordnern organisiert werden. Sie können persönliche Ordner in Ihrem Bereich für persönliche Dokumente erstellen. Das DocumentFolder-Objekt stellt einen dieser Ordner dar.

Das DocumentFolder-Objekt hat die SHARABLE hinzugefügt.

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 Hochladen einer neuen Version eines Dokuments.

Direkte Felder

  • externalIntegrationType

    Folgender Wert wurde hinzugefügt:

    • SHAREPOINT_V2 (SharePoint (Graph API)

      Dieser Wert unterstützt die aktualisierte SharePoint-Integration.

Gruppe (GROUP)

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

Weitere Informationen zu Gruppen finden Sie unter Gruppen im Vergleich zu Teams .

Das Gruppenobjekt hat die DATA_EXTENDIBLE hinzugefügt

Direkte Felder

Die folgenden Felder wurden hinzugefügt:

  • categoryID

    Eine Kategorie ist ein benutzerdefiniertes Formular. Dieser Parameter wurde hinzugefügt, um das Hinzufügen benutzerdefinierter Forms zu Gruppenobjekten zu unterstützen.

  • isActive

    Dies ist ein boolescher Parameter, der den Wert „true“ hat, wenn ein Objekt „Active“ ist, und den Wert „false“, wenn es nicht ist. Objekte, die als Aktiv festgelegt sind, werden in Dropdown-Menüs und Feldern mit automatischer Textvervollständigung angezeigt und können an andere Objekte angehängt werden.

Referenzfelder

Die folgenden Felder wurden hinzugefügt:

  • Genehmiger

  • Kunde

  • Antragsteller

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

Standardfelder

Das folgende Feld wurde hinzugefügt:

  • isActive

    Dies ist ein boolescher Parameter, der den Wert „true“ hat, wenn ein Objekt „Active“ ist, und den Wert „false“, wenn es nicht ist. Objekte, die als Aktiv festgelegt sind, werden in Dropdown-Menüs und Feldern mit automatischer Textvervollständigung angezeigt und können an andere Objekte angehängt werden.

Aktionen

Die folgenden Felder wurden hinzugefügt:

  • calculateDataExtension

    Diese Aktion berechnet die Ausdrücke in benutzerdefinierten Formularfeldern neu.

  • completeGroupInfo

  • linkExternalObject

  • unlinkExternalObject

Tagebucheintrag (JRNLE)

Das JournalEntry-Objekt kann so eingerichtet werden, dass Informationen zu bestimmten Objektfeldern jedes Mal protokolliert werden, wenn diese Felder geändert werden. Wenn ein Feld so eingerichtet ist, dass es als Teil des Journaleintragsobjekts protokolliert wird, wird jedes Mal, wenn dieses Feld geändert wird, ein entsprechender Journaleintrag erstellt.

Direkte Felder

changeType

Folgender Wert wurde hinzugefügt:

  • DW (Download)

Verknüpfter Ordner (LINKFDR)

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

Direkte Felder

  • externalIntegrationType

    Folgender Wert wurde hinzugefügt:

    • SHAREPOINT_V2 (SharePoint (Graph API)

      Dieser Wert unterstützt die aktualisierte SharePoint-Integration.

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

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 WIDGET (Widget) wurde hinzugefügt

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

  • displayType

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

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

Portfolio (PORT)

Ein Portfolio-Objekt ist eine Sammlung von Projekten, die um dieselben Ressourcen konkurrieren, normalerweise Geld oder Personen, um sie abzuschließen.

Sammlungsfelder
  • objectIntegrations
Aktionen

  • linkExternalObject

  • unlinkExternalObject

Programm (PRGM)

Ein Programmobjekt ist eine Teilmenge von Projekten innerhalb eines Portfolios, in dem ähnliche Projekte gruppiert werden können.

Sammlungsfelder
  • objectIntegrations
Aktionen

  • linkExternalObject

  • unlinkExternalObject

Projekt (PROJ)

Projekte sind Arbeitselemente innerhalb von Workfront und ein wichtiger Baustein in der Art und Weise, wie Workfront Menschen bei der Arbeit unterstützt. Ein Project-Objekt stellt eine Gruppe von Aufgaben mit einem gemeinsamen, spezifischen Ziel dar.

Direkte Felder
  • resourcePlannerBudgetedHours
Referenzfelder

  • Initiative

    Das Objekt Initiative erstellt im Workfront-Szenarioplaner Schätzungen für die Art und Anzahl der Aufgabengebiete, die Fixkosten 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 Relation dar.

QueueDef (QUED)

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

  • RequestorCoreAction

    Die folgenden möglichen Werte wurden hinzugefügt:

    • EDIT_TEAMS_I_AM_ON (Teams bearbeiten, an denen ich mitwirke)

    • 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, an denen ich mitwirke)

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

ScoreCardQuestion (SCOREQ)

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

  • displayType

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

Aufgabe (AUFGABE)

Ein Aufgabenobjekt stellt ein Arbeitselement dar, das als Schritt zum Erreichen eines endgültigen Ziels (Fertigstellen 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 Relation dar.

Vorlage (TMPL)

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

Arbeitszeittabelle (TABELLE)

Ein Arbeitszeittabellen-Objekt stellt eine virtuelle Arbeitszeitkarte dar, mit der Benutzende tatsächliche Arbeitsstunden für Aufgaben, Projekte und allgemeine Stundentypen 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 (Aktualisierungen)

    • UPDATESTOOLBAR_FEED (Aktualisierungen)

    • WORKINGON (in Arbeit)

    • CUSTOMDATA (Benutzerdefinierte Daten)

    • CUSTOMDATA_UPDATE (Benutzerdefinierte Daten aktualisieren)

    • STATUS_UPDATE (Statusaktualisierung)

    • OPTASK_STATUS_UPDATE (Statusaktualisierung)

    • PROJ_STATUS_UPDATE (Statusaktualisierung)

    • PROJECT_TIMEENTRY (Statusaktualisierung)

    • DLIST (Detailliste)

    • DLIST_SECTION (Abschnitt Detailliste)

Aktualisieren (UPDATE)

Arbeitselemente in Workfront können aktualisiert werden, um Benutzende über den aktuellen Status zu informieren. Ein Update -Objekt stellt eine dieser Aktualisierungen dar. Aktualisierungen können von Benutzenden eingegeben oder vom Workfront-System erstellt werden.

Direkte Felder

  • updateType

    Der mögliche Wert documentVersionDownload (enum.updateTypeEnum.DocumentVersionDownload) wurde hinzugefügt.

Benutzer (USER)

Ein Benutzerobjekt 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 (hat Sie um den Korrekturabzug eines Dokuments gebeten)

    • DUV (Ermöglicht die Anzeige eines Dokuments)

Arbeit (ARBEIT)

Ein Arbeitsobjekt ist eine gemeinsame Schnittstelle, die sowohl von Task als auch von OpTask erbt wird und gemeinsamen Code zwischen den beiden 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 Relation dar.

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