通知を受け取る

UiPath Studio

UiPath Studio ガイド

プロジェクトを Git で管理する

GIT integration in Studio requires the Microsoft Visual C++ 2015 Redistributable Update 3. Check the Software Requirements page.

GIT への認証

Studio 内の認証方法は、GIT リポジトリのクローニングに HTTPS または SSH のどちらの方法を使用するかによって異なります。GitHub を使用している場合は、どちらを使用すべきかを、このページで確認してください。

📘

注:

  • Studio で入力する Git の資格情報は、Windows 資格情報マネージャーに保存されます。
  • 現在、Studio と連携されている Git では、2 要素認証をサポートしていません。回避策として、パーソナルトークンによる SSO 認証方式を使用するか、基本アクセス認証方式を使用してください。

現在のガイドでは、GitHub リポジトリに対する認証手順を詳述していますが、Studio での Git の統合は、このサービスに限られているわけではありません。

HTTPS による方法

HTTPS を使ってはじめてリモート Git リポジトリをクローニングする場合や現在のプロジェクトを既存の Git リポジトリにコピーする場合、Git の資格情報を指定する必要があります。これらの資格情報は、[資格情報を使用] フィールドに入力します。

750750

以下の方法で認証できます。

  • ユーザー名とパスワードをそれぞれの特定のフィールドに入力する
  • [ユーザー] フィールドにユーザー名を入力し、[トークン] フィールドに Git トークンを入力する

このページで解説している手順に従い、GitHub リポジトリの GIT トークンを生成します。

SSH による方法

SSH を使ってはじめてリポジトリをクローニングする場合や現在のプロジェクトを既存の GIT リポジトリにコピーする場合、秘密キーを使用するオプションがあります。

750750

[秘密キーのパス][パスワード] を入力して、[開く] をクリックすることで、リモート Git リポジトリがクローニングされます。GitHub リポジトリの SSH キーを生成するには、こちらの詳細な手順をご覧ください。

認証に失敗した場合

HTTPS による方法

HTTPS による方法で GIT リポジトリを複製するときにパスワードまたはユーザー名を誤って入力していた場合、「認証に失敗しました」というメッセージとともに、[資格情報を入力] ウィンドウが表示されます。

422422

資格情報として正しいユーザー名パスワードを入力し、再度試してください。たとえば、Git Bash を使用してリポジトリのクローンをリモートで作成し、ユーザー名とパスワードが正しいかどうかを確認することもできます。

以下の図は、HTTPS 経由でリポジトリをクローンしようとして、誤ったパスワードを入力してしまった例です。Git Bash のウィンドウに、資格情報に誤りがあったことが示されています。

834834

SSH による方法

SSH を介した認証に失敗すると、次の [資格情報を入力] ウィンドウが表示されます。

653653

正しい秘密キーのパスパスワードを入力し、再度試してください。たとえば、Git Bash を使用してリポジトリのクローンをリモートで作成し、トークンやパスワードが正しいかどうかを確認することもできます。

以下の図は、SSH 経由でリポジトリのクローンを作成しようとしたものの、アカウントにパブリック SSH キーが設定されていなかった例です。

970970

リモート Git リポジトリの複製

  1. [チーム] タブで、[リポジトリを複製] を選択します。[リモート Git リポジトリを複製] ウィンドウが開きます。
  2. [HTTPS を使用して複製] または [SSHを使用] を選択します。
  3. [リポジトリ URL] に入力します。また、空の [チェックアウト ディレクトリ] を選択します。
  4. [資格情報を使用] または [キーを使用] チェックボックスをクリックして、Git ユーザー名または秘密キーのパス、およびパスワードを追加します。
  5. [開く] をクリックすると、Studio はこのプロジェクトをデザイナー パネルで開きます。
  6. [開く] ウィンドウで project.json ファイルを選択して、Studio で開きます。

Git リポジトリをローカルの作業ディレクトリに複製すると、.git サブディレクトリが作成され、ここに必要な Git メタデータが格納されます。メタデータには、オブジェクトのサブディレクトリ、参照、テンプレート ファイルが含まれます。さらに、現在チェックアウト中の確定を指し示す HEAD ファイルも作成されます。

プロジェクトの Git への追加

Git Init (Git の初期化)」機能は、現在のプロジェクトをローカル Git リポジトリに追加します。[チーム] タブ、またはステータス バーからコマンドにアクセスします。

  1. Studio でプロジェクトを作成するか、開きます。[スタート] タブ > [チーム] をクリックします。[チーム] タブが表示されます。
  2. [Git Init] ボタンをクリックして、リポジトリを初期化するパスを選択します。この場所は、プロジェクトまたは親フォルダーと同じになることがあります。[変更をコミット] ウィンドウが開きます。
961961
  1. [変更されたファイル] セクションに、Git リポジトリに追加されるプロジェクト ファイルが表示されます。追加しないファイルの隣にあるチェックボックスをオフにするか、[すべて選択] または [選択しない] を使用します。
  2. バージョン管理されていないファイルをリストに追加するには、[バージョン管理されていないファイルを表示] ボックスのチェックをオンにします。
    [コミット メッセージ] を作成します。[コミット] ボタンをクリックすると、ローカルの Git リポジトリへの変更がコミットされます。

When a project is added to GIT, the context menu in the Project panel includes GIT-specific options. For more information, see Context Menu Options for GIT.

Git への確定とプッシュ

  1. 同じ [変更をコミット] ウィンドウで、[コミットしてプッシュする] ボタンをクリックすると、変更がコミットされ、リモート リポジトリにプッシュされます。この [リモートの管理] ウィンドウが表示されます。このウィンドウは、ステータス バーからも使用できます。
750750
  1. [名前] セクションに、リモート リポジトリの名前を入力します。
  2. [URL] セクションで、リモート URL を追加します。

追加したリポジトリに変更を加える場合には、エントリをクリックして、名前と URL を変更し、[更新] ボタンをクリックします。完了したら、[追加][保存] の順にクリックします。次のメッセージ ボックスが開きます。このメッセージは、ローカル リポジトリがリモート リポジトリと同期されていないことを示しています。

500500
  • [リモート コンテンツを上書きする] ボタンをクリックすると、ファイルのローカル バージョンをリモート リポジトリにプッシュして、リモート リポジトリのファイルを上書きします。
  • [プル (リベース)] ボタンをクリックすると、リモート ファイルがプルされ、現在のブランチがリベースされます。
  • [キャンセル] ボタンをクリックすると、操作全体がキャンセルされます。

プッシュされていない変更の数および新しく追加されたファイルが、ステータス バーに表示されます。changes_iconchanges_icon アイコンをクリックして [変更をコミット] ウィンドウを開くか、push_commitpush_commit アイコンをクリックして変更をプッシュします。

📘

注:

外部エディターでソース管理に追加されたプロジェクトのファイルを編集する場合は、[プロジェクト] パネルの [更新] refreshrefresh をクリックすると、変更内容が [プロジェクト] パネルとステータス バーに表示されます。

前回の確定の変更

Studio と連携している Git には、[コミットを修正] オプションがあります。前回確定したものを、プッシュする前に変更することができます。

  1. [プロジェクト] パネルで、変更したファイルを右クリックして、[コミット] を選択します。[変更をコミット] ウィンドウが表示されます。
875875
  1. [コミットを修正] ボックスのチェックをオンにすると、前回のコミット メッセージが、確定されたファイルとともに表示されます。現在のファイルと前回のコミット間の変更点を表示させるには、[変更を表示] オプションを使用します。
  2. コミット メッセージを変更して、含めるファイルを選択します。[コミットしてプッシュする] ボタン、または [コミット] ボタンをクリックします。

保留中の変更を元に戻す

Studio では、バージョン管理されているファイルで行った変更を元に戻すことができます。ただし、この操作は、ファイルを確定してリモートリポジトリにプッシュする前にのみ有効です。

ローカル リポジトリで変更を行った後に、Git コンテキスト メニューで [元に戻す] をクリックすると、[保留中の変更を元に戻す] ウィンドウが開きます。

875875

ファイルの隣にあるチェックボックスをオンにして、[元に戻す] をクリックします。これらのファイルは、変更前のステートに戻ります。

📘

注:

[元に戻す] は、バージョンを付けられていないファイルには対応していません。新規ファイルを作成して、[元に戻す] を選択しても、そのファイルはプロジェクトから削除されません。プロジェクト ツリーに追加された新規ファイルは、手動で削除しないかぎり残ります。

Git プロジェクトへのコピー

ステータス バーと Studio の Backstage ビューの [Git にコピー] ボタンを使用すると、現在のプロジェクトが既存の Git リポジトリにコピーできます。

コピーするには、Studio でプロジェクトを開くか、作成します。[チーム] タブで、[Git にコピー] をクリックして、マシンにある既存の Git リポジトリ フォルダーを選択します。プロジェクトがローカル Git リポジトリに追加され [Git にコピー] メッセージ ボックスが開きます。

500500
  • [はい] を選択すると、新しい場所からプロジェクトが開きます。[変更をコミット] ウィンドウが開きます。[コミット メッセージ] を入力して、[コミットしてプッシュする] をクリックするか、[コミット] をクリックします。
  • [いいえ] を選択すると、Studio のユーザー インターフェイスに戻ります。

ブランチの作成と管理

Add and manage branches from the Manage Branches window. To access it, either right-click the project node or a file in the Project panel and select Manage Branches, or use the merge_buttonmerge_button branch menu in the status bar.

875875
  • ブランチを追加するには、次の操作を行います。
    1. Select a branch in the table, and then click Plus add_buttonadd_button at the top of the window.
    2. ブランチの名前を入力し、[branch_name からブランチを作成] をクリックして、[保存] をクリックします。
      ブランチがリストに追加されます。
  • To refresh the list of branches, click Refresh refresh_buttonrefresh_button at the top of the window.
  • To delete a local branch, select it, and then click Delete delete_buttondelete_button at the top of the window.
  • ブランチを管理するには、任意のブランチを右クリックして、メニューからいずれかのオプションを選択します。
    • [ブランチをチェックアウト] オプションは、選択したブランチに切り替えます。
    • [リベース] オプションは、現在のブランチを選択したブランチにリベースします。
    • [マージ] オプションは、選択したブランチを現在のブランチにマージします。
      ブランチを GIT リモートリポジトリのマスターにマージするには、マスターブランチを Studio 内でチェックアウトさせた後、修正されたブランチをマスター内にマージする必要があります。
  • To switch between branches, open the merge_buttonmerge_button branch menu in the status bar, and then select the branch to switch to from the list of recently checked out branches.

競合の解決

Studio と連携している Git には、[リベース] コマンドや [プッシュ] コマンドの実行中に発生する競合を解決する機能があります。これは、[変更をコミット] ウィンドウから使用できます。

Studio がローカル ファイルとリモート リポジトリ内のファイルとの間で競合を検出した場合は常に、[コンフリクトを解決] ウィンドウが表示されます。

11051105

このウィンドウは、同じファイルのリモート バージョンとローカル バージョンの間の変更を表示するファイル差分検出ウィンドウに類似しています。

下表は、[コンフリクトを解決] ウィンドウで利用できるオプションの一覧です。

OptionDescription
Choose LeftSelect the left file representing the file in the remote repository to push.
Choose RightSelect the right file representing the file in the local repository to push.
SaveClick Save after choosing the left or right file.
CancelCancel the operation and exit the Solve conflicts window.
PreviousNavigates to the previous change in the compared files.
NextNavigates to the next change in the compared files.
Collapse AllCollapses all nodes in the .xaml files.
Expand AllExpands all nodes in the .xaml files.

Git からの切断

Studio の Backstage ビューの [チーム] タブでは、次の 2 つの場合に [切断] オプションを使用できます。

  1. プロセスをローカル Git リポジトリとして初期化します。新しいプロセスを作成して、[Git Init] を使用してローカル Git リポジトリに追加してから、[切断] を使用してサブバージョンタグを削除します。
  2. 親プロジェクトと子プロジェクトを含む Git リポジトリで [切断] をクリックすると、サブバージョン タグを削除できます。
  3. 子プロジェクトを切断すると、開かれているプロジェクトを含む Git リポジトリ全体がソース管理から切断されます。Studio に、切断を実行する前に確認を求めるメッセージ ボックスが表示されます。

署名を変更する

Git コミットの署名は、[チーム] タブ > [署名を変更] から変更できます。名前とメール アドレスを入力し、[OK] をクリックします。

プロキシ サーバーでの GIT の使用

Studio への GIT 連携は、インターネットにプロキシ サーバーを介して接続している場合のリモート リポジトリへのアクセスに対応しています。実現するには 2 つの方法があります。[プロキシ設定] ウィンドウでマシン レベルで設定する方法と、git コマンドを変更する方法です。

[プロキシ設定] ウィンドウで設定したプロキシの詳細が考慮されるので、.gitconfig ファイルにそれらの情報を入力する必要はありません。

プロキシの詳細を git コマンドで設定するには、Git 設定ファイルに以下の形式で追加します。
[http "https://domain.com"] proxy = http://proxyUsername:[email protected]:port

GIT 設定ファイルは、以下の場所に保存されています。

  • config ファイル : %ProgramData%\Git
  • .gitconfig ファイル : %UserProfile%
  • プロジェクト レベルのローカル config ファイル (例 : %UserProfile%\Desktop\testproject\.git)

1 年前に更新

プロジェクトを Git で管理する


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。