DokumentationWorkfrontAnvändarhandbok om Workfront

Nyheter i API-version 12

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Utvecklare

Workfront släppte API version 12 den 12 november 2020. API-version 12 innehåller följande ändringar från version 11

Tillagda resurser

Följande resurser är nya i Workfront API version 12.

Ett BreadCrumb-objekt representerar ett element i hierarkin för överordnade/underordnade element för ett Adobe Workfront-arbetsobjekt. Brevbeskrivningar visar hur en arbetsuppgift passar in i den större strukturen för Portfolio, projekt, projekt och uppgifter.

Mer information om vägbeskrivningar i Workfront finns i Översikt över vägbeskrivningar i nya Adobe Workfront

  • getObjectHierarchy

RichTextParameterValue richtextparametervalue

RTF-fält är nu tillgängliga för fler objekt. RichTextParameterValue-objektet lades till i Workfront för att stödja den här tillgängligheten.

Mer information finns i RTF-fält i Adobe Workfront API.

  • ID
  • ID
  • objCode

Borttagna resurser

Inga resurser togs bort för API-version 12.

Ändrade resurser

Följande resurser ändrades för Workfront API version 12.

AccessLevel accesslevel

Ett AccessLevel-objekt är associerat med användare och beskriver uppsättningen AccessLevelPermissions som avgör vad användaren kan komma åt.

Mer information om åtkomstnivåer finns i Hur åtkomstnivåer fungerar.

AccessLevelPermissions accesslevelpermissions

Ett AccessLevelPermissions-objekt representerar en specifik behörighet för att komma åt, skapa eller ändra ett Workfront-objekt. Dessa behörigheter kan sedan kopplas till en åtkomstnivå.

Direktfält

  • coreAction

    Följande possibleValues har lagts till:

  • forbiddenActions

    Följande possibleValues har lagts till:

    • PLANNED_HOURS_CONTOURING

    • ADD_TO_CUSTOM_FORMS

    • EDIT_SYSTEMWIDE

  • secondaryActions

    Följande possibleValues har lagts till:

    • PLANNED_HOURS_CONTOURING

    • ADD_TO_CUSTOM_FORMS

    • EDIT_SYSTEMWIDE

AccessRequest accessrequest

Om en användare inte har åtkomst till ett objekt i Workfront som de behöver kan de begära åtkomst till det objektet. AccessRequest-objektet representerar denna begäran.

Direktfält

AccessRule accessrule

Ett AccessRule-objekt representerar en regeluppsättning med anpassade åtkomstnivåer som avgör hur användare kan dela projekt som de skapar.

Direktfält

  • coreAction

    Följande possibleValues har lagts till:

  • forbiddenActions

    Följande possibleValues har lagts till:

    • PLANNED_HOURS_CONTOURING

    • ADD_TO_CUSTOM_FORMS

    • EDIT_SYSTEMWIDE

  • secondaryActions

    Följande possibleValues har lagts till:

    • PLANNED_HOURS_CONTOURING

    • ADD_TO_CUSTOM_FORMS

    • EDIT_SYSTEMWIDE

ActivityLog activitylog

Ett ActivityLog-objekt är en fullständig lista över alla aktiviteter som har utförts i ett visst Workfront Proof-konto.

Operationer

Följande åtgärd togs bort från ActivityLog-objektet:

  • LÄGG TILL

AnnouncementAttachment announcementattachment

Ett AnnouncementAttachment-objekt representerar en fil som har bifogats till ett Workfront-meddelande.

Mer information om meddelandebilagor finns i Skicka meddelanden

Direktfält

  • fileExtension

    Möjliga värden har lagts till:

    • qdoc (enum.fileextension.qdoc)

    • qslides (enum.fileextension.qslides)

    • qsheet (enum.fileextension.qsheet)

Godkännande approval

En viss arbetsuppgift, till exempel en uppgift, ett dokument eller en tidrapport, kan kräva att en ansvarig eller annan användare signerar arbetsposten. Ett Approval-objekt representerar åtgärden för signering av en arbetsuppgift.

Direktfält

  • backlogOrder

    Följande flaggor har tagits bort:

    • DYNAMISKA,

    • LAZY_READ,

    • NOT_GROUPABLE

  • groupID

    Följande flaggor har lagts till

    • AUTO_LOAD,

    • DYNAMISKA,

    • READ_ONLY

  • workEffort

    Det här fältet lades till och anger om det tar en användare en liten, medelstor eller stor del av den dagliga arbetsinsatsen att slutföra en uppgift. Möjliga värden är:

    • 1 (liten)

    • 2 (Medium)

    • 3 (stor)

    Mer information om Arbetsinsats i Workfront finns i Översikt över Arbetsinsats.

CalendarSection calendarsection

Ett kalenderavsnitt är en kalenderrapport.

Mer information om kalenderrapporter finns i Översikt över kalenderrapporter.

Direktfält

Följande fält har lagts till i CalendarSection-objektet för att ge stöd för den nya funktionen att använda anpassade datum i kalenderrapporter.

Mer information finns i Använd anpassade datumfält i en kalenderrapport.

  • customDate

  • customEndDateParameterID

  • customStartDateParameterID

  • ignoreActualDates

Företag company

Ett företagsobjekt representerar en organisation som består av en samling personer.

Mer information om företag finns i Skapa och redigera företag.

Direktfält

  • groupID

    ID för gruppen som företaget är associerat med.

Referensfält

  • grupp

    Gruppen som företaget är associerat med. Genom att associera ett företag med en grupp kan gruppadministratören utöka gruppåtkomst och behörigheter till företaget.

Kund customer

Ett kundobjekt representerar en organisation som använder en instans av Workfront.

Åtgärder

  • productEnabled

    Den här åtgärden tar ett CustomerProductTypeEnum-argument och returnerar ett booleskt värde som anger om kunden har ett konto för produkten.

CustomerPreferences customerpreferences

Ett CustomerPreferences-objekt representerar den uppsättning inställningar som en kund har ställt in för sin instans av Workfront.

Direktfält

  • name

    Möjliga värden har lagts till:

    • lösenord:zoomIntegrationEnabled (Aktivera zoomintegration i uppdateringsströmmen)
    • password:quipIntegrationEnabled (config.general.quip.enabled)

Dokument document

Ett Document-objekt representerar en fil (t.ex. skrivet material, bilder eller andra typer av information).

Åtgärder

  • createLinkedProofVersion

    Tillagd

DocumentVersion documentversion

Ett DocumentVersion-objekt representerar en specifik version av en fil (t.ex. skrivet material, bilder eller andra typer av information).

Mer information om dokumentversioner finns i Överföra en ny version av ett dokument.

Direktfält

  • externalIntegrationType

    Möjligt värde har tagits bort:

    • QUIP (Quip)

  • proofDecision

    Tillagd

Åtgärder

Följande åtgärder har lagts till i Document-objektet.

  • getDocumentReviewerDecision

    Den här åtgärden tar argumentet documentVersonID (sträng) och returnerar en karta som anger granskarens beslut.

  • setDocumentReviewerDecision

    Den här åtgärden har följande argument:

    • documentVersionID (sträng)

    • reviewerDecision (sträng)

    • kommentar (sträng)

Grupp group

Ett Group-objekt representerar en uppsättning användare och team. Grupper representerar ofta avdelningsstruktur.

Direktfält

  • businessLeaderID

    ID för den affärsledare som är tilldelad gruppen.

Referensfält

  • businessLeader

    Den affärsledare som tilldelats gruppen. En företagsledare är någon som fattar affärsbeslut för gruppen.

    Mer information om företagsledare finns i Översikt över företagsledare.

Åtgärder

  • assignMultiple

    Den här åtgärden har följande argument:

    • userIDs (string[])

    • roleIDs (string[])

    • teamID (sträng)

  • getGroupMembers

  • updateMembersList

    Den här åtgärden har följande argument:

    • newMemberID (sträng[])

    • removedMemberDs (string[])

LinkedFolder linkedfolder

Ett LinkedFolder-objekt representerar en mapp som är länkad från en extern dokumentleverantör, till exempel Google Drive eller Dropbox.

Mer information om länkade mappar finns i Länka dokument från externa program.

Direktfält

  • externalIntegrationType

    Möjligt värde har tagits bort:

    • QUIP (Quip)

OpTask optask

Ett OpTask-objekt kallas vanligtvis för ett problem. Ett problem är en arbetsuppgift som vanligtvis anger att det finns ett problem som förhindrar att en uppgift eller ett projekt slutförs. Ett problem kan också vara en Help Desk-begäran. Ändringsorder, begäranden och buggar är också problem.

Direktfält

  • backlogOrder

    Ordningen anger en uppgifts eller artikels position på Agile-eftersläpningen.

    Det här fältet tog bort följande flaggor:

    • DYNAMISKA,
    • LAZY_READ,
    • NOT_GROUPABLE:
Åtgärder

De här åtgärderna har lagt till argumentstatusen för att stödja den nya Start-knappfunktionen, som ändrar statusen för en arbetsuppgift när en användare klickar på knappen för att ange att de har påbörjat arbetet med posten.

Mer information finns i Ersätt knappen Arbeta med med knappen Start.

  • acceptWork

  • unacceptWork

Parameter parameter

Ett Parameter-objekt är ett anpassat fält.

Parameterresursen lade till flaggan SHARABLE.

Mer information om anpassade fält finns i Skapa eller redigera ett anpassat formulär i Skapa eller redigera ett anpassat formulär.

Direktfält
Samlingsfält

  • accessRules

    Tillagd

Standardfält

  • etikett

    Tillagd

Portfolio portfolio

Ett Portfolio-objekt är en samling projekt som konkurrerar om samma resurser, vanligtvis pengar eller personer som ska slutföra dem.

Mer information om portföljer finns i Översikt över Portfolio i Adobe Workfront.

Direktfält

  • groupID

    ID för gruppen som portföljen är associerad med.

Referensfält

  • grupp

    Gruppen som portföljen är associerad med.

Program program

Ett Program-objekt är en delmängd av projekt i en portfölj, där liknande projekt kan grupperas tillsammans.

Direktfält

  • groupID

    ID för gruppen som programmet är associerat med.

Referensfält

  • grupp

    Gruppen som programmet är associerat med.

QueueDef queuedef

Ett QueueDef-objekt representerar en kö, vilket är ett projekt som har publicerats till Help Desk-området där användarna kan skicka problem till den.

Mer information om begärandeköer finns i Skapa en begärandekö.

Direktfält

SchemalagdRapport scheduledreport

Ett ScheduledReport-objekt representerar en rapport som har konfigurerats att schemaläggas för leverans.

Direktfält

  • format

    Möjliga värden har lagts till:

    • qdoc (enum.fileextension.qdoc)

    • qslides (enum.fileextension.qslides)

    • qsheet (enum.fileextension.qsheet)

ScoreCardQuestion scorecardquestion

Ett ScoreCardQuestion-objekt representerar en fråga som har lagts till i ett styrkort. Dessa frågor avgörs vanligtvis av Portfolio-förvaltaren och deras svar gör det möjligt för förvaltaren att förstå hur väl ett projekt passar ihop med portföljens mål.

Mer information om styrkortsfrågor finns i Skapa ett styrkort.

Direktfält

Uppgift task

Ett Task-objekt representerar en arbetsuppgift som måste utföras som ett steg mot att uppnå ett slutligt mål (slutföra ett projekt).

Direktfält

  • workEffort

    Det här fältet lades till och anger om det tar en användare en liten, medelstor eller stor del av den dagliga arbetsinsatsen att slutföra en uppgift. Möjliga värden är:

    • 1 (liten)

    • 2 (Medium)

    • 3 (stor)

    Mer information om Arbetsinsats i Workfront finns i Översikt över Arbetsinsats.

Åtgärder

De här åtgärderna har lagt till argumentstatusen för att stödja den nya Start-knappfunktionen, som ändrar statusen för en arbetsuppgift när en användare klickar på knappen för att ange att de har påbörjat arbetet med posten.

Mer information finns i Ersätt knappen Arbeta med med knappen Start.

  • acceptWork

  • unacceptWork

Team team

Ett Team-objekt är en samling användare som kan tilldelas till ett arbetsobjekt.

Direktfält

Följande fält har lagts till i teamresursen:

  • groupID

    Det här fältet associerar ett team med en grupp. Detta identifierar teamet som en del av gruppen och ger gruppadministratören möjlighet att hantera teamen.

  • workOnItStatusChange

    Det här är en boolesk parameter som anger om teamets Work on It-knapp har konfigurerats som en Start-knapp. När en teammedlem klickar på en Start-knapp för att börja arbeta med ett arbetsobjekt ändras objektets status från Nytt till en status som konfigurerats i gruppinställningarna.

  • I följande fält kan du ange anpassade statusvärden för Start-knappen för de enskilda arbetsobjekten.

    • workOnItOpTaskBugReportStatuses

    • workOnItOpTaskChangeOrderStatuses

    • workOnItOpTaskIssueStatuses

    • workOnItOpTaskRequestStatuses

      workOnItTaskStatuses

    Mer information om knappen Start finns i Ersätt knappen Work On It med knappen Start.

Referensfält

Följande fält har lagts till i teamresursen:

  • grupp

TemplateTask templatetask

Ett TemplateTask-objekt representerar en aktivitet som är en del av en Template. Malluppgifter blir uppgifter i det projekt där mallen används.

Mer information om malluppgifter finns i Redigera en malluppgift.

Direktfält

  • workEffort

    Det här fältet lades till och anger om det tar en användare en liten, medelstor eller stor del av den dagliga arbetsinsatsen att slutföra en uppgift. Möjliga värden är:

    • 1 (liten)

    • 2 (Medium)

    • 3 (stor)

    Mer information om Arbetsinsats i Workfront finns i Översikt över Arbetsinsats.

Tidrapport timesheet

Ett Timesheet-objekt representerar ett virtuellt tidkort som gör att användare kan ange faktiskt antal arbetstimmar för uppgifter, projekt och obemannade timtyper.

Mer information om tidrapporter finns i Översikt över tidrapporter

Kärnfält

Följande fält har tagits bort från tidrapportresursen:

  • objcode

Uppdatera

Direktfält

  • updateType

    Följande möjliga värden har lagts till:

    • InitiativeAdd (enum.updatetypeenum.initiativeadd)

    • InitiativeEdit (enum.updatetypeenum.initiativeedit)

    Mer information om initiativ finns i Översikt över initiativ i scenarioplanen.

Användare user

Ett User-objekt representerar en person med ett konto i Workfront som kan logga in och interagera med systemet.

Direktfält

Följande fält har lagts till i användarresursen:

  • actualDeactivationDate

    Detta representerar datum och tid då en användare inaktiverades.

    Mer information om inaktiverade användare finns i Inaktivera eller återaktivera en användare.

  • alignAccessType

    I det här fältet visas användarens åtkomst till Workfront-mål. Möjliga värden är:

    • Ingen åtkomst

    • Visa

    • Redigera

Åtgärder

Följande åtgärd lades till i användarresursen:

  • getUserAccessPermissionsByObjCode

    Den här åtgärden använder följande argument

    • ids (sträng)

    • objCode (sträng)

Arbete work

Ett Work-objekt är ett vanligt gränssnitt som både Task och OpTask ärver och delar gemensam kod mellan de två.

Direktfält

  • backlogOrder

    Ordningen anger en uppgifts eller artikels position på Agile-eftersläpningen.

    Det här fältet tog bort följande flaggor:

    • DYNAMISKA,

    • LAZY_READ,

    • NOT_GROUPABLE

  • groupID

    I det här fältet har följande flaggor lagts till:

    • AUTO_LOAD,

    • DYNAMISKA,

    • READ_ONLY

  • workEffort

    Det här fältet lades till och anger om det tar en användare en liten, medelstor eller stor del av den dagliga arbetsinsatsen att slutföra en uppgift. Möjliga värden är:

    • 1 (liten)

    • 2 (Medium)

    • 3 (stor)

    Mer information om Arbetsinsats i Workfront finns i Översikt över Arbetsinsats.

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