Context attributes

In addition to the extra data attached to messages transferred from activity to activity, the integration engine owns a global dictionary of data. The contents of this dictionary can be used anywhere in the integration engine and is permanently stored (restored even after a system crash).

Entries in this dictionary are called context attributes. With three specific DML built-in functions, you can either insert a new entry in this dictionary, read or remove an existing entry.

  • To insert a new entry, call the setContextAttribute function and specify the key (a string) and the value (another string) you want to link. You receive an exception if the key already exists in the dictionary.
  • To read an entry, call the getContextAttribute function. You specify the key and you always receive a string value. When no entry for the specified key exists in the dictionary, the call evaluates to the absent symbolic value.
  • To remove an existing entry, use the removeContextAttribute function with the key as the unique argument. An exception is raised if the key is not present in the dictionary.

Unlike message attributes, context attributes are global and not attached to any other data. They are the privileged way to store permanent information that might be used in multiple integrations and by multiple proc-engines.

Related Links