Excel Add-in Views

The Excel Add-in Views tab allows you to set up one or more Excel Files to be distributed during the Job execution.

1. Click to choose the Excel file you want to import.

   

   Note

   If you want to add more than one Excel file, click on to add another file tab then on to import the file.

   Tabs can be removed with .

2. Click Upload to browse to the location where the file is. The window will display a list of files in the Central Point.
   
   

   

3. Select the file you want to import, click Open then Confirm to get back to the Job Properties window.

4. Once the File Name is determined, you may choose to add a Custom Name by clicking the toggle button to enable the field.

   This option allows you to customize the distribution file, in which you can:

   • Add a custom name, with multilingual options.

   • Add Global Variables and Special Variables.

     Example

     Invoice by Customer @@CURYEAR Period @@UDM_CURPER

     Note

     Uppercase and lowercase letters (A-Z, a-z), digits (0-9), and the underscore (_) symbol cannot be attached at the end of a global variable name.

     Important

     Windows files do now allow the following characters: " \ / : | < > * ?. If these characters are present in the custom name, the distribution job will fail.

     If a file with the specified name already exists, it will be overwritten.

     Global Variables and Special Variables will be resolved based on the default environment only: Admin for OnPremise, and ADMCA for CloudMode.

5. Next, you can define which sheets in the file to distribute in the Sheets field. You can select them all with the All sheets toggle.

6. In the Format field, select the output format:

   • Excel: Excel file with the values only, all the formulas are removed.

   • PDF: Generic static PDF file.

   • CSV: Comma-separated values (excel format).

   • Excel Add-in: Excel file including all the Add-in formulas. The calculation mode will be set to manual.

   Note

   If you select Excel or Excel Add-In in the drop-down list, the Reporting Tree feature becomes available. When enabled, it replaces the one distribution file per value slider with one sheet per Reporting Tree node slider. The one sheet per Reporting Tree node slider will remove the Cell Value input column and generate Excel sheets based on the Nodes of the Reporting Tree you set as Distributable in the Administration section.

7. In the Protection field, activate the option and enter the password that will unlock the files. Excel and PDF files can be password protected.

8. In the Execution timeout field, set the maximum number of minutes that Nectari will wait before canceling.

9. To send a parameter to the Add-in report:

   1. Click

   2. In the first drop-down list, select the sheet in which the parameter will be used.
   3. In the second field, enter the location the parameter will be sent to (this can be either a cell number or the cell name).

   4. In the last field, enter the value to assign to the cell.

   Note

   Global Variables can be used instead of typing the value in manually.

   A parameter value can overwrite existing data in the Excel file within the cell.

   Example

   In the Job Properties window:
   
   

   In the Worksheet, the name is Site and the cell number B1.
   
   

10. Click Save.