Skip to content
View Categories

Configuration

34 articles

Permissions required in SQL Server to create and maintain a BPA Platform SQL store

Last Updated: August 1, 2022

Introduction The BPA Platform Configurator uses the credentials of a SQL Server account to either create a new store or connect to one that already exists. Sufficient permissions on the account must be in place to allow these actions. The SQL account provided will be used by BPA Platform to maintain the store, i.e. read from...

How to rebuild the BPA Platform internal store

Last Updated: September 7, 2022

Learn how to rebuild the BPA Platform internal store.

Configuring the Web Service Connector Tool to work with a proxy server

Last Updated: June 28, 2022

Summary Where an organisations internet access is via a HTTP web proxy, TaskCentre must be manually re-configured to force HTTP traffic through the proxy. Prerequisites TaskCentre has to be installed and configured The Web Service Connector Tool has to be installed Instructions Open the file iwtskrun.exe.config (may also be known as iwtskrun.config) in the TaskCentre...

Web Service Connector tool – How to map a Constant to a HTTP header

Last Updated: June 28, 2022

In some cases a web service may require authentication or a string passed in the header. If this needs changing or editing you may want to use a Constant. This will allow you to make the change once instead of changing every operation. This can be achieved as follows: Open your web service global connection...

Web Service Connector Tool – Using Basic Authentication to connect to a web service

Last Updated: July 28, 2022

Symptom When testing the connection to a web service it complains that you are using Anonymous instead of Basic. i.e. WSCT is not using the right authentication. The following error occurs: System.ServiceModel.Security.MessageSecurityException: The HTTP request is unauthorized with client authentication scheme 'Anonymous'. The authentication header received from the server was 'Basic Realm="webservices4.autotask.net"'. ---> System.Net.WebException: The...

How to monitor encrypted HTTP sessions from a web proxy

Last Updated: September 5, 2022

How to monitor encrypted HTTP sessions from a web proxy.

How to configure the Web Service Connector Tool for RSS feeds

Last Updated: August 3, 2022

Introduction This article will show how the Web Service Connector Tool can be configured to enable web service calls to retrieve RSS feed data from a web page. This is achieved by creating a new HTTP based web service configuration which will be used to perform a GET operation on a specified RSS feed at...

Run External Program step fails at task runtime with error 0x80070522 “A required privilege is not held by the client”

Last Updated: September 2, 2024

Symptom When a task that uses impersonation contains a Run External Program step that runs a batch file it may fail at runtime with the following error: 0x80070522 “A required privilege is not held by the client” Cause Occurs where the impersonating account does not have sufficient rights to logon as a batch job. Resolution...

The BPA Platform event log has to be deleted frequently due to reaching high capacity

Last Updated: August 31, 2022

Symptom The BPA Platform event log increases in size very quickly and has to be deleted frequently.  Cause One or a number of tool packs installed have extended logging turned on. When this mode is set, it records the inbound and outbound data to the BPA Platform event log, causing it to increase in size at...

An error has occurred while processing: Initialization Error details: Cannot decode the product key

Last Updated: June 29, 2022

Symptom When you run the Configurator the following error message is received: An error has occurred while processing: Initialization Error details: Cannot decode the product key Cause Caused by an expired main product key license (You will also find that tasks cannot be run.) Resolution The resolution is to renew the main product key license....

Unable to open the BPA Platform configurator on the client machine: Error “Cannot retrieve the product key”

Last Updated: June 29, 2022

Symptom Once the BPA Platform client has been installed onto a workstation, you are unable to open the configurator to complete any required configuration settings. The following error is displayed: An error has occurred while processing:Initialization Error details: Cannot retrieve the product key Note: This message will only be displayed when trying to launch the...

Configuring Impersonation – Allowing BPA Platform to access a remote network location such as a shared folder or printer

Last Updated: June 29, 2022

When tasks run on the BPA Platform Server, by default they will run using an account called Local System. This account has a set of rights to perform various activities but generally does not have sufficient network permissions to allow access rights to tasks, this often results in tasks failing. The impersonation feature specifies how...

A task is failing at run time with the following error: “Could not load file or assembly”

Last Updated: June 29, 2022

Symptom A task is failing at runtime and errors similar to the following are being produced: TIAPI: Type Information Error while loading tool assembly for step SAP Business One Connector. See Windows Event Viewer for more details. The Windows application log will display something similar to the following: Could not load file or assembly 'file:///C:\Program...

Task fails at runtime with error: Task initialisation failure, error code 0x80040300

Last Updated: June 29, 2022

Symptom When a task contains many connection steps an initialisation failure can occur. The following system error is recorded to the event log: Error code: 0x80040300 Description: Task initialisation failure This can occur when the following types of connection steps are in use: Web Service Connector Database Query (ODBC or OLEDB) External Memory (ODBC or...

Task fails at runtime with the error: “System.UnauthorizedAccessException: Access to the registry key….is denied”

Last Updated: June 29, 2022

Symptom A task is failing at runtime and is producing the following error message: System.UnauthorizedAccessException: Access to the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Orbis Software\TaskCentre\Providers\{B30672F2-176C-4F71-A35E-8C50A99BE230}\parameters’ is denied. Cause A “parameters” key that the task is expecting to be present is missing for the associated registry key: {B30672F2-176C-4F71-A35E-8C50A99BE230} Solution Manually add the missing parameter key within the registry at...

Task Run Failed, error code 0x8007007e

Last Updated: June 29, 2022

Symptom Task failing at run time with the following error code: “Task Run Failed”, error code 0x8007007e Cause The fault mode occurs when the VBScript COM registration in the registry has been changed to point to a proprietary dll. This change is typically caused by Anti-Virus software as part of a ‘defence in depth’ approach....

Task Runtime Error: The connection used cannot be found in the global configuration

Last Updated: June 29, 2022

Symptom At task runtime a step with a database connection fails with the following error message even though the connection is present in the global configuration: “The connection used can not be found in the global configuration” Solution Navigate to the TaskCentre registry key. On 32 bit systems: HKLM\SOFTWARE\Orbis Software\TaskCentre On 64 bit systems: HKLM\SOFTWARE\Wow6432Node\Orbis...

BPA Platform has stopped working, tasks are failing when queued to run

Last Updated: June 29, 2022

Symptom All tasks are failing to run when they are queued, the BPA Platform event logs will display ‘initialisation failure’ error messages. Cause A likely cause would be that the license for  your SQL Server Store has expired. This may mean that your 30 day evaluation period has finished or your purchased license has come...

myBPAPlatform Graphics Not Displaying Correctly

Last Updated: July 12, 2022

Introduction The article aims to explain how to ensure embedded graphics are displayed correctly in your myBPAPlatform workflow portal. Scenario After configuring myBPAPlatform, you see this when launching the web portal: Resolution Missing graphics in the web portal is caused by Static Content not being enabled for your web server. Do the following: From the...

Call COM tool fails at design time with error: The operation failed 0x8002802b

Last Updated: July 1, 2022

Symptom You have a .NET assembly that you are calling from COM. From within the Call COM action you can view and select the object, but when you save the object it fails with the following error: The Operation failed 0x8002802b Cause The Call COM tool was not accepting types generated from a COM callable...

Select Publishing Site drop down list not populated when you select a remote web server

Last Updated: July 1, 2022

Symptom After you select a remote web server under the Publishing tab of the Create Workflow Job tool, the Select Publishing Site drop-down list does not get populated. Cause The user has insufficient rights to access IIS objects on the remote machine. The Create Workflow Job tool connects to the IIS objects on the web...

System.Unauthorized Access Exception: Retrieving the COM class factory for component with CLSID failed

Last Updated: July 1, 2022

Symptom After opening a workflow job through the web browser you may get the following exception page. System.UnauthorizedAccessException: Retrieving the COM class factory for component with CLSID {B5DF154A-A87D-4858-8B32-9F60B3E62B65} failed due to the following error: 80070005 Cause The account that the web site application pool runs under does not have sufficient permissions to call onto Workflow...

‘Select Publishing Site’ drop-down list does not display a list of websites

Last Updated: July 1, 2022

Symptom Under the ‘Publishing’ tab of the ‘Create Workflow Job’ tool, the ‘Select Publishing Site’ drop-down list does not display a list of websites. Cause Caused by Windows User Account Control (UAC) preventing access to the Windows Management Instrumentation (WMI) interfaces from the BPA Platform client. You are more likely to experience this issue on...

Letters with accents display a black diamond symbol

Last Updated: February 14, 2023

Symptom When writing text to a web service which includes special characters, for example letters with accents above them, the characters are replaced with the symbol; Example: Text containing the German word “Für” will appear as “Fr” Cause The special characters used are unknown to the encoding and fall outside of the ASCII character set...

FTP Connections

Last Updated: July 31, 2023

Global configuration of FTP connections The BPA Platform administrator is responsible for global connections. This is to ensure connections are ready for use by task designers. One of these global configurations is that of FTP connections. These connections are needed for task steps involving the transfer of files using FTP (file transfer protocol). File transfer...

Configuring Web Service Connections

Last Updated: July 22, 2022

The TaskCentre Server contains the functionality to connect and use web enabled product API’s. The Web Service Connector is used to call a web service operation and return the response from the web service as data content which can be used in the task. It is capable of working with a very wide range of...

BPA Platform Administration

Last Updated: August 17, 2022

System Administration – Introduction There are a number of major roles involved in the implementation and use of the BPA Platform product. One of these roles is the BPA Platform administrator. The person assigned to this role would have a good knowledge of the organisation’s infrastructure and of the authentication particulars needed for BPA Platform...

Background to the Bank of England URL

Last Updated: July 29, 2022

For your convenience, the URL for the currency rate conversion service that we’re using in this example is provided here. You can use this link to practise making the changes demonstrated in our example. http://www.bankofengland.co.uk/mfsd/iadb/fromshowcolumns.asp?Travel=NIxIRxSUx&FromSeries=50&DAT=RNG&FD=1&FM=Jan&FY=1963&TD=23&TM=Jun&TY=2011&VFD=Y&CSVF=TT&C=C8J&Filter=N&xml.x=8&xml.y=11 For configuring REST connections, you need to understand a little about the structure of URLs. The structure is more straightforward...

Run Sage 50/200 Report – Global Configuration

Last Updated: August 1, 2022

This knowledgebase article will show how to setup a connection between TaskCentre and a Sage 50 or 200data source. Once configured this will allow reports to be accessed by a task using a Run Sage 50 & 200 Report step. The global configuration for the tool can be accessed via the toolbar: Manage -> Tools...

Saving and Printing Files

Last Updated: August 17, 2022

Introduction Global configuration is done so that connections are ready for use by task designers. Among the connection configurations that can be considered are those used in steps that produce data files as output, to be saved or printed. Steps that produce files as output Steps can produce a wide variety of output. Besides email,...

Configuring Office 365 send mail authentication

Last Updated: November 2, 2022

Changes have been applied by Microsoft to Office 365 send mail authentication settings, these setting were previously enabled by default. This article guides you through the steps required to configure Office 365 send mail authentication for BPA Platform.

Valid certificate .pfx file password rejected by Web Service Connector Tool

Last Updated: November 2, 2022

The Web Service Connector tool rejects valid certificate password.

Update Concur Vendor API

Last Updated: June 30, 2023

As part of changes to the Concur Vendor API, a small amendment to the version number in the endpoint URL is required. Mandatory field mappings that have arisen as part of this change, are already mapped in the solution, therefore no further action is required in BPA Platform, However, please ensure all suppliers in your...

Partial Global Configuration

Last Updated: December 7, 2023

Previously, any partially created global configurations would have been lost, however, the new functionality prevents this. Benefits include, the ability to store configurations without sensitive information, such as credentials, when exporting your tasks for a client. Or simply to return to the configuration later. For this example, we will demonstrate this with the Microsoft SQL...