Task Cancelation Utility

About the Hornbill Task Cancelation Utility

The utility provides a simple way to either cancel tasks from within the Hornbill Collaboration Tool. The tool is designed to run behind your corporate firewall, and requires access to your Hornbill instance.

The tool connects to your Hornbill instance in the cloud over HTTPS/SSL, so as long as you have standard internet access then you should be able to use the tool without the need to make any firewall configuration changes.

When the tool is executed, depending on configuration, a list of tasks will be cancelled.

Open Source

The Hornbill Service Manager Request Import Utility is provided open source under the Hornbill Community Licence and can be found Here on GitHub

Installation Overview

Windows Installation

• Download the OS and architecture specific ZIP archive
• Extract zip into a folder you would like the application to run from e.g. C:\data\
• Open a Command Line Prompt as Administrator
• Change Directory to the folder containing the utility C:\data\
• Determine the appropriate executable and possibly rename it to remove confusion.
• Run the command relevant to the OS of the machine you are running this on:

Windows:

taskCanceller.exe -instance=testinstance -api=abc...def -listfile=C:\data\tasks.csv

taskCanceller.exe -instance=testinstance -api=abc...def -taskref=TSK1234567

Command Line Parameters

• instance - Name of the Hornbill instance to connect to
• api - the API Key to use to connect to the aforementioned instance
• taskref - allows for the cancelation of a single task
• listfile - path to text file with a list of task references to cancel. One task reference per line.
• delete - Set to true to delete the task(s), defaults to false and the cancellation of the task(s)

API Key Rules

This utility uses either (API keys):

• task:taskCancel
• task:taskDelete

Troubleshooting

HTTP Proxies

If you use a proxy for all of your internet traffic, the HTTP_PROXY Environment variable needs to be set. The https_proxy environment variable holds the hostname or IP address of your proxy server. It is a standard environment variable and like any such variable, the specific steps you use to set it depends on your operating system.

For windows machines, it can be set from the command line using the following:
set HTTP_PROXY=HOST:PORT
Where "HOST" is the IP address or host name of your Proxy Server and "PORT" is the specific port number.

Logging Overview

No logging apart from a summary at the end and errors/issues will be reflected in the command terminal

Extras

Bundled with the app is a file open-tasks-on-cancelled-requests.report.txt which is a Service Manager report export which can be imported to identify orphaned tasks (i.e. live tasks which connected to cancelled requests).