Orchestrator でアセットを管理する

オートメーションで使用するアセット (資格情報、テキスト値、その他の共有リソースを含む) を Orchestrator で作成および管理します。

アセットを作成する

1. [アセット] ページで、[追加] を選択します。[アセットを追加] ウィンドウが表示されます。
2. [アセット名] フィールドに、アセットの名前を入力します。
3. [ 種類 ] のリストから、作成するアセットの [入力] を選択します。
4. アセットの説明を追加します。
5. [ アクセス スコープ ] セクションから目的のアクセス スコープを選択します。
   • オートメーションのみ: アセット値をオートメーション関連のコンテキスト内でのみ取得できます。
   • オートメーションと API: オートメーションのコンテキストを必要とせずに、API と連携を介してプログラムによってアセット値を取得できます。
6. このアセットを保存する場所を、[資格情報ストア] のリストの定義済み資格情報ストアの中から選択します。
7. このアセットに既定値 (アカウントごと/アカウントとマシンごとの固有の値が存在しない場合に使用されます) を設定するかどうかを [グローバル値] のトグルで指定します。
   • 有効化する場合は、アセットに含める内容を [値] フィールドに入力します。アセットがブール型の場合は [True] または [False] を選択します。アセットが資格情報の場合は、[ユーザー名] と [パスワード] を入力します。
   • 無効化する場合は、アカウント固有のアセット値を少なくとも 1 つは指定する必要があります。
8. [ロボットのアセット値を追加] ボタンを使用して、必要なアカウントごとまたはアカウントとマシンごとのアセット値を作成します。
9. [ 作成] を選択します。アセットが作成され、[ アセット ] ページに表示されます。
   注:

   • アセットを作成した後は、アセットの種類は変更できません。
   • グローバル値の Credential アセットまたは Secret アセットを作成する際に、Orchestrator 名と外部名を複数の Orchestrator フォルダー間で同じにすると、それらのアセットは資格情報ストア内の単一のオブジェクトを指します。したがって、いずれかの Orchestrator フォルダーでアセットを変更すると、他の Orchestrator フォルダーにある同じ名前のアセットすべてに影響します。 Orchestrator の複数のフォルダー間で同一の名前を持つ Credential アセットまたは Secret アセットを誤って変更しないようにするには、これらのアセットにフォルダーごとに異なる外部名を使用します。これにより、アセットは資格情報ストア内の異なるオブジェクトを指すようになります。

フィールド	説明
アセット名	ユーザーが設定する名前で、アセットを識別するために役立ちます。 256 文字までです。
入力	アセットの種類です。 次のオプションを使用できます。 Text - 文字列のみを格納できるアセットです。これは既定のオプションです。 Bool: true または false の値のみを格納できるアセットです。このオプションを選択すると、[値] フィールドに2種類のラジオ ボタン ( [True]、[False] ) が表示されます。 Integer: 整数値のみ格納できるアセットです。 Credential: 認証情報を格納するアセットです。 このオプションを選択すると、[値] フィールドが、[ユーザー名] (最大 512 文字) および [パスワード] (最大 25,000 文字) に置換されます。 Secret: API キーなどのシークレットを格納できるアセットです。 [シークレット] フィールドにシークレット値を入力します。シークレットは 25,000 文字以内にする必要があります。 注: 現在、Secret タイプのアセットは、コード化されたエージェントと組み合わせて使用する必要があります。コード化されたエージェントは、<programming language> Agent () の形式で示されます。 現在のところ、基になるパッケージが Studio で作成されたプロセスは、Secret タイプのアセットをサポートしていません。
アクセス スコープ	アセット値にアクセスできる場所を定義します。 この設定を使用すると、アセットをオートメーション ワークフロー内でのみ利用できるようにするか、API や連携を通じても利用できるようにするかを制御できます。次のオプションを次に示します。 オートメーションのみ: アセット値はオートメーション ワークフロー内でのみ使用できます。 オートメーションと API: アセット値には、API や連携を介してプログラムでアクセスすることもできます。
資格情報ストア	Credential アセットまたは Secret アセットを追加する場合にのみ使用できます。 アセットが保存される資格情報ストアです。ネイティブの Orchestrator データベースの場合と、ユーザーが作成した任意の外部ストアの場合があります。 注: 接続されていないプロキシを使用していると、外部資格情報ストアからは Secret タイプのアセットを取得できません。
外部名	Credential アセットまたは Secret アセットを資格情報ストアに追加する場合にのみ使用できます。 資格情報ストアと通信するときに使用されるアセットの名前です。
グローバル値	特定のアセット値 ([ロボットのアセット値を追加] ボタンを使用して定義) が割り当てられているアカウントを除くすべてのアカウントが、グローバル値を持つアセットを受け取ります。 このオプションが有効な場合、アカウントが受け取る値として、次のグローバル値を入力する必要があります。 [Bool] アセットの場合、[True] と [False] の 2 つのラジオ ボタンが表示されます。既定では、[False] が選択されています。 Credential アセットの場合、[ユーザー名] フィールドと [パスワード] フィールドが有効化されます。 これら両方のフィールドに入力する必要があります。 Secret アセットの場合は、[シークレット] フィールドに値を入力する必要があります。 [Text] の場合、このフィールドに入力できる最大文字数は 1,000,000 文字です。
ロボットのアセット値を追加	アカウントごと、またはアカウントとマシンごとに、特定のアセット値を追加できます。 [ グローバル値 ] オプションを使用しない場合は、特定の値を 1 つ以上設定する必要があります。 グローバル値が設定されている場合は、特定の値の追加は任意です。 [Bool] アセットの場合、[True] と [False] の 2 つのラジオ ボタンが表示されます。既定では、[False] が選択されています。 Credential アセットの場合、[ユーザー名] フィールドと [パスワード] フィールドが有効化されます。 これら両方のフィールドに入力する必要があります。 Secret アセットの場合は、[シークレット] フィールドに値を入力する必要があります。 [Text] の場合、このフィールドに入力できる最大文字数は 1,000,000 文字です。

アセットのリンクを管理する

フォルダー間でアセットを共有すると、基になるプロセスが同じアセットをターゲットにしている場合、Studio でワークフローを再設計しなくても、複数のフォルダーでジョブを開始できます。アセットをフォルダーにリンクすると、そのアセットとアセットに関連するすべてのオブジェクト (アセット アイテムなど) をそのフォルダーで使用できるようになります。

重要:

共有できるアセットは、グローバル値を持ち、アカウントごとの固有の値を持たないアセットのみです。アカウントごとの値を持つアセットをフォルダー間で共有することはできません。

注:

複数のフォルダーにリンクされているアセットは、 アイコンを使用してマークされます。アイコンが存在しない場合は、現在のフォルダーがアセットが存在する唯一のフォルダーです。ここで削除すると、アセットは Orchestrator から完全に削除されます。アセットを追加するフォルダー (ターゲット フォルダー) での Assets - Create 権限と、アセットが現在存在するフォルダー (元のフォルダー) での Assets - View 権限が必要です。ターゲット フォルダーに [アセット] - [編集 ] がある場合、元のフォルダーに [アセット] - [編集 ] は必要ありません。アセットがフォルダーに共有されると、移動先のフォルダーに 「アセット - 編集 」を持つユーザーがアセットを編集でき、変更はグローバルに適用されます。

現在のフォルダーに複数のアセットをリンクする

1. アセットをリンクするフォルダーの [ アセット ] ページで [ 追加] を選択します。3 つのボタンが表示され、アセットを追加したり、他のフォルダーのアセットをリンクしたり、オプションを非表示にしたりできます。
2. [ 他のフォルダーからリンク] を選択します。[ アセットをリンク] ウィンドウに、アセットの表示権限を持つフォルダー内のすべてのアセットのリストが表示されます。

図 1. 他のフォルダーのアセットのリンク

3. [アセットを選択] セクションで、リストから 1 つまたは複数のアセットを選択します。
4. [ 続行] を選択します。[フォルダーの検証] セクションに移動します。ここでは、アセットがすでにリンクされているフォルダーを確認できます。複数のフォルダーがある場合は、それらのフォルダーの名前が表示されます。

図 2. フォルダーの検証

5. 変更を元に戻すには、該当するアセットの [ 削除 ] を選択し、操作を取り消すには [ 終了 ] を選択します。
6. 選択したアセットと現在のフォルダーの間にリンクを作成するには、[リンク] を選択します。アセットが [アセット] ページに表示されます。

複数のフォルダーにアセットをリンクする

1. リンクするアセットが存在するフォルダーに移動します。

目的のアセットで [その他のアクション] > [リンクを管理] を選択して、[リンクを管理] ウィンドウを開きます。アセットのリンクの管理ウィンドウが表示されます。

図 3. アセットのリンクの管理

1 - 左側のペインには、アセットの表示権限が付与されたすべてのフォルダーが表示されます。

2 - アセットの現在のステート。アセットが現在置かれているフォルダーの数とその名前を示します。

3 - 左側のペインで選択した内容に従ってアセットが追加されるフォルダーです。

4 - アセットが削除されるフォルダーです。

1. [ 更新] を選択します。確認のウィンドウが表示されます。
2. 変更を中止する場合は [キャンセル] を選択し、変更を反映させる場合は [続行] を選択します。変更内容に応じて、Orchestrator に操作が反映されます。

フォルダーへのアセットのリンクを解除する

フォルダーへのアセットのリンクの解除は、リンク操作とほぼ同じ方法で実行できます。上記の手順のリンク管理領域に移動し、特定のアセットと特定のフォルダー間の接続を削除します。

または、[ 削除 ] 機能を使用してアセットを削除することもできます。アセットの削除を参照してください。

重要:

複数のフォルダーに存在するアセットを削除すると、アセットは削除操作を実行したフォルダーからのみ削除され、他のフォルダーからは削除されません。アセットを完全に削除するには、既存のリンクをすべて削除する必要があります。

アセットの編集

アセットを編集するには、[その他のアクション] > [編集] ボタンをクリックし、必要な変更を加えて、[アセットを更新] ウィンドウで [更新] をクリックします。アセット値と名前のみを編集できます。すべての変更は監査対象となり、[ 監査 ] ページで表示できます。資格情報アセットのユーザー名を変更する場合は、パスワードも変更する必要があります。

ユーザーごとおよびロボットごとのアセット値を削除する

特定のユーザーまたはロボットに対して定義されたアセット値をアセット エディターから直接削除できます。

1. [アセット] を開きます。
2. 新しいアセットを作成するか、既存のアセットを編集します。
3. [アセット値] セクションで、削除する値を選択します。
4. [削除] を選択します。
5. 確認ダイアログで [削除] を選択します。

グリッド ヘッダーの [削除] オプションを使用し、複数のエントリを選択して同時に削除することもできます。

アセットにタグを追加する

注:

アセットに既存のタグを追加するには、アセットに対する [編集] 権限とタグに対する [表示] 権限が必要です。 アセットに新しいタグを追加するには、アセットに対する [編集] 権限とタグに対する [作成] 権限が必要です。

注:

• 各アセットには、最大 100 万個のキー/値のペアを設定できます。
• ラベルおよびキー/値のプロパティに使用できる文字数は、最大 256 文字です。
• タグ名に含められない文字は、 <、 >、 %、 &、 ?、 /、 :です。

アセットへのタグの適用は、アセットの作成時または既存のアセットの編集時に行うことができます。アセットの編集時にアセットにタグを追加するには、以下の手順に従います。

1. [ アセット] ページで、目的のアセットの横にある [ その他のアクション ] > [編集 ] を選択します。アセットが編集用に開きます。
2. [ラベル] フィールドで、ラベル名の入力を開始します。既存のラベルを選択するか、新しいラベルを作成することができます。
3. [ プロパティ (キーと値のペア)] フィールドで、[ 新規追加] を選択します。
4. 新しいキーと値を追加します。既存のキーまたは値を選択するか、新しいキーまたは値を作成することができます。
5. 完了したら、[ 更新] を選択します。アセットが更新され、新しく作成されたタグ (ある場合) が他のオブジェクトで利用できるようになります。

アセットからタグを削除する

アセットからタグを削除するには、以下の手順に従います。

1. [ アセット] ページで、目的のアセットの横にある [ その他のアクション ] > [編集 ] を選択します。アセットが編集用に開きます。
2. [ ラベル] フィールドで、ラベルの名前の横にある [X ] を選択して削除します。ラベルが削除されます。
3. [プロパティ (キーと値のペア)] フィールドで、キーや値の横にある X を選択して削除します。キーや値が削除されます。
4. キーと値のペアを削除するには、次の手順を実行します。 そのエントリに対応する [削除 ] アイコンを選択します。キーと値のペアが削除されます。
5. 完了したら、[ 更新] を選択します。アセットが更新され、タグが削除されます。

アセットを削除する

アセットを削除するには [その他のアクション] > [削除] をクリックします。

または、1つまたは複数のアセットを選択して [削除] ボタンをクリックすることもできます。