Adobe Workfront Planning moduler

Med modulerna Adobe Workfront Planning kan du utlösa ett scenario när händelser inträffar i Workfront Planning. Du kan också skapa, läsa, uppdatera och ta bort poster eller utföra ett anpassat API-anrop till ditt Adobe Workfront Planning-konto.

Åtkomstkrav

Expandera om du vill visa åtkomstkrav för funktionerna i den här artikeln.
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Adobe Workfront package

Alla Adobe Workfront Workflow-paket och alla Adobe Workfront Automation and Integration-paket

Workfront Ultimate

Workfront Prime- och Select-paket med ytterligare köp av Workfront Fusion.

Adobe Workfront-licenser

Standard

Arbeta eller högre

Produkt Om ni har ett Select- eller Prime Workfront-paket som inte innehåller Workfront Automation and Integration måste ni köpa Adobe Workfront Fusion.

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

s## Förutsättningar

Du måste ha följande för att få tillgång till Workfront Planning:

  • Ett nytt Workfront-paket och en ny licens. Workfront Planning är inte tillgängligt för tidigare Workfront-paket eller licenser.
  • Ett Workfront Planning-paket.
  • Din organisations instans av Workfront måste integreras med Adobe Unified Experience.

Information om Adobe Workfront Planning API

Adobe Workfront Planning Connector använder följande:

Bas-URL
https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/
API-tagg
v1.13.7

Anslut Workfront Planning till Workfront Fusion

Workfront Planning Connector använder OAuth 2.0 för att ansluta till Workfront Planning.

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

Anslut till Workfront Planning med klient-ID och klienthemlighet

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

  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 layout-auto html-authored no-header
    Connection type Välj Adobe Workfront-autentiseringsanslutning.
    Connection name Ange ett namn för den nya anslutningen.
    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 Planning 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.

Anslut till Workfront Planning via en Server-till-Server-anslutning

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

  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 7-row-2 layout-auto html-authored no-header
    Connection type Välj Adobe Workfront Server-till-server-anslutning.
    Connection name Ange ett namn för den nya anslutningen.
    Instance name

    Ange namnet på din instans, även kallat din domän.

    Exempel: Om din URL är https://example.my.workfront.com anger du example.

    Instance lane

    Ange den miljötyp som anslutningen ska ansluta till.

    Exempel: Om din URL är https://example.my.workfront.com anger du my.

    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.
    Scopes Ange eventuella omfattningar för den här anslutningen.
    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 Planning 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.

Adobe Workfront Planning-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

Utlösare

Se händelser

Den här utlösarmodulen startar ett scenario när en post, posttyp eller arbetsyta skapas, uppdateras eller tas bort i Workfront Planning.

Webhook
Välj den webkrok som du vill använda eller klicka på Lägg till för att skapa en ny.
Connection
Instruktioner om hur du skapar en anslutning till Adobe Workfront Planning finns i Skapa en anslutning till Adobe Workfront Planning i den här artikeln.
Object type
Välj om du vill bevaka poster, posttyper eller arbetsytor.
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.

  • Old state

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

Workspace
Om du tittar på inspelningar väljer du den Workspace du vill titta efter.
Record type
Om du tittar på poster väljer du vilken typ av post du vill bevaka.
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-webbplatser. 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 Workfront modulartikel.

Objects to watch
Välj om du vill hålla utkik efter nya. uppdaterade, nya och uppdaterade eller borttagna poster.
Exclude updates made by this connection
Aktivera det här alternativet om du vill förhindra att scenariot aktiveras när en ändring görs av anslutningen som används av modulen. Detta förhindrar att en annan instans av scenariot utlöses om det här scenariot utför en utlösande åtgärd.

Åtgärder

Ta bort en posttyp

Den här åtgärdsmodulen tar bort en enskild posttyp i Workfront Planning med dess ID.

WARNING
Om du tar bort en posttyp i Workfront Planning tas även alla poster i posttyptabellen bort.
Connection
Instruktioner om hur du skapar en anslutning till Adobe Workfront Planning finns i Skapa en anslutning till Adobe Workfront Planning i den här artikeln.
Record type ID
Ange eller mappa ID:t för den posttyp som du vill ta bort.

Göra ett anpassat API-anrop

Den här modulen gör ett anpassat API-anrop till API:t Adobe Workfront Planning.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Workfront Planning finns i Skapa en anslutning till Adobe Workfront Planning i den här artikeln.
URL
Ange en sökväg i förhållande till https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
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.
Headers

Lägg till rubrikerna för begäran i form av ett standard-JSON-objekt.

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

Workfront Fusion lägger automatiskt till auktoriseringsrubriker.

Query String
För varje nyckel/värde-par som du vill lägga till i frågesträngen klickar du på Lägg till objekt och anger nyckel och värde.
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.

Sökningar

Sök poster

Den här åtgärdsmodulen hämtar en lista med poster baserat på villkor som du anger.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Workfront Planning finns i Skapa en anslutning till Adobe Workfront Planning i den här artikeln.
Workspace
Ange eller mappa den Workspace som innehåller de poster som du vill söka efter.
Record type
Välj den posttyp som du vill söka efter.
Record Fields
Leta reda på fältet, markera operatorn och ange eller mappa värdet som du vill söka efter för varje fält som du vill använda i sökningen. Fältet är tillgängligt baserat på vald posttyp.
Condition for filters

Välj villkor för dina filter:

  • OCH

    Modulen returnerar poster som uppfyller alla av de fältvärden som du markerade.

  • ELLER

    Modulen returnerar poster som uppfyller något av de fältvärden som du har valt.

Limit
Ange eller mappa det maximala antal poster som du vill att modulen ska returnera under varje körningscykel för scenario.

Okategoriserad

Skapa en post

Den här åtgärden skapar en enda post i Workfront Planning.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Workfront Planning finns i Skapa en anslutning till Adobe Workfront Planning i den här artikeln.
Record type ID
Ange eller mappa den typ av post som du vill skapa. Tillgängliga posttyper baseras på ditt Workfront Planning-konto.
Andra fält
Ange de värden som du vill att den nya posten ska ha. Dessa fält baseras på den posttyp som du har valt.

Ta bort en post

Den här åtgärdsmodulen tar bort den angivna posten i Workfront Planning.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Workfront Planning finns i Skapa en anslutning till Adobe Workfront Planning i den här artikeln.
Record ID
Ange eller mappa ID:t för den post som du vill ta bort.

Hämta en post

Den här åtgärdsmodulen hämtar en enskild post från Adobe Workfront Planning, som anges av dess ID.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Workfront Planning finns i Skapa en anslutning till Adobe Workfront Planning i den här artikeln.
Record ID
Ange eller mappa ID:t för den post som du vill hämta.

Hämta poster efter posttyp

Den här åtgärdsmodulen hämtar alla poster av den angivna typen.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Workfront Planning finns i Skapa en anslutning till Adobe Workfront Planning i den här artikeln.
Workspace
Markera eller mappa arbetsytan som innehåller de poster som du vill hämta.
Record type
Välj den typ av post som du vill hämta.

Hämta posttyper

Den här åtgärdsmodulen hämtar en lista med posttyper i ett Adobe Workfront Planning-konto.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Workfront Planning finns i Skapa en anslutning till Adobe Workfront Planning i den här artikeln.
Workspace
Markera eller mappa arbetsytan som innehåller de posttyper som du vill hämta.

Uppdatera post

Den här åtgärden uppdaterar en enda post i Workfront Planning.

Connection
Instruktioner om hur du skapar en anslutning till Adobe Workfront Planning finns i Skapa en anslutning till Adobe Workfront Planning i den här artikeln.
Record ID
Ange eller mappa den typ av post som du vill uppdatera. Tillgängliga posttyper baseras på ditt Workfront Planning-konto.
Andra fält
Ange de nya värden som du vill att posten ska ha. Dessa fält baseras på den posttyp som du har valt.

Använd JSONata för läsbar record-types-nedbrytning

I följande JSONata-uttryck skapas ett läsbart resultat av planeringsfrågan som ger dig uppdelningen av posttyper. Detta gör att posttypens namn, fältnamn och fältalternativens namn (där det är tillämpligt) kan läsas av ett namn och behåller resten av strukturen intakt.

(
    $s0 := ({"data":$ ~> | fields | {"options":(options){name:$}} |});
    $s1 := ({"data":$s0.data ~> | **.fields | {"options_name":(options.*){displayName:$}} | });
    $s2 := $s1 ~> | data | {"fields":(fields){displayName:$}} |;
    $s2.data{displayName:$}
)

Mer information om hur du använder JSONata-moduler finns i JSONata-moduler.

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