IFS Cloud
Installation Guide for Travel and Expense Cloud
Last updated
Installation Guide for Travel and Expense Cloud
Last updated
This document will provide guidance on installing and configuring the Travel and Expense App.The Travel and Expense App contains 6 separate workflows.
* Azure Form Recognizer is only needed for automatically scanning receipts. If that functionality is not needed it can manually be removed from the workflow.
If you plan to utilize the Email Receipts and Email Receipts Service, set up a storage account for Blob and Table storage, Set Up Azure Storage Account.
If you plan to utilize the Create Expense - Scan Receipt functionality or Email Receipts and Email Receipts Service, set up a Form Recognizer Cognitive Service, Set Up Form Recognizer. More information on Form Recognizer pricing can be found here.
If you plan to utilize the Email Receipts and Email Receipts Service, create an App Registration for reading emails and attachments in a unified inbox. The App Registration needs Mail.ReadWrite permissions to be able access the mailbox. Read more in the how-to guides Create App Registration and Limit Permissions to a Specific Mailbox.
If you do not have a connector set up, you can see an example here.
If you already have an IFS Cloud OData connector setup, you can skip this step and use the existing connector instead.
For how to add a new projection to the connector click here.
Used Projections in Workflows
If you don't have a connector set up, you can see an example here.
If you don't have a connector set up, you can see an example here.
If you don't have a connector set up, you can see an example here.
A REST Connector Project must be set up to utilize the Microsoft Form Recognizer Cognitive Service.
Create a new REST Connector named "Microsoft Form Recognizer v3.0" and import the configuration file "Microsoft Form Recognizer v3.0.ncrcp", for more information see Import a REST Configuration.
After the connector has been imported, navigate to the connector Authentication and select “…” to the right of API Keys
Replace the apiKeyHeader and the apiKeyQuery with KEY 1 from your Microsoft Form Recognizer Cognitive Service
Select “Save” to save the API Keys
Select “Save” to save the REST Connector Configuration
A REST Connector Project must be set up to utilize the Microsoft Azure Blob Storage Service. The blob storage is used for temporary storing emailed files until the user has handled the receipt i.e., turned into an expense.
Create a new REST Connector named "Azure Blob Storage" and import the configuration file "Azure Blob Storage.ncrcp", for more information see Import a REST Configuration.
After the connector has been imported, navigate to the connector Authentication and select “…” to the right of API Keys
Enter the information from your shared access key for your storage account
Select “Save” to save the API Keys
Select “Save” to save the REST Connector Configuration
Connector setup completed
A REST Connector Project must be set up to utilize the Microsoft Azure Table Storage Service. The table storage is used for temporary storing information about emailed receipts.
Create a new REST Connector named "Azure Table Storage" and import the configuration file "Azure Table Storage.ncrcp", for more information see Import a REST Configuration
After the connector has been imported, navigate to the connector Authentication and select “…” to the right of API Keys
Enter the information from your shared access key in your storage account
Select “Save” to save the API Keys
Select “Save” to save the REST Connector Configuration
Connector setup completed
A REST Connector Project must be set up to utilize the Microsoft Graph API. The connector will be used to read messages and fetch attachments in the unified inbox for receipts.
Create a new REST Connector named "Microsoft Graph Expenses" and import the configuration file "Microsoft Graph Expense.ncrcp", for more information see Import a REST Configuration
After the connector has been imported, navigate to the connector Global parameters and select “…” to the right of Edit parameters.
Enter your Client ID and Client Secret from your application registration.
Enter the directory tenant that you want to request permission from. This can be in GUID or friendly name format.
Select “Save” to save the Global parameters
Select “Save” to save the REST Connector Configuration
Connector setup completed
Before installing the workflows, it is required to create several Global Flow Properties within Novacura Flow Studio.
Make sure that you have created all connectors and Flow properties before importing the workflows.
Import workflows in the file "Expense Reporting.wap".
There are some workflows that have multiple IFS connectors, these should be mapped to the same IFS connector when the import is done. The different connectors are only used for demo purposes.
For detilas see Import Workflows
Together with the imported workflows there will also be a menu. Connect the menu to your roles to make them available for users.
For details see Setting Menu Roles
Within the Server Contents Window right click on the Expense Reporting folder and select “Publish”. This process can take a few minutes but once complete, a Publish Successful message will be displayed.
If you receive any errors during the publication of the workflow. Please review the error detail and consult your support contact with the relevant information.
The workflows will now be available to execute on your chosen Flow client. For instructions on individual Travel and Expense functions, please consult the function individual documentation provided separately.
For details see Publishing Workflows
App
Required Connectors/Services
Create Expense
IFS, File System, Azure Form Recognizer*
Review Expenses
IFS, File System
Confirm Expenses
IFS, HTML to PDF
Approve Expenses
IFS, Email
Emailed Receipts Service
Email, Azure Storage Account, Microsoft Graph, Azure Form Recognizer*
Emailed Receipts
IFS, File System, Azure Storage Account
System
Version
IFS Applications
IFS Cloud 23R1
Novacura Flow Server
6.15.3
Novacura Flow Studio
6.15.5
Connectors
OData v2.1.23, File System, REST Service, Send E-Mail, Convert HTML To PDF
Flow Property
Example Value
Description
AppOwner
ifsapp
IFS environment application owner (Schema).
EnvironmentUrl
server.dev.novacuracloud.net
Base address for the temporary image of the receipt to be viewed by the Image Viewer User Step element.
LocalImagePath
D:\home\site\wwwroot\images
Local server folder for image of the receipt to be viewed by the Image Viewer User Step element. Should be somewhere under the www root.
ExpenseDocClass
EXPENSE
Document class for the expense report that will be added to the expense sheet header when the expense sheet is confirmed.
ExpenseAdmin
admin@example.com
If something goes wrong in the background workflow for receiving emailed receipts, the error message will be sent by email to this address. Multiple email addresses can be added as comma separated values.
ExpenseBlobContainerName
expense-files
Name of the container to be used in the blob storage for temporarily storing emailed receipt files.
ExpenseInboxAddress
expense.receipts@example.com
The email address for the unified inbox receipts.
ExpenseInlineAttachments
True
Include inline attachments in messages or not for emailed receipts.
ExpenseTableName
Receipts
Name of the table to be used in the Table Storage Service.
ExpenseTablePartitionKey
novacura-labs
Name of the partition key to be used in the Table Storage Service. Every record in a table needs to have a partition key set.
Flow Property
Columns
Example Value
Description
ExpenseDomains
Domain
novacura.com novacura.se
Valid domain names for the emailed receipts. Only senders from the specified domains will be handled by the workflow. Messages from other domains will be deleted.