createUser

カテゴリ	メタデータの変更
説明	1 人または複数のユーザーを作成します。成功した場合、API は作成されたユーザーにメッセージを返します。1 回のリクエストで作成できるユーザーが 1000 人を超えることはありません。
起動に必要な権限	ユーザー権限
リクエストに応じてパラメータが必要	認証情報

このメソッドのリクエストには、呼び出し元のユーザーを識別し、認証するための認証情報タグが含まれています。ユーザーを作成するには、"ユーザー権限" 権限が必要です。

この方法は、Workday からのユーザー同期の後には機能しません。

リクエストのフォーマット


<?xml version='1.0' encoding='UTF-8'?>
<call method="createUser" callerName="a string that identifies your client application">
      <credentials login="sampleuser@company.com" password="my_pwd" />
        <users>
            <user
              email="newUser@company.com"
              name="new guy"
              password="new Password"
              alternateEmail="abc@greenco.com"
              samlFedId= "1234"
              permissionSetId="1"
              ownedLevels="2,3,7,11"
              timeZone="America/Mexico_City"
            />
       </users>
</call>

認証情報要素
タグ名		認証情報
説明		すべての API 呼び出しには、API を呼び出したユーザーを識別するための単一の認証情報要素が含まれている必要があります。その後、この API 呼び出しはこのユーザーとして実行されます (システムの監査証跡やアクション履歴は、このユーザーがアクションを実行したことを示します)。そのため、API 呼び出しが成功:
要素の特性
特性名	必須？	値	例
ログイン	あり	API メソッドを呼び出すユーザーのログイン名。このユーザーは、メソッドを呼び出すために必要な権限を持っている必要があります	sampleuser@company.com
password	あり	API メソッドを呼び出すユーザーのパスワード。	my_password
ロケール	なし	入力される数値と日付の解釈、および出力する数値と日付の形式設定 (適切な千単位の区切り文字、月名、日付の形式設定を使用) に使用されるロケールを指定します。ロケールは、応答内のシステムメッセージを表示する言語を指定するためにも使用されます。指定しない場合は、en_US (米国英語) が使用されます。	fr_FR
instanceCode	なし	認証情報で指定されたユーザーがの複数のインスタンスにアクセスできる場合、 Adaptive Planning 、この属性は、ユーザーがデフォルトのインスタンス以外のインスタンスにアクセスしようとしていることを指定するのに使用できます。指定しない場合、ユーザーのデフォルトのインスタンスが使用されます。使用可能なインスタンスコードを決定するには、exportInstances API を使用します。	MYINSTANCE1
エレメントの内容
(なし)

ユーザー要素
タグ名		ユーザー
説明		1 つ以上のユーザー要素が含まれます。
要素の特性
特性名	必須？	値	例
エレメントの内容
1 つ以上のユーザー要素が含まれます。1 回のリクエストで作成できるユーザーが 1000 人を超えることはありません。

ユーザー要素
タグ名		ユーザー
説明		作成するユーザーを指定します。
要素の特性
特性名	必須？	値	例
E メール	あり	このユーザーの E メールアドレス。一意性が必要です。使用できる文字は、a、z、0 ～ 9、-、およびのみです。	newUser@company.com
名前	あり	このユーザーの名前。	メルビンムルメール
ポジション API v39 以上で使用可能	なし	ユーザーのポジション	"CEO"
password	あり	このユーザーのパスワード。この属性は必須です。ただし、ユーザー同期が有効で、Adaptive Planning にログインするために Workday SAML SSO を使用している Workday 接続インスタンスの場合を除きます。	newpassword
alternateEmail API v27 で使用可能	なし	このユーザーの代替 E メールアドレス。このオプションは自動的にオンになり、"ユーザー詳細" セクションにユーザーの E メール ID が入力されます。	abc@greenco.com
samlFedId API v27 で使用可能	なし	このユーザーの SAML フェデレーション ID。	1234, user@company.com
permissionSetId API v25 以上で使用可能	なし	このユーザーに割り当てられた権限セットの内部システム ID。	3
roleId API v25 以前で使用可能 API v25+ では使用できません。	なし	このユーザーに割り当てられたロールの内部システム ID。デフォルト値はありません。(roleId 特性は exportRoles API でカバーされます。)	3
ownedLevels	なし	カンマで区切られた組織の内部システム ID。デフォルト値はありません。(ownLevels 特性は exportLevels API でカバーされます。)	5,10,13
ホームページ API v39 以上で使用可能	なし	ユーザーのホームページ。	"Welcome"
timeZone	なし	ユーザーのタイムゾーン。指定されていない場合は、デフォルトで "US/Pacific" が使用されます。	米国/太平洋地域
国 API v39 以上で使用可能	なし	ユーザーの国コード (英 2 文字コード)。	"US"
usState API v39 以上で使用可能	なし	ユーザーの状態コード (国は米国である必要があります)。	"CA"
netsuiteLogin API v39 以上で使用可能	なし	NetSuite ログイン	"abc@netsuite.com"
salesforceLogin API v39 以上で使用可能	なし	Salesforce ログイン	"abc@salesforce.com"
エレメントの内容
(なし)

回答フォーマット


  <?xml version='1.0' encoding='UTF-8'?>
  <response success="true">
     <output>
         <result>
               <created_users>
                   <user success="true" message="user newUser@company.com was created successfully." guid="0CCF69803A990160E063820012ACFDD7"/>
               </created_users>
         </result>
     </output>
</response>

回答エレメント
タグ名		response
要素の特性
特性名	必須？	値	例
成功	あり	真偽のいずれか。API 呼び出しが成功したかどうかを示します。呼び出しが成功した場合でも、応答に警告メッセージが含まれる場合があります。	真
エレメントの内容
createUser または updateUser の呼び出しがそれぞれ行われたかどうかに応じて、 created_user または updateUser のステータス要素を含む単一の結果要素

結果要素
タグ名		result
説明		1 つ以上のステータス要素のコンテナです。
要素の特性
特性名	必須？	値	例
(なし)
エレメントの内容
1 つ以上の created_user または updateUser の呼び出しがそれぞれ行われたかどうかに応じて、1 つ以上の created_user または update_user ステータス要素を入力します。

created_users element
タグ名		created_users
説明		システムから呼び出し元に送り返されるメッセージを表します。
要素の特性
特性名	必須？	値	例
ユーザー成功	あり	呼び出しによって返されたステータス真でも偽でも構いません。	真
message	あり	ステータスメッセージ。	ユーザーnewuser@company.com が正常に作成されました。
ガイド	あり	作成したユーザーの GUID	"0CCF69803A990160E063820012ACFDD7"
エレメントの内容
1 つのサブスクリプションエレメント