スクリプトの作成と編集

スクリプトの作成にはいくつかのオプションがあります:

• スクリプト エディタ スクリプト エディタ ウィンドウのスクリプト構文を入力する
• コマンド ログ コマンド ログからスクリプト構文をコピーして貼り付ける
• スクリプト レコーダー 実行時にコマンドの構文を記録する
• 構文キャプチャ コマンドを実行せずユーザー インターフェイスで選択する場合にコマンドの構文を挿入する
• テーブル履歴 出力テーブル履歴からスクリプトの構文をコピーする

これらのオプションは組み合わせで利用できます。たとえば、コマンドログから構文をコピーして、スクリプト エディター ウィンドウに直接構文を追加してスクリプトを開始することができます。

Analytics 内の既存のスクリプトを編集するには、スクリプト エディターを使用する必要があります。

また、選択したテキスト エディターを使用して、Analytics スクリプトに構文をコピーして貼り付けることもできます。

コード補完

スクリプト エディターでスクリプト構文を入力する際、Analytics によってさまざまな種類のコード補完が実行されます。コード補完により、構文の入力が簡素化されるだけでなく、ACLScript のコマンド、関数、キーワード、パラメーターの有効な形式も提示されます。

• コマンド、関数、キーワードの自動補完 自動補完機能により、入力した文字に基づいて、ACLScript のコマンド、関数、キーワードの選択リストが順次更新されます。リストから項目を選択すると、構文項目が自動的に補完されます。

• 関数パラメーターのポップアップ ヘルプ 有効な関数名の後に開き括弧を入力すると、ポップアップ ヘルプが表示され、関数が返す出力のデータ型と、関数パラメーターに必要な形式が示されます。

• ペアの構文項目の自動閉じ 以下のペアになっている構文項目のいずれかの開き記号を入力すると、閉じ記号が自動的に入力されます。

  • 二重引用符 ""

  • 単一引用符 ''

  • 逆引用符 ``

  • 括弧 ()

コマンド、関数、キーワードのオートコンプリートをオフにするには、［オプション］ダイアログ ボックスの［インターフェイス］タブ（［ツール］ > ［オプション］）で［スクリプトのオートコンプリートを無効にする］を選択します。

関数パラメーターのポップアップ、および一般的な構文項目の自動閉じを無効にすることはできません。

ScriptHub からスクリプトやスニペットをインポートする

スクリプトを作成するための別のオプションは、ScriptHubのコンテンツを利用することです。ScriptHub は、Diligent の社員と Diligent ユーザー コミュニティによって開発された Analytics スクリプト項目の Web ライブラリです。サブスクリプションの一部として、ScriptHub のコンテンツをダウンロードおよび使用できます。

詳細については、ScriptHub からのインポートを参照してください。

スクリプト エディター でスクリプトを作成または編集する

必要な ACLScript 構文を直接スクリプトエディターに入力するか、あるいは既存のスクリプトに対してはその他の方法のいずれかを使用することで、スクリプトを作成または編集することができます。

コマンド ログからスクリプトを作成する

ナビゲーターの［ログ］タブにあるログ エントリを、スクリプトを新規作成するための出発点として、または既存のスクリプトに追加するためにコピーすることができます。Analytics で以前に実行された各コマンドの構文は個別のログ エントリに記録されます。

次のタイプのログ エントリを選択し、新しい、または既存のスクリプトにコピーします。

• 個別のエントリ
• テーブルに関連付けられた一連のエントリ
• セッションまたは期間に関連付けられたエントリのより大きいグループ

スクリプト レコーダーを使用してスクリプトを作成する

Analytics スクリプト レコーダーでは、Analytics ユーザーインターフェイスでテーブルに対して行った操作やコマンドを記録することによって、スクリプトを作成できます。スクリプト レコーダーを使用してスクリプトを作成する利点は、使用する ACLScript コマンドに対して構文を入力することや構文の知識が必要ないという点です。

スクリプト レコーダー が記録するのはコマンドだけです。原則として、コマンド ログに表示されるコマンドはスクリプト レコーダーに記録できます。

構文のキャプチャを使用してスクリプトを作成する

構文のキャプチャを使用すると、Analytics メニューとダイアログボックスを使用して、Analytics スクリプト構文をスクリプトに自動的に挿入できます。

テーブル履歴からスクリプトを作成する

Analytics 出力または結果または結果テーブルに関連付けられた履歴に基づいてスクリプトを作成できます。

たとえば、Analytics プロジェクトに月次棚卸テーブルを追加し、関連する部署と項目を新しいテーブルに抽出する場合は、作成した最初の出力テーブルに関連付けられたテーブル履歴に基づいてこのプロセスをスクリプト化できます。

Analytics では、Analytics コマンドの実行結果の出力として作成されたテーブルごとに、そのテーブルの作成に使用したコマンドの記録を保持しています。これには、元の ACL テーブルと出力テーブル間に存在した中間テーブルを作成したコマンドも含まれます。後続の出力テーブルの作成を自動化するために使用できる新しいスクリプトにこのテーブル履歴をコピーできます。

Diligent One アクセス トークンを取得する

新しいアクセストークンを作成する理由がない場合は、既存のトークンを使用してください。既存のトークンが機能しない場合は、新しいトークンを作成してください。既存のトークンを使用すると、管理する必要があるトークン数が減ります。

1. 次のいずれかを実行します。

   • Analytics メインメニューで［ツール］ > ［Diligent One アクセス トークン］の順に選択します。

   • スクリプト エディター内を右クリックし、［挿入］ > ［Diligent One トークン］の順に選択します。

   ［API トークンを管理］ページがお使いのブラウザーで開きます。最初に Diligent One にサインインすることを求められる場合があります。

   Analytics からの［API トークンを管理］ページへのアクセスが便利です。Diligent One にサインインし、Analytics を使用せずにユーザープロファイルからこのページにアクセスすることもできます。

2. 次のいずれかを実行します。

   • 既存のトークンを使用する

     1. ［トークン］列で、使用するトークンをクリックします。

     2. Diligent One アカウントのパスワードを入力し、［確認Diligent One］をクリックします。

        マスクされていないトークンが表示されます。

     3. ［コピー ］をクリックしてトークンをコピーします。

        ヒント

        トークンが含まれているこのダイアログボックスは、そのトークンを貼り付けるまで閉じないでください。

   • 新しいトークンを作成する

     1. ［トークンを追加］ > ［Analytics］をクリックします。

     2. ［新しい Analytics トークン］サイド パネルで、次の情報を指定します。

        フィールドまたはオプション	説明
        説明	次のような有用な情報を提供する説明を入力します。 トークンの目的 トークンの使用場所 - 例えば、Analytics スクリプトの名前と場所、ロボットのタスクの名前と場所など。
        トークンの有効期限	有効 指定した日数後にトークンの有効期限が切れます 無効 トークンの有効期限はありません メモ あなたの組織には、トークンを一定期間後に失効させるセキュリティポリシーがあるかもしれません。有効期限付きのトークンを作成することは良い習慣です。Diligent One では、有効期限の前に自動でメール通知が送られます。
        有効期限が切れるまでの日数	トークンの有効期限が切れるまでの日数を指定します (1～365)。
        パスワード	Diligent One アカウントのパスワードを入力します。

     3. ［トークンを生成］をクリックします。

     4. ［コピー ］をクリックしてトークンをコピーします。

        ヒント

        トークンが含まれているこのサイド パネルは、トークンを貼り付けるまで閉じないでください。

3. 使用しているパスワード定義方法に応じて次のいずれかを実行します。

   • PASSWORDアナリティクスタグACLロボットのタスクデザイナーで、コピーしたトークンをパスワーACL robotドパラメーターフィールドに貼り付けます。

   • PASSWORD コマンドAnalytics で、コピーしたトークンを、スクリプト実行中に表示されるパスワードの確認に貼り付けます。

   • SET PASSWORD コマンドAnalytics で、スクリプトの SET PASSWORD コマンド構文内の適切な位置にコピーしたトークンを貼り付けます。

4. Launchpad で、トークンが含まれているダイアログボックスまたはサイド パネルを閉じます。

   新しいトークンを作成した場合は、部分的にマスクされたバージョンのトークンが、トークンのリストに追加されます。

   詳細については、Diligent One アクセス トークンの作成と管理を参照してください。