Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

These are the methods for doing lookups in conversion tables.

ConversionLookup[LookupType]Value(string conversiontablename, string returncolumn, string searchcolumn[N], string searchvalue[N], …, string suppressExceptions)

This is a template for the methods used for performing a conversion table lookup.

...

Each of the three lookup types support between 1 and 5 pairs of search columns and search values.

string suppressExceptions

This parameter is optional. If it is not used in a call, the lookup method will never fail, it will simply return an empty string if anything goes wrong, such as the conversion table not existing, or one of the lookup values being blank. If you explicitly want the map to fail in one of those situations, add the parameter to the end of the call as false() or ‘false’.

While the parameter is logically a boolean value, it is implemented as a string to make it “play nice” with XSLT.

Link settings

Should you have a need for it, you can get the value of any Link setting on the system.

...

These are the methods used for error handling.

RaiseError(string message,

...

string retryAllowed)

This method is used for making a document intentionally go into Failed status in Link.

...

The retryAllowed parameter should always be set to false() or ‘false’ except in very specific cases. Any error that stems from faulty input data will not be resolved by trying to map the faulty data again. While the parameter is logically a boolean value, it is implemented as a string to make it “play nice” with XSLT.

RaiseError(string message, string errorCode,

...

string retryAllowed)

This method is the same as above, but allows you to register the error with a specific error code. If you have a known error scenario that you know a specific department needs to take care of, you can register the error code in Link and assign a specific stakeholder to it. Then any time a document fails with that specific error code, the stakeholder will be notified.

RaiseError(string message, string errorCode, string documentStatus,

...

string retryAllowed)

This method is the same as above, but allows you to set a specific document status rather than defaulting to “Failed”.

...