メインコンテンツにスキップ
Adaptive Planning
最終更新: 2023-06-23
updateAccount

updateAccount

カテゴリ
メタデータの変更
説明
システムの既存の科目を更新する場合。この API は、検証または更新に失敗するとエラー メッセージを返し、成功した場合は更新された科目のメタデータを返します。この API は、次の科目タイプのみをサポートします。前提条件、総勘定元帳科目、カスタム科目。システム科目またはリンク元科目はサポートされていません。
起動に必要な権限
GL とカスタム科目のモデル前提条件の前提条件。
リクエストに応じてパラメータが必要
認証情報
このメソッドのリクエストには、呼び出し元のユーザーを識別し、認証するための認証情報タグが含まれています。科目作成を実行するには、ユーザーがモデルまたは前提条件の権限を持っている必要があります。XML リクエストは各フィールドおよび特定のビジネス ロジックに対して検証されます。作成に失敗すると、応答にエラー メッセージが返されます。リスクのある操作が検出された場合、操作が停止し、警告メッセージが表示される場合があります。科目の更新を完了するには、"ignoreWarnings" 属性を 1 に設定してリクエストを再送信する必要があります。

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

リクエスト スキーマは、Relax NG コンパクト形式で提供されます。
default namespace = "" start = element account { attribute id { xsd:integer }, #account id attribute name { xsd:string { maxLength="2048" minLength="1"} }?, #Non-empty string with a maximum length of 2048 characters. attribute code { xsd:string { maxLength="2048" minLength="1"} }?, #Non-empty 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="updateAccount" callerName="a string that identifies your client application"> <credentials login="sampleuser@company.com" password="my_pwd"/> <account id="48" 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 呼び出しには、API を呼び出したユーザーを識別するための単一の認証情報要素が含まれている必要があります。その後、この API 呼び出しはこのユーザーとして実行されます (システムの監査証跡やアクション履歴は、このユーザーがアクションを実行したことを示します)。そのため、API 呼び出しが成功:
要素の特性
特性名
必須?
ログイン
あり
API メソッドを呼び出すユーザーのログイン名。このユーザーは、メソッドを呼び出すために必要な権限を持っている必要があります。
sampleuser@company.com
password
あり
API メソッドを呼び出すユーザーのパスワード。
my_password
ロケール
なし
入力される数値と日付の解釈、および出力する数値と日付の形式設定 (適切な千単位の区切り文字、月名、日付の形式設定を使用) に使用されるロケールを指定します。ロケールは、応答内のシステム メッセージを表示する言語を指定するためにも使用されます。指定しない場合は、en_US (米国英語) が使用されます。
fr_FR
instanceCode
なし
認証情報で指定されたユーザーが の複数のインスタンスにアクセスできる場合、
Adaptive Planning
、この属性は、ユーザーがデフォルトのインスタンス以外のインスタンスにアクセスしようとしていることを指定するのに使用できます。指定しない場合、ユーザーのデフォルトのインスタンスが使用されます。使用可能なインスタンス コードを決定するには、exportInstances API を使用します。
MYINSTANCE1
エレメントの内容
(なし)
科目要素
タグ名
account
説明
作成する科目を指定します。
要素の特性
特性名
必須?
ID
あり
科目の内部システム ID 番号です。これは、exportDimensionFamilies などの他の API 呼び出しで科目を識別するために使用できます。
16
名前
あり
レポートおよびシートに表示される科目の名前。
流動資産
code
なし
科目のコード。英数字と下線のみです。科目グループのコード特性を指定することはできません。
Cur_Assets
説明
なし
科目のテキストによる説明。
合計流動資産
shortName
なし
科目の短い名前。
CA
exchangeRateType
なし
多通貨が有効になっているインスタンス、および displayAs="CURRENCY" を指定している科目にのみ存在します。可能な値: "通貨の管理" で設定された、インスタンスに表示されている任意の為替レート タイプ コード。"A" = 月平均、"E" = "月末"
E
hasSalaryDetail
なし
科目の分割を表示するには、給与詳細の権限が必要です。いいえ: 0、はい: 1。
1
dataPrivacy
なし
科目の値を非公開 (PRIVATE)、最上位組織でのみ公開 (Public_Top)、またはすべての組織で公開 (Public_ALL) を選択します。デフォルトは "非公開" です。
非公開
isBreakbackEligible
なし
按分で使用できます。いいえ: 0、はい: 1。前提条件にのみ適用されます。
0
proceedWithWarnings
なし
ユーザーが警告メッセージを無視して更新操作を続行するかどうかを示します。いいえ、0 は 1、はいは 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="" accountId="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="Assets" name="Assets" description="Total Assets" timeStratum="month" 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"> <attributes> <attribute name="AP Eligible" attributeId="17" value="Yes" valueId="170" /> </attributes> </account> </accounts> </output> </response>

エラーの例

<?xml version='1.0' encoding='UTF-8'?> <response success="false"> <messages> <message type="ERROR" key="invalid-account-id" values="441" accountId="-50">Invalid account id: "-50"</message> </messages> </response>
回答エレメント
タグ名
response
要素の特性
特性名
必須?
成功
あり
True または False のいずれかで、API 呼び出しが成功したかどうかを示します。呼び出しが成功した場合でも、警告メッセージが応答に含まれる場合があります。
エレメントの内容
単一の任意のメッセージ要素または単一の任意の出力要素。
出力要素
タグ名
出力
要素の特性
(なし)
エレメントの内容
単一の科目要素この出力ラベンダーはすべての API 応答の標準であり、成功した API 呼び出しの有効な出力を囲みます。
メッセージ要素
タグ名
メッセージ
説明
1 つ以上のメッセージ要素のコンテナです。
要素の特性
(なし)
エレメントの内容
1 つ以上のメッセージ要素
メッセージ要素
タグ名
message
説明
システムから呼び出し元に送り返されるメッセージを表します。メッセージは、リクエストが成功しない場合のエラー メッセージ、リクエストが成功した場合の警告メッセージ、成功した場合の確認メッセージに使用されます。
要素の特性
特性名
必須?
type
あり
タイプはメッセージのタイプを識別する方法です。異なるタイプは、INFO、 WARNING、ERROR です。エラー タイプは、このリクエストが処理されなかったことを示します。
警告
キー
あり
キーは特定のメッセージやメッセージのタイプを識別するための手段で、クライアント プログラムにおけるエラー ログ記録と復旧に役立ちます。メッセージの言語が変わってもキーはリクエストのロケールの中で変更されません。また、単語の調整や用語の変更によってキーが将来変更される可能性も低いです。
警告-無効な期間-開始
なし
値が指定されると、メッセージ テキストで使用されている変数を表します。
199,12
parentId
なし
使用可能な場合は、リクエストで提供された新しい科目の親の ID。
50
エレメントの内容
メッセージのテキスト。このテキストは、リクエストで指定されたロケールの言語になります (そのロケールがサポートされていると仮定します)。テキストには、処理された行数や、エラーの原因となった特定の列や値などの可変情報を含めることもできます。
科目要素
タグ名
科目
説明
1 つ以上の科目要素のコンテナです。
要素の特性
(なし)
エレメントの内容
1 つ以上の科目要素
科目要素
タグ名
account
説明
exportAccounts API コールへの応答で返される単一科目を表します。この要素が応答のそれを囲む科目要素内に直接ある場合 (つまり、別の科目要素に囲まれていない場合)、この科目要素はルート科目、つまり親を持たない科目を表します。
要素の特性
特性名
必須?
名前
あり
レポートおよびシートに表示される科目の名前。
現在
資産
code
なし
科目のコード。英数字と下線のみです。科目グループのコード特性を指定することはできません。
Cur_Assets
ID
あり
科目の内部システム ID 番号です。これは、exportDimensionFamilies などの他の API 呼び出しで科目を識別するために使用できます。
16
accountTypeCode
なし
データ タイプの科目に対応する文字コード
タイプ コード
科目タイプ
科目クラス
A
資産
総勘定元帳
B
流動資産
総勘定元帳
C
負債と純資産
総勘定元帳
キューブ
キューブ
キューブ
EN
年初来の利益/損失
総勘定元帳
F
固定資産
総勘定元帳
G
売上原価
総勘定元帳
I
Income
総勘定元帳
J
営業外収益
総勘定元帳
K
為替換算調整勘定
システム
L
負債
総勘定元帳
M
流動負債
総勘定元帳
MI
連結比率
定義済
MT
メトリック
メトリック
なし
純利益
総勘定元帳
O
他の資産
総勘定元帳
Q
純資産
総勘定元帳
R
長期資産
総勘定元帳
S
前提条件
前提条件
T
長期負債
総勘定元帳
W
モデル
モデル
X
経費
総勘定元帳
XR
為替レート
定義済
あり
営業外費用
総勘定元帳
Z
カスタム
カスタム
A
説明
なし
科目のテキストによる説明。
合計
流動資産
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="CURRENCY" を指定している科目にのみ存在します。可能な値: "通貨の管理" で設定された、インスタンスに表示されている任意の為替レート タイプ コード。"A" = 月平均、"E" = "月末"
E
isImportable
なし
科目がインポートされたデータを受け入れることができるかどうかを示します。0 はその科目がインポート不可であることを、1 はインポート可能であることを示します。リクエストで versionName または versionId が指定されている場合にのみ存在します。
注: "isImportable" は、科目が指定されたバージョンでインポート可能であることのみを示します。API を呼び出しているユーザーが、バージョンまたは科目にインポートする権限を持っていることは意味しません。exportVersions を使用して、ユーザーがインポートに使用できるバージョンを確認します。
1
hasSalaryDetail
なし
科目の分割を表示するには、給与詳細の権限が必要です。いいえ: 0、はい: 1。
1
balanceType
なし
科目の残高タイプ (借方または貸方) を示します。科目に関連付けられた残高タイプがない場合、この特性は空になります。GL 科目のみに残高タイプがあります。
借方
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、 W EligTED_AVERAGE、 TEXT、 または NONBlank_AVERAGE を指定できます。これは、科目グループおよびメトリック科目の場合は空になります。
NONBLANK_AVERAGE
levelDimWeightAcctId
なし
この科目の levelDimRollup が "WE却下" の場合、これは科目の内部システム ID 番号になります。この内部システム ID 番号は加重値の決定元となります。加重科目が存在しない場合、または科目の levelDimRollup が WE却下_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 つのネストされた科目要素
科目に関連付けられた 1 つまたは複数の特性がある場合は、1 つの特性要素。
特性要素
タグ名
特性
説明
1 つ以上の特性要素のコンテナです。
要素の特性
特性名
必須?
(なし)
エレメントの内容
1 つ以上の特性要素
特性要素
タグ名
特性
説明
科目が関連付けられている、空白ではない単一の科目特性マッピングを示します。
要素の特性
特性名
必須?
名前
あり
科目特性の名前。
SEC レポート
あり
科目に関連付けられた科目特性の名前。
はい
attributeId
あり
科目特性の内部システム ID 番号。
10
valueId
あり
科目特性値の内部システム ID 番号。
108
エレメントの内容
なし。