The 1000 steps program to MDriven Chapter 1
No edit summary
(changed cardinality of step 28 from" zero or one" to "zero to one")
(39 intermediate revisions by 3 users not shown)
Line 1: Line 1:
We are not sure that there will be exactly 1000 steps, as there may be more. To learn, however, you can start at step 1 and make sure you master the steps in order. Soon, you will be a productive information modeler bringing business value to your customers at an unprecedented speed.
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 and 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.
Whenever you lose your way, you can backtrack to a step that touches upon your current main point and follow along from there.


Here is the video for Steps 1 - 40: https://youtu.be/Z_jLDZMafXk
=== '''Video 1: The Basics''' ===
<html>


==== Video 1: Mdriven Education Steps 1 - 40: The Basics ====
<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>


=== Start MDrivenDesigner, Basic Modelling, Classes, and Associations, Press Play ===
<div class="video">
1. Start MDrivenDesigner by clicking the "clickonce" link on https://mdriven.net/designer.
  <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>


2. Create a new empty model. Save the file as c:\temp\MDrivenEducation\Start.modlr or equivalent.
</html>


3. Create a class Person and save the model; from now on, save the model often, using "ctrl+s."
== Chapter 1: Start MDrivenDesigner, Basic Modeling, Classes, and Associations, Press Play ==
<blockquote>'''Throughout this training process, we'll familiriaze you with the MDriven Designer using the example of a car management sytem. 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.''' </blockquote>1. Start MDrivenDesigner by clicking the "Run with ClickOnce" link at: https://mdriven.net/designer.
* You have <u>two</u> options (See: [https://www.youtube.com/watch?v=81jCg2EWdYw MDriven Shorts| How to install MDriven Designer?]):
** You can choose to always run the MDriven Designer online using "Run with ClickOnce".
** Or, 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 <u>Cegid Peoplenet ClickOnce launcher</u> extension from the Chrome Web Store (Microsoft Edge does not need a plug-in).
2. Create a new empty model. Save the file on your device as <code>c:\temp\MDrivenEducation\Start.modlr</code> or equivalent.


4. Create an attribute Name of type string in class Person.
3. Create the class <code>Person</code> and save the model.
* From now on, save the model often, using "CTRL + S."
4. Create an attribute, <code>Name</code>, of type string in class <code>Person</code>. Remember to Save


5. Press Play - choose XML persistence - Start system - Show debugger
5. Press the Play button on the left of the top menu. Choose XML persistence. Select "Start system", then "Show debugger".


6. In the debugger, in an Expression box, write the OCL expression to show all instances of your class Person with the operator allinstances; note the empty result list - you have no Person objects.
6. In the debugger, in an Expression box, write the OCL expression to show all instances of your class <code>Person</code> with the operator "allinstances": <code>person.allinstances</code>
* Note the empty result list - you have no <code>Person</code> objects.
7. In the debugger, bring up a Seeker - Search will be empty. Create 2 <code>Person</code> objects by selecting "Create New" and adding 2 rows.


7. In the debugger, bring up a seeker, search -> empty. Create 2 person objects.
8. In the 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."
8. In the AutoForm for person 1, give it your name; in person 2, write some other name.
* Click on the box under "Name" and input your name.
 
* Repeat this to add "SomeOtherDude" (or some other name) as Person 2.
9. Save the created Person objects from the save button in the debugger.
9. Save the created Person objects from the save button in the Debugger.


10. Find the saved XML file on disk in the same location as your model file.
10. Find the saved XML file on disk in the same location as your model file.
Line 30: Line 58:
11. Open the XML file with Notepad or another app, find your name, and close the file.
11. Open the XML file with Notepad or another app, find your name, and close the file.


12. In the debugger expression box, use the expression to find all persons from step 6 - note the result - two rows.
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 Debugger, close Play dialog, close MDrivenDesigner, save if asked, then restart by performing step 1.
13. Close the Debugger, close the Play dialog, and close MDriven Designer. Save, if asked, then restart by performing Step 1.
 
14. Open recent files - your file, press play, and go into the debugger as in step 5.


15. Perform step 12. Ensure your 2 person-objects survived.
14. Open recent files - select your file, press play, and go into the Debugger as in Step 5.


16. Close the debugger and close play-dialog(system prototyper).
15. Perform Step 12. Check that your 2 person-objects survived.


17. Find class Person in Tree to the right by filling in the search box on top of the tree.
16. Close the Debugger and close the play-dialog (system prototyper).


18. Note 2 rows: one is the class, and the other result is the property. Select Person class in tree - look at the property inspector below tree. Change its default color to cyan (or whatever looks nice).
17. Find the class <code>Person</code> in the tree to the right by filling in the search box on top of the tree.


19. In the search box, press escape or clear search box - note tree structure of the entire model in tree. You can always find things in the model here.
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 property inspector below the tree. Change its default color to cyan (or whatever looks nice).


20. Find the diagram1 in tree - double click to open.
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.
20. Find <code>Diagram1</code> in the tree - double click to open it.


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


22. Press the "Start!" in the top left corner to show Start-wizard if it does not already show.
22. Press the "Start!" in the top left corner to show the Start wizard if it does not already show.


23. Right-click the diagram. Choose "Add class."
23. Right-click the diagram. Choose "Add class."


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


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


26. Enter AssociationMode by pressing the association arrow in tool button.
26. Enter AssociationMode by pressing the association arrow in the tool button.


27. Click-drag-hold association from Person - hold mouse - move to Car - release.
27. Click-drag-hold association from <code>Person</code> - hold mouse - move to Car - release.


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


29. Rename the "Person" association-end name to "PreviousOwner." Make sure it has cardinality 0..1 (zero or one).
29. Rename the <code>Person</code> association-end name to <code>PreviousOwner</code>. Make sure it has cardinality 0..1 (zero to one).


30. Add an attribute to class Car with the name "RegistrationNumber" of type string.
30. Add an attribute to class Car with the name <code>RegistrationNumber</code> of type string.


31. Find the Car in the tree by using the search box.
31. Find the <code>Car</code> in the tree by using the search box.


32. Double-click the Car in the tree; note that the screen is not your diagram - it is an auto diagram.
32. Double-click the <code>Car</code> 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 shift to center Person and show Car on the side.
33. Note the link in the auto diagram to class <code>Person</code> . Click class <code>Person</code>. Note, also, the auto diagram shifts to center <code>Person</code> and shows <code>Car</code> on the side.


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


35. Play-button, XML persistence, debugger, Expression to list allinstances of Person.
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>).


36. Click on the person with your name.
36. Click on the person with your name.


37. Note the new multilink button for CarsIUsedToOwn - click it.
37. Note the new multilink button for <code>CarsIUsedToOwn</code> - click it.


38. Use add new button to create 3 cars I used to own.
38. Use the "Add New" button to create 3 <code>CarsIUsedToOwn.</code>


39. Click up the auto form for each car; give them registrationNumber OldCar1 to OldCar3.
39. Click on the auto form for each car. Give them RegistrationNumber ''OldCar1'', ''OldCar2'', and ''OldCar3''.


40. Save the debugger data.
40. Save the Debugger data.


=== Next Chapter ===
=== Next Chapter ===
[[The 1000 steps program to MDriven 41 to 75]]
[[The_1000_steps_program_to_MDriven_Chapter_2]]
[[Category:1000 Steps Program]]

Revision as of 05:39, 19 April 2024

This is Chapter 1 of the 1000 Steps Program. Each step has been carefully thought out for easy understanding and progress and 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

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.

Steps 1 - 40 Introduction Getting started Class, attribute, debugger Seeker and objects Search Association Multilink

Chapter 1: Start MDrivenDesigner, Basic Modeling, Classes, and Associations, Press Play

Throughout this training process, we'll familiriaze you with the MDriven Designer using the example of a car management sytem. 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.

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

  • You have two options (See: MDriven Shorts| How to install MDriven Designer?):
    • You can choose to always run the MDriven Designer online using "Run with ClickOnce".
    • Or, 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 Cegid Peoplenet ClickOnce launcher extension from the Chrome Web Store (Microsoft Edge does not need a plug-in).

2. Create a new empty model. Save the file on your device as c:\temp\MDrivenEducation\Start.modlr or equivalent.

3. Create the class Person and save the model.

  • From now on, save the model often, using "CTRL + S."

4. Create an attribute, Name, of type string in class Person. Remember to Save

5. Press the Play button on the left of the top menu. Choose XML persistence. Select "Start system", then "Show debugger".

6. In the debugger, in an Expression box, write the OCL expression to show all instances of your class Person with the operator "allinstances": person.allinstances

  • Note the empty result list - you have no Person objects.

7. In the debugger, bring up a Seeker - Search will be empty. Create 2 Person objects by selecting "Create New" and adding 2 rows.

8. In the 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.

9. Save the created Person objects from the save button in the Debugger.

10. Find the saved XML file on disk in the same location as your model file.

11. Open the XML file with Notepad or another app, find your name, and close the file.

12. In the Debugger Expression box, use the expression from Step 6 to find all persons: person.allinstances

  • Note the result - two rows.

13. Close the Debugger, close the Play dialog, and close 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 Step 5.

15. Perform Step 12. Check that your 2 person-objects survived.

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

17. Find the class Person in the tree to the right by filling in the search box on top of the tree.

18. Note 2 rows: one is the class, and the other result is the property. Select Person in the tree. Look at the 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.

20. Find Diagram1 in the tree - double click to open it.

21. Diagram1 may be empty - drag and drop the Person class from the tree onto the diagram.

22. Press the "Start!" in the top left corner to show the Start wizard if it does not already show.

23. Right-click the diagram. Choose "Add class."

24. Rename the new class to Car.

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

26. Enter AssociationMode by pressing the association arrow in the tool button.

27. Click-drag-hold association from Person - hold mouse - move to Car - release.

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

29. Rename the Person association-end name to PreviousOwner. Make sure it has cardinality 0..1 (zero to one).

30. Add an attribute to class Car with the name RegistrationNumber of type string.

31. Find the Car in the tree by using the search box.

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 Diagram1 by finding it in the tree.

35. Select the Play button, choose XML persistence, click on Debugger, and execute the expression to list all instances of Person (person.allinstances).

36. Click on the person with your name.

37. Note the new multilink button for CarsIUsedToOwn - click it.

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.

40. Save the Debugger data.

Next Chapter

The_1000_steps_program_to_MDriven_Chapter_2

This page was edited 1 days ago on 05/16/2024. What links here