Table of Contents
Excel file
- File Type: Excel file type to be used to output the data:
- File type “Excel 97 - 2003 workbook” (*.xls): The choice of this type of file requires the use of the Excel application to generate the output.
- File type “Excel 2007 Workbook” (supporting *.xlsm macros or not *.xlsx): The choice of this file type allows you to generate the output without using the Excel application.
The use of the Excel application to generate the output requires a lot of system resources if the result of the query contains many rows. This is why it is recommended to use the “Excel 2007 Workbook” format if the number of rows returned by the query exceeds a few hundred.
- Define a file: define the name of the file and the location where the result of the query will be saved.
This option is not available by default. To have access to it, users (or the group they belong to) must have been authorized to do so in the AdminTool application (see Restriction of rights\Restitutions\Authorize restitution to particular files).
- Model: the file specified as a template allows you to use Excel to finalize the formatting of the query data (pivot table, graph, conditional formatting, etc). It is advisable to store the template in the shared directory of Vigilens to be sure that it is accessible during the execution of the query (especially in case of Web type execution).
The file used as a template can be any type of Excel file. It is not necessarily an “Excel template” type file. (*.xlt).
- Location : Defines the location where Vigilens will deposit the result of the query (often used with templates to ensure consistency between the result obtained from Vigilens and the formatting done by Excel).
- Apply format set at Vigilens Level: Keeps the formatting defined in Vigilens (format, conditional formatting).
- Macro to launch: Automatic execution of a macro at the end of editing. For the macro to run, remember to uncheck the box “Remove personal information from file properties when saving” in the Excel options when saving the model.
Warning: Running a macro or updating fields requires the use of the Excel application (even if the document type is “Excel 2007 workbook”). This being said, in the case of an “Excel 2007 workbook”, only the execution of the macro or the updating of the fields will require the use of the Excel application (the data insertion will be done without the use of the Excel application, therefore, faster).
Running from Excel / Calling up external data
The call of a Vigilens query from Excel is done through the menuData→Get & transform data→From web.
url exemple : http://my-server/vigilens/table.php?vglCtrlName=“%2FDEMO%2F01%20Fiche%20CLIENT”&vglOutput=“XLTable”&CLIENT=4245&vglNumFormat=“%2C%2E”&vglUserName=“srivier”
Mandatory parameters
- Root Adress: http://<ServeurWeb>/vigilens/table.php?
- vglOutput=XLTable&
- vglCtrlName=<NomDeLaRequête>&
- vglUserName=<NomUtilisateur>
- use commande line wizard in the designer, with output option “* Run query from Excel”
Parameters order does not matter
It is possible to automate this processing by using Excel macros. Here is an example of a macro to be adapted according to the needs:Example macro