12. Consolidation¶
12.1. Principles¶
The consolidation feature allows you to combine the values of one or more indicators (called “sources”) into another indicator (called “recipient indicator”). Source indicators can belong to any ring, of any letter, of any board, of any room, of your domain.
Note
The values used for the binary valorization mode are always 0 and 1.
When consolidating binary indicators, only the button values (0 and 1) are used.
12.2. Settings¶
Whenever you create a new indicator, you can make it a recipient of values from other indicators through the consolidation feature. You just have to click on the icon shown below.
Note
- A binary indicator cannot be a recipient indicator
- Only room administrators can set up a consolidation
Below you will find the interface for the consolidation set-up:
1 -> Ring selection
2 -> Type of formula selection
3 - > Select whether or not to take into account values not entered in boxes
4 -> Set-up display and edition of this indicator in the box menu
5 -> Decimal digits after consolidation
6 -> Selection and editon of formula input
7 -> Formula element deletion
8 -> Formula
Note
When all source values are empty and the “Empty values” option is disabled (empty values not ignored), the target (consolidated values) is empty
12.2.1. Available formulas¶
Five consolidation formulas are available: sum, average, minimum, maximum and custom.
Sum The recipient indicator will receive the sum of the values of source indicators |
|
Average The recipient indicator will receive the average of the values of source indicators Note: If one or more source indicators have a missing value, they will be ignore in the calculation. For example: If we consolidate 8 indicators and one of them has a missing value, we only consider 7 values. |
|
Minimum In this case, the target indicator retrieves the minimum values of each source indicator. |
|
Maximum In this case, the target indicator retrieves the maximum values of each source indicator. |
|
Custom With the custom formula you are free to define any formula by combining arithmetic operators with source indicators and fixed numbers with a simple click or a drag&drop |
|
Note: the formula syntax must be correct. If not, a red error message will be displayed and the formula will not be taken into account |
12.2.2. Formula elements by type of formula¶
. | . | Type of formula selection | ||||
---|---|---|---|---|---|---|
Element type | Possibilities | Sum | Average | Minimum | Maximum | Custom |
Recipient Indicator | Every source indicator:
|
✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
Arithmetic operator | 6 basic operators:
|
❌ | ❌ | ❌ | ❌ | ✔️ |
Fixed number | Fixed numerical value entered manually | ❌ | ❌ | ❌ | ❌ | ✔️ |
12.2.2.1. Source indicator management¶
12.2.2.1.1. Target and recipient ring frequency compatibility¶
The frequency of the ring the recipient indicator belongs to must be lower than the frequencies of the rings target indicators belong to (ie.: you cannot consolidate a quarter into a month).
12.2.2.1.2. Time aggregation rules¶
Aggregation rules must be defined when the frequency of source rings is higher than the one of recipient rings (ex.: 31 boxes of a month to be consolidated in one month). In this case you have the choice between:
- Aggregating values with a sum
- Aggregating values with an average
12.2.2.1.3. Lifecycle¶
Some elements may be changed over time, after the consolidation is setup and running. In this case, when you open the consolidation setup window, some indicators may be displayed:
- With an orange border, if a source indicator was renamed
- With a red border, if the source indicator was erased or the user has no access to it
This may occur in case of data import-export.
12.3. Consolidation trigger¶
A consolidation can be triggered in many ways:
Automatically by clicking on a board | If the switch is on in the utility panel |
From the QCD utility panel | 2 - Consolidation time window 3 - Consolidation trigger 4 - Automatic trigger management |
Directly from a letter |
Note
- You cannot trigger a consolidation on a time window wider than the current time window of a letter (ex. : for a letter displaying the values of march 2019, the consolidation can triggered between march 1st and march 31st)
- Users with simple editing rights can trigger a consolidation
12.4. Result display¶
12.4.1. On the letter¶
A status report will pop up on the letter :
- In black if the consolidation succeeded
- In red if an error occurred
1 -> Trigger date
2 -> Activator user name
3 -> Formula reminder for custom formulas
4 -> Number of boxes with a successful consolidation
5 -> Number of boxes with a consolidation error
6 -> Number of boxes to be still calculated
12.4.2. On indicators¶
In the letter menu an icon will show recipient indicators.
In case of errors in a consolidation this icon will turn red.
By clicking on it you will see the details of the consolidation, that will be described with the following signs:
- ‘#’ if the box of the source indicator wasn’t found or ‘~’ in case of consolidation by average
- ‘@’ if the box of the source indicator was disabled
This screen allows you to see all the details of your indicator formula.
Tip
Click on the indicator’s box to be directed to the source letter.
12.5. Results modification¶
If the value of a consolidation is changed manually, the consolidation status will be updated accordingly: the icon and the detail will be blue.
From that moment on, this specific value will not be affected by future consolidations.
In order to recalculate the initial consolidated value, the manually changed value is to be deleted and a new consolidation launched.
12.6. Limitations¶
12.6.1. Consolidation settings lifecycle¶
When a room administrator sets up a consolidation in a given room, he needs the rights of access to the room where source indicators are located.
Thus he can set up a “link” between the “recipient” room and “source” rooms.
Once this “link” is setup, it will stay even if the administrator of the recipient room loses his right to access the source room. Only this specific recipient room administrator will have the right to delete this “link”.
12.6.2. Data import-export¶
Exported data include consolidation settings. This means that if you export a QCD board with a consolidated indicator and then you re-import it, the consolidated indicator will keep its initial settings.