Modulöversikt
Adobe Workfront Fusion skiljer ut fem typer av moduler:
- Åtgärdsmoduler
- Sökmoduler
- Utlösarmoduler
- Aggregatorer
- Iteratorer
Aggregatorer och iteratorer är för avancerade scenarier.
Åtgärdsmoduler
Åtgärdsmoduler är den vanligaste typen av modul. En typisk åtgärdsmodul utför en åtgärd och returnerar ett paket som sedan skickas vidare till nästa modul för bearbetning.
Till skillnad från utlösarmoduler kan åtgärdsmoduler placeras i början, mitten eller slutet av ett scenario.
Scenarier kan innehålla ett obegränsat antal åtgärdsmoduler, men ett stort antal moduler (150+) kan påverka prestandan.
Exempel:
- Workfront>Upload a file skickar en fil till Workfront och returnerar dess identifierare.
- Image>Resize tar emot en bild, ändrar storlek på den till angivna mått och överför den storleksändrade bilden till nästa åtgärd.
Åtgärdstypen har fyra undertyper:
- Skapa
- Läs
- Uppdatera
- Ta bort
Undertypen Uppdatera innehåller följande tre åtgärder:
-
Radera innehållet i ett fält. Den här åtgärden utförs när innehållet i fältet utvärderas till nyckelordet
erase
(ska inte blandas ihop medempty
). -
Ändra inte innehållet i ett fält. Den här åtgärden utförs när fältet lämnas tomt eller innehållet i fältet utvärderas till tomt (representeras med null i JSON).
-
Ersätt innehållet i ett fält. Denna operation äger rum i alla andra fall än de som beskrivs ovan.
-
Om du inte ser nyckelordet
erase
på mappningspanelen är modulen inte en uppdateringsmodul eller så har den inte uppdaterats till de senaste specifikationerna för appen. -
Empty
ändrar inte fältinnehållet. Om du behöver radera fältet kan du använda följande formel: -
Det går inte att låta ett fält vara oförändrat när dess innehåll utvärderas som tomt.
Sökmoduler
Sökmodulerna returnerar noll, ett eller flera paket, som sedan skickas vidare till nästa modul för bearbetning.
Du kan placera sökmoduler i början, mitten eller slutet av ett scenario.
Scenarier kan innehålla ett obegränsat antal sökmoduler, men ett stort antal moduler (150+) kan påverka prestandan.
Exempel:
Workfront>Read Related Records läser poster som matchar den sökfråga du anger, i ett visst överordnat objekt.
Utlösarmoduler
Utlösare genererar paket när en viss tjänst har ändrats, till exempel när en post skapas eller uppdateras.
Utlösare returnerar noll, ett eller flera paket, som sedan skickas till nästa modul för bearbetning.
Eftersom utlösare gör att scenarier börjar köras, kan de bara placeras i början av ett scenario.
Varje scenario kan bara innehålla en utlösare.
Workfront Fusion använder två typer av utlösare: avsökningsutlösare och direktutlösare.
Avsökningsutlösare
Avsökningsutlösare avsöker regelbundet en viss tjänst även om det inte har skett någon förändring sedan föregående scenario kördes. Vi rekommenderar att du schemalägger ett scenario som innehåller en avsökningsutlösare som körs med regelbundna intervall. Om det finns en ändring som matchar utlösarens konfiguration returnerar utlösaren paket som innehåller information om ändringen. Om det inte finns någon ändring som matchar konfigurationen kommer utlösaren inte att generera några paket.
Instruktioner om hur du schemalägger ett scenario finns i Schemalägg ett scenario.
Med avsökningsutlösare kan du välja det första paket som de ska skicka via en panel som visas automatiskt när du har sparat en utlösare eller ändrat utlösarinställningarna. Det här valet påverkar bara den första körningen av modulen. När modulen har körts en gång bevakar efterföljande körningar endast ändringar som inträffar efter den senaste körningen.
Mer information finns i Välja var en utlösarmodul ska starta.
Exempel:
-
Workfront>Watch records returnerar poster som nyligen har lagts till efter den senaste körningen av scenariot.
-
Google Sheets>Watch Rows returnerar nya rader som lagts till efter den senaste gången scenariot kördes.
Direktutlösare
Direktutlösare gör att en tjänst kan meddela Workfront Fusion om en ändring omedelbart efter att den har utförts. Vi rekommenderar att du schemalägger ett scenario som innehåller en direktutlösare som körs omedelbart.
Instruktioner finns i Schemalägg ett scenario.
Mer information om hur inkommande data hanteras av en direktutlösare finns i Direktutlösare (webhooks).
Exempel:
- Workfront>Watch Events returnerar information när en viss typ av händelse inträffar i Workfront, till exempel när en uppgift skapas.
- Google Sheets>Watch Changes returnerar information när en cell uppdateras.
Aggregatorer
En aggregeringsmodul samlar ihop flera paket i ett och samma paket.
Aggregatorer returnerar bara ett paket, som sedan skickas vidare till nästa modul för vidare bearbetning.
Du kan bara placera aggregerare mitt i ett scenario.
Scenarier kan innehålla ett obegränsat antal aggregerare, men ett stort antal moduler (150+) kan påverka prestandan.
Exempel:
- Archive>Create an archive komprimerar flera filer till ett zip-arkiv.
- CSV>Aggregate to CSV sammanfogar flera strängar från en CSV-fil till en enda rad.
- Tools>Text aggregator kombinerar flera strängar till en enda sträng.
Mer information finns i Aggregatormodulen.
Iteratorer
En iterator är en typ av modul som delar upp arrayer i separata paket.
Iteratorer returnerar ett eller flera paket som sedan skickas vidare till nästa modul för bearbetning.
Du kan bara placera iteratorer mitt i ett scenario.
Scenarier kan innehålla ett obegränsat antal iteratorer, men ett stort antal moduler (150+) kan påverka prestandan.
Exempel:
Email>Retrieve attachments delar upp en matris med bilagor i separata paket.
Mer information finns i Interpolatormodulen och Mappa en array.