Oracle Migration Tool On Demand Guide > Migrating Action Bar Layouts > Migrating Action Bar Layouts >

Updating or Inserting an Action Bar Layout (Upsert)

This topic describes how to update an Action bar layout (if it exists) or insert a custom Action bar layout (if it does not exist) in your Oracle CRM On Demand environment (customer test environment or production).

NOTE:  Before you upsert an applet into the global header section child container, you must configure the applet in the global header section through the section child container.

About the Upsert Operation

The Upsert command inserts or updates an Action bar layout based on the <LayoutName> value. If an Action bar layout already exists with the same <LayoutName> value, then an update occurs, otherwise, a new Action bar layout is created.

The matching of the Action bar layout names is case sensitive. For example, <LayoutName>My Custom Action Bar Layout</LayoutName> and <LayoutName>MY Custom Action Bar Layout</LayoutName> are considered two different layouts (because the first layout name contains My, while the second layout name contains MY).

Syntax

The following is the syntax for using the Oracle Migration Tool On Demand client to update an Action bar layout (if it exists) or insert an Action bar layout (if it does not exist):

migrationtool -u UserID -s ServerURL Upsert ActionBarLayout ActionBarLayoutXML

where:

• UserID is the user sign-in ID that has the appropriate privileges to run the Oracle Migration Tool On Demand client commands, for example, CompanyABC/jdoe.
• ServerURL is the URL for the Oracle CRM On Demand server where your company resides.
• ActionBarLayoutXML is the fully qualified path name of the Action bar layout XML file, for example:

  C:\My Files\MyActionBarLayout.xml

NOTE:  The Oracle Migration Tool On Demand client requests your Oracle CRM On Demand password, which can be redirected (using the pipe command) to the client program from standard input; that is, from a file, from the command line, or from another program.

Example of Updating or Inserting an Action Bar Layout

The following is an example of updating an Action bar layout (if it exists) or inserting the action bar layout (if it does not exist) in your Oracle CRM On Demand server:

migrationtool -u UserID -s ServerURL Upsert ActionBarLayout "C:\My Files\MyActionBarLayout.xml"

NOTE:  Quotation marks are required only if the name contains spaces.