Previous	Next		Contents	Index	Glossary

procedure AddItemAttr

(itemtype in varchar2,
     itemkey in varchar2,
     aname in varchar2,
     text_value in varchar2 default null,
     number_value in number default null,
      date_value in date default null);

Java Syntax

public static boolean addItemAttr

(WFContext wCtx,
     String itemType,
     String itemKey,
     String aName)

public static boolean addItemAttrText
    (WFContext wCtx,
     String itemType,
     String itemKey,
     String aName,
     String aValue)

public static boolean addItemAttrNumber
    (WFContext wCtx,
     String itemType,
     String itemKey,
     String aName,
     BigDecimal numberVal)

public static boolean addItemAttrDate
    (WFContext wCtx,
     String itemType,
     String itemKey,
     String aName,
     String aValue)

Description

Adds a new item type attribute variable to the process. Although most item type attributes are defined at design time, you can create new attributes at runtime for a specific process. You can optionally set a default text, number, or date value for a new item type attribute when the attribute is created.

If you are using Java, choose the correct method for your attribute type. To add an empty item type attribute, use addItemAttr(). When adding an item type attribute with a default value, use addItemAttrText() for all attribute types except number and date.

Note: If you need to add large numbers of item type attributes at once, use the AddItemAttributeArray APIs rather than the AddItemAttribute APIs for improved performance. See: AddItemAttributeArray

Arguments (input)

The following example shows how API calls can be simplified by using AddItemAttr() to set the default value of a new item type attribute at the time of creation.

Using AddItemAttr() to create the new attribute and SetItemAttrText() to set the value of the attribute, the following calls are required:

AddItemAttr('ITYPE', 'IKEY', 'NEWCHAR_VAR');
SetItemAttrText('ITYPE', 'IKEY', 'NEWCHAR_VAR',
                 'new text values');

Using AddItemAttr() both to create the new attribute and to set its value, only the following call is required:

AddItemAttr('ITYPE', 'IKEY', 'NEWCHAR_VAR',
             'new text values');

Copyright © 2003 Oracle Corporation.
All rights reserved.