In this exercise, you are going to define a Business Object called CardStatus as a child to Business Object Card, including Interface Fields and adding Target Objects. Like the previous exercise, you are also going to map some of the Target Fields, the easy ones.


What is the rationale behind creating Business Object CardStatus as a child of Card? Why not just continue on Card itself? There can be many different reasons, but the most common ones are:

  • There can be several CardStatus for each Card
  • Sometimes a CardStatus must be created, sometimes not

Create child Business Object CardStatus as a child to Card

  • Open Business Object Card on the Document canvas
  • Go to Children tab
  • Click the Add button, in the dialog
    • Supply the name of the new Child Business Object: CardStatus
    • Check Save Business Object to save the Card parent Business Object after save
    • Check Open child to open the new child Business Object immediately
  • The new child Business Object opens on the Document canvas and is already name CardStatus
    • Provide a description: List of status on a Card
    • Select the Interface tab to create CardStatus Interface Fields, and now - because this is a Child Business Object - a cardinality to define the number of occurrences allowed of the child, for instance
      • 0 : * - there can be 0 to infinity occurrences
      • 1 : 1 - there must be 1 and only 1 occurrence
      • 0 : 2 - there can be from 0 up to 2 occurrences
    • In this case leave it at the default: 0 : *
  • Type in the Interface Fields listed below
  • Save (Ctrl-s)



Add Target Object Tgt.Card_Status


  • Open child Business Obejct CardStatus (if not open)
  • Go to the Target tab
  • Click the Add button, in the dialog
    • Leave the Meata data drop down on Target [Tgt]
    • Select the Card_Status metadata structure from the list (if Card_Status do not appear, check if you did Exercise 1.2 – Import Target Structures correctly?
    • Leave the Name blank
    • Check Save Business Object to save the Card parent Business Object after save
    • Check Open Target Object to open the new Target Object immediately


Map part of Target Object Tgt.Card_Status


Now you are going to map the easy part of the Target Fields in Target Object Tgt.Card_Status.


  • Tgt.Card_Status should be open on the Document canvas after the last step 
    • If not: Open Tgt.CardStatus, either from Project Explorer (Business Object Card > Business Object CardStatus > Tgt.CardStatus), or from Business Object CardStatus by double-clicking the Tgt.Card_Status row on the Target tab
  • On Tgt.Card_Status, select the Target tab
  • Map the following fields using value Interface
    • Target Field StatusSeqNo to CardStatus Interface Field CardStatusSeqNo
    • Target Field StatusStartDate to CardStatus Interface Field StatusStartDate
    • Target Field StatusEndDate to CardStatus Fnterface Field StatusEndDate
  • Target Field CrudStatus to value Literal C
  • Map the following fields using value Target. The value type Target means that you pick up the value of another Target Field, whose value has already been assigned
    • Target Field BankId to Target Field BankId in Tgt.Card on Business Object Card
      • Select BankId field
      • Select Target from Value drop down
      • Tab right (or click in the Content cell)                 
      • Select Business Object Card from Business Object drop down. Note that you can chose your current Business Object (which is CardStatus) or any of its ancestors (in this case Card)
      • Select Tgt.Card from the Target Object drop down
      • Select BankId from the Field drop down
      • Then Ok       
    • Target Field CardId to Target Field CardId in Tgt.Card on Business Object Card
    • Target Field CreatedBy to Target field CreatedBy in Tgt.Card on Business Object Card



What happened here?


You are proceeding in your instructions to migFx on how to create the Target data for the Card Business Object. You have extended the Card Business Object by adding the child Business Object CardStatus.


Furthermore, you have told migFx to deliver a row to the structure in the Target system called Card_Status, by creating the Target Object Tgt.Card_Status on the child Business Object CardStatus.


If you have a look at the Project Explorer treeview, this is quite easy to see the structure you have created in this and the previous exercise:


You have also extended your arsenal of Value types with a new one:

  • Interface
  • Literal
  • Target, to pick up a value from another Target Field


Of course, when you use the value of another Target Field, it is rather important that this value has already been assigned. This is why you can change the calculation sequence of the Target Fields by moving them up or down in the list using the 2 buttons on the right.

Note that moving the Target Fields like this only affects the sequence of the value assignments. Regardless of this, in the migration result the Target Fields will always be delivered by migFx in the sequence they are defined in the metadata.