| <?xml version="1.0" encoding="UTF-8"?> |
| <!DOCTYPE html |
| PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <html lang="en-us"> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> |
| <meta name="abstract" content="The Properties View allows you to edit OData properties. These properties are used to define the different artifacts in the model."/> |
| <meta name="description" content="The Properties View allows you to edit OData properties. These properties are used to define the different artifacts in the model."/> |
| |
| <link rel="stylesheet" type="text/css" href="../css/documentation.css"/> |
| <title>Working in the Properties View</title> |
| <!--[if lte IE 7]><style> |
| .codeblock{ |
| overflow:visible; |
| }</style><![endif]--> |
| </head> |
| <body class="" id="loio504f84d32071419eb2bb5489f0658c21"> |
| <div id="wrapper"><div id="container"> |
| <h1 class="title topictitle1">Working in the Properties View</h1> |
| <div class="body conbody"><p class="shortdesc">The Properties View allows you to edit OData properties. These properties are used to |
| define the different artifacts in the model. </p> |
| <p class="p"><img class="image" id="loio504f84d32071419eb2bb5489f0658c21__image_h43_d2k_tp" width="960px" src="ebfd42f61e7a4b3bb3ece79a169b6eb1.image"/> |
| </p> |
| <p class="p">Each artifact displays a different set of attributes according to the OData specifications. |
| When you change the selection of an artifact in the OData Model Editor or in the project |
| explorer tree, the attributes displayed in the Properties View change accordingly. </p> |
| <div class="p"><div class="note note" id="loio504f84d32071419eb2bb5489f0658c21__note_N10087_N10080_N10012_N10001"><span class="notetitle">Note</span> When selecting an artifact in the OData Model |
| Editor its properties are displayed in the Properties view in read-only mode. |
| </div> |
| When you change an attribute in the OData Model Editor, the changes are reflected |
| automatically in the Properties view and vice-versa. For example, you can change the |
| name of the artifact in either place and it will be updated in both. The Properties view |
| also allows you to change attributes that are not editable in the OData Model Editor, |
| for example, changing the name of the schema. </div> |
| <div class="p">To display the Properties view:<ol class="ol" id="loio504f84d32071419eb2bb5489f0658c21__ol_wnl_wbc_4j"><li class="li">Select <span class="ph menucascade"><img src="../images/navstart.gif" alt="Start of the navigation path" title="Start of the navigation path"/> <span class="ph uicontrol">Window</span> <img src="../images/navstep.gif" alt="Next navigation step" title="Next navigation step"/> <span class="ph uicontrol">Show View</span> <img src="../images/navstep.gif" alt="Next navigation step" title="Next navigation step"/> <span class="ph uicontrol">Other</span> <img src="../images/navend.gif" alt="End of the navigation path" title="End of the navigation path"/></span>. The<strong class="ph b"> Show View </strong>dialog is displayed</li> |
| <li class="li">Select <span class="ph menucascade"><img src="../images/navstart.gif" alt="Start of the navigation path" title="Start of the navigation path"/> <span class="ph uicontrol">General</span> <img src="../images/navstep.gif" alt="Next navigation step" title="Next navigation step"/> <span class="ph uicontrol">Properties</span> <img src="../images/navend.gif" alt="End of the navigation path" title="End of the navigation path"/></span>. The <strong class="ph b">Properties</strong> view is displayed.</li> |
| </ol> |
| </div> |
| <div class="p">To edit the properties of OData artifacts: <ol class="ol" id="loio504f84d32071419eb2bb5489f0658c21__ol_wgq_wbc_4j"><li class="li">Select the desired artifact.</li> |
| <li class="li">From the <strong class="ph b">General</strong> tab, give the desired value to the artifact’s attributes |
| displayed. </li> |
| </ol> |
| </div> |
| <div class="section" id="loio504f84d32071419eb2bb5489f0658c21__section_N1005A_N10012_N10001"><div class="section_title">Referential Constraints</div><div type="Referential Constraints"> |
| |
| <p class="p">A referential constraint asserts that the entity on the principal end of the |
| referential constraint must exist in order for the entity on the dependent end to |
| exist. This assertion is established by the |
| <span class="ph filepath">edm:ReferentialConstraint</span> element.</p> |
| |
| <p class="p">A referential constraint must contain exactly one <span class="ph filepath">edm:Principal |
| </span>element and exactly one <span class="ph filepath">edm:Dependent </span>element. </p> |
| |
| <div class="p">To maintain association referential constraints: <div class="note note" id="loio504f84d32071419eb2bb5489f0658c21__note_N10120_N1011D_N10101_N10012_N10001"><span class="notetitle">Note</span> Referential constraints are not |
| relevant for associations in a many to many relationship.</div> |
| <ol class="ol" id="loio504f84d32071419eb2bb5489f0658c21__ol_l2f_5cc_4j"><li class="li">Select desired association. The association’s attributes are displayed in |
| the Properties view. </li> |
| <li class="li">Select <span class="ph uicontrol">Referential Constraint</span>. </li> |
| <li class="li">In the <span class="ph uicontrol">Value</span> column, choose <img class="image" id="loio504f84d32071419eb2bb5489f0658c21__image_srd_s2k_tp" src="41ddb30b77804ebf95df9a866931ed0e.image"/>. |
| The <span class="ph uicontrol">Referential Constraint</span> page is displayed. </li> |
| <li class="li">From the <span class="ph uicontrol">Principle</span> drop-down list, select the entity |
| with the principal role. The <span class="ph uicontrol">Dependent</span> column is |
| filled in automatically with the second entity in the association. <div class="note note" id="loio504f84d32071419eb2bb5489f0658c21__note_N10152_N10147_N10124_N1011D_N10101_N10012_N10001"><span class="notetitle">Note</span> If the |
| association is 1:many, the entity from which the association goes to |
| many is automatically selected as Principal.</div> |
| </li> |
| <li class="li">In the<span class="ph uicontrol"> Principle Key</span> column, select the property key |
| that will act as lead in the association. <div class="note note" id="loio504f84d32071419eb2bb5489f0658c21__note_N1015E_N10157_N10124_N1011D_N10101_N10012_N10001"><span class="notetitle">Note</span> The |
| properties displayed in the <span class="ph uicontrol">Principal Key</span> column, |
| depend on the properties defined as Key in the OData Model |
| Editor.</div> |
| </li> |
| <li class="li"> From the<span class="ph uicontrol"> Dependent Property</span> drop-down list, select |
| the desired property to be dependent on the principal key. <div class="note note" id="loio504f84d32071419eb2bb5489f0658c21__note_N1016E_N10167_N10124_N1011D_N10101_N10012_N10001"><span class="notetitle">Note</span> You cannot |
| use the same property for two different Principle keys.</div> |
| </li> |
| <li class="li">Choose <span class="ph uicontrol">OK</span>. The referential constraint is displayed in |
| the <span class="ph uicontrol">Value</span> column of the Properties Editor. </li> |
| </ol> |
| </div> |
| |
| <div class="p">To delete a referential constraint:<ol class="ol" id="loio504f84d32071419eb2bb5489f0658c21__ol_gpn_wgf_pj"><li class="li">Select desired association. The association’s attributes are displayed in |
| the Properties view.</li> |
| <li class="li">Select<span class="ph uicontrol"> Referential Constraint</span>.</li> |
| <li class="li">In the <span class="ph uicontrol">Value</span> column, choose <img class="image" id="loio504f84d32071419eb2bb5489f0658c21__image_ljj_gfk_tp" src="41ddb30b77804ebf95df9a866931ed0e.image"/> . |
| The <span class="ph uicontrol">Referential Constraint</span> page is displayed. </li> |
| <li class="li">Choose <span class="ph uicontrol">Delete</span>. All the referential constraints for |
| these entities are deleted.</li> |
| </ol> |
| </div> |
| |
| <div class="p">To maintain association set:<ol class="ol" id="loio504f84d32071419eb2bb5489f0658c21__ol_orx_ngf_pj"><li class="li">Select desired association. The association’s attributes are displayed in |
| the Properties view. </li> |
| <li class="li">Select <span class="ph uicontrol">Association Sets</span>.</li> |
| <li class="li">In the <span class="ph uicontrol">Value</span> column, choose . The<span class="ph uicontrol"> Association |
| Sets</span> page is displayed. On the displayed page you can see a |
| table with the association set properties (name of the association set, end1 |
| entity set, and end2 entity set). </li> |
| <li class="li">To add a new association set, choose the <span class="ph uicontrol">Add</span>. </li> |
| <li class="li">To delete an association set, select it from the table and choose |
| <span class="ph uicontrol">Remove</span>. </li> |
| <li class="li">To edit the name of the association set, in the Name column, select the |
| desired name and edit it. </li> |
| <li class="li">To change an entity set of the association set, select the desired entity |
| set and change it by selecting a different one from the drop-down list. </li> |
| <li class="li">Choose <span class="ph uicontrol">Apply</span>.</li> |
| </ol> |
| </div> |
| |
| </div></div> |
| </div> |
| <div class="topic nested1" id="topic_dmx_thf_pj"><h2 class="title topictitle2">Annotations</h2> |
| <div class="body"><p class="shortdesc">You can apply annotations to OData artifacts from the Properties View |
| <span class="ph uicontrol">Annotations</span> tab.</p> |
| <div class="note note" id="topic_dmx_thf_pj__note_N1020E_N1020B_N101F8_N10001"><span class="notetitle">Note</span> The <span class="ph uicontrol">Annotations</span> tab |
| is enabled only when an OData artifact that supports annotations is selected.</div> |
| <div class="p">To apply annotations to an OData artifact:<ol class="ol" id="topic_dmx_thf_pj__ol_ccn_lmf_pj"><li class="li">Select the desired artifact from the model and choose <img class="image" id="topic_dmx_thf_pj__image_stp_xfk_tp" src="0a80b8c1b2c849a19e6d612219b8618c.image"/>(maintain annotation) from the Properties view toolbar. The |
| <span class="ph uicontrol">Maintain Annotation</span> page is displayed showing the |
| available (loaded) vocabularies. These vocabularies contain the applicable |
| terms for the selected artifact.</li> |
| <li class="li">Expand the desired vocabulary. <div class="note note" id="topic_dmx_thf_pj__note_N101A2_N1019F_N1018C_N10189_N1017D_N1016A_N10001"><span class="notetitle">Note</span> If terms have |
| already been selected for this vocabulary, they appear in the list with |
| thier checkbox selected.</div> |
| </li> |
| <li class="li">If the desired vocabulary is missing, you can add it manually using the |
| <span class="ph filepath">edmx</span> references. For more information see the |
| <cite class="cite">Adding EDMX References</cite> topic.</li> |
| <li class="li">Select the checkbox of the desired term(s).</li> |
| <li class="li">When finished, choose <span class="ph uicontrol">OK</span>. The annotations tab is |
| displayed in the Properties view.</li> |
| <li class="li">You can edit each term in the <span class="ph uicontrol">Value</span> column according |
| to the term's limitations.</li> |
| </ol> |
| </div> |
| <p class="p"/> |
| <div class="p">To edit simple value annotations:<ul class="ul" id="topic_dmx_thf_pj__ul_px2_g4f_pj"><li class="li">Entering the appropriate value (according to the annotation type).</li> |
| <li class="li">Selecting an artifact from the <span class="ph uicontrol">Value</span> drop-down list. |
| If there are other artifacts of the same type (for example, edm.string |
| type), they are displayed in the drop-down list.</li> |
| </ul> |
| <div class="note note" id="topic_dmx_thf_pj__note_N10258_N10249_N1020B_N101F8_N10001"><span class="notetitle">Note</span> For Boolean annotations, the |
| drop-down list contains <span class="ph uicontrol">True</span>, |
| <span class="ph uicontrol">False</span>, and Artifacts of type Boolean (in this case |
| you cannot enter the value).</div> |
| <div class="note note" id="topic_dmx_thf_pj__note_N1026C_N1024D_N1020B_N101F8_N10001"><span class="notetitle">Note</span> If the term is annotated with the |
| annotation <span class="ph filepath">isPropertyPath</span>, you can choose its value only |
| from the drop-down list . You can check the annotations for the terms in each of |
| the vocabularies. To acces the vocabularies provided out-of-the-box, go to the |
| OASIS repositories webpage. </div> |
| </div> |
| <p class="p">Annotations of type record can contain simple value annotations and annotation |
| collections within them. To see what the record annotiation is composed of, expand |
| the term cell. </p> |
| <div class="p">To edit record annotations:<ul class="ul" id="topic_dmx_thf_pj__ul_urj_dm1_qj"><li class="li">Edit the simple value annotations.</li> |
| <li class="li">Edit collections:<ol class="ol" id="topic_dmx_thf_pj__ol_hdb_kn1_qj"><li class="li"> selecting the value cell and choosing <img class="image" id="topic_dmx_thf_pj__image_gns_ggk_tp" src="41ddb30b77804ebf95df9a866931ed0e.image"/>. The<span class="ph uicontrol"> Maintain Dynamic |
| Annotation </span>dialog is opened.</li> |
| <li class="li">Expand the collection to set the value for each annotation.</li> |
| <li class="li">To add a collectable expression, select the desired collection row |
| and choose <span class="ph uicontrol">Add</span>. </li> |
| <li class="li">To remove a collectable expression, select the desired collectable |
| expression's row and choose <span class="ph uicontrol">Remove</span>.</li> |
| </ol> |
| </li> |
| </ul> |
| </div> |
| </div> |
| <div class="related-links"> |
| <div class="relinfo"><div class="relinfotitle ">Related Information</div> |
| <div><a class="extlink" href="http://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/examples/#_trunk_spec_examples_" target="_blank">OASIS repositories webpage<img src="../images/3rd_link.png" class="link-external" alt="Information published" title="Information published" border="0"/></a></div> |
| </div> |
| </div></div> |
| </div></div> |
| </body> |
| </html> |