Konvertera mellan filformat och PDF converting-between-file-formatsand-pdf

Exempel och exempel i det här dokumentet gäller endast för AEM Forms i JEE-miljö.

Om tjänsten Generate PDF

Tjänsten Generate PDF konverterar de ursprungliga filformaten till PDF. Dessutom konverteras PDF till andra filformat och storleken på PDF-dokument optimeras.

Tjänsten Generate PDF använder inbyggda program för att konvertera följande filformat till PDF. Om inget annat anges stöds endast de tyska, franska, engelska och japanska versionerna av dessa program. Endast Windows anger endast stöd för Windows Server® 2003 och Windows Server 2008.

Tjänsten Generate PDF konverterar följande standardbaserade filformat till PDF.

Tjänsten Generate PDF konverterar PDF till följande filformat (endast Windows):

Tjänsten Generera PDF kräver att du utför följande administrativa uppgifter:

Dessa åtgärder beskrivs i Installera och distribuera AEM formulär med JBoss-tangenten.

Du kan utföra följande uppgifter med tjänsten Generate PDF:

Konvertera Word-dokument till PDF-dokument converting-word-documents-to-pdf-documents

I det här avsnittet beskrivs hur du kan använda Generate PDF API för att programmässigt konvertera ett Microsoft Word-dokument till ett PDF.

Sammanfattning av steg summary-of-steps

Så här konverterar du ett Microsoft Word-dokument till ett PDF-dokument:

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa en Generate PDF-klient

Skapa en Generate PDF service-klient innan du programmässigt utför en Generate PDF-åtgärd. Om du använder Java API skapar du ett GeneratePdfServiceClient-objekt. Om du använder webbtjänstens API skapar du ett GeneratePDFServiceService-objekt.

Hämta filen som ska konverteras till ett PDF-dokument

Hämta Microsoft Word-dokumentet som ska konverteras till ett PDF-dokument.

Konvertera filen till ett PDF-dokument

När du har skapat tjänstklienten Generate PDF kan du anropa metoden createPDF2. Den här metoden kräver information om dokumentet som ska konverteras, inklusive filtillägget.

Hämta resultaten

När filen har konverterats till ett PDF-dokument kan du hämta resultatet. När du till exempel har konverterat en Word-fil till ett PDF-dokument kan du hämta och spara dokumentet i PDF.

Se även

Konvertera Word-dokument till PDF med Java API

Konvertera Word-dokument till PDF-dokument med hjälp av webbtjänstens API

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Generera snabbstart för PDF Service API

Konvertera Word-dokument till PDF med Java API convert-word-documents-to-pdf-documents-using-the-java-api

Konvertera ett Microsoft Word-dokument till ett PDF-dokument med hjälp av API:t Generate PDF (Java):

Se även

Sammanfattning av steg

Snabbstart (SOAP): Konvertera ett Microsoft Word-dokument till ett PDF-dokument med Java API

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Konvertera Word-dokument till PDF-dokument med hjälp av webbtjänstens API convert-word-documents-to-pdf-documents-using-the-web-service-api

Konvertera ett Microsoft Word-dokument till ett PDF-dokument med hjälp av API:t Generate PDF (webbtjänst):

Se även

Sammanfattning av steg

Anropa AEM Forms med MTOM

Anropa AEM Forms med SwaRef

Konvertera HTML-dokument till PDF-dokument converting-html-documents-to-pdf-documents

I det här avsnittet beskrivs hur du kan använda Generate PDF API för att programmässigt konvertera HTML-dokument till PDF-dokument.

Sammanfattning av steg summary_of_steps-1

Så här konverterar du ett HTML-dokument till ett PDF-dokument:

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa en Generate PDF-klient

Innan du programmässigt kan utföra en Generate PDF-åtgärd måste du skapa en Generate PDF-tjänstklient. Om du använder Java API skapar du ett GeneratePdfServiceClient-objekt. Om du använder webbtjänstens API skapar du en GeneratePDFServiceService.

Hämta HTML-innehåll som ska konverteras till ett PDF-dokument

Referera till HTML-innehåll som du vill konvertera till ett PDF-dokument. Du kan referera till HTML-innehåll som en HTML-fil eller HTML-innehåll som är tillgängligt via en URL.

Konvertera HTML-innehåll till ett PDF-dokument

När du har skapat tjänstklienten kan du anropa lämplig åtgärd för att skapa PDF. Den här åtgärden kräver information om dokumentet som ska konverteras, inklusive sökvägen till måldokumentet.

Hämta resultaten

När HTML-innehållet har konverterats till ett PDF-dokument kan du hämta resultatet och spara PDF-dokumentet.

Se även

Konvertera HTML-innehåll till ett PDF-dokument med Java API

Konvertera HTML-innehåll till ett PDF-dokument med hjälp av webbtjänstens API

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Generera snabbstart för PDF Service API

Konvertera HTML-innehåll till ett PDF-dokument med Java API convert-html-content-to-a-pdf-document-using-the-java-api

Konvertera ett HTML-dokument till ett PDF-dokument med hjälp av API:t Generate PDF (Java):

Se även

Konvertera HTML-dokument till PDF-dokument

Snabbstart (SOAP): Konvertera HTML-innehåll till ett PDF-dokument med Java API

Snabbstart (SOAP): Konvertera HTML-innehåll till ett PDF-dokument med Java API

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Konvertera HTML-innehåll till ett PDF-dokument med hjälp av webbtjänstens API convert-html-content-to-a-pdf-document-using-the-web-service-api

Konvertera HTML-innehåll till ett PDF-dokument med hjälp av API:t Generate PDF (webbtjänst):

Se även

Konvertera HTML-dokument till PDF-dokument

Anropa AEM Forms med MTOM

Anropa AEM Forms med SwaRef

Konvertera PDF-dokument till andra format än bildformat converting-pdf-documents-to-non-image-formats

I det här avsnittet beskrivs hur du kan använda Generate PDF Java API och webbtjänstens API för att programmässigt konvertera ett PDF-dokument till en RTF-fil, som är ett exempel på ett icke-bildformat. Andra format som inte är bildformat är HTML, text, DOC och EPS. När du konverterar ett PDF-dokument till RTF-format bör du kontrollera att PDF-dokumentet inte innehåller några formulärelement, t.ex. en skicka-knapp. Formulärelement konverteras inte.

Sammanfattning av steg summary_of_steps-2

Så här konverterar du ett PDF-dokument till någon av de typer som stöds:

Inkludera projektfiler

Inkludera nödvändiga filer i utvecklingsprojektet. Om du skapar ett klientprogram med Java, inkluderar du de JAR-filer som behövs. Om du använder webbtjänster måste du inkludera proxyfilerna.

Skapa en Generate PDF-klient

Innan du programmässigt kan utföra en Generate PDF-åtgärd måste du skapa en Generate PDF-tjänstklient. Om du använder Java API skapar du ett GeneratePdfServiceClient-objekt. Om du använder webbtjänstens API skapar du ett GeneratePDFServiceService-objekt.

Hämta PDF-dokumentet för konvertering

Hämta dokumentet PDF för konvertering till ett format som inte är en bild.

Konvertera PDF-dokumentet

När du har skapat tjänstklienten kan du starta exportåtgärden i PDF. Den här åtgärden kräver information om dokumentet som ska konverteras, inklusive sökvägen till måldokumentet.

Spara den konverterade filen

Spara den konverterade filen. Om du till exempel konverterar ett PDF-dokument till en RTF-fil sparar du det konverterade dokumentet till en RTF-fil.

Se även

Konvertera ett PDF-dokument till en RTF-fil med Java API

Konvertera ett PDF-dokument till en RTF-fil med webbtjänstens API

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Generera snabbstart för PDF Service API

Konvertera ett PDF-dokument till en RTF-fil med Java API convert-a-pdf-document-to-a-rtf-file-using-the-java-api

Konvertera ett PDF-dokument till en RTF-fil med hjälp av Java-API:t (Generate PDF):

Se även

Sammanfattning av steg

Snabbstart (SOAP): Konvertera HTML-innehåll till ett PDF-dokument med Java API

Inkludera AEM Forms Java-biblioteksfiler

Ange anslutningsegenskaper

Konvertera ett PDF-dokument till en RTF-fil med webbtjänstens API convert-a-pdf-document-to-a-rtf-file-using-the-web-service-api

Konvertera ett PDF-dokument till en RTF-fil med hjälp av API:t för Generate PDF (webbtjänst):

Se även

Sammanfattning av steg

Anropa AEM Forms med MTOM

Anropa AEM Forms med SwaRef

Stöd för fler filformat adding-support-for-additional-native-file-formats

I det här avsnittet beskrivs hur du lägger till stöd för fler inbyggda filformat. Här finns en översikt över interaktionen mellan Generate PDF-tjänsten och de inbyggda program som den här tjänsten använder för att konvertera inbyggda filformat till PDF.

I det här avsnittet förklaras även följande:

Komponentinteraktioner component-interactions

Tjänsten Generate PDF konverterar de ursprungliga filformaten genom att anropa det program som är associerat med filformatet och sedan interagera med programmet för att skriva ut dokumentet med standardskrivaren. Standardskrivaren måste ställas in som Adobe PDF-skrivare.

Den här bilden visar vilka komponenter och drivrutiner som har inbyggt programstöd. Där omnämns också XML-grammatiken som påverkar interaktionen.

Komponentinteraktioner för intern filkonvertering

I det här dokumentet används termen ursprungligt program för att ange vilket program som används för att skapa ett ursprungligt filformat, t.ex. Microsoft Word.

AppMon är en företagskomponent som interagerar med ett systemspecifikt program på samma sätt som en användare navigerar genom de dialogrutor som visas i det programmet. Den XML-grammatik som används av AppMon för att instruera ett program, som Microsoft Word, att öppna och skriva ut en fil omfattar följande sekventiella uppgifter:

AppMon använder Win32-standardAPI:er för att interagera med program från tredje part för att överföra gränssnittshändelser som tangenttryckningar och musklick, vilket är användbart för att styra programmen för att skapa PDF-filer från dem.

På grund av en begränsning med dessa Win32 API:er kan AppMon inte skicka dessa UI-händelser till vissa specifika typer av fönster, till exempel flytande menyrader (som finns i vissa program som TextPad) och vissa typer av dialogrutor vars innehåll inte kan hämtas med Win32 API:er.

Det är enkelt att se en flytande menyrad, men det är inte säkert att det går att identifiera särskilda typer av dialogrutor bara genom visuell kontroll. Du behöver ett tredjepartsprogram som Microsoft Spy++ (en del av Microsoft Visual C+±utvecklingsmiljön) eller dess motsvarande WinID (som kan laddas ned kostnadsfritt från https://www.dennisbabkin.com/php/download.php?what=WinID) för att undersöka en dialogruta för att avgöra om AppMon kan interagera med den med Win32-standardprogrammeringsgränssnitt.

Om WinID kan extrahera dialoginnehåll som text, underfönster, fönsterklass-ID och så vidare, kan AppMon också göra det.

I den här tabellen visas vilken typ av information som används vid utskrift av originalfilformat.

Om skript- och dialogrute-XML-filer about-the-script-and-dialog-xml-files

Skript-XML-filer instruerar Generate PDF att navigera i programdialogrutor på samma sätt som en användare navigerar i programdialogrutorna. Skript-XML-filer instruerar även Generate PDF att svara på dialogrutor genom att utföra åtgärder som att trycka på knappar, markera eller avmarkera kryssrutor eller välja menyalternativ.

XML-filer i dialogrutor svarar däremot bara på dialogrutor med samma typ av åtgärder som används i XML-filer i skript.

Dialogruta och terminologi för fönsterelement dialog-box-and-window-element-terminology

I det här avsnittet och i nästa avsnitt används olika terminologi för dialogrutor och de komponenter de innehåller, beroende på vilket perspektiv som beskrivs. Dialogrutekomponenter är objekt som knappar, fält och kombinationsrutor.

När det här avsnittet och nästa avsnitt beskriver dialogrutor och deras komponenter ur användarens perspektiv, används termer som dialogruta, knapp, fält och kombinationsruta.

När det här avsnittet och nästa avsnitt beskriver dialogrutor och deras komponenter utifrån deras interna representation används termen fönsterelement. Den interna representationen av fönsterelement är en hierarki, där varje fönsterelementinstans identifieras med etiketter. Fönsterelementinstansen beskriver också dess fysiska egenskaper och beteende.

Från användarens perspektiv visar dialogrutorna och deras komponenter olika beteenden, där vissa dialogruteelement är dolda tills de aktiveras. Från ett internt representationsperspektiv finns det ingen sådan beteendefråga. Den interna representationen av en dialogruta liknar till exempel komponenterna i den, med undantag för att komponenterna är kapslade i dialogrutan.

I det här avsnittet beskrivs XML-element som innehåller instruktioner för AppMon. Dessa element har namn som elementet dialog och elementet window. I det här dokumentet används ett teckensnitt med fast teckenbredd för att skilja på XML-element. Elementet dialog identifierar en dialogruta som en XML-skriptfil kan orsaka att den visas, antingen avsiktligt eller oavsiktligt. Elementet window identifierar ett fönsterelement (dialogruta eller komponenter i en dialogruta).

Hierarki hierarchy

Bilden visar hierarkin för skript och dialogrute-XML. En skript-XML-fil överensstämmer med skriptet.xsd-schemat, som i XML-bemärkelse inkluderar window.xsd-schemat. På samma sätt överensstämmer en dialogrute-XML-fil med dialogs.xsd-schemat, som även innehåller window.xsd-schemat.

Hierarki för skript och dialogrute-XML

Skript-XML-filer script-xml-files

En skript-XML-fil anger en serie steg som instruerar det ursprungliga programmet att navigera till vissa fönsterelement och sedan skicka svar till dessa element. De flesta svar är text eller tangenttryckningar som motsvarar de indata en användare skulle ge till ett fält, en kombinationsruta eller en knapp i motsvarande dialogruta.

Avsikten med Generate PDF-tjänstens stöd för skript-XML-filer är att instruera ett program att skriva ut en intern fil. Skript-XML-filer kan dock användas för att utföra alla åtgärder som en användare kan utföra när han eller hon interagerar med programmets dialogrutor.

Stegen i en skript-XML-fil körs i ordning, utan möjlighet till förgreningar. Det enda villkorstest som stöds är timeout/retry, vilket gör att ett skript avslutas om ett steg inte slutförs korrekt inom en viss tidsperiod och efter ett visst antal försök.

Förutom att steg är sekventiella utförs även instruktionerna i ett steg i ordning. Se till att stegen och instruktionerna återspeglar den ordning i vilken en användare utför samma steg.

Varje steg i en skript-XML-fil identifierar det window-element som förväntas visas om instruktionerna för steget har utförts. Om en oväntad dialogruta visas när du kör ett skriptsteg söker tjänsten Generate PDF igenom XML-filer i dialogrutan enligt beskrivningen i nästa avsnitt.

Dialog-XML-filer dialog-xml-files

När du kör inbyggda program visas olika dialogrutor, som visas oavsett om de inbyggda programmen är i synligt eller osynligt läge. Dialogrutorna kan genereras av operativsystemet eller av själva programmet. När inbyggda program körs under kontroll av tjänsten Generate PDF visas dialogrutorna för system och inbyggda program i ett osynligt fönster.

En dialogrute-XML-fil anger hur tjänsten Generate PDF svarar på systemdialogrutor eller systemspecifika programdialogrutor. I dialogrutans XML-filer kan tjänsten Generate PDF svara på dialogrutor som inte efterfrågas på ett sätt som underlättar konverteringsprocessen.

När systemet eller det inbyggda programmet visar en dialogruta som inte hanteras av den XML-fil som för närvarande körs, söker tjänsten Generate PDF igenom XML-filer i dialogrutan i den här ordningen och stoppar när en matchning hittas:

Om tjänsten Generate PDF hittar en matchning för dialogrutan stängs den av genom att den skickas med tangentbordet eller någon annan åtgärd som har angetts för dialogrutan. Om instruktionerna för dialogrutan anger ett avbrottsmeddelande avbryter tjänsten Generate PDF det jobb som körs och genererar ett felmeddelande. Ett sådant abort-meddelande skulle anges i elementet abortMessage i skriptets XML-grammatik.

Om tjänsten Generate PDF påträffar en dialogruta som inte beskrivs i någon av de tidigare listade filerna, infogar tjänsten Generate PDF dialogrutans bildtext i loggfilsposten. Tidsgränsen för det jobb som körs för närvarande har uppnåtts. Du kan sedan använda informationen i loggfilen för att skapa nya instruktioner i XML-filen för ytterligare dialogrutor för det ursprungliga programmet.

Lägga till eller ändra stöd för ett ursprungligt filformat adding-or-modifying-support-for-a-native-file-format

I det här avsnittet beskrivs de åtgärder du måste utföra för att stödja andra filformat eller för att ändra stödet för ett filformat som redan stöds.

Innan du kan lägga till eller ändra support måste du utföra följande åtgärder.

Välja ett verktyg för att identifiera fönsterelement choosing-a-tool-for-identifying-window-elements

Dialogrutan och skriptets XML-filer kräver att du identifierar det fönsterelement (dialogruta, fält eller annan dialogrutekomponent) som dialogrutan eller skriptelementet svarar på. När ett skript till exempel anropar en meny för ett inbyggt program, måste skriptet identifiera det fönsterelement på den menyn som tangenttryckningar eller en åtgärd ska tillämpas på.

Du kan enkelt identifiera en dialogruta med den bildtext som visas i namnlisten. Du måste dock använda ett verktyg som Microsoft Spy++ för att identifiera element på lägre nivå i fönstret. Fönsterelementen på den lägre nivån kan identifieras med hjälp av en mängd olika attribut, som inte är uppenbara. Dessutom kan varje inbyggt program identifiera sitt fönsterelement på olika sätt. Det finns därför flera sätt att identifiera ett fönsterelement. Här är den föreslagna ordningen för att överväga identifiering av fönsterelement:

Alla eller en kombination av dessa tre attribut kan användas för att identifiera ett fönster.

Om attributen inte kan identifiera en bildtext kan du i stället identifiera ett fönsterelement genom att använda dess index i förhållande till dess överordnade element. Ett index anger fönsterelementets position i förhållande till dess element på samma nivå. Index är ofta det enda sättet att identifiera kombinationsrutor.

Tänk på följande:

Om du tänker arbeta med dialogruta- eller skript-XML-filer bör du installera programmet Microsoft Spy++.

Uppackning av dialogrute- och skriptfiler unpackaging-the-dialog-and-script-files

Dialogrutan och skriptfilerna finns i filen appmondata.jar. Innan du kan ändra någon av dessa filer eller lägga till nya skript- eller dialogfiler måste du packa upp den här JAR-filen. Anta till exempel att du vill lägga till stöd för programmet EditPlus. Du skapar två XML-filer med namnen appmon.editplus.script.en_US.xml och appmon.editplus.script.addition.en_US.xml. Dessa XML-skript måste läggas till i filen adobe-appmondata.jar på två platser, enligt vad som anges nedan:

När du har lagt till dessa XML-filer i filen adobe-appmondata.jar måste du distribuera om komponenten GeneratePDF. Så här lägger du till dialogrute- och skript-XML-filer i filen adobe-appmondata.jar:

Så här distribuerar du om komponenten GeneratePDF

Skapa eller ändra en skript-XML-fil för ett internt program creating-or-modifying-a-script-xml-file-for-a-native-application

Om du vill dirigera filer till ett nytt originalprogram måste du skapa en skript-XML-fil för det programmet. Om du vill ändra hur tjänsten Generate PDF interagerar med ett program som redan stöds måste du ändra skriptet för det programmet.

Skriptet innehåller instruktioner som navigerar genom det inbyggda programmets fönsterelement och som ger specifika svar på dessa element. Filen som innehåller den här informationen är appmon.[appname].script.[locale].xml. Ett exempel är appmon.notepad.script.en_US.xml.

Identifiera steg som skriptet måste köra identifying-steps-the-script-must-execute

Använd det inbyggda programmet för att bestämma vilka fönsterelement du måste navigera i och vilka svar du måste utföra för att skriva ut dokumentet. Lägg märke till de dialogrutor som är resultatet av ett svar. Stegen ser ut ungefär så här:

Identifiera dialogrutorna som anges i bildtextattribut identifying-the-dialogs-specified-in-caption-attributes

Använd Microsoft Spy++ för att hämta identiteterna för fönsterelementegenskaper i det ursprungliga programmet. Du måste ha dessa identiteter för att kunna skriva skript.

Använda reguljära uttryck i bildtextattribut using-regular-expressions-in-caption-attributes

Du kan använda reguljära uttryck i beskrivningsspecifikationer. Tjänsten Generate PDF använder klassen java.util.regex.Matcher som stöd för reguljära uttryck. Verktyget stöder de reguljära uttryck som beskrivs i java.util.regex.Pattern.

Reguljärt uttryck för filnamnet som är angivet som Anteckningar i banderollen Anteckningar

 <!-- The regular expression ".*Notepad" means any number of non-terminating characters followed by Notepad. -->
 <step>
     <expectedWindow>
         <window caption=".*Notepad"/>
     </expectedWindow>
 </step>

Reguljärt uttryck som skiljer Skriv ut från Utskriftsinställningar

 <!-- This regular expression differentiates the Print dialog box from the Print Setup dialog box. The "^" specifies the beginning of the line, and the "$" specifies the end of the line. -->
 <windowList>
     <window controlID="0x01" caption="^Print$" action="press"/>
 </windowList>

Ordna elementen window och windowList ordering-the-window-and-windowlist-elements

Ordna elementen window och windowList enligt följande:

Ordna fönsterelement i en dialogrutefil

 <!-- The caption attribute in the following window element is 40 characters long. It is the longest caption in this example, so its parent window element appears before the others. -->
 <window caption="Unexpected Failure in DebugActiveProcess">
     <…>
 </window>

 <!-- Caption length is 33 characters. -->
 <window caption="Adobe Acrobat - License Agreement">
     <…>
 </window>

 <!-- Caption length is 33 characters. -->
 <window caption="Microsoft Visual.*Runtime Library">
     <…>
 </window>

 <!-- The caption attribute in the following window element is 28 characters long. It is the shortest caption in this example, so its parent window element appears after the others. -->
 <window caption="Adobe Acrobat - Registration">
     <…>
 </window>

Ordna fönsterelement i ett windowList-element

 <!-- The caption attribute in the following indexes element is 56 characters long. It is the longest caption in this example, so its parent window element appears before the others. -->
 <windowList>
     <window caption="Can&apos;t exit design mode because.* cannot be created"/>
     <window className="Button" caption="OK" action="press"/>
 </windowList>
 <windowList>
     <window caption="Do you want to continue loading the project?"/>
     <window className="Button" caption="No" action="press"/>
 </windowList>
 <windowList>
     <window caption="The macros in this project are disabled"/>
     <window className="Button" caption="OK" action="press"/>
 </windowList>

Skapa eller ändra ytterligare en dialogrute-XML-fil för ett ursprungligt program creating-or-modifying-an-additional-dialog-xml-file-for-a-native-application

Om du skapar ett skript för ett internt program som inte stöds tidigare, måste du också skapa ytterligare en dialogrute-XML-fil för det programmet. Alla inbyggda program som AppMon använder får bara ha en ytterligare dialogrute-XML-fil. Ytterligare dialogrute-XML-fil krävs även om inga oombedda dialogrutor förväntas. Den extra dialogrutan måste ha minst ett window-element, även om det window-elementet bara är en platshållare.

Du kan också ändra XML-filen för ytterligare dialogrutor för ett internt program för följande syften:

Filnamnet som identifierar ytterligare en dialogXML-fil är appmon.[appname].addition.[locale].xml. Ett exempel är appmon.excel.addition.en_US.xml.

Namnet på XML-filen för ytterligare dialogrutor måste ha formatet appmon.[applicationname].addition.[locale].xml, där applicationName måste matcha programnamnet som används i XML-konfigurationsfilen och i skriptet exakt.

Ordna windowList element som visas som underordnade i ett window-element. (Se Beställa element för fönster och windowList.)

Ändra den allmänna XML-filen i dialogrutan modifying-the-general-dialog-xml-file

Du kan ändra den allmänna XML-filen i dialogrutan för att svara på dialogrutor som genereras av systemet eller för att svara på dialogrutor som är gemensamma för flera program.

Lägga till en filtypspost i XML-konfigurationsfilen adding-a-filetype-entry-in-the-xml-configuration-file

I den här proceduren beskrivs hur du uppdaterar tjänstkonfigurationsfilen Generate PDF för att associera filtyper med systemspecifika program. Om du vill uppdatera den här konfigurationsfilen måste du använda administrationskonsolen för att exportera konfigurationsdata till en fil. Standardfilnamnet för konfigurationsdata är native2pdfconfig.xml.

Uppdatera tjänstkonfigurationsfilen Generate PDF

I det här exemplet ändrades standardkonfigurationsdata som medföljde tjänsten Generate PDF så att Anteckningar (inte Microsoft Word) skulle användas för att bearbeta filer med filnamnstillägget .txt. Innan den här ändringen utfördes specificerades Microsoft Word som det ursprungliga program som ska bearbeta sådana filer.

Ändringar för att dirigera textfiler till Notepad (native2pdfconfig.xml)

 <filetype-settings>

 <!-- Some native app file types were omitted for brevity. -->
 <!-- The following GenericApp element specifies Notepad as the native application that should be used to process files that have a txt file name extension. -->
             <GenericApp
                 extensions="txt"
                 name="Notepad" displayName=".*Notepad"/>
             <GenericApp
                 extensions="wpd"
                 name="WordPerfect" displayName="Corel WordPerfect"/>
             <GenericApp extensions="pmd,pm6,p65,pm"
                 name="PageMaker" displayName="Adobe PageMaker"/>
             <GenericApp extensions="fm"
                 name="FrameMaker" displayName="Adobe FrameMaker"/>
             <GenericApp extensions="psd"
                 name="Photoshop" displayName="Adobe Photoshop"/>
         </settings>
     </filetype-settings>

Skapa en miljövariabel för att hitta det inbyggda programmet creating-an-environment-variable-to-locate-the-native-application

Skapa en miljövariabel som anger platsen för det interna programmets körbara fil. Variabeln måste använda formatet [applicationname]_PATH, där applicationName måste matcha programnamnet som används i XML-konfigurationsfilen och i skriptet, och där sökvägen innehåller sökvägen till den körbara filen inom citattecken. Ett exempel på en sådan miljövariabel är Photoshop_PATH.

När du har skapat den nya systemvariabeln måste du starta om servern som tjänsten Generate PDF är distribuerad på.

Skapa en systemvariabel i Windows XP-miljön

Skapa en systemvariabel från kommandoraden

XML-filer xml-files

AEM Forms innehåller XML-exempelfiler som gör att tjänsten Generate PDF kan använda Anteckningar för att bearbeta filer med filnamnstillägget .txt. Den här koden ingår i det här avsnittet. Dessutom måste du göra de andra ändringarna som beskrivs i det här avsnittet.

XML-fil för ytterligare dialogrutor additional-dialog-xml-file

Det här exemplet innehåller ytterligare dialogrutor för programmet Anteckningar. De här dialogrutorna kan läggas till de som anges av tjänsten Generate PDF.

Dialogrutor för anteckningsblock(appmon.notepad.addition.en_US.xml)

 <dialogs app="Notepad" locale="en_US" version="7.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="dialogs.xsd">
     <window caption="Caption Title">
         <windowList>
             <window className="Button" caption="OK" action="press"/>
         </windowList>
     </window>
 </dialogs>

Skript-XML-fil script-xml-file

I det här exemplet anges hur tjänsten Generate PDF ska samverka med Anteckningar för att skriva ut filer med Adobe PDF-skrivaren.

Anteckningsskript, XML-fil (appmon.notepad.script.en_US.xml)

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!--
*
* ADOBE CONFIDENTIAL
* ___________________
* Copyright 2004 - 2005 Adobe Systems Incorporated
* All Rights Reserved.
*
* NOTICE:  All information contained herein is, and remains
* the property of Adobe Systems Incorporated and its suppliers,
* if any.  The intellectual and technical concepts contained
* herein are proprietary to Adobe Systems Incorporated and its
* suppliers and may be covered by U.S. and Foreign Patents,
* patents in process, and are protected by trade secret or copyright law.
* Dissemination of this information or reproduction of this material
* is strictly forbidden unless prior written permission is obtained
* from Adobe Systems Incorporated.
*-->

<!-- This file automates printing of text files via notepad to Adobe PDF printer. To see the complete hierarchy Adobe recommends using the Microsoft Spy++ which details the properties of windows necessary to write scripts. In this sample there are total of eight steps-->

<application name="Notepad" version="9.0" locale="en_US" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="scripts.xsd">

    <!-- In this step we wait for the application window to appear -->
    <step>
        <expectedWindow>
            <window caption=".*Notepad"/>
        </expectedWindow>
    </step>

    <!-- In this step, we acquire the application window and send File->Open menu bar, menu item commands and the expectation is the windows Open dialog-->
    <step>
        <acquiredWindow>
            <window caption=".*Notepad">
                <virtualInput>
                    <menuBar>
                        <selection>
                            <name>File</name>
                        </selection>
                        <selection>
                            <name>Open...</name>
                        </selection>
                    </menuBar>
                </virtualInput>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Open"/>
        </expectedWindow>
    </step>

    <!-- In this step, we acquire the Open window and then select the 'Edit' widget and input the source path followed by clicking on the 'Open' button . The expectation of this 'action' is that the Open dialog will disappear -->
    <step>
        <acquiredWindow>
            <window caption="Open">
                <windowList>
                    <window className="ComboBoxEx32">
                        <windowList>
                            <window className="ComboBox">
                                <windowList>
                                <window className="Edit" action="inputSourcePath"/>
                                </windowList>
                            </window>
                        </windowList>
                    </window>
                </windowList>
                <windowList>
                    <window className="Button" caption="Open" action="press"/>
                </windowList>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Open" action="disappear"/>
        </expectedWindow>
        <pause value="30"/>
    </step>

    <!-- In this step, we acquire the application window and send File->Print menu bar, menu item commands and the expectation is the windows Print dialog-->
    <step>
        <acquiredWindow>
            <window caption=".*Notepad">
                <virtualInput>
                    <menuBar>
                        <selection>
                            <name>File</name>
                        </selection>
                        <selection>
                            <name>Print...</name>
                        </selection>
                    </menuBar>
                </virtualInput>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Print">
        </window>
        </expectedWindow>
    </step>

    <!-- In this step, we acquire the Print dialog and click the 'Preferences' button and the expected window in this case is the dialog with the caption '"Printing Preferences' -->
    <step>
        <acquiredWindow>
            <window caption="Print">
                <windowList>
                    <window caption="General">
                        <windowList>
                            <window className="Button" caption="Preferences" action="press"/>
                        </windowList>
                    </window>
                </windowList>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Printing Preferences"/>
        </expectedWindow>
    </step>

    <!-- In this step, we acquire the dialog "Printing Preferences' and select the combo box which is the 10th child of window with caption '"Adobe PDF Settings' and select the first index. (Note: All indeces start with 0.) Besides this we uncheck the box which has the caption '"View Adobe PDF results' and we click the button OK. The expectation is that 'Printing Preferences' dialog disappears. -->
    <step>
        <acquiredWindow>
            <window caption="Printing Preferences">
                <windowList>
                    <window caption="Adobe PDF Settings">
                        <windowList>
                            <window className="Button" caption="View Adobe PDF results" action="uncheck"/>
                        </windowList>
                        <windowList>
                            <window className="Button" caption="Ask to Replace existing PDF file" action="uncheck"/>
                        </windowList>
                    </window>
                </windowList>
                <windowList>
                    <window className="Button" caption="OK" action="press"/>
                </windowList>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Printing Preferences" action="disappear"/>
        </expectedWindow>
    </step>

    <!-- In this step, we acquire the 'Print' dialog and click the Print button. The expectation is that the dialog with caption 'Print' disappears. In this case we use the regular expression '^Print$' for specifying the caption given there could be multiple dialogs with caption that includes the word Print. -->
    <step>
        <acquiredWindow>
            <window caption="Print">
                <windowList>
                    <window caption="General"/>
                    <window className="Button" caption="^Print$" action="press"/>
                </windowList>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Print" action="disappear"/>
        </expectedWindow>
    </step>
    <step>
        <expectedWindow>
            <window caption="Save PDF File As"/>
        </expectedWindow>
    </step>
    <!-- Finally in this step, we acquire the dialog with caption "Save PDF File As" and in the Edit widget type the destination path for the output PDF file and click the Save button. The expectation is that the dialog disappears-->
    <step>
        <acquiredWindow>
            <window caption="Save PDF File As">
                <windowList>
                    <window className="Edit" action="inputDestinationPath"/>
                </windowList>
                <windowList>
                    <window className="Button" caption="Save" action="press"/>
                </windowList>
            </window>
        </acquiredWindow>
        <expectedWindow>
            <window caption="Save PDF File As" action="disappear"/>
        </expectedWindow>
    </step>

    <!-- We can always set a retry count or a maximum time for a step. In case we surpass these limitations, PDF Generator generates this abort message and terminates processing. -->
    <abortMessage msg="15078"/>
</application>