View source for PrF UG inst copy instance

__NOTOC__
== Copying an Instance ==

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

You can copy an existing instance,
using the <b>Copy Instance</b>
([[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.
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 <b>Deep Copy</b>,
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><p>
    At the Instances tab,
    select the instance that you want to copy.
    </p>

  <li><p>
    Click the <b>Copy Instance</b>
    ([[Image:PrF_UG_inst_instance.copy.gif|instances_instance.copy]]) button.
    </p>

  <li><p>
    In the Copy Frames dialog box,
    enter the number of copies that you want to make.
    </p>
    <div>[[Image:PrF_UG_inst_copy_instance.png|frame|none|
           Copy Frames dialog]]</div>

  <li><p>
    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.
    </p>
</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><p>
    the selected instance
    </p>

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

Note the following:

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

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

  <li><p>
    Other referenced instances do not get copied.
    </p>
</ul>

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

<ul class='a'>
  <li><p>
    the instance <u>M137</u> (class = <b>Personals_Ad</b>)
    </p>

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

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

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

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

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

  <ul>
    <li><p>
      <u>Weekday Ads</u> (class = <b>Billing_Chart</b>) in the Prototype Billing Chart field
      </p>
  
    <li><p>
      <u>Lifestyle</u>, <u>Local News</u>, <u>Magazine</u>, <u>Science</u>, <u>Sports</u>,
      and <u>World News</u> (class = <b>Section</b>) in the Sections field
      </p>
  </ul>
</ul>

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, as it has already been copied,
    no additional copy is created.
    </p>

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


<noinclude></div></noinclude>