Versions Compared

Old Version 3

changes.mady.by.user Kirstin Seidel-Gebert

Saved on

compared with

New Version 4

changes.mady.by.user Kirstin Seidel-Gebert

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WDESIGNER and version 21.2a

When you open the implementation diagram of a mapping diagram from the Data Model folder in the Service paneloperation, a new tab will openopens, displaying the model and the mapping diagram is displayed in the mapping editor.
This is where you model your data mapping.

Image Removed

The mapping editor consists of different areas:

  1. Mapping Editor
  2. Elements Toolbar
  3. Model Toolbar
  • Designer Panels

    • Customizing the Mapping Editor

    You have several options to adjust the Mapping Editor. When you open the editor for the first time, the default view is displayed:

    The Mapping Editor is displayed in the center
    (see Managing the Mapping Editor for details).
    Two
    1. Designer Panels
    are shown in the left sidebar
    (see Managing Panels for details):
    • The Service Panel
    • The Attributes Panel
  • Two Designer Panels are hidden:
    (use the two icons in the upper right corner of the editor to display them):
    • The Validation Panel
    • The Search Panel

    • Managing the Mapping Editor

    Image Removed

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamesecond_sidebar
    DisableCachingtrue
    PageWithExcerptINTERNAL:_designer_excerpts

    Image Removed

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNameenlarge_pane
    DisableCachingtrue
    PageWithExcerptINTERNAL:_designer_excerpts

    Image Removed

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamehide_sidebar
    DisableCachingtrue
    PageWithExcerptINTERNAL:_designer_excerpts

    Managing Panels

    Multiexcerpt includeSpaceWithExcerptINTERNALMultiExcerptName

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptName

    state_of_panePageWithExcerptINTERNAL:_designer_excerpts

    tip_panel_management
    DisableCachingtrue
    PageWithExcerptINTERNAL:_designer_excerpts

    Modeling in the Mapping Editor

    ActionExampleDescriptionZoom

    Image Removed

    When modeling, you have several options to apply the zoom in the editor.

    • Press the Ctrl button and use the mouse wheel.
    • Use the zoom bar at the bottom of the editor.
      To zoom, you can use the pin or press the plus or minus button of the zoom bar.

    Scaling

    Image Removed

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamefit_model_to_pane
    DisableCachingtrue
    PageWithExcerptINTERNAL:_designer_excerpts

    Image Removed

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamescale_model
    DisableCachingtrue
    PageWithExcerptINTERNAL:_designer_excerpts

    When starting with a new mapping diagram, the mapping editor displays a canvas that contains the incoming and outgoing parameters of the mapping operation.

    Image Added

    The image above shows the blank mapping diagram of a non-static mapping operation.

    On the left side, you can see the mapping source. In this case, the source is the Self context of the related class. If the mapping operation has input parameters, the mapping diagram will also show elements in the Input section of the mapping diagram.
    On the right side, you can see the mapping target (section Output). The target is defined by the output parameters of the mapping operation.

    Drawing Mapping Relations

    Each class property has a connector Image Added. Use these connectors to map properties directly from source to target.

    Image Added

    Click a connector on the source side of the mapping diagram and drag out a mapping relation.

    You can abort this process by pressing the Esc button, or by clicking the right mouse button.

    Image Added

    Drag the relation to the connector of the target property.

    The color of the target connector indicates whether you can connect the selected properties. Valid connectors are displayed in blue Image Added.

    Image Added

    Drop the mapping relation on the target connector.

    Tip

    A source property can be connected to more than one target property.

    Image Added

    If the mapping relation is valid, it is displayed in black, if not, it is displayed in red.

    Tip

    If invalid mapping relations are not highlighted in red, you may need to enable Show invalid from the mapping toolbar. See Toolbars further below for more details on the mapping toolbar.

    Generally, all mapping relations are arranged automatically in a way that provides the best overview.


    Image Added

    If you need to change a mapping relation, take the relation e.g. from the target connector, and move it to another connector.

    To delete a mapping relation, click it with the right mouse button, and click on the thrash icon from the context menu (or press the Del button).

    Assigning a Literal Value to a Target Property

    Image Added

    Click the literal icon Image Added from the elements toolbar, and select a property to assign a literal value to (or use drag & drop).

    To cancel the procedure, press Esc.

    Image Added

    A box appears where you can enter the literal value. Press Enter to save the value.

    You can change the value by double-clicking the box and entering a new value.
    To delete the literal value, select the box and press the Del key, or select Image Added from the context menu.

    Adding Operations to Mapping Relations

    In cases the target and the source type do not match, or you want to perform some other transformation with the mapping, you can add operations to mapping relations.

    Image Added

    Drag out the needed operation from the service panel to the mapping operation area - the grey section in the middle of the mapping editor.

    Tip

    You can also directly use Base Type operations in a mapping diagram.

    Image Added

    Once you have added the operation to the mapping diagram, you can connect the source and target properties to the operation pins.

    Image Added

    If you want to create a new mapping operation, you can click the mapping function icon and drag it to the grey mapping operation area.

    Other Features of the Mapping Editor

    While modeling, some general functionalities help you to browse through your model, and to adjust your working location within the model. Refer to Customizing Editors and Panels for more details.

    Toolbars

    The mapping editor features a mapping toolbar in the center top of the diagram pane, and an elements toolbar on the right.

    The Toolbars

    Two toolbars are available for working with the Mapping Editor:

    The Model Toolbar

    The model toolbar assists you during modeling on the diagram pane:

    Image Removed

    The following table explains the available tools:

    Tool IconTool NameDescription

    Image Removed

    Show invalid

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamemodel_toolbar_show_invalid
    PageWithExcerptINTERNAL:_designer_excerpts

    Image Removed

    Start service

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamemodel_toolbar_start_service
    PageWithExcerptINTERNAL:_designer_excerpts

    Image Removed

    Stop service

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamemodel_toolbar_stop_service
    PageWithExcerptINTERNAL:_designer_excerpts

    Image Removed

    Open Bridge

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamemodel_toolbar_open_bridge
    PageWithExcerptINTERNAL:_designer_excerpts

    Image Removed

    Deploy service

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamemodel_toolbar_deploy_service
    PageWithExcerptINTERNAL:_designer_excerpts

    Image Removed

    Export repository
    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamemodel_toolbar_export_repository
    PageWithExcerptINTERNAL:_designer_excerpts

    Image Removed

    Clear Compiler cache
    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamemodel_toolbar_clear_compiler_cache
    PageWithExcerptINTERNAL:_designer_excerpts

    Image Removed

    Go to libraryClick on this icon to highlight the operation in the Service panel.The
    ToolbarDescription
    Mapping Toolbar

    Use the mapping toolbar to change the appearance of the mapping relations and to jump to the related mapping operation in the service panel.

    IconDescription
    Image Added
    		Toggle if invalid mapping relations should be highlighted in red, or not.
    Image Added
    		Jump to the related mapping operation in the service panel.
    Elements Toolbar

    The elements toolbar contains all elements that you can create

    in the Mapping Editor.

    on your mapping diagram.

    IconDescription
    Image Modified

    By default, the elements toolbar only displays the icons of the available elements.

    Add a mapping function to the mapping diagram.
    Image Added
    		Assign a string literal to a target property.
    Image Removed

    You can also expand the toolbar by using

    the 

    theImage Modifiedicon.


    In its expanded version, the names of all elements are also displayed.

    Image Removed

    Drag the element you want to create from the toolbar and drop it on the editor.

    Another way to create an element is to click on the element in the toolbar, switch to the editor and click again.

    To cancel the operation, press the Esc key.

    The Mapping Context Menu

    A context menu supports the user during the creation of a mapping diagram.

    The expanded toolbar additionally displays a description of the toolbar icons.

    Context Menu of Elements in a Mapping Diagram

    Each element of the mapping editor has a context menu that you can select actions from.

    Image Added

    Right

    Mapping Operation Context Menu

    Image Removed

    If you right

    click on a mapping element, to open the context menu

    opens

    .

    Use it to edit the current element.The following options are available if you click on a mapping operation

    Available actions are:

    IconDescriptionAvailable for
    Image ModifiedDelete the selected element.

    all elements

    Image ModifiedGo to library.
    Click on this icon to highlight
    Highlight the current element in the
    Service
    service panel.
    • property
    • mapping operation
    Image ModifiedNavigate to implementation.
    Opens
    Open the implementation of the mapping operation in a new tab.
    • mapping operation

    Keyboard Shortcuts

    You can also use shortcuts Find below a list of all keyboard shortcuts that are available in the mapping editor. The following list of shortcuts can be searched. Enter your search term in the Global Filter field.

    Table Filter
    hideControlstrue
    sparkNameSparkline
    datepatterndd M yy
    globalFiltertrue
    id16161642989361637918643186_795085269-1888608086
    sortShortcut ⇧
    worklog365|5|8|y w d h m|y w d h m
    isORAND
    separatorPoint (.)
    order0
    ShortcutDescription
    Arrow downMoves the whole editor content downwards.
    Arrow upMoves the whole editor content upwards.
    CTRL Ctrl + 1, 2, 3 ... 9

    Opens Switches to the Designer tab corresponding to the chosen number. The This feature is available for the first nine opened models are offered for activation. Press a number to activate the corresponding model and bring it to the foreground.open tabs.

    Ctrl CTRL + D
    		Closes the active model windowDesigner tab.
    CTRL Ctrl + Mouse WheelReduces Zooms in (scrolling downup) or enlarges out (scrolling updown) the zoom factor of the current model.
    CTRL Ctrl + SHIFT Shift + DCloses all tabs and switches to explorer the service tab.
    DelRemoves the selected element(s) DELPress Del to remove selected elements from the diagram pane.
    Esc

    Aborts

    		ESC

    Pressing the Esc key aborts the following processesprocedures:

    • adding a new element
    • closing a dialog
    • drawing a relation
    Mouse WheelMoves the model diagram pane up or down.
    SHIFT Shift + Page downSwitches to the next Designer tab from left to right.
    SHIFT Shift + Page up
    		Switches to the next Designer tab from right to left.

    Customizing the Mapping Editor

    You can customize the mapping editor and the arrangement of the Designer panels to fit your needs. How to do that is explained in detail on Working with the Designer pp. On that page, you can also find a summary of all available keyboard shortcuts in the Designer, and an explanation of the zooming and scaling features of the editor.

    Otp
    Floatingfalse
    maxHLevel2

    Rp