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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
説明 | なし | 科目のテキストによる説明。 | 合計 流動資産 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 |
エレメントの内容
| |||
なし。 | |||