The documentation about this variable is as follows: The report title can be changed at runtime in the SQLI step preceding the
report step, using the :HTMLFNCTITLE variable. When would one need/desire to use this variable? When one wants the
title of a report to contain the value of a variable; for example,
'List of orders entered on 18/01/22' could be achieved by the following
means
:PAR1 = DTOA (SQL.DATE8 - 24:00, 'DD/MM/YY'); SELECT ENTMESSAGE ('$', 'P', 10) INTO :HTMLFNCTITLE FROM DUMMY;
where message 10 would be 'List of orders entered on <P1>' (I use this method to get Hebrew strings into a program - it's easier this way than writing naked strings in the program text that get reversed ... or not). As the documentation states, the above should be in an SQL statement prior to the report whose title one is creating.
So where's the pitfall? 'Ordinary' reports created without :HTMLFNCTITLE display their title (this may come from the report's title - which is limited in length - or from the sub-form 'output title) along with the parameters used to create the report. I find this information very useful when debugging reports that other users have created (e.g. answering the question why a given order doesn't appear in a report - because the parameters of the report don't match those of the order). This information does not appear in a report whose title has been changed by :HTMLFNCTITLE.
So: it's ok to use :HTMLFNCTITLE in an 'HTML document' but not advisable to use it in an ordinary multi-step report.
No comments:
Post a Comment