![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |
You can change a process-level data field to a parameter by right-clicking it, and selecting Convert Data Field to Parameter. The default mode for converted parameters is In/Out, meaning that they can be specified as either input or output.
• Parameters can also be specified as input, output or both by selecting the Mode (In, Out, or In/Out). The mode is indicated by the icon next to the parameter:
• in the Properties view table provided when the Parameters or Data Fields folder is selected in Project Explorer (this method is better if you need to create several data fields or parameters), or
See Associating Participants with Activities for information on how to highlight all the tasks in a process that have a particular data field or parameter assigned to them.If the Data Fields folder is empty under a package, it will be hidden by default. This is because the preferred usage is to define Data Fields at the Process level.
If you want to show the Data Fields folder under a package, regardless of whether it is empty or not, then you need to go to Project Explorer, and click the View Menu icon in the top right corner, then select Customize View. You can then deselect BPM Package Data Fields on the list of filters which are set.
2. As appropriate, click Data Fields or Parameters folder in the Project Explorer. If you need to add a Data Field at the Package level, select New > Data Field as described in Using the Wizards below.
3.
2. As appropriate, right-click Data Fields or Parameters and select New > Data Field or New > Parameter. The New Data Field or New Parameter dialog is displayed.
If you start this wizard from the File > New menu, the first dialog is the project and package dialog, where you must specify a valid project and package. This dialog is not displayed if you right-click at the process level to start the dialog; however you can click Back to display it.
− Mandatory (Parameter only) Select this checkbox to specify that the parameter must be present when the process is started.
− Read Only Select this checkbox to specify that the value of the data field or parameter cannot be modified after it is created.
− Mode (Parameter only) Select whether the parameter will be an input (In) output (Out) or both (In/Out).
The parameters specified on the Interface tab for a user task are from the perspective of the form, not the user. This means that input parameters are sent to the form by the process, not the user. Output Parameters are sent to the form by the user.
− Basic Type If you select this type, you can choose from Text, Decimal Number, Integer Number, Boolean, Date, Time, Date Time or Performer. For more information about using performer data types, see the appropriate implementation guide.
If you need to create a Text field of unlimited length, ensure that the Length field is empty. If you wish to limit the number of characters enter the appropriate numeric value.
− Initial Value For data fields, you can optionally specify an Initial Value by clicking in the provided text entry area and entering a value. For arrays, you can add more than one value:
− Allowed Values For parameters, you can optionally specify the permitted input values (values that may be supplied by application starting an instance of the process). You can add rows by clicking thebutton. You can also delete rows by clicking the
button.
− Declared Type This option allows you to select from the declared types that you have already defined (see Creating Declared Types).
− External Reference Allows you to refer to a business object defined in the Business Object Modeler.
6. Select whether you want the data field or parameter to be an array. Selecting the Array checkbox creates an array of the Basic Type that is selected. For example, if you select the Array checkbox and Text, you are defining the data field or parameter as an array of Text values.
7. Click Finish to create the data field or parameter, or click Next to specify a documentation URL, description, or extended attributes.
8. The Documentation Url and Description fields allow you to specify supplementary information about the data field or parameter that you have created.
9. The Extended dialog allows you to specify extended attributes. For more information about extended attributes, see Creating Extended Attributes.
• If an Integer or Decimal field has its Length set to 9, a warning is displayed that format restrictions are not enforced, and at runtime you can still assign a value with more than 9 digits.
• If a Decimal field has Decimal Places set to 2, a warning is displayed that format restrictions are not enforced, and at runtime you can still assign a value with 3 decimal places.
• If a Text type data field has its Length set to 50, you can still assign a value with more than 50 characters.
You can produce the same effect as limiting the value of the field or parameter by using a BOM data type defined with the restricted values you need. See TIBCO Business Studio Business Object Modeling User’s Guide for more details of BOM data types.
2. On the Properties view, click Data Fields.
Activities that do not support activity-level data fields (such as gateways) do not have a Data Fields tab on their Properties view.A validation error is displayed if you define a data field for an activity on the Data Fields tab, but the destination environment selected for the parent process does not support activity-level data fields for that activity type.
You can only assign a value to an activity-level data field by using the Scripts tab on the activity. See the appropriate implementation guide for more information.
![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |