IMPORT GRCPROJECT コマンド
コンセプト情報
HighBond プロジェクト テーブルをインポートして、Analytics テーブルを作成します。
構文
IMPORT GRCPROJECT TO テーブル インポートファイル名 PASSWORD番号 FROM 組織 ID タイプ ID <FIELD 名前 AS 表示名 <...n>> <CHARMAX 最大フィールド長>
パラメーター
| 名前 | 説明 | |||||||
|---|---|---|---|---|---|---|---|---|
| TO テーブル |
データをインポートする Analytics テーブルの名前。 メモ テーブルの名前は、64 文字までの英数字に制限されます。名前にはアンダースコア文字（_）を使用できますが、他の特殊文字やスペースは使用できません。名前の先頭を数字にすることはできません。 |
|||||||
|
インポートファイル名 |
作成する Analytics データ ファイルの名前。 インポートファイル名、.FIL ファイル拡張子を持つ引用符で囲まれた文字列として指定します。例："Invoices.FIL". デフォルトでは、データ ファイル（.FIL）は、Analytics プロジェクトが入っているフォルダーに保存されます。 既存の異なるフォルダーにデータ ファイルを保存するには、絶対または相対ファイル パスを指定します。
|
|||||||
| PASSWORD 番号 |
使用するパスワード定義。 実際のパスワードを入力することを求めたり指定したりするのには、PASSWORD 番号の構文は使用しません。パスワード定義とは、以前に PASSWORD コマンドか SET PASSWORD コマンドを使用して入力または設定されたパスワードのことです。 番号はパスワード定義の番号です。たとえば、以前に 2 つのパスワードをスクリプトで設定したり入力したりしている場合、またはアナリティクス スクリプトをスケジュールしている場合、PASSWORD 2 により、2 番目のパスワードを使用することを指定します。 パスワードの入力または設定の詳細については、次を参照してください。 必須のパスワード値は、HighBond アクセス トークンです。詳細については、パスワード定義の作成とパスワード値の指定を参照してください。 PASSWORD 番号は必要な場合と不要な場合があります。スクリプトを実行する環境によって異なります。
|
|||||||
|
FROM 組織ID タイプID |
組織とインポート中のデータを定義する情報のタイプ。
組織ID 値と タイプID 値はスペースを入れずにスラッシュで区切る必要があります。 FROM "125@-eu/audits" 文字列全体を引用符で囲む必要があります。 組織 ID組織 ID には、組織の ID 番号が含まれている必要があるほか、北米（米国）以外のデータ センターへインポートする場合には、そのデータ センターのコードも含まれている必要があります。組織 ID 番号とデータ センターのコードは、アット マーク（@）とハイフン（-）で区切る必要があります。 FROM "125@-eu" メモ 北米（US）データセンター コードを指定する場合は、ハイフンを含まない少し異なる形式が使用されます。 FROM "125@us" データ センター コードは、どの地域の HighBond サーバーからデータをインポートするのかを指定します。
組織の HighBond インスタンスに対して承認されているデータ センター コードのみを使用できます。北米のデータ センターがデフォルトであるため、@us を指定するのはオプションです。 組織 ID 番号がわからない場合は、Analytics のユーザー インターフェイスを使用して、プロジェクトからテーブルをインポートします。組織 ID 番号はログのコマンドに含まれます。詳細については、HighBond プロジェクト データのインポートを参照してください。 タイプ IDタイプID はインポートする情報のタイプを指定します。プロジェクトの情報は一連の関連するテーブルに含まれます。 タイプ ID では、次のリストの値のいずれかを使用します。必要に応じて、表示される値を正確認入力します（アンダースコアを含む）。
ヒント プロジェクトのテーブルが関連付けられる方法および Analytics にインポートした後にテーブルを結合するために使用できるキー フィールドについては、HighBond プロジェクト データのインポートを参照してください。 |
|||||||
| FIELD 名前 AS 表示名 <...n> 省略可能 |
インポートするソース データの個別のフィールド。名前を指定します。 FIELD を省略すると、すべてのフィールドがインポートされます。
ヒント 物理フィールド名を取得するには、Analytics のユーザー インターフェイスを使用して、プロジェクトから該当するテーブルをインポートします。物理フィールド名はログのコマンドに含まれます。 後続のインポートをスクリプト化できます。 |
|||||||
| CHARMAX 最大フィールド長 省略可能 |
プロジェクトテーブル内の文字データから発生する Analytics テーブルの任意のフィールドの文字の最大長。 プロジェクトテーブル内の最大フィールド長を超えるデータは、Analytics にインポートすると切り捨てられます。 フィールドを切り詰める機能では、時折出現する長い値が原因で、インポート処理でサポートされるレコード全体の長さを超えることがなくなります。
|
例
指定したフィールドをプロジェクト テーブルからインポートする
組織 286（米国地域）に属するすべてのアクティブなプロジェクトに関するプロジェクト テーブル内の指定したフィールドを、Analytics テーブル All_Projects にインポートするとします。
IMPORT GRCPROJECT TO All_Projects "C:\HighBond Projects Data\All_Projects.fil" FROM "286@us/audits" FIELD "id" AS "Id" FIELD "description" AS "Description" FIELD "name" AS "Name" FIELD "start_date" AS "Start date" FIELD "status" AS "Status" FIELD "created_at" AS "Created at"
プロジェクト テーブルからすべてのフィールドをインポートする
組織 286（米国地域）に属するすべてのアクティブなプロジェクトに関するプロジェクト テーブル内のすべてのフィールドを、Analytics テーブル All_Projects にインポートするとします。接続を認証するため、番号付けされたパスワード定義を追加します。以上を行うコマンドは次のようになります。
IMPORT GRCPROJECT TO All_Projects "C:\HighBond Projects Data\All_Projects.fil" PASSWORD 1 FROM "286@us/audits"
プロジェクトテーブルからインポートするときのフィールド長の制限
プロジェクト テーブル内のすべてのフィールドを、Analytics テーブル All_Projects にインポートするとします。CHARMAX パラメーターを使用してフィールド長を制限します。
IMPORT GRCPROJECT TO All_Projects "C:\HighBond Projects Data\All_Projects.fil" PASSWORD1 FROM "286@us/audits" CHARMAX 200
結果として得られた Analytics テーブルでは、プロジェクト内の文字データから発生するすべてのフィールドは、指定した 200 文字長に制限されます。制限を超えるフィールド値は 200 文字に切り詰められます。
すべてのフィールドを問題テーブルからインポートする
この例では、組織 11594（欧州地域）に属するすべてのアクティブなプロジェクトに関する問題テーブルのすべてのフィールドを、Analytics テーブル All_Issues にインポートします
IMPORT GRCPROJECT TO All_Issues "C:\HighBond Projects Data\All_Issues.fil" FROM "11594@-eu/findings"
備考
このコマンドの動作の詳細については、HighBond プロジェクト データのインポートを参照してください。
パスワード定義の作成とパスワード値の指定
ロボットで HighBond プロジェクトテーブルをインポートするスクリプトを実行する場合、IMPORT GRCPROJECT コマンドを使用してパスワード定義を含める必要があります。オフラインアクティベーションを使用する場合、同じ要件が Analytics で実行されるスクリプトに適用されます。
どの方法を用いてパスワード定義を作成したかにかかわらず、パスワードには値として HighBond アクセストークンを指定する必要があります。このトークンは Launchpad で生成できます。詳細については、HighBond アクセス トークンを取得を参照してください。
パスワード定義方法
| 方法 | 説明 |
|---|---|
|
PASSWORD アナリティクス タグ （ロボットで実行するスクリプト用） |
PASSWORD アナリティクスタグを使用して、HighBond に接続するための番号付けされたパスワード定義を作成した場合、スクリプトでパスワードの値が指定されません。ロボットでスクリプトを実行するタスクを作成すると、タスクデザイナーの入力フィールドで実際のパスワードを指定できます。 詳細については、PASSWORD アナリティクスタグを参照してください。 |
|
PASSWORD コマンド （Analytics で実行するスクリプトでは、オフラインアクティベーション） |
PASSWORD コマンドを使用して、HighBond に接続するための番号付けされたパスワード定義を作成した場合、スクリプトでパスワードの値が指定されません。スクリプトで接続しようとすると、パスワードプロンプトが表示されます。 詳細については、PASSWORD コマンドを参照してください。 |
|
SET PASSWORD コマンド （Analytics で実行するスクリプトでは、オフラインアクティベーション） |
SET PASSWORD コマンドを使用して、HighBond に接続するための番号付けされたパスワード定義を作成した場合、スクリプトでパスワードの値が指定されるため、パスワードプロンプトは表示されません。この方法は自動実行用に作成されたスクリプトに適していますが、スクリプトに実際のパスワードがクリアテキストで表示されるため、この状況には適していません。 詳細については、SET PASSWORD コマンドを参照してください。 |
HighBond アクセス トークンを取得
注意
生成されるアクセストークンは HighBond にサインインするために使用されるアカウントと一致します。他のユーザーが使用するスクリプトを作成する場合は、そのスクリプト内に自身のアクセス トークンを指定することは不適切です。
アクセストークンはアカウントパスワードと同じように保護してください。
新しいアクセストークンを作成する理由がない場合は、既存のトークンを使用してください。既存のトークンが機能しない場合は、新しいトークンを作成してください。既存のトークンを使用すると、管理する必要があるトークン数が減ります。
-
次のいずれかを実行します。
-
Analytics メインメニューで［ツール］ > ［HighBond アクセストークン］を選択します。
-
スクリプト エディター内を右クリックし、［挿入 > HighBond トークン］を選択します。
［API トークンを管理］ページがお使いのブラウザーで開きます。最初に HighBond にサインインすることを求められる場合があります。
Analytics からの［API トークンを管理］ページへのアクセスが便利です。HighBond にサインインし、Analytics を使用せずにユーザープロファイルからこのページにアクセスすることもできます。
-
-
次のいずれかを実行します。
-
既存のトークンを使用する
-
［トークン］列で、使用するトークンをクリックします。
-
HighBond のパスワードを入力し、［確認］をクリックします。
マスクされていないトークンが表示されます。
-
［コピー ］をクリックしてトークンをコピーします。
ヒント
トークンが含まれているこのダイアログボックスは、そのトークンを貼り付けるまで閉じないでください。
-
-
新しいトークンを作成する
-
［トークンを追加］ > ［Analytics］をクリックします。
-
［新しい Analytics トークン］サイド パネルで、次の情報を指定します。
フィールドまたはオプション 説明 説明 次のような有用な情報を提供する説明を入力します。
- トークンの目的
- トークンの使用場所 - 例えば、Analyticsスクリプトの名前と場所、ロボットのタスクの名前と場所など。
トークンの有効期限 - 有効 指定した日数後にトークンの有効期限が切れます
- 無効 トークンの有効期限はありません
メモ
あなたの組織には、トークンを一定期間後に失効させるセキュリティポリシーがあるかもしれません。有効期限付きのトークンを作成することは良い習慣です。HighBondでは、有効期限の前に自動でメール通知が送られます。
有効期限が切れるまでの日数 トークンの有効期限が切れるまでの日数を指定します (1～365)。 パスワード HighBond アカウントのパスワードを入力します。 -
［トークンを生成］をクリックします。
-
［コピー ］をクリックしてトークンをコピーします。
ヒント
トークンが含まれているこのサイド パネルは、トークンを貼り付けるまで閉じないでください。
-
-
-
使用しているパスワード定義方法に応じて次のいずれかを実行します。
-
PASSWORDアナリティクスタグACLロボットのタスクデザイナーで、コピーしたトークンをパスワードパラメーターフィールドに貼り付けます。
-
PASSWORD コマンドAnalytics で、コピーしたトークンを、スクリプト実行中に表示されるパスワードの確認に貼り付けます。
-
SET PASSWORD コマンドAnalytics で、スクリプトの SET PASSWORD コマンド構文内の適切な位置にコピーしたトークンを貼り付けます。
-
-
Launchpad で、トークンが含まれているダイアログボックスまたはサイド パネルを閉じます。
新しいトークンを作成した場合は、部分的にマスクされたバージョンのトークンが、トークンのリストに追加されます。
詳細については、HighBond アクセストークンの作成と管理を参照してください。
インポート デバッグ機能
HighBond からのインポートには、簡易デバッグ機能があります。
インポートされたデータは、対象 Analytics プロジェクトを含むフォルダーの JSON 中間ファイルに一時的に格納されます。Analytics プロジェクトを含むフォルダーでは、データが Analytics にインポートされた後に削除する代わりに、JSON ファイルを保持するテキスト ファイルを作成できます。
- JSON ファイルが存在する HighBond からのインポートが失敗し、JSON ファイルがコンピューターにある場合は、問題が HighBond 側ではなく、Analytics 側にあることがわかっています。
- JSON ファイルが存在しない HighBond からのインポートが失敗し、JSON ファイルがコンピューターにない場合は、問題が HighBond 側にあることがわかっています。
この情報はトラブルシューティングで役立ちます。
JSON 中間ファイルの保持を設定する
ターゲット Analytics プロジェクトを含むフォルダーで、_grc_import_debug.txt という名前の空のテキスト ファイルを作成します。
HighBond のリザルトまたはプロジェクトからインポートするときには、JSON 中間ファイルは results.json という名前で保持されます。ファイルは後続の各 HighBond からのインポートするたびに上書きされます。
