Oracle Migration Tool On Demand Guide > Migrating Search Layouts >

Elements and Sections in the Search Layout XML Output File


Table 49 describes the elements and sections in the search layout XML output file.

Table 49. Elements and Sections in the Search Layout XML File
Element or Section
Description

<data:SearchLayout>
. . .
</data:SearchLayout>

The <SearchLayout> section contains all of the information for a single search layout.

<data:SearchLayout>
  <data:ObjectName>Account
  </data:ObjectName>
. . .
</data:SearchLayout>

<ObjectName> contains the system name of the record type (object), which never changes.

<data:SearchLayout>
. . .
  <data:LayoutName>TestLayout
  </data:LayoutName>
. . .
</data:SearchLayout>

<LayoutName> contains the name of the layout.

<data:SearchLayout>
. . .
  <data:LastUpdatedBy>10/17/2012 12:41:05
  </data:LastUpdatedBy>
. . .
</data:SearchLayout>

<LastUpdatedBy> contains the date and time the layout was last updated.

<data:SearchLayout>
  <data:Description>This is a test layout.
  </data:Description>
. . .
</data:SearchLayout>

<Description> contains the description for the layout.

<data:SearchLayout>
. . .
   <data:ListOfSpecifySearchFields>
    <data:SearchLayoutField>
      <data:FieldName>Name_Shadow
      </data:FieldName>
      <data:SearchOptimization>2
      </data:SearchOptimization>
      <data:Section>1</data:Section>
      <data:Order>0</data:Order>
    </data:SearchLayoutField>
. . .
   </data:ListOfSpecifySearchFields>
. . .
</data:SearchLayout>

The <ListOfSpecifySearchFields> section contains the details of the search fields for the layout. For each field, the <SearchLayoutField> section includes the following elements:

  • <FieldName> contains the system name of the field, which never changes.
  • <SearchOptimization> indicates whether the field is optimized for fast search and whether it can be case insensitive in a search. For more information about this element, see About the SearchOptimization Element.
  • <Section> indicates which section of the search field layout the field appears in, as follows:
    • A value of 0 indicates that the field appears in the Not Available Search Fields section.
    • A value of 1 indicates that the field appears in the Targeted Search Fields section.
    • A value of 2 indicates that the field appears in the Additional Search Fields section.
  • The <Order> element indicates the position of the field within the section of the search layout. In the Targeted Search Fields section and the Additional Search Fields section, the fields are numbered consecutively within the section. The first field in each section is numbered 0, the second field is numbered 1, and so on. All of the fields in the Not Available Search Fields section have their order number set
    to -1.

<data:SearchLayout>
. . .
   <data:ListOfDefineSearchResultsLayout>
    <data:SearchLayoutField>
      <data:FieldName>Name_Shadow
      </data:FieldName>
      <data:SearchOptimization>2
      </data:SearchOptimization>
      <data:Section>1</data:Section>
      <data:Order>0</data:Order>
    </data:SearchLayoutField>
   </data:ListOfDefineSearchResultsLayout>
. . .
</data:SearchLayout>

The <ListOfDefineSearchResultsLayout> section contains the details of the search result fields for the layout. For each field, the <SearchLayoutField> section includes the following elements:

  • <FieldName> is the name of the field.
  • <SearchOptimization> indicates whether the field is optimized for fast search and whether it can be case insensitive in a search. For more information about this element, see About the SearchOptimization Element.
  • <Section> indicates which section of the search results layout the field appears in, as follows:
    • A value of 0 indicates that the field appears in the Not Available Search Results Fields section.
    • A value of 1 indicates that the field appears in the Lookup Window Search Results Fields section.
    • A value of 2 indicates that the field appears in the Additional Search Results Fields section.
  • The <Order> element indicates the position of the field within the list of fields. In the Lookup Window Search Results Fields section and the Additional Search Results Fields section, the fields are numbered consecutively within the section. The first field in each section is numbered 0, the second field is numbered 1, and so on. All of the fields in the Not Available Search Results Fields section have their order number set to -1.

<data:SearchLayout>
. . .
  <data:EnableDivisionAsDefaultSearchField>  false
  </data:EnableDivisionAsDefaultSearchField>
. . .
</data:SearchLayout>

The <EnableDivisionAsDefaultSearch Field> element corresponds to the Configure Lookup Window with Division as the Default Search Field check box in the UI. This element is applicable for search layouts for the Product record type only. It determines which field is used as the default search field in Lookup windows for the Product record type, as follows:

  • If this element is set to true, then the Division field is the default search field and it is prepopulated with the user's primary division.
  • If this element is set to false, then the Product Name field is the default search field.

<data:SearchLayout>
. . .
  <data:EnableDefaultFields>true
  </data:EnableDefaultFields>
. . .
</data:SearchLayout>

The <EnableDefaultFields> element corresponds to the Configure Lookup Window With Default Fields check box in the UI. It determines which fields appear in the search results in the Lookup windows for the record type, as follows:

  • If this element is set to true, then a predefined set of fields is displayed in the search results in the Lookup windows for the record type.
  • If this element is set to false, then the fields that are configured as the search fields for the Lookup window are also displayed in the search results in the Lookup window.

<data:SearchLayout>
. . .
  <data:EnableDefaultSearchResults>true
  </data:EnableDefaultSearchResults>
. . .
</data:SearchLayout>

The <EnableDefaultSearchResults> element corresponds to the Show Search Results When Lookup Window Opens check box in the UI. It determines whether a list of available records is displayed in the Lookup window when it opens (true), or if no records are displayed when the Lookup window opens (false).

<data:SearchLayout>
. . .
  <data:EnableAutoResolve>true
  </data:EnableAutoResolve>
. . .
</data:SearchLayout>

The <EnableAutoResolve> element corresponds to the Auto-Resolve Enabled check box in the UI. It determines whether smart associations are enabled (true) or are not enabled (false). Smart associations are automatic searches that make it easier for users to associate records of different record types, such as account, contact, opportunity, activity, and so on with each other. For more information about smart associations, see Oracle CRM On Demand Online Help.

<data:SearchLayout>
. . .
  <data:EnableDefaultCtxSensitiveList>
  false
  </data:EnableDefaultCtxSensitiveList>
...
</data:SearchLayout>

The <EnableDefaultCtxSensitiveList> element corresponds to the Show Context-Sensitive List as Lookup Window Default check box in the UI. It determines whether any available context-sensitive lists appear before the other lists in the record-type List field in the upper-left corner of Lookup windows (true), or if the context-sensitive lists appear after the system lists (false).

NOTE:  This check box is effective only if the Show Context-Sensitive List as Lookup Window Default option is set to Enabled on the company profile.

<data:SearchLayout>
. . .
  <data:EnableKeywordSearch>false
  </data:EnableKeywordSearch>
. . .
</data:SearchLayout>

The <EnableKeywordSearch> element corresponds to the Configure Enhanced Keword Search with Selected Search Results Fields check box in the UI. It determines which fields appear in the search results when an ehanced keyword search is performed for the record type, as follows:

  • If this element is set to true, then the fields that are configured as the search fields for the Lookup window are also displayed in the results of an enhanced keyword search.
  • If this element is set to false, then a predefined set of fields is displayed in the results of an enhanced keyword search.

About the SearchOptimization Element

The <SearchOptimization> element for a field in a search layout indicates whether the field is optimized for fast search and also whether the field can be made case insensitive by selecting the Case Insensitive check box in an advanced search or in the Refine List page for a list. The possible values are as follows:

  • A value of -1 indicates that the field is not optimized for fast search and is always case sensitive, regardless of the setting in the Case Insensitive check box in a search. The names of these fields appear in the default text color in the search layout wizard.
  • A value of 1 indicates that the field is optimized for fast search and is always case sensitive, even when the Case Insensitive check box is selected in a search. The names of these fields appear in green text in the search layout wizard.
  • A value of 2 indicates that the field is optimized for fast search and becomes case insensitive when the Case Insensitive check box is selected in a search. The names of these fields appear in blue text in the search layout wizard.
  • A value of 3 indicates that the field is not optimized for fast search and is always case insensitive, regardless of the setting in the Case Insensitive check box in a search. The names of these fields appear in purple text in the search layout wizard.
Oracle Migration Tool On Demand Guide, Release 33 Copyright © 2016, Oracle and/or its affiliates. All rights reserved. Legal Notices.