PrF UG inst copy instance - Revision history

RichMorin at 01:03, November 14, 2008

2008-11-14T01:03:38Z

RichMorin: /* Making Copies */

2008-10-26T23:58:28Z

‎Making Copies

RichMorin at 21:07, October 22, 2008

2008-10-22T21:07:04Z

RichMorin at 22:53, October 15, 2008

2008-10-15T22:53:22Z

RichMorin: Automated import of articles

2008-10-09T08:53:42Z

Automated import of articles

New page

__NOTOC__
== Copying an Instance ==

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

You can copy an existing instance,
using the Copy Instance
<div>[[Image:PrF_UG_inst_instance.copy.gif|instances_instance.copy]]</div>
button.
Copying an instance is useful when you want to create multiple instances that share some field values.
You can create the first instance,
fill out the shared values,
then copy the instance and fill out or change the remaining values.

Unless you select Deep Copy,
copying an instance duplicates the instance with identical field values.
Only the internal name stored by {{#var:Pr}} is changed.
If you are working with deep copies,
you may want to temporarily clear the
[[PrF_UG_inst_set_display_slot|display slot]],
so that it displays the internal name.

=== Making Copies ===

<ol class='a'>
<li>
At the Instances Tab,
select the instance that you want to copy.


<li>
Click the Copy Instance
[[Image:PrF_UG_inst_instance.copy.gif|instances_instance.copy]]
button.


<li>
In the Copy Frames dialog box,
enter the number of copies that you want to make.

 <div>[[Image:PrF_UG_inst_copy_instance.png|instances_copy_instance]]</div>


<li>
To have {{#var:PrF}} perform a "deep copy",
select the deep copy option.
This is described more fully below.
Otherwise,
the instance is duplicated with identical field values;
only the instance name is changed.

</ol>

=== What is a Deep Copy? ===

You can select to "deep copy" an instance.
A deep copy is a recursive copy that creates a copy of:

<ul class='a'>
<li>
the selected instance


<li>
any instance that appears as a value for an
[[PrF_UG_inst_entry_field_instance|Instance entry field]]
in any copied instance

</ul>

Note the following:

<ul class='a'>
<li>
The copy is recursive.
As long as a new instance appears as a value for a copied instance,
a copy of it is created.


<li>
It is possible for an instance to appear more than once in the chain.
If this happens,
only one copy is created.


<li>
Other referenced instances do not get copied.

</ul>

For example,
if you deep copy the instance M137 for the class Personals_Ad,
then all of the following are copied:

<ul class='a'>
<li>
the instance M137 (class = Personals_Ad)


<li>
all the instances which appear as instance values for M137,
specifically:


<ul>
<li>
the instance 08/19/97 (class = Newspaper),
which appears as the value for the Published In field of M137

</ul>

<li>
all the uncopied instances which appear as values for 08/19/97,
specifically:


<ul>
<li>
Tuesday (class = Prototype_Newspaper),
which appears as the value for the Prototype field

</ul>

<li>
all the instances which appear as values for Tuesday:


<ul>
<li>
Weekday Ads (class = Billing_Chart) in the Prototype Billing Chart field


<li>
Lifestyle, Local News, Magazine, Science, Sports,
and World News (class = Section) in the Sections field

</ul>
</ul>

None of these instances have any instance fields,
so the copy stops here.

<ul class='a'>
<li>
M137 appears again as an instance of 08/19/97.
However,
as it has already been copied,
no additional copy is created.


<li>
M137 appears as a value for San Jose Mercury News (class = Library).
This is not copied.

</ul>

</div>

@@ Line 2: / Line 2: @@
 == Copying an Instance ==
-{{PrF_UG_TOC_inst}}<div id='prf_ug'>
+<noinclude>{{PrF_UG_TOC_inst}}<div id='prf_ug'></noinclude>
 You can copy an existing instance,
@@ Line 148: / Line 148: @@
-</div>
+<noinclude></div></noinclude>

@@ Line 6: / Line 6: @@
 You can copy an existing instance,
 using the <b>Copy Instance</b>
-[[Image:PrF_UG_inst_instance.copy.gif|instances_instance.copy]] button.
+([[Image:PrF_UG_inst_instance.copy.gif|instances_instance.copy]]) button.
 Copying an instance is useful when you want to create multiple instances
 that share some field values.
@@ Line 30: / Line 30: @@
    <li><p>
      Click the <b>Copy Instance</b>
-     [[Image:PrF_UG_inst_instance.copy.gif|instances_instance.copy]] button.
+     ([[Image:PrF_UG_inst_instance.copy.gif|instances_instance.copy]]) button.
      </p>
@@ Line 37: / Line 37: @@
      enter the number of copies that you want to make.
      </p>
-     <div>[[Image:PrF_UG_inst_copy_instance.png|instances_copy_instance]]</div>
+     <div>[[Image:PrF_UG_inst_copy_instance.png|frame|none|
    <li><p>

@@ Line 24: / Line 24: @@
 <ol class='a'>
    <li><p>
-     At the Instances Tab,
+     At the Instances tab,
      select the instance that you want to copy.
      </p>

@@ Line 6: / Line 6: @@
 You can copy an existing instance,
 using the <b>Copy Instance</b>
-<div>[[Image:PrF_UG_inst_instance.copy.gif|instances_instance.copy]]</div>
+[[Image:PrF_UG_inst_instance.copy.gif|instances_instance.copy]] button.
-button.
+Copying an instance is useful when you want to create multiple instances
-Copying an instance is useful when you want to create multiple instances that share some field values.
+that share some field values.
-You can create the first instance,
+You can create the first instance, fill out the shared values,
 then copy the instance and fill out or change the remaining values.
@@ Line 31: / Line 30: @@
    <li><p>
      Click the <b>Copy Instance</b>
-     [[Image:PrF_UG_inst_instance.copy.gif|instances_instance.copy]]
+     [[Image:PrF_UG_inst_instance.copy.gif|instances_instance.copy]] button.
      </p>
@@ Line 38: / Line 36: @@
      In the Copy Frames dialog box,
      enter the number of copies that you want to make.
      </p>
    <li><p>
@@ Line 46: / Line 43: @@
      select the deep copy option.
      This is described more fully below.
-     Otherwise,
+     Otherwise, the instance is duplicated with identical field values;
      only the instance name is changed.
      </p>
@@ Line 63: / Line 59: @@
    <li><p>
-     any instance that appears as a value for an
+     any instance that appears as a value
-    [[PrF_UG_inst_entry_field_instance|Instance entry field]]
+    for an [[PrF_UG_inst_entry_field_instance|Instance entry field]]
      in any copied instance
      </p>
@@ Line 80: / Line 76: @@
    <li><p>
      It is possible for an instance to appear more than once in the chain.
-     If this happens,
+     If this happens, only one copy is created.
      </p>
@@ Line 89: / Line 84: @@
 </ul>
-For example,
+For example, if you deep copy the instance M137 for the class <b>Personals_Ad</b>,
 then all of the following are copied:
@@ Line 99: / Line 93: @@
    <li><p>
-     all the instances which appear as instance values for M137,
+     all the instances which appear as instance values for M137, specifically:
      </p>
@@ Line 138: / Line 131: @@
 </ul>
-None of these instances have any instance fields,
+None of these instances have any instance fields, so the copy stops here.
 <ul class='a'>
    <li><p>
      M137 appears again as an instance of 08/19/97.
-     However,
+     However, as it has already been copied,
      no additional copy is created.
      </p>