IMPORT GRCRESULTS コマンド
コンセプト情報
Diligent One のリザルト テーブルまたは解釈をインポートして、Analytics テーブルを作成します。
構文
IMPORT GRCRESULTS TO テーブル インポートファイル名 PASSWORD番号 FROM リザルトリソースパス <FIELD 名前 AS 表示名 <...n>> <CHARMAX 最大フィールド長>
パラメーター
| 名前 | 説明 | |||||||
|---|---|---|---|---|---|---|---|---|
| TO テーブル |
データをインポートする Analytics テーブルの名前。 メモ テーブルの名前は、64 文字までの英数字に制限されます。名前にはアンダースコア文字（_）を使用できますが、他の特殊文字やスペースは使用できません。名前の先頭を数字にすることはできません。 |
|||||||
|
インポートファイル名 |
作成する Analytics データ ファイルの名前。 インポートファイル名、.FIL ファイル拡張子を持つ引用符で囲まれた文字列として指定します。例："Invoices.FIL". デフォルトでは、データ ファイル（.FIL）は、Analytics プロジェクトが入っているフォルダーに保存されます。 既存の異なるフォルダーにデータ ファイルを保存するには、絶対または相対ファイル パスを指定します。
|
|||||||
| PASSWORD 番号 |
使用するパスワード定義。 実際のパスワードを入力することを求めたり指定したりするのには、PASSWORD 番号の構文は使用しません。パスワード定義とは、以前に PASSWORD コマンドか SET PASSWORD コマンドを使用して入力または設定されたパスワードのことです。 番号はパスワード定義の番号です。たとえば、以前に 2 つのパスワードをスクリプトで設定したり入力したりしている場合、またはアナリティクス スクリプトをスケジュールしている場合、PASSWORD 2 により、2 番目のパスワードを使用することを指定します。 パスワードの入力または設定の詳細については、次を参照してください。 必須のパスワード値は、Diligent One アクセス トークンです。詳細については、パスワード定義の作成とパスワード値の指定を参照してください。 PASSWORD 番号は必要な場合と不要な場合があります。スクリプトを実行する環境によって異なります。
|
|||||||
|
FROM リザルトリソース パス |
インポートしているデータへのリザルト パス。 パスの形式は、インポートしているデータによって異なります。パスの形式の詳細については、リザルトパスを参照してください。 メモ リザルトパスの形式は API によって提供され、変更されることがあります。パスの正確な現在の構文を取得する最も簡単で信頼できる方法は、対象データの手動インポートを実行し、コマンドログからパスをコピーすることです。 |
|||||||
| FIELD 名前 AS 表示名 <...n> 省略可能 |
インポートするソース データの個別のフィールド。名前を指定します。 FIELD を省略すると、すべてのフィールドがインポートされます。 名前名前は、リザルトのテーブルの物理フィールド名と正確に一致する必要があります。大文字小文字も区別されます。物理フィールド名を表示するには、次のいずれかを実行します。
メモ リザルトの物理フィールド名は、テーブルビューResultsの列見出しに使用される表示名ではありません。 リザルト データをインポートおよびエクスポートするときのフィールド名の考慮事項を参照してください。 表示名表示名は、新しい Analytics テーブルのビューにおけるフィールドの表示名（代替列見出し）です。各 FIELD 名の表示名を指定する必要があります.表示名の値は引用符で囲まれた文字列。 列見出しを改行したい場合は、語句の間にセミコロン (;) を入れます。 Analytics の他のいくつかの IMPORT コマンドとは異なり、FIELD 名を表示名として使用する方法として、空の表示名を指定することはできません。 |
|||||||
| CHARMAX 最大フィールド長 省略可能 |
リザルトテーブルまたは解釈内の文字データから発生する Analytics テーブルの任意のフィールドの文字の最大長。 リザルトテーブルまたは解釈内の最大フィールド長を超えるデータは、Analytics にインポートすると切り捨てられます。 フィールドを切り詰める機能では、時折出現する長い値が原因で、インポート処理でサポートされるレコード全体の長さを超えることがなくなります。
|
例
リザルトのテーブル内の指定したフィールドをインポートする
リザルトのテーブルから Analytics テーブル T and E exceptions に指定されたフィールドをインポートしています。
IMPORT GRCRESULTS TO T_and_E_exceptions "C:\Secondary Analysis\T_and_E_exceptions.fil" PASSWORD 1 FROM "results/api/orgs/11594/control_tests/185699/exceptions" FIELD "metadata.status" AS "Status" FIELD "EmpNo" AS "Employee Number" FIELD "DATE" AS "Date" FIELD "CARDNUM" AS "Card Number" FIELD "CODES" AS "MC Codes" FIELD "AMOUNT" AS "Amount" FIELD "DESCRIPTION" AS "Description"
リザルトのテーブル内のすべてのフィールドをインポートする
次の例では、リザルトのテーブルから Analytics テーブル T and E exceptions にすべてのフィールドをインポートしています。
IMPORT GRCRESULTS TO T_and_E_exceptions "C:\Secondary Analysis\T_and_E_exceptions.fil" PASSWORD 1 FROM "results/api/orgs/11594/control_tests/185699/exceptions"
リザルトのテーブルからインポートするときのフィールド長の制限
次の例では、リザルトのテーブルから Analytics テーブル T and E exceptions にすべてのフィールドをインポートしています。CHARMAX パラメーターを使用してフィールド長を制限します。
IMPORT GRCRESULTS TO T_and_E_exceptions "C:\Secondary Analysis\T_and_E_exceptions.fil" PASSWORD1 FROM "results/api/orgs/11594/control_tests/185699/exceptions" CHARMAX 200
結果として得られた Analytics テーブルでは、リザルト内の文字データから発生するすべてのフィールドは、指定した 200 文字長に制限されます。制限を超えるフィールド値は 200 文字に切り詰められます。
リザルトの解釈内のデータをインポートする
次の例では、リザルトの解釈を Analytics テーブル T and Exceptions filtered にインポートしています。
IMPORT GRCRESULTS TO T_and_E_exceptions_filtered "C:\Secondary Analysis\T_and_E_exceptions_filtered.fil" FROM "results/api/orgs/11594/control_tests/185699/interpretations/22699/exceptions"
備考
このコマンドの動作の詳細については、Diligent One リザルトのデータをインポートするを参照してください。
並べ替え順やフィルターを保持する
リザルトからデータをインポートする場合、並べ替えやフィルターなどのデータ カスタマイズは、データのインポート方法に応じて、インポート後の Analytics テーブルでは保持されるか、破棄されます。
- テーブルのインポート データカスタマイズが破棄されます。省略するように選択したフィールドを除き、テーブルのすべてのデータがインポートされます。
- 解釈のインポート データカスタマイズが保持されます。
リザルトパス
メモ
リザルトパスの形式は API によって提供され、変更されることがあります。パスの正確な現在の構文を取得する最も簡単で信頼できる方法は、対象データの手動インポートを実行し、コマンドログからパスをコピーすることです。
FROMResults パラメーターのリザルトパスは次の一般的な形式を使用します。
FROM "results <-地域コード>/api/orgs/<組織 ID>/control_tests/<統制テスト ID>/exceptions
例：
FROM "results/api/orgs/11594/control_tests/4356/exceptions"
組織 ID は Launchpad にログインするときにブラウザーのアドレスバーに表示されます。統制テスト ID および解釈 ID は、リザルトでテーブルを表示するときにアドレスバーに表示されます。
以下の表は、リザルトパスのバリエーションを示します。
| インポートするには | 次の形式のリザルトパスを使用します。 |
|---|---|
| 統制テスト（テーブル）のデータ | FROM "results/api/orgs/11594/control_tests/4356/exceptions" |
| 統制テスト（テーブル）の監査証跡 | FROM "results/api/orgs/11594/control_tests/4356/audit_trail" |
| 統制テスト（テーブル）のコメント | FROM "results/api/orgs/11594/control_tests/4356/comments" |
| 解釈 | FROM "results/api/orgs/11594/control_tests/4356/interpretations/1192/exceptions" |
| デフォルト地域 (us) 以外の Diligent One 地域のデータ |
|
システムで生成された情報列
リザルトからデータをインポートするときには、次で示すシステムで生成された情報列を 1 つ以上インポートすることができます。
システムで生成された列は次のいずれかです。
- リザルトのテーブルの一部であり、個々のレコードに関連する処理情報を含んでいます。
- 追加情報 - コレクション名、テーブル名、またはレコード ID 番号
以下に示すように、システムで生成された列のフィールド名を正確に指定する必要があります。Analytics のユーザーインターフェイスを使用して リザルトからインポートするときには、デフォルトの表示名が適用されます。インポート処理のスクリプトを作成する場合は、表示名を自由に変更できます。
|
フィールド名 |
デフォルトの表示名 |
|---|---|
|
metadata.priority |
優先度 |
|
metadata.status |
進捗状況 |
|
metadata.publish_date |
公開済み |
|
metadata.publisher |
公開者名 |
|
metadata.assignee |
割り当てられたユーザー |
| metadata.group | グループ |
| metadata.updated_at | 更新 |
| metadata.closed_at | クローズ済み |
| extras.collection | コレクション |
| extras.results_table | 結果テーブル |
| extras.record_id | レコード ID |
リザルト データをインポートおよびエクスポートするときのフィールド名の考慮事項
If you are round-tripping data between リザルト and Analytics, you need to ensure that all field names in the リザルト table meet the more stringent Analytics field name requirements.If you do not, you risk misaligning your Analytics and リザルト data.
For example, any special characters in リザルト field names are automatically converted to underscores when they are imported into Analytics, which means the field names no longer match the original names in リザルト.If you then export the Analytics data back to the original table in リザルト, fields are no longer correctly matched.
To avoid this problem with data that you intend to round-trip, make sure that before you upload the data to リザルト from CSV or Excel files it meets these Analytics field name requirements:
- no special characters or spaces
- does not start with a number
- contains only alphanumeric characters, or the underscore character ( _ )
パスワード定義の作成とパスワード値の指定
ロボットで Diligent One リザルトテーブルまたは解釈をインポートするスクリプトを実行する場合、IMPORT GRCRESULTS コマンドとともにパスワード定義を含める必要があります。オフラインアクティベーションを使用する場合、同じ要件が Analytics で実行されるスクリプトに適用されます。
どの方法を用いてパスワード定義を作成したかにかかわらず、パスワードには値として Diligent One アクセス トークンを指定する必要があります。このトークンは Launchpad で生成できます。詳細については、Diligent One アクセス トークンを取得するを参照してください。
パスワード定義方法
| 方法 | 説明 |
|---|---|
|
PASSWORD アナリティクス タグ （ロボットで実行するスクリプト用） |
PASSWORD アナリティクスタグを使用して、Diligent One に接続するための番号付けされたパスワード定義を作成した場合、スクリプトでパスワードの値が指定されません。ロボットでスクリプトを実行するタスクを作成すると、タスクデザイナーの入力フィールドで実際のパスワードを指定できます。 詳細については、PASSWORD アナリティクスタグを参照してください。 |
|
PASSWORD コマンド （Analytics で実行するスクリプトでは、オフラインアクティベーション） |
PASSWORD コマンドを使用して、Diligent One に接続するための番号付けされたパスワード定義を作成した場合、スクリプトでパスワードの値が指定されません。スクリプトで接続しようとすると、パスワードプロンプトが表示されます。 詳細については、PASSWORD コマンドを参照してください。 |
|
SET PASSWORD コマンド （Analytics で実行するスクリプトでは、オフラインアクティベーション） |
SET PASSWORD コマンドを使用して、Diligent One に接続するための番号付けされたパスワード定義を作成した場合、スクリプトでパスワードの値が指定されるため、パスワードプロンプトは表示されません。この方法は自動実行用に作成されたスクリプトに適していますが、スクリプトに実際のパスワードがクリアテキストで表示されるため、この状況には適していません。 詳細については、SET PASSWORD コマンドを参照してください。 |
Diligent One アクセス トークンを取得する
注意
生成されるアクセストークンは Diligent One にサインインするために使用されるアカウントと一致します。他のユーザーが使用するスクリプトを作成する場合は、そのスクリプト内に自身のアクセストークンを指定することは不適切です。
アクセストークンはアカウントパスワードと同じように保護してください。
新しいアクセストークンを作成する理由がない場合は、既存のトークンを使用してください。既存のトークンが機能しない場合は、新しいトークンを作成してください。既存のトークンを使用すると、管理する必要があるトークン数が減ります。
-
次のいずれかを実行します。
-
Analytics メインメニューで［ツール］ > ［Diligent One アクセス トークン］の順に選択します。
-
スクリプト エディター内を右クリックし、［挿入］ > ［Diligent One トークン］の順に選択します。
［API トークンを管理］ページがお使いのブラウザーで開きます。最初に Diligent One にサインインすることを求められる場合があります。
Analytics からの［API トークンを管理］ページへのアクセスが便利です。Diligent One にサインインし、Analytics を使用せずにユーザープロファイルからこのページにアクセスすることもできます。
-
-
次のいずれかを実行します。
-
既存のトークンを使用する
-
［トークン］列で、使用するトークンをクリックします。
-
Diligent One アカウントのパスワードを入力し、［確認Diligent One］をクリックします。
マスクされていないトークンが表示されます。
-
［コピー ］をクリックしてトークンをコピーします。
ヒント
トークンが含まれているこのダイアログボックスは、そのトークンを貼り付けるまで閉じないでください。
-
-
新しいトークンを作成する
-
［トークンを追加］ > ［Analytics］をクリックします。
-
［新しい Analytics トークン］サイド パネルで、次の情報を指定します。
フィールドまたはオプション 説明 説明 次のような有用な情報を提供する説明を入力します。
- トークンの目的
- トークンの使用場所 - 例えば、Analytics スクリプトの名前と場所、ロボットのタスクの名前と場所など。
トークンの有効期限 - 有効 指定した日数後にトークンの有効期限が切れます
- 無効 トークンの有効期限はありません
メモ
あなたの組織には、トークンを一定期間後に失効させるセキュリティポリシーがあるかもしれません。有効期限付きのトークンを作成することは良い習慣です。Diligent One では、有効期限の前に自動でメール通知が送られます。
有効期限が切れるまでの日数 トークンの有効期限が切れるまでの日数を指定します (1～365)。 パスワード Diligent One アカウントのパスワードを入力します。 -
［トークンを生成］をクリックします。
-
［コピー ］をクリックしてトークンをコピーします。
ヒント
トークンが含まれているこのサイド パネルは、トークンを貼り付けるまで閉じないでください。
-
-
-
使用しているパスワード定義方法に応じて次のいずれかを実行します。
-
PASSWORDアナリティクスタグACLロボットのタスクデザイナーで、コピーしたトークンをパスワーACL robotドパラメーターフィールドに貼り付けます。
-
PASSWORD コマンドAnalytics で、コピーしたトークンを、スクリプト実行中に表示されるパスワードの確認に貼り付けます。
-
SET PASSWORD コマンドAnalytics で、スクリプトの SET PASSWORD コマンド構文内の適切な位置にコピーしたトークンを貼り付けます。
-
-
Launchpad で、トークンが含まれているダイアログボックスまたはサイド パネルを閉じます。
新しいトークンを作成した場合は、部分的にマスクされたバージョンのトークンが、トークンのリストに追加されます。
詳細については、Diligent One アクセス トークンの作成と管理を参照してください。
インポートデバッグ機能
Diligent One からのインポートには、簡易デバッグ機能があります。
インポートされたデータは、対象 Analytics プロジェクトを含むフォルダーの JSON 中間ファイルに一時的に格納されます。Analytics プロジェクトを含むフォルダーでは、データが Analytics にインポートされた後に削除する代わりに、JSON ファイルを保持するテキストファイルを作成できます。
- JSON ファイルが存在する Diligent One からのインポートが失敗しDiligent One、JSON ファイルがコンピューターにある場合は、問題が Diligent One 側ではなく、Analytics 側にあることがわかっています。AnalyticsDiligent One
- JSON ファイルが存在しない Diligent One からのインポートが失敗し、JSDiligent OneON ファイルがコンピューターにない場合は、問題が Diligent One 側にあることがわかっています。Diligent One
この情報はトラブルシューティングで役立ちます。
JSON 中間ファイルの保持を設定する
ターゲット Analytics プロジェクトを含むフォルダーで、_grc_import_debug.txt Analyticsという名前の空のテキスト ファイルを作成します。
Diligent One のリザルトまたはプロジェクトからインポートするときには、JSON 中間ファイルは results.json という名前で保持されます。ファイルは後続の各 Diligent One からのインポートするたびに上書きされます。
大きいテーブルのインポート
Tables that have a large number of fields may not successfully import using a single IMPORT GRCRESULTS command.If you need to work with a single table containing a large number of fields outside of リザルト, use one of the following approaches:
- Split the table use two or more IMPORT GRCRESULTS commands to import a subset of fields and then join the resulting tables in Analytics using the JOIN command
- Export the table to file use the export to CSV format and then import the resulting file into Analytics using the IMPORT DELIMITED command
