Skip to main content
Use Export and Import to move mappings and workflows between Kodda instances — for example from development to production. Export writes the selected objects, with everything they depend on, to a single Kodda export file (.kexp); Import reads that file into another instance and lets you remap connections on the way in. Open Migrate > Export or Migrate > Import from the main header.

​
Export Objects

Use the search bar to find the mappings and workflows to export. Type free text, or use keywords in the form <keyword>:<value> to filter precisely. The ? button next to the search box lists the keywords: For example, type:map source:SourceDemo target:TargetDemo name:department lists the mappings from SourceDemo to TargetDemo whose name contains department.
To search for several values with one keyword, separate them with commas and no spaces: name:department,employee.
Words entered without a keyword are matched against the source and target connection names as well as the mapping and workflow names.
The results are listed under Available Objects with their Type, Name, Source, Source Schema, Source Table, Target, Target Schema and Target Table.
  • Tick the box in the first column to select each object to export. Use the box in the header row to select every object in the list.
  • Click Export in the upper right corner of the list.
A log shows the progress of the export. Workflows are exported with the mappings and nested workflows they contain.
  • Click Download to save the export file (kodda_objects.kexp) through your browser.
  • Click Back to return to the search.

​
Import Objects

Open Migrate > Import on the instance you are importing into.

​
Add and upload the file

Click + Add file(s) to choose one or more .kexp files from your computer, or drag and drop them onto the Drag and drop files here area. Only .kexp files are accepted; an error is displayed for any other file type.
  • Click × next to a file to remove it from the queue before uploading.
  • Click Cancel upload to clear the whole queue.
  • Click Start upload to upload every file in the queue. When a file has finished uploading, a green progress bar is shown and the × is replaced by Config ⚙ and Delete 🗑 buttons.

​
Configure the import

Click Config ⚙ next to an uploaded file. Kodda reads the file and shows two sections on the right side of the screen.

​
Map Imported Connections

Every connection referenced by the exported objects is listed. Connections are not included in the export file, so each one must be matched to a connection that exists on this instance.
  • Connection Name — the connection name as it was on the instance the objects were exported from.
  • Import As — the connection on this instance to use in its place. Defaults to a connection of the same name if one exists.
  • Update Object Name ⇄ — if the mapping and workflow names include the connection name (as the standard Std.<Target>.<Source>.<schema>.<table> names do), click this to replace the original connection name with the Import As name in the Imported Name column below.

​
Objects to Import

Every mapping and workflow in the file is listed.
  • Type, Name, Source and Target — the object as it was exported.
  • Imported Name — the name the object will have on this instance. Edit it here if you want to rename the object on import.
  • Message — New if no object with the Imported Name exists on this instance, or Replace if one does and will be overwritten by the import.
Click Import Objects to import every object in the list. Objects marked Replace are overwritten.

​
Delete an uploaded file

Click Delete 🗑 next to a file to remove it from the server once it has been imported.