Writing Tachyon Instructions
Integrating with Tachyon
Tachyon RunInstruction command-line tool
Consumer API reference
Tachyon .NET Consumer SDK
Using scope and filter expressions
How to guides
Add and remove Instruction Definitions and organize them into Instruction Sets
Deal with connected devices running Tachyon Agent (now part of 1E Client)
Find the right instruction definition
Handling errors returned by Tachyon
Issue an instruction, track its progress and retrieve responses
Set up in instruction to be executed on a schedule
Set up Principals, Roles and Permissions
- Add and remove Instruction Definitions and organize them into Instruction Sets
The Error object
The Error object has 3 properties:
- ErrorCode - the internal Tachyon error code described in error code
- Message - a localized message displayed to a user
- Data - localization data, see localization.
Although these properties are always present, only Message is intended for end users.
Error code is designed to help support and development teams diagnose the error.
Because it's a string instead of a number it should be descriptive enough in most circumstances. The error code can be used by an end user to determine what the error is, although it's better to use the Message field as this will contain more details about why the error occurred and possible help about how to fix the error.
Localization is not currently supported. All errors are in English.
To support Localization in the future a Data array is included, containing non-translatable parts of the error message. However, at this time, you can ignore this array.
Errors in Consumer API SDK
If you're using Consumer API .NET SDK, the errors are returned inside the ApiCallResponse class in the property called Errors, which is a collection. If the call was unsuccessful and the Success property is set to False, the Errors collection should contain the errors received. The Error class (contained by the Errors collection) has an additional field called ErrorType:
If ErrorType is equal to "Tachyon":
Means the error was returned by the Tachyon Consumer API and it will have the structure described above.
If ErrorType is equal to "Exception":
Means an exception was thrown inside the SDK either during the course of the HTTP call itself, or during subsequent model de-serialization. The exception's message, along with messages for its inner exceptions, will be in the Message property.
If ErrorType is equal to "Other":
Means that another type of error has occurred. This most likely means that although the HTTP call itself concluded successfully, the HTTP status code received indicated an error but the error could not be translated to the standard Error structure seen above. It might have been, for instance, an HTML page. This can happen if the address for Consumer API is incorrect and the SDK contacts an address that does not belong to Consumer API, or if the request is rejected by IIS without being processed by Consumer API at all.
Finding out more about the error
To find out more about the error, look in the Consumer API and Coordinator service log files. These log files are found on the server where the Tachyon master stack is installed, by default under %PROGRAMDATA%\1E\Tachyon