ソース管理

Source control allows you to view updates to automation projects source code. This can be done using external providers if you are a regular user, in Automation Cloud through Studio Web if you are an Organization Admin. Together with the Source Control feature available in Studio and StudioX, allows you to gain more control over code management.

注:

ソース管理ポリシーへのアクセスは、使用するクラウド製品によって異なります。詳しくは、「 利用可能な Automation Ops 機能」をご覧ください。

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

• 少なくとも 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 の組織管理者でもなければなりません。
• API キーまたは PAT トークンによる認証はサポートされていません。GitHub 組織管理者が GitHub OAuth 経由でログインし、接続を設定する必要があります。Automation Ops ユーザーが GitHub Org 管理者でない場合の一般的な回避策は、Automation Ops 管理者ロールを GitHub Org 管理者に一時的に割り当てて、セットアップを完了できるようにしてから、後でロールを取り消すことです。
• リポジトリを手動で選択する場合は、パブリック リポジトリも明示的に選択する必要があります。手動で選択したリポジトリにはパブリック リポジトリが暗黙的に選択されないためです。
• Automation Ops - ソース管理は、各リポジトリの既定のブランチにある RPA プロジェクトのみを同期します。

別の 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 Repos の連携を削除するには、Azure 側で [User settings] の [Authorization] タブにアクセスし、そこから認可されたアプリを削除する必要があります。その後、Automation Ops™ の [ソース管理] の [接続を管理] タブから連携を削除します。

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

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

プロジェクトごとに、外部リポジトリのプロジェクト メタデータに基づいて以下のフィールドを確認できます。

• プロジェクト名
• 簡単な説明
• 適合性 (正常に動作する割合)
• 入力
• リポジトリ
• 最終変更日

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

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

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

注:

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

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

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

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

注:

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

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

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

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

• ワークフロー ファイルの場合、Studio のようなビューが利用可能です。

• 他の種類のファイルの場合、コンテンツ ビューはファイルの種類に基づいて表示されます。

• 変数、引数、またはインポートを選択すると、それぞれの詳細が表示されます。

  

コミットを比較する

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

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

• ファイルの古いバージョンは左側にあり、新しいバージョンは右側にあります。

• 比較されたファイル名とコミット識別子が左上に表示されます。

• 右上では、変更のあった箇所まで順に移動して、確認する変更の種類を選択できます。

  

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

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

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

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

• すべて展開: 現在のビューのすべてのサブワークフローを展開します。

• 縮小: ワークフローの表示サイズを縮小します。

• リセット: ビューの幅を 100% に戻します。

• 拡大: ワークフローの表示サイズを拡大します。