Difference between revisions of "How to Play In"

From WeizmannWiki
Jump to: navigation, search
Line 1: Line 1:
==Natural language play-in==
+
__TOC__
To use [[PlayGo_Feature_List#Natural_language_play-in|Natural Language Play-in]], click the 'NL Play-In' button.<br>
+
[[Image:NL.play-in.start.png | 800px]]<br><br>
+
  
Consequently, the play-in session starts, and the 'NL Play-in' view opens. To play in, enter LSC name and the requirement: <br><br>
+
== Natural language play-in ==
[[Image:NL.play-in.view.png|800px]]
+
  
<br>
+
To use [[PlayGo Feature List#Natural_language_play-in|Natural Language Play-in]], click the 'NL Play-In' button.<br> [[Image:NL.play-in.start.png|800px]]<br><br>
When the 'Online Parsing' button is pressed, the text is parsed and is checked after each space.<br>
+
The LSC is created (when no errors exist) when pressing ENTER, or when clicking the '+' button at the view toolbar.
+
  
In the 'NL Play-In' view, errors appear underlined by a squiggly line, and when hovering on them with the mouse an explanation appears, and when relevant also possible solutions. Click on a solution to select it, or edit the text to fix it yourself:<br><br>
+
Consequently, the play-in session starts, and the 'NL Play-in' view opens. To play in, enter LSC name and the requirement: <br><br> [[Image:NL.play-in.view.png|800px]]  
[[Image:playin.view.ambigous.png|800px]]
+
<br><br>
+
  
 +
<br> When the 'Online Parsing' button is pressed, the text is parsed and is checked after each space.<br> The LSC is created (when no errors exist) when pressing ENTER, or when clicking the '+' button at the view toolbar.
  
Tips for playing in natural language requirements:
+
In the 'NL Play-In' view, errors appear underlined by a squiggly line, and when hovering on them with the mouse an explanation appears, and when relevant also possible solutions. Click on a solution to select it, or edit the text to fix it yourself:<br><br> [[Image:Playin.view.ambigous.png|800px]] <br><br>
#Sentences should be explicit, with a clear object and verb, or adjective.
+
 
#The comma after each part (or a 'then' or 'and') is important and must be present. For example "when the user clicks the button, the display shows Hello", or "when the user clicks the button then the display shows Hello".
+
<br> Tips for playing in natural language requirements:  
#To refer to a specific object, use 'the'. To refer to a non-specific object, use 'a' or 'any'. For example: ‘click the button’ or ‘click a button’.
+
 
#Use lower case constantly (object names too).
+
#Sentences should be explicit, with a clear object and verb, or adjective.  
 +
#The comma after each part (or a 'then' or 'and') is important and must be present. For example "when the user clicks the button, the display shows Hello", or "when the user clicks the button then the display shows Hello".  
 +
#To refer to a specific object, use 'the'. To refer to a non-specific object, use 'a' or 'any'. For example: ‘click the button’ or ‘click a button’.  
 +
#Use lower case constantly (object names too).  
 
#Use the exact name of the object as it appears in the system model.
 
#Use the exact name of the object as it appears in the system model.
  
Examples for requirements in the system's natural language, can be found [http://www.wisdom.weizmann.ac.il/~michalk/Projects/ReqToLSCs/ here].
+
Examples for requirements in the system's natural language, can be found [http://www.wisdom.weizmann.ac.il/~michalk/Projects/ReqToLSCs/ here].  
  
== Basic play-in==
+
== Basic play-in ==
To use [[Language_%26_Concepts#Play-In|Basic play-in]], click the 'Basic Play-In' button.<br>
+
[[Image:NL.play-in.start.png|800px]]<br><br>
+
  
Consequently, the play-in session starts. If a GUI exists it is launched, from which you can start play-in:
+
To use [[Language & Concepts#Play-In|Basic play-in]], click the 'Basic Play-In' button.<br> [[Image:NL.play-in.start.png|800px]]<br><br>
  
* Clicking an object in the GUI creates a diagram snippet reflecting the click.
+
Consequently, the play-in session starts. If a GUI exists it is launched, from which you can start play-in:  
* Use the Play-In toolbar to control some of the play-in operations, such as applying modality (hot/cold, monitor/execute):<br>[[Image:playin.toolbar1.JPG|800px]]
+
<br>
+
* Insert new LSC elements, such as new LSC, new Instance, Assertion, Assignment etc…<br>[[Image:playin.toolbar2.JPG|800px]]
+
<br>
+
*You may want to carry out operations on the GUI without affecting the LSC (e.g., for restoring the GUI to a state from which you want to play in). To do this, press the 'Ignore GUI Play-In' button, next to the 'Play-In Mode' drop-down button, and carry out the required operation. Once done, press the 'Ignore GUI Play-In' button again, to release it (in which case GUI operations will no longer be ignored):<br> [[Image:playin.ignore.JPG | 800px]]
+
<br>
+
*Once created, LSC construct properties can be modified via the properties view and the right-click menu:<br> [[Image:properties.view.rightClickMenu.png|800px]]
+
<br>
+
  
== System model play-in==
+
*Clicking an object in the GUI creates a diagram snippet reflecting the click.  
One can also play in by selecting an object from the system model, right-clicking it and selecting the required operation. For example, to add a lifeline, right-click an object and select 'Add Object as Lifeline':
+
*Use the Play-In toolbar to control some of the play-in operations, such as applying modality (hot/cold, monitor/execute):<br>[[Image:Playin.toolbar1.JPG|800px]]
  
[[Image:playin.systemmodel1.png|800px]]
+
<br>  
<br><br>
+
To add a self message (from an object to itself), right-click a method of an object and select 'Call Message'. If the message requires input parameters, the play-in view will open, and will prompt the user to add the required message parameters:<br>
+
  
[[Image:playin.systemmodel.png | 800px]]
+
*Insert new LSC elements, such as new LSC, new Instance, Assertion, Assignment etc…<br>[[Image:Playin.toolbar2.JPG|800px]]
  
To add a message from one object to another, right-click the source object and select 'Call Other Object', then, right-click a method of the target object and select 'Call Message'. Once again, if the message requires input parameters, the play-in view will open, and will prompt the user to add the required message parameters.
+
<br>
  
== ==
+
*You may want to carry out operations on the GUI without affecting the LSC (e.g., for restoring the GUI to a state from which you want to play in). To do this, press the 'Ignore GUI Play-In' button, next to the 'Play-In Mode' drop-down button, and carry out the required operation. Once done, press the 'Ignore GUI Play-In' button again, to release it (in which case GUI operations will no longer be ignored):<br> [[Image:Playin.ignore.JPG|800px]]
 +
 
 +
<br>
 +
 
 +
*Once created, LSC construct properties can be modified via the properties view and the right-click menu:<br> [[Image:Properties.view.rightClickMenu.png|800px]]
 +
 
 +
<br>
 +
 
 +
== System model play-in ==
 +
 
 +
One can also play in by selecting an object from the system model, right-clicking it and selecting the required operation. For example, to add a lifeline, right-click an object and select 'Add Object as Lifeline':
 +
 
 +
[[Image:Playin.systemmodel1.png|800px]] <br><br> To add a self message (from an object to itself), right-click a method of an object and select 'Call Message'. If the message requires input parameters, the play-in view will open, and will prompt the user to add the required message parameters:<br>
 +
 
 +
[[Image:Playin.systemmodel.png|800px]]
 +
 
 +
To add a message from one object to another, right-click the source object and select 'Call Other Object', then, right-click a method of the target object and select 'Call Message'. Once again, if the message requires input parameters, the play-in view will open, and will prompt the user to add the required message parameters.

Revision as of 09:16, 27 November 2012

Natural language play-in

To use Natural Language Play-in, click the 'NL Play-In' button.
NL.play-in.start.png

Consequently, the play-in session starts, and the 'NL Play-in' view opens. To play in, enter LSC name and the requirement:

NL.play-in.view.png


When the 'Online Parsing' button is pressed, the text is parsed and is checked after each space.
The LSC is created (when no errors exist) when pressing ENTER, or when clicking the '+' button at the view toolbar.

In the 'NL Play-In' view, errors appear underlined by a squiggly line, and when hovering on them with the mouse an explanation appears, and when relevant also possible solutions. Click on a solution to select it, or edit the text to fix it yourself:

Playin.view.ambigous.png


Tips for playing in natural language requirements:

  1. Sentences should be explicit, with a clear object and verb, or adjective.
  2. The comma after each part (or a 'then' or 'and') is important and must be present. For example "when the user clicks the button, the display shows Hello", or "when the user clicks the button then the display shows Hello".
  3. To refer to a specific object, use 'the'. To refer to a non-specific object, use 'a' or 'any'. For example: ‘click the button’ or ‘click a button’.
  4. Use lower case constantly (object names too).
  5. Use the exact name of the object as it appears in the system model.

Examples for requirements in the system's natural language, can be found here.

Basic play-in

To use Basic play-in, click the 'Basic Play-In' button.
NL.play-in.start.png

Consequently, the play-in session starts. If a GUI exists it is launched, from which you can start play-in:

  • Clicking an object in the GUI creates a diagram snippet reflecting the click.
  • Use the Play-In toolbar to control some of the play-in operations, such as applying modality (hot/cold, monitor/execute):
    Playin.toolbar1.JPG


  • Insert new LSC elements, such as new LSC, new Instance, Assertion, Assignment etc…
    Playin.toolbar2.JPG


  • You may want to carry out operations on the GUI without affecting the LSC (e.g., for restoring the GUI to a state from which you want to play in). To do this, press the 'Ignore GUI Play-In' button, next to the 'Play-In Mode' drop-down button, and carry out the required operation. Once done, press the 'Ignore GUI Play-In' button again, to release it (in which case GUI operations will no longer be ignored):
    Playin.ignore.JPG


  • Once created, LSC construct properties can be modified via the properties view and the right-click menu:
    Properties.view.rightClickMenu.png


System model play-in

One can also play in by selecting an object from the system model, right-clicking it and selecting the required operation. For example, to add a lifeline, right-click an object and select 'Add Object as Lifeline':

Playin.systemmodel1.png

To add a self message (from an object to itself), right-click a method of an object and select 'Call Message'. If the message requires input parameters, the play-in view will open, and will prompt the user to add the required message parameters:

Playin.systemmodel.png

To add a message from one object to another, right-click the source object and select 'Call Other Object', then, right-click a method of the target object and select 'Call Message'. Once again, if the message requires input parameters, the play-in view will open, and will prompt the user to add the required message parameters.