Updating or Inserting a Specific Related Information Layout (Upsert)
This topic describes how to update a specific related information layout (if it exists) or to insert the related information layout (if it does not exist) in your Oracle CRM On Demand environment; that is, a customer test environment or production environment.
The configuration data is updated when the System Layout Name exists in the target company for the specified object and related object. The following table lists the results of an Upsert operation in different situations.
If the XML file definition contains... | If the target company contains... | Then the result is... |
---|---|---|
Object: Account Related Object: Account Competitors Layout Name: My Custom Layout |
Object: Account Related Object: Account Competitors Layout: Standard Related Information Layout |
A new My Custom Layout is inserted |
Object: Account Related Object: Account Competitors Layout Name: My Custom Layout |
Object: Account Related Object: Account Competitors Layouts:
|
My Custom Layout is updated. |
Object: Account Related Object: Account Competitors Layout Name: Standard Related Information Layout |
Object: Account Related Object: Account Competitors Layouts:
|
An error is generated because Standard Related Information Layout cannot be updated. |
The Upsert operation has the same limitations as the Oracle CRM On Demand user interface (UI), and it fails if the following conditions occur:
The XML file contains a layout name that exceeds the length supported in the UI.
The XML contains a description that exceeds the length supported in the UI.
The XML content references fields that do not exist in the target environment.
Syntax
The following is the syntax for using the Oracle Migration Tool On Demand client to update a specific related information layout (if it exists) or insert the related information layout (if it does not exist):
migrationtool -u UserID -s ServerURL Upsert RelatedInformationLayout MyRelatedInfoLayoutXML
where:
UserID is the user sign-in ID that has the appropriate privileges to run the Oracle Migration Tool On Demand client commands.
ServerURL is the URL for the Oracle CRM On Demand server where your company resides.
MyRelatedInfoLayoutXML is the fully qualified path name of the related information layout XML file, for example:
C:\My Files\MyRelatedInfoLayout.xml
Example of Updating or Inserting a Related Information Layout
The following is an example of updating a related information layout (if it exists) or inserting the related information layout (if it does not exist) in your Oracle CRM On Demand server:
migrationtool -u UserID -s ServerURL Upsert RelatedInformationLayout "C:\My Files\MyRelatedInfoLayout.xml"