Migrating Custom HTML Head Tag Additions

This chapter describes how to migrate your custom HTML head tag additions. It contains the following topics:

Custom HTML Head Tag Additions

Custom HTML head tag additions are custom <script> elements that you can add to the HTML <head> element of the Oracle CRM On Demand pages. For example, the <script> elements can contain custom JavaScript code that creates custom buttons on your pages. Your custom code can also reference JavaScript files that were uploaded through client side extensions or external JavaScript files. HTML head tag additions apply to all pages in Oracle CRM On Demand.

The following table describes the Oracle Migration Tool On Demand client commands used with custom HTML head tag additions. These commands are case sensitive.

Table Commands Used with Custom HTML Head Tag Additions in Oracle Migration Tool On Demand

Command	Description
`ReadForValue CustomHTMLHeadTag`	This command exports the custom HTML head tag additions for the Oracle CRM On Demand pages.
`Upsert CustomHTMLHeadTag CustomHTMLHeadTagXML`	This command inserts the custom HTML head tag additions that are specified in the XML file. If any custom HTML head tag additions exist in the target environment, then they are overwritten by the content of the input file.

Privileges Required for Migrating Custom HTML Head Tag Additions

The following privileges are required for the user account running the Oracle Migration Tool On Demand client commands:

For the ReadForValue command: Enable Web Services Access, and Upload Client Side Extensions and Manage Custom HTML Head Tag.
For the Upsert command: Enable Web Services Access and Upload Client Side Extensions and Manage Custom HTML Head Tag.

Elements in the Custom HTML Head Tag Additions XML Output File

The following tabledescribes the elements in the custom HTML head tag additions XML output file.

Table Elements in the Custom HTML Head Tag Additions XML File

Description	Element
<HTMLHeadAdditions> contains the HTML head tag additions.	<data:HTMLHeadAdditions> </data:HTMLHeadAdditions>

Migrating Custom HTML Head Tag Additions

The following topics describe how to use the Oracle Migration Tool On Demand client to migrate custom HTML head tag additions:

Extracting Custom HTML Head Tag Additions

This topic describes how to extract the custom HTML head tag additions from the HTML head tag.

Syntax

The following is the syntax for using the Oracle Migration Tool On Demand client to extract the custom HTML head tag additions:

migrationtool -u UserID -s ServerURL ReadForValue CustomHTMLHeadTag

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.

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.

Updating or Inserting Custom HTML Head Tag Additions

This topic describes how to update or insert custom HTML head tag additions for the Oracle CRM On Demand pages in your Oracle CRM On Demand environment (customer test environment or production). If any custom HTML head tag additions exist, then they are overwritten by the content of the input file.

Syntax

The following is the syntax for using the Oracle Migration Tool On Demand client to update or insert custom HTML head tag additions in the HTML <head> element of the Oracle CRM On Demand pages:

migrationtool -u UserID -s ServerURL Upsert CustomHTMLHeadTag CustomHTMLHeadTagXML

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.
CustomHTMLHeadTagXML is the fully qualified path name of the custom HTML head tag additions XML file, for example:
```
C:\MyFiles\CustomHTMLHeadTag.xml
```
If the fully qualified path name contains any spaces, then it must be enclosed with quotation marks, for example:
```
migrationtool -u UserID -s ServerURL Upsert CustomHTMLHeadTag "C:\My Files\CustomHTMLHeadTag.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.