PrF UG slots make inverse slot - Revision history

RichMorin at 01:48, November 14, 2008

2008-11-14T01:48:51Z

RichMorin: /* Creating a New Inverse Slot */

2008-10-29T20:00:23Z

‎Creating a New Inverse Slot

RichMorin: /* Linking Two Existing Slots */

2008-10-29T19:59:50Z

‎Linking Two Existing Slots

RichMorin at 21:34, October 25, 2008

2008-10-25T21:34:56Z

RichMorin at 23:02, October 16, 2008

2008-10-16T23:02:35Z

Show changes

RichMorin at 23:39, October 14, 2008

2008-10-14T23:39:07Z

RichMorin at 23:36, October 14, 2008

2008-10-14T23:36:59Z

RichMorin at 23:36, October 14, 2008

2008-10-14T23:36:00Z

RichMorin at 23:35, October 14, 2008

2008-10-14T23:35:15Z

RichMorin: Automated import of articles

2008-10-09T09:12:50Z

Automated import of articles

New page

__NOTOC__
== Creating an Inverse Slot Relationship ==

{{PrF_UG_TOC_slots}}<div id='prf_ug'>

The Inverse Slots widget on the Slot Editor allows you to create an inverse relationship between two slots of type Class or Instance.

<ul class='a'>
<li>
You can create an inverse slot relationship in one of two ways:


<ul>
<li>
by
[[#Linking_Two_Existing_Slots|linking two existing slots]]


<li>
by
[[#Creating_a_New_Inverse_Slot|creating a new slot as the inverse]]
of an existing slot

</ul>

<li>
You can also modify inverse slot relationships:


<ul>
<li>
by
[[#Removing_an_Inverse_Slot_Relationship|removing the inverse slot]]
link between two slots


<li>
by
[[#Replacing_an_Inverse_Slot|replacing an inverse slot]]
with another slot

</ul>
</ul>

For an inverse relationship to work correctly,
your two slots and the classes where they appear must be designed appropriately.
For slots of type Instance,
the following situation provides optimal results:

<ul class='a'>
<li>
All classes where the first slot is attached (i.e.,
the domain of the slot) appear in the
[[PrF_UG_slots_value_type_instance#Setting_the_Value_Type_to_Instance|Allowed Classes]]
pane for the second slot.


<li>
All classes where the second slot is attached appear in the
[[PrF_UG_slots_value_type_instance#Setting_the_Value_Type_to_Instance|Allowed Classes]]
pane for the first slot.

</ul>

However,
depending on the structure of your knowledge base,
this may not be appropriate or feasible.
Other situations are also valid.
For example,
suppose slots A and B are inverse slots.
If one of the allowed classes for slot A does not have B as one of its attached slots,
all that happens is that inverse slot value does not get created for those instances.
The inverse relationship will still work normally for those allowed classes that do have slot B attached.

A slot can have at most one inverse slot.
For more information on designing an inverse slot relationship,
see
[[PrF_UG_slots_inverse_slots|Understanding Inverse Slots]].

Note that if you create an inverse slot relationship after instances have been created,
existing instances will not display the inverse slot information.

=== Linking Two Existing Slots ===

To create an inverse slot relationship between two existing slots,
the slots you choose must be of value type Class or Instance.
To create the relationship:

<ol class='a'>
<li>
Open the
[[PrF_UG_slots_slot_editor|Slot Editor]]
for one of the two slots;
it does not matter which one you choose.
You can open the Slot Editor from the
[[PrF_UG_classes_classes_tab|Classes Tab]]
or the
[[PrF_UG_slots_slots_tab|Slots Tab]].


<li>
Click the Add Slot
[[Image:PrF_UG_slots_slot.add.gif|slots_slot.add]]
button at the right of the Inverse Slot field.
[[Image:PrF_UG_slots_inverse_slot_bar.png|slots_inverse_slot_bar]]Note: If the button is grayed out,
you cannot create an inverse slot for the selected slot.
Make sure that the slot is of type Class or Instance.


<li>
Select the slot you want to use from the Select Slot dialog box.
Only slots of type Class or Instance will appear.

 <div>[[Image:PrF_UG_slots_slot_select.png|slots_slot_select]]</div>


<li>
Click OK.
The two slots will now be inverses of each other.

</ol>

You can view the Slot Editor of the second slot by double-clicking on its name in the Inverse Slot field or by using the View Slot
<div>[[Image:PrF_UG_slots_slot.view_top_level.gif|slots_slot.view_top_level]]</div>
button.
You will see that it automatically has the first slot as its inverse slot.
You may also wish to check that the Allowed Classes of each slot contains all the possible classes where the other slot will appear.

=== Creating a New Inverse Slot ===

To create a new slot and make it the inverse of a slot:

<ol class='a'>
<li>
Open the
[[PrF_UG_slots_slot_editor|Slot Editor]]
for the slot you want to create an inverse for.
You can do this from either the Class Tab or the
[[PrF_UG_slots_slots_tab|Slots Tab]]:


<ul>
<li>
On the Slots tab,
select the slot from the list of slots in the Slot Browser pane.


<li>
On the Classes tab,
double-click the slot in the list of Template Slots (or select the slot in the list of Template Slots and click the "View Top-Level Slot" button).

</ul>

<li>
Click the Create Slot
[[Image:PrF_UG_slots_slot.create.gif|slots_slot.create]]
button at the right of the Inverse Slot Editor.
[[Image:PrF_UG_slots_inverse_slot_bar.png|slots_inverse_slot_bar]]Note: If the button is grayed out,
you cannot create an inverse slot for the selected slot.
Make sure it is of type Class or Instance.


<li>
A new class of type Instance is created.
The
[[PrF_UG_slots_slot_editor|Slot Editor]]
for the new slot opens automatically.

 <div>[[Image:PrF_UG_slots_inverse_slot_editor.png|slots_inverse_slot_editor]]</div>


<li>
Name the slot.


<li>
The classes where your original slot appears will be automatically entered in the
[[PrF_UG_slots_value_type_instance#Setting_the_Value_Type_to_Instance|Allowed Classes]]
field.
Modify this list if necessary.


<li>
The classes in the Allowed Classes field of the original slot will be added to the Domain field.
Modify this list if necessary.
Remember that attaching a slot to a class also attaches it to all subclasses of the class.


<li>
Make any other changes you wish to the slot definition.

</ol>

=== Removing an Inverse Slot Relationship ===

Removing the inverse slot relationship removes the link between the two classes.
Note that,
if you remove an inverse slot relationship after instances have been created,
existing values that were created by the inverse slot relationship are not removed.
Removing an inverse slot only affects the values of new instances.
To remove the inverse slot relationship between two slots:

<ol class='a'>
<li>
Highlight the Inverse Slot field in the Slot Editor for either one of the two slots.


<li>
Click the Remove
[[Image:PrF_UG_slots_slot.remove.gif|slots_slot.remove]]
button at the right of the Inverse Slot field.
The slot relationship will be removed.

</ol>

=== Replacing an Inverse Slot ===

Replacing the inverse slot relationship at a slot removes the link to the original inverse slot and makes a link with a different,
existing,
slot.
Note that,
if you replace an inverse slot relationship after instances have been created,
existing values that reflect the original
(replaced)
inverse slot relationship are retained.
Replacing an inverse slot only affects the values of new instance.
To replace an inverse relationship:

<ol class='a'>
<li>
Select the slot you want to have a different inverse.


<li>
Click the Add Slot
[[Image:PrF_UG_slots_slot.add.gif|slots_slot.add]]
button at the right of the Inverse Slot field.


<li>
Select the slot you want from the Select Slot dialog box.


<li>
Click OK.
The new slot becomes the inverse slot of the current slot.
The original inverse slot is now unlinked from the slot where you made the change and no longer has an inverse slot.

</ol>

</div>

@@ Line 2: / Line 2: @@
 == Creating an Inverse Slot Relationship ==
-{{PrF_UG_TOC_slots}}<div id='prf_ug'>
+<noinclude>{{PrF_UG_TOC_slots}}<div id='prf_ug'></noinclude>
 The Inverse Slots widget on the Slot Editor allows you to create an inverse relationship
@@ Line 233: / Line 233: @@
-</div>
+<noinclude></div></noinclude>

@@ Line 74: / Line 74: @@
    <li><p>
      Click the <b>Add Slot</b>
-     [[Image:PrF_UG_slots_slot.add.gif|slots_slot.add]] button
+     ([[Image:PrF_UG_slots_slot.add.gif|slots_slot.add]]) button
      at the right of the Inverse Slot field.
      </p>
-     <div>[[Image:PrF_UG_slots_inverse_slot_bar.png|slots_inverse_slot_bar]]</div>
+     <div>[[Image:PrF_UG_slots_inverse_slot_bar.png|frame|none|
      <p>
      <b>Note:</b>
@@ Line 89: / Line 90: @@
      Only slots of type Class or Instance will appear.
      </p>
-     <div>[[Image:PrF_UG_slots_slot_select.png|slots_slot_select]]</div>
+     <div>[[Image:PrF_UG_slots_slot_select.png|frame|none|
    <li><p>
@@ Line 100: / Line 102: @@
 by double-clicking on its name in the Inverse Slot field
 or by using the <b>View Slot</b>
-[[Image:PrF_UG_slots_slot.view_top_level.gif|slots_slot.view_top_level]] button.
+([[Image:PrF_UG_slots_slot.view_top_level.gif|slots_slot.view_top_level]]) button.
 You will see that it automatically has the first slot as its inverse slot.
 You may also wish to check that the Allowed Classes of each slot
@@ Line 133: / Line 135: @@
    <li><p>
      Click the <b>Create Slot</b>
-     [[Image:PrF_UG_slots_slot.create.gif|slots_slot.create]] button
+     ([[Image:PrF_UG_slots_slot.create.gif|slots_slot.create]]) button
      at the right of the Inverse Slot Editor.
      </p>
-     <div>[[Image:PrF_UG_slots_inverse_slot_bar.png|slots_inverse_slot_bar]]</div>
+     <div>[[Image:PrF_UG_slots_inverse_slot_bar.png|frame|none|
      <p>
      <b>Note:</b>
@@ Line 149: / Line 152: @@
      for the new slot opens automatically.
      </p>
-     <div>[[Image:PrF_UG_slots_inverse_slot_editor.png|
+     <div>[[Image:PrF_UG_slots_inverse_slot_editor.png|frame|none|
-            slots_inverse_slot_editor]]</div>
+            inverse-of-sections dialog]]</div>
    <li><p>
@@ Line 191: / Line 194: @@
    <li><p>
      Click the <b>Remove</b>
-     [[Image:PrF_UG_slots_slot.remove.gif|slots_slot.remove]] button
+     ([[Image:PrF_UG_slots_slot.remove.gif|slots_slot.remove]]) button
      at the right of the <b>Inverse Slot</b> field.
      The slot relationship will be removed.
@@ Line 213: / Line 216: @@
    <li><p>
      Click the <b>Add Slot</b>
-     [[Image:PrF_UG_slots_slot.add.gif|slots_slot.add]] button
+     ([[Image:PrF_UG_slots_slot.add.gif|slots_slot.add]]) button
      at the right of the Inverse Slot field.
      </p>

@@ Line 115: / Line 115: @@
      Open the [[PrF_UG_slots_slot_editor|Slot Editor]]
      for the slot you want to create an inverse for.
-     You can do this from either the Class Tab
+     You can do this from either the Class tab
-     or the [[PrF_UG_slots_slots_tab|Slots Tab]]:
+     or the [[PrF_UG_slots_slots_tab|Slots tab]]:
      </p>

@@ Line 68: / Line 68: @@
      it does not matter which one you choose.
      You can open the Slot Editor
-     from the [[PrF_UG_classes_classes_tab|Classes Tab]]
+     from the [[PrF_UG_classes_classes_tab|Classes tab]]
-     or the [[PrF_UG_slots_slots_tab|Slots Tab]].
+     or the [[PrF_UG_slots_slots_tab|Slots tab]].
      </p>

@@ Line 101: / Line 101: @@
 </ol>
-You can view the Slot Editor of the second slot by double-clicking on its name in the Inverse Slot field or by using the <b>View Slot</b>
+You can view the Slot Editor of the second slot
-<div>[[Image:PrF_UG_slots_slot.view_top_level.gif|slots_slot.view_top_level]]</div>
+by double-clicking on its name in the Inverse Slot field
-button.
+or by using the <b>View Slot</b>
 You will see that it automatically has the first slot as its inverse slot.
-You may also wish to check that the Allowed Classes of each slot contains all the possible classes where the other slot will appear.
+You may also wish to check that the Allowed Classes of each slot
 === Creating a New Inverse Slot ===
@@ Line 128: / Line 130: @@
      <li><p>
        On the Classes tab,
-       double-click the slot in the list of Template Slots (or select the slot in the list of Template Slots and click the "View Top-Level Slot" button).
+       double-click the slot in the list of Template Slots
        </p>
    </ul>
@@ Line 136: / Line 140: @@
      [[Image:PrF_UG_slots_slot.create.gif|slots_slot.create]]
      button at the right of the Inverse Slot Editor.
-     [[Image:PrF_UG_slots_inverse_slot_bar.png|slots_inverse_slot_bar]]<b>Note:</b> If the button is grayed out,
+     </p>
      you cannot create an inverse slot for the selected slot.
      Make sure it is of type Class or Instance.
@@ Line 143: / Line 150: @@
    <li><p>
      A new class of type Instance is created.
-     The
+     The [[PrF_UG_slots_slot_editor|Slot Editor]]
      for the new slot opens automatically.
@@ Line 156: / Line 162: @@
    <li><p>
      The classes where your original slot appears will be automatically entered in the
-     [[PrF_UG_slots_value_type_instance#Setting_the_Value_Type_to_Instance|Allowed Classes]]
+     [[PrF_UG_slots_value_type_instance#Setting_the_Value_Type_to_Instance|Allowed Classes]] field.
      Modify this list if necessary.
      </p>

@@ Line 9: / Line 9: @@
    <li><p>
      You can create an inverse slot relationship in one of two ways:
      </p>
    <li><p>
-     You can also modify inverse slot relationships:
+     You can also modify inverse slot relationships,
      </p>
 </ul>