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.
The data after execution will be displayed on the sheet after the Reflect or Retrieve and Reflect process.

For each sheet on which you want to execute server-side calculation processing, create an instruction sheet named with the sheet name + "_FPCTL1".
The instruction sheet can be hidden and still executed.
The starting cell of the instruction table (the cell with the data presence header) must be cell A1.

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.
Pass the starting cell of the instruction table (the cell with the data presence header) as an argument to the procedure.

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.
Processing proceeds from the second row; when a row with this column left blank appears, processing will stop thereafter.
If in a non-blank row either the Type through Participant columns are blank, that row will be skipped and the next instruction data (moving right first, then down) will be processed.

Type

1

TYPE

For forms: F
For scripts: S

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.
The user using [Excel-Link] must have execution authority.

Parameter Values

n

"P:" + Dimension Label
Example:
P:#FY
P:#SCENARIO

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

  1. 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."

  2. This processing will only be executed for sheets with a corresponding instruction sheet.

  3. 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).

  4. 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.

  5. 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)

  1. Execute FP_RunServerCalc specifying the argument.

  2. 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.