DokumentationWorkfrontAnvändarhandbok om Workfront

Adobe Workfront moduler

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

Skapat för:

  • Användare

Du kan använda Adobe Workfront Fusion Adobe Workfront-anslutningen för att automatisera dina processer i Workfront. Om du har en Workfront Fusion for Work Automation and Integration-licens kan du även använda den för att ansluta till appar och tjänster från tredje part.

Workfront-kopplingen räknar inte med antalet aktiva appar som är tillgängliga för din organisation. Alla scenarier, även om de bara använder appen Workfront, räknas mot din organisations totala antal scenarier.

Mer information om organisationens tillgängliga appar och scenarier finns i Organisationer i Adobe Workfront Fusion organisationer och team.

Om du behöver instruktioner om hur du skapar ett scenario kan du läsa Skapa ett scenario i Adobe Workfront Fusion. Mer information om moduler finns i Moduler i Adobe Workfront Fusion.

Åtkomstkrav

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

Adobe Workfront plan*
Pro eller högre
Adobe Workfront licens*
Plan, Work
Adobe Workfront Fusion licens**

Aktuellt licenskrav: Inget Workfront Fusion-licenskrav.

eller

Gammalt licenskrav: Workfront Fusion för Automatisering och integrering av arbetet, Workfront Fusion för Automatisering av arbete

Produkt

Aktuellt produktkrav: Om du har planen Select eller Prime Adobe Workfront måste din organisation köpa både Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln. Workfront Fusion ingår i planen Ultimate Workfront.

eller

Äldre produktkrav: Din organisation måste köpa Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln.

Kontakta Workfront-administratören om du vill ta reda på vilken plan, licenstyp eller åtkomst du har.

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

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 klient-ID för Workfront. 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 ditt klient-ID för Workfront. Detta finns under OAuth2-program under Konfigurera i Workfront. Öppna det program du ansluter till för att se klient-ID:t.
    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.

NOTE

  • Om du inte ser någon inloggningsknapp för SAML har din organisation inte aktiverat enkel inloggning (SSO). Du kan logga in med ditt användarnamn och lösenord.

    Mer information om enkel inloggning finns i Översikt över enkel inloggning Adobe Workfront

  • OAuth 2.0-anslutningar till API:t Workfront är inte längre beroende av API-nycklar.

Workfront-moduler och deras fält

När du konfigurerar Workfront moduler visar Workfront Fusion fälten som listas nedan. 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 i Adobe Workfront Fusion.

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.

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.

    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
    Webhook name (Valfritt) Ange ett nytt 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 Välj 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! Det går inte att 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! Posttypen för tilldelning 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 Workfront hjälpartikeln API för händelseprenumeration.

Visa 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 fält som 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 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 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 fälten som administratören för Workfront har ställt in för spårning.
Outputs Välj den information som du vill inkludera 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.

Visa 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 lades till och uppdaterades under den angivna tidsperioden 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 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

(Visas när du har valt ett filter.) Välj 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 Välj den information som du vill inkludera 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.

Visa 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
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)

Den här åtgärdsmodulen skapar ett objekt, till exempel ett projekt, en uppgift eller ett problem i Workfront, och gör att du kan lägga till ett anpassat formulär till 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.

Du kan till exempel använda den här modulen för att skapa en aktivitet i Workfront när en klient lägger till en ny rad i en Google Sheets-lista med uppgifter som behöver utföras.

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

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.

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 och kontrollerar sedan att du har tillgång till data (från tidigare moduler i scenariot) som fyller i projektet.
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.

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 sedan värden för fälten.

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

    Mer information om RTF i uppdateringar finns i Lägga till en uppdatering av ett arbetsobjekt i Uppdatera arbete.
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.

Du kan till exempel använda den här modulen för att skapa en aktivitet i Workfront när en klient lägger till en ny rad i en lista med Google-blad med uppgifter som behöver utföras.

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

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.

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 och kontrollerar sedan att du har tillgång till data (från tidigare moduler i scenariot) som fyller i projektet.
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.

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

    Mer information om RTF i uppdateringar finns i Lägga till en uppdatering av ett arbetsobjekt i Uppdatera arbete.
Custom API Call

Med den här åtgärdsmodulen kan du göra ett anpassat autentiserat anrop till API:t Workfront. På så sätt kan du skapa en dataflödesautomatisering som inte kan utföras av de andra Workfront-modulerna.

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

Visa 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 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 för att se till att posten tas bort, även om användargränssnittet för Workfront begär att borttagningen ska bekräftas.
ID

Ange det unika Workfront-ID:t för posten som du vill att modulen ska ta bort.

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

Visa 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 objektet Workfront i webbläsaren och kopierar texten i slutet av URL:en efter "ID=". Exempel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

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

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

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 via modulen Workfront Misc Action är det bästa sättet att skapa ett korrektur utan avancerade alternativ och sedan uppdatera korrekturet med Workfront Proof SOAP API:t.

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

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

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

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

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 standardfälten för de utdata du angav.

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 posten som du vill att modulen ska läsa.

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

Visa 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 posten som du vill att modulen ska uppdatera.

Om du vill hämta ID:t öppnar du objektet Workfront i webbläsaren och kopierar texten i slutet av URL:en efter "ID=". Exempel: https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
Record Type Välj 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.

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

    Mer information om RTF i uppdateringar finns i Lägga till en uppdatering av ett arbetsobjekt i Uppdatera arbete.
Upload Document

Den här åtgärdsmodulen överför ett dokument till ett Workfront-objekt, till exempel ett projekt, en uppgift eller ett problem.

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 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:t 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.
Source file Välj en källfil från en tidigare modul eller mappa källfilens namn och data.

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

Visa 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 moduli 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 objektet Workfront 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.
accordion
Search (Legacy)

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

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.

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

Workfront objekttyper 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 objekttyperna Workfront 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 modulerna Workfront > Watch Events

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

Modulen Workfront Watch Events utlöser scenarier baserat på en webkrok som skapar en händelseprenumeration i API:t Workfront. 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 API:t Workfront 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 att konfigurera ett filter i scenariot Workfront Fusion. 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
Det går inte att 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.
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.
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.
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 händelseprenumerationer finns i Vanliga frågor och svar - Händelseprenumerationer.

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

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

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