データ関数
ONESOURCE DataFlow は、さまざまなレポート作成や分析のために、リクエスト間でデータを共有したりデータを抽出したりする方法を提供します。DataFlow リクエストを操作するには、操作対象の特定のリクエストを指定するために
リクエスト ID
を使用する必要があります。GetList
および GetID
メソッドは、特定のリクエスト ID を検索するために使用されます。これらのメソッドの結果を使用して、データ取得用の他のメソッドを使用できます。note
データ取得メソッドは、どの数式内にもネストしないでください。
GetID
条件に一致するリクエストの単一の ID を取得します。
- エンティティ ID
- エンティティ名
- テンプレート名
- 税タイプ
- 年
- 期間
- ステータス
- コード
- シナリオ
- 管轄区域
すべてのパラメータは任意ですが、1 件のリクエストのみが見つかるように、できるだけ多く指定してください。
note
一致するリクエストが複数見つかった場合、
指定された条件を満たすリクエストが複数あります
というエラーが返されます。条件に一致するリクエストがない場合は、指定された条件を満たすリクエストはありません
と表示されます。抽出 | リクエスト内 |
|---|---|
EXTDCGetID (Entity ID, Entity Name, Template Name, Tax Type, Year, Period, Status, Codes, Scenario, Jurisdiction, Client Name, Client Number) | DCGetID (Entity ID, Entity Name, Template Name, Tax Type, Year, Period, Status, Codes, Scenario, Jurisdiction, Client Name, Client Number |
GetList
条件に一致するリクエストのリストを取得し、そのリストを出力範囲に配置します。
2025 年の Q2 期間内で、税タイプが Annual Report のすべてのリクエストを取得します。
- エンティティ ID
- エンティティ名
- テンプレート名
- 税タイプ: Annual Report
- 年: 2025
- 期間: Q2
- ステータス
- コード
- シナリオ
- 管轄区域
出力範囲は必須です。その他はすべて任意ですが、結果のリストをできるだけ小さく保つために、できるだけ多く指定してください。
抽出 | リクエスト内 |
|---|---|
EXTDCGetList (Output Range, Entity ID, Entity Name, Template Name, Tax Type, Year, Period, Status, Codes, Scenario, Jurisdiction, Client Name, Client Number ) | DCGetList (Output Range, Entity ID, Entity Name, Template Name, Tax Type, Year, Period, Status, Codes, Scenario, Jurisdiction, Client Name, Client Number ) |
GetData
表形式データを除く、リクエストのすべてのデータを取得します。データは、出力範囲に 1 セルにつき 1 つの値として縦方向に配置されます。
抽出 | リクエスト内 |
|---|---|
= EXTDCGetData (Request ID Range, Output Range) | 利用不可 |
GetRange
指定されたリクエスト ID の範囲から値を取得し、出力場所に配置します。
抽出 | リクエスト内 |
|---|---|
=EXTDCGetRange(Request ID Range, Range Name, Output location) | =DCGetRange(Request ID Range, Range Name, Output location) |
GetValues
送信されたリクエスト ID 内で、指定された名前に関連付けられている値を取得します。水平出力を
True
に設定すると、取得される値が強制的に転置されます。抽出 | リクエスト内 |
|---|---|
=EXTDCGetValues(Request ID Range, Range Names, Output location, Horizontal Output) | =DCGetValues(Request ID Range, Range Names, Output location, Horizontal Output) |
GetTable
指定されたリクエスト ID のテーブルから値を取得し、出力場所に配置します。必要に応じてテーブルのヘッダーを含めることができます。
ヘッダーを含めて、テーブル MyTable_Table からすべての値を取得します。
抽出 | リクエスト内 |
|---|---|
=EXTDCGetTable(Request ID Range, Range Name, Output location, Include Headers) | =DCGetTable(Request ID Range, Range Name, Output location, Include Headers) |
LookUpTable
条件に基づいて、指定されたリクエスト ID のテーブルから値を取得し、出力場所に配置します。必要に応じてテーブルのヘッダーを含めることができます。
- 取得する列: 取得する列の実際のヘッダーテキスト、または個々の列ヘッダーを含むセル範囲。
- 条件列: （任意）値を確認する列の実際のヘッダーテキスト。
- 条件値: （任意）検索する値。
抽出 | リクエスト内 |
|---|---|
=EXTDCLookUpTable(Request ID Range, Table Name, Output location, Include Headers, Columns to retrieve, Criteria Column, Criteria Value) | =DCLookUpTable(Request ID Range, Table Name, Output location, Include Headers, Columns to retrieve, Criteria Column, Criteria Value) |
例:
DCLookupTable (RequestID, “MyTable_Table”, $A$15, TRUE, , “Account Number”, “0001”)
Account Number 列に 0001 が含まれるテーブル MyTable_Table のすべての行を取得し、$A$15 から配置します。
DCLookupTable(RequestID, “MyTable_Table”, $B$12, TRUE, C4:C6, C7, C8)
Book 列に Office が含まれるテーブル MyTable_Table から、Account、Description、および Book 列のすべての値を取得し、$B$12 から配置します。
SetRange
指定された範囲内の指定されたリクエストにデータを配置します。より多くの行を含むデータを設定すると、リクエストの領域が拡張されます。データは宛先範囲内で左上から右下に設定され、追加の列は設定されず、値は破棄されます。
例: $B$8 から $B$19 までのデータが、範囲 CellFormat_DCRange にプッシュされます。
抽出 | リクエスト内 |
|---|---|
=EXTDCSetRange(Request ID Range, Range Name,Value range) | 利用不可 |
SetTable
指定されたテーブル内の指定されたリクエストにデータを配置します。データは宛先テーブルに上から下へ設定され、追加の列は設定されず、値は破棄されます。AddRows が有効でないテーブルにデータを設定すると、宛先テーブル外のデータは切り捨てられます。AddRows が有効な宛先テーブルは、設定されるデータを追加するために拡張されます。設定にはヘッダー名を含める必要があります。
例: $B$7 から $H$19 までのデータが、テーブル MyTable_Table にプッシュされます。
抽出 | リクエスト内 |
|---|---|
=EXTDCSetTable(Request ID Range, Table Name,Value range) | 利用不可 |
SetValues
指定されたリクエスト内の、指定された範囲名にデータを配置します。複数の範囲を設定する場合、値は範囲名のリストと一致している必要があります。
例: $B$13 から $B$19 までのデータが、名前 I_0002、I_0005、I_0006、I_0007、I_0008、I_0009、I_0010（$C$2 から $C$8）に設定されます。
抽出 | リクエスト内 |
|---|---|
=EXTDCSetValues(Request ID Range, RangeName range,Values Range) | 利用不可 |