Load / Save definitions

Integration artifacts are grouped into projects so that it is easy to organize them and to share them among different integration tasks. You can easily copy actions and data sources from one project to another when both projects are running on the same application by dragging and dropping, see Drag or copy and paste. However it is sometimes useful to share these resources among projects running on a different instance of the application, i.e. running on a separate system. In this case dragging or copying is not possible and you will instead use the Save definition and Load definition options. Load definition imports a new resource into a project while Save definition saves it for export to another system. For example you may want to reuse an activity or data source which has already been defined for a different task. It is often quicker to alter an existing action or data source than to define a new one from scratch. Or it may be that someone else has developed a data source or action elsewhere that you can reuse. In these cases you can copy a resource from one system to another by first using Save definition in the original project, then using Load definition in the new project to import the file.  

The Load/Save definition process is similar to the Report option in that it constructs a file containing information about an action or a data source into a special file format for export. The format is especially designed so that the resource can be imported into another project and translated into the original resource. This second project may be quite separate, running on a different copy of the application. If the action is a data transfer action, then both source and target data sources are included in the import/export file.  If an activity is imported, i.e. its definition is loaded into a project, then all actions and sub-activities comprising that activity and the activity's workflow structure are loaded.  

Please note that in order to load, actions or data sources must have been previously saved from system releases 2.13 or higher.

Same name: If you are loading an action or data source that is already in your system, or saving a file to a file name that already exists, you will see a warning message that gives you these options:

Re-use, Re-use all: Choose this if you do not want the new element. In this case the existing item will be used. Choosing "Re-use all" will re-use every existing component element with the same name as an existing element, without further prompting

New, New all: Select to copy the new item, and use this item as a component of any copied complex actions or data sources. In this case the new element will be given the name Copy of...., i.e. "copy of" is appended to the name so that it can be distinguished from the element that already exists. Pressing New all accepts this response to all elements with the same name, without further prompting.

You may also see this message when you load an activity that uses the same data source more than once.

Related topics include Actions overview, New action, Save, Reports, Drag or copy and paste