チームが計画を立て、進行状況を追跡し、共同作業することができるソースコンテンツのリポジトリーを確立するには、Team Foundation Server 上にチームプロジェクトを作成します。
Team Foundation Server を使用して RoboHelp で共同作業を行う方法を学習します。
Team Foundation Server に接続するための前提条件
Team Foundation Server 接続プロファイルを作成する前に、次の操作を行います。
- コンピューター上で Team Foundation バージョン管理の設定をします。詳しくは、Microsoft ヘルプを参照してください。
- RoboHelp で、「編集/環境設定」を選択します。アプリケーション設定ダイアログボックスで「バージョンコントロール」をクリックして、「Team Foundation クライアント」フィールドで tf.exe バイナリの完全パスを指定します。tf.exe バイナリは、お使いのコンピューターの Visual Studio または Team Explorer インストールディレクトリにあります。パスの例を以下に示します。
C:/Program Files (x86)/Microsoft Visual Studio/2017/Enterprise/Common7/IDE/CommonExtensions/Microsoft/
TeamFoundation/Team Explorer/TF.exe
RoboHelp では、バージョン 14.102 以降の tf.exe ファイルがサポートされています。
英語以外のシステム言語を使用している場合、Team Foundation Server への接続をサポートするには回避策が必要になります。tf.exe を含むフォルダーには、様々な言語のサブフォルダーも含まれています。tf.exe がデフォルトで英語バージョンになるように、システム言語に対応するサブフォルダーを削除するか、名前を変更してください。例えば、お使いのシステム言語がフランス語の場合は、「fr」サブフォルダーを削除するか、名前を変更します。
Team Foundation Server 接続プロファイルの作成
-
注意:
RoboHelp の実行に使用するシステムユーザーアカウントに、作成したチームプロジェクトにアクセスするための適切な権限があることを確認してください。ユーザー権限の変更について詳しくは、Microsoft ヘルプを参照してください。
-
RoboHelp で、「共同作業/新規接続」を選択します。
-
接続プロファイルダイアログボックスで、接続プロファイルの名前を指定します。
-
「バージョンコントロール」ドロップダウンリストで、「Team Foundation Server」を選択します。
-
「チームプロジェクトコレクション URL」フィールドで、次のフォーマットで、チームプロジェクトコレクションの URL を指定します。
http://myserver:8080/tfs/DefaultCollection
-
「チームプロジェクト」フィールドで、Team Foundation Server のプロジェクト名を指定します。
注意:チームプロジェクト名と大文字小文字の区別は、Team Foundation Server 上のチームプロジェクト名と大文字小文字の区別に一致する必要があります。
RoboHelp では、プロジェクト名に「$/」のプレフィックスが付けられます。
-
「ワークスペース」フィールドで、ワークスペース名を指定します。このワークスペースは、「ローカルパス」フィールドで指定されたパスに作成されます。
ワークスペースは、プロジェクトのローカルコピーです。RoboHelp では、コンテンツをローカルに作成してから、Team Foundation Server にチェックインすることができます。ワークスペースについて詳しくは、Microsoft ヘルプを参照してください。
注意:RoboHelp の実行に使用するシステムユーザーアカウントに、チームプロジェクト用にワークスペースを作成するための適切な権限があることを確認してください。
RoboHelp は、ローカルワークスペースでのみ動作します。ローカルワークスペースを使用して、プロジェクトコレクションのデフォルトのワークスペースタイプを設定する方法について詳しくは、Microsoft ヘルプを参照してください。
-
「ローカルパス」フィールドで、チームプロジェクトにマッピングするコンピューター上のパスを指定します。
接続プロファイルを使用して、Team Foundation Server に現在開いている RoboHelp プロジェクトをアップロードする場合は、プロジェクトを含むフォルダーまたはその親フォルダーを指定してください。 このフォルダーは、サーバー上のチームプロジェクトコンテンツにマッピングされます。
また、接続プロファイルを使用してチームプロジェクトをダウンロードする場合、プロジェクトのダウンロード先とする空のローカルフォルダーのパスを指定します。
-
「保存」をクリックします。
Team Foundation Server からプロジェクトをダウンロードする
-
RoboHelp で「共同作業/接続を開く」を選択して、Team Foundation Server 接続プロファイルを選択します。
注意:チームプロジェクトコレクション URL に初めて接続する場合、パスワードの入力を要求するプロンプトが表示され、継続して使用するためにシステムの Credential Manager に保存されます。パスワードを最近変更した場合は、パスワードエラーのプロンプトが表示されないよう、Credential Manager から対応するレコードを削除または更新してください。レコードは、次の形式で保存されています。
team:<server>|<user>
システムの Credential Manager に一致するレコードが見つからない場合は、パスワードの再入力を要求するプロンプトが表示されます。 システムの Credential Manager(Windows)について詳しくは、Microsoft ヘルプを参照してください。接続プロファイルで指定したローカルパスに、プロジェクトのクローンが作成されます。
-
開くダイアログボックスで、RoboHelp プロジェクトファイル(.rhpj)を選択して、「開く」をクリックします。
プロジェクトファイルが表示されます。
注意:これらの手順を使用して RoboHelp プロジェクトを最初に起動するとき、接続情報は継続して使用するためにプロジェクトに保存されます。「プロジェクトを開く」に記載されたいずれかの方法でプロジェクトを直接開きます。
バージョン管理されたファイルの操作
-
トピックにコンテンツを追加するか、トピックを編集します。ネットワーク接続が使用できない場合、または信頼性が低い場合でも、ファイルをすばやく編集できるようになります。RoboHelp はローカルワークスペースのみを使用するため、編集する前にファイルを明示的にチェックアウトする必要はありません。
-
変更内容をサーバーにチェックインするには、「共同作業/チェックイン」を選択します。
-
チェックインダイアログボックスで、変更したファイル、新しく追加したファイル、削除したファイルのリストからチェックインするファイルを選択します。
-
オプションでチェックインの説明を指定することもできます。
-
「チェックイン」をクリックします。
チェックインが正常に完了すると、成功メッセージが表示されます。
注意:チェックインしようとしているファイルがサーバー上で別のユーザーによって変更されている場合、チェックインは失敗します。ローカルバージョンとサーバーバージョン間の競合を解決するように促すメッセージが表示されます。すべての競合が解決したら、ファイルをもう一度チェックインします。
-
ローカルファイルを Team Foundation Server の最新バージョンと同期するには、「共同作業/最新バージョンを取得」を選択します。
ワークスペース内のファイルは、編集が含まれているものを除き、更新されます。チェックイン時に、ローカルで編集されたバージョンをサーバーから更新されたバージョンにマージできます。
ファイルのロック
コンテンツパネルでファイルをロックして、サーバー上で他のユーザーによる変更を一時的に防ぐことができます。これは、ワークスペースのファイルを変更して、マージの競合を解決する必要なくそのファイルをチェックインする場合に便利です。ファイルをロックできるのは、一度に 1 人のユーザーに限られます。
-
ファイルのロックステータスを更新するには、目的のファイルを右クリックして、「ロックのステータスを更新」を選択します。
ロックステータスは、ファイルが他のユーザーによってロックされている場合は
アイコン、自分でロックしている場合は
アイコンで表示されます。
-
ファイルをロックしたユーザーの名前を確認するには、ポインターを
アイコンの上に置きます。
-
ファイルをロックするには、コンテンツパネルで目的のファイルを右クリックして、「ロックする」を選択します。「ロックする」オプションは、ファイルが別のユーザーによってロックされていない場合にのみ表示されます。ファイルをロックしても、他のユーザーはファイルを編集できます。ただし、ロックが解除されるまでは変更内容をサーバーにチェックインすることはできません。
-
ファイルのロックを解除するには、目的のファイルを右クリックして、「ロックを解除する」を選択します。 ファイルのロックを解除すると、他のユーザーはサーバーに変更内容をチェックインできるようになります。自分自身でロックしていたファイルをチェックインすると、自動的にロックが解除されます。
Team Foundation Server にプロジェクトを追加する
-
プロジェクトを追加するには、「共同作業/プロジェクトを追加」を選択して、Team Foundation Server 接続プロファイルを選択します。
プロファイルのローカルパスには、現在のプロジェクトが含まれている必要があります。詳しくは、「Team Foundation Server 接続プロファイルの作成」の手順 8 を参照してください。
チェックインダイアログボックスが表示されます。
-
「バージョン管理されたファイルの操作」を参照して、必要なファイルを確認してください。
Team Foundation Server 接続を削除する
-
現在の RoboHelp プロジェクトから Team Foundation Server プロジェクト接続を削除するには、「共同作業/接続を削除」を選択します。
-
また、ローカルワークスペースも併せて削除する場合は、確認ダイアログボックスで「あらゆるソース管理情報をローカルフォルダーから削除します。」フィールドを選択します。
警告:ワークスペースを削除する前にすべての変更をチェックインして、チェックインされないロックされたファイルのロックを解除します。
注意:現在のシステムユーザーに削除権限がない場合は、ワークスペースを削除する操作は失敗します。
-
「OK」をクリックします。
接続が削除されるとすぐにプロジェクトが再度開き、共同作業メニューで、「プロジェクトを追加」オプションが使用可能になります。 プロジェクトをもう一度追加するには、「Team Foundation Server にプロジェクトを追加する」を参照してください。