Executing Server-Side Processing from Excel-Link (fusion_place >= 14.1)
This manual is in pilot operation.
|
This feature allows you to request calculation processing with forms and scripts from Excel and execute it (on the server side).
No macro coding is required for setup; you can easily configure it based on an Excel sheet describing the processing instructions.
1. How to Execute Processing
You can execute server-side calculation processing using the following two methods:
Method | How to Specify Processing Instructions |
---|---|
a. Execute server-side calculation processing after performing Reflect or Retrieve and Reflect. |
For each sheet on which you want to execute server-side calculation processing, create an instruction sheet named with the sheet name + "_FPCTL1". |
b. Execute server-side calculation processing by calling a procedure from a macro, independent of Reflect or Retrieve and Reflect. |
You can write the instruction table starting at any cell on any sheet. |
2. Processing Instruction Table
The processing instruction table must be a rectangular cell range on a specific sheet.
The first row of the instruction table should be the header row, specifying headers indicating the content of each column. Rows from the second row onward are detail rows where you describe the processing instructions.
The contents of the processing instruction table are as follows:
Item | Count | Header | Details for Setting |
---|---|---|---|
Data Presence |
1 |
X |
Enter any string in the rows you want to use. |
Type |
1 |
TYPE |
For forms: |
Application |
1 |
APPL |
Label of the application |
Action |
1 |
ACTION |
Label of the form or script |
Ledger Edition |
1 |
EDITION |
Key of the ledger edition (e.g., WORKSPACE) |
Participant |
1 |
PARTICIPANT |
Label of the participant to be used for the calculation processing. |
Parameter Values |
n |
"P:" + Dimension Label |
Specify the parameter values (member labels) to be passed to the form or script for each dimension. |
The columns from Type to Parameter Values can be repeated horizontally.
The "TYPE" column indicates the boundary of horizontally laid-out tables.
For example, you can specify "X" in cell A1, then "TYPE" in cell A2, "APPL" in cell A3, and so on, placing items rightward in columns, and by writing "TYPE" further to the right, start another table.
The order of items other than the "TYPE" column is arbitrary. Uppercase and lowercase letters are ignored within the processing instruction table, as are spaces before and after strings.
3. Details of Processing Execution
(a) Automatically execute server-side calculation processing after Reflect or Retrieve and Reflect
-
When performing "Reflect" or "Retrieve and Reflect," the specified form/script will be executed.
This also applies to "Batch/Reflect" and "Batch/Retrieve and Reflect." -
This processing will only be executed for sheets with a corresponding instruction sheet.
-
The processing order is as follows:
(1) Execute the usual Reflect or Retrieve and Reflect process
(2) Execute server-side calculation processing with the form/script according to the instruction table
(3) Retrieve the processed data and update the data on the Excel sheet
(4) For Excel files launched from Contributor, perform package recalculation if specified
After processing, the ledger data after executing the form/script described in the instruction table will be displayed on the Excel sheet.
The additional processing enabled by the presence of the instruction table is (2) and (3). -
The server-side calculation processing reads and executes the instruction table content in horizontal priority order.
If there are multiple tables, it will process the first detail row of all tables horizontally, then move to the next row. -
If an error or warning occurs during processing, it will stop at that point and display a message.
(b) Execute processing by calling a procedure from a macro, independent of Reflect or Retrieve and Reflect
Procedure Specification
Procedure Name | Description | Argument | Return Value |
---|---|---|---|
FP_RunServerCalc |
Executes server-side calculation processing according to the instruction table specified in the argument. |
TableRange As Range Starting cell of the instruction table (the cell with the data presence header) |
(none) |
-
Execute FP_RunServerCalc specifying the argument.
-
If an error occurs, VBA’s Err will be raised.
You must handle the display of messages or other responses to the raised error on the calling side.