Addovation Stream - Setup Guide(Customer)

Last Updated: 2025-06-25

Overview

This customer setup guide provides a comprehensive overview and step-by-step instructions for configuring the Addovation Stream on IFS Cloud. It details the essential tasks the customer needs to perform, including gathering data and calling stream services, deploying the utility to gather data, creating a queue, importing the application configuration package, deploying the projection, and enabling communication. Each step is thoroughly explained to ensure a smooth and efficient setup process, empowering the customer to successfully configure the Addovation Stream on their IFS Cloud environment.

Setup IFS Cloud

Gather Data & Call Stream Service

Create Queue “ADDO_DOCGEN_OUT” in IFS Connect to Call the Stream Service

Go to Message Queues and Click on + option.

Provide the Instance name to continue.
Provide a description and select Insequence as the Execution Mode.

Import Application Configuration Package

This section explains configuring a button to call the Stream Service.

This package Contains,
- Projection configurations.
- Page Configurations for Prepare Work Order window.
Download the application configuration package file here
Now go to Solution Manager-> Configuration -> Application Configuration Packages -> Import Configuration -> Import Configuration Package.
Provide the package file as below.

After successful configuration, you can see the Create DocGen Report in Prepare Work Order as below.

Open Up for Communication

Import Routing Addresses

Download the RoutingAddress_Addovation DocGen Service.xml located here
Go to Solution manager-> Integration -> IFS Connect -> Import Configuration.
Brows the downloaded file and set the Import Method as Add and click on Import.

Navigate to the created routing address. Set the Rest Root Endpoint to the HTTP POST URL in IFStoDocGenUtil, which was copied at the end of step 2.2.

Import Routing Rules

Download the RoutingRule_Addovation DocGen integration routing rule.xml file from Routing Rules
Go to Solution manager-> Integration -> IFS Connect -> Import Configuration and Brows the downloaded file and set the Import Method as Add and click on Import.

Allow Access from IFS to IPs

Below logic app in Addovation tenant needs access to the customer’s IFS environment.

IP whitelisting for Logic App (sending Queue messages /upload images to the Blob) /(inbound)

Network Configurations

Click here to read details about network configurations.

IFS Integrations

Make sure you add the token generating user to company and site
Two quick reports must be generated to get details from IFS

Create new “Quick Report”

Select New Report
Fill relevant info as follows
Report title – A report name of your choice
Type – “SQL Statement” must be selected from dropdown
Category – Create a new Category in Report Category or select an existing one

Query Details – SQL query for the report

Queries

Query to fetch work order details SELECT wo_no, reg_date, err_descr, plan_hrs,reported_by, mch_code, mch_code_description, customer_no FROM ACTIVE_SEPARATE WHERE WO_NO ='&WO_NO'
Query to fetch work order tasks SELECT ORDER_NO, WO_NO, SITE, LONG_DESCRIPTION, REPORTED_BY, REPORTED_DATE from ifsapp.jt_task WHERE WO_NO='&WO_NO'

After creating the two quick reports, view details of them and projection name can be fetched as follows.

Get the numerical value from projection name and replace them in following fields in manifest. E.g.: QuickReport97831 -> 97831

orderDetailsQuickReportId – Query to fetch work order details report’s projection name numerical value
orderTasksListQuickReportId - Query to fetch work order tasks query report’s projection name numerical value

Setup Azure

Logic App for IFS Integration

Go to the Azure Portal’s main page and search for Logic Apps and select.

Add new Logic App.

Select Workflow Service Plan Hosting Plan and click Select.

Enter required fields and click on create button.

Subscription: Select the subscription you use.
Resource group: Create Resource group by clicking ‘Create new’ and enter a proper name for the resource group and click ‘OK’

Or else
- select the resource group which has created in step Resource group. (Resource group should be the same for other resources as well).

Logic App name: give the app name as “HandleGroupSubscriptions”.
Region: use same region as in Resource Group.
Windows Plan: Select an existing Plan or create a New App Service Plan.
Pricing Plan: Select plan type as Standard and choose a Resource Group before selecting a plan.
Zone Redundancy: Make sure to select zone redundancy as Disable.

After logic app is created successfully -Click on “go to resources”, this will redirect you to Logic App overview page. Go to "workflows"

Click Add, select Select Stateful and Enter a proper name for workflow Name, and click on Create.
It will navigate to the WorkFlow designer and click on Code and delete existing content.

Go to StreamIFSIntegration.txt from the Release Packages.
Copy the content of StreamIFSIntegration.txt,
And change the content as below.
- Give the IFS client id, client secret values for client_id / client_secret each place in code view as below.

- Give the HTTP POST URL of **IFStoDocGenUtil** logic app, as Url.

	- Give IFS Access Provider URL and Releam for as below

Give IFS Access Provider URL for below lines.

• Select change connection

Add Required fields and click Create New

• Connection Name: Connection name of your preference • Authentication Type: select storage account connection string • Storage Account Connection String: Copy the connection string from your blob storage as shown below

Navigate to the Access Keys section of Azure Storage Account. Click the Show button next to key1 Connection string and Copy the value. Enter the copied value.

Change connection of “Upload blob to storage container” request as follows

Select the added connection in above step.