ロボットへの ACL スクリプトのコミット (アップロード)

ACL スクリプトをロボット アプリにコミット (アップロード) する方法として、2 つの方法があります。

• Analytics からロボットにスクリプトをコミットする

• ロボットを使用して ACL スクリプトをアップロードする

  メモ

  ロボットを使用して ACL スクリプトをアップロードするこの方法は、ロボットを使用して、新規作成されたロボットに ACL スクリプトの初回アップロードを実行する方法とは異なります。詳細については、スクリプト自動化をロボットに追加するを参照してください。

各方法の比較

スクリプトをコミットする各方法の最終結果は同じで、スクリプトの新しいバージョンが宛先のロボットに作成されます。しかし、方法によってこのような違いが存在します。

• 構文検証 Analyticsからスクリプトをコミットする際に、構文の自動検証を行います。ロボットを使用してスクリプトをアップロードする場合は、検証は行われません。

• プロジェクトとロボットの関連付け Analytics からスクリプトをコミットする際に、スクリプトを含む Analytics プロジェクトとアップロード先のロボットが自動的に関連付けられます。ロボットを使用してスクリプトをアップロードする場合は、関連付けは行われません。

構文検証やプロジェクトとロボットの関連付けは便利な機能なので、Analytics からロボットにスクリプトをコミットする方法を推奨します。プロジェクトとロボットの関連付けが確立された後、また構文検証の回避があまり問題でないスクリプトの小さな更新をする場合に便利な機能としてロボットからアップロードすることができます。

スクリプトをコミットする仕組み

スクリプトを ACL ロボット アプリにコミットするときには、Analytics プロジェクトのすべてのスクリプトがコミットされ、関連付けられたロボットで「バージョン」になります。プロジェクトからスクリプトを選択してコミットすることはできません。詳細については、Analytics およびロボットにおける ACL スクリプトの開発ワークフローを参照してください。

スクリプトをロボットにコミットするには、ロボット アプリの該当するロールに割り当てる必要があります。詳細については、ロボット アプリのアクセス許可を参照してください。

Analytics からロボットへのスクリプトのコミット

Analytics のスクリプトをロボット アプリの ACL ロボットにコミットまたはアップロードするときには、複数の方法があります。

さまざまな可能性を理解するための最も簡単な方法は、Analytics プロジェクトと ACL ロボットを、関連付けることができる、スクリプトを格納するための 2 つのコンテナであると考えることです。関連付けると、プロジェクトの連続したバージョンのスクリプトをロボットにコミットできます。

アクション	コミットの結果
スクリプトを新しい ACL ロボットにコミットする	コミットされたスクリプトのバージョン 1 を含む、新しい ACL ロボットが作成されます。
スクリプトを既存の ACL ロボットにコミットする	既存の ACL ロボットにはコミットされたスクリプトが含まれます。バージョン番号は、ロボットに既にスクリプトが含まれているかどうかによって異なります。
編集されたスクリプトを ACL ロボットにコミットする	新しいバージョンのスクリプトは、プロジェクトに関連付けられた ACL ロボットにコミットされます。
スクリプトを別の ACL ロボットにコミットする	スクリプトは、新しく作成された ACL ロボットまたは既存の ACL ロボットにコミットされます。 プロジェクトと前のロボットの間の関連付けは削除されます。

スクリプトを新しい ACL ロボットにコミットする

初めてスクリプトをロボット アプリにコミットし、コミットされたスクリプトを含む新しい ACL ロボットを作成します。

1. コンピューターからスクリプトが含まれる Analytics プロジェクトを開きます。

2. Analytics メインメニューから、［ファイル］>［スクリプトをコミット］を選択します。

   エラー メッセージが表示される場合は、プロジェクトの 1 つ以上のスクリプトで、アナリティクス ヘッダーまたはスクリプト構文に問題がある場合があります。

   詳細については、Analytics およびロボットにおける ACL スクリプトの開発ワークフローを参照してください。

3. 必要に応じて、［送信先を選択］ダイアログボックスで、該当する Diligent One インスタンスをダブルクリックします。

   ［ロボットコレクション］と既存のロボットの一覧が表示されます。

4. ［新しいロボット］フィールドにロボット名を入力し、［作成］をクリックします。

   ロボットが作成され、ロボット ID が自動的に生成されます。

   スクリプトを含む Analytics プロジェクトと既存ロボットが関連付けられ、次回以降のコミットでロボットを手動で検索する必要がなくなります。

   メモ

   ロボット名には "$"、"€" の文字を使用しないでください。

5. コミットされたスクリプトを説明する簡潔なコミット メッセージを入力し、［OK］をクリックします。

   バージョン 1 のスクリプトが新しく作成されたロボットにコミットされます。このスクリプトは、この時点では開発モードでのみ存在します。

6. 省略可能。［スクリプトのコミットが成功しました］ダイアログボックスで、新しく作成されたロボット、あるいはコミットされたスクリプトを検査するためのリンクのいずれかをクリックします。
7. ［OK］をクリックして、ダイアログボックスを閉じます。

スクリプトを既存の ACL ロボットにコミットする

ACL ロボットにスクリプトをコミットし、ロボットを入力します。既存のロボットはスクリプトが含まれていても、空であってもかまいません。

1. コンピューターからスクリプトが含まれる Analytics プロジェクトを開きます。

2. Analytics メインメニューから、［ファイル］>［スクリプトをコミット］を選択します。

   エラー メッセージが表示される場合は、プロジェクトの 1 つ以上のスクリプトで、アナリティクス ヘッダーまたはスクリプト構文に問題がある場合があります。

   詳細については、Analytics およびロボットにおける ACL スクリプトの開発ワークフローを参照してください。

3. 必要に応じて、［送信先を選択］ダイアログボックスで、該当する Diligent One インスタンスをダブルクリックします。

   ［ロボットコレクション］と既存のロボットの一覧が表示されます。

4. ロボットのリストで、スクリプトをコミットするロボットを選択し、［OK］をクリックします。

   スクリプトを含む Analytics プロジェクトと既存ロボットが関連付けられ、次回以降のコミットでロボットを手動で検索する必要がなくなります。

5. コミットされたスクリプトを説明する簡潔なコミット メッセージを入力し、［OK］をクリックします。

   スクリプトは、既存のロボットにコミットされます。スクリプトのバージョン番号は、ロボットに既にスクリプトがあるか、以前に空であったかどうかによって異なります。

   このスクリプトは、この時点では開発モードでのみ存在します。

6. 省略可能。［スクリプトのコミットが成功しました］ダイアログボックスで、既存のロボット、あるいはコミットされたスクリプトを検査するためのリンクのいずれかをクリックします。
7. ［OK］をクリックして、ダイアログボックスを閉じます。

編集されたスクリプトを ACL ロボットにコミットする

編集されたスクリプトをコミットし、関連付けられた ACL ロボットで新しいバージョンのスクリプトを作成します。

コミットする前にスクリプトを編集するには、2 つの方法があります。関連付けられたプロジェクトでスクリプトを編集するか、ロボットから新しい Analytics プロジェクトにスクリプトをダウンロードして、新しいプロジェクトでスクリプトを編集できます。

ロボットからスクリプトをダウンロードする

既にローカル コンピューターにあるスクリプトではなく、ロボットに含まれるスクリプトで作業する場合は、この手順の一部を実行します。

1. Launchpad ホームページ（www.highbond.com）から、ロボット アプリを選択して開きます。

   すでに Diligent One を使用している場合は、左側のナビゲーション メニューを使用してロボット アプリに切り替えることができます。

2. ロボットのダッシュボードから、［ACL ロボット］を選択します。
3. ダウンロードするスクリプトが含まれるロボットに移動し、そのロボットを選択して開きます。

4. ロボットの右上隅で、［本番］または［開発］をクリックして、使用するモードを選択します。

   詳細については、ロボットの開発モードと本番モードを参照してください。

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

   • 現在有効なスクリプトのバージョンをダウンロードする

     本番モードで、［ロボットをダウンロード］をクリックします。

   • 最新の開発スクリプトバージョンをダウンロードする

     開発モードでは、［ロボットをダウンロード］をクリックします。

   • 最古のバージョンのスクリプトをダウンロードする

     1. 開発モードで、［スクリプトバージョン］タブを選択します。

     2. ［スクリプトバージョン］リストで、ダウンロードするバージョンを選択します。

     3. ［バージョンの詳細］パネルで、［スクリプトをダウンロード］をクリックします。

   スクリプトがコンピューターのデフォルトのダウンロードフォルダーにダウンロードされます。スクリプトは、ダウンロードしたロボットと同じ名前で、新しく作成された Analytics プロジェクトに含まれます。プロジェクトとロボットは自動的に関連付けられます。

   メモ

   ロボットは 2 つのプロジェクトに関連付けられます。ダウンロードによって作成されたプロジェクトと、スクリプトをコミットするために以前に使用されたプロジェクトです。1 つのロボットは複数のプロジェクトに関連付けることができます。

6. 省略可能。別のフォルダーで作業する場合は、ダウンロードしたスクリプトを含むプロジェクトを移動します。

Analytics でスクリプトを編集してコミットする

1. コンピューターからスクリプトが含まれる Analytics プロジェクトを開きます。

2. スクリプトを編集し、変更を保存します。

   メモ

   必要に応じて、スクリプトを追加したり、削除したりすることもできます。

3. Analytics メイン メニューから、［ファイル > スクリプトのコミット］を選択します。

   エラー メッセージが表示される場合は、プロジェクトの 1 つ以上のスクリプトで、アナリティクス ヘッダーまたはスクリプト構文に問題がある場合があります。

   詳細については、Analytics およびロボットにおける ACL スクリプトの開発ワークフローを参照してください。

4. コミットされたスクリプトの変更を説明する簡潔なコミット メッセージを入力し、［OK］をクリックします。

   スクリプトは関連付けられたロボットにコミットされ、新しいバージョンとして保存されます。ロボットの既存のバージョンのスクリプトは上書きされません。

   関連付けられたロボットが見つからないというエラー メッセージが表示される場合は、ロボットがロボットに存在することと、ロールがスクリプトのコミットを許可していることを確認します。

5. 省略可能。［スクリプトのコミットが成功しました］ダイアログボックスで、新しいバージョンのスクリプトを検査するためのリンクのいずれかをクリックします。
6. ［OK］をクリックして、ダイアログボックスを閉じます。

スクリプトを別の ACL ロボットにコミットする

スクリプトを別の ACL ロボットにコミットし、スクリプトのバージョンをロボットに追加して、プロジェクトに関連付けられたロボットを変更します。スクリプトは編集または編集解除できます。

スクリプトを別のロボットにコミットするときには、2 つの方法があります。

• スクリプトを新しいロボットにコミットする
• スクリプトを既存のロボットにコミットする

1. コンピューターからスクリプトが含まれる Analytics プロジェクトを開きます。

2. Analytics メインメニューから、［ファイル］>［名前を付けてスクリプトをコミット］を選択します。

   エラー メッセージが表示される場合は、プロジェクトの 1 つ以上のスクリプトで、アナリティクス ヘッダーまたはスクリプト構文に問題がある場合があります。

   詳細については、Analytics およびロボットにおける ACL スクリプトの開発ワークフローを参照してください。

3. 必要に応じて、［送信先の選択］ダイアログボックスで、該当する Diligent One インスタンスに移動します。

   ［ロボットコレクション］と既存のロボットの一覧が表示されます。

4. 次のいずれかを実行します。
   • スクリプトを新しいロボットにコミットする［新しいロボット］フィールドにロボット名を入力し、［作成］をクリックします。

     ロボットが作成され、ロボット ID が自動的に生成されます。スクリプトを含む Analytics プロジェクトと新しいロボットが関連付けられます。

     メモ

     ロボット名には "$"、"€" の文字を使用しないでください。

   • スクリプトを既存のロボットにコミットするロボットのリストで、スクリプトをコミットするロボットを選択し、［OK］をクリックします。

     スクリプトを含む Analytics プロジェクトと既存のロボットが関連付けられます。

   プロジェクトと前のロボットの間の関連付けは削除されます。

5. コミットされたスクリプトを説明する簡潔なコミット メッセージを入力し、［OK］をクリックします。

   スクリプトは、新しく作成されたロボットまたは既存のロボットにコミットされます。スクリプトのバージョン番号は、ロボットに既にスクリプトがあるか、以前に空であったかどうかによって異なります。

   このスクリプトは、この時点では開発モードでのみ存在します。

6. 省略可能。［スクリプトのコミットが成功しました］ダイアログボックスで、新しく作成されたロボットまたは既存のロボット、あるいはコミットされたスクリプトを検査するためのリンクのいずれかをクリックします。
7. ［OK］をクリックして、ダイアログボックスを閉じます。

ロボットを使用した ACL スクリプトのアップロード

Analytics を開くことなく、ロボットを使用して ACL スクリプトをアップロードすることができます。この方法では、構文検証を回避してスクリプトをアップロードするため、検証済みのスクリプトの小さな更新をアップロードする場合にのみ使用する必要があります。

1. Launchpad ホームページ（www.highbond.com）から、ロボット アプリを選択して開きます。

   すでに Diligent One を使用している場合は、左側のナビゲーション メニューを使用してロボット アプリに切り替えることができます。

2. ロボットのダッシュボードから、［ACL ロボット］を選択します。

3. ACL ロボットをクリックして開きます。

4. ロボットの右上隅で、［開発］をクリックし、開発モードに切り替えます。

5. ［スクリプトバージョン］タブで、［アップロード］をクリックします。

6. 表示されるダイアログボックスで、次の操作を行います。

   1. ［コンピューターから選択］をクリックし、スクリプトが含まれる Analytics プロジェクトに移動します。

   2. プロジェクトを選択して、［開く］をクリックします。

      Analytics プロジェクトを［アップロードされたスクリプト］領域にドラッグすることもできます。

7. [メッセージをコミット] を入力して、[アップロードしてコミット] をクリックします。

   スクリプトがロボットにアップロードされ、［スクリプトバージョン］リストの最上部に新しいスクリプトバージョンが作成されます。