Preference - Administration
The Administration section in Preference is used only by FA administrators. Clients can’t access these settings.
Banner
In Banner preferences, you can define HTML to be displayed into the red toolbar. This allows you to utilize the space in the red toolbar more extensively, and to for example easily distinguish your test and production environments with a descriptive text.
For example, HTML <p align='center'><font size='4'>TEST ENVIRONMENT</font></p> allows you to enter a noticeable text centered in the red banner.
Document management
Document management preferences allow you to adjust how your users can upload documents into the system (available from FA 3.5 onward).
- Define maximum size for all uploaded files in megabytes (MB)
Allows you to define a maximum file size for documents your user can upload to the system. By default, there is no maximum file size.
- Limit the frequency of document uploads
Allows you to define how many documents a user can upload, and how frequently rights to upload new documents will be available (e.g. a user can receive 1 new document to upload every 10 seconds). You can control the upload frequency with three settings:
Number of documents user can upload – The number of documents user can upload without any limit on upload frequency. By default, the number of documents is set to 1000.
Number of new documents to upload user receives at once – The number of new documents upload "rights" the user receives at the defined interval. By default, the number of new documents is set to 1000.
How often (seconds) user receives the new documents to upload – The freguency: how often the user gets the new document upload "rights". By default, the number of time is set to 1 second.
With the default configurations, users can upload 1000 documents without any limit, and get 1000 new documents to upload every second - in practice, this means that there is by default no limit on document upload frequency, unless the user tries to upload more than 1000 documents a second.
Adjusting the preferences above allows you to limit file uploads. If a user tries to upload files more frequently than allowed, the upload is prevented with a notification.
For example, set the number of documents to 5, new documents to 1, and time to 10 seconds. With this configuration, your users are able to upload 5 documents without a limit and will receive 1 new document to upload every 10 seconds. Every time your user uploads a document, the number of "uploads left" is reduced from five - after one upload, you have four uploads left, etc. The number of documents gets restored with one new document every ten seconds - if the user uploaded one document, reducing the "number of uploads left" to four, after ten seconds, the user would again have rights for full five uploads. If the user uploads more than five documents simultaneously or right after each other within ten seconds, further uploads are prevented until the user gets a "refill" of new documents to upload.
Email settings
Email settings contain fields for defining the settings for sending the emails (defined by FA when email reporting is enabled).
General
You can set the following general preferences:
- Document management
Enable or disable document management. If enabled, documents can be attached to contacts, portfolios, transactions, and securities in the corresponding windows.
- Language
Set the default language of the application to be either Suomi, English, or Svenska. The language setting defines the default language of the application: the user interface is shown with the selected language by default. The user can change the language of the user interface from Action - Languages (the language selection specific to the user name).
- Enter button functionality
Define how the Enter key behaves in FA Portfolio windows. The following options are available:
Enter navigates to the next field: Set the Enter key to behave as the tabulator, navigating to the next field when pressed. Selected by default.
Enter submits the form: Set the Enter key to submit the open form when pressed (Enter acts as the Save / OK buttons).
Enter does not do anything: The Enter key has no extra functions.
- Default search
Select the default search criteria to show when you open a view. You can choose from the following options:
Extended search: The views show all search criteria. You can use the quick search by clicking Show quick search. Selected by default.
Quick search: The views show the quick search. You can use the extended search by clicking Show extended search.
Market data connection
The market data connection preferences are visible only if the functionality to import market data from an external source is enabled. Define the market data information to the field:
- Earliest date of observation
Set the earliest date of the market data observations imported. External market price sources often have a long history of market price observations available, and it might not be worthwhile to save the entire market data history to FA. This field allows you to define the earliest date of market data observations.
- Number of days market prices are fetched for in the nightly run
Define how many day's market data observations are fetched for and saved as market prices during the nightly run. The nightly run automatically fetches market prices for "Active" securities, for which a corresponding update code is defined. The default number of days to fetch during the nightly run is 5: this means that every night, including weekends, the prices from the previous 5 days are fetched and saved for securities as market prices. For example, setting the number of days as 1 means that on Saturday, the close price from Friday is fetched. Similarly, on Monday, the close price from Sunday is fetched. Note that it is unlikely there is a price available for Sunday.
Performance calculation
Performance calculation preferences define how TWR is calculated and stored.
- Timing of intra-day cashflows in TWR calculation
An option to define how net cash flows or net exposure affect the base for the daily TWR formula.
Cashflow timing
Description
Differentiated (default)
The daily market value-based TWR formula
Positive net cashflows are added to the base for long positions. Negative cashflows are added to the base only for short positions. In other cases, negative cashflows are handled at the end of the day. The absolute value of the result is taken.
Equation 5.The daily exposure-based TWR formula
Positive net exposure is added to the base for long positions. Negative exposure is added to the base only for short positions. In other cases, negative exposure is handled at the end of the day. The absolute value of the result is taken.
Equation 6.Start of day
The daily market value-based TWR formula
The net of positive and negative net cashflows is added to the base. The absolute value of the result is taken.
Equation 7.The daily exposure-based TWR formula
The net of positive and negative exposure is added to the base. The absolute value of the result is taken.
Equation 8.End of day
The daily market value-based TWR formula
The net of positive and negative net cashflows are handled at the end of the day. This means they affect the market value base of the next day. The base is always market value start. The absolute value of the result is taken.
Equation 9.The daily exposure-based TWR formula
The net of positive and negative exposure is handled at the end of the day. This means it affects the market value base of the next day. The base exposure start. The absolute value of the result is taken.
Equation 10.Simple Dietz
The daily market value-based TWR formula
Positive and negative net cashflows are handled in the middle of the day. Half of the net of positive and negative net cashflows is added to the base. The absolute value of the result is taken.
Equation 11.The daily exposure-based TWR formula
Positive and negative net exposure is handled in the middle of the day. Half of the net of positive and negative net exposure is added to the base. The absolute value of the result is taken.
Equation 12.- Use imported TWR up to
The date until which Analytics+ should use pre-calculated TWR values (instead of calculating values on the fly). Importing pre-calculated TWR values helps you speed up the usage of Analytics+. For more details, see File format for importing TWR.
Permissions
Permission preferences allow you to define and adjust permissions of each user role, i.e. adjust the rights to use the system per user role. The permissions are used to what users can access, view and edit when using FA.
To switch between the tabs, click on them or use the 
icon at the bottom of the view.
Restrict reports to roles
Restricting reports to roles allows you to define which user roles have access to certain reports. Enter one or several semicolon-separated roles next to the report and click Save. If you leave the field empty, all users can generate the report in the Report window.
If a report is included in the report package, the user can generate only those reports in the package they have access to. The user gets a warning that some reports included in the package are unavailable. To learn more about the report packages, see the Report packages section.
Session timeout
Session timeout preferences allow you to control the application life cycle through "session timeout" and "heartbeat interval". These parameters are applied when a user is inactive, but the application is open and stays idle. (Available from FA 3.5 onward)
- Heartbeat interval (minutes)
The default is 5 minutes. Heartbeat interval controls how often heartbeats that keep the user's session alive are sent. "UI instances are cleaned up if no communication is received from them after some time. If no other server requests are made, the client side sends keep-alive heartbeat requests. A UI is kept alive for as long as requests, or heartbeats, are received from it.”
- Session timeout (minutes)
Default 30 minutes. Session timeout defines the time period for which the application remains “alive” without user interaction. Timeout is reset if the user performs some action within the application.
Manipulating session length by adjusting these two parameters in FA Back and the corresponding KeyCloak setting means that the application can function in two ways:
If the heartbeat is set to be longer than the session timeout, the session will always die after the timeout.
If the heartbeat interval is shorter than the session, the session will never expire.
Update report
Update report preferences allow you to define how and when portfolio report data is updated.
- Disable report updates
Disables all report updates and blocks all purchase lot and position calculations from being triggered. Use this option to speed up data import when importing large volumes of data. This also overrides "Update reports immediately” if both are selected. After the import is completed, you should:
Re-enable report updates in Preferences.
Recalculate the report data. Click Update in the top menu and choose Recalculate all report data of all portfolios.
Re-run posting rules if they are used. Click the Generate postings at the bottom of the Transactions view.
- Update reports immediately
Enables portfolio positions to update immediately after changes in the data. When disabled, the positions have to be updated manually or via an automatic position calculation at night. Purchase lots are calculated immediately in either case. Enabling this is recommended.
- Automatically update reports
Enables or disables automatic nightly report data update. If you are using a market data connector, the nightly report data update first fetches the latest market price entries through your market data connector and then recalculates report data with the latest close prices.
- Update time
Define the time for the daily report update in the form hh:mm (for example 01:00). Daily report update is recommended to run at night so that report data is ready in the morning. If you are using a market data connector to fetch prices, adjust the time so that yesterday's prices are available through the connector when the nightly report data update begins.
- Number of days to store report calculation records
Define the number of days for storing information about completed report calculations.
Nightly report data updates are audited - system audit tracks when the system automatically fetches market prices through a market data connector and updates report data at night. Every time the system starts to fetch prices, the system audit contains a message “Nightly close price updates and report calculations started” and once prices have been fetched, the system audit contains a message “Nightly close price updates done, report calculations scheduled”. (Available from FA 3.10 onward)