📘

注:

このページでは、Studio で使用できるファイルベースのガバナンス モデルについて説明します。Automation Ops からポリシーをデプロイする方法については『UiPath Automation Ops ガイド』をご覧ください。

ガバナンスについて

Studio ユーザーが開発基準に準拠し、特定のルールを遵守するように、組織は Studio の機能をコントロールするガバナンス ポリシーを適用できます。

ガバナンス ポリシーは、次のいずれかの方法で適用できます。

• 使いやすい Web アプリケーションである UiPath Automation Ops からポリシーを作成してデプロイします。
• JSON ポリシー ファイルを作成し、ファイルをローカルまたは外部に、あるいは Orchestrator を介してデプロイする、ファイルベースのガバナンス モデルを使用します。

現在の機能は次のとおりです。

• Studio プロファイルごとに異なるポリシーを適用します。
• restrict usage of package feeds from the Manage Packages window and Backstage View> Settings > Manage Sources.
• enforce organizational development standards using Workflow Analyzer rules.
• enforce design and location settings, and configure several settings that are not available Studio.
• enable sending Studio usage data to your organization.
• enforce the use of specific repositories for GIT source control.

Studio で利用できるガバナンス機能の概要と、StudioX でのガバナンス機能の使用方法については、以下のビデオをご覧ください。

To enforce a governance policy, start by generating a governance file from Studio, then configure the file using the parameters it contains, and apply the policy in one of the following ways:

• Using a local file (for testing purposes) - Place the governance file in the Roaming folder on the machine where Studio is installed.
• Using an external file (for large deployments) - Place the governance file at a path (for example, an HTTP/HTTPS server) referenced by either a registry key or an asset in Orchestrator.
• Using an asset in Orchestrator - Copy the contents of the governance file to an asset in Orchestrator.

ガバナンス ファイルを生成する

組織に開発基準を徹底させる最初の段階として、ガバナンス ファイルを Studio で生成するか、前述の機能のすべてまたは一部を含む同様のファイルを手動で作成します。

🚧

重要

ガバナンス ファイルは、名前が uipath.policies.config の .config の種類である必要があります。

Studio の現在の設定からガバナンス ファイルを生成するには、Backstage ビュー > [ヘルプ] タブに移動して、[ガバナンス ファイルを生成] を選択します。エクスポートしたファイルは、チームで共有できます。

📘

注:

組織に対して Automation Ops が有効化されている場合、クラシック ポリシーとモダン ポリシーのどちらを生成するか選択するよう求められます。ファイルベースのガバナンス モデルの場合は、クラシック オプションを選択します。モダン オプションを選択するとポリシーが生成され、それを Automation Ops にインポートして、そのモデルに簡単に移行することができます。

下記のボタンから、ワークフロー アナライザーのルールを含むサンプルをダウンロードできます。このサンプルを自分の組織のニーズに合わせて変更してください。

サンプルをダウンロード

ガバナンス ファイルを設定する

ファイル バージョンとファイル ラベル

ガバナンス ファイルには、異なるバージョンとカスタム名がある可能性があります。

{
    "Metadata": {
        "Version": "1.0"
                "LastUpdatedUtc": "2021-08-25T07:49:26.3089368Z",
                "Availability": null
    },
    "Info": {
        "Name": "Sample Policy Registry Key"
    }
}

Studio プロファイル

ガバナンス ファイルには、Studio と StudioX のユーザー向けポリシーを含めることができますが、それらのポリシーはプロファイルごとに構成する必要があります。次の例のように、Studio のポリシーを StudioX のポリシーと分けてください。

{
    "Profiles": {
        "Development": {
            "Shell": {
                "IsFeedbackEnabled": true,
                "HideGettingStartedScreen": false
            },
            "PackageManager": {},
            "Analyzer": {}
        },
        "Business": {
            "Shell": {
                "IsFeedbackEnabled": true,
                "HideGettingStartedScreen": false
            },
            "PackageManager": {},
            "Analyzer": {}
        }
    }
}

ユーザーが Studio から構成できない設定

"Shell" パラメーターにより、変更のないプロジェクトをユーザーが実行できる回数の制限を設定し、StudioX からの運用環境での実行を禁止できます。

また、ユーザーがフィードバック フォームやウェルカム画面を使用できるようにするかを設定できます。

{
      "Shell": {
        "IsFeedbackEnabled": true,
        "HideGettingStartedScreen": false,
        "RequireUserPublish": {
          "PermittedConsecutiveRuns": 3,
          "DialogMessage": null,
          "LogToQueue": {
            "QueueName": "NameOfQueue",
            "QueueFolder": "NameOfQueueFolder"
          }
        }
      }
}

1 - 変更は、StudioX プロファイルでのみ有効です。

パッケージ ソースの使用

ガバナンス ファイルを使用して、Studio または StudioX ごとにパッケージ ソースのアクセス、追加、または削除を制限できます。

{
    "PackageManager": {
        "AllowAddRemoveFeeds": false,
        "AllowEnableDisableFeeds": false,
        "AllowOrchestratorFeeds": true,
        "Feeds": [{
                "Name": "Organization Internal Feed",
                "Source": "https://[company].pkgs.visualstudio.com/_packaging/nuget-packages/nuget/v3/index.json",
                "IsEnabled": true
            },
            {
                "Name": "Official",
                "Source": "https://uipath.pkgs.visualstudio.com/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json",
                "IsEnabled": true
            }
        ]
    }
}

パラメーター "AllowAddRemoveFeeds" と "AllowEnableDisableFeeds" を true に設定すると、ユーザーがパッケージ マネージャーで提供されるフィードを変更できるようになります。加えた変更は、Studio を再起動しても保持されます。

"AllowOrchestratorFeeds" パラメーターが true に設定され、ロボットが Orchestrator に接続されている場合、ユーザーは既定の Orchestrator フィードを無効化できません。

ガバナンス ファイルに定義されたフィードは、[パッケージを管理] ウィンドウの [既定のパッケージ ソース] セクションに追加され、ユーザーは [ユーザー定義のパッケージ ソース] セクションにカスタム フィードを追加できます (ガバナンス ファイル内で必要な権限を与えられている場合)。

ユーザー単位のインストールのローカル フィードへのパスは C:\Users\CurrentUser\AppData\Local\Programs\UiPath\Studio\Packages です。

アクティビティ パネルの設定 (StudioX のみ)

ActivitiesManager パラメーターでは、StudioX で特定のアクティビティを非表示にし、[開発者向けアクティビティを表示] フィルターの使用を強制できます。

"ActivitiesManager": {
        "AllowShowDeveloper": false,
        "HiddenActivities": ["UiPath.Mail.Activities.Business.GmailApplicationCard","UiPath.Mail.Activities.Business.OutlookApplicationCard"]

}

テンプレート フィード

TemplatesManager にある設定では、組織でどのテンプレート フィードを有効化または無効化するかを適用できます。

"TemplatesManager": {
        "Feeds": [
          {
            "Name": "GettingStarted",
            "IsEnabled": true
          },
          {
            "Name": "Official",
            "IsEnabled": true
          },
          {
            "Name": "Marketplace",
            "IsEnabled": true
          }
        ]

ソース管理設定

"SourceControl" パラメーターでは、Git を使用するとき、および変更をパブリッシュ前にコミットするときに、許可されたリポジトリの使用を強制できます。

{
      "SourceControl": {
        "CheckInBeforePublishParam": {
          "AllowEdit": false,
          "Value": false
        },
       "RepositoriesConfigParam": {
          "AllowEdit": true,
          "Value": {
            "AllowSaveLocal": null,
            "AllowEditRepositories": null,
            "Repositories": [
              {
                "SourceControlType": 0,
                "Name": null,
                "Url": null,
                "DefaultFolder": null
              }
            ]
          }
       
}

"AllowEdit" パラメーターでは、ガバナンス ファイルによる既定の設定の変更をユーザーに許可するかどうかを指定します。

1 - 変更は、StudioX プロファイルでのみ有効です。

Studio の設定

The following parameters enable you to configure settings found in Home (Studio Backstage View) > Settings. For more information, see Configuring Studio Settings.

{
      "Workflow": {
        "DefaultProjectLanguageParam": {
          "Value": VisualBasic,
          "AllowEdit": false
        },
        "DefaultProjectFrameworkParam": {
          "Value": "Classic",
          "AllowEdit": true
        },          
        "AllowedProjectFrameworks": {
          "Classic": true,
          "Modern": true,
          "CrossPlatform": true
        },
        "DockedAnnotationsParam": {
          "AllowEdit": false,
          "Value": true
        },
        "ShowDataManagerOnlyParam": {
          "AllowEdit": true,
          "Value": false
        },
        "IsCollapsedViewSlimParam": {
          "AllowEdit": false,
          "Value": false
        },
        "UseSmartFilePathsParam": {
          "AllowEdit": true,
          "Value": true
        },
        "EnableLineNumberingParam": {
          "AllowEdit": true,
          "Value": true
        },
        "EnableActivityOnlineRecommendationsParam": {
          "AllowEdit": true,
          "Value": true
        },
        "EnforceReleaseNotes": null,
        "DisplayLegacyFrameworkDeprecation": true,
        "AnalyzeOnPublishParam": {
          "AllowEdit": false,
          "Value": false
        },
        "AnalyzeOnPushParam": {
          "AllowEdit": true,
          "Value": false
        },
        "AnalyzeOnRunParam": {
          "AllowEdit": false,
          "Value": false
        },
        "AnalyzeRpaXamlsOnlyParam": {
          "AllowEdit": false,
          "Value": false
        },
        "AdditionalAnalyzerRulePathParam": {
          "AllowEdit": false,
          "Value": null
        },
        "DefaultProjectFolderParam": {
          "AllowEdit": false,
          "Value": null
        },
        "DefaultProcessPublishUrlParam": {
          "AllowEdit": false,
          "Value": null
        },
        "DefaultLibraryPublishUrlParam": {
          "AllowEdit": false,
          "Value": null
        },
        "DefaultTemplatePublishUrlParam": {
          "AllowEdit": false,
          "Value": "C:\\Users\\username\\Documents\\UiPath\\.templates"
        },
        "DefaultPipTypeParam": {
          "Value": "ChildSession",
          "AllowEdit": true
        },
        "ModernBehaviorParam": {
          "AllowEdit": false,
          "Value": false
        },
        "ObjectRepositoryEnforcedParam": {
          "AllowEdit": false,
          "Value": false
        },
        "UseConnectionServiceParam": {
          "AllowEdit": true,
          "Value": false
        },
        "PlatformAutoUpdateIntervalDaysParam": {
          "AllowEdit": true,
          "Value": 7
        },
        "HideSequencesParam": {
          "AllowEdit": true,
          "Value": true
        },
        "AllowedPublishFeeds": {
          "Custom": true,
          "PersonalWorkspace": true,
          "TenantPackages": true,
          "FolderPackages": true,
          "HostLibraries": true,
          "TenantLibraries": true,
          "Local": true
        }
      },
}

ほとんどのオプションで以下の 2 つのパラメーターを利用できます。

• "AllowEdit" - ガバナンス ファイルによる既定の設定 (true: 許可、false: 拒否) の変更をユーザーに許可するかどうかを指定します。
• "Value" - 以下の表に示すように、既定の設定を指定します。

"Workflow" の内容:

1 - 変更は、Studio プロファイルでのみ有効です。
2 - 変更は、StudioX プロファイルでのみ有効です。

"ObjectBrowser" の下:

Studio の使用状況データを組織に送信する

"Telemetry" 下のパラメーターにより、Studio の使用状況のデータをお使いの Azure ポータルの Application Insights リソースに送信できます。このデータを使用して、ユーザーが Studio で何をしているかを監視して分析することができます。この機能を有効化するには、"instrumentation-keys" パラメーターにお使いの Application Insights インスタンスのインストルメンテーション キーを入力します。

{
       "Telemetry": {
        "TelemetryOptions": {
          "TelemetryOptionsDictonary": {
            "instrumentation-keys": ""
        }
      }
   }
}

Application Insights に送信されるテレメトリ データについては、以下の表をご覧ください。

1 - プロジェクトの作成時、ユーザーが Studio の Backstage ビューで新しいプロジェクトの作成を選択すると NewProject が生成され、ユーザーが新しいプロジェクトの作成ダイアログで [作成] ボタンをクリックすると NewProjectCreated が生成されます。
2 - StartDebug イベントは、操作を実行した対象のロボットを追跡します。対象のロボットはローカル ロボット (Local) またはリモート ロボット (Unattended ロボット接続の場合は Orchestrator、リモート マシン接続の場合は Remote) です。

Application Insights のデータを使用する

In addition to the use case scenarios described in the official Microsoft documentation, you can test and build queries using Log Analytics in the Azure Monitor of your Azure Insights instance. To see all possible data for an event, you can build a simple query that will explore all its occurrences in the predefined time range. For example:

customEvents
| where name == "StudioStarted"

See the following table for examples of telemetry queries and a description for each one. You can also check the list of known issues.

以下の表には、イベントに既定で含まれるその他のパラメーターが記載されています。

Log Analytics では、前述のパラメーターの一部である各データ型を明示的に拡張して、フィルターとして使用したり、追加の要約要素として使用したりできます。これを行うには、ログ内のデータ要素の横にある 3 点リーダー メニューのアイコンをクリックし、データを拡張するかフィルターとして使用するかを選択します。

データの拡張またはフィルター処理の例は、次の表をご覧ください。

既知の問題

• PublishProject イベントでは、Orchestrator にパブリッシュされたプロジェクトの詳細のみが表示されます。
• S.Activities.ActivityAdded イベントに誤ったパッケージ バージョンが表示されます。

ワークフロー アナライザーのルール

ワークフロー アナライザーは、プロジェクトが開発基準を満たしているかどうかを検証するツールです。組織はガバナンス ファイルを使用することで、ニーズに沿ったカスタム ルールをすべてのプロジェクトに一元的に適用できます。

備考

• カスタム ルールセットは、.json の別ファイルとしてあらかじめ定義でき、dll 外部アセンブリまたはカスタム アクティビティ パッケージを介して提供できます。ワークフロー アナライザーのカスタム ルールの作成について、詳細を確認してください。
• ガバナンス ファイルは資格情報を提供できません。つまり、セキュリティを確保したフィードには対応していないということです。
• カスタム ルールセットを適用した場合、ユーザーはワークフロー アナライザーのルールを一切変更できなくなります。
• カスタム ルールセットがガバナンス ファイルで参照されていない場合、またはガバナンス ファイルに組み込まれていない場合、ワークフロー アナライザーの既定のルールが適用されます。"Analyzer" セクションの記述が存在しない場合、ワークフロー アナライザー向けのガバナンスは適用されません。このセクションが記述されている場合は、中身が空でも、Studio でのルール管理が無効化されます。
• ガバナンスを適用すると、Studio または UiPath アクティビティ パッケージの組み込みルールは、ガバナンス ファイルまたはカスタム ルールセットに特に記述のないかぎり、既定で無効になります。

ルールの適用

uipath.policies.config ガバナンス ファイルのカスタム ルールセットを管理する方法には、次の 2 種類があります。

1. 以下のパスのいずれか 1 つに置かれたルールセットを参照します。

• ローカル マシン
• ネットワーク サーバーまたはマシンの共有パス - UNC パスで識別可能
• 共有 BLOB ストレージ - http(s) パスで識別可能

2. カスタム ルールセットを埋め込みます。ルールを有効化または無効化し、それらの ID、パラメーター、エラー レベルを記述します。

すべてのカスタム ルールを "Analyzer" セクションで参照するか、同セクションに追加する必要があります。また、下図のようにルールとカウンターは、それぞれのセクションに分けて記述しなければなりません。

{
    "Analyzer": {
    "AllowEdit": false,
        "ReferencedRulesConfigFile": null,
        "EmbeddedRulesConfig": {
            "Rules": [
        {
                    "Id": "ST-NMG-001",
                    "IsEnabled": false,
                    "Parameters": [{
                        "Name": "Regex",
                        "Value": null
                    }],
                    "ErrorLevel": "Error"
                }
            ],
            "Counters": [{
                "Id": "ST-ANA-009",
                "IsEnabled": true,
                "Parameters": []
            }]
        }
    }
}

1 - カウンターにはパラメーターがないため、[] を使用します。

"AllowEdit" パラメーターを true に設定した場合、ユーザーは、[ワークフロー アナライザーの設定] ウィンドウに表示されるルールを変更できます。加えた変更は、Studio を再起動しても保持されます。

ガバナンス ポリシーを適用する

📘

注:

Automation Ops を使用してポリシーを設定し、デプロイすることをお勧めします。Studio から生成されたガバナンス ファイルからポリシーを作成する方法について詳しくは、『Automation Ops ガイド』の「ガバナンス ポリシーを作成する」をご覧ください。

ローカル ファイルを使用する

ローカルに保存する場合、ガバナンス ファイルはパス %AppData%\UiPath に置く必要があります。

外部ファイルを使用する

外部に保存する場合、ポリシー ファイルへのパスは、Windows レジストリまたは Orchestrator のアセットを使用して定義する必要があります。

Windows レジストリを使用してファイル パスを定義する

1. Studio がインストールされているマシンでレジストリ エディターを開きます。
2. 次のレジストリ キーを検索し、Enter キーを押します。Computer\HKEY_CURRENT_USER\Software\UiPath
3. レジストリ エディターで右クリックして、[新規] > [文字列値] を選択します。新しい [値の名前] として GovernanceSource を入力します。他の名前は使用しないでください。
4. 編集するために GovernanceSource という文字列をダブルクリックします。[値のデータ] フィールドに uipath.policies.config ファイルへのパスを入力して、[OK] をクリックします。
   • If the policy file is stored locally, an example for this field would be C:\policies\uipath.policies.config.
   • If the policy file is stored on a server, an example for this field would be 192.168.1.1\policies\uipath.policies.config.

レジストリ キーは次のようになるはずです。

Orchestrator アセットを使用してファイル パスを定義する

1. Orchestrator で [テナント] > [フォルダー] を選択し、uipath.settings.config という名前の新しいフォルダーを追加します。
2. ガバナンス ポリシーを適用するユーザーをフォルダーに割り当てます。
3. uipath.settings.config フォルダーで新しいアセットを作成し、次のように設定します。
   • アセット名 - uipath.studio.governancesource
   • 種類 - テキスト
   • グローバル値 - このオプションを選択し、uipath.policies.config ファイルへのフル パスをテキスト ボックスに入力します。
     必要に応じて、ユーザー単位で異なるファイル パスを含む値を追加して、ユーザーごとに別々のポリシーを適用できます。

Orchestrator のアセットを使用する

1. Orchestrator で [テナント] > [フォルダー] を選択し、uipath.settings.config という名前の新しいフォルダーを追加します。
2. ガバナンス ポリシーを適用するユーザーをフォルダーに割り当てます。
3. uipath.settings.config フォルダーで新しいアセットを作成し、次のように設定します。
   • アセット名 - uipath.studio.governancepolicy
   • 種類 - テキスト
   • グローバル値 - このオプションを選択し、uipath.policies.config ファイルの内容全体をテキスト ボックスに貼り付けます。
     必要に応じて、ユーザー単位の値を追加し、さまざまなパラメーターを貼り付けて、ユーザーごとに別々のポリシーを適用できます。

📘

注:

ファイル パスを参照する、またはファイルの内容を保持する Orchestrator のアセットを使用してガバナンス ポリシーを適用するには、モダン フォルダーを使用する v2020.10 以降の Orchestrator が必要です。

適用と優先順位

ポリシーを定義すると、Studio を再起動した後に適用されます。

メッセージが、[ワークフロー アナライザー] の設定ウィンドウ、[フィードバックを送る] ウィンドウ、Backstage ビューの [設定] タブ、および [パッケージを管理] ウィンドウに表示されます。

Studio は、次の優先順位を使用してガバナンス ポリシーを適用します。Automation Ops > uipath.studio.governancepolicy > uipath.studio.governancesource > レジストリ キー > ローカル ファイル

ユーザーに対してガバナンス ポリシーが削除された場合、ガバナンス ファイルによって適用されていた設定は、既定として保持されます。ただし、ユーザーは、ガバナンス ポリシーが設定されていたときには制限されていた設定を変更できるようになります。