前へ	次へ		目次	索引	用語集

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構文

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)

説明

プロセスに新規の項目タイプ属性の変数を追加します。ほとんどの項目タイプ属性は設計時に定義されますが、特定のプロセスに対して実行時に新しい属性を作成できます。属性の作成時に、オプションで新しい項目タイプ属性のデフォルトのテキスト値、数値または日付値を設定できます。

Javaを使用している場合は、属性タイプに対して適切なメソッドを選択してください。 空の項目タイプ属性を追加するには、addItemAttr()を使用します。 デフォルト値を持つ項目タイプ属性を追加するには、数値と日付以外のすべての属性タイプにaddItemAttrText()を使用します。

注意: 一度に多数の項目タイプ属性を追加する必要がある場合は、パフォーマンスを改善するために、APIはAddItemAttributeではなくAddItemAttributeArrayを使用します。 「AddItemAttributeArray」を参照してください。

引数（入力）

wCtx	ワークフローのコンテキスト情報。Javaメソッドの場合にのみ必須です。 「Oracle Workflowのコンテキスト」を参照してください。
itemtype	有効な項目タイプ。
itemkey	アプリケーション・オブジェクトの主キーから生成される文字列。この文字列により、項目タイプの項目が一意に識別されます。項目タイプと項目キーにより、プロセスが識別されます。 「CreateProcess」を参照してください。
aname	項目タイプ属性の内部名。
text_value	項目タイプ属性のデフォルトのテキスト値。PL/SQLプロシージャの場合にのみ必須です。デフォルト値はNULLです。
number_valueまたはnumberVal	項目タイプ属性のデフォルトの数値。 PL/SQLプロシージャとaddItemAttrNumber() Javaメソッドの場合にのみ必須です。デフォルト値はNULLです。
date_value	項目タイプ属性のデフォルトの日付値。PL/SQLプロシージャの場合にのみ必須です。デフォルト値はNULLです。
aValue	項目タイプ属性のデフォルト値。 addItemAttrText() JavaメソッドとaddItemAttrDate() Javaメソッドの場合にのみ必須です。

例

次の例は、AddItemAttr()を使用して新しい項目タイプ属性の作成時にデフォルト値を設定し、APIコールを簡素化する方法を示しています。

AddItemAttr()を使用して新規属性を作成し、SetItemAttrText()を使用して属性の値を設定するには、次のコールが必須です。

AddItemAttr('ITYPE', 'IKEY', 'NEWCHAR_VAR');

SetItemAttrText('ITYPE', 'IKEY', 'NEWCHAR_VAR', 

                'new text values');

新規属性の作成と属性値の設定の両方にAddItemAttr()を使用する場合は、次のコールのみですみます。

AddItemAttr('ITYPE', 'IKEY', 'NEWCHAR_VAR', 

            'new text values');