Running Ibistic Integration Framework Manually


Note: This article is aimed at IT professionals or server administrators having access to the server hosting the Ibistic Integration Framework for your company.

Ibistic masterdata and invoice integration run automatic per schedule, set by Task Scheduler on the server. In the case you wish to run it immediately and not wait for to the next scheduled run, or if you would like to run it for troubleshooting purposes, this article describes how to do this.

To manually force the integration to run, you may open the Task Scheduler:



To manually force the integration to run, you may open the Task Scheduler, and locate the ibistic tasks for masterdata/chart, invoice (and expense if you use it).



Running the masterdata / chart task manually

To upload latest masterdata to Ibistic, simply right click on the Ibistic Chart task, and select "Run":



Running the invoice import task from Ibistic manually

Likewise, to force import of latest transferred invoices in Ibistic, you may right click on the Ibistic Invoice Import task, and select "Run":



Running Ibistic Integration in a command window

Alternativelly, you may also run the integration manually outside the task scheduler, by opening a command window. In this scenario, you should first make sure you are logged in with the same windows user on the server used to run the Ibistic Integration through Task Schedule. You may verify the user you are logged in with by opening a command window and enter "whoami". Example screenshot with the command and result:


Being logged in with the same user as integration normally runs on is very important, because a certificate was installed on the user when the integration was installed, and this certificate is required in order for the integration to communicate with Ibistic.


From the command prompt you may run the Ibistic.Integration.Host.exe file with either the "parameters.xml" extension for masterdata/chart or the parameters_invoiceimport.xml for invoice import. The filepath depends on where you have Ibistic Integration Framework installed, but it should look something as described below.


Running Masterdata / Chart from command prompt

Here is an example command for chart / masterdata "C:\Ibistic Integration Framework>Ibistic.Integration.Host.exe parameters.xml"


(adjust path according to the current install path of ibistic integration framework)


Running Invoice import from command prompt

Here is an example command for invoice import "C:\Ibistic Integration Framework>Ibistic.Integration.Host.exe parameters_invoiceimport.xml"


(adjust path according to the current install path of ibistic integration framework)


Execution log

You may observe the end result, if the integration run without error by inspecting the executionlog.txt file in the Ibistic Integration Framework folder.


If running the invoice import, you should also observe new files in the invoice import and and invoice backup folder, and if you run chart integration (masterdata), the chart of accounts in Ibistic should be updated shortly after.


Errors in execution log

In the event the job failed, this will be described in the execution log, with a path to the file name in the log folder:


The corresponding log file with details of the error found in the log folder:


The error described in the relevant file, will explain exactly what went wrong, which may give a clue how to resolve the problem. If unsure what the error means, please forward the full log entries and details to Ibistic Support.


Related articles:
Troubleshooting integration problems
Server Migration Guidelines