createAccount
カテゴリ
| メタデータの変更 |
説明
| システムに科目を作成します。この API は、検証または作成に失敗するとエラー メッセージを返し、成功した場合は作成された科目のメタデータを返します。この API は、次の科目タイプのみをサポートします。前提条件、総勘定元帳科目、カスタム科目。システム科目またはリンク元科目はサポートされていません。 |
起動に必要な権限
| GL とカスタム科目のモデル前提条件の前提条件。 |
リクエストに応じてパラメータが必要
| 認証情報 |
このメソッドのリクエストには、呼び出し元のユーザーを識別し、認証するための認証情報タグが含まれています。科目作成を実行するには、ユーザーがモデルまたは前提条件の権限を持っている必要があります。XML リクエストは各フィールドおよび特定のビジネス ロジックに対して検証されます。作成に失敗すると、応答にエラー メッセージが返されます。リスクの操作 (他の科目やデータに予期しない影響を与える可能性のある操作) が検出された場合、操作は停止し、警告メッセージが表示される場合があります。この場合、アカウントの作成を完了するには、"ignoreWarnings" 属性を 1 に設定してリクエストを再送信する必要があります。
リクエストのフォーマット
リクエスト スキーマは、Relax NG コンパクト形式で提供されます。
default namespace = "" start = element account { attribute parentId { xsd:integer }, #id of the parent account the new account should roll up to attribute name { xsd:string { maxLength="2048" minLength="1"} }, #Non-empty string with a maximum length of 2048 characters. attribute isGroup { string "0" | string "1" }, #0=No, 1=Yes attribute code { xsd:string { maxLength="2048"} }, #String with a maximum length of 2048 characters. attribute description { xsd:string { maxLength="2048"} }?, #Potentially empty string with a maximum length of 2048 characters. attribute shortName { xsd:string { maxLength="64"} }?, #Potentially empty string with a maximum length of 64 characters. attribute exchangeRateType { xsd:string }?, #displayAs must be CURRENCY (only if multicurrency is enabled) attribute hasSalaryDetail { string "0" | string "1" }?, #0=No, 1=Yes attribute dataPrivacy { string "PRIVATE" | string "PUBLIC_TOP" | string "PUBLIC_ALL" }?, attribute isBreakbackEligible { string "0" | string "1" }?, #0=No, 1=Yes attribute proceedWithWarnings { string "0" | string "1" }?, #0=No, 1=Yes element attributes{ element attribute{ attribute attributeId{ xsd:integer }, attribute valueId{ xsd:integer } }* }? }
例
<?xml version='1.0' encoding='UTF-8'?> <call method="createAccount" callerName="a string that identifies your client application"> <credentials login="sampleuser@company.com" password="my_pwd"/> <account parentId="441" isGroup="0" name="Account Name" code="Account_Code" description="Account Description" shortName="Short Name" exchangeRateType="A" hasSalaryDetail="1" dataPrivacy="PRIVATE" > <attributes> <attribute attributeId="20" valueId="170" /> </attributes> </account> </call>
認証情報要素
| |||
タグ名
| 認証情報 | ||
説明
| すべての API 呼び出しに単一の値を含める必要があります credentials 要素を使用して、API を呼び出したユーザーを識別する。その後、この API 呼び出しはこのユーザーとして実行されます (システムの監査証跡やアクション履歴は、このユーザーがアクションを実行したことを示します)。そのため、API 呼び出しが成功: | ||
要素の特性
| |||
特性名
| 必須?
| 値
| 例
|
ログイン | あり | API メソッドを呼び出すユーザーのログイン名。このユーザーは、メソッドを呼び出すために必要な権限を持っている必要があります。 | sampleuser@company.com |
password | あり | API メソッドを呼び出すユーザーのパスワード。 | my_password |
ロケール | なし | 入力される数値と日付の解釈、および出力する数値と日付の形式設定 (適切な千単位の区切り文字、月名、日付の形式設定を使用) に使用されるロケールを指定します。ロケールは、応答内のシステム メッセージを表示する言語を指定するためにも使用されます。指定しない場合は、en_US (米国英語) が使用されます。 | fr_FR |
instanceCode | なし | 認証情報で指定されたユーザーが の複数のインスタンスにアクセスできる場合、 Adaptive Planning 、この属性は、ユーザーがデフォルトのインスタンス以外のインスタンスにアクセスしようとしていることを指定するのに使用できます。指定しない場合、ユーザーのデフォルトのインスタンスが使用されます。使用可能なインスタンス コードを決定するには、exportInstances API を使用します。 | MYINSTANCE1 |
エレメントの内容
| |||
(なし) | |||
科目要素
| |||
タグ名
| account | ||
説明
| 作成する科目を指定します。 | ||
要素の特性
| |||
特性名
| 必須?
| 値
| 例
|
parentId | あり | 科目のロールアップ先科目の内部システム ID 番号。 | 16 |
名前 | あり | レポートおよびシートに表示される科目の名前。 | 流動資産 |
isGroup | あり | 科目グループを作成するかどうか。いいえの場合は 0、はいの場合は 1。 | 1 |
code | なし | 科目のコード。英数字と下線のみです。科目グループを作成する場合は、空にするか指定しない必要があります。 | Cur_Assets |
説明 | なし | 科目のテキストによる説明。デフォルトは空の文字列です。 | 合計流動資産 |
shortName | なし | 科目の短い名前。デフォルトは空の文字列です。 | CA |
exchangeRateType | なし | 多通貨が有効になっているインスタンス、および displayAs="CURRENCY" を指定している科目にのみ存在します。可能な値: "通貨の管理" で設定された、インスタンスに表示されている任意の為替レート タイプ コード。"A" = 月平均、"E" = "月末"親から継承 (設定されていない場合)多通貨が無効であるか、親に為替レート タイプがない場合、ストック科目のデフォルト値は E、それ以外の場合はすべて A になります。 | E |
hasSalaryDetail | なし | 科目の分割を表示するには、給与詳細の権限が必要です。いいえ: 0、はい: 1。設定されていない場合、または親に hasSalaryDetail がない場合、親から継承します。デフォルト値は 0 です。 | 1 |
dataPrivacy | なし | 科目の値を非公開 (PRIVATE)、最上位組織でのみ公開 (Public_Top)、またはすべての組織で公開 (Public_ALL) を選択します。デフォルトは "非公開" です。 | 非公開 |
isBreakbackEligible | なし | 按分で加重値の選択として使用できます。いいえ: 0、はい: 1。前提条件にのみ適用されます。デフォルト値は 0 です。 | 0 |
proceedWithWarnings | なし | ユーザーが警告メッセージを無視して作成操作を続行するかどうかを示します。いいえ: 0、はい: 1。警告が表示され、proceedWithWarnings=0 の場合、科目は作成されません。警告がある場合にアカウントを作成するには、proceedWithWarnings=1 を設定します。 | 1 |
エレメントの内容
| |||
科目に関連付けられた 1 つ以上の科目特性を追加する場合の 1 つのオプション特性要素。 | |||
特性要素
| |||
タグ名
| 特性 | ||
説明
| 1 つ以上の科目特性要素のコンテナです。 | ||
要素の特性
| |||
特性名
| 必須?
| 値
| 例
|
(なし) | |||
エレメントの内容
| |||
1 つ以上 特性要素 | |||
特性要素
| |||
タグ名
| 特性 | ||
説明
| 1 つの科目特性要素を示します。 | ||
要素の特性
| |||
特性名
| 必須?
| 値
| 例
|
attributeID | あり | システムによって生成された科目特性の ID。 | 20 |
valueID | あり | システムによって生成された科目特性値の一意の ID。この値が 0 の場合、この特性は科目から削除されます。 | 170 |
エレメントの内容
| |||
なし | |||
回答フォーマット
これらは、科目の作成が成功した場合および失敗した場合の応答の例です。
成功例
<?xml version='1.0' encoding='UTF-8'?> <response success="true"> <messages> <message type="WARNING" key="warning-unpublished-changes" values="" parentId="1">You have unpublished changes. Your changes will not be visible every where until it is published.</message> </messages> <output> <accounts> <account id="1" code="AssetsChild" name="AssetsChild" timeStratum="month" description="Total Assets Child" displayAs="CURRENCY" accountTypeCode="A" decimalPrecision="0" isAssumption="0" suppressZeroes="1" isDefaultRoot="1" shortName="" exchangeRateType="E" balanceType="DEBIT" formula="" isLinked="0" owningSheetId="" isSystem="0" isIntercompany="0" dataEntryType="" planBy="DELTA" timeRollup="LAST" timeWeightAcctId="" levelDimRollup="SUM" levelDimWeightAcctId="" rollupText="" startExpanded="1" hasSalaryDetail="" dataPrivacy="PRIVATE" isBreakbackEligible="" subType="CUMULATIVE" enableActuals="1" isGroup="0" /> </accounts> </output> </response>
エラーの例
<?xml version='1.0' encoding='UTF-8'?> <response success="false"> <messages> <message type="ERROR" key="invalid-attributevalueid" values="-50" parentId="-50">Invalid account id: "-50"</message> </messages> </response>
回答エレメント
| |||
タグ名
| response | ||
要素の特性
| |||
特性名
| 必須?
| 値
| 例
|
成功 | あり | 両方 真または false。API 呼び出しが成功したかどうかを示します。呼び出しが成功した場合でも、応答に警告メッセージが含まれる場合があります。 | true |
エレメントの内容
| |||
単一 (任意) "メッセージ" 要素および/または単一のオプション 出力要素 | |||
出力要素
| |||
タグ名
| 出力 | ||
要素の特性
| |||
(なし) | |||
エレメントの内容
| |||
単一の科目要素これ 出力ラップはすべての API 応答の標準であり、成功した API 呼び出しの有効な出力を囲みます。 | |||
メッセージ要素
| |||
タグ名
| メッセージ | ||
説明
| 1 つ以上のコンテナ メッセージ要素 | ||
要素の特性
| |||
(なし) | |||
エレメントの内容
| |||
1 つ以上 メッセージ要素 | |||
メッセージ要素
| |||
タグ名
| message | ||
説明
| システムから呼び出し元に送り返されるメッセージを表します。メッセージは、リクエストが成功しない場合のエラー メッセージ、リクエストが成功した場合の警告メッセージ、成功した場合の確認メッセージに使用されます。 | ||
要素の特性
| |||
特性名
| 必須?
| 値
| 例
|
type | あり | タイプはメッセージのタイプを識別する方法です。異なるタイプは、INFO、 WARNING、ERROR です。エラー タイプは、このリクエストが処理されなかったことを示します。 | 警告 |
キー | あり | キーは特定のメッセージやメッセージのタイプを識別するための手段で、クライアント プログラムにおけるエラーの記録と復旧に役立ちます。メッセージの言語が変わってもキーはリクエストのロケールの中で変更されません。また、単語の調整や用語の変更によってキーが将来変更される可能性も低いです。 | error-invalid-timespan-start |
値 | なし | 値が指定されると、メッセージ テキストで使用されている変数を表します。 | 199,12 |
parentId | なし | 使用可能な場合は、リクエストで提供された新しい科目の親の ID。 | 50 |
エレメントの内容
| |||
メッセージのテキスト。このテキストは、リクエストで指定されたロケールの言語になります (そのロケールがサポートされている場合)。テキストには、処理された行数や、エラーの原因となった特定の列や値などの可変情報を含めることもできます。 | |||
科目要素
| |||
タグ名
| 科目 | ||
説明
| 1 つ以上のコンテナ 科目要素 | ||
要素の特性
| |||
(なし) | |||
エレメントの内容
| |||
1 つ以上 科目要素 | |||
科目要素
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
タグ名
| account | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
説明
| 単一の科目に対する応答として返される科目を表します。 exportAccounts API コールこの要素が直接枠内にある場合は、 回答の科目要素 (つまり、別の値に囲まれていない) 科目要素) の場合、この科目要素はルート科目、親を持たない科目を表します。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
要素の特性
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
特性名
| 必須?
| 値
| 例
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
名前 | あり | レポートおよびシートに表示される科目の名前。 | 流動資産 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
code | あり | 科目のコード。数式で参照された場合に表示されます。 | Cur_Assets | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ID | なし | 科目の内部システム ID 番号。これは、次のような他の API 呼び出しで科目を識別するために使用できます。 exportDimensionFamilies | 16 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
accountTypeCode | なし | この科目のデータ タイプに対応する文字コード。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
説明 | なし | 科目管理で入力された科目のテキスト説明 (存在する場合) | 合計流動資産 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
shortName | なし | 科目管理で入力された科目の短縮名 (存在する場合) | CA | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
timeStratum API v16 以上でサポート | なし | 科目の時間層 (時間層のコードとして)。キューブ科目、モデル科目、キューブ入力 GL 科目の場合、時間層はそれらを所有するシートの時間層によって決まります。他のすべての科目は、時間管理 UI 内で設定されたデフォルトの時間層を使用します。 | Month | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
displayAs | なし | 科目の出力表示設定: NUMBER、通貨、パーセント"科目の管理" で "表示形式" プロパティがある科目に対してのみ提供されます。 | NUMBER | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IS前提条件 | なし | "0" または "1" のいずれかで、科目が前提条件であるかどうかを示します。これは前提条件および為替レート科目では 1 に設定されます。 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
suppressZeroes | なし | この科目でユーザーがシート上のゼロを非表示にできるかどうかを示すフラグです。0 は許可されず、1 は許可されます。"科目の管理" で "ゼロを表示しない" プロパティがある科目に対してのみ提供されます。 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
isDefaultRoot | なし | "0" または "1"。科目または科目グループがデフォルト ルートであるかどうかを示します。 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
decimalPrecision | なし | この科目の数値を表示する小数点以下の桁数。デフォルトは 0 です。特殊値 99 は、ターゲットの小数点以下の桁数を継承するリンク元科目を示すために使用されます。値が -1 の場合、その科目は通貨科目であり、表示されているいずれかの通貨の小数部桁数が使用されます。 | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
planBy | なし | ストック科目の場合、科目が残高での計画 (BALANCE) か、差額での計画 (DELTA) かを示します。 | 残高 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
exchangeRateType | なし | displayAs="CARERENCY" を持つ科目の場合のみ存在します。可能な値: "通貨の管理" で設定された、インスタンスに表示されている任意の為替レート タイプ コード。"A" = 月平均、"E" = "月末" | E | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
isImportable | なし | 科目がインポートされたデータを受け入れることができるかどうかを示します。0 はその科目がインポート不可であることを意味します。 1 つがインポート可能です。次の場合にのみ表示 versionName または リクエストに versionId が指定されています。 注: "isImportable" は、科目が指定されたバージョンでインポート可能であることのみを示します。API を呼び出しているユーザーに、バージョンまたは科目にインポートする権限があることは示しません。用途 exportVersions: ユーザーがインポートに使用できるバージョンを確認します。 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
balanceType | なし | 科目の残高タイプ (借方または貸方) を示します。科目に関連付けられた残高タイプがない場合、この特性は空になります。GL 科目のみに残高タイプがあります。 | 借方 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
isContra API v34+ で使用可能 | なし | 0 または 1 でこの科目が相対であるかどうかを示します。 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
dataEntryType | なし | 科目のデータ入力タイプを示します。STANDARD または CUBE空白の値は、データ入力タイプが科目に適用されないことを示します。たとえば、リンク元科目またはモデル科目のデータ入力タイプが空白の場合、 | キューブ | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
timeRollUp | なし | 特定の期間にわたってロールアップされた科目の動作を示します。SUM、WEITETED_AVERAGE、LAST、AVERAGE を指定できます。これは、科目グループおよびメトリック科目の場合は空になります。 | SUM | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
timeWeightAcctId | なし | この科目の timeRollup が ”WESIGNED_AVERAGE” である場合、これは科目の内部システム ID 番号になります。この内部システム ID 番号は加重値の決定元となります。これは、加重科目が存在しない場合、または科目の timeRollup が WESIGNED_AVERAGE の場合、空になります。 | 133 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
hasSalaryDetail | なし | 0 または 1 で、この科目に "給与詳細にアクセス" 権限を表示する必要がある分割があるかどうかを示します。この科目に該当しない場合は空になります。 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
dataPrivacy | なし | 科目の値がどの組織において公開され、数式の作成時に他の組織で参照可能であるかを示します。科目の値が非公開になる場合は "PRIVATE" を、最上位組織のみで科目の値が公開される場合は "Public_Top" を、すべての組織で公開されるようにするには "Public_ALL" を指定できます。前提条件は常に公開されるため、dataPrivacy 設定はありません。 | 非公開 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subType | なし | 科目がフローかストックかを示します。科目がフローである場合、特定の月の値はその月の正味アクティビティに等しくなります。例としては、収益科目と経費科目が挙げられます。科目がストックの場合、その値は特定の月の終了残高に等しくなります。これは、前月の値とその月のアクティビティの値の合計です。貸借対照表の科目はストックです。これは、科目グループおよびメトリック科目の場合は空になります。 | フロー | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
startExpanded | なし | これは、シートを最初にロードしたときに科目とその子が展開された状態で開始するかどうかを示します。これは親科目にのみ適用されます。これは最下位科目の場合空になります。 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
isBreakbackEligible | なし | 0 または 1 のいずれかで、この科目を按分で使用できるかどうかを示します。これは標準の前提条件にのみ適用されます。これは他のタイプの科目では空になります。 | 0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
levelDimRollup | なし | 組織または属性に沿ってロールアップされた科目の挙動を示します。SUM、WEITETED_AVERAGE、TEXT、NONBLANK_AVERAGE を指定できます。これは、科目グループおよびメトリック科目の場合は空になります。 | NONBLANK_AVERAGE | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
levelDimWeightAcctId | なし | この科目の levelDimRollup が "WE却下" の場合、これは科目の内部システム ID 番号になります。この内部システム ID 番号は加重値の決定元となります。加重科目が存在しない場合、または科目の levelDimRollup が WESIGNED_AVERAGE でない場合、これは空になります。 | 118 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
rollupText | なし | この科目の levelDimRollup が TEXT の場合、これは科目のロールアップされた値を示すセルに表示されるテキスト文字列です。 | なし | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
enableActuals | なし | 0 を選択すると、その科目の計画データのみが表示されます。1: 科目に実績をインポートします。リンクされた科目の場合、0 を指定するとリンク元科目に実績がある場合にのみ実績が表示され、1 を指定するとリンク元科目の実績が有効になります。これは、科目グループおよびメトリック科目の場合は空になります。 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
isGroup | あり | 0 または 1 で科目グループかどうかを示します。 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
isIntercompany | なし | 0 または 1 で、この科目が内部取引科目であるかどうかを示します。 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
数式 | なし | 科目の数式 (ある場合)。 | ACCT.Revenue - ACCT.Expenses | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
isLinked | なし | 0 または 1 でこの科目がリンク元科目であるかどうかを示します。 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
isSystem | なし | 0 または 1 でシステム科目であるかどうかを示します。 | 1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
owningSheetId | なし | モデル シートおよびキューブ シートにある科目の場合、この科目があるシートの内部システム ID 番号そのような科目ではない場合、またはそのような科目であるがシートに現在割り当てられていない場合は、空になります。 | 17 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
エレメントの内容
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1 つがネストされている この科目の各直接の子科目の account 要素 1 科目に 1 つ以上の特性が関連付けられている場合は、attributes 要素 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
特性要素
| |||
タグ名
| 特性 | ||
説明
| 1 つ以上のコンテナ 特性要素 | ||
要素の特性
| |||
特性名
| 必須?
| 値
| 例
|
(なし) | |||
エレメントの内容
| |||
1 つ以上 特性要素 | |||
特性要素
| |||
タグ名
| 特性 | ||
説明
| 科目が関連付けられている、空白ではない単一の科目特性マッピングを示します。 | ||
要素の特性
| |||
特性名
| 必須?
| 値
| 例
|
名前 | あり | 科目特性の名前。 | SEC レポート |
値 | あり | 科目に関連付けられた科目特性の名前。 | はい |
attributeId | あり | 科目特性の内部システム ID 番号。 | 10 |
valueId | あり | 科目特性値の内部システム ID 番号。 | 108 |
エレメントの内容
| |||
なし。 | |||