Contents
-
Writing Tachyon Instructions
-
Integrating with Tachyon
-
Introduction
-
Tachyon RunInstruction command-line tool
-
Consumer API reference
-
Using scope and filter expressions
-
How to guides
-
Add and remove Instruction Definitions and organize them into Instruction Sets
-
Find the right instruction definition
-
Getting data from Tachyon clients
-
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, for Tachyon version 8.0 and later
-
Set up Principals, Roles and Permissions, up to and including Tachyon version 5.2
-
Add and remove Instruction Definitions and organize them into Instruction Sets
-
Introduction
-
Tachyon .NET Consumer SDK
-
Tachyon PowerShell Toolkit
-
Index
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
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
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.
Example error
[ { "ErrorCode": "InstructionDefinition.CannotDeleteDueToPendingInstructions", "Message": "Instruction definition 1E-Explorer-TachyonCore-BiosDetails cannot be deleted because there are pending instructions based on it.", "Data": [ "1E-Explorer-TachyonCore-BiosDetails" ] } ]
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