View source for Training:Bootcamp:Chapter 1

<message>Write the content here to display this box</message>
This is '''Chapter 1''' of the ''[https://wiki.mdriven.net/index.php/Category:1000_Steps_Program 1000 Steps Program].'' Each step has been carefully thought out for easy understanding and progress. You will master the steps gradually and in detail.  

Whenever you lose your way, you can backtrack to a step that touches upon your current main point and follow along from there.

=== '''Video 1: The Basics''' ===
<html>

<p class="video-warn">
  To make your experience smooth, we set the main tags mentioned in the video to the right bar menu of this mini-player. Choose an interesting subtitle on the list and immediately get to the exact theme navigation item place in the video. Now you can pick any topic to be instructed on without watching the whole video.
</p>

<div class="video">
  <div class="video__wrapper">
    <iframe src="https://www.youtube.com/embed/Z_jLDZMafXk?si=pI3RXc4oYFpriDEl" title="YouTube video player" frameborder="0" allowfullscreen></iframe>
  </div>
  <div class="video__navigation">
 <span data-video="Z_jLDZMafXk" data-start="00" tabindex="0"> <strong> Steps 1 - 40 </strong> </span>
    <span class="navigation-item" data-video="Z_jLDZMafXk" data-start="00" tabindex="0"> Introduction </span>
    <span class="navigation-item" data-video="Z_jLDZMafXk" data-start="42" tabindex="0"> Getting started </span>
    <span class="navigation-item" data-video="Z_jLDZMafXk" data-start="130" tabindex="0"> Class, attribute, debugger </span>
    <span class="navigation-item" data-video="Z_jLDZMafXk" data-start="308" tabindex="0"> Seeker and objects </span>
    <span class="navigation-item" data-video="Z_jLDZMafXk" data-start="562" tabindex="0"> Search </span>
    <span class="navigation-item" data-video="Z_jLDZMafXk" data-start="666" tabindex="0"> Association </span>
    <span class="navigation-item" data-video="Z_jLDZMafXk" data-start="1020" tabindex="0"> Multilink </span>
  </div>
</div>

</html>

== Chapter 1: Start MDrivenDesigner, Basic Modeling, Classes, and Associations, Press Play ==
<blockquote>Throughout this training process, we'll familiarize you with the [[Training:MDriven Designer Overview Series|MDriven Designer]] using the example of a car management system. This includes creating elements like Cars and a Car Factory and adding people such as a Car Owner and Car Dealer. Every chapter adds a different piece to the overall system.  

Go to [https://mdriven.net/ mdriven.net] and let's begin! 

[[File:0.0.png|frameless|605x605px]] </blockquote>'''1.''' To use MDriven Designer, you have '''two''' options (see: [https://www.youtube.com/watch?v=81jCg2EWdYw MDriven Shorts| How to install MDriven Designer?]):

'''<u>Option 1: (Blue)</u>''' 

Start MDrivenDesigner by clicking the "'''Run with ClickOnce'''" link at: https://mdriven.net/designer.

* You can choose to always run the MDriven Designer online using "'''Run with ClickOnce'''".

<u>'''Option 2: (Red)'''</u> 

You can decide to download and install the MDriven Designer, running it '''locally''' and making it available '''offline'''.

* Download using either Google Chrome or Microsoft Edge (Internet Explorer is not a viable option).
** Downloading may take some time if there is a new version.
* If you're using Chrome, install the '''[https://chromewebstore.google.com/detail/cegid-peoplenet-clickonce/jkncabbipkgbconhaajbapbhokpbgkdc?utm_source=ext_app_menu Cegid Peoplenet ClickOnce launcher]''' extension from the Chrome Web Store (Microsoft Edge does not need a plug-in).
[[File:1.1.2 corrected.png|frameless|791x791px]]

'''NOTE:''' Click on the step/number to access the corresponding images.

'''[[Training:Chapter 1 Images#Step 2|2]].''' Create a new empty model. Save the file on your device as<code>c:\temp\MDrivenEducation\Start.modlr</code> or equivalent.

'''[[Training:Chapter 1 Images#Step 3|3]].''' Create the [[Documentation:Class|class]] <code>Person</code> and save the model. 
* From now on, save the model often, using "'''CTRL + S'''."
'''[[Training:Chapter 1 Images#Step 4|4]].''' Create an  [[Training:Derived attributes & associations|attribute]], <code>Name</code>, of type string in class <code>Person</code>. Remember to Save.

'''[[Training:Chapter 1 Images#Step 5|5]].''' Press the Play button on the left of the top menu. Choose [[Documentation:XML|XML]] persistence. Select "'''Start system'''", then "'''Show debugger'''".

'''[[Training:Chapter 1 Images#Step 6|6]].''' In the [[Documentation:Ocl debugger|Debugger]], in an Expression box, write the [[Training:OCL Expressions|OCL expression]] to show all instances of your class <code>Person</code> with the operator "[[Documentation:OCLOperators allInstances|allinstances]]": <code>person.allinstances</code> 
* Note the empty result list - you have no <code>Person</code> [[Documentation:Objects|objects]].
'''[[Training:Chapter 1 Images#Step 7|7]].''' In the debugger, bring up a '''[[Training:Seeker view|Seeker]]''' - Search will be empty. Create 2 <code>Person</code> objects by selecting "'''Create New'''" and adding 2 rows.

'''[[Training:Chapter 1 Images#Step 8|8]].''' In the [[Documentation:AutoForms–get more with less faster|AutoForm]] for '''Person 1''', give it your name. For '''Person 2''', write some other name.
* In the Seeker for '''Person''', select the first row, right-click, and press the word "Open."
* Click on the box under "Name" and input your name. 
* Repeat this to add "'''SomeOtherDude'''" (or some other name) as '''Person 2'''. 
'''[[Training:Chapter 1 Images#Step 9|9]].''' Save the created Person objects from the save button in the Debugger.

'''[[Training:Chapter 1 Images#Step 10|10]].''' Find the saved XML file on disk in the same location as your model file.

'''[[Training:Chapter 1 Images#Step 11|11]].''' Open the XML file with Notepad or another app, find your name, and close the file.

'''[[Training:Chapter 1 Images#Step 12|12]].''' In the Debugger Expression box, use the expression from Step 6 to find all persons: <code>person.allinstances</code> 
* Note the result - two rows.
'''13.''' Close the Debugger, close the Play dialog, and close [[Training:MDriven Designer Overview Series|MDriven Designer]]. Save, if asked, then restart by performing Step 1.

'''14.''' Open recent files - select your file, press play, and go into the Debugger as in <u>Step 5</u>.

'''15.''' Perform <u>Step 12</u>. Check that your 2 person-objects survived.

'''16.''' Close the Debugger and close the play-dialog (system prototyper).

'''[[Training:Chapter 1 Images#Step 17|17]].''' Find the class <code>Person</code> in the tree to the right by filling in the search box on top of the tree.

'''[[Training:Chapter 1 Images#Step 18|18]].''' Note 2 rows: one is the class, and the other result is the property. Select <code>Person</code> in the tree. Look at the [[Documentation:Property inspector|property inspector]] below the tree. Change its default color to cyan (or whatever looks nice).

'''19.''' In the search box, press escape or clear search box.
* Note the tree structure of the entire model in the tree. You can always find things in the model here.
'''[[Training:Chapter 1 Images#Step 20|20]].''' Find <code>Diagram1</code> in the tree - double click to open it.

'''21.''' <code>Diagram1</code> may be empty - drag and drop the <code>Person</code> class from the tree onto the diagram.

'''[[Training:Chapter 1 Images#Step 22|22]].''' Press the "[[Documentation:Start Introduction|Start!]]" in the top left corner to show the Start wizard if it does not already show.

'''[[Training:Chapter 1 Images#Step 23|23]].''' Right-click the diagram. Choose "'''Add class'''."

'''24.''' Rename the new class to <code>Car</code>.

'''25.''' Use zoom buttons or ctr-wheel to zoom in on your diagram.  

'''26.''' Enter AssociationMode by pressing the [[Documentation:Association|association]] arrow in the tool button.

'''[[Training:Chapter 1 Images#Step 27|27]].''' Click-drag-hold association from '''Person''' - hold mouse - move to '''Car''' - release.

'''28.''' Rename the '''Cars''' association-end name to <code>CarsIUsedToOwn</code>. Make sure it has cardinality '''0..*''' (zero to many).

'''[[Training:Chapter 1 Images#Step 29|29]].''' Rename the '''Person''' association-end name to <code>PreviousOwner</code>. Make sure it has cardinality '''0..1''' (zero to one).

'''[[Training:Chapter 1 Images#Step 30|30]].''' Add an attribute to class '''Car''' with the name <code>RegistrationNumber</code> of type [[Documentation:String|string]].

'''[[Training:Chapter 1 Images#Step 31|31]].''' Find the '''Car''' in the tree by using the search box.

'''[[Training:Chapter 1 Images#Step 32|32]].''' Double-click the '''Car''' in the tree. Note that the screen is not your diagram - it is an auto diagram.

'''33.''' Note the link in the auto diagram to class '''Person''' . Click class '''Person'''. Note, also, the auto diagram shifts to center '''Person''' and shows '''Car''' on the side.

'''34.''' Find your way back to <code>Diagram1</code> by finding it in the tree.

'''[[Training:Chapter 1 Images#Step 35|35]].''' Select the Play button, choose XML persistence, click on Debugger, and execute the expression to list all instances of Person (<code>person.allinstances</code>).

'''[[Training:Chapter 1 Images#Step 36|36]].''' Click on the person with your name.

'''[[Training:Chapter 1 Images#Step 37|37]].''' Note the new multilink button for '''CarsIUsedToOwn''' - click it.

'''[[Training:Chapter 1 Images#Step 38|38]].''' Use the "'''Add New'''" button to create 3 '''CarsIUsedToOwn'''.

'''39.''' Click on the auto form for each car. Give them RegistrationNumber '''OldCar1''', '''OldCar2''', and '''OldCar3'''.

'''[[Training:Chapter 1 Images#Step 40|40]].''' Save the Debugger data.

=== Next Chapter ===
[[The_1000_steps_program_to_MDriven_Chapter_2]]
[[Category:Bootcamp]]