Syntax of the printTemplate variable of the Print method

bstrPrintTemplate argument of the IGeneralInvoiceRequestManager::Print is either empty or of the general form defined below. In the case of an empty bstrPrintTemplate variable than no print variables are changed/substituted and the default print templates are used according to the defined language, law and tiers type.

However, bstrPrintTemplate can be used to change the normal printing behavior or changing printing objects dynamically. The following syntax is used as content of the bstrPrintTemplate variable:

[logTpl[4Recipient]][(objectName1=text;...)][=printTemplateFile][#INIPATH=inipath]

where a [] pair defines an optional part. The commands are case insensitive and have the following meaning:
  • logTpl: is the logical template name out of a set of 4 well-defined template names: {summary | feeSummary | detail | feeDetail}.
    The variant with the 'fee' tag produces fee notes/reminders (with the law=enORG), while the other variant provides the healthcare-defined invoices/reminders (with the law<>enORG).
  • 4Recipient: defines the optional addressee where from the set of {4debitor | 4guarantor | 4patient | 4hc} can be choosen.
    For example, in a Tiers Garant/enKVG case summary4debitor (or just summary) and detail4debitor (or just detail) are the defaults for the debitor addressed invoice/reminder form ("Patienten-Rechnung" and "Rückforderungsbeleg")
      
    For example, in a Tiers Garant/enORG case feesummary4debitor (or just feesummary) and feedetail4debitor (or just feedetail) are the defaults for the debitor addressed fee note/reminder form ("Honorarrechnung" and "Leistungsübersicht")
      
    For example, in a Tiers Payant/enUVG case detail4hc is the for the healthcare-addressed invoice/reminder form ("TP Rechnung").
      
    The other combinations basically use the addressed recipient and automatically change the title and other print objects. E.g. detail4patient prints a detailed invoice with the patient as recipient.
      
    Please note, that there is a subtle difference between a patient and a guarantor even if it is physically the same person. From a formal point of view the patient is not the payer of the invoice but the guarantor, and that has an influence upon the title and other print objects!
  • objectName1=text; does control a substitution of the content of the print object objectName1 by text.
    A print object is terminated by a semicolon and all print objects together are enclosed in a () pair.
    There are 3 predefined pseudo print objects with a special meaning:
    • PDF for generating PDF files
    • WEBSTAMP for printing electronic stamps
    • PRINTLANGUAGE=language, where language is {DE|FR|IT}, forces the usage of the print_template for the given language and thus override the print language given in IGeneralInvoiceRequest::Initialize . Please note that only the print template is changed, whereas all data remains as supplied.
  • printTemplateFile defines an external print template file name (full path + name!).
    If an external print template is supplied it must be mapped against a logical template. Therefore detail=full_vps_file must be used!
  • #INIPATH=inipath defines a fully qualified path to a directory where the report engine searches the corresponding .vpd print template INI file.
    This allows for global settings of a print template in a LAN. The default inipath is the install directory of the Dll

Here are some usage examples:
  • bstrPrintTemplate: "" or bstrPrintTemplate: Detail
    denotes a standard printing situation for a TP/enUVG case.
     
  • bstrPrintTemplate: feedetail(DOCUMENT_TITLE_DETAIL=Alternate title for the service overview;) prints a substituted title for the list of services of a fee note in a TG/enORG case.
     
  • bstrPrintTemplate: summary4hc(DOCUMENT_TITLE_SUMMARY=Alternate title for the HealthCare company;) prints a summary invoice on A4 with ESR attached on the bottom for a health care company. The title is adjusted as given above.
     
  • bstrPrintTemplate: feesummary=C:\myForms\myPrintForm.vps
    uses the print template "C:\myForms\myPrintForm.vps". An optional INI file with the name "C:\myForms\myPrintForm.vpd" is searched under this condition at the same directory.
     
  • bstrPrintTemplate: #INIPATH=\\host1\\myForms\
    the default path for the ini files (place of the installed component) is changed to "\\host1\\myForms\". If "\\host1\\myForms\" is accessible by all hosts of the LAN then the same INI settings can be used.