Oracle Migration Tool On Demand Guide > Migrating Workflow Rules and Action Sets > Elements and Sections in the Workflow Action Sets Output File >

Assign a Book Workflow Action Set


Table 58 describes the elements and sections in the Assign a Book workflow action set XML output file.

Table 58. Elements and Sections in the Assign a Book Workflow Action Set XML File
Element or Section
Description

<data:WorkflowName>Opportunity Rule
</data:WorkflowName>

<WorkflowName> contains the name of the workflow rule with which this action is associated. When performing an Upsert or InsertOrUpdate operation for workflow actions, this name is used to find a matching workflow rule.

<data:WorkflowAction>
. . .
</data:WorkflowAction>

The <WorkflowAction> section contains the details of the workflow action.

<data:WorkflowAction>
  <data:Name>BookAssignTest
  </data:Name>
. . .
</data:WorkflowAction>

<Name> is the name of the workflow action.

<data:WorkflowAction>
. . .
  <data:Active>true</data:Active>
. . .
</data:WorkflowAction>

<Active> specifies whether the workflow action is active (true) or inactive (false).

<data:WorkflowAction>
. . .
  <data:Order>1</data:Order>
. . .
</data:WorkflowAction>

<Order> is the order number for the workflow action within the set of actions on the workflow rule. It determines the order in which Oracle CRM On Demand invokes the sequence of workflow actions on the workflow rule.

<data:WorkflowAction>
. . .
  <data:WorkflowAssignBookAction>
. . .
  </data:WorkflowAssignBookAction>
</data:WorkflowAction>

The <WorkflowAssignBookAction> section contains the details of the Assign a Book workflow action.

<data:WorkflowAction>
 . . .
  <data:WorkflowAssignBookAction>
    <data:BookName>MyBook</data:BookName>
    <data:BookExpr/>
. . .
  </data:WorkflowAssignBookAction>
</data:WorkflowAction>

If the <AssignmentOption> element value is anything other than Remove all, then either the <BookName> element or the <BookExpr> element is required, to specify the target book. The target book is the book that is to be assigned to records, or removed from records, by the workflow action. The target book is specified as follows:

  • <BookName> optionally specifies the name of the target book.
  • <BookExpr> optionally contains an expression that evaluates to the name of a book.

NOTE:  If the <BookName> and <BookExpr> elements both contain a value in an input file for an Upsert or InsertOrUpdate command, then only the value of the <BookName> element is saved in Oracle CRM On Demand.

<data:WorkflowAction>
. . .
  <data:WorkflowAssignBookAction>
. . .
    <data:AssignmentOption>Replace Only
    </data:AssignmentOption>
. . .
  </data:WorkflowAssignBookAction>
</data:WorkflowAction>

<AssignmentOption> specifies the type of book assignment. The valid values are as follows:

  • Add. This option assigns the target book to all records.
  • Replace. This option assigns the target book to all records and removes any previously assigned books that have the same type as the target book.
  • Replace All. This option assigns the target book to all records and removes all previously assigned books, regardless of type.
  • Replace Only. This option specifies that a currently assigned book is to be replaced by the target book. If the <AssignmentOption> element value is Replace Only, then the <ReplaceBookName> element or the <ReplaceBookExpr> element specifies the book that is to be replaced.
  • Remove. This option removes the existing assignment to the target book from all records.
  • Remove All. This option removes all assigned books from the records.

<data:WorkflowAction>
. . .
  <data:WorkflowAssignBookAction>
. . .
    <data:ReplaceBookName>NewBook
    </data:ReplaceBookName>
    <data:ReplaceBookExpr/>
. . .
  </data:WorkflowAssignBookAction>
</data:WorkflowAction>

If the <AssignmentOption> element value is Replace Only, then either the <ReplaceBookName> element or the <ReplaceBookExpr> element is required, to specify the book that is to be replaced. The elements are as follows:

  • <ReplaceBookName> optionally contains the name of the book that is to be replaced.
  • <ReplaceBookExpr> optionally contains an expression that evaluates to the name of the book that is to be replaced.

NOTE:  If the <ReplaceBookName> and <ReplaceBookExpr> elements both contain a value in an input file for an Upsert or InsertOrUpdate command, then only the value of the <ReplaceBookName> element is saved in Oracle CRM On Demand.

<data:WorkflowAction>
. . .
  <data:WorkflowAssignBookAction>
. . .
    <data:ApplyTo>Both</data:ApplyTo>
  </data:WorkflowAssignBookAction>
</data:WorkflowAction>

<ApplyTo> specifies the cases in which the new book assignment will be made. The <ApplyTo> element is required if the <AssignmentOption> element value is anything other than Add. The valid values are as follows:

    • Manual. The book assignment will be made only in cases where the previous book assignment was made manually.
    • Auto. The book assignment will be made only in cases where the previous book assignment was made through workflow or a batch assignment.
    • Both. The new book assignment will be made in all cases.
Oracle Migration Tool On Demand Guide, Release 35 Copyright © 2017, Oracle and/or its affiliates. All rights reserved. Legal Notices.