Commit 37cfb9d5 authored by Carsten  Rose's avatar Carsten Rose
Browse files

Manual.rst: explanation of 'Import/merge forms'

parent 6bf05247
Pipeline #741 passed with stage
in 1 minute and 51 seconds
...@@ -94,7 +94,8 @@ In `configuration`_ specify the: :: ...@@ -94,7 +94,8 @@ In `configuration`_ specify the: ::
cmdWkhtmltopdf=/opt/wkhtmltox/bin/wkhtmltopdf`. cmdWkhtmltopdf=/opt/wkhtmltox/bin/wkhtmltopdf`.
baseUrl=http://www.example.com/`. baseUrl=http://www.example.com/`.
If wkhtml has been compiled with dedicated libraries, specify the LD_LIBRARY_PATH together with the path-filename: :: If wkhtml has been compiled with dedicated libraries (not part of LD_LIBRARY_PATH), specify the LD_LIBRARY_PATH together
with the path-filename: ::
cmdWkhtmltopdf=LD_LIBRARY_PATH=/opt/wkhtmltox/lib /opt/wkhtmltox/bin/wkhtmltopdf cmdWkhtmltopdf=LD_LIBRARY_PATH=/opt/wkhtmltox/lib /opt/wkhtmltox/bin/wkhtmltopdf
...@@ -4702,13 +4703,26 @@ Table: Person ...@@ -4702,13 +4703,26 @@ Table: Person
slaveId={{id:R0}} slaveId={{id:R0}}
sqlUpdate={{ UPDATE Person AS p SET p.name='{{cn:L:alnumx:s}}' WHERE p.id={{slaveId}} LIMIT 1 }} sqlUpdate={{ UPDATE Person AS p SET p.name='{{cn:L:alnumx:s}}' WHERE p.id={{slaveId}} LIMIT 1 }}
FAQ Import/merge forms
--- ------------------
The form `copyFormFromExt` copies a form from table `ExtForm / ExtFormElement` to `Form / FormElement`. The import/merge
form
* offers a drop down list with all forms of `ExtForm`,
* an input element for the new form name,
* create new Form.id
* copied FormElements get the new Form.id.
* the copied form will be opened in the FormEditor.
Installation:
* Q: A variable {{<var>}} is shown as empty string, but there should be a value. * Play the file *<ext_dir>/qfq/sql/copyFormFromExt.sql*.
* Insert a link/button 'Copy form from ExtForm' to open the import/merge form. A good place is the list of all forms
(see `form-editor`_). E.g.: ::
10.head = {{'b|p:id={{pageAlias:T}}&form=copyFormFromExt|t:Copy form from ExtForm' AS _link }} ...
* A: The sanitize rule is violeted and therefore the value has been removed. Set {{<var>:<store>:all}} as a test.
Only STORE_CLIENT and STORE_FORM will be sanitized.
.. _`report`: .. _`report`:
...@@ -5139,6 +5153,12 @@ Special column names ...@@ -5139,6 +5153,12 @@ Special column names
+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| _monitor |Constantly display a file. See `column-monitor`_. | | _monitor |Constantly display a file. See `column-monitor`_. |
+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| _XLS |Used for Excel export. Append a `newline` character at the end of the string. See `excel-export`_. |
+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| _XLSs |Used for Excel export. Prepend 's=' and append a `newline` character around the string. See `excel-export`_. |
+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| _XLSn |Used for Excel export. Prepend 'n=' and append a `newline` character around the string. See `excel-export`_. |
+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| _+??? |The content will be wrapped in the tag '???'. Example: SELECT 'example' AS '_+a href="http://example.com"' creates '<a href="http://example.com">example</a>' | | _+??? |The content will be wrapped in the tag '???'. Example: SELECT 'example' AS '_+a href="http://example.com"' creates '<a href="http://example.com">example</a>' |
+------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|_<nonReservedName> |Suppress output. Column names with leading underscore are used to select data from the database and make it available in other parts of the report without generating any output. | |_<nonReservedName> |Suppress output. Column names with leading underscore are used to select data from the database and make it available in other parts of the report without generating any output. |
...@@ -6325,15 +6345,13 @@ Excel export ...@@ -6325,15 +6345,13 @@ Excel export
Mode: Mode:
* NEW: The export file will be completely build from scratch. * NEW: The export file will be completely build from scratch.
* TEMPLATE: The export file is based on an earlier saved xlsx file (template). The template is unchanged. * TEMPLATE: The export file is based on an earlier uploaded xlsx file (template). The template itself is unchanged.
Injecting the data is done in the same way in both modes . The only difference is by specifying a xlsx file which will Injecting the data is done in the same way in both modes . The only difference is by specifying a xlsx file which will
be used as an template. be used as an template.
If the export file has to be customized (colors, pictures, headlines, ...), the TEMPLATE mode is the preferred option. If the export file has to be customized (colors, pictures, headlines, ...), the TEMPLATE mode is the preferred option.
Setup Setup
''''' '''''
...@@ -6363,10 +6381,11 @@ Setup ...@@ -6363,10 +6381,11 @@ Setup
[global] [global]
* Use the regular QFQ Report syntax to create some output. * Use the regular QFQ Report syntax to create some output.
* The newline character ist CHAR(10). * The newline at the end of every line needs to be CHAR(10). To make it simpler, the special column name `... AS _XLS`
can be used.
* One option per line. * One option per line.
* Empty will be skipped. * Empty lines will be skipped.
* Lines starting with '#' will be skipped (comments) * Lines starting with '#' will be skipped (comments). Inline comment signs are NOT recognized as comment sign.
* Separate <keyword> and <value> by '='. * Separate <keyword> and <value> by '='.
+-------------+----------------+---------------------------------------------------------------------------------------------------+ +-------------+----------------+---------------------------------------------------------------------------------------------------+
...@@ -6380,11 +6399,11 @@ Setup ...@@ -6380,11 +6399,11 @@ Setup
+-------------+----------------+---------------------------------------------------------------------------------------------------+ +-------------+----------------+---------------------------------------------------------------------------------------------------+
| 'newline' | newline | Start a new row. The column will be the one of the last 'position' statement. | | 'newline' | newline | Start a new row. The column will be the one of the last 'position' statement. |
+-------------+----------------+---------------------------------------------------------------------------------------------------+ +-------------+----------------+---------------------------------------------------------------------------------------------------+
| 'str', 's' | s=hello world | Set the given string on the given position. The current position will be shifted one to the right | | 'str', 's' | s=hello world | Set the given string on the given position. The current position will be shiftet one to the right.|
+-------------+----------------+---------------------------------------------------------------------------------------------------+ +-------------+----------------+---------------------------------------------------------------------------------------------------+
| 'f' | f==SUM(A5:C6) | Set a formula on the given position. The current position will be shifted one to the right | | 'n' | n=123 | Set number on the given position. The current position will be shiftet one to the right. |
+-------------+----------------+---------------------------------------------------------------------------------------------------+ +-------------+----------------+---------------------------------------------------------------------------------------------------+
| 'n' | n=123 | Set number on the given position. The current position will be shifted one to the right | | 'f' | f==SUM(A5:C6) | Set a formular on the given position. The current position will be shiftet one to the right. |
+-------------+----------------+---------------------------------------------------------------------------------------------------+ +-------------+----------------+---------------------------------------------------------------------------------------------------+
Create a output like this: :: Create a output like this: ::
...@@ -6407,8 +6426,7 @@ In Report Syntax: :: ...@@ -6407,8 +6426,7 @@ In Report Syntax: ::
's=First Line' AS _XLS, 's=First Line' AS _XLS,
'newline' AS _XLS, 'newline' AS _XLS,
's=Second line' AS _XLS, 's=Second line' AS _XLS,
'n=123' AS _XLS 'n=123' AS _XLS,
.. _drag_and_drop: .. _drag_and_drop:
...@@ -7092,6 +7110,11 @@ Tips: ...@@ -7092,6 +7110,11 @@ Tips:
QFQ specific QFQ specific
------------ ------------
A variable {{<var>}} is empty
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The sanitize rule is violeted and therefore the value has been removed. Set {{<var>:<store>:all}} as a test.
Page is white: no HTML code at all Page is white: no HTML code at all
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
...@@ -7100,7 +7123,7 @@ This should not happen. ...@@ -7100,7 +7123,7 @@ This should not happen.
The PHP process stopped at all. Check the Apache error logfile, look for a stacktrace to find the latest function. Send The PHP process stopped at all. Check the Apache error logfile, look for a stacktrace to find the latest function. Send
a bug report. a bug report.
Problem with Query or variables Problem with query or variables
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Specify the required sanitize class. Remember: for STORE_FORM and STORE_CLIENT the default is sanitize class is `digit`. Specify the required sanitize class. Remember: for STORE_FORM and STORE_CLIENT the default is sanitize class is `digit`.
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment