Bookshelf Home | Contents | Index | PDF |
Siebel Business Process Framework: Workflow Guide > Manipulating Data in a Workflow Process > Using Process Properties > Using Process Properties to Manipulate DataThis topic describes how to use a process property to manipulate data. It includes the following topics:
Passing a Process Property In and Out of a Workflow Process StepIt is recommended that the Type field of the top level of a hierarchical argument not contain data. If Siebel Workflow passes a hierarchical process property to a workflow process step, then it overwrites the Type field of the top level process property for the duration of the call. It does this so that the process property matches the name of the argument that the configuration for the input argument defines. This configuration applies only for a long-running, interactive, or service workflow process. For example, assume MyTree is a process property and that the data type for this process property is Hierarchy. MyBusSvc is a business service that contains a hierarchical input argument named SomeTree. Table 19 describes the configuration for this process property. If you use the values that Table 19 describes to define the input argument, then the call to MyBusSvc receives a child in the input process property for the argument where the Process Property Type field is set to SomeTree instead of MyTree. The rest of the data in the child process property remains the same as the contents of the MyTree process property. Siebel Workflow expects an output argument of a workflow process step that passes out a hierarchy as a child of the output property set. To locate the child, Siebel Workflow examines the Type field of the child. The string in the Type field must match the name of the Output Argument field, as defined in the output argument applet of the step. If Siebel Workflow finds such a child, then it does the following:
Passing a Process Property by ReferenceA sub process that modifies a large amount of data must copy this data through input arguments and output arguments. This situation can negatively affect performance and scalability. Pass By Reference is a feature that allows you to pass a pointer to the property set rather than passing all the data that this property set contains. For more information, see Using the Pass By Reference Feature with a Business Service. Passing Data Through a Process Property to an Error-Workflow ProcessSiebel CRM can pass more than only a system defined process property to an error-workflow process. It can pass the following information:
To pass data through a process property to an error-workflow process
Concatenating a Process PropertyThe example in this topic describes how Siebel CRM can use four process properties in a workflow process to concatenate three string values. The three process properties contain the following values in the Default String property: To concatenate a process property
Referencing a Process PropertyTo reference a process property in an expression, you must use the following format: The following example describes how Siebel CRM can use a process property as a substitution variable. This example uses an input argument to create a message body: The Activity #" + [&Object Id] + ", owned by " + [&First Name]+" "+[&Last Name] + " is three days past the Due Date. For more examples of using a process property as a substitution variable, see Using Compound Expressions and Substitutions in a Search Specification and Using Substitution Variables in an Expression. Externalizing Workflow PropertiesIt is recommended that you define properties for a workflow process that are externalized and that are not hard coded. Hard coding a property in a workflow process requires you to change the object definitions when you deploy the workflow process between environments. For example, if a workflow process sends an email to a customer list, and if you hard code this list in a process property, then the workflow process does not run correctly in the production environment. You must make sure the workflow process reads this kind of data dynamically. For more information, see Externalizing Properties When Using a Business Service. |
Siebel Business Process Framework: Workflow Guide | Copyright © 2016, Oracle and/or its affiliates. All rights reserved. Legal Notices. | |