Orchestrator でアセットを管理する

アセットを作成する

1. [アセット] ページで、[追加] を選択します。[アセットを追加] ウィンドウが表示されます。
2. [アセット名] フィールドに、アセットの名前を入力します。
3. Type のリストから、作成するセットの種類を選択します。
4. アセットの説明を追加します。
5. Select the desired access scope from the Access scope section.
   • Automations only: allows asset values to be retrieved exclusively within automation related contexts.
   • Automations and API: allows asset values to be retrieved programatically via APIs and integrations, without requiring an automation context.
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 タイプのアセットをサポートしていません。
Access scope	Defines where the asset value can be accessed from. Use this setting to control whether the asset is available only within automation workflows or also through APIs and integrations. The following options are: Automations only: the asset value can be used only within automation workflows. Automations and API: the asset value can also be accessed programmatically through APIs and integrations.
資格情報ストア	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 でワークフローを再設計しなくても、複数のフォルダーでジョブを開始できます。アセットをフォルダーにリンクすると、そのアセットとアセットに関連するすべてのオブジェクト (アセット アイテムなど) をそのフォルダーで使用できるようになります。

重要:

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

注:

An asset linked to multiple folders is marked using the icon. If the icon is not present, then the current folder is the only folder the asset resides in. Deleting it here completely removes the asset from Orchestrator. You need the Assets - Create permission in the folders where you want to add the asset (target folders) and Assets - View in the folder where the asset currently resides (original folder). If you have Assets - Edit in the target folder, you do not need Assets - Edit in the original folder. Once an asset is shared to a folder, users with Assets - Edit in the destination folder can edit the asset, and the changes will apply globally.

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

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つまたは複数のアセットを選択して [削除] ボタンをクリックすることもできます。