Oracle Migration Tool On Demand Guide > Migrating Roles > Migrating Roles >

Updating or Inserting a Specific Role (Upsert)

This topic describes how to update a specific role (if it exists) or insert the role (if it does not exist) in your Oracle CRM On Demand environment (customer test environment or production).

Syntax

The following is the syntax for using the Oracle Migration Tool On Demand client to update a specific role (if it exists) or insert the role (if it does not exist):

migrationtool -u <UserID> -s <ServerURL> Upsert Role <RoleXML>

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.
• <RoleXML> is the fully qualified path name of the role XML file, for example:

  C:\My Files\MyRole.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 a Role

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

migrationtool -u <UserID> -s <ServerURL> Upsert Role "C:\My Files\MyRole.xml"

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