Chapter 39. Dictionary

Dictionary is a data storage object associated with each run of a graph in CloudConnect. Its purpose is to provide simple and type-safe storage of the various parameters required by the graph.

It is not limited to storing only input or output parameters but can also be used as a way of sharing data between various components of a single graph.

When a graph is loaded from its XML definition file, the dictionary is initialized based on its definition in the graph specification. Each value is initialized to its default value (if any default value is set) or it must be set by an external source (e.g., Launch Service, etc.).

Important

Two versions of CloudConnect Transformation Language differ on whether dictionary must be defined before it is used, or not. CTL1 CTL1 allows the user to create dictionary entries without their previous definitions using a set of dictionary functions. See Dictionary Functions CTL2 Unlike in CTL1, in CTL2 dictionary entries must always be defined first before they are used. The user needs to use standard CTL2 syntax for working with dictionaries. No dictionary functions are available in CTL2. See Dictionary in CTL2

Between two subsequent runs of any graph, the dictionary is reset to the initial or default settings so that all dictionary runtime changes are destroyed. For this reason, dictionary cannot be used to pass values between different runs of the same graph.

In this chapter we will describe how a dictionary should be created and how it should be used: