リリースノート(バージョン2020.1)
                  Helix ビジュアルクライアント（P4V）


はじめに
--------
Helix ビジュアルクライアント（P4V）は、グラフィカルインターフェイスを介し
てHelix Coreのバージョン管理されたファイルへのアクセスを提供するデスクト
ップアプリです。コードの進化をマージして視覚化するためのツールが含まれて
います。

Perforce のリリースは YYYY.R/CCCCC(例:2002.2/30547) という形式で表され、
YYYY は年、R はその年の中のリリース番号、CCCCC はバグ修正レベルでの変更を
示します。リリースノートでは、各バグ修正に変更番号が記されています。どの
ビルドにも、(1) 以前の全リリースにおけるバグ修正と (2) 現在のリリースにお
ける、バグ修正変更レベルまでのすべてのバグ修正が含まれます。

--------------------------------------------------------------------------

重要なメモ：
--------
P4V WebKitベースのP4JsApi（ビジュアルツール用のJavaScript API）は、
P4Vの2020.2リリースで廃止されます。 これは、HTML5をサポートするWebEngin
eベースのソリューションであるP4VJSに置き換えられました。 ユーザーガイドや変換ガイド
などの詳細情報は、既存のプログラムを移植したい方のために、当社のWebサイトで入手
できます。

サポートされていないP4Vコマンド構文「p4v -cmd」は、P4V 2020.2で廃止されます。
https://community.perforce.com/s/article/2871
「-cmd」フラグで使用できるアクションは、P4VCコマンドで置き換えることができ
ます。前のKB記事で説明されている「p4v -s」および「p4v -t」機能を引き続きサ
ポートします。

P4VCの詳細については、以下を参照してください。
https://community.perforce.com/s/article/15316。

--------------------------------------------------------------------------

サポート対象のプラットフォーム
------------------------------

    Windows 7、8.1、10(x86、x86_64)
    Mac OS X 10.12、10.13、10.14(x86_64)
    Linux(x86_64)
        RHEL 7.4
        CentOS 7.4
        Ubuntu 16.04 18.04

上記のプラットフォームはテストされており、積極的(頻繁)にリグレッションテス
トが行われています。
これらのプラットフォームで発見されたエラーまたはバグは、修正のための優先順
位が付けられ対応されます。
上記以外のプラットフォームは、Perforceによって積極的にテストされていません。
P4Vは、上記以外のプラットフォームで実行することができるかもしれません。

--------------------------------------------------------------------------

インストール
----------------

Windows
-------

1. 弊社の Helix Core 製品ダウンロードページから、適切な Windows プラット
   フォーム向けのインストーラをダウンロードしてください。

2. インストーラを起動するには、ブラウザ上でインストーラを実行するか、ロー
   カルディスクの任意の場所にダウンロードしてから実行します。

3. P4V の Windows インストーラーは、Microsoft Visual C++ Redistributables
   をインストールする場合があります。その場合、システムの再起動が必要です。

4. Wix Burnエンジンを使用してインストーラーを作成するため、P4V 2020.1以降
   では自動(サイレント)インストールの手順が変更されました。更新された手順
   については、以下を参照してください。
   https://community.perforce.com/s/article/17304

Mac OS X
--------

1. 弊社の Helix Core 製品ダウンロードページから、適切な Mac プラットフォ
   ーム向けのインストーラをローカルディスクにダウンロードしてください。

2. ダウンロードしたファイルをダブルクリックして、インストーラを起動します。

Linux
-----

1. 弊社の HelixCore 製品ダウンロードページから、適切な Linux プラットフォ
   ーム向けのインストーラをローカルディスクにダウンロードしてください。Li
   nuxのプラットフォーム向けの P4V は tar ファイルで圧縮されています。

2. インストールするには、ファイルを gzip で解凍し、実行時ファイルを任意の
   ディレクトリに展開します。

P4V 実行可能スクリプトへのシンボリックリンクを作成することができます。例
えば、配布ファイルが解凍された場所へのリンクを作成するには、以下のコマン
ドを実行します。

$cd /foo
$gunzip p4v.tgz
$tar xvf p4v.tar
$ln -s foo/p4v-2010.2-123456/bin/p4v /usr/local/bin/p4v

--------------------------------------------------------------------------

古いバージョンとの互換性
------------------------
このバージョンのHelix P4Vは、Helix Core 2018.2以降を正式にサポートしてい
ます。Helix P4Vで使用できる機能は、サーバーのバージョンとHelix P4Vのバー
ジョンによって異なります

分散型バージョン管理システム (DVCS) のリモート操作 (クローン/フェッチ/プッシュ) を
行うには、リモート Helix バージョニングエンジンのバージョン2016.2/1487173 以降
が必要です。これ以外の場合、リモートサーバに対する P4Vの DVCS 機能は、無効となりま
す。

以降の説明文に記述されているアスタリスクは、Helix P4V または Helix バージョニン
グエンジン (P4D) をアップグレードの必要性を表します。

** -- 新しい p4d サーバプログラムが必要

-------------------------------------------------- ------------------------
2020.1.1/1966006の新機能

#102508（Change#1963443、#1963422）
p4vjs.js スクリプトは、127.0.0.1 を使用してアドレスのルックアップを保存
します。この変更により、パフォーマンスが向上します。機能は変わりません。

-------------------------------------------------- ------------------------
2020.1.1/1966006で修正されたバグ

#102546（Change#1965822、#1965820）
HTML のサブミット前ページに引数として渡されると、ファイル/ディレクトリパ
ラメータが適切にエスケープされるようになりました。

#102515（Change#1963573）
ダッシュボードの背景色がダークテーマで正しく表示されるようになりました。

#102486（Change#1963426、#1962487）
ガードが p4vjs.refreshAll() に追加され、refreshAll()を実行する前にアクテ
ィブな有効なワークスペースがあることを確認します。

#102469（Change#1960713、#1960712）
P4V が新しいバージョンのリリースとアップデートを見つけて報告する問題を修
正しました。

#102300（Change#1954880）
「Specに移動」ダイアログのチェンジリスト番号に先行ゼロを含めるとクラッシ
ュする問題を修正しました。先頭のゼロは、チェンジリスト番号では使用できな
いため、最初に削除されます。

#102267
アドレスバーにファイルパスを入力または貼り付けるときの問題を修正しました
。ファイルツリーでファイルが正しく選択され、適切なツールバーボタンが有効
になります。

-------------------------------------------------- ------------------------
2020.1/1946989の新機能

#101445（Change#1922449）
P4V は、OpenSSL 1.1.1 を使用するように更新されました。

#100597（Change#1888583）
定義されている場合、P4V のシステム情報は HTML ツールの構成に関する情報を
報告します。

#100147（Change#1902662）
ユーザーが潜在的な競合を解決する方法を確実に決定できるように、「保留解除
されたファイルを削除する」が選択されている場合、「解決」ダイアログは、保
留解除後にファイルが解決のために開かれている場合、保留されたファイルは削
除されないことをユーザーに通知します。

#99944（Change#1865249、#1865249）
[サブミット]ウィンドウで、ストリームが編集用に開かれている場合、ユーザー
はストリームを表示、編集、または元に戻すことができます。ユーザーは、スト
リームの履歴を表示することもできます。

#99924（Change#1856028）
HTMLツールでのCookieをサポートします。Cookieを削除するには、[プリファレン
ス]> [HTMLツール]> [詳細設定]> [すべてのCookieを削除]を使用します。

#99023（Change#1861186）
HTML サブミットアクションを作成するとき、HTMLプレページは P4V サブミット
ウィンドウに渡されるすべてのパラメーター（保留中の変更、保留からのサブミ
ット、選択されたファイル、選択されたディレクトリ）にアクセスできます。こ
れらのパラメータを取得する方法は、prepage.html サンプルページに示されてい
ます。これらのパラメーターを使用して、サブミット要求の発信元を解釈できま
す。

#98608（Change#1928141、#1926977、#1926977、#1921650）
ログファイルへの書き込みが有効になっている場合、Swarm 接続のステータスは
そのログファイルに記録されます。

#98410（Change#1860856）
P4V には、ストリームの履歴オプションがあります。履歴リストは、ストリーム
リビジョングラフまたは[ストリーム]タブに表示されるストリームから起動でき
ます。リスト内のストリームリビジョンは、ドラッグアンドドロップすることで
比較できます。その他のコンテキストメニューオプションには、「前のリビジョ
ンとと比較」と「最新リビジョンと比較」があります。

#96573（Change#1877502、#1876200、#1870833）
新しい大きなチェンジリスト領域：サブミット、元に戻す、解決、保留、または
保留解除されるファイルの数が設定した「チェンジリストごとの最大ファイル数」
を超える場合、サブミット、元に戻す、解決、保留、および保留解除のダイアロ
グに大きなチェンジリストが表示されます。これにより、GUI オブジェクトを作
成せずにファイルを一覧表示することができ、パフォーマンスが向上します。ま
た、チェンジリストのファイルを簡単に選択および削除できるようになり、削除
の取り消しオプションが提供されます。
各ファイルには、「ファイル履歴」、「リビジョングラフ」、「タイムラプスビ
ュー」、「リビジョンとの相違」、および「...との相違」を表示できるコンテキ
ストメニューを表示できます。

#95922（Change#1912599、#1902352）
「解決」ダイアログで、解決時に使用する空白の選択が保持されるようになりま
した。最後に選択した選択肢が、次にダイアログを開いたときのデフォルトの選
択肢です。

#91729（Change#1915717）
ユーザーは、P4V で「ハイブリッド」ワークスペースを作成、同期して、Perfor
ceと Git(グラフディポ)両方のソースファイルを参照および表示できるようにな
りました。ハイブリッドワークスペースは、クラシックパスとリポパスをマッピ
ングして作成します。タイプが「グラフ」のワークスペースは読み取り専用です。
Git リポジトリの同期オプションには、最新のコミット、特定のブランチ、タグ、
または特定のコミット SHA-1 への同期が含まれます

#87752（Change#1906995）
P4V によって表示される「最近のワークスペース」の数を増減するには、ワーク
スペースの切り替えに使用するワークスペースブラウザーの上にある、ワークス
ペースドロップダウンをクリックし、新しい「最近のワークスペースの編集」オ
プションを選択します。

#65896（Change#1894140、#1885647）
「p4vc [options] diffhave file(s)」と「p4vc [options] diffprev file(s)」
を追加しました。'p4vc diffhave'は、(ローカル構文で)開いているワークスペー
スファイルのリビジョンを比較します。'p4vc diffprev'は、ファイルを(ディポ
パス#リビジョン構文で)以前のリビジョンと比較します。

#32515（Change#1913384、#1912627、#1912030、#1908727、#1908727、#1906995）
以前に使用したワークスペースをワークスペースのリストから削除するには、ワ
ークスペースブラウザーの上にあるワークスペースドロップダウンをクリックし
て、ワークスペースを切り替え、新しい[最近のワークスペースを編集]オプショ
ンを選択します。

-------------------------------------------------- ------------------------
2020.1/1946989で修正されたバグ

#102031（Change#1945532、#1944446）
番号付きチェンジリストでチェックアウトされたファイルを保留したり元に戻し
たりすることなく現在のワークスペースでストリームを切り替えるには、プリフ
ァレンスの新しいストリーム設定オプション「標準の切り替え動作(「p4 switch」
)を使用」を使用します。このモードでは、デフォルトのチェンジリストでチェッ
クアウトされたファイルは、「p4 switch」ベースの動作を使用している場合とは
異なり、保留されません。

#101876（Change#1939327）
ワークスペースブラウザーで特定の tiff ファイルにカーソルを合わせると P4V
がクラッシュする問題を修正しました。

#101737（Change#1932715、#1931879）
MacOSX 10.12 で P4V を起動したときにクラッシュする問題を修正しました。

#101456（Change#1921107）
DVCS 機能を無効にすると、Init、Fetch、Clone、および Push ボタンはツール
バーに表示されません。

#101443（Change#1920769）
暗いテーマのツールチップの色は、明るい黄色ではなく暗い灰色になりました。

#100800（Change#1895750）
すべての HTML ツールの URL フィールドは、ファイルパスを受け入れるようにな
りました。ファイルパスは、HTML ツールを保存するときに URL に変換されます。

#100628（Change#1888552）
[元に戻す]ウィンドウでサブミットされたチェンジリストを元に戻すと、指定し
たチェンジリストのファイルが再び開かれます。

#100350（Change#1928838）
P4V では、ストリーム仕様がチェックアウトされ、解決のためにスケジュールさ
れている場合、ストリーム仕様を保留解除できるようになりました。

#100176
インストールされた VC++ 再頒布可能ファイルが P4V のビルドに使用された再
頒布可能パッケージよりも新しい場合、Windows インストーラーは警告を出さな
くなりました。 P4V は、新しい VC++ 再頒布可能パッケージと互換性がありま
す。

#100105（Change#1892795）
HTML ツールのフォントが 4K モニターで適切に拡大縮小されるようになりまし
た。HTML ツール設定ページでは、HTML フォントのスケーリングを明示的に制御
できます。

#99958（Change#1875380）
編集のために開かれたストリームは、チェンジリスト内のファイルの表示に使用
されるソート順に関係なく、チェンジリストの最初のアイテムとして表示されま
す。

#99881
別のストリームからのストリーム仕様が保留されている場合でも、ファイルを保
留することを拒否されなくなりました。

#99645（Change#1879969）
ワークスペースとディポツリーを切り替えるときの選択処理が改善され、切り替
え時に転送できない選択が認識されるようになりました。

#99304
P4V では、所有者以外によるドラッグアンドドロップで「ロックされた」ストリ
ームの親を変更できなくなりました。

#96632（Change#1881820）
P4V は、エッジサーバーにサブミットする場合、サブミットするファイルの数を
報告します。このとき「ディポ」ではなく「エッジサーバー」と表示します。サ
ーバーはエッジからコミットサーバーへのファイル転送の進行状況を報告しない
ため、進行状況ダイアログは「ファイルをコミットサーバーに転送しています」
というラベルを切り替え、進行状況を表すバーをプログレスバーに変更します。
進行状況のカウントをエッジサーバーに報告します。この時点で、ファイルの合
計数になる可能性があります。

#95296（Change#1921663、#1921158、#1675793）
「A-Z」オプションがディポツリーのソートメニューに、表示されなかった問題
を修正しました。

#58812（Change#1928473、#1925265）
カスタムツールを実行するとき、または非 Unicode モードのサーバーに対して
コマンドプロンプトを開くとき、P4CHARSET は明示的に設定解除されます。

#51716（Change#1897226）
ワークスペースブラウザーとディポブラウザーでは、フォルダーにファイルとサ
ブフォルダーの両方が含まれていることがよくあります。これらは同じ量だけイ
ンデントされています。

#43100（Change#1922702）
ファイルにタグを付けてラベルに関連付けるために使用されるコンテキストメニ
ューは、「ラベルでタグ付け」という名前に変更されました。「ラベルでファイ
ルにタグをつける」ウィンドウでも、「同期」の代わりに「タグ」という単語が
使用されています。

#26380（Change#1904241）
新しいラベル、ブランチ、ジョブ、またはリモート仕様を作成する場合、フォー
ムエディターは、仕様を保存する前に、指定された名前がすでに使用されている
かどうかを確認します。その場合は、フォームエディターから警告が表示され、
問題を修正する必要があります。これにより、新しい仕様を保存できます。

-------------------------------------------------- ------------------------
2019.2 update3/1965058で修正されたバグ

#102469（Change#1960713、#1960712）
P4V が新しいバージョンのリリースとアップデートを見つけて報告する問題を修
正しました。

#101329（Change#1961136、#1961136）
インストーラーのリリースノートのリンクが正しい場所を指すようになりました。

-------------------------------------------------- ------------------------
2019.2 update2/1904275で修正されたバグ

#100882（Change#1901186）
メニューバーをポイントしてメニューを表示するときに、リビジョングラフツール
メニューでカスタムツールと HTML ウィンドウが複製されなくなりました。

#100857（Change#1899460）
Windows でコンテキスト認識 HTML ツールを複数回実行すると、P4V は選択され
たオブジェクトを正しく認識し、選択されたオブジェクトで起動するようになり
ました。

#100670（Change#1889852）
Identity フィールドの値は、保留からサブミットされた後、サブミット済みチェ
ンジリストから削除されなくなりました。

#99092（Change#1903805、#1829980）
P4V は、開いているストリーム仕様がない場合、起動時に「クライアント xyz に
開いているストリームがありません」という警告を生成しなくなりました。

#84162（Change#1894144、#1889851、#1355093）
システム情報の P4V バージョン文字列に正しい短い製品名が表示されるようにな
りました

-------------------------------------------------- ------------------------
2019.2 update1/1883366の新機能

#56018（変更点#1882924、#1879087、#1878625）
'$ p4vc [options] history [file（s）、...]'を追加しました。このコマンドは
、詳細ペインを含むファイル履歴リストを表示します。

-------------------------------------------------- ------------------------
2019.2 update1/1883366で修正されたバグ

#100380、#100379、#100378（Change#1877962）
p4vc 引数は、P4CHARSET の文字変換を認識して正しく処理されました。

#100198（Change#1871815）
「カスタムツール」および「HTMLツール」で使用されるストリームグラフでのス
トリームの選択認識を修正しました。

#100102（Change#1862710）
設定から保存されたウィンドウの場所は、発生するたびにウィンドウを少し下に
移動しなくなりました。

#100101（Change#1862698）
アイテムをダブルクリックすると、結果のポップアップウィンドウがメインウィ
ンドウの後ろに隠れなくなりました。

#99994（Change#1858330）
言語の設定で、ドロップダウンメニューに使用可能な言語が正しく表示されるよ
うになりました。

#98916（Change#1860754、#1824104）
ラジオボタンとラベルが、[マージ]、[コピー]、[統合]ダイアログのダークテー
マで正しい色で表示されるようになりました

#98881（Change#1879298、#1822836、#1813126、#1810077）
P4V がユーザーが「super」であるかどうかを特定のホスト上でのみ判断し、そ
れに応じてコマンドパラメーターを調整するための修正を改善しました。

#97796（Change#1862225）
「プリファレンス/ストリーム/ワークスペースアイコンの新しいストリームへの
ドラッグ時:別のワークスペースを使用」を修正しました。

#97749（Change#1864735、#1861248）
ファイル名の特殊文字を処理するための調整を修正しました。

-------------------------------------------------- ------------------------
2019.2/1856742の新機能

#99954
P4VJS で P4V 機能を拡張します。メジャーアップグレードでは、P4VJS が P4J
SAPI に置き換わり、Webkit を Webengine に置き換えます。これで、P4V 内で
任意の HTML5 コンテンツをサポートできます。
この新しい機能により独自または既存の Web ページをカスタム P4V タブおよび
ウィンドウに追加するためのより簡単で強力な方法が提供されます。この機能は
Helix サーバーからグローバルに管理できます。始めるのに役立つサンプルプロ
グラムが含まれています。
https://www.perforce.com/support/self-service-resources/documentation に
ある P4VJS ユーザーガイドおよび P4JSAPI から P4V-JS への変換ガイドを参照
してください。

#98584（Change#1844485、#1837625）
P4V は Helix Authentication Service のサポートを追加したため、ユーザーは
外部 ID プロバイダーを使用して認証できます。
詳細については、以下リンク先を参照してください。
https：//github.com/perforce/helix-authentication-extension

#98291（Change#1837593、#1837593、#1820809）
チェックアウトされたストリームは、番号付きチェンジリストで保留できるよう
になりました。
現在のワークスペースでチェックアウトされている場合、保留にされたストリー
ムを保留解除することはできません。
ユーザーは、保留されたストリームを他の保留されたストリームまたはチェック
アウトされたストリームと比較することもできます。ストリームは保留からサブ
ミットすることもできます。

#96816（Change#1819567、#1818249、#1816538）
ストリームのリビジョンを視覚化できるようになりました。
新しいストリームリビジョングラフは、ストリームバージョンを比較するときに
詳細な情報を提供します。ストリームをドラッグアンドドロップして、すばやく
簡単に比較できます。

#92367
P4V はダークモードを提供するようになりました。プリファレンスの「表示」ペ
ージで、明るいテーマと暗いテーマを切り替えることができます。
この設定を変更して P4V を再起動すると、アプリケーションが明るいモードま
たは暗いモードで表示されます。

#85443（Change#1838272）
PERFORCE 管理者によって完全なユーザー名のサポートが有効になっている場合、
[Swarm のリクエストの確認]ダイアログの[ユーザー]フィールドは自動補完をサ
ポートしています。

-------------------------------------------------- ------------------------
2019.2/1856742で修正されたバグ

#99642（Change#1845768）
バーチャルストリームまたはタスクストリームの仕様のチェックアウトはサポー
トされていないため、P4V は誤ったコンテキストメニューの[チェックアウト]お
よび[チェックアウトと編集]を表示しなくなりました。

#99610（Change#1844485、#1844112）
PERFORCE に認識されていないユーザーがユーザーを参照しようとして認証が必要
な場合に、P4V がハングすることがなくなりました。

#99535（Change#1840464）
「開いているファイルをチェックし、マージする前に警告する」は適切に機能し、統
合操作自体と衝突しなくなりました。

#99390（Change#1835329）
親ストリームから子ストリームにファイルを保留解除するときに、「<子ストリー
ム>は<親ストリーム>を継承しません "という警告は表示されなくなりました。

#99386（Change#1833788）
アドレスツールバー領域にパスを貼り付け、ファイルをチェックアウトするため
に Enter キーを押したときに発生する Windows のクラッシュを修正しました。

#99114（Change#1836116、#1836116）
[リビジョンを取得]ダイアログで、[リビジョンの指定に使用]フィールドにチェ
ンジリスト番号またはリビジョン番号を入力すると、対応するラジオボタンが期
待どおりに自動的に選択されるようになりました。

#98655（Change#1836687）
マージ/統合ダイアログで、高度な統合オプションが正しく表示されるようにな
りました。

#98053
保留解除が失敗すると、P4V は失敗した各ファイルを正しくリストするようにな
りました。

#86532（Change#1855428）
接続が失われたかタイムアウトしたために、[再接続]ダイアログと[エラー]ダイ
アログが一緒に表示される場合、それらのボタンにアクセスできるようになり、
閉じることができます。

#84281（Change#1836857）
ユーザーがファイルを分岐し、自動サブミットオプションを選択して説明を提供
すると、期待どおりにその説明が使用されます。以前は、説明が破棄される可能
性がありました。

#72931（Change#1830725、#1830403、#1830391、#1822866、#1786578、#1785100）
以前は、制限付きチェンジリストは「スーパー」ユーザーにのみ表示されました。
これで、「スーパー」ユーザーと「管理者」ユーザーの両方が制限付きチェンジ
リストを表示できるようになりました。

#68338（Change#1837195、#1785100）
リストへのアクセス権を持つユーザーは、保留されたファイルに対して「表示す
る権限がありません」というメッセージを受け取りません。

#25503（Change#1812170）
以前は、[現在のワークスペースを編集]および[現在のユーザーを編集]のダイア
ログは、ユーザーが[キャンセル]をクリックしたときに[保存]の入力を求めてい
ました。 [キャンセル]ボタンが正常に機能するようになりました。

-------------------------------------------------- ------------------------