Oracle Migration Tool On Demand Guide > Migrating Access Profiles > Migrating Access Profiles >

Extracting a Single Access Profile by System Name Using a Template File

This topic describes how to extract a single access profile from your Oracle CRM On Demand server for your environment (customer test environment or production) by system name, using a template file.

Syntax

The following is the syntax for using the Oracle Migration Tool On Demand client to extract a specific access profile by system name, using an access profile input file that is derived from the access profile template file:

migrationtool -u UserID -s ServerURL Read AccessProfile AccessProfileTemplateXML

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.
• AccessProfileTemplateXML is an XML file that is derived from the default access profile template file on your computer. The default access profile template (AccessProfile.xml) is located in the install_path\resources\template directory, for example:

  C:\Oracle Migration Tool On Demand\resources\template

  NOTE:  Do not modify the default template file. If the template file is modified, then a Read operation extracts only the access profile specified in the template file, bypassing what is provided on the command line. Instead, modify a copy of the default access profile.

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 Extracting a Single Access Profile by System Name Using a Template File

The following is an example of extracting a specific access profile by system name using a template file. In this example, before you run the Oracle Migration Tool On Demand client, make a copy of the default file, AccessProfile.xml, and in the copy, add the system name of the access profile between the tags:

<data:Name> </data:Name>

For example: <data:Name>Administrator Default Access Profile</data:Name>)

migrationtool -u UserID -s ServerURL Read AccessProfile "C:\Oracle Migration Tool On Demand\resources\template\MyAccessProfile.xml"

By default, the template files are stored in the following directory:

path of Oracle Migration Tool\resources\template

Also, quotation marks are required only if the name contains spaces. If quotation marks are not surrounding the name, then the Oracle Migration Tool On Demand client uses the first value and bypasses the remaining values. For example, if you have two access profiles called Admin and Admin Access Profile, and you send the following request (without quotation marks), then the Oracle Migration Tool On Demand client extracts the Admin access profile, because no quotation marks are used. Oracle Migration Tool On Demand client uses the first value (Admin) and bypasses the rest (Access Profile):

migrationtool -u UserID -s ServerURL Read AccessProfile Admin Access Profile