Använd Forms-centrerade AEM - stegvis referens för att automatisera affärsprocesser

Du använder arbetsflödesmodeller. En modell hjälper dig att definiera och köra en serie steg. Du kan också definiera modellegenskaper, t.ex. om arbetsflödet är tillfälligt eller använder flera resurser. Du kan inkludera olika AEM arbetsflödessteg i en modell för att uppnå affärslogiken.

Forms-centrerade steg

Forms-centrerade arbetsflödessteg utför AEM Forms-specifika åtgärder i ett AEM arbetsflöde. Med dessa steg kan du snabbt skapa ett adaptivt Forms-baserat Forms-baserat arbetsflöde i OSGi. Dessa arbetsflöden kan användas för att utveckla enkla arbetsflöden för granskning och godkännande, interna och övergripande affärsprocesser. Du kan även använda Formers Workflow för att:

• Skapa affärsprocesser, arbetsflöden efter inlämningen och serverbaserade arbetsflöden för att hantera registreringsprocesser.

• Skapa och tilldela uppgifter till en användare eller grupp.

• Använd Adobe Sign i ett AEM arbetsflöde för att skicka ett dokument för signering.

• Generera ett dokument för registrering on demand eller när formulär skickas.

• Koppla samman en arbetsflödesmodell med olika datakällor för att enkelt spara och hämta data.

• Använd e-poststeget för att skicka e-postmeddelanden och andra bilagor när en åtgärd har slutförts och när arbetsflödet har påbörjats eller slutförts.

Tilldela aktivitetssteg

Tilldela ett arbetsobjekt och tilldelar det till en användare eller grupp. Förutom att tilldela uppgiften anger komponenten även den adaptiva formen eller icke-interaktiva PDF för uppgiften. Det adaptiva formuläret krävs för att kunna ta emot indata från användare och icke-interaktiva PDF eller ett skrivskyddat anpassat formulär används endast för granskning.

Du kan också använda komponenten för att styra aktivitetens beteende. Du kan till exempel skapa ett automatiskt dokument för post, tilldela uppgiften till en viss användare eller grupp, ange sökvägen för skickade data, ange sökvägen för data som ska fyllas i i förväg och ange standardåtgärder. Tilldela uppgift-steget har följande egenskaper:

• Title: Aktivitetens namn. Titeln visas i AEM Inkorg.

• Description: Förklaring av de åtgärder som utförs i uppgiften. Den här informationen är användbar för andra processutvecklare när du arbetar i en delad utvecklingsmiljö.

• Thumbnail Path: Sökväg till aktivitetsminiatyrbilden. Om ingen sökväg anges visas en standardminiatyrbild för ett adaptivt formulär och en standardikon för Postdokument.

• Workflow Stage: Ett arbetsflöde kan ha flera steg. Dessa steg visas i AEM Inkorg. Du kan definiera dessa steg i modellens egenskaper (Sidekick > Sida > Sidegenskaper > Steg).

• Priority: Vald prioritet visas i AEM Inkorg. De tillgängliga alternativen är Hög, Medel och Låg. Standardvärdet är Medel.

• Due Date: Ange efter hur många dagar eller timmar aktiviteten ska markeras som försenad. Om du väljer Off, markeras uppgiften aldrig som försenad. Du kan också ange en uttidshanterare för att utföra vissa åtgärder när åtgärden är försenad.

• Days: Antal dagar innan uppgiften ska slutföras. Antalet dagar räknas efter att uppgiften har tilldelats en användare. Om en uppgift inte är fullständig och korsar det antal dagar som anges i fältet Dagar, aktiveras en timeout-hanterare efter förfallodatumet, om detta väljs.

• Hours: Antal timmar innan uppgiften ska slutföras. Antalet timmar räknas efter att uppgiften har tilldelats en användare. Om en uppgift inte är slutförd och korsar det antal timmar som anges i fältet Timmar, aktiveras en timeout-hanterare efter de timmar som ska förfalla.

• Time-out after Due Date: Välj det här alternativet om du vill aktivera markeringsfältet för Timeout-hanteraren.

• Timeout Handler: Välj det skript som ska köras när tilldelningssteget överskrider förfallodatumet. Skript i CRX-databasen på [appar]/fd/dashboard/scripts/timeoutHandler är tillgängliga för val. Den angivna sökvägen finns inte i crx-databasen. En administratör skapar sökvägen innan den används.

• Highlight the action and comment from the last task in Task Details: Välj det här alternativet om du vill visa den senaste åtgärden som utfördes och kommentarer som togs emot i aktivitetsinformationsavsnittet för en uppgift.

• Type: Välj vilken typ av dokument som ska fyllas när arbetsflödet startas. Du kan välja ett adaptivt formulär, ett skrivskyddat adaptivt formulär, ett icke-interaktivt PDF-dokument.

• Use Adaptive Form: Ange vilken metod som ska användas för att hitta den adaptiva formen. Det här alternativet är tillgängligt om du väljer Adaptivt formulär eller Skrivskyddat anpassat formulär i listrutan Typ. Du kan använda det adaptiva formulär som skickas till arbetsflödet, som finns på en absolut sökväg eller som finns på en sökväg i en variabel. Du kan använda en variabel av typen String för att ange sökvägen.
  Du kan koppla flera adaptiva Forms till ett arbetsflöde. Det innebär att du kan ange ett adaptivt formulär i körningsmiljön med de tillgängliga indatametoderna.

• Adaptive Form Path: Ange sökvägen till det adaptiva formuläret. Du kan använda det adaptiva formulär som skickas till arbetsflödet, finns på en absolut sökväg eller hämta det adaptiva formuläret från en sökväg som lagras i en variabel av strängdatatyp.

• Select input PDF using: Ange sökvägen till ett icke-interaktivt PDF-dokument. Fältet är tillgängligt när du väljer ett icke-interaktivt PDF-dokument i textfältet. Du kan markera indata PDF med den sökväg som är relativ till nyttolasten, som har sparats med en absolut sökväg eller med en variabel av dokumentdatatypen. Till exempel: [Payload_Directory]/Workflow/PDF/credit-card.pdf. Sökvägen finns inte i crx-databasen. En administratör skapar sökvägen innan den används. Du måste ha alternativet Dokument för post aktiverat eller formulärmallsbaserad Adaptiv Forms för att kunna använda alternativet PDF-sökväg.

• For completed task, render the Adaptive Form as: När en åtgärd har markerats som slutförd kan du återge det adaptiva formuläret som ett skrivskyddat anpassat formulär eller ett PDF-dokument. Du måste ha alternativet Dokument för post aktiverat eller formulärmallsbaserad Adaptiv Forms för att kunna återge det adaptiva formuläret som Dokument för post.

• Pre-populated: Följande fält i listan nedan fungerar som indata för uppgiften:

  • Select input data file using: Sökväg till indatafil (.json, .xml, .doc eller formulärdatamodell). Du kan hämta indatafilen med en sökväg som är relativ till nyttolasten eller hämta filen som lagras i en variabel av datatypen Document, XML eller JSON. Filen innehåller till exempel de data som har skickats för formuläret via ett AEM Inkorgsprogram. En exempelsökväg är [Payload_Directory]/workflow/data.

  • Select input attachments using: Bifogade filer på platsen bifogas till formuläret som är kopplat till uppgiften. Sökvägen kan vara relativ till nyttolasten eller hämta den bifogade filen som lagras i en variabel i ett dokument. En exempelsökväg är [Payload_Directory]/attachments/. Du kan ange bifogade filer som placeras i förhållande till nyttolasten eller använda en dokumenttypsvariabel (Array list > Document) för att ange en bifogad indatafil för det adaptiva formuläret.

  • Request Attribute Mapping: Använd avsnittet Mappning av attribut för att definiera namn och värde för attributet request. Hämta informationen från datakällan baserat på attributnamnet och värdet som anges i begäran. Du kan definiera ett attributvärde för begäran med hjälp av ett literalt värde eller en variabel av datatypen String.

• Submitted information: Följande fält i listan nedan fungerar som utdataplatser för uppgiften:

  • Save output data file using: Spara datafilen (.json, .xml, .doc eller formulärdatamodell). Datafilen innehåller information som skickas via det associerade formuläret. Du kan spara utdatafilen med en sökväg som är relativ till nyttolasten eller lagra den i en variabel av datatypen Document, XML eller JSON. Till exempel: [Payload_Directory]/Arbetsflöde/data, där data är en fil.
  • Save attachments using: Spara de bifogade formulären i en uppgift. Du kan spara de bifogade filerna med en sökväg som är relativ till nyttolasten eller lagra den i en variabel i arraylistan med dokumentdatatypen.
  • Save Document of Record using: Sökväg att spara en postdokumentfil. Till exempel: [Payload_Directory]/DocumentofRecord/credit-card.pdf. Du kan spara postdokumentet med en sökväg som är relativ till nyttolasten eller lagra det i en variabel av dokumentdatatypen. Om du väljer Relative to Payload om sökvägsfältet lämnas tomt, genereras inte dokumentdokumentet. Det här alternativet är bara tillgängligt om du väljer Adaptivt formulär i listrutan Typ.

• Assignee > Assign options: Ange vilken metod som ska användas för att tilldela en användare uppgiften. Du kan dynamiskt tilldela uppgiften till en användare eller en grupp med skriptet för deltagarväljaren eller tilldela uppgiften till en viss AEM användare eller grupp.

• Participant Chooser: Alternativet är tillgängligt när Dynamically to a user or group är markerat i fältet Tilldela alternativ. Du kan använda ett ECMAScript eller en tjänst för att dynamiskt välja en användare eller grupp. Mer information finns i Tilldela användare ett arbetsflöde dynamiskt och Skapa ett anpassat Adobe Experience Manager Dynamic Participant-steg.

• Participants: Fältet är tillgängligt när com.adobe.granite.workflow.core.process.RandomParticipantChooser alternativet är markerat i Participant Chooser fält. I fältet kan du välja användare eller grupper för alternativet RandomParticipantChooser.

• Assignee: Fältet är tillgängligt när com.adobe.fd.workspace.step.service.VariableParticipantChooser är markerat i Participant Chooser fält. I fältet kan du välja en variabel av datatypen String för att definiera den som tilldelas.

• Arguments: Fältet är tillgängligt när ett annat skript än skriptet RandomParticipantChoose har valts i fältet för deltagarväljaren. I fältet kan du ange en lista med ett kommaavgränsat argument för det skript som valts i fältet Deltagare.

• User or Group: Uppgiften tilldelas en vald användare eller grupp. Alternativet är tillgängligt när To a specific user or group option är markerat i Assign options fält. I fältet visas alla användare och grupper i workflow-users grupp.
  The User or Group listar de användare och grupper som den inloggade användaren har åtkomst till. Hur användarnamn visas beror på om du har åtkomstbehörighet för users i crx-databasen för just den användaren.

• Send Notification Email: Välj det här alternativet om du vill skicka e-postmeddelanden till den tilldelade personen. Dessa meddelanden skickas när en uppgift tilldelas en användare eller grupp. Du kan använda Recipient Email Address om du vill ange vilken mekanism som ska användas för att hämta e-postadressen.

• Recipient Email Address: Du kan lagra en e-postadress i en variabel, använda en litteral för att ange en permanent e-postadress eller använda den förvalda e-postadressen för den som har angetts i profilen för den som tilldelats. Du kan använda literalen eller en variabel för att ange en grupps e-postadress. Variabelalternativet är användbart när du dynamiskt vill hämta och använda en e-postadress. The Use default email address of the assignee är bara för en tilldelad. I det här fallet används den e-postadress som lagras i användarprofilen för tilldelade användare.

• HTML Email Template: Välj e-postmall för e-postmeddelandet. Om du vill redigera en mall ändrar du filen på /libs/fd/dashboard/templates/email/htmlEmailTemplate.txt i crx-databasen.

• Allow Delegation To: AEM Inkorg ger den inloggade användaren möjlighet att delegera det tilldelade arbetsflödet till en annan användare. Du får delegera inom samma grupp eller till arbetsflödesanvändaren i en annan grupp. Om uppgiften har tilldelats en enskild användare och allow delegation to members of the assignee group om du väljer det här alternativet går det inte att delegera uppgiften till en annan användare eller grupp.

• Share Settings: AEM Inkorgen innehåller alternativ för att dela en enskild eller alla uppgifter i inkorgen med en annan användare:

  • När Allow assignee to share explicitly in inbox är markerat kan användaren markera uppgiften i AEM Inkorg och dela den med en annan AEM.
  • När Allow assignee to share via inbox sharing är valt och användare delar sina inkorgsobjekt eller tillåter andra användare att komma åt sina inkorgsobjekt. Endast uppgifter med det tidigare alternativet aktiverat delas med andra användare.
  • När Allow assignee to delegate using ‘Out of Office’ settings är markerat. Uppdragaren kan aktivera alternativet att delegera uppgiften till andra användare tillsammans med andra frånvaroalternativ. Alla nya uppgifter som tilldelas till användaren utanför kontoret delegeras automatiskt (tilldelas) till de användare som anges i inställningarna utanför kontoret.

  Det gör att andra användare kan välja tilldelningsuppgifter när de inte är på kontoret och inte kan arbeta med tilldelade uppgifter.

• Actions > Default Actions: Det finns färdiga funktioner för att skicka, spara och återställa. Som standard är alla standardåtgärder aktiverade.

• Route Variable: Namn på flödesvariabeln. Vägvariabeln hämtar anpassade åtgärder som en användare väljer i AEM Inkorg.

• Routes: En aktivitet kan förgrena till olika vägar. När du väljer det här alternativet i AEM Inkorg returnerar flödet ett värde och arbetsflödesgrenarna baserat på det valda flödet. Du kan antingen lagra vägar i en variabel av datatypen String eller välja Literal om du vill lägga till flöden manuellt.

• Route Title: Ange ruttens titel. Den visas i AEM Inkorg.

• Coral Icon: Ange ett HTML-attribut för en korallikon. Adobe CorelUI-biblioteket innehåller en mängd ikoner som sätter pekskärpan först. Du kan välja och använda en ikon för rutten. Den visas tillsammans med titeln i AEM Inkorg. Om du lagrar rutterna i en variabel använder rutterna en taggikon.

• Allow assignee to add comment: Välj det här alternativet om du vill aktivera kommentarer för uppgiften. En tilldelad kan lägga till kommentarerna från AEM Inkorg när uppgiften skickas.

• Save comment in variable: Spara kommentaren i en variabel av datatypen String. Det här alternativet visas bara om du väljer Allow assignee to add comment kryssrutan.

• Allow assignee to add attachments to the task: Välj det här alternativet om du vill aktivera bilagor för uppgiften. En tilldelad kan lägga till de bifogade filerna inifrån AEM Inkorg när uppgiften skickas. Du kan också begränsa den maximala storleken (Maximum File Size) för en bifogad fil. Standardstorleken är 2 MB.

• Save output task attachments using: Ange platsen för den bifogade mappen. Du kan spara bilagor för utdatauppgifter med en relativ sökväg till nyttolasten eller med en variabel av en array med dokumentdatatyper. Det här alternativet visas bara om du väljer Allow assignee to add attachments to the task kryssruta och markera Adaptive Form, Read-only Adaptive Form, eller Non-interactive PDF document från Type nedrullningsbar lista i Form/Document -fliken.

• Use custom metadata: Välj det här alternativet om du vill aktivera det anpassade metadatafältet. Anpassade metadata används i e-postmallar.

• Custom Metadata: Välj anpassade metadata för e-postmallarna. Anpassade metadata är tillgängliga i crx-databaser på apparna/fd/dashboard/scripts/metadataScripts. Den angivna sökvägen finns inte i crx-databasen. En administratör skapar sökvägen innan den används. Du kan också använda en tjänst för anpassade metadata. Du kan också utöka WorkitemUserMetadataService för att skapa anpassade metadata.

• Show Data from Previous Steps: Välj det här alternativet om du vill att tilldelningar ska kunna visa tidigare tilldelningar, åtgärder som redan har vidtagits för uppgiften, kommentarer som har lagts till i uppgiften och dokumentdokument för den slutförda uppgiften, om tillgängligt.

• Show Data from Subsequent Steps: Välj det här alternativet om du vill att den som är tilldelad ska kunna visa den åtgärd som vidtagits och de kommentarer som lagts till i uppgiften av efterföljande tilldelningar. Den aktuella tilldelaren kan även visa en dokumentfil för den slutförda uppgiften, om en sådan finns.

• Visibility of data type: Som standard kan en tilldelad visa ett arkivdokument, tilldelningar, åtgärd och kommentarer som tidigare och efterföljande tilldelningar har lagt till. Använd datatypsalternativet för synlighet för att begränsa vilken typ av data som är synlig för de tilldelade.

Konvertera till PDF/A-steg

PDF/A är ett arkiveringsformat som gör att dokumentets innehåll bevaras på lång sikt genom att teckensnitten bäddas in och filen dekomprimeras. Därför är ett PDF/A-dokument vanligtvis större än ett PDF-standarddokument. Du kan använda Konvertera till PDF/A i ett AEM arbetsflöde för att konvertera dina PDF-dokument till PDF/A-format.

Följande egenskaper gäller för steget Konvertera till PDF/A:

Input Document: Indatadokumentet kan vara relativt till nyttolasten, ha en absolut sökväg, kan anges som en nyttolast eller lagras i en variabel av dokumentdatatypen.

Conversion Options: Med den här egenskapen anges inställningarna för konvertering av PDF-dokument till PDF/A-dokument. De olika alternativ som är tillgängliga under den här fliken är:

• Compliance: Anger den standard som utdata-PDF/A-dokumentet måste uppfylla. Det stöder olika PDF-standarder som PDF/A-1b, PDF/A-2b eller PDF/A-3b.
• Result Level: Anger resultatnivån som PassFail, Summary eller Detailed för konverteringsutdata.
• Color Space: Anger den fördefinierade färgrymden som S_RGB, COATED_FOGRA27, JAPAN_COLOR_COATED eller SWOP, som kan användas för utdata i PDF/A-filer.
• Optional Content: Tillåt att specifika grafiska objekt och/eller anteckningar visas i utdata från PDF/A-dokument, endast när en angiven uppsättning villkor uppfylls.

Output Documents: Anger platsen där utdatafilen ska sparas. Utdatafilen kan sparas på en plats som är relativ till nyttolasten, skriver över nyttolasten, om nyttolasten är en fil eller i en variabel av dokumentdatatypen.

Skicka e-poststeg

Använd e-poststeget för att skicka ett e-postmeddelande, till exempel ett e-postmeddelande med ett postdokument, en länk till ett anpassat formulär eller med ett bifogat PDF-dokument. Skicka e-poststeg som stöds HTML email. HTML e-postmeddelanden är responsiva och anpassar sig efter mottagarnas e-postklient och skärmstorlek. Du kan använda en HTML-e-postmall för att definiera utseendet, färgschemat och beteendet för e-postmeddelandet.

I e-poststeget används Day CQ Mail Service för att skicka e-postmeddelanden. Kontrollera att e-posttjänsten är konfigurerad innan du använder e-poststeget. E-poststöd är som standard bara för HTTP- och HTTP-protokoll. Kontakta supportteam för att göra det möjligt för portar att skicka e-post och aktivera SMTP-protokoll för din miljö. Begränsningen bidrar till att förbättra plattformens säkerhet.

E-poststeget har följande egenskaper:

Title: Stegen är en titel som hjälper dig att identifiera steget i arbetsflödesredigeraren.

Description: Förklaring är användbar för andra processutvecklare när du arbetar i en delad utvecklingsmiljö.

Email Subject: Ämne kan hämtas från ett arbetsflödes metadata, anges manuellt eller hämtas från värdet som lagras i en variabel. Välj bland följande alternativ:

• Literal Ange ett ämne manuellt.
• Retrieve from Workflow metadata - Hämta ämnet från en metadataegenskap.
• Variable - Hämta ämnet från värdet som lagras i en variabel av strängdatatyp.

HTML Email Template: HTML-mall för e-postmeddelandet. Du kan ange variabler i en e-postmall. E-poststeget extraheras och visar alla variabler som ingår i en mall för indata.

Email Template Metadata: Värdet för e-postmallvariablerna kan vara ett användarspecificerat värde, sökvägen till en resurs på författaren eller på publiceringsservern, bilden eller en metadataegenskap för arbetsflödet.

• Literal: Använd alternativet när du vet exakt vilket värde du ska ange. Till exempel: example@example.com.

• Workflow Metadata: Använd alternativet när värdet som ska användas sparas i en arbetsflödets metadataegenskap. När du har valt alternativet anger du metadataegenskapens namn i den tomma textrutan under alternativet Metadata för arbetsflöde. Till exempel emailAddress.

• Image: Använd alternativet för att bädda in en bild i e-postmeddelandet. När du har valt alternativet bläddrar du och väljer bilden. Bildalternativet är bara tillgängligt för de bildtaggar (<img src="<span id=" translate="no" />"/>) som är tillgängliga i e-postmallen.*

Sender’s / Recipient’s Email Address: Välj Literal om du vill ange en e-postadress manuellt eller välja Retrieve from Workflow metadata alternativ för att hämta e-postadressen från en metadataegenskap. Du kan också ange en lista med egenskapsmatriser för metadata för Retrieve from Workflow metadata alternativ. Välj Variable om du vill hämta e-postadressen från värdet som lagras i en variabel av strängdatatyp.

• File Attachment: Resursen som är tillgänglig på den angivna platsen är kopplad till e-postmeddelandet. Resursens sökväg kan vara relativ till nyttolasten eller den absoluta sökvägen. En exempelsökväg är [Payload_Directory]/attachments/.

Välj Variable om du vill hämta den bifogade filen som lagras i en variabel av datatypen Document, XML eller JSON.

File Name: Namnet på e-postbilagefilen. E-poststeget ändrar det ursprungliga filnamnet för den bifogade filen till det angivna filnamnet. Namnet kan anges manuellt eller hämtas från en metadataegenskap eller variabel i arbetsflödet. Använd Literal när du vet exakt vilket värde du ska ange. Använd Variable om du vill hämta filnamnet från det värde som lagras i en variabel av strängdatatyp. Använd Retrieve from a Workflow Metadata när värdet som ska användas sparas i en metadataegenskap för arbetsflöde.

Generera dokumentarkivhandlingssteget

När ett formulär fylls i eller skickas kan du spara en post med formuläret, i utskrift eller i dokumentformat. Den här posten kallas dokumentarkivhandling (DoR). Du kan använda steget Skapa dokument för post för att skapa en skrivskyddad eller interaktiv PDF-version av ett anpassat formulär. PDF-versionen innehåller information som fylls i i formuläret tillsammans med layouten för det adaptiva formuläret.

Dokumentsteget har följande egenskaper:

Use Adaptive Form: Ange vilken metod som ska användas för att hitta den adaptiva formen. Du kan använda det adaptiva formulär som skickas till arbetsflödet, som finns på en absolut sökväg eller som finns på en sökväg i en variabel. Du kan använda en variabel av datatypen String för att ange sökvägen i Select variable to resolve fält.
Du kan koppla flera adaptiva Forms till ett arbetsflöde. Det innebär att du kan ange ett adaptivt formulär i körningsmiljön med de tillgängliga indatametoderna.

Adaptive Form Path: Ange sökvägen till det adaptiva formuläret. Fältet är tillgängligt när du väljer Available at an absolute path från Use Adaptive Form fält.

Select Input data using: Sökväg till indata för det adaptiva formuläret. Du kan behålla data på en plats i förhållande till nyttolasten, ange en absolut sökväg till data eller hämta data som lagras i en variabel av datatypen Document, JSON eller XML. Indata sammanfogas med det adaptiva formuläret för att skapa ett postdokument.

Select Input attachment path using: Sökväg till de bifogade filerna. De här bifogade filerna ingår i dokumentdokumentet. Du kan behålla de bifogade filerna på en plats i förhållande till nyttolasten, ange en absolut sökväg för de bifogade filerna eller hämta bifogade filer som lagras i en variabel av dokumentdatatypen.

Om du anger sökvägen till en mapp, till exempel bilagor, bifogas alla filer som är direkt tillgängliga i mappen till Dokument för post. Om det finns filer i de mappar som är direkt tillgängliga i den angivna sökvägen inkluderas filerna i Postdokument som bilagor. Om det finns mappar i direkt tillgängliga mappar hoppas de mapparna över.

Save Generated Document of Record using below options: Ange platsen där en postfil ska sparas. Du kan välja att skriva över nyttolastmappen, placera postdokumentet på en plats i nyttolastkatalogen eller lagra postdokumentet i en variabel av dokumentdatatypen.

Locale: Ange språk för postdokumentet. Välj Literal om du vill välja språkinställning i en nedrullningsbar lista eller välja Variable för att hämta språkinställningen från värdet som lagras i en variabel av strängdatatyp. Definiera språkkoden medan värdet för språkinställningen lagras i en variabel. Ange till exempel sv_SE för engelska och fr_FR för franska.

Anropa DDX-steg

Document Description XML (DDX) är ett deklarativt kodspråk vars element representerar byggstenar av dokument. Dessa byggstenar innehåller PDF- och XDP-dokument och andra element som kommentarer, bokmärken och formaterad text. DDX definierar en uppsättning åtgärder som kan tillämpas på ett eller flera indatadokument för att generera ett eller flera utdatadokument. Ett enda DX kan användas med ett antal olika källdokument. Du kan använda Anropa DDX-steg i ett AEM arbetsflöde för att utföra olika åtgärder, t.ex. att samla ihop dokument, skapa och ändra Acrobat och XFA Forms, samt andra som beskrivs i DDX-referensdokumentation.

Anropa DDX-steget har följande egenskaper:

Input Documents: Används för att ange egenskaper för ett indatadokument. De olika alternativ som är tillgängliga under den här fliken är:

• Specify DDX Using: Anger indatadokumentet i förhållande till nyttolasten, har en absolut sökväg, kan anges som nyttolast eller lagras i en variabel av dokumentdatatypen.
• Create Map from Payload: Lägg till alla dokument under nyttolastmappen i Input Document Map för invoke API i Assembler. Nodnamnet för varje dokument används som en nyckel på kartan.
• Input Document’s Map: Alternativ används för att lägga till flera poster med ADD -knappen. Varje post representerar dokumentets nyckel på kartan och dokumentets källa.

Environment Options: Det här alternativet används för att ange bearbetningsinställningar för anrop av API. De olika alternativ som är tillgängliga under den här fliken är:

• Validate Only: Kontrollerar giltigheten för indata-DDX-dokumentet.
• Fail on Error: Booleskt värde som anger om anrop-API-tjänsten misslyckas, om ett fel uppstår eller inte. Som standard är värdet Falskt.
• First Bates Number: Anger talet, som ökar automatiskt. Det här självökande numret visas automatiskt på varje sida i följd.
• Default Style: Anger standardformatet för utdatafilen.

Output Documents: Anger platsen där utdatafilen ska sparas. De olika alternativ som är tillgängliga under den här fliken är:

• Save Output in Payload: Sparar utdatadokument under nyttolastmappen, eller skriver över nyttolasten om nyttolasten är en fil.
• Output Document’s Map: Anger platsen där varje dokumentfil ska sparas explicit genom att en post per dokument läggs till. Varje post representerar dokumentet och platsen där det ska sparas. Om det finns flera utdatadokument används det här alternativet.

Anropa tjänststeg för formulärdatamodell

Du kan använda AEM Forms Dataintegrering för att konfigurera och ansluta till olika datakällor. Dessa datakällor kan vara en webbtjänst, REST-tjänst, OData-tjänst och CRM-lösning. AEM Forms Med dataintegrering kan du skapa en formulärdatamodell som omfattar olika tjänster för att utföra datahämtnings-, additions- och uppdateringsåtgärder för den konfigurerade databasen. Du kan använda Invoke Data Model Service step för att välja en formulärdatamodell (FDM) och använda FDM-tjänsterna för att hämta, uppdatera eller lägga till data till olika datakällor.

Följande databastabell och JSON-filen används som exempel för att förklara indata för stegfält:

Sample CustomerDetails table

Sample JSON file

  {
    customer: {
     firstName: "Sarah",
     lastName:"Rose",
     customerId: "1",
     emailAddress:"srose@we.info"
   },
    insurance: {
     customerId: "1",
    policyType: "Premium,
    policyNumber: "Premium-521499",
    customerDetails: {
     firstName: "Sarah",
     lastName: "Rose",
     customerId: "1",
     emailAddress: "srose@we.info"
    }
   }
  }

I steget Anropa formulärdatamodelltjänst visas följande fält för att underlätta formulärdatamodellåtgärder:

• Title: Stegets namn. Det hjälper till att identifiera stegen i arbetsflödesredigeraren.

• Description: Förklaring är användbar för andra processutvecklare när du arbetar i en delad utvecklingsmiljö.

• Form Data Model Path: Bläddra och välj en formulärdatamodell som finns på servern.

• Errors and Validations: Med det här alternativet kan du samla in felmeddelanden och ange valideringsalternativ för data som hämtas och skickas till datakällor. Med de här ändringarna kan du se till att data som skickas till steget Anropa datamodell följer de databegränsningar som definieras av datakällan. Mer information finns i Automatisk validering av indata

• Validation level: Det finns tre valideringskategorier: Basic, Full och OFF:

  • Fullständig: Alla begränsningar valideras.
  • Grundläggande: Endast obligatoriska och nullbara begränsningar
  • AV: Ingen validering sker.

• Terminate Workflow on Failure: När en begränsning inte kan valideras stoppas arbetsflödet.

• Store Error Code in Variable: Du kan lagra en felkod i en Strängtypsvariabel.

• Store Error Message in Variable: Du kan lagra ett felmeddelande i en Strängtypsvariabel.

• Store Error Details in Variable: Du kan lagra en felinformation i en JSON-typvariabel.

• Service: Lista över de tjänster som den valda formulärdatamodellen tillhandahåller.

• Input for services > Provide input data using literal, variable, or workflow metadata, and a JSON file: En tjänst kan ha flera argument. Välj alternativet för att hämta värdet för tjänstargumenten från en metadataegenskap för arbetsflöde, ett JSON-objekt, en variabel eller ange värdet direkt i textrutan:

  • Literal: Använd alternativet när du vet exakt vilket värde du ska ange. Exempel: srose@we.info.

  • Variable: Använd alternativet för att hämta värdet som lagras i en variabel.

  • Retrieve from Workflow Metadata: Använd alternativet när värdet som ska användas sparas i en arbetsflödets metadataegenskap. Till exempel emailAddress.

  • Relative to Payload: Använd alternativet för att hämta den bifogade filen som har sparats på en relativ sökväg till nyttolasten. Markera alternativet och ange antingen mappnamnet som innehåller den bifogade filen eller ange namnet på den bifogade filen i textrutan.

    Om mappen Relativt till nyttolast i CRX-databasen till exempel innehåller en bifogad fil på attachment\attachment-folder plats, ange attachment\attachment-folder i textrutan efter att du har valt Relative to Payload alternativ.

  • JSON Dot Notation: Använd alternativet när värdet som ska användas finns i en JSON-fil. Till exempel försäkring.customerDetails.emailAddress. Alternativet JSON-punktnotation är bara tillgängligt om du har valt kartinmatningsfält från alternativet JSON för inmatning.

  • Map input fields from input JSON: Ange sökvägen till en JSON-fil för att hämta indatavärdet för vissa tjänstargument från JSON-filen. JSON-filens sökväg kan vara relativ till nyttolasten, en absolut sökväg eller så kan du välja ett JSON-indata-dokument med hjälp av en variabel av typen JSON eller Form Data Model.

• Input for services > Provide input data using variable or a JSON file: Välj alternativet om du vill hämta värden för alla argument från en JSON-fil som har sparats med en absolut sökväg, med en sökväg som är relativ till nyttolasten eller i en variabel.

• Select Input JSON document using: JSON-filen innehåller värden för alla tjänstargument. JSON-filens sökväg kan vara relative to the payload eller en absolute path. Du kan även hämta JSON-indata-dokumentet med hjälp av en variabel av datatypen JSON eller Form Data Model.

• JSON Dot Notation: Lämna fältet tomt om du vill använda alla objekt i den angivna JSON-filen som indata för tjänstargument. Om du vill läsa ett specifikt JSON-objekt från den angivna JSON-filen som indata för serviceargument anger du punktnotation för JSON-objektet, till exempel, om du har en JSON som liknar den som anges i början av avsnittet, anger du försäkring.customerDetails för att ge all information om en kund som indata till tjänsten.

• Output of service > Map and write output values to variable or metadata: Välj alternativet att spara utdatavärdena som egenskaper för arbetsflödesinstansens metadatanod i crx-databasen. Ange namnet på metadataegenskapen och välj det motsvarande tjänstutdataattribut som ska mappas med metadataegenskapen, till exempel mappa det telefonnummer som returneras av utdatatjänsten med egenskapen phone_number för arbetsflödets metadata. På samma sätt kan du lagra utdata i en variabel med datatypen Long. När du väljer en egenskap för Service output attribute to be mapped , fylls endast variabler som kan lagra data för den valda egenskapen i för Save the output to alternativ.

• Output of service > Save output to variable or a JSON file: Välj alternativet att spara utdatavärdena i en JSON-fil med en absolut sökväg, med en sökväg som är relativ till nyttolasten eller i en variabel.

• Save Output JSON document using below options: Spara JSON-utdatafilen. Sökvägen till JSON-utdatafilen kan vara relativ till nyttolasten eller en absolut sökväg. Du kan också spara JSON-utdatafilen med en variabel av datatypen JSON eller Form Data Model.

Underteckna dokumentsteg

Med steget Signera dokument kan du använda Adobe Sign för att signera dokument. När du använder Adobe Sign Arbetsflödessteg för att signera ett adaptivt formulär kan skickas mellan mottagarna en i taget eller skickas till alla mottagare samtidigt, beroende på arbetsflödesstegets konfiguration. Adobe Sign Adaptiv Forms skickas till Experience Manager Forms Server först när alla mottagare har slutfört signeringsprocessen.

Som standard är Adobe Sign Tjänsten Schemaläggaren kontrollerar (avsöker) mottagarens svar efter 24 timmars intervall. Du kan ändra standardintervallet för miljön.

Stegen Signera dokument har följande egenskaper:

• Agreement Name: Ange avtalets namn. Avtalsnamnet blir en del av ämnet och brödtexten i det e-postmeddelande som skickas till signerarna. Du kan antingen lagra namnet i en variabel av datatypen String eller välja Literal om du vill lägga till namnet manuellt.

• Locale: Ange språk för alternativen för e-post och verifiering. Du kan antingen lagra språkinställningen i en variabel av datatypen String eller välja Literal om du vill välja språkområde i listan med tillgängliga alternativ. Du måste definiera språkkoden medan du lagrar värdet för språkinställningen i en variabel. Ange till exempel en_US för engelska och fr_FR för franska.

• Adobe Sign Cloud Configuration: Välj en Adobe Sign Molnkonfiguration. Om du inte har konfigurerat Adobe Sign for AEM Forms, se Integrera Adobe Sign med AEM Forms.

• Select Document to be signed using: Du kan välja ett dokument från en plats som är relativ till nyttolasten, använda nyttolasten som dokument, ange en absolut sökväg för dokumentet eller hämta dokumentet som lagras i en variabel av dokumentdatatypen.

• Days Until Deadline: Ett dokument markeras som förfallet (passerat deadline) efter att det inte finns någon aktivitet i uppgiften för det antal dagar som anges i Days Until Deadline fält. Antalet dagar räknas efter att dokumentationen har tilldelats en användare för signering.

• Reminder Email Frequency: Du kan skicka en påminnelse via e-post varje dag eller vecka. Veckan räknas från den dag som dokumentationen tilldelas en användare för signering.

• Signature Process: Du kan välja att signera ett dokument i sekventiell eller parallell ordning. I sekventiell ordning tar en signerare emot dokumentet i taget för signering. När den första signeraren har slutfört signeringen av dokumentet skickas dokumentet till den andra signeraren och så vidare. Flera signerare kan signera ett dokument samtidigt i parallell ordning.

• Redirection URL: Ange en URL för omdirigering. När dokumentet har signerats kan du dirigera om den som tilldelats till en URL. Oftast innehåller denna URL ett tackmeddelande eller ytterligare instruktioner.

• Workflow Stage: Ett arbetsflöde kan ha flera steg. Dessa steg visas i AEM Inkorg. Du kan definiera dessa steg i modellens egenskaper ( Sidekick > Page > Page Properties > Stages).

• Select Recipients: Ange metoden för att välja mottagare för dokumentet. Du kan dynamiskt tilldela arbetsflödet till en användare eller en grupp eller manuellt lägga till information om en mottagare. När du väljer Manuellt i listrutan lägger du till mottagarinformation som e-post, roll och autentiseringsmetod.

  OBSERVERA

  • I rollavsnittet kan du ange mottagarrollen som signerare, godkännare, godkännare, certifierad mottagare, formulärifyllare och delegerande.
  • Om du väljer Delegerande i alternativet Roll kan delegeraren tilldela signeringsaktiviteten till en annan mottagare.
  • Om du har konfigurerat en autentiseringsmetod för Adobe Sign, baserat på din konfiguration, väljer du en autentiseringsmetod som telefonbaserad autentisering, autentisering via social identitet, kunskapsbaserad autentisering, autentisering baserad på myndighetsidentitet.

• Script or service to select recipients: Alternativet är bara tillgängligt om du väljer alternativet Dynamiskt i fältet Välj mottagare. Du kan ange ett ECMAScript eller en tjänst för att välja signerare och verifieringsalternativ för ett dokument.

• Recipient Details: Alternativet är bara tillgängligt om alternativet Manuellt är markerat i fältet Välj mottagare. Ange en e-postadress och välj en valfri verifieringsmekanism. Kontrollera att motsvarande verifieringsalternativ är aktiverat för den konfigurerade Adobe Sign konto. Du kan använda en variabel av datatypen String för att definiera värden för fälten E-post, Landskod och Telefonnummer. Fälten Landskod och Telefonnummer visas bara om du väljer Telefonverifiering i den 2-stegsvisa verifieringslistan.

• Signed Document: Du kan spara statusen för det signerade dokumentet till Variabel. Om du vill lägga till en elektronisk signaturgranskningsversion för att öka säkerheten och lagligheten i det signerade dokumentet kan du inkludera revideringsrapport. Du kan spara det signerade dokumentet med hjälp av variabeln eller nyttolastmappen.

  OBSERVERA

  Revideringsrapporten läggs till den sista sidan i det signerade dokumentet.

Generera utskriftssteg

Steget genererar ett PCL-, PostScript-, ZPL-, IPL-, TPCL- eller DPL-utdata baserat på en formulärdesign och datafil. Datafilen sammanfogas med formulärdesignen och formateras för utskrift. De utdata som genereras i det här steget kan skickas direkt till en skrivare eller sparas som en fil. Vi rekommenderar att du använder det här steget när du vill använda formulärdesigner eller data från ett program. Om formulärdesignerna finns i nätverket, det lokala filsystemet eller på HTTP-platsen använder du åtgärden generatePrintedOutput.

Programmet kräver till exempel att du sammanfogar en formulärdesign med en datafil. Informationen innehåller hundratals poster. Dessutom krävs att utdata skickas till en skrivare som stöder ZPL. Formulärdesignen och dina indata finns i ett program. Använd åtgärden generatePrintedOutput för att sammanfoga varje post med en formulärdesign och skicka utdata till en skrivare som stöder ZPL.

Stegen Generera utskrift har följande egenskaper:

Input properties

• Select template file using: Ange sökvägen till mallfilen. Du kan välja mallfilen med hjälp av sökvägen som är relativ till nyttolasten, sparad med en absolut sökväg eller med hjälp av en variabel av datatypen Dokument. Till exempel: [Payload_Directory]/Workflow/data.xml. Om sökvägen inte finns i crx-databasen kan en administratör skapa sökvägen innan den används. Dessutom kan du acceptera nyttolasten som indatafil.

• Select data document using: Ange sökvägen till en indatafil. Du kan markera indatafilen med den sökväg som är relativ till nyttolasten, som har sparats med en absolut sökväg eller med en variabel av dokumentdatatypen. Till exempel: [Payload_Directory]/Workflow/data.xml. Om sökvägen inte finns i crx-databasen kan en administratör skapa sökvägen innan den används.

• Printer Format: Ett värde för utskriftsformat som anger vilket sidbeskrivningsspråk som ska användas när ingen XDC-fil anges för att generera utdataströmmen. Om du anger ett literalt värde väljer du något av följande värden:

  • color PCL: Använd alternativet för att ange en XDC-fil för PCL.
  • Generic PostScript: Använd alternativet för att ange en allmän XDC-fil för PostScript.
  • ZPL 300 DPI: Använd ZPL 300 DPI. Zpl300.xdc används.
  • ZPL 600 DPI: Använd ZPL 600 DPI. Filen zpl600.xdc används.
  • IPL 300 DPI: Använd IPL 300 DPI. ipl300.xdc används.
  • IPL 400 DPI: Använd IPL 400 DPI. Filen ipl400.xdc används.
  • TPCL 600 DPI: Använd TPCL 600 DPI. Filen tpcl600.xdc används.
  • PostScript Plain: Använd alternativet för att ange en XDC-fil med oformaterad text för PostScript.
  • DPL300DPI: Använd DPL 300 DPI. dpl300.xdc används.
  • DPL400DPI: Använd DPL 400 DPI. dpl400.xdc används.
  • DPL600DPI: Använd DPL 600 DPI. dpl600.xdc används.
  • HP_PCL_5e: Använd alternativet för att stödja flera Canon-enheter.

Output Properties

• Save output document using: Ange platsen där utdatafilen ska sparas. Du kan spara utdatafilen på en plats som är relativ till nyttolasten, i en variabel eller ange en absolut plats att spara utdatafilen på. Om sökvägen inte finns i crx-databasen kan en administratör skapa sökvägen innan den används.

Advanced Properties

• Select Content Root location using: Innehållsroten är ett strängvärde som anger URI, absolut referens eller plats i databasen för att hämta relativa resurser som används i formulärdesignen. Om formulärdesignen till exempel refererar till en bild relativt, som ../myImage.gif, myImage.gif måste vara på repository://. Standardvärdet är repository://, som pekar på databasens rotnivå.

  När du väljer en resurs från ditt program måste innehållsrots-URI-sökvägen ha rätt struktur. Om ett formulär till exempel hämtas från ett program med namnet SampleApp och placeras på SampleApp/1.0/forms/Test.xdpmåste innehållets rot-URI anges som repository://administrator@password/Applications/SampleApp/1.0/forms/, eller repository:/Applications/SampleApp/1.0/forms/ (när behörigheten är null). När innehållets rot-URI anges på det här sättet matchas sökvägarna för alla refererade resurser i formuläret mot denna URI.

• Select XCI file using: XCI-filer används för att beskriva teckensnitt och andra egenskaper som används för formulärdesignelement. Du kan behålla en XCI-fil i förhållande till nyttolasten, på en absolut sökväg eller med en variabel av dokumentdatatypen.

• Locale: Anger vilket språk som ska användas för att generera PDF-dokumentet. Om du anger ett literalt värde väljer du ett språk i listan eller något av dessa värden:

  • To use server default: (Standard) Använd inställningen Språk ut som konfigurerats på AEM Forms Server. Inställningen Språk konfigureras med administrationskonsolen. (Se Designer - hjälp.)

  • To use custom value: Ange språkkoden i den litterala rutan eller välj en strängvariabel som innehåller språkkoden. En fullständig lista över språkkoder som stöds finns på https://docs.oracle.com/javase/1.5.0/docs/guide/intl/locale.doc.html.

• Copies: Ett heltalsvärde som anger antalet kopior som ska genereras för utdata. Standardvärdet är 1.

• Duplex Printing: Ett sidnumreringsvärde som anger om dubbelsidig eller enkelsidig utskrift ska användas. Skrivare som stöder PostScript och PCL använder det här värdet. Om du anger ett literalt värde väljer du något av följande värden:

  • Duplex Long Edge: Använd dubbelsidig utskrift och utskrift med sidnumrering i långkant.
  • Duplex Short Edge: Använd dubbelsidig utskrift och utskrift med hjälp av sidnumrering med kort kant.
  • Simplex: Använd enkelsidig utskrift.

Generera icke-interaktiv PDF-utdatasteg  

1. Dra arbetsflödet Generera icke-interaktiv PDF-utdata på fliken Forms Workflow i Sidekick.
2. Dubbelklicka på det tillagda arbetsflödessteget för att redigera komponenten.
3. Konfigurera indatadokument, utdatadokument och andra parametrar i dialogrutan Redigera komponent och klicka på OK.

Indatadokument

• Mallfil: Anger platsen för XDP-mallen. Det är ett obligatoriskt fält.

• Datadokument: Anger platsen för den data-XML som behöver sammanfogas med mallen.

Utdatadokument

Utdatadokument: Anger namnet på det genererade PDF-formuläret.

Ytterligare parametrar

• Innehållsrot: Anger sökvägen till mappen i databasen där fragment eller bilder som används i XDP-indatamallen lagras.
• Språk: Anger standardspråkområdet för det genererade PDF-formuläret.
• Acrobat Version: Anger Acrobat-målversionen för det genererade PDF-formuläret.
• Linjäriserad PDF: Anger om den genererade PDF ska optimeras för webbvisning.
• Tagged PDF: Anger om den genererade PDF ska vara tillgänglig.
• XCI-dokument: Anger sökvägen till XCI-filen.

Se även

• Variabler i Forms-centrerade AEM
• Konfigurera frånvaroinställningar

Resurser för Business.Adobe.com