ソース管理

ソース管理を使用すると、オートメーション プロジェクトのソース コードの更新を表示できます。このためには、通常のユーザーの場合は外部プロバイダーを使用し、組織管理者の場合は UiPath Cloud で Studio Web を使用します。Studio および StudioX のソース管理機能と共に使用すると、コード管理をより詳細に制御できます。

外部リポジトリの前提条件

• 少なくとも 1 つの組織と 1 つのリポジトリを持つ GitHub または Azure DevOps アカウント。
• UiPath Automation Ops アプリにリポジトリへのアクセス権を付与する権限。GitHub の組織管理者であるか、少なくとも 1 つのリポジトリの管理者である必要があります。Azure の場合は、ユーザーがアクセスできるリポジトリが接続されます。

注:

Azure Repos との連携は現在プレビュー段階であるため、特定の機能が利用できない可能性があります。

構成

情報を管理するには、Automation Ops™ が GitHub または Azure の組織に接続する必要があります。 それには、GitHub または Azure 側に UiPath-AutomationOps アプリをインストールします。 ステップ バイ ステップのガイドもユーザー インターフェイスで利用できます。

手順 1: Automation Ops™ から接続を開始する

ソース管理 > Automation Ops™ にアクセスし、[ GitHub に接続 ] または [ Azure に接続 ] をクリックします。

手順 2.a: GitHub 用の Automation Ops™ アプリをインストールして認可する

GitHub への接続を選択すると、Automation Ops がアクセスできるようにする組織とリポジトリを選択するよう、GitHub にリダイレクトされます™。

注:

GitHub 組織が SSO ログインを使用している場合は、まず GitHub にサインインする必要があります。 その後、ソース管理を介してGitHubアプリをインストールできます。 これは次のように実行できます。

• Enterprise Managed Users - IdP を使用して GitHub にログインする必要があります。

• ユーザーは、次の場所でSSOログインセッションを設定できます https://github.com/orgs/<OrganizationName>/sso

選択した項目に応じて、Automation Ops™ の [ソース管理] に次のリポジトリが表示されます。

GitHub ロール	選択	結果
GitHub 組織管理者	All repositories	すべてのパブリック リポジトリとプライベート リポジトリ。
GitHub 組織管理者	Only select repositories	選択したリポジトリのみが表示されます (既定では、すべての公開されているリポジトリが表示されるわけではありません)。
Repository administrator only	Only select repositories	管理者が管理するリポジトリからしか選択できません。

注: GitHub リポジトリ リストは、後からいつでも更新できます。

Automation Ops™ - ソース管理を GitHub に接続する際に、ソース管理とパイプラインを完全に使用するために必要な権限を付与するよう求められます。 必要な権限は、以下のとおりです。

• コードとメタデータへの読み取りアクセス

• リポジトリの Webhook への読み取り/書き込みアクセス権

重要:

• GitHub への接続には GitHub 管理者の認証が必要です。つまり、Automation Ops™ の [ソース管理] から接続を開始するユーザーは、GitHub の組織管理者でもなければなりません。
• リポジトリを手動で選択する場合は、パブリック リポジトリも明示的に選択する必要があります。手動で選択したリポジトリにはパブリック リポジトリが暗黙的に選択されないためです。

別の GitHub 組織に接続する必要がある場合、または別のリポジトリを選択する必要がある場合は、既存の接続を削除して設定を再実行する必要があります。この操作は、[接続の設定] メニュー > [削除] から実行します。

UiPath で接続を削除すると、GitHub 側にインストールされているアプリも削除されます。

手順 2.b: Azure リポジトリの Automation Ops™ アプリをインストールして認可する

Azure への接続を選択すると、Azure にリダイレクトされるので、資格情報を入力し、アクセス権のあるリポジトリの読み込みを UiPath に許可することを確認します。

Azure 側で UiPath アプリへのアクセス権を付与するために、別のサービス アカウントを作成して使用することをお勧めします。 これは、ユーザー アカウントに代わってアクセス権が付与されるためです。つまり、ユーザーが OAuth が有効化された複数の Azure 組織に属している場合、それらのすべてが Automation Ops™ に反映されます。

プロジェクトを同期するには、Azure の組織設定レベルで、 OAuth を介したサードパーティ アプリケーションへのアクセス を有効化する必要があります。 このためには、[ セキュリティ ]の下の [ポリシー ]タブにアクセスする必要があります。このオプションの有効化は、Azure Repos アカウントへの認可前に行う必要があります。 すでに認可を確立している場合は、接続を再同期する必要があります。

Azure への接続を許可したユーザーが複数の組織に属しており、特定のリポジトリのコンテンツを Automation Ops™ に表示しないようにする場合は、その組織の Azure 側でサード パーティとの連携が無効化されていることを確認する必要があります。

[同意] をクリックすると、再び Automation Ops™ にリダイレクトされ、利用可能なプロジェクトのリストが入力されます。

Azure サービス フックを作成するには、アプリケーションを承認するサービス アカウントに対する サブスクリプションの編集権限と サブスクリプションの表示権限が必要です。既定では、プロジェクト管理者のみがこれらのアクセス許可を有します。他のユーザーにこれらのアクセス許可を付与するには、Azure CLI または Azure Security REST API を使用できます。

UiPath Automation Ops™ と Azure リポジトリの連携を削除するには、Azure 側の [ユーザー設定 ] の [ 認可 ] タブにアクセスし、そこから認可されたアプリを削除する必要があります。その後、Automation Ops™ の [ソース管理] の [ コネクションを管理 ] タブから連携を削除します。

手順 3: Automation Ops™ にプロジェクトを表示する

アプリケーションの認可が完了すると、再び Automation Ops™ にリダイレクトされ、プロジェクト のリストが入力されます。

プロジェクトごとに、外部リポジトリのプロジェクト メタデータに基づいて次のフィールドが表示されます。

• プロジェクト名
• 簡単な説明

• 適合性 (正常に動作する割合)

• 入力

• リポジトリ

• 最終変更日

外部リポジトリから最新の更新を取得するには、[ 接続を管理 ] ボタンの下の [ 同期] ボタンをクリックするか、[接続を管理] メニューから行います。

必要に応じてプロジェクト リストを同期して、追加された最新のプロジェクトを取得することができます。同期が完了すると、更新されたプロジェクト リストをすべてのソース管理ユーザーが利用できるようになります。

最初の同期後は、後続の同期が最後の同期との差異に基づいて高速に実行されます。

手記： リポジトリのサイズによっては、すべてのプロジェクトが Automation Ops™ の [ソース管理] に表示されるまで時間がかかる場合があります。

プロジェクトのコミット履歴を表示する

プロジェクトにアクセスすると、プロジェクトのコミット履歴が表示されます。この履歴には変更の簡単な説明、コミットしたユーザーの名前、タイムスタンプが示されます。

ここから、[ 新しいパイプライン] ボタンを使用してパイプラインを作成できます。 「パイプライン」セクションから 、「最初のパイプライン フローを作成する 」にリダイレクトされます。 この場合、パイプラインの定義に必要な情報は、パイプライン作成プロセスがトリガーされたプロジェクトに基づいて既に入力されています。

注:

[パイプライン] セクションで、リポジトリ/組織を変更してから最初のリポジトリ/組織を再選択すると、事前構成済みのパイプライン設定がクリアされます。

パイプライン ランタイム環境が利用できない場合は、[ 新しいパイプライン ] ボタンの代わりに、新しいオプション [ パイプラインの設定] が表示されます。 パイプライン 構成にリダイレクトされ、ここから実行環境を設定できます。

コミットの詳細を表示する

コミットを開くと、プロジェクトに含まれるファイルをより詳細に表示できます。

• ワークフロー ファイルの場合、Studio のようなビューが利用可能です。
• 他の種類のファイルの場合、コンテンツ ビューはファイルの種類に基づいて表示されます。
• [変数]、[引数]、[インポート] をクリックすると、それぞれの詳細が表示されます。
  
  

  

  
  

コミットを比較する

最後のコミットで変更されたファイルは黄色で強調表示されます。変更内容を確認するには、[以前のコミットと比較] ボタンをクリックします。

比較ウィンドウでは以下の操作が可能です。

• ファイルの古いバージョンは左側にあり、新しいバージョンは右側にあります。
• 比較されたファイル名とコミット識別子が左上に表示されます。
• 右上では、変更のあった箇所まで順に移動していったり、表示する変更の種類を選択したりできます。
  
  

  

  
  

ワークフロー ファイル内を移動する

複雑なワークフローでは、ナビゲーション コントロールを使用して、ビューを変更したりワークフロー内を移動したりできます。アクティビティをクリックすると [プロパティ] パネルが開き、ダブルクリックするとその特定のアクティビティが展開されます。

上部の階層リンク メニューを使用すると、アクティビティから 1 レベル戻ることができます。

以下のナビゲーション コントロールを使用できます。

• すべて展開: 現在のビューのすべてのサブワークフローを展開します。
• 縮小: ワークフローの表示サイズを縮小します。
• リセット: ビューの幅を 100% に戻します。
• 拡大: ワークフローの表示サイズを拡大します。