「Create Relationship」操作

IBM Content Manager リポジトリ内の 2 つのアイテム間に関係を作成します。関係には、ソースとターゲットがあります。

General プロパティグループと Route Evaluation プロパティグループについて詳しくは、 共通の操作プロパティ を参照してください。

Login Settings プロパティ

Content Repository Connector for IBM Content Manager サービスを呼び出すためのログイン設定を指定するプロパティ。

Login Mode

操作が IBM Content Manager で認証を受ける方法を表す LoginMode com.adobe.livecycle.connectorforibmcm.dsc.client.type.LoginMode )値。有効値は Use Credentials From Process Context および Use User Credentials です。

注意: Use Credentials From Process Context は、IBM Content Manager と AEM forms の両方が同じ LDAP サーバーと同期している場合のみ機能します。

リテラル値を指定する場合は、次のいずれかのオプションを選択します。

Use Credentials From Process Context:
IBM Content Manager 認証のプロセスコンテキストからの AEM forms User Management 秘密鍵証明書を使用します。User Name、Data Store、Password および Connection String プロパティは使用されません。
注意: この操作を使用する Workbench でプロセスを呼び出すには、 [User Name] @ [Data Store] : [Connection String] という形式を使用して「Username」ボックスにログイン名を入力します。この形式の [User Name] はユーザー ID、 [Data Store] は接続先リポジトリの名前、 [Connection String] はリポジトリに接続するために使用するオプションのリストをそれぞれ示します。

Use User Credentials:
User Name および Password プロパティを使用して、IBM Content Manager の認証を受けます。ユーザー名が、この操作の Data Store プロパティで指定されるリポジトリで有効であることを確認してください。

この値を選択した場合は、Data Store、User Name、Password および Connection String プロパティの値を指定します。

Data Store

(オプション)ユーザーが接続するデータストアの名前を指定する string 値。

このフィールドは、Login Mode プロパティが Use User Credentials に設定された場合のみ使用されます。

リテラル値を指定する場合は、データストアの名前を入力します。

User Name

(オプション)この操作が IBM Content Manager で認証されるときに使用するユーザー名を指定する string 値。デフォルト値はありません。

このフィールドは、Login Mode プロパティが Use User Credentials に設定された場合のみ使用されます。

リテラル値を指定する場合は、ユーザー ID を入力します。

パスワード

(オプション)User Name プロパティで指定されたユーザー名と関連付けられているパスワードを指定する string 値。このパスワードは、この操作が IBM Content Manager で認証されるときに使用されます。デフォルト値はありません。

このフィールドは、Login Mode プロパティが Use User Credentials に設定された場合のみ使用されます。

リテラル値を指定する場合は、パスワードを入力します。

Connection String

(オプション)IBM Content Manager に接続するときに使用する追加オプションを指定する string 値。例えば、 SCHEMA= [schemaName] [schemaName] はスキーマ名で、大文字と小文字が区別される)。

リテラル値を指定する場合は、追加の接続オプションを入力します。

Create Relationship Settings プロパティ

作成する関係のパラメーターを指定するプロパティ。

Source PID

ソースアイテムの固有な識別子を表す string 値。Persistent Identifier(PID)は、すべてのアイテムを一意に識別するために IBM Content Manager サーバーで使用される識別子です。

リテラル値を指定する場合は、ソースアイテムの固有な識別子(PID)を表す値を入力します。

Target PID

ターゲットアイテムの固有な識別子を表す string 値。Persistent Identifier(PID)は、すべてのアイテムを一意に識別するために IBM Content Manager サーバーで使用される識別子です。

リテラル値を指定する場合は、ターゲットアイテムの PID を表す値を入力します。

RelationType

作成する関係タイプの名前を指定する string 値。関係タイプは、15 文字以内で指定できます。

リテラル値を指定する場合は、関係タイプを表す値を入力します。

New Relationship

関係タイプが存在しない場合は作成するかどうかを設定する boolean 値。値 True は、関係タイプが存在しない場合は作成することを意味します。デフォルト値である False は、関係タイプを作成しないことを意味します。

リテラル値を指定する場合は、「New Relationship」チェックボックスをオンにして、RelationType プロパティで指定した値が存在しない場合は関係タイプを作成するようにします。「New Relationship」チェックボックスをオフにすると、関係タイプが存在しない場合でも作成しません。

重要: 「New Relationship」をオフにするかまたは値を False に設定して、さらに RelationType プロパティで存在しない値を指定した場合は、例外がスローされます。

Result プロパティ

操作の結果を格納するプロパティ。

Relationship Information

操作の結果を格納する位置。データタイプは RelationInfo です。

Relationship Type

操作を実行して作成された関係タイプを格納する位置。このデータタイプは string です。

RelationshipType Description

関係タイプの説明を格納する位置。データタイプは string です。

Source Document Information

新しく作成した関係のソースアイテムのドキュメント情報を格納する位置。データタイプは DocInfo です。

XPath 式および Set Value サービスを使用して、データアイテムを DocInfo 値で取得します。

Target Document Information

新しく作成した関係のターゲットアイテムのドキュメント情報を格納する位置。データタイプは DocInfo です。

Exceptions

この操作では、 RepositoryException 例外をスローすることがあります。