複数グループ登録/更新処理

オペレーション名

複数グループ登録/更新

機能概要

入力データをもとにグループを登録/更新します。
また、指定したグループに所属させることができます。

データモデル

本コンポーネントのデータモデルはXML型です。

入出力のスキーマについては、「スキーマ」を参照してください。

プロパティ

変数の使用については、「変数」を参照してください。

基本設定

項目名	必須/省略可	変数の使用	説明	備考
名前	必須	使用不可	スクリプトキャンバス上での名前を入力します。
入力データ	必須	使用不可	スクリプトキャンバス上にあるコンポーネントを選択します。

必須設定

項目名	必須/省略可	変数の使用	説明	備考
接続先	必須	使用不可	グローバルリソースを選択します。グローバルリソースの設定方法については、「グローバルリソースのプロパティ」を参照してください。 [追加]: 新規にグローバルリソースを追加します。 [一覧の編集]: 「リソース一覧の編集」画面にて、グローバルリソースの設定を編集することができます。
キーの値と一致する行は更新	省略可	使用不可	[検索キー]が選択されている項目の入力データを条件として検索し、一致するアカウントが存在した場合に更新するかを選択します。 [チェックなし]:(デフォルト) 更新せずに入力データをMapperに渡します。 [チェックあり]: [更新対象]が選択されている項目の入力データで更新します。
検索キー/更新対象	必須	-	検索キーとする項目および更新対象とする項目を指定します。
検索キー/更新対象/検索キー	省略可	使用不可	検索キーとする項目を選択します。 [チェックあり]: 検索キーとします。 [チェックなし]:(デフォルト) 検索キーとしません。	入力データの該当項目と一致という条件になります。複数行を選択した場合は、AND条件になります。
検索キー/更新対象/更新対象	省略可	使用不可	更新対象とする項目を選択します。 [チェックあり]: 更新対象とします。 [チェックなし]:(デフォルト) 更新対象としません。
検索キー/更新対象/項目名(英字)	必須	使用不可	項目名(英字)が表示されます。
検索キー/更新対象/項目名(日本語)	必須	使用不可	項目名(日本語)が表示されます。

項目名	必須/省略可	変数の使用	説明	備考
コメント	省略可	使用不可	このアダプタの簡単な説明を記述することができます。説明を記述すると、仕様書に反映させることができます。

スキーマ

スキーマ定義

入力スキーマ

<?xml version="1.0" encoding="Shift_JIS"?>
<activedirectory>
<group>
  <cn></cn>
  <sAMAccountName></sAMAccountName>
  <groupType></groupType>
  <groupNameIncludedMember></groupNameIncludedMember>
  <description></description>
  <mail></mail>
  <info></info>
</group>
</activedirectory>

英字名	日本語名	備考
cn	グループ名	グループ名は更新できないため、[更新対象]としては使用できません。設定できる文字列長は最大64文字です。
sAMAccountName	グループ名(Windows2000以前)	設定できる文字列長は最大256文字です。
groupType	グループタイプ	設定値については、「グループタイプの設定値」を参照してください。
groupNameIncludedMember	所属グループ名	所属させたいグループ名を指定します。複数のグループを指定する場合は「,」(カンマ)で区切り、「""」(ダブルクォーテーション)で囲って設定します。「,」を区切り文字として使用するため、名称に「,」を含んだグループを指定することはできません。 [検索キー]としては使用できません。
description	説明
mail	電子メール
info	メモ

出力スキーマ

<?xml version="1.0" encoding="Shift_JIS"?>
<activedirectory>
<group>
  <cn></cn>
  <sAMAccountName></sAMAccountName>
  <groupType></groupType>
  <groupNameIncludedMember></groupNameIncludedMember>
  <description></description>
  <mail></mail>
  <info></info>
</group>
</activedirectory>

英字名	日本語名	備考
cn	グループ名
sAMAccountName	グループ名(Windows2000以前)
groupType	グループタイプ	設定値については、「グループタイプの設定値」を参照してください。
groupNameIncludedMember	所属グループ名
description	説明
mail	電子メール
info	メモ

属性が存在しない項目には""(空文字)が設定されます。
出力される情報が複数存在する場合の設定順序は不定です。

Mapperでのスキーマ読み込み

スキーマは自動で読み込まれます。

詳細については、「スキーマ編集」を参照してください。

大容量データ処理

大容量データ処理に対応していません。

トランザクション

トランザクションはサポートしていません。

PSPでの使用について

PSPでは使用できません。

使用できるコンポーネント変数

コンポーネント変数名	説明	備考
register_count	登録したデータの件数が格納されます。	デフォルト値はnullです。
update_count	更新したデータの件数が格納されます。	デフォルト値はnullです。
skip_count	登録/更新しなかったデータの件数が格納されます。	デフォルト値はnullです。
message_category	エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。	デフォルト値はnullです。
message_code	エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。	デフォルト値はnullです。
message_level	エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。	デフォルト値はnullです。
error_type	エラー発生時、発生したエラーの種類が格納されます。	デフォルト値はnullです。エラーの種類は、以下のような形式となります。例:「java.io.FileNotFoundException」 DataSpider Cloudのバージョンにより、格納される内容が変わる可能性があります。
error_message	エラー発生時、発生したエラーのメッセージが格納されます。	デフォルト値はnullです。 DataSpider Cloudのバージョンにより、格納される内容が変わる可能性があります。
error_trace	エラー発生時、発生したエラーのトレース情報が格納されます。	デフォルト値はnullです。 DataSpider Cloudのバージョンや実行するクライアントアプリケーションにより、格納される内容が変わる可能性があります。

設定ごとの処理内容について

キーの値と一致する行は更新	検索キー	更新対象	一致するデータ	処理
更新しない	未選択	未選択/選択	あり/なし	設定されている入力データの全項目を登録します
更新しない	選択	未選択/選択	なし	設定されている入力データの全項目を登録します
更新しない	選択	未選択/選択	あり	登録/更新はせずに入力データをMapperに渡します
更新する	未選択	未選択/選択	あり/なし	設定されている入力データの全項目を登録します
更新する	選択	未選択	なし	設定されている入力データの全項目を登録します
更新する	選択	選択	なし	設定されている入力データの全項目を登録します
更新する	選択	選択	あり	[更新対象]が選択されている項目を更新対象の入力データが""の場合、設定値を削除します
更新する	選択	未選択	あり	[更新対象]が未選択のため、何も更新されません

選択された[検索キー]に該当する入力データが未設定の場合、検索条件になりません。
グループタイプに該当する入力データが未設定の場合、「グローバル・セキュリティ」を登録/更新します。
登録/更新処理は1行ずつ処理を実行し確定します。そのため、処理中にエラーが発生した場合でもそれまでの登録/更新データは反映されます。

仕様制限

登録されたアカウントは「Users」に作成されます。

検索条件に該当するアカウントが複数存在した場合、すべて更新対象となります。

[グループ名(Windows2000以前)]は、Active Directory内で一意となる属性のため、検索条件に指定するとアカウントを特定することができます。

グループタイプの以下の更新は、Active Directoryの仕様によりできません。
- 「ドメインローカル」から「グローバル」に更新
- 「グローバル」から「ドメインローカル」に更新
グローバルリソースで[子ドメインも操作対象とする]にチェックを入れてグループの追加を行う場合、設定した[グループ名]または[グループ名(Windows2000以前)]と一致するアカウントが子ドメインに登録されている場合「jp.synctrust.util.account.context.ContextException」エラーが発生します。
この場合は、[子ドメインも操作対象とする]のチェックを外してください。

主な例外

例外名	原因	対策
InputDataNotFoundException	[入力データ]が指定されていません。	[入力データ]を指定する、またはデータフローを引いてください。
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[]	[接続先]が指定されていません。	[接続先]を指定してください。
ResourceNotFoundException リソース定義が見つかりませんでした。名前:[<グローバルリソース名>]	[接続先]で選択されたリソース定義が見つかりません。	[接続先]で指定したグローバルリソースを確認してください。
InvalidPropertyConfigurationException リソースの必須項目が指定されていません。	[接続先]に選択されたリソースの必須項目が指定されていません。	リソースの必須項目を指定してください。
InvalidPropertyConfigurationException 必須項目が指定されていません。	必須項目が指定されていません。	必須項目を指定してください。
InvalidPropertyConfigurationException 最大長を超えています。	入力した項目の文字列長が最大値を超えています。	設定できる文字列長以内の値を入力してください。
InvalidPropertyConfigurationException 設定値が不正です。グループタイプ	[グループタイプ]の値が不正です。	[グループタイプ]に正しい値を入力してください。
InvalidPropertyConfigurationException 設定値が不正です。グループ名(Windows2000以前)	[グループ名(Windows2000以前)]に以下の入力できない文字が入力されています。「. , / \ [ ] : ; \| = + * ? < > "」	[グループ名(Windows2000以前)]に正しい値を入力してください。
InvalidPropertyConfigurationException グループ名は更新できません。	[検索キー]に一致するアカウントがすでに登録されており、かつ[グループ名]が[更新対象]に指定されています。	設定内容を確認してください。
jp.synctrust.util.account.context.ContextException 一致するアカウントがすでに存在するため、登録できません。	[グループ名]または[グループ名(Windows2000以前)]と一致するアカウントがすでに登録されています。	設定内容を確認してください。
jp.synctrust.util.account.context.ContextException エントリの修正に失敗しました。	[グループタイプ]を以下の内容で修正した場合に発生します。「ドメインローカル」から「グローバル」に修正「グローバル」から「ドメインローカル」に修正	原因の内容の修正はできないため、以下のいずれかの対策をしてください。入力データを修正する。 [検索キー/更新対象]のグループタイプの[更新対象]を未選択にする。
java.rmi.UnmarshalException	キーストアに証明書がインポートされていません。	キーストアに証明書をインポートする必要があります。キーストアへのインポート方法については、別途お問い合わせください。