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 resource from the list “Available for projects” (the resource contains a configured 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 six panels and a lightbox.

Description / Purpose
Source Data Widget Upper left (1)
  • In order to make the modelling of mappings and data transformations easy, sample records of the configured data resource are presented.
  • If there is more than one record in the resource, the first few are presented in individual tabs.
    • Note: The alpha release does not allow for selection of specific records other than the first few.
Mapping Area Upper middle (2)
  • 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.
Target Data Widget Upper right (3)
  • 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.
Transformation Logic Widget Lower middle (4)
  • After defining mappings, transformation workflows can be modelled in the transformation logic widget using a set of functions.
Function List Widget Lower right (5)
  • 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 availbable. Future versions of d:swarm will also provide functions for integrating records from different resources (e.g. look-up functions) or for nesting transformations recursively.
Configuration Widget Lower left (6)
  • Some transformation functions require parameters. They can be configured in the configuration widget.
Filter Widget Lightbox
  • Filters can be used for restricting transformations to a given specific of the 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.

Step by Step:

← Configure CSV Data Resources
← Configure XML Data Resources
Define Mappings →

Leave a Reply