Conversion PDF vers PDFA/en

<languages />
==Introduction==
The command MAPPDFA converts a PDF to a PDF/A (Compatible PDF/A-1b, PDF/A-2b, PDF/A-3b)
==Prerequistes==
This command is not included with the basic installation. A separated install package needed to be installed.
When executing MAPPDFA, the MAPPING library must be online. (edtlibl)

It is also recommanded not to have annotations and UTF16BE fonts inside the input PDF.

The libstdc++ library must be installed on the server prior to installing MAPPDFA

==Installation==
The setup in made of a SAVF containing the resources needed, the program and the MAPPDFA command. it needs to be restored in the QTEMP lib.

RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(QGPL/MAPPDFA) RSTLIB(QTEMP)         

Then Execute the install :  INSTALL + F4

Library destination : Lib where you will install the prog and command<br>
Mapping Path : IFS mapping path folder (same path as the one defined in your configuration of your Mapping env Example : /home/mapping)


The program is then installed in the destination lib as well as the resources in the xxx/mapping/bin and xxx/mapping/conf folders

==Screen==
The MAPPDFA command has 5 different parameters (In '''bold''' the default values) :

#Infile : Input file
#Outfile : Output file
#Type : PDFA type (PDFA1, '''PDFA2''', PDFA3)
#Quality : Compression rate when vectorial image mode for the licensed fonts ('''*HIGH''', *MEDIUM, *LOW)
#Licensed fonts : Way to manage licensed fonts ('''*NONE''', *ALL, *LIST)
##<nowiki>*NONE</nowiki> : Default valeur, if a licensed fonts restriction occurs, MAPPDFA will generate an error message, which could be caught by the gserror.txt config file to switch to vectorial mode.
##<nowiki>*ALL</nowiki> : With this mode, all licensed fonts restrictions will be ignore, MAPPDFA will then embbed all the fonts and no error message will occur.
##<nowiki>*LIST</nowiki> : Use a list of defined fonts in the '''conf/authorized_fonts.txt''' file (encoded in ANSI)
We ignore the licensed font restrictions only for the font listed in this file. MAPPDFA will keep generating error messages for the other non listed fonts, which can be caught by the gserror.txt to switch them to vectorial mode. 

The authorized_fonts.txt file must contain the list of fonts to be authorised (one per line)
The font names to add can be found looking at the stdout log of MAPPDFA

<u>Example</u> : 

<span style="background-color:black;color:#64ff33;">Warning: CFMZCH+DejaVuSans-Bold cannot be embedded because of licensing restrictions</span>

We must add  '''CFMZCH+DejaVuSans-Bold''' (Or just DejaVuSans-Bold in the  conf/authorized_fonts.txt file)

==Settings==
===Introduction===
MAPPDFA allows to catch the error messages and have a special behaviour in the event of use of '''Licensed fonts''' contained in the input PDF file?
It will then be possible to vectorialize the font in image (from MAPPDFA V1.1.0) and specifying a compression rate (from MAPPDFA V1.2.0) or also to force the acceptation of all or certain licensed fonts  (from MAPPDFA V1.3.0). All of this of course with a PDF/A as output.

===Détails===
====Fonts vectorialization====
The Error/Warning messages for which we want to have the fonts vectorized are located in the following file :

xxx/mapping/conf/gserror.txt

Example of its content : 

 cannot be embedded because of licensing restrictions=vectorize_fonts
 A font missing from the input PDF has been substituted=vectorize_fonts


*If we get a error message : cannot be embedded because of licensing restrictions   THEN   we vectorize in the image the fonts.
*If we get a error message : A font missing from the input PDF has been substituted   THEN   we vectorize in the image the fonts.

====Acceptation of the licensed fonts====
It is also possible to force the acceptation of MAPPDFA of the licensed font. To do so, we need to manually create a '''conf/authorized_fonts.txt''' file. MAPPDFA will then ignore the error message of licensed font restriction for the fonts listed in this file. The LICFONTS parameter of the command must be set to *LIST

Here is an content example of this file : 

 CFMZCH+DejaVuSans-Bold<br>

*If we get tge error message : CFMZCH+DejaVuSans-Bold cannot be embedded because of licensing restrictions   THEN we will force its acceptance and the output PDF will be PDF/A compliant.

==Utilization==
===Example 1 - Conversion of a simple pdf to  PDFA/1-b rejecting all the licensed fonts===
'''Warning''': If there is one or multiple licensed fonts in the input PDF, the output PDF will then not be PDF/A compliant.

MAPPDFA INFILE('/home/mapping/simple_pdf.pdf') TYPE(*PDFA1) OUTFILE('/home/mapping/pdfa1_pdf.pdf')  

===Example 2 - Convert a simple pdf file to a PDF/A2-b accepting all licensed fonts ===
'''Warning''': If there is one or multiple licensed fonts in the input PDF, the output PDF will be PDF/A compliant.

MAPPDFA INFILE('/home/mapping/simple_pdf.pdf') TYPE(*PDFA2) OUTFILE('/home/mapping/pdfa2_pdf.pdf') LICFONTS(*ALL)   

===Example 3 - Convert a simple pdf file to a PDF/A3-b accepting just one specfic licensed fonts CFMZCH+DejaVuSans-Bold===
<u>Warning</u> : If there are one or multiple fonts other than FMZCH+DejaVuSans-Bold, then the output PDF will come out with vectorial image font if the settings is set as it (Content of gserror.txt file : cannot be embedded because of licensing restrictions=vectorize_fonts)
If this setting is not present, then the output pdf will come out with dots instead of the licensed fonts and the PDF will not be PDF/A compliant.

MAPPDFA INFILE('/home/mapping/simple_pdf.pdf') TYPE(*PDFA3) OUTFILE('/home/mapping/pdfa3_pdf.pdf') LICFONTS(*LIST)

We will then need to have the name of the fonts in the '''conf/authorized_fonts.txt''' file :
 CFMZCH+DejaVuSans-Bold

==Remarks==
*In *LIST mode, if the conf/authorized_fonts.txt file does not exist, the output PDF will be 0KB
* The conf/authorized_fonts.txt file is not included with the setup. If you need, you will need to create it with the ANSI encoding.