Currency Rate Update (ACCRUL)¶
The purpose of this page is to provide product specific tailoring guides for Workflows related to Currency Rate Update (ACCRUL component).
The following workflows are utilized for the purpose of updating Currency Rates retrieved from an external third-party webservice.
-
finCurrencyTypeUpdate
-
finUpdateCurrencyRatesForCurrencyTask
-
finCentralCurrencyHandling
Prior to configuring Currency Rate Update Workflows, users should fully avail themselves of the capabilities described under:
Currency Rate Update Example Content¶
Currency Rate Update Example Scope¶
Facilitating the update of currency rates via a third-party web service is accomplished within IFS Cloud through the use of workflows.
Below example cases cover a limited scope which can be used as starting points to design your own workflows.
- Update currency rates using Currency Types page.
- Update currency rates using Currency Rates Page.
- Update currency rates using Tasks for Currency Updates page.
- Synchronize currency rates between companies using Centralized Currency Rate Handling page.
Currency Rate Update Workflows¶
The events of these workflows are disabled by default upon install.
The provided example workflows can be used to enable the functionalities as described below.
- Update currency rates using Currency Types page.
- Update currency rates using Currency Rates Page.
- Update currency rates using Tasks for Currency Updates page.
- Synchronize currency rates between companies using Centralized Currency Rate Handling page.
Currency Rate Update Overview¶
When a user configures a third-party webservice to retrieve currency rates, in accordance with the workflows detailed above, the latest currency rates will be synchronized with the IFS Cloud upon the execution of the Update Currency Rates command.
Setup Currency Rate Update Workflow Diagram¶
-
[ ] Navigate to the Workflow ID finCurrencyTypeUpdate
-
[ ] Clone the workflow to a new version.
-
[ ] Open the cloned version in the Design mode.
-
[ ] Select the Activity named Set Web Service URL
-
[ ] Enter the URL of the third-party webservice used to fetch the currency rates in the Script field.
-
The provided example utilizes the following Web Service URL: https://api.currencyapi.com/v3/latest.
-
If the user wants to use an alternative webservice, the Workflow Diagram should be adjusted to align with the specific requirements of the chosen webservice, encompassing both the request and response aspects. Please refer to the Workflow Tooling for guidance on making these modifications.
-
[ ] Select the activity named Set WebService API Key.
-
[ ] Enter the Webservice API Key in the Script field.
Setup Update currency rates using Currency Types page.¶
-
[ ] Navigate to Workflow ID finCurrencyTypeUpdate
-
[ ] Confirm & enable projection actions.
| Projection Name | Action Type | Call Name | Workflow Type | Workflow Timing |
|---|---|---|---|---|
| CurrencyRateTypesHandling | CALL | UpdateCurrencyRatesFromWorkFlow | Process Enrichment | Before |
- [ ] Once it is enabled, the Update Currency Rates command button will become enable in the Currency Rate Types page when a specific row is selected.
Setup Update currency rates using Currency Rates Page.¶
-
[ ] Navigate to Workflow ID finCurrencyTypeUpdate
-
[ ] Confirm & enable projection actions.
| Projection Name | Action Type | Call Name | Workflow Type | Workflow Timing |
|---|---|---|---|---|
| CurrencyRatesHandling | CALL | UpdateCurrencyRatesFromWorkFlow | Process Enrichment | Before |
- [ ] Once it is enabled, the Update Currency Rates command button will become enable in the ** Currency Rates ** page.
Setup Update currency rates using Tasks for Currency Updates page.¶
-
[ ] Navigate to Workflow ID finUpdateCurrencyRatesForCurrencyTask
-
[ ] Confirm & enable projection actions.
-
[ ] Enable Online execution option.
| Projection Name | Action Type | Call Name | Workflow Type | Workflow Timing |
|---|---|---|---|---|
| TasksForCurrencyUpdatesHandling | CALL | UpdateCurrencyRatesFromWorkFlow | Process Enrichment | Before |
- [ ] Enable Background execution option.
| Projection Name | Action Type | Call Name | Workflow Type | Workflow Timing |
|---|---|---|---|---|
| TasksForCurrencyUpdatesHandling | CALL | ExtCurrencyTask_UpdateCurrencyRatesFromWorkFlow | Process Enrichment | Before |
- [ ] Once it is enabled, Update Currency Rates command button will be enabled in Tasks for Currency Updates page for the Task IDs created with the Task for Workflow check box is checked.
Setup Synchronize currency rates between companies using Centralized Currency Rate Handling page.¶
-
[ ] Navigate to Workflow ID finCentralCurrencyHandling
-
[ ] Confirm & enable projection actions.
| Projection Name | Action Type | Call Name | Workflow Type | Workflow Timing |
|---|---|---|---|---|
| CentralizedCurrencyRateHandling | CALL | UpdateCurrencyRatesFromWorkFlow | Process Enrichment | Before |
- [ ] Once it is enabled “Update Currency Rates” command button will be enabled in the Centralized Currency Rate Handling page for the records with the Active status.