複数ユーザ登録/更新処理

オペレーション名

複数ユーザ登録/更新

機能概要

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

データモデル

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

プロパティ

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

スキーマ

入力スキーマ

<?xml version="1.0" encoding="Shift_JIS"?>
<activedirectory>
<user>
  <cn></cn>
  <sn></sn>
  <givenName></givenName>
  <displayName></displayName>
  <userPrincipalName></userPrincipalName>
  <sAMAccountName></sAMAccountName>
  <unicodePwd></unicodePwd>
  <groupNameIncludedMember></groupNameIncludedMember>
  <userAccountControl>
      <passwdNotreqd></passwdNotreqd>
      <dontExpirePassword></dontExpirePassword>
      <encryptedTextPwdAllowed></encryptedTextPwdAllowed>
      <accountDisable></accountDisable>
  </userAccountControl>
  <accountExpires></accountExpires>
  <description></description>
  <physicalDeliveryOfficeName></physicalDeliveryOfficeName>
  <telephoneNumber></telephoneNumber>
  <mail></mail>
  <wWWHomePage></wWWHomePage>
  <c></c>
  <postalCode></postalCode>
  <st></st>
  <l></l>
  <postOfficeBox></postOfficeBox>
  <streetAddress></streetAddress>
  <profilePath></profilePath>
  <scriptPath></scriptPath>
  <homeDirectory></homeDirectory>
  <homePhone></homePhone>
  <pager></pager>
  <mobile></mobile>
  <facsimileTelephoneNumber></facsimileTelephoneNumber>
  <ipPhone></ipPhone>
  <info></info>
  <company></company>
  <department></department>
  <title></title>
</user>
</activedirectory>
英字名 日本語名 備考
cn エントリ名
  • エントリ名は更新できないため、[更新対象]としては使用できません。
  • 設定できる文字列長は最大64文字です。
sn
  • 設定できる文字列長は登録時は最大29文字、更新時は最大64文字です。
givenName
  • 設定できる文字列長は登録時は最大28文字、更新時は最大64文字です。
displayName 表示名
  • 設定できる文字列長は登録時は最大64文字、更新時は最大256文字です。
userPrincipalName ユーザログオン名
  • すでに存在するユーザログオン名での登録および更新はできません。
  • 設定できる文字列長は登録時は最大256文字、更新時は最大1015文字です。
sAMAccountName ユーザログオン名(Windows2000以前)
  • すでに存在するユーザログオン名(Windows2000以前)での登録および更新はできません。
  • 設定できる文字列長は最大20文字です。
unicodePwd パスワード
  • 登録時はパスワードを省略できますが、更新時は省略できません。
  • 設定できる文字列長は最大127文字です。
  • 設定する値は、Active Directoryで設定されているパスワードポリシーの要件を満たす必要があります。
groupNameIncludedMember 所属グループ名
  • 所属させたいグループ名を指定します。
  • 複数のグループを指定する場合は「,」(カンマ)で区切り、「""」(ダブルクォーテーション)で囲って設定します。
  • 「,」を区切り文字として使用するため、名称に「,」を含んだグループを指定することはできません。
  • [検索キー]としては使用できません。
userAccountControl アカウントオプション
  • 親要素のため[検索キー][更新対象]ともに使用できません。
passwdNotreqd ユーザは次回ログオン時にパスワード変更が必要
  • 「true」または「false」(大文字/小文字問わず)を設定します。
dontExpirePassword パスワードを無期限にする
  • 「true」または「false」(大文字/小文字問わず)を設定します。
encryptedTextPwdAllowed 暗号化を元に戻せる状態でパスワードを保存
  • 「true」または「false」(大文字/小文字問わず)を設定します。
accountDisable アカウントは無効
  • 「true」または「false」(大文字/小文字問わず)を設定します。
accountExpires アカウント有効期限
  • 書式は「yyyy/MM/dd」形式で設定します。
  • [検索キー]として使用できません。
description 説明  
physicalDeliveryOfficeName 事業所  
telephoneNumber 電話番号
  • 設定できる文字列長は最大64文字です。
mail 電子メール  
wWWHomePage Web ページ  
c
  • 設定値については、「国の設定値」を参照してください。
postalCode 郵便番号
  • 設定できる文字列長は最大40文字です。
st 都道府県  
l 市区町村  
postOfficeBox 私書箱
  • 設定できる文字列長は最大40文字です。
streetAddress 番地  
profilePath プロファイルパス  
scriptPath ログオンスクリプト  
homeDirectory ローカルパス
  • "<ドライブ文字>:\<ディレクトリ>"の形式で有効なパスを入力してください。
homePhone 自宅電話番号
  • 設定できる文字列長は最大64文字です。
pager ポケットベル
  • 設定できる文字列長は最大64文字です。
mobile 携帯電話
  • 設定できる文字列長は最大64文字です。
facsimileTelephoneNumber FAX
  • 設定できる文字列長は最大64文字です。
ipPhone IP 電話
  • 設定できる文字列長は最大64文字です。
info メモ  
company 会社名
  • 設定できる文字列長は最大64文字です。
department 部署
  • 設定できる文字列長は最大64文字です。
title 役職
  • 設定できる文字列長は最大64文字です。

出力スキーマ

<?xml version="1.0" encoding="Shift_JIS"?>
<activedirectory>
<user>
  <cn></cn>
  <sn></sn>
  <givenName></givenName>
  <displayName></displayName>
  <userPrincipalName></userPrincipalName>
  <sAMAccountName></sAMAccountName>
  <unicodePwd></unicodePwd>
  <groupNameIncludedMember></groupNameIncludedMember>
  <userAccountControl>
      <passwdNotreqd></passwdNotreqd>
      <dontExpirePassword></dontExpirePassword>
      <encryptedTextPwdAllowed></encryptedTextPwdAllowed>
      <accountDisable></accountDisable>
  </userAccountControl>
  <accountExpires></accountExpires>
  <description></description>
  <physicalDeliveryOfficeName></physicalDeliveryOfficeName>
  <telephoneNumber></telephoneNumber>
  <mail></mail>
  <wWWHomePage></wWWHomePage>
  <c></c>
  <postalCode></postalCode>
  <st></st>
  <l></l>
  <postOfficeBox></postOfficeBox>
  <streetAddress></streetAddress>
  <profilePath></profilePath>
  <scriptPath></scriptPath>
  <homeDirectory></homeDirectory>
  <homePhone></homePhone>
  <pager></pager>
  <mobile></mobile>
  <facsimileTelephoneNumber></facsimileTelephoneNumber>
  <ipPhone></ipPhone>
  <info></info>
  <company></company>
  <department></department>
  <title></title>
</user>
</activedirectory>
英字名 日本語名 備考
cn エントリ名  
sn  
givenName  
displayName 表示名  
userPrincipalName ユーザログオン名  
sAMAccountName ユーザログオン名(Windows2000以前)  
unicodePwd パスワード
  • Active Directoryの仕様により、パスワード情報は取得できないため設定されません。
groupNameIncludedMember 所属グループ名  
userAccountControl アカウントオプション
  • 親要素のため設定されません。
passwdNotreqd ユーザは次回ログオン時にパスワード変更が必要
  • 「true」または「false」(小文字)を設定します。
dontExpirePassword パスワードを無期限にする
  • 「true」または「false」(小文字)を設定します。
encryptedTextPwdAllowed 暗号化を元に戻せる状態でパスワードを保存
  • 「true」または「false」(小文字)を設定します。
accountDisable アカウントは無効
  • 「true」または「false」(小文字)を設定します。
accountExpires アカウント有効期限  
description 説明  
physicalDeliveryOfficeName 事業所  
telephoneNumber 電話番号  
mail 電子メール  
wWWHomePage Web ページ  
c
  • 設定値については、「国の設定値」を参照してください。
postalCode 郵便番号  
st 都道府県  
l 市区町村  
postOfficeBox 私書箱  
streetAddress 番地  
profilePath プロファイルパス  
scriptPath ログオンスクリプト  
homeDirectory ローカルパス  
homePhone 自宅電話番号  
pager ポケットベル  
mobile 携帯電話  
facsimileTelephoneNumber FAX  
ipPhone IP 電話  
info メモ  
company 会社名  
department 部署  
title 役職  

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に渡します
更新する 未選択 未選択/選択 あり/なし 設定されている入力データの全項目を登録します
更新する 選択 未選択 なし 設定されている入力データの全項目を登録します
更新する 選択 選択 なし 設定されている入力データの全項目を登録します
更新する 選択 選択 あり [更新対象]が選択されている項目を更新
対象の入力データが""の場合、設定値を削除します
更新する 選択 未選択 あり [更新対象]が未選択のため、何も更新されません

仕様制限

主な例外

例外名 原因 対策
InputDataNotFoundException [入力データ]が指定されていません。 [入力データ]を指定する、またはデータフローを引いてください。
ResourceNotFoundException
リソース定義が見つかりませんでした。名前:[]
[接続先]が指定されていません。 [接続先]を指定してください。
ResourceNotFoundException
リソース定義が見つかりませんでした。名前:[<グローバルリソース名>]
[接続先]で選択されたリソース定義が見つかりません。 [接続先]で指定したグローバルリソースを確認してください。
InvalidPropertyConfigurationException
リソースの必須項目が指定されていません。
[接続先]に選択されたリソースの必須項目が指定されていません。 リソースの必須項目を指定してください。
InvalidPropertyConfigurationException
必須項目が指定されていません。
必須項目が指定されていません。 必須項目を指定してください。
InvalidPropertyConfigurationException
エントリ名・姓・名・表示名の要素に値が設定されていません。
入力データのcn(エントリ名)・sn(姓)・givenName(名)・displayName(表示名)すべての要素に値が設定されていません。 エントリ名・姓・名・表示名のいずれかに値を設定してください。
InvalidPropertyConfigurationException
最大長を超えています。
入力した項目の文字列長が最大値を超えています。 設定できる文字列長以内の値を入力してください。
InvalidPropertyConfigurationException
設定値が不正です。ユーザログオン名(Windows2000以前)
[ユーザログオン名(Windows2000以前)]に以下の入力できない文字が入力されています。
「. , / \ [ ] : ; | = + * ? < > "」
[ユーザログオン名(Windows2000以前)]に正しい値を入力してください。
InvalidPropertyConfigurationException
設定値が不正です。アカウント有効期限
[アカウント有効期限]の値が不正です。 [アカウント有効期限]に「yyyy/MM/dd」形式で正しい値を入力してください。
InvalidPropertyConfigurationException
10桁を設定してください。
[アカウント有効期限]の値が10桁以外で入力されています。 [アカウント有効期限]に「yyyy/MM/dd」形式で正しい値を入力してください。
InvalidPropertyConfigurationException
設定値が不正です。国
[国/地域]の値が不正です。 [国/地域]に正しい値を入力してください。
InvalidPropertyConfigurationException
半角英字で入力してください。
[国/地域]の値が半角英字以外で入力されています。 [国/地域]には半角英字のみ入力してください。
InvalidPropertyConfigurationException
2桁を入力してください。
[国/地域]の値が2桁以外で入力されています。 [国/地域]には半角英字2文字のみ入力してください。
InvalidPropertyConfigurationException
エントリ名は更新できません。
[検索キー]に一致するアカウントがすでに登録されており、かつ[エントリ名][更新対象]に指定されています。 設定内容を確認してください。
jp.synctrust.util.account.context.ContextException
一致するアカウントがすでに存在するため、登録できません。
設定した[エントリ名][ユーザログオン名]または[ユーザログオン名(Windows2000以前)]と一致するアカウントがすでに登録されています。 設定内容を確認してください。
java.rmi.UnmarshalException キーストアに証明書がインポートされていません。 キーストアに証明書をインポートする必要があります。