DokumentationWorkfrontAdobe Workfront Fusion

Adobe Workfront moduler

Last update: Thu Jan 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Du kan använda Adobe Workfront Fusion Adobe Workfront-kontakten för att automatisera processerna i Workfront. Du kan även ansluta Workfront till andra program och tjänster.

Instruktioner om hur du skapar ett scenario finns i artiklarna under Skapa scenarier: artikelindex. Mer information om moduler finns i artiklarna under Moduler: artikelindex.

Åtkomstkrav

Expandera om du vill visa åtkomstkrav för funktionerna i den här artikeln.

Du måste ha följande åtkomst för att kunna använda funktionerna i den här artikeln:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront package Alla
Adobe Workfront-licens

Nytt: Standard

eller

Aktuell: Arbete eller högre
Adobe Workfront Fusion-licens**

Aktuell: Inga Workfront Fusion-licenser krävs.

eller

Äldre: Alla
Produkt

Nytt:

  • Select or Prime Workfront package: Your organization must purchase Adobe Workfront Fusion.
  • Ultimate Workfront-paket: Workfront Fusion ingår.

eller

Aktuell: Din organisation måste köpa Adobe Workfront Fusion.

Mer information om informationen i den här tabellen finns i Åtkomstkrav i dokumentationen.

Mer information om Adobe Workfront Fusion licenser finns i Adobe Workfront Fusion licenser.

note note
NOTE
  • Om din organisation använder det äldre licenspaketet (baserat på anslutningar) måste den ha en Workfront Fusion for Work Automation- och Integration-licens för att kunna ansluta till program och tjänster från tredje part. Workfront Connector räknar inte med antalet aktiva appar som är tillgängliga för din organisation. Alla scenarier, även om de bara använder Workfront-appen, räknas av mot organisationens totala antal scenarier.

Anslut Workfront till Workfront Fusion

Workfront-anslutningen använder OAuth 2.0 för att ansluta till Workfront.

Du kan skapa en anslutning till ditt Workfront-konto direkt inifrån en Workfront Fusion-modul.

  1. Klicka på Lägg till bredvid anslutningsfältet i en Adobe Workfront-modul.

  2. Fyll i följande fält:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    Connection name Ange ett namn för den nya anslutningen.
    Environment Välj om du ansluter till en produktionsmiljö eller icke-produktionsmiljö.
    Connection type Ange om du ansluter till ett tjänstkonto eller ett personligt konto.
    Client ID Ange ditt Workfront klient-ID. Detta finns under OAuth2-program under Konfigurera i Workfront. Öppna det program du ansluter till för att se klient-ID:t.
    Client Secret Ange din Workfront-klienthemlighet. Detta finns under OAuth2-program under Konfigurera i Workfront. Om du inte har någon klienthemlighet för OAuth2-programmet i Workfront kan du generera en annan. Instruktioner finns i dokumentationen för Workfront.
    Authentication URL

    Detta kan vara standardvärdet eller så kan du ange URL:en för din Workfront-instans följt av /integrations/oauth2.

    Exempel: https://mydomain.my.workfront.com/integrations/oauth2
    Host prefix I de flesta fall bör det här värdet vara origin.

  3. Klicka på Continue för att spara anslutningen och återgå till modulen.

    Om du inte är inloggad på Workfront dirigeras du till en inloggningsskärm. När du har loggat in kan du tillåta anslutningen.

NOTE
  • OAuth 2.0-anslutningar till Workfront API är inte längre beroende av API-nycklar.
  • Om du vill skapa en anslutning till en Workfront Sandbox-miljö måste du skapa ett OAuth2-program i den miljön och sedan använda det klient-ID och klienthemlighet som genereras av det programmet i anslutningen.

Workfront-moduler och deras fält

När du konfigurerar Workfront-moduler visas fälten som listas nedan i Workfront Fusion. Dessutom kan ytterligare Workfront-fält visas, beroende på faktorer som din åtkomstnivå i appen eller tjänsten. En rubrik med fet stil i en modul visar ett obligatoriskt fält.

Om du ser kartknappen ovanför ett fält eller en funktion kan du använda den för att ange variabler och funktioner för det fältet. Mer information finns i Mappa information från en modul till en annan.

Växla karta

NOTE
  • Om du inte ser de mest aktuella fälten i en Workfront-modul kan det bero på problem med cachelagring. Vänta en timme och försök igen.
  • HTTP 429-statuskoder från Adobe Workfront bör inte orsaka inaktiveringar, utan i stället utlösa en kort körningspaus i scenariot.

Utlösare

Watch Events

Denna utlösarmodul kör ett scenario i realtid när objekt av en viss typ läggs till, uppdateras eller tas bort i Workfront

Modulen returnerar alla standardfält som är associerade med posten, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

  1. Klicka på Add till höger om rutan Webkrok.

  2. Konfigurera webkroken i rutan Add a hook som visas.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    Webhook name Ange ett namn för webkroken
    Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
    Record Type Markera den typ av Workfront-post som du vill att modulen ska bevaka.
    State

    Välj om du vill titta på det gamla eller nya läget.

    • New state

      Utlös ett scenario när posten ändras till för ett givet värde.

      Om läget till exempel är inställt på New State och filtret är inställt på Status Equals In Progress utlöser webkroken ett scenario när Status ändras till In Progress, oavsett vilken status som var tidigare.

    • Old state

      Utlös ett scenario när posten ändrar från ett givet värde.

      Om läget till exempel är inställt på Old State och filtret är inställt på Status Equals In Progress utlöser webkroken ett scenario när en Status som för närvarande är In Progress ändras till en annan status.
    Events filters

    Du kan ställa in filter så att endast poster som uppfyller de villkor du väljer bevakas.

    För varje filter anger du fältet som du vill att filtret ska utvärderas, operatorn och värdet som du vill att filtret ska tillåta. Du kan använda mer än ett filter genom att lägga till OCH-regler.

    Obs! Du kan inte redigera filter i befintliga Workfront-webbböcker. Om du vill ställa in olika filter för Workfront-händelseprenumerationer tar du bort den aktuella webbkroken och skapar en ny.

    Mer information om händelsefilter finns i Evenemangsprenumerationsfilter i Workfront > Watch Events moduler i den här artikeln.
    Uteslut händelser som har gjorts i den här anslutningen

    Aktivera det här alternativet om du vill exkludera händelser som har skapats eller uppdaterats med samma koppling som den här utlösarmodulen använder. Detta kan förhindra situationer där ett scenario kan utlösa sig självt och få det att upprepas i en oändlig slinga.

    Obs! Tilldelningsposttypen innehåller inte det här alternativet.
    Record Origin

    Välj om du vill att scenariot ska bevaka New Records Only, Updated Records Only, New and Updated Records eller Deleted Records Only.

    Obs! Om du väljer New and Updated Records skapar webkroken 2 händelseprenumerationer (för samma webkrok-adress).

När webbkroken har skapats kan du visa adressen till slutpunkten som händelser skickas till.

Mer information finns i avsnittet Exempel på händelsenyttolaster i artikeln Event Subscription API (Händelseprenumerations-API) i Workfront-dokumentationen.

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

Watch Field

Den här utlösarmodulen kör ett scenario när ett fält som du anger uppdateras. Modulen returnerar både det gamla och det nya värdet för det angivna fältet. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Record Type

Markera den typ av Workfront-post som du vill att modulen ska bevaka.

Välj till exempel Task om du vill börja köra scenariot varje gång ett postfält uppdateras i en uppgift.
Field Markera det fält som du vill att modulen ska bevaka för uppdateringar. Dessa fält återspeglar de fält som din Workfront-administratör har ställt in för spårning.
Outputs Markera de objektfält som du vill ska ingå i utdatapaketet för den här modulen.
Limit Ange eller mappa det maximala antal poster som du vill att modulen ska returnera under varje körningscykel för scenario.

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

Watch Record

Den här utlösarmodulen kör ett scenario när objekt av en viss typ läggs till, uppdateras eller både och. Modulen returnerar alla standardfält som är associerade med posten eller posterna, tillsammans med anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

I utdata anger modulen om varje post är ny eller uppdaterad.

Poster som både lagts till och uppdaterats sedan det senaste scenariot kördes returneras som nya poster.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Filter Välj om du vill att scenariot ska bevaka New Records Only, Updated Records Only eller New and Updated Records.
Record Type

Markera den typ av Workfront-post som du vill att modulen ska bevaka.

Om du till exempel vill starta scenariot varje gång ett nytt projekt skapas, väljer du Project
Outputs Markera de fält som du vill inkludera i utdatapaketet för den här modulen.
Reference Markera de referensfält som du vill ska ingå i utdatapaketet för den här modulen.
Outputs Markera de samlingsfält som du vill ska ingå i utdatapaketet för den här modulen.
Optional Filter (Avancerat) Ange en API-kodsträng för att definiera eventuella ytterligare parametrar eller kod som förfinar villkoren.
Limit Ange eller mappa det maximala antal poster som du vill att modulen ska returnera under varje körningscykel för scenario.

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

Åtgärder

Convert object

Den här åtgärdsmodulen gör någon av följande konverteringar:

  • Konvertera problem till projekt
  • Konvertera problem till aktivitet
  • Konvertera aktivitet till projekt
note note
NOTE
Från och med juli 2024 kan anpassade formulär inkluderas när ett objekt konverteras.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Object type Markera den typ av objekt som du vill konvertera. Detta är den typ som objektet har före konverteringen.
Convert to Markera det objekt som du vill konvertera det till. Detta är den typ som objektet har efter konverteringen.
<Object> ID

Ange objektets ID.

Obs! När du anger ID:t för ett objekt kan du börja skriva namnet på objektet och sedan markera det i listan. Modulen anger sedan rätt ID i fältet.
Template ID

Om du konverterar till ett projekt väljer du det mall-ID som du vill använda för projektet.

Obs! När du anger ID:t för ett objekt kan du börja skriva namnet på objektet och sedan markera det i listan. Modulen anger sedan rätt ID i fältet.
Custom forms Markera de anpassade formulär som du vill lägga till i det nyligen konverterade objektet och ange värden för fälten i det anpassade formuläret.
Options Aktivera de alternativ du vill ha när du konverterar objektet. Alternativen är tillgängliga beroende på vilket objekt du konverterar till eller från.
Copy native fields Aktivera det här alternativet om du vill kopiera inbyggda fält från det ursprungliga objektet till det nya objektet.
Copy custom forms Aktivera det här alternativet om du vill kopiera inbyggda fält från det ursprungliga objektet till det nya objektet.
Create a record (attaching custom forms)

I den här åtgärdsmodulen skapas ett objekt, t.ex. ett projekt, en uppgift eller ett problem i Workfront, och du kan lägga till ett anpassat formulär i det nya objektet. I modulen kan du välja vilka av objektets fält som är tillgängliga i modulen.

Du anger postens ID.

Modulen returnerar postens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

Se till att du anger det minsta antalet inmatningsfält. Om du till exempel vill skapa ett problem måste du ange ett giltigt överordnat projekt-ID i fältet Projekt-ID för att ange var problemet ska finnas i Workfront. Du kan använda mappningspanelen för att mappa den här informationen från en annan modul i ditt scenario, eller ange den manuellt genom att skriva in namnet och sedan välja den i listan.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Record Type

Välj den typ av Workfront-post som du vill att modulen ska skapa.

Om du till exempel vill skapa ett projekt väljer du Project i listrutan.
Select fields to map

Markera de fält som du vill ska vara tillgängliga för datainmatning. På så sätt kan du använda de här fälten utan att behöva bläddra igenom de fält du inte behöver. Du kan sedan ange eller mappa data till dessa fält.

Använd fältet Attach Custom Form för fält i anpassade formulär.
Attach Custom Form Markera de anpassade formulär som du vill lägga till i det nya objektet och ange eller mappa värden för fälten.

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

note note
NOTE
  • När du anger ID:t för ett objekt kan du börja skriva namnet på objektet och sedan markera det i listan. Modulen anger sedan rätt ID i fältet.
  • När du anger text för ett anpassat fält eller ett Note-objekt (kommentar eller svar) kan du använda HTML-taggar i fältet Note Text för att skapa RTF, till exempel fet eller kursiv text.
Create Record

Den här åtgärdsmodulen skapar ett objekt, till exempel ett projekt, en uppgift eller ett problem i Workfront. I modulen kan du välja vilka av objektets fält som är tillgängliga i modulen.

Du anger postens ID.

Modulen returnerar postens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

Se till att du anger det minsta antalet inmatningsfält. Om du till exempel vill skapa ett problem måste du ange ett giltigt överordnat projekt-ID i fältet Projekt-ID för att ange var problemet ska finnas i Workfront. Du kan använda mappningspanelen för att mappa den här informationen från en annan modul i ditt scenario, eller ange den manuellt genom att skriva in namnet och sedan välja den i listan.

Den här modulen kopplar inte anpassade formulär när objektet skapas. Använd modulen Create a record (attaching custom forms) om du vill bifoga anpassade formulär när du skapar ett objekt.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Record Type

Välj den typ av Workfront-post som du vill att modulen ska skapa.

Om du till exempel vill skapa ett projekt väljer du Project i listrutan.
Select fields to map Markera de fält som du vill ska vara tillgängliga för datainmatning. På så sätt kan du använda de här fälten utan att behöva bläddra igenom de fält du inte behöver.

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

note note
NOTE
  • När du anger ID:t för ett objekt kan du börja skriva namnet på objektet och sedan markera det i listan. Modulen anger sedan rätt ID i fältet.
  • När du anger text för ett anpassat fält eller ett Note-objekt (kommentar eller svar) kan du använda HTML-taggar i fältet Note Text för att skapa RTF, till exempel fet eller kursiv text.
Custom API Call

Med den här åtgärdsmodulen kan du göra ett anpassat autentiserat anrop till Workfront API. På så sätt kan du skapa en dataflödesautomatisering som inte kan uppnås med andra Workfront-moduler.

Modulen returnerar följande information:

  • Status Code (tal): Detta anger om HTTP-begäran lyckades eller misslyckades. Det här är standardkoder som du kan söka efter på Internet.

  • Headers (objekt): En mer detaljerad kontext för svars-/statuskoden som inte relaterar till utdatatexten. Alla sidhuvuden som visas i en svarshuvud är inte svarshuvuden, så en del kanske inte är användbara för dig.

    Svarshuvuden beror på den HTTP-begäran du valde när du konfigurerade modulen.

  • Body (objekt): Beroende på den HTTP-begäran du valde när du konfigurerade modulen kan du få tillbaka data. Dessa data, till exempel data från en GET-begäran, finns i det här objektet.

Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
URL Ange en relativ sökväg till https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/.
API Version Välj den version av Workfront API som du vill att modulen ska använda.
Method Välj den HTTP-förfrågningsmetod som du behöver för att konfigurera API-anropet. Mer information finns i Metoder för HTTP-begäran i Adobe Workfront Fusion.
Headers

Lägg till rubrikerna för begäran i form av ett standard-JSON-objekt. Detta avgör begärans innehållstyp.

Exempel: {"Content-type":"application/json"}

Obs! Om du får felmeddelanden och det är svårt att fastställa deras ursprung bör du överväga att ändra rubrikerna baserat på Workfront-dokumentationen. Om ditt anpassade API-anrop returnerar ett 422 HTTP-begärandefel kan du försöka med att använda en "Content-Type":"text/plain"-rubrik.
Query String

Lägg till frågan för API-anropet i form av ett standard-JSON-objekt.

Exempel: {"name":"something-urgent"}

Tips! Vi rekommenderar att du skickar information via JSON-brödtexten i stället för som frågeparametrar.
Body

Lägg till brödinnehållet för API-anropet i form av ett standard-JSON-objekt.

Obs!

När du använder villkorssatser som if i JSON placerar du citattecknen utanför villkorssatsen.

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

Delete Record

Den här åtgärdsmodulen tar bort ett objekt, till exempel ett projekt, en uppgift eller ett problem i Workfront.

Du anger postens ID.

Modulen returnerar postens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Force delete Aktivera det här alternativet om du vill vara säker på att posten tas bort, även om användargränssnittet i Workfront begär att du bekräftar borttagningen.
Async delete Aktivera det här alternativet om du vill tillåta att modulen tas bort asynkront.
ID

Ange det unika Workfront-ID:t för den post som du vill ta bort modulen.

Om du vill hämta ID:t öppnar du Workfront-objektet i webbläsaren och kopierar texten i slutet av URL:en efter "ID=.". Exempel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
Record Type Markera den typ av Workfront-post som du vill ta bort modulen.

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

note note
NOTE
Vi rekommenderar följande scenariokonfiguration för att undvika möjligheten att poster inte tas bort på grund av asynkrona åtgärder.
  1. Ta bort posten synkront.
  2. Lägg till felhantering i modulen Ta bort post för att ignorera felet som orsakas av timeout på 40 sekunder.
Download Document

Denna åtgärdsmodul hämtar ett dokument från Workfront.

Du anger postens ID.

Modulen returnerar dokumentets innehåll, filnamn, filtillägg och filstorlek. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Document ID

Mappa eller ange det unika Workfront-id:t för dokumentet som du vill att modulen ska hämta.

Om du vill hämta ID:t öppnar du Workfront-objektet i webbläsaren och kopierar texten i slutet av URL:en efter "ID=.". Exempel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

Misc Action

Med den här åtgärdsmodulen kan du utföra åtgärder mot API:t.

note note
NOTE
Från och med juli 2024 innehåller åtgärden convertToProject fältet copyCategories. När värdet är TRUE inkluderas alla anpassade formulär i projektet som utgåvan konverteras till.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Record Type Välj den typ av Workfront-post som du vill att modulen ska interagera med.
Action

Välj den åtgärd som du vill att modulen ska utföra.

Du kan behöva fylla i ytterligare fält, beroende på vilken Record Type och Action du väljer. Vissa kombinationer av dessa två inställningar kan endast kräva ett post-ID, medan andra (till exempel Projekt för Record Type och Attach Template för Action) kräver ytterligare information (till exempel ett objekt-ID och ett mall-ID).

Tillgängliga alternativ för vissa åtgärder finns i Alternativ för andra åtgärder i den här artikeln.

Mer information om enskilda fält finns i dokumentationen för Workfront-utvecklare.

Obs! Utvecklarens dokumentationswebbplats innehåller endast information via API-version 14, men innehåller fortfarande värdefull information för API-anrop.

  1. Välj posttyp i den vänstra navigeringen på dokumentationssidan för Workfront-utvecklare. Följande typer har egna sidor:

    • Projects

    • Tasks

    • Issues

    • Users

    • Documents

    För alla andra posttyper väljer du Other objects and endpoints och letar upp posttypen på de alfabetiskt sorterade sidorna.

  2. På sidan med rätt posttyp söker du efter åtgärden (Ctrl-F eller Cmd-F).

  3. Visa beskrivningar för tillgängliga fält under den valda åtgärden.

Obs!

När du skapar ett korrektur med Workfront Misc Action-modulen är det bästa sättet att skapa ett korrektur utan några avancerade alternativ och sedan uppdatera korrekturet med Workfront Proof SOAP API:t.

Mer information om hur du skapar ett korrektur med Workfront API (som används i den här modulen) finns i Lägga till avancerade korrekturalternativ när du skapar ett korrektur via Adobe Workfront API
ID

Ange eller mappa det unika Workfront-ID:t för den post som du vill att modulen ska interagera med.

Om du vill hämta ID:t öppnar du Workfront-objektet i webbläsaren och kopierar texten i slutet av URL:en efter "ID=.". Exempel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

Alternativ för diverse åtgärder

Uppgift
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
Åtgärd Alternativ
Kopiera

  • clearApprovers

  • clearAssignments

  • clearConstraints

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Raderar ekonomiska data

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Rensar påminnelsemeddelanden
Flytta

  • clearApprovers

  • clearAssignments

  • clearDocuments

  • clearConstraints

  • clearExpenses

  • clearFinancials

    Raderar ekonomiska data

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Rensar påminnelsemeddelanden
Problem
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored
Åtgärd Alternativ
Kopiera
  • clearApprovers
  • clearAssignments
  • clearCustomData
  • clearDocuments
  • clearPermissions
  • clearProgress
Konvertera till uppgift

  • preserveIssue

    Behåll det ursprungliga problemet och knyt lösningen till den här uppgiften

  • preservePrimaryContact

    Tillåt åtkomst till den primära kontakten för den här aktiviteten

  • preserveCompletionDate

    Behåll det planerade slutförandedatumet för problemet
Konvertera till projekt

  • preserveIssue

    Behåll det ursprungliga problemet och knyt lösningen till den här uppgiften

  • preservePrimaryContact

    Tillåt åtkomst till den primära kontakten för den här aktiviteten
Projekt
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
Åtgärd Alternativ
Kopiera

  • clearApprovers

  • clearAssignments

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Raderar ekonomiska data

  • clearPermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    Rensar påminnelsemeddelanden
Bifoga mall/Spara som mall

  • clearApprovers

  • clearAssignments

  • clearBillingRates

  • clearConstraints

  • clearDeliverables

    Rensar mål

  • clearDocuments

  • clearExpenses

  • clearFinancials

    Raderar ekonomiska data

  • clearHourTypes

  • clearIssueSetup

    Rensar köegenskaper och inställningar för utleveranser

  • clearPredecessors

  • clearRisks

  • clearSharingOptions

  • clearTimedNotifications

    Rensar påminnelsemeddelanden
Read a Record

Den här åtgärdsmodulen hämtar data från en enda post.

Du anger postens ID. Du kan också ange vilka relaterade poster som du vill att modulen ska läsa.

Om posten som modulen läser till exempel är ett projekt kan du ange att du vill att projektets uppgifter ska läsas.

Modulen returnerar en array med data från de utdatafält som du har angett.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Record Type Välj den Workfront-objekttyp som du vill att modulen ska läsa.
Outputs Välj den information som du vill inkludera i utdatapaketet för den här modulen.
References Markera de referensfält som du vill ta med i utdata.
Collections Markera de referensfält som du vill ta med i utdata.
ID

Ange det unika Workfront-ID:t för den post som du vill att modulen ska läsa.

Om du vill hämta ID:t öppnar du Workfront-objektet i webbläsaren och kopierar texten i slutet av URL:en efter "ID=.". Exempel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

Update Record

Den här åtgärdsmodulen uppdaterar ett objekt, t.ex. ett projekt, en uppgift eller ett problem. I modulen kan du välja vilka av objektets fält som är tillgängliga i modulen.

Du anger postens ID.

Modulen returnerar objektets ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
ID

Ange det unika Workfront-ID:t för den post som du vill att modulen ska uppdatera.

Om du vill hämta ID:t öppnar du Workfront-objektet i webbläsaren och kopierar texten i slutet av URL:en efter "ID=.". Exempel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
Record Type Markera den typ av Workfront-post som du vill att modulen ska uppdatera.
Select fields to map Markera de fält som du vill ska vara tillgängliga för datainmatning. På så sätt kan du använda de här fälten utan att behöva bläddra igenom de fält du inte behöver. Du kan sedan ange eller mappa data till dessa fält.

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

note note
NOTE
  • När du anger ID:t för ett objekt kan du börja skriva namnet på objektet och sedan markera det i listan. Modulen anger sedan rätt ID i fältet.
  • När du anger text för ett anpassat fält eller ett Note-objekt (kommentar eller svar) kan du använda HTML-taggar i fältet Note Text för att skapa RTF, till exempel fet eller kursiv text.
Upload Document

Den här åtgärdsmodulen överför ett dokument till ett Workfront-objekt, t.ex. ett projekt, en uppgift eller ett problem. Den här modulen överför dokumentet i segment, vilket gör överföringsprocessen smidigare för Workfront.

Den här modulen kan hantera större filer än den äldre modulen och är en del av en fasad utrullning till organisationer med ett Ultimate Workfront-paket.

Du anger platsen för dokumentet, filen som du vill överföra och ett valfritt nytt namn för filen.

Modulen returnerar ID:t för dokumentet och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Related Record ID Ange det unika Workfront-id för den post som du vill överföra dokumentet till.
Related Record Type Välj den typ av Workfront-post där du vill att modulen ska överföra dokumentet.
Folder ID Beroende på vilken typ av relaterad post det är kan du behöva ange eller mappa ett mapp-ID.
Source file Välj en källfil från en tidigare modul eller mappa källfilens namn och data.

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

Upload Document (Legacy)

Den här åtgärdsmodulen överför ett dokument till ett Workfront-objekt, t.ex. ett projekt, en uppgift eller ett problem. Hela dokumentet överförs samtidigt.

Du anger platsen för dokumentet, filen som du vill överföra och ett valfritt nytt namn för filen.

Modulen returnerar ID:t för dokumentet och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Related Record ID Ange det unika Workfront-id för den post som du vill överföra dokumentet till.
Related Record Type Välj den typ av Workfront-post där du vill att modulen ska överföra dokumentet.
Folder ID Beroende på vilken typ av relaterad post det är kan du behöva ange eller mappa ett mapp-ID.
Source file Välj en källfil från en tidigare modul eller mappa källfilens namn och data.

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul.

Sökningar

Read Related Records

Den här sökmodulen läser poster som matchar den sökfråga du anger, i ett visst överordnat objekt.

Du anger vilka fält som ska inkluderas i utdata. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Record Type

Välj den typ av överordnad post (Workfront-objekt) vars associerade poster du vill läsa.

Se en lista över de Workfront-objekttyper som du kan använda den här modulen för i Workfront-objekttyper som är tillgängliga för varje Workfront-modul i den här artikeln.
Parent Record ID

Ange eller mappa ID:t för den överordnade post vars associerade poster du vill läsa.

Om du vill hämta ID:t öppnar du Workfront-objektet i webbläsaren och kopierar texten i slutet av URL:en efter "ID=.". Exempel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
Collections Markera eller mappa den typ av underordnad post som du vill att modulen ska läsa.
Outputs Välj den information som du vill inkludera i utdatapaketet för den här modulen.
Search

Den här sökmodulen söker efter poster i ett objekt i Workfront som matchar den sökfråga du anger.

Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 layout-auto html-authored no-header
Connection Instruktioner om hur du ansluter din Workfront-app till Workfront Fusion finns i Ansluta Workfront till Workfront Fusion i den här artikeln.
Record Type Välj den typ av Workfront-post som du vill att modulen ska söka efter.
Result Set Välj ett alternativ för att ange om du vill att modulen ska få det första resultatet som matchar dina sökvillkor eller alla resultat som matchar det.
Maximal Ange eller mappa det maximala antal poster som du vill att modulen ska returnera under varje körningscykel för scenario.
Search criteria fields Markera de fält som du vill använda som sökvillkor. Dessa fält är sedan tillgängliga i listrutan Sökvillkor.
Search criteria

Ange fältet som du vill söka efter, operatorn som du vill använda i frågan och värdet som du söker efter i fältet.

Obs! Använd inte username i sökvillkoren. Om username inkluderas i en API-fråga till Workfront loggas användaren in i Workfront och sökningen kommer inte att lyckas.

Obs! In och NotInfungerar med arrayer. Indata ska vara i matrisformat.
Outputs Markera de fält som du vill inkludera i utdata för den här modulen.
References Markera de referensfält som du vill ta med i sökningen.
Collections Markera de samlingar som du vill lägga till i sökningen.

Workfront objekttyper som är tillgängliga för varje Workfront-modul

Objekttyper tillgängliga för varje Workfront-utlösarmodul
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 32-row-4 33-row-4 34-row-4 35-row-4 36-row-4 37-row-4 38-row-4 39-row-4 40-row-4 41-row-4 layout-auto
Watch Record Watch Field Watch Events
Godkännandeprocess ✓
Tilldelning ✓ ✓
Baslinje ✓
Faktureringspost ✓
Faktureringstakt ✓
Företag ✓ ✓ ✓
Kontrollpanel ✓
Dokument ✓ ✓ ✓
Dokumentmapp ✓ ✓
Dokumentförfrågan ✓
Dokumentversion ✓ ✓
Utgift ✓ ✓ ✓
Utgiftstyp
Grupp ✓ ✓
Timme ✓ ✓
Timtyp ✓
Problem ✓ ✓ ✓
Upprepning ✓ ✓
Jobbroll ✓ ✓
Journalpost ✓
Milstolpe ✓
Sökväg för milstolpe ✓ ✓
Anteckning ✓ ✓ ✓
Anteckningstagg ✓
Portfolio ✓ ✓ ✓
Program ✓ ✓ ✓
Projekt ✓ ✓ ✓
Projektanvändare ✓
Bevis godkännande ✓
Reserverad tid* ✓
Rapport ✓
risk
Risktyp
Steggodkännare ✓
Uppgift ✓ ✓ ✓
Team ✓
Mall ✓ ✓ ✓
Malluppgift ✓ ✓
Tidrapport ✓ ✓ ✓
Användare ✓ ✓ ✓
Uppdatera
Objekttyper tillgängliga för varje Workfront-åtgärdsmodul
note note
NOTE
Modulen Download Document ingår inte i den här tabellen eftersom Workfront-objekttyper inte ingår i konfigurationen.
table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 6-row-8 7-row-8 8-row-8 9-row-8 10-row-8 11-row-8 12-row-8 13-row-8 14-row-8 15-row-8 16-row-8 17-row-8 18-row-8 19-row-8 20-row-8 21-row-8 22-row-8 23-row-8 24-row-8 25-row-8 26-row-8 27-row-8 28-row-8 29-row-8 30-row-8 31-row-8 32-row-8 33-row-8 34-row-8 35-row-8 36-row-8 37-row-8 38-row-8 39-row-8 layout-auto
Create a record Update a record Delete a record Upload Document Read a record Custom API Call Misc Action
Godkännandeprocess ✓ ✓ ✓ ✓ ✓ ✓ ✓
Tilldelning ✓ ✓ ✓ ✓ ✓ ✓
Baslinje ✓ ✓ ✓ ✓
Faktureringspost ✓ ✓ ✓ ✓
Faktureringstakt ✓ ✓ ✓ ✓ ✓
Företag ✓ ✓ ✓ ✓ ✓ ✓ ✓
Dokument ✓ ✓ ✓ ✓ ✓ ✓ ✓
Dokumentmapp ✓ ✓ ✓ ✓ ✓ ✓ ✓
Dokumentversion ✓ ✓ ✓ ✓ ✓ ✓
Växelkurs ✓ ✓ ✓ ✓
Utgift ✓ ✓ ✓ ✓ ✓ ✓ ✓
Utgiftstyp ✓ ✓ ✓ ✓
Externt dokument ✓
Grupp ✓ ✓ ✓ ✓ ✓ ✓ ✓
Timme ✓ ✓ ✓ ✓ ✓
Timtyp ✓ ✓ ✓ ✓
Problem ✓ ✓ ✓ ✓ ✓ ✓ ✓
Upprepning ✓ ✓ ✓ ✓ ✓
Jobbroll ✓ ✓ ✓ ✓ ✓
Journalpost ✓ ✓ ✓ ✓ ✓ ✓
Milstolpe ✓ ✓ ✓ ✓ ✓
Sökväg för milstolpe ✓ ✓ ✓ ✓ ✓
Anteckning ✓ ✓ ✓ ✓ ✓ ✓ ✓
Anteckningstagg ✓ ✓ ✓ ✓ ✓
Portfolio ✓ ✓ ✓ ✓ ✓ ✓ ✓
Program ✓ ✓ ✓ ✓ ✓ ✓ ✓
Projekt ✓ ✓ ✓ ✓ ✓ ✓ ✓
Projektanvändare ✓ ✓ ✓ ✓ ✓
Reserverad tid* ✓ ✓ ✓ ✓ ✓
risk ✓ ✓ ✓ ✓ ✓
Risktyp ✓ ✓ ✓ ✓
Steggodkännare ✓ ✓ ✓ ✓ ✓
Uppgift ✓ ✓ ✓ ✓ ✓ ✓ ✓
Team ✓ ✓ ✓ ✓
Mall ✓ ✓ ✓ ✓ ✓
Malluppgift ✓ ✓ ✓ ✓ ✓ ✓ ✓
Tidrapport ✓ ✓ ✓ ✓ ✓
Användare ✓ ✓ ✓ ✓ ✓ ✓ ✓
Uppdatera ✓
Objekttyper tillgängliga för varje Workfront-sökmodul
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 32-row-3 33-row-3 34-row-3 35-row-3 36-row-3 layout-auto
Search Read Related Records
Godkännandeprocess ✓ ✓
Tilldelning ✓ ✓
Faktureringspost ✓
Faktureringstakt ✓
Företag ✓ ✓
Dokument ✓ ✓
Dokumentmapp ✓ ✓
Dokumentversion ✓
Utgift ✓
Utgiftstyp ✓
Grupp ✓ ✓
Timme ✓
Timtyp ✓
Problem ✓ ✓
Upprepning ✓
Jobbroll ✓
Journalpost ✓
Milstolpe ✓
Sökväg för milstolpe ✓
Anteckning ✓
Anteckningstagg ✓
Portfolio ✓ ✓
Program ✓
Projekt ✓ ✓
Projektanvändare ✓
Reserverad tid* ✓
risk ✓
Risktyp ✓
Steggodkännare ✓
Uppgift ✓ ✓
Team ✓
Mall ✓
Malluppgift ✓
Tidrapport ✓ ✓
Användare ✓ ✓
Användardelegering ✓

Vi rekommenderar att du kontrollerar att det här fungerar som du tänkt dig.

Evenemangsprenumerationsfilter i Workfront > Watch Events moduler

NOTE
Vi rekommenderar att du använder händelseprenumerationsfilter i dina Watch Events-moduler.

Workfront Watch Events-modulen utlöser scenarier baserat på en webkrok som skapar en händelseprenumeration i Workfront API. Händelseprenumerationen är en uppsättning data som avgör vilka händelser som skickas till webbkroken. Om du t.ex. har konfigurerat en Watch Events-modul som bevakar problem, skickar händelseprenumerationen endast händelser som rör problem.

Genom att använda händelseprenumerationsfilter kan Fusion-användare skapa händelseprenumerationer som passar bättre för deras användningsfall. Du kan till exempel konfigurera en händelseprenumeration i Workfront API så att endast problem som finns i ett visst projekt skickas till webbhoven, vilket säkerställer att modulen Watch Events bara aktiveras för problem i det projektet. Möjligheten att skapa smalare utlösare förbättrar scenariodesignen genom att minska antalet irrelevanta utlösare.

Detta skiljer sig från hur du ställer in ett filter i Workfront Fusion-scenariot. Utan ett händelseprenumerationsfilter får din webkrok alla händelser som hör till den objekttyp du väljer. De flesta av dessa händelser skulle vara irrelevanta för scenariot och måste filtreras bort innan scenariot kan fortsätta.

Följande operatorer är tillgängliga i Workfront > filtret Bevakningshändelser:

  • Lika med

  • Inte lika med

  • Större än

  • Mindre än

  • Större än eller lika med

  • Mindre än eller lika med

  • Innehåller

  • Finns

    • Den här operatorn kräver inget värde och värdefältet saknas.

  • Finns inte

    • Den här operatorn kräver inget värde och värdefältet saknas.

  • Ändrad

    • Den här operatorn kräver inget värde och värdefältet saknas.
    • Den här operatorn ignorerar tillståndsfältet.
    • När du använder Changed väljer du Endast uppdaterade händelser i fältet Postursprung.
IMPORTANT
Du kan inte redigera filter i befintliga Workfront-webbplatser. Om du vill ställa in olika filter för Workfront-händelseprenumerationer tar du bort den aktuella webbkroken och skapar en ny.
INFO
Exempel: Överväg ett scenario som bearbetar nya problem som har tilldelats en viss användare, Ana.

Filtrera händelser med ett händelseprenumerationsfilter (rekommenderas) filtrera-h%C3%A4ndelser-med-ett-h%C3%A4ndelseprenumerationsfilter-(rekommenderas)

Med hjälp av händelsefiltret kan du ställa in webkroken för att utlösa scenariot när ett problem tilldelas Ana när problemet skapas. Ana har användar-ID b378489d8f7cd3cee0539260720a84b7.
Händelsefilter
Om 100 utgåvor skapas per dag, men bara två av dem tilldelas till Ana, körs scenariot två gånger.

Filtrera händelser i scenariot (rekommenderas inte) filtrera-h%C3%A4ndelser-i-scenariot-(rekommenderas-inte)

Om du vill filtrera händelser så att endast ärenden som tilldelats Ana behandlas, kan du skapa ett filter efter modulen Watch Events.
Utan händelsefilter
Om 100 utgåvor skapas per dag, men bara två av dem tilldelas till Ana, körs scenariot 100 gånger. 98 av körningarna stoppades vid filtret, men utlösarmodulen använder fortfarande data och utför åtgärder i alla körningar.

Mer information om Workfront-händelseprenumerationer finns i Vanliga frågor och svar - Händelseprenumerationer.

Mer information om webbhooks finns i Direktutlösare (webbhooks) i Adobe Workfront Fusion

Mer information om filter i scenarier finns i Lägga till ett filter i ett scenario.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3