<?xml version="1.0" encoding="UTF-8"?>
<!--Arbortext, Inc., 1988-2015, v.4002-->
<!DOCTYPE pubsConcept PUBLIC "-//PTC//DTD PUBS DITA Concept//EN"
 "pubsConcept.dtd">
<?Pub UDT template _font?>
<?Pub UDT _bookmark _target?>
<?Pub Inc?>
<pubsConcept id="_filtering_documents_30940" xml:lang="en"
xmlns:import="http://www.oberontech.com/import" import:style="0_Topic"
import:mapobject="1Heading_to_conceptH1">
<title>Using Custom Fields and Custom Field Values</title>
<pubsConbody>
<p>Custom fields provide users who are not <ph
conkeyref="text_variables/ProdName01"
conref="../common/text_variables.dita#text_variables/ProdName01"></ph
> system administrators the ability to define fields for capturing
project-specific metadata using the <ph
conkeyref="text_variables/ProdName01"
conref="../common/text_variables.dita#text_variables/ProdName01"></ph
> client GUI. </p>
<p>Project administrators with appropriate permissions to create or
edit an instance of a project backing item can define custom fields.
When items are associated with a specific project, those items allow
users to specify values for the custom fields defined on the project
backing item.</p>
<p>Users with appropriate permissions to edit an instance of an item
can modify the custom field values.</p>
<p otherprops="Manuals">For more information, see “Specifying Custom
Field Values” in the <ph
conref="../common/text_variables.dita#text_variables/_Guide_Integrity_Getting_Started"
></ph>.</p>
<p otherprops="Help">For more information, see <xref format="dita"
href="..\int-user\client_items_custom_field_values_specify.dita"
scope="local" type="pubsConcept">Specifying Custom Field Values</xref
>.</p>
<section><title>Custom Fields Pre-Requisites</title><p>For project
administrators to configure custom fields on project backing items,
an <ph conkeyref="text_variables/ProdName01"
conref="../common/text_variables.dita#text_variables/ProdName01"></ph
> system administrator must complete the following actions using the <ph
conref="../common/text_variables.dita#text_variables/ProdName06"></ph
> GUI:</p><ol>
<li><p>Define a project backing item type and enable the Back Projects
attribute on the type.</p></li>
<li><p>Define field visibility for Custom Fields for the project backing
item type.</p></li>
</ol><p>For more information on these pre-requisite actions, see the
following topics:</p><table>
<tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/>
<thead>
<row>
<entry valign="top"><?PubTbl cell border-bottom-width="0.50pt"
border-left-width="0.50pt" border-right-width="0.50pt" border-top-width="0.50pt"?><p
>To...</p></entry>
<entry valign="top"><?PubTbl cell border-bottom-width="0.50pt"
border-right-width="0.50pt" border-top-width="0.50pt"?><p>See this
section...</p></entry>
</row>
</thead>
<tbody>
<row>
<entry><?PubTbl cell border-bottom-width="0.50pt"?><p>Define a project
backing item type</p></entry>
<entry><?PubTbl cell border-bottom-width="0.50pt"?><p><xref
format="dita" href="serv_proj_WF_projects_managing_metadata.mif-1.dita"
scope="local" type="pubsConcept">Managing Metadata for Workflow and
Document Projects</xref></p></entry>
</row>
<row>
<entry><?PubTbl cell border-bottom-width="0.50pt" border-left-width="0.50pt"
border-right-width="0.50pt"?><p>Define field visibility</p></entry>
<entry><?PubTbl cell border-bottom-width="0.50pt" border-right-width="0.50pt"?><p
><xref format="dita"
href="serv_type_setting_field_visibility_for_types.mif-1.dita"
scope="local" type="pubsConcept">Setting Field Visibility for Types</xref
></p></entry>
</row>
</tbody>
</tgroup>
</table><p>In addition to the pre-requisites, project backing items
also must be created. <ph
conref="../common/text_variables.dita#text_variables/ProdName01"></ph
> system administrators can create a project backing item using the <ph
conref="../common/text_variables.dita#text_variables/ProdName06"></ph
> GUI. For more information, see <xref format="dita"
href="serv_proj_WF_projects_managing_metadata.mif-2.dita" scope="local"
type="pubsTask">To back a workflow and document project with an Item</xref
>.</p><note><p>The Custom Fields field can only be visible on a Type
that backs projects. The Custom Field Values field can then be set
as visible on Types where users set custom field values.</p></note
></section>
<section><title>Defining Project-Specific Custom Fields</title><p
><ph conref="../common/text_variables.dita#text_variables/ProdName01"
></ph> system administrators can define custom fields on a project
backing item using the <ph
conref="../common/text_variables.dita#text_variables/ProdName06"></ph
> GUI.</p><p otherprops="Manuals">For more information on defining
custom fields, see “Defining Project-Specific Custom Fields” in the <ph
conref="../common/text_variables.dita#text_variables/_Guide_Integrity_Getting_Started"
></ph>.</p><p otherprops="Help">For more information on defining custom
fields, see <xref format="dita"
href="..\int-user\client_items_custom_fields_values_define_custom_fields.dita"
scope="local" type="pubsConcept">Defining Project-Specific Custom
Fields</xref>.</p><?Pub Caret 53?></section>
<section><title>Key Considerations</title><p>The Custom Fields field
is created automatically in an Integrity system, in version 10.9 or
later. To enable users to set custom field values on items, a system
administrator must complete the following tasks:</p><ul>
<li><p>Make the Custom Field visible on the item type that is backing
their project.</p></li>
<li><p>Make the Project field visible on the target item type.</p
></li>
<li><p>Make the Custom Field Values field visible on the target item
type.</p></li>
</ul><p>Once project administrators have created custom field definitions
on the project backing item, users can specify custom field values
on items that participate in that project.</p><p>Relevance and editability
rules apply to the Custom Field field and the Custom Field Values
fields as a whole, and not to individual fields or values. For more
information, see <xref format="dita"
href="serv_fields_creating_fields.mif-11.dita" scope="local"
type="pubsConcept">Setting Field Relevance</xref> and <xref
format="dita" href="serv_fields_creating_fields.mif-13.dita"
scope="local" type="pubsConcept">Setting Field Editability</xref>.</p
></section>
<section><title>Known Limitations</title><p>When working with Custom
Fields and Custom Field Values, note the following limitations:</p
><ul>
<li><p>Mandatory fields on an item Type cannot include Custom Fields
or Custom Field Values.</p></li>
<li><p>The visible fields on an item Type cannot include both Custom
Fields and Custom Field Values.</p></li>
</ul><p>The following <ph
conref="../common/text_variables.dita#text_variables/ProdName01"></ph
> functional areas do not support Custom Fields or Custom Field Values:</p
><ul>
<li><p>Trigger rules</p></li>
<li><p>Type constraints</p></li>
<li><p>Type attributes</p></li>
<li><p>Query Backed Relationship (QBR)</p></li>
<li><p>Item Backed Pick List (IBPL)</p></li>
<li><p>Field Value Attribute (FVA)</p></li>
</ul></section>
</pubsConbody>
</pubsConcept>
