タスクとコンテキストを管理する
プロジェクトで作業する場合は、完了する必要のある小さな作業で作業を整理できます。
これらは、自分で設定したタスクです。PyCharm では、大きな作業を小さなタスクに分割し、変更リストに関連付けることができます。
これらは、課題追跡システムからのタスクである可能性もあります。例: PyCharm から直接割り当てられたタスクやバグを処理できます。これを可能にするには、IDE とトラッカーアカウントを接続します。
課題追跡との統合を構成する
PyCharm は次のものとの統合をサポートします。
IDE をトラッカーに接続する
設定ダイアログ Ctrl+Alt+S で、 を選択します。
をクリックして、リストから必要な課題追跡を選択します。
接続の詳細を入力します。問題のトラッカーによって設定が異なることに注意してください。
通常、サーバー URL および接続資格情報を指定する必要があります: ユーザー名およびパスワード。
場合によっては、パスワードの代わりに API トークンを入力する必要があります。例: IDE を YouTrack に接続している場合、パスワードフィールドはトークンに置き換えられます。詳細については、永久トークンの管理を参照してください。
URL の共有オプションを選択して、チームの他のメンバーがサーバーにアクセスできるようにします。このオプションを有効にすると、サーバーの URL とそのタイプが .idea/misc.xml ファイルに保存され、バージョン管理を通じて開発チームのメンバー間で共有できます。
プロキシサーバー経由でサーバーにアクセスする場合は、プロキシ設定をクリックします。プロキシ設定の詳細については、HTTP プロキシセクションを参照してください。
コミットメッセージ: タブで、変更リストのコミットメッセージの追加を有効にし、メッセージテンプレートを構成できます。
サーバー構成タブで、課題追跡に接続するための詳細パラメーターを構成します。
このタブは、一部のトラッカーでのみ使用できます(たとえば、そのままではサポートされていないトラッカーなど)。
サーバー構成タブのパラメーター
項目 | 説明 |
---|---|
ログイン URL | 認証用のリソース。IDE は、サーバーから問題のリストを取得する前に、毎回このリソースに要求を送信します(例: {serverUrl}/rest/user/login?login={username}&password={password})。 一般タブで HTTP 認証を使用するチェックボックスを選択した場合、フィールドは無効になります。 |
タスクリスト URL | サーバーから問題のリストを取得するためのリソース(例: {serverUrl}/rest/api/2/search)。 |
シングルタスク URL | 問題に関する詳細情報を ID で取得するためのリソース(例: {serverUrl}/rest/api/2/issue/{id})。 別リクエストの各タスクチェックボックスを選択しない限り、このフィールドはオプションです。 |
GET または POST | 必要なタイプの HTTP リクエストを選択します。 |
別リクエストの各タスク | このオプションを有効にすると、IDE は複数のリクエストを送信して、まず ID の問題のリストを取得し、次にシングルタスク URL フィールドで指定されたリソースを使用して各問題の詳細情報を個別に取得できます。 このオプションは、単一の応答ですべての必要な情報を送信できない、制限された REST API を備えた課題トラッカー用です。 |
レスポンスタイプ | 課題トラッカーが応答する形式を選択します: XPath の場合は XML、JSONPath(英語) の場合は JSON、正規表現の場合はテキスト。 |
セレクターの表 | セレクターを使用すると、サーバーの応答から取得する問題に関する情報を指定できます。 |
tasks | サーバー応答の問題のリストへのパス。このフィールドは必須です。 |
id | サーバー応答内の問題 ID へのパス。このフィールドは必須です。 |
summary | サーバー応答の問題タイトルへのパス。このフィールドは必須です。 |
![設定に表示されるサーバー構成タブ The Server Configuration tab shown in the settings](https://resources.jetbrains.com/help/img/idea/2024.1/server-configuration-tab.png)
追加の統合オプションを指定する
設定ダイアログ Ctrl+Alt+S で、 を選択します。
必要なオプションを設定します。
変更リスト名のフォーマット : 新しいタスクを開くか作成すると、PyCharm はこのタスクに関連付けられた新しい変更リストを作成するように求めます。このフィールドでは、新しい変更リストの名前を生成するために使用されるテンプレートを指定できます。
をクリックして、リストからプレースホルダーを選択します。
feature ブランチ名フォーマット : 新しいタスクを作成または開くと、PyCharm は新しい機能ブランチを作成するように求めます。このフィールドでは、新機能ブランチの名前を生成するためのテンプレートを構成できます。
をクリックして、リストからプレースホルダーを選択します。
Lowercased および次の記号でスペースを置換オプションを使用して、プロンプト機能ブランチ名を構成します。
IDE が課題追跡と統合されている場合、これらの設定は便利です。例: DSGN-0001 Add new icon タスク名は、dsgn-0001add-new-icon 機能ブランチ名に変換されます。
タスクヒストリー長 : PyCharm が保存するタスクの数。
コミット時にコンテキストを保存する : 変更をコミットするたびに、PyCharm は、作業したファイル、ブックマーク、ブレークポイントを保持する新しい閉じたローカルタスクを作成します。これにより、将来いつでもタスクに関連付けられているすべてのタブをすばやく復元できます。
問題キャッシュを使用可能にする : PyCharm とあなたの issue tracker の間の同期を最適化します。「遅い」課題追跡システムを使用している場合は同期が特に推奨されます。
PyCharm は、トラッカーからロードされた問題のリストをキャッシュし、繰り返し更新します。キャッシュされる問題の数と、PyCharm がそれらに関する情報を更新する頻度を指定できます。
タスク
PyCharm には、次の 2 種類のタスクがあります。
課題トラッカーから PyCharm にロードされたタスク。これらはトラッカータスクです。トラッカータスクは、課題トラッカーの対応する課題にリンクされています。これにより、PyCharm から直接監視および更新できます。
もともと PyCharm で作成されたタスク。これらはローカルタスクです。ローカルタスクは、課題追跡システムとは関係ありません。
いずれかのタイプのタスクを少なくとも 1 つ作成した場合、タスクコンボと呼ばれるリストがツールバーで使用可能になります。
トラッカータスクを開く
トラッカータスクは、問題トラッカーに接続すると PyCharm にロードされます。
メインメニューで、
Alt+Shift+N に移動するか、ツールバーのタスクコンボをクリックします。リストから必要なタスクを選択します。
タスクを開くダイアログでは、問題の状態を更新できます。
エディターで現在開いているすべてのタブを閉じるには、現在のコンテキストをクリアチェックボックスをオンにします。
VCS 操作セクションでは、新しい変更リストを作成したり、既存のブランチを選択したり、新しいブランチを作成したりすることができます。
現在の変更を保留して、後でそれらに戻すこともできます。
ローカルタスクを作成する
PyCharm では、課題トラッカーから発信されていないローカルタスクを作成できます。
メインメニューで、
に移動します。タスクコンボを使用するか、Alt+Shift+N を押すこともできます。タスク名の入力ダイアログで、新しいタスクを作成するを選択します。
新しいタスクの名前を入力します。
エディターで現在開いているすべてのタブを閉じるには、現在のコンテキストをクリアチェックボックスをオンにします。
VCS 操作セクションでは、新しい変更リストを作成したり、コントリビュートする既存のブランチを選択したり、新しいブランチを作成したりできます。
現在の変更を保留して、後でそれらに戻すこともできます。
タスクの説明を表示
切り替え先のタスクを選択すると、タスクリストにはタスク ID のみが表示されます。この情報は、問題につながる手順も関連する議論も反映されていないため、必ずしも十分ではありません。
メインメニューで、
に移動します。必要なタスクを開き、Ctrl+Q を押して PyCharm または Alt+Shift+B のタスクの説明を開き、ブラウザーで説明を表示します。
または、' タスク ID' の説明を表示またはブラウザーで「タスク ID」を開きますをクリックします。
に移動し、閉じたタスクを表示する
閉じられたローカルタスクは、プロジェクト全体または影響を受けたディレクトリがバージョン管理にある場合、変更リストに関連付けられていないタスクです。
クローズドトラッカータスクは、課題トラッカーでクローズステータスを持つタスクです。
タスクコンボをクリックし、タスクを開くをクリックします。
終了したタスクを含めるチェックボックスを選択するか、Alt+Shift+N を押します。
タスクを閉じる
メインメニューで、アクティブなタスクを閉じるをクリックします。
に移動し、
これにより、PyCharm の現在のコンテキストが閉じます。変更をコミットするために必要なチェックボックスを選択し、オプションで、作成されたブランチをマージします。トラッカータスクでは、状態を変更することもできます。新しい状態があなたの課題トラッカーに伝播されます。
![タスクを閉じる Closing a task](https://resources.jetbrains.com/help/img/idea/2024.1/tasks_close_task.png)
タスクの削除
PyCharm に表示するタスクが必要ない場合は、タスクのリストから削除することができます。
メインツールバーのタスクコンボをクリックします。
削除する 1 つ以上のタスクを選択します。
複数選択の場合は、Shift (隣接アイテムの場合)または Ctrl (非隣接アイテムの場合)キーを使用します。
右矢印ボタンをクリックし、除去を選択します。
トラッカータスクを削除する場合は、IDE から削除します。彼らはあなたの課題トラッカーに残っています。この場合のローカルタスクは、課題追跡ツールに接続されていないため、完全に削除されます。
タイムトラッキング
PyCharm を使用すると、エディターで作業するタスクに費やす時間を追跡できます。ローカルタスクの場合、この情報は、プロジェクトの作業中にタスクに競合する時間を正確に知りたい場合に役立ちます。
トラッカータスクの場合、このオプションは、課題トラッカー構成でタスクに費やす時間を記録する必要がある場合に便利です。この場合、PyCharm からトラッカーに時間ログを送信することができます。
タイムトラッキングを有効にする
Ctrl+Alt+S を押して設定を開き、
を選択します。タイムトラッキングを有効にするチェックボックスを選択します。
(オプション)サスペンド遅延値を変更します。
ここでは、タスクが中断されたと見なされるまで非アクティブでいなければならない時間を指定できます。
時間を追跡する
自動時間ロギングのために
をクリックします。
手動で時間を追跡するには、
をクリックします。手動のタイムトラッキングを停止するには、
をクリックします。
トラッカーに時間ログを送る
タイムトラッキングツールウィンドウで Bugtracker に作業項目を投稿します
をクリックします。
ログに記録する時間間隔を指定し、必要に応じてコメントを追加します。OK をクリックします。
コンテキスト
コンテキストは、エディターで開かれるブックマーク、ブレークポイント、タブのセットです。コンテキストはタスクにリンクされていますが、特定のタスクに関連付けることなくコンテキストを操作できます。
個別のコンテキストを使用すると、いくつかの作業を行い、変更を混ぜることなく切り替えることができます。
コンテキストを保存する
メインメニューで、
に移動します。「コンテキストの保存」ダイアログで、コンテキストの名前を入力し、「OK」をクリックします。
既存のコンテキストにアイテムを追加する
メインメニューで、
に移動します。必要な項目(ブックマークまたはブレークポイント)を追加するか、必要なファイルを開いてコンテキスト
を保存します。
コンテキストを切り替える
タスクを切り替えると、IDE は関連するコンテキストを自動的に切り替えます。ただし、操作するコンテキストがタスクに関連付けられていない場合は、手動で切り替えることができます。
メインメニューで、
に移動します。コンテキストのロードポップアップで、リストから必要なコンテキストを選択します。
または、右矢印をクリックしてロードを選択します。
コンテキストをクリアする
別のコンテキストをロードせずに現在のコンテキストをクリアするには、メインメニューから
を選択するか、Alt+Shift+X を押します。
コンテキストを削除する
タスクが終了したら、またはコンテキストが不要になったら、削除できます。
メインメニューで、
に移動します。コンテキストのロードポップアップで、右矢印をクリックし、除去を選択します。
関連ページ:
![](https://resources.jetbrains.com/help/img/idea/2024.1/tutorial_generic_general_tab.png)
汎用タスクサーバーを構成する
PyCharm は、すぐに使用できる多くのタスクトラッカーとの統合をサポートしています。ただし、PyCharm がまだサポートしていないトラッカーを使用する場合でも、いわゆる汎用サーバーを構成して統合できます。このチュートリアルでは、次の方法について説明します。汎用サーバーとして JIRA Cloud に接続します。割り当てられている問題のリストを取得します。各問題について、ID、タイトル、説明、問題が作成および更新された日時を取得します。トラッカーへの接続を設定する前に、PyCharm に注意...
![](https://resources.jetbrains.com/help/img/idea/2024.1/proxy_server_settings.png)
HTTP プロキシ
PyCharm がインターネットにアクセスするときにトラフィックを通過させたい場合は、HTTP または SOCKS プロキシサーバーの設定を指定します。HTTP プロキシは、HTTP 接続と HTTPS 接続の両方で機能します。これらの設定は、プラグインのダウンロード、ライセンスの有効性の確認、インスタンス間での IDE 設定の同期、および IDE 自体のその他のタスクを実行するために PyCharm が確立する接続に影響します。プロキシなしプロキシなしで直接接続します。プロキシ設定を自動検出シス...
![](https://resources.jetbrains.com/help/img/idea/2024.1/py_shelve_changes.png)
シェルブまたはスタッシュの変更
場合によっては、未完了のままのタスクを切り替えて、元に戻る必要があることがあります。作業内容を失うことなく複数の異なる機能に取り組むには、保留中の変更をシェルブまたはスタッシュすることができます。Shelve 対スタッシュ:スタッシュの変更はシェルブ付けと非常に似ています。スタッシュは Git によって生成され、PyCharm 内または PyCharm 外から適用できます。保留された変更を含むパッチは PyCharm によって生成され、IDE を通じて適用されます。また、スタッシュにはコミット...
![](https://pleiades.io/icons/pycharm.png)
変更を変更リストにグループ化する
変更リストは、VCS リポジトリにまだコミットされていないローカル変更のセットです。変更リストを使用すると、さまざまなタスクに関連する変更をグループ化し、これらの変更セットを個別にコミットできます。詳細については、変更をローカルでコミットするを参照してください。変更リストは変更ビューに表示されます。最初は、変更というデフォルトの変更リストが 1 つあります。新しい変更はすべて、変更変更リストに自動的に配置されます。VCS にまだ追加されていない新しく作成されたファイルをグループ化するバージョン管...
![](https://resources.jetbrains.com/help/img/idea/2024.1/plugins_settings.png)
プラグインのインストール
プラグインは PyCharm のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains マーケット...
![](https://resources.jetbrains.com/help/img/idea/2024.1/py_bookmarks_tool_window.png)
ブックマーク
大規模なプロジェクトで作業する場合、ファイルやフォルダーの検索には時間がかかる場合があります。そのような場合、PyCharm はブックマークを備えています。必要なコード行をブックマークして、見つけやすくすることができます。他のプロジェクトアイテムよりも頻繁に必要なプロジェクトファイルとフォルダーをブックマークすることもできます。すべてのブックマークはブックマークツールウィンドウのリストにグループ化されており、メインメニューからを選択するか、を押すと開くことができます。ツールウィンドウには、コー...