Create and Edit Projects

After configuring the data schema you can create a project in which you can define mappings and model data transformations.

Create Projects – Workflow

• Click on the tab “Data”.
• Select a data model from the list “Available for projects” (the data model refers to a schema) (1).
• Two buttons “Show details” and “Use for new project” will be shown.
• You can view and edit the configuration by clicking on “Show details”.
• Click on “Use for new project” in order to create a new project. Type telling name (obligatory) and a short description of your project (optional) in the pop-up box (2) and click on “Create” (3).
• The new project will appear in the list “All projects”.

Edit a Project – the Modelling Perspective

• Select your project by clicking in the list “All projects” (1).
• Click on the button “Load for modelling” (2) in order to load the project in the modelling perspective.

The modelling perspective is the central d:swarm tool for defining schema mappings and model data transformations. The modelling perspective is divided in seven section each with its dedicated purpose.

Section	Description / Purpose
(1) Source Data Widget	In order to make the modelling of mappings and data transformations easy, sample records of the data model are presented. If there is more than one record in the resource, the first few are presented in individual tabs. Note: The beta release does not allow for selection of specific records other than the first few.
(2) Mapping Area	On the left of the middle panel, the input schema is presented, on the right, the output schema. Create your desired mapping by linking input attribute paths with output attribute paths.
(3) Target Data Widget	Mappings and transformations in a project can be run singly or collectively on the sample records so that the results can be evaluated right away.
(4) Transformation Logic Widget	After defining mappings, transformation workflows can be modelled in the transformation logic widget using a set of functions.
(5) Function List Widget	The set of functions available for data transformation is shown in the function list widget. Note: In the alpha release, only record-centered functions are available. Future versions of d:swarm will also provide functions for integrating records from different sources (e.g. look-up functions) or for nesting transformations recursively.
(6) Configuration Widget	Some transformation functions require parameters. They can be configured in the configuration widget.
(7) Filter Widget	Filters can be used for restricting transformations to specific values of an input attribute path so that complex conditions for the execution of a transformation logic can be constructed.

You can save your work at any time by clicking on the button “Save project” (on the upper left in the source data widget). Additionally, all changes will be saved automatically. If you happen to leave the modelling perspective without manually saving your project, you will be asked to save or discard your last modifications after reloading the project.

---

D:SWARM Help - Step by Step

• next: Define Mappings
• previous: Configure XML Data Resources