Verwalten von Assets in Orchestrator

Erstellen und verwalten Sie Assets in Orchestrator, einschließlich Anmeldeinformationen, Textwerten und anderer gemeinsam genutzter Ressourcen für die Automatisierungsnutzung.

Erstellung von Assets

1. On the Assets page, select Add asset, then select Create a new asset. The Add Asset page is displayed.
2. In das Feld Asset-Namegeben Sie einen Namen für das Asset ein.
3. In the Description field, enter what the asset is used for.
4. Aus der Liste Typ (Type) wählen Sie den Typ des Assets aus, das Sie erstellen möchten.
   • For credential or secret assets, from the Credential Store list, select where the asset is stored.
   • For Object (define properties) assets, in the Schema section, select Add property to define the properties of the object.
5. To let external apps and integrations read the asset value through the Orchestrator API, turn on Expose value to API. Automations can always read the asset.
6. In the Global value & overrides section, enter the global value in the Global row. All accounts without an override receive this value.
   • To enter the value in a side panel, select Edit global value, enter the value, then select Done.
   • To create the asset without a global value, turn off the toggle in the Global row. In this case, you must add at least one override.
7. To add a value for a specific account or account-machine pair, select Add override. The New override panel is displayed.
   1. Under Applies to, select In current folder to pick a user assigned to the folder, or In identity directory to pick a user from the identity directory.
   2. From the Account list, select the account.
   3. From the Machine list, keep Any machine, or select a specific machine.
   4. Enter the value, then select Done.
8. Select Create asset.

The asset is created and displayed on the Assets page.

Hinweis:

• Sobald ein Asset erstellt wurde, können Sie den Asset-Typ nicht mehr ändern.
• Wenn Sie globale Zugangsdaten oder geheime Assets mit demselben Orchestrator-Namen und demselben externen Namen in mehreren Orchestrator-Ordnern erstellen, verweisen diese Assets auf ein einziges Objekt im Schlüsseltresor. Daher wirkt sich jede Änderung, die Sie an dem Asset in einem der Orchestrator-Ordner vornehmen, auf alle identisch benannten Assets in den anderen Orchestrator-Ordnern aus. Um versehentliche Änderungen an gleichnamigen Zugangsdaten oder geheimen Assets in verschiedenen Orchestrator-Ordnern zu vermeiden, verwenden Sie bitte in jedem Ordner einen anderen externen Namen für das Asset. Dadurch wird sichergestellt, dass die Assets auf verschiedene Objekte im Schlüsseltresor verweisen.

Feld	Beschreibung
Assetname	Ein benutzerdefinierter Name für das Asset, damit Sie dieses leichter identifizieren können. 256 Zeichen dürfen nicht überschritten werden.
Typ	Der Typ des Assets. The following options are available, grouped as Primitive, Secure, and JSON: Text : Assets, die Stringwerte speichern können. Dies ist die Standardoption. Bool : Assets, die einen Wahr- oder Falschwert speichern können. Wenn Sie diese Option wählen, werden im Feld Wert zwei Optionsfelder angezeigt ( Wahr , Falsch ). Integer: Assets können ganzzahlige Werte speichern. Zugangsdaten : Assets können Zugangsdaten speichern. Wenn Sie diese Option wählen, wird das Feld Wert durch zwei andere Werte ersetzt: Benutzername, das auf 512 Zeichen begrenzt ist, und Passwort, das auf 25.000 Zeichen begrenzt ist. Geheimnis : Assets, die geheime Daten speichern können, wie z. B. API-Schlüssel. Geben Sie den geheimen Wert im Feld Geheimnis ein Das Feld „Geheimnis“ ist auf 25.000 Zeichen begrenzt. Hinweis: Derzeit können Sie geheime Assets nur in Verbindung mit codierten Agents verwenden, die als Agent () gekennzeichnet<programming language> sind. Zurzeit unterstützt kein Prozesstyp mit einem von Studio erstellten zugrundeliegenden Paket geheime Assets. JSON : assets that can store structured JSON data. The following JSON types are available: Object (define properties) , Array of strings , Number (Float) , DateTime , Email , URL , Regex , and Any . For Object (define properties) assets, you define the properties of the object in the Schema section.
Expose value to API	Defines whether the asset value can also be read outside automations. Automations can always read the asset. Off: only automations can read the asset value. This is the default option. On: external apps and integrations can also read the asset value through the Orchestrator API.
Anmeldeinformationsspeicher	Nur verfügbar, wenn Zugangsdaten oder geheime Assets hinzugefügt werden. Der Anmeldeinformationsspeicher, in dem das Asset gespeichert wird. Das kann die native Orchestrator-Datenbank oder einer Ihrer erstellten externen Speicher sein. Hinweis: Sie können keine geheimen Assets aus einem externen Schlüsseltresor abrufen, wenn Sie einen nicht verbundenen Proxy verwenden.
Externer Name	Nur verfügbar, wenn Zugangsdaten oder geheime Assets einem Schlüsseltresor hinzugefügt werden. Der Name des Assets, der bei der Kommunikation mit dem Anmeldeinformationsspeicher verwendet werden soll.
Global value	The value received by all accounts, except those with an override (defined using the Add override button). Enter it in the Global row of the Global value & overrides section, or select Edit global value to enter it in a side panel. To create the asset without a global value, turn off the toggle in the Global row. When the global value is turned on, you must enter the value that is received by accounts: Für Bool-Assets werden die beiden Optionsfelder True und False angezeigt. Standardmäßig ist False ausgewählt. Für Assets des Typs Zugangsdaten sind die Felder Benutzername und Passwort aktiviert. Sie müssen in beiden Feldern etwas eintragen. Bei Assets des Typs Geheimnis müssen Sie einen Wert in das Feld Geheimnis eintragen. Für Text-Assets sind in diesem Feld bis zu 1.000.000 Zeichen zulässig.
Add override	Ermöglicht Ihnen das Hinzufügen bestimmter Asset-Werte pro Konto oder pro Konto-Maschine. In the New override panel, select whether the account is In current folder or In identity directory, then select the Account and, optionally, the Machine. When the global value is turned off, you must configure at least one override. If a global value is provided, adding overrides is optional. Für Bool-Assets werden die beiden Optionsfelder True und False angezeigt. Standardmäßig ist False ausgewählt. Für Assets des Typs Zugangsdaten sind die Felder Benutzername und Passwort aktiviert. Sie müssen in beiden Feldern etwas eintragen. Bei Assets des Typs Geheimnis müssen Sie einen Wert in das Feld Geheimnis eintragen. Für Text-Assets sind in diesem Feld bis zu 1.000.000 Zeichen zulässig.

Verwalten von Asset-Verknüpfungen

Durch die Freigabe von Assets zwischen Ordnern können Aufträge in mehreren Ordnern gestartet werden, ohne Ihre Workflows in Studio anpassen zu müssen, wenn die zugrundeliegenden Prozesse auf das gleiche Asset abzielen. Wenn Sie ein Asset mit einem Ordner verknüpfen, werden das Asset und alle Asset-bezogenen Objekte, z. B. Asset-Elemente, in diesem Ordner verfügbar.

Wichtig:

Sie können nur Assets mit globalen Werten und ohne spezifischen Wert pro Konto freigeben. Sie können Assets mit Werten pro Konto nicht zwischen Ordnern freigeben.

Hinweis:

Ein Asset, das mit mehreren Ordnern verknüpft ist, wird mit der Symbol klicken. Wenn das Symbol nicht vorhanden ist, ist der aktuelle Ordner der einzige Ordner, in dem sich das Asset befindet. Wenn Sie es hier löschen, wird das Asset vollständig aus dem Orchestrator entfernt. Sie benötigen die Berechtigungen Assets – Erstellen in den Ordnern, in denen Sie das Asset hinzufügen möchten (Zielordner), sowie Assets – Anzeigen in dem Ordner, in dem sich das Asset derzeit befindet (ursprünglicher Ordner). Wenn Sie Assets – Bearbeiten für den Zielordner haben, benötigen Sie Assets – Bearbeiten für den Originalordner nicht mehr. Sobald ein Asset für einen Ordner freigegeben wurde, können Benutzer mit Assets – Bearbeiten für den Zielordner das Asset bearbeiten, und die Änderungen werden global übernommen.

Verknüpfen mehrerer Assets mit dem aktuellen Ordner

1. Wählen Sie in dem Ordner, mit dem Sie ein Asset verknüpfen möchten, auf der Seite Assets die Option Hinzufügen aus. Es werden drei Schaltflächen angezeigt, mit denen Sie ein Asset hinzufügen, Assets aus anderen Ordnern verknüpfen oder die Optionen ausblenden können.
2. Wählen Sie Aus anderen Ordnern verknüpfen. Das Fenster Assets verknüpfen wird mit einer Liste aller Assets in den Ordnern angezeigt, in denen Sie Berechtigungen zum Anzeigen von Assets haben.

Abbildung 1. Verknüpfen von Assets aus anderen Ordnern

3. Wählen Sie im Abschnitt Assets auswählen ein oder mehrere Assets von der Liste aus.
4. Wählen Sie die Schaltfläche zum Fortfahren aus. Sie werden zum Abschnitt Ordnervalidierung weitergeleitet. Hier sehen Sie die Ordner, mit denen die Assets bereits verknüpft sind. Bei mehreren Ordnern wird deren Name angezeigt.

Abbildung 2. Validierung eines Ordners

5. Wählen Sie für das entsprechende Asset Entfernen , um die Änderung rückgängig zu machen, oder Beenden wählen, um den Vorgang abzubrechen.
6. Wählen Sie Verknüpfen, wenn Sie die Verknüpfung zwischen den ausgewählten Assets und dem aktuellen Ordner erstellen möchten. Die Assets werden auf der Seite Assets angezeigt.

Verknüpfen eines Assets mit mehreren Ordnern

1. Navigieren Sie zu dem Ordner, in dem sich das zu verknüpfende Asset befindet.

Wählen Sie für das gewünschte Asset Weitere Aktionen > Verknüpfungen verwalten, um das Fenster Verknüpfungen verwalten zu öffnen. Das Fenster Assetverknüpfungen verwalten wird angezeigt.

Abbildung 3. Verwalten von Assetverknüpfungen

1 – Der linke Bereich zeigt alle Ordner an, für die Sie die Berechtigung Anzeigen für Assets erhalten haben.

2 – Der aktuelle Status des Assets mit der Anzahl der Ordner, in denen es sich derzeit befindet, sowie deren Namen.

3. Die Ordner, in die das Asset entsprechend Ihrer Auswahl im linken Bereich eingefügt werden soll.

4. Die Ordner, aus denen das Asset entfernt wird.

1. Wählen Sie Aktualisieren. Ein Bestätigungsfenster wird angezeigt.
2. Wählen Sie Abbrechen, wenn Sie die Änderungen abbrechen möchten, oder Fortfahren, ´damit die Änderungen übernommen werden. Die Vorgänge werden jetzt gemäß Ihren Änderungen in Orchestrator widergespiegelt.

Aufheben der Verknüpfung von Assets mit Ordnern

Das Aufheben der Verknüpfung von Assets mit Ordnern erfolgt auf ähnliche Weise wie das Verknüpfen. Navigieren Sie zu den in den oben beschriebenen Verfahren genannten Bereichen für die Verknüpfungsverwaltung und entfernen Sie die Verbindungen zwischen einem bestimmten Asset und einem bestimmten Ordner.

Alternativ können Sie die Funktion Entfernen verwenden, um ein Asset zu entfernen. Siehe Entfernen eines Assets.

Wichtig:

Wenn Sie ein Asset entfernen, das in mehreren Ordnern vorhanden ist, wird es nur aus dem Ordner entfernt, in dem der Entfernungsvorgang ausgeführt wird. Es wird dadurch nicht auch aus den anderen Ordnern entfernt. Um ein Asset vollständig zu löschen, müssen Sie alle seine vorhandenen Verknüpfungen entfernen.

Bearbeiten von Assets

Um ein Asset zu bearbeiten, klicken Sie auf Weitere Aktionen > Bearbeiten , nehmen Sie die erforderlichen Änderungen vor und klicken Sie im Fenster Asset aktualisieren auf Aktualisieren . Nur der Asset-Wert und der Name können bearbeitet werden. Alle Änderungen werden geprüft und können auf der Seite Prüfung angezeigt werden. Wenn Sie den Benutzernamen eines Anmeldeinformations-Assets ändern, müssen Sie auch das Kennwort ändern.

Asset-Werte pro Benutzer und pro Roboter entfernen

Sie können für bestimmte Benutzer oder Roboter definierte Asset-Werte direkt im Asset-Editor entfernen.

1. Öffnen Sie Assets.
2. Erstellen Sie ein neues Asset oder bearbeiten Sie ein vorhandenes Asset.
3. Wählen Sie im Abschnitt Asset-Wert den Wert aus, den Sie entfernen möchten.
4. Wählen Sie Entfernen aus.
5. Wählen Sie im Bestätigungsdialogfeld Löschen aus.

Sie können auch mehrere Einträge auswählen und sie gleichzeitig mit der Option Entfernen im Grid-Header entfernen.

Hinzufügen von Tags zu Assets

Hinweis:

Sie benötigen die Berechtigungen Bearbeiten für Assets und Anzeigen für Tags, um vorhandene Tags zu Assets hinzuzufügen. Sie benötigen die Berechtigungen Bearbeiten für Assets und Erstellen für Tags, um neue Tags zu Assets hinzuzufügen.

Hinweis:

• Jedes Asset kann maximal eine Million Schlüssel-/Wertpaare haben.
• Beschriftungen und Schlüssel-/Werteigenschaften sind auf 256 Zeichen begrenzt.
• Tag-Namen dürfen diese Zeichen nicht enthalten: <, >, %, &, , ?, /, :.

Sie können einem Asset Tags zuweisen, wenn Sie ein Asset erstellen oder ein bestehendes bearbeiten. Führen Sie die folgenden Schritte aus, um einem Asset beim Bearbeiten Tags hinzuzufügen:

1. Wählen Sie auf der Seite Assets neben dem gewünschten Asset Weitere Aktionen > Bearbeiten . Das Asset wird zur Bearbeitung geöffnet.
2. Geben Sie in das Feld Beschriftungen den Namen der Beschriftung ein. Sie können eine vorhandene Beschriftung auswählen oder eine neue erstellen.
3. Wählen Sie im Feld Eigenschaften (Schlüssel-Wert-Paare) die Option Neue hinzufügen aus.
4. Fügen Sie neue Schlüssel und Werte hinzu. Sie können vorhandene Schlüssel und/oder Werte auswählen oder neue erstellen.
5. Wenn Sie fertig sind, wählen Sie Aktualisieren aus. Ihr Asset wird aktualisiert und die neu erstellten Tags werden, falls vorhanden, für andere Objekte verfügbar.

Entfernen von Tags von Assets

Führen Sie die folgenden Schritte aus, um Tags von einem Asset zu entfernen:

1. Wählen Sie auf der Seite Assets neben dem gewünschten Asset Weitere Aktionen > Bearbeiten . Das Asset wird zur Bearbeitung geöffnet.
2. Wählen Sie im Feld Beschriftungen die X-Taste neben dem Namen der Beschriftung aus, um sie zu entfernen. Die Beschriftung wird entfernt.
3. Wählen Sie im Feld „Eigenschaften“ (Schlüssel-Wert-Paare) das X neben den Schlüsseln und/oder Werten aus, um sie zu entfernen. Die Schlüssel und/oder Werte werden entfernt.
4. Zum Löschen eines Schlüssel-/Wertepaars wählen Sie das Symbol Entfernen für den jeweiligen Eintrag. Das Schlüssel/Wert-Paar wird entfernt.
5. Wenn Sie fertig sind, wählen Sie Aktualisieren aus. Ihr Asset wird aktualisiert und die Tags wurden entfernt.

Entfernen von Assets

To remove an asset, click More Actions > Remove.

Alternativ können Sie ein oder mehrere Assets auswählen und auf die Schaltfläche Entfernen (Remove) klicken.