Enable PDF Export for Modules
Objective
- To customize a PDF export for selected status reports
Note
- Here, only the general functionality is installed. Optimizations are to be carried out if necessary, e.g.:
- Editing messages
- Variable input of export path, file name, module variant, etc., e.g. in the Global Settings module.
- Handling of the PDF file (e.g. the behavior when the file has already been opened or the possibility to specify another name)
Procedure
- Create a new module that displays the status reports to be printed with a Create PDF button (=selection module)
- The selection of these status reports can be done, e.g., via another module in which status reports are selected by activating a checkbox.
- Create a macro module for this button.
- Adjust the following parameters in this macro:
exp_path
= save path of the created PDF filefile_name
= "name of the created PDF file"REPORT_MOD_ID
=module, which is used for output
(=report module). For status reports, e.g., the MOD009A52 Status Report default moduleREPORT_VARIANT_ID
= required variant of the report moduleDA_PYTHON_ID
= name of the source data area in selection mode
# module settings: Export path. Export file name, output module, and variant to be used, Python ID of the source data area
exp_path = 'Exportpfad'.replace(chr(92),chr(92)+chr(92))
file_name = "Name of the created PDF file"
REPORT_MOD_ID = "Module ID"
REPORT_VARIANT_ID = "Variant ID"
DA_PYTHON_ID = 'Python ID'
#Read out the print settings from the report module
module_customizing_record = ppms.search_record(405, [REPORT_MOD_ID], [25609,25610,1789,2947], True)
page_size = module_customizing_record.paper_format.get_value()
landscape = not bool(module_customizing_record.portrait_format.get_value())
zoom = float(module_customizing_record.zoom_print_preview.get_value())
fit_to_page = bool(module_customizing_record.default_zoom_col.get_value())
#Module objects
macro_module = ppms.get_macro_module()
select_module = macro_module.get_invoker_module()
#Structure of the command for the client
CLIENT_CODE = """
e = get_Env()
pdf_list = e.PdfExportDocumentsList
list = e.PdfExportDocumentsList
page_size = '{page_size}'
landscape = {landscape}
zoom = {zoom}
fit_to_page = {fit_to_page}
for uid in {export_list}:
module = e.ActivePanel.ModuleManager[uid]
doc = module.CreatePdfExportDocument(pageSize=page_size, landscape=landscape, zoom=zoom, fitToPage=fit_to_page)
pdf_list.Add(doc)
e.ActivePanel.ModuleManager
e.GeneratePdfFile(pdf_list, '{exp_path}', '{file_name}')
"""
def get_selected_reports():
export_list =[]
modules_to_close = []
for pr_rec in select_module.get_da(DA_PYTHON_ID).get_records():
pr_id = pr_rec.pr_id.get_raw_value()
main_pr_id = pr_rec.main_pr_id.get_raw_value()
report_id = pr_rec.report_id.get_raw_value()
#Set all filter criteria used in the report module
select_module.set_new_L_var(30, [pr_id])
select_module.set_new_L_var(78, [report_id])
select_module.set_new_L_var(74, [main_pr_id])
#select_module.set_new_L_var(26, [report_id]) - is set in the macro of the status report
#select_module.set_new_L_var(25, [report_id]) - is empty in standard
#Call of the module variant (docked outside the on-screen display)
reporting_module=select_module.open_module(REPORT_MOD_ID,
dock_to_module=select_module.get_uid(),
forced_status=2,
dock_style=3,
dock_proportion=0.001,
foreground=0,
focus=0)
reporting_module.apply_mv_by_id(REPORT_VARIANT_ID)
reporting_module.menu(12)
modules_to_close.append(reporting_module)
#Internal number of the opened module
uid = str(reporting_module.get_uid())
#Add opened modules to the list for PDF interface
export_list.append((uid))
client_call = CLIENT_CODE.format(export_list=export_list, exp_path=exp_path, file_name=file_name,
page_size=page_size, landscape=landscape,
zoom=zoom, fit_to_page=fit_to_page)
ppms.client_exec(client_call)
for module in modules_to_close:
module.menu(49)
select_module.menu(49)
#Loop for display of module variant
get_selected_reports()
PY
Notes
- For the transfer of data to the client, an rpc service is to be used.
- When using the !IronPython method
CreatePdfExportDocument()
, the parameter names must be specified as well.-
doc = module.CreatePdfExportDocument(pageSize='A4',landscape=TRUE, zoom=100.0, fitToPage=TRUE)
stattdoc = module.CreatePdfExportDocument('A4', TRUE, 100.0,TRUE)
-