Set up printers for IFbA to be able to select paperformats from different printer trays, to define outputtrays and to do duplex printing

1. XDC example to define two different input trays with different paperformats (PCL Format; PS format?)The step-by-step guide describes how a template can be created with two pages that use different paper formats from two different input trays ofthe printer 

A. Overview of necessary steps:

Adobe Form Template has to be created with two pages and the necessary paper type for each page Check the specific printer manual for the available tray numbers and select the appropriate tray for the desired mediumHow to identify the printer specific XDC File on the Adobe serverHow to get the Adobe XDC Editor to modify the XDC FileCreate/Verify the current stock/tray number mappings in the XDC file and upload the XDC file to the ADS ServerConfigure the printer and a device type for the printer in the ABAP SystemIn Transaction SPAD evaluate, which device Type is used for your output device (printer).Map the XDC File to a device Type in ABAP:Test your configuration with a Test Program

B. Configuration steps in detail:

1. Create a Adobe Form Template with two pages and the paper types 'a4' and'A4small'.

The attached sample Adobe Form uses  Paper Type 'A4' and 'A4 small' for the master pages one and two. The following screenshotTemplateshows the page1 with paper type 'A4'.

Verify after the paper types are selected in the Designer with a switch to the 'XML Source' Tab in the Designer that the followingXML Elements are part of the Template.

<pageArea id="Page1" name="page1"><medium long="297mm" short="210mm" />stock="a4"<pageArea id="Page2" name="page2"><medium long="297mm" short="210mm" "/>stock="a4mall

Optional: The definition of new paper types can be done in the Designer.xdc file located at:%ProgramFiles%\Adobe\<DesignerVersion>\Designer.xdc

The paper types 'a4' and 'a4Small' are already shipped with the Designer and are part of the Designer.xdc. Both paper types are represented withthe following XML elements:

<medium stock="a4" short="210mm" long="297mm"/><medium stock="a4Small" short="210mm" long="297mm"/>

Newly defined Papers Types can be added, if for example the following definition is added to the Designer.xdc

<medium stock=" " short="210mm" long="297mm"/>myMediumStock

To display the new paper Type in the Designer DropDownlistBox the mediumstocklist.xml must be modified in the language specific version ofthe Designer.For the German version the element <stock name="myMediumStock" desc=" "/> must be added to themyMediumStockDescriptionMediumStockList.xmllocated in directory: %ProgramFiles%\Adobe\<DesignerVersion>\DE\MediumStockList.xml.

With the description the paper type 'myMediumStock' will appear as 'myMediumStockDescription' in the DropDownlistBox of the Designer for theselection of the paper type.

Further Details regarding XDC File configuration are available in the .Adobe LiveCycle Documentation

2. Check the specific printer manual for the available tray numbers and selectthe appropriate tray for the desired medium

Please note that the Tray Settings are different for the output formats PCL or PS. In this example we are using the printer 'HP Laserjet M5035MFP'. The following documentation describes for each printer language (PS, PCL5, PCL 6) which Tray Numbers are mapped to thecorresponding media source commands. The media source commands are needed in the next steps for creating/adapting the Input Tray mappingin the XDC Files.

The Tray Settings are described at page 297 of the Printer Guide for HP Laserjet M5035MFP. .http://bizsupport2.austin.hp.com/bc/docs/support/SupportManual/c00767053/c00767053.pdf

If you want to use Tray 4 for the PostScript format you have to use '4' for the Media position and for Tray 5 you need '38' (see Table below).

3. How to identify the printer specific XDC File (several XDC files are alreadydelivered)

SAP ships several XDC Files for common printers and printer languages already that can be used for customizing a XDC file. The shipped XDCFiles can be found at the NetWeaver (ADS) Server at:   

<instance>\SYS\global\AdobeDocumentServices\lib\

In this example we are using a HP Printer with support for PCL5 (Black and White printers are using for PCL the XDC File 'hppcl5e.xdc') and forPost Script the XDC file 'ps_plain.xdc'. After identifying the right XDC fileit is strongly recommended to copy the file an adapt the file name. The next step is to modify the XDC File with XDC Editor.

Further information is available in the XDC Editor Help Documentation (Todo: Link).

4. How to get the Adobe XDC Editor

The Adobe XDC Editor is an Eclipse based editor that is available to download from the SAP web site located:  (Related Resources -> Downloads -> XDC Editor) and have to be used to adapt yourhttp://scn.sap.com/community/interactive-forms-by-adobe

XDC file.

Further information is available in the XDC Editor Help Documentation (Todo: Link).

5. Create the Tray mappings for a medium type in the XDC file and upload theXDC file to the ADS Server. 

The next step is to create the mappings for the Input Trays 4 and 5 for the Medium Types 'A4' and 'A4Small'. In Eclipse edit your customized XDCfile (in our example my_ps_plain.xdc file) via the editor.

Goto File -> Open File and select your copied XDC file. Add the Trays in section 'Input Trays' and add the mappings in the Secion 'Medium toTray Mappings' like in the screenshot below.

The above settings are dependent on the postscript level and are done for PostScript 3 Level. Check in your Printer settings which Post Scriptlevel is supported. Dependent on the supported Post Script Level of your printer you should select the coresponding XDC File for that PostScriptLevel. Select  Tab 'Printer Capabilites' in the XDC Editor to check which PostScript Level is defined in the current XDC File (see screenshotbelow).

 

Note: For Formats the Tag DeferredMediaSelection must be set to 'false', so that the customized XDC file will be applied otherwisePostScriptprinter configuration will decide which medium will be selected.

Changing the DeferreMediaSelection can be done in the XDC Editor on 'Sequences' Tab.

Copy your modified XDC File onto the ADS Server at the same directory next to the other XDC Files. Path:<instance>\SYS\global\AdobeDocumentServices\lib\.

Further information is available in the XDC Editor Help Documentation (Todo: Link).

6. Configure the printer and a device type for the printer in the ABAP System

In Transaction SPAD evaluate which device type is used for your output device (printer). Then copy the device type by putting the cursor in thecorresponding line of the list and choosing 'Device type->Create using template' (short key F5) from the menu.

   

Then copy the device (= printer) and choose the new device type (ZPOSTOH in the example below) for the new device. 

7. Map the XDC File to your printer specific device Type in ABAP

Start Transcation SA38 in your ABAP system and start report 'RSPO0022'. Choose Action 'Create/Change XDC Entry' and choose the deviceType identified for your printer in SPAD.It is also important to select the target print format (here PS for PostScript). Press F8 and upload your copied and adapted XDC File in thefollowing screen. Execute the program to create the mapping.

 

8. Test your configuration with the test report: FP_TEST_03

To test your configuration you can run report FP_TEST_03. The report needs the template name (here: ZGW_TEST_INPUT_TRAY) and the ADSConnection (here: ADS_Bommel).Press F8 to execute the report.

  At the following screen enter your device type where you mapped the XDC File (here: T540OH) and select 'Print Immediately'  and 'New Spool

request'.'  Click on the 'Print' Button. Start Transaction SP02 to get an overview of your spool requests and see the print status of your print job. thesreenshot below shows that the coresponding spool request no. 19112is currently in process. 

  

9. Troubleshooting:

Problem: Paper is not selected from the configured Tray in PostScript Format. Please check, if the PostScript Level of the XDC is the same assupported from your printer.

10. Sample XDC files for and for an HP PrinterPCL PostScript

2. XDC-Example to define a specific Output Tray

3. XDC-Example to define dublex printing