YouTrack サーバー 2024.2 ヘルプ

ファイルを添付

直接課題やコメントにファイルを添付することができます。イメージや他の種類のファイルをアップロードして添付することができます。課題にファイルを添付するオプションは、リストビューと単一の課題ビューの課題ツールバーに表示されます。

課題リストからファイルを添付すると、その添付ファイルはリストで現在ハイライト表示されている号に追加されます。

ファイルは issue に直接添付することも、コメント付きで追加することもできます。

  • 課題に添付すると、ファイルはページの添付セクションにのみ表示されます。

  • コメントに添付されているファイルは、課題の添付セクションに表示され、コメントテキストのすぐ下にサムネイルとしても表示されます。

このページの手順は、ファイルを issue に直接添付する方法を説明しています。ファイルをコメントに添付する方法の詳細については、ファイルをコメントに添付するを参照してください。

課題にファイルを添付するには:

  • 課題にファイルを添付する方法は複数あります。

    1. 1 つまたは複数のファイルをページ中央の任意の場所にドラッグアンドドロップします。

    2. 課題ツールバーの さらに表示メニューから、次のいずれかのオプションを選択します。

      オプション

      説明

      ファイルを添付

      ローカルディレクトリからファイルを検索してアップロードできるダイアログを開きます。添付ファイルは課題から表示設定を継承します。

      詳しくは、添付ファイルの可視性を参照してください。

      ファイルを非公開で添付

      1 つ以上のファイルを選択し、添付ファイルの表示を特定のグループに制限するためのダイアログを開きます。ファイルにユーザーアカウントやログファイルなどの機密情報が含まれている場合は、このオプションを使用します。

    3. 説明のファイルを添付リンクをクリックします。

キーボードショートカット

キーボードショートカットを使用して、ファイルを issue に添付することができます。これらのショートカットは、リストビューと単一号ビューで利用できます。

Windows のショートカット

Mac ショートカット

説明

Ctrl + Alt + A

Control + Option + A

ローカルディレクトリからファイルを見つけてアップロードできるダイアログを開きます。添付ファイルは課題から表示設定を継承します。

Ctrl + V

+ V

クリップボードからイメージを issue またはコメントに添付します。

Ctrl + Alt + Shift + V

Control + Option + Shift + V

ファイルを添付して表示を設定するためのダイアログを開きます。

ドラッグアンドドロップ

ファイルを課題にドラッグするだけで添付できます。複数のファイルをドラッグアンドドロップして、一度に添付することができます。

クイックビューまたは単一の課題ビューで課題を開き、1 つ以上のファイルをドロップゾーンにドラッグします。

Drag attachments single issue view

この方法は、どのビューモードでも機能します。

  • 課題リストで、1 つ以上のファイルをリスト内のターゲット issue にドラッグします。

    Drag attachment to list view
  • 単号表示では、1 つ以上のファイルをページ中央の任意の場所にドラッグします。

    Drag attachments single issue view

貼り付け

ファイルをクリップボードにコピーして、課題の添付ファイルとして貼り付けることができます。この方法では、標準のキーボード貼り付けコマンド Ctrl + V (macOS の場合は + V)を使用します。

リスト表示および単一号表示では、貼り付けたファイルはその号に添付されます。イメージを直接コメントに貼り付けることもできます。

添付ファイルを表示する

課題に添付されているすべてのファイルは、添付ファイルセクションにサムネイルまたはリスト項目として表示されます。課題の説明の添付ファイルセクションの 添付ファイルのオプションで、添付ファイルをサムネイルとして表示するか、リスト項目として表示するかを選択できます。

YouTrack は、ファイルの種類に応じてさまざまなレベルのインタラクションを提供します。

ファイルタイプ

振る舞い

イメージ

イメージファイルの場合、サムネイルにはイメージのプレビューが含まれます。リストモードでは、アイコンにファイルの種類が表示されます。

  • 添付ファイルをクリックすると、イメージがライトボックスモードで開きます。

  • テキストの表示アイコンをクリックするとテキストビューが開き、イメージ内で認識されたテキストを操作できます。詳細については、テキスト認識を参照してください。

Markdown を使用して、添付のイメージを課題の説明の本文またはコメントテキストとインラインで表示することもできます。詳しくは、画像の添付ファイルを参照してください。

ビデオ

MPEG-4、Ogg、WebM 形式のビデオファイルの場合、添付ファイルをクリックすると、新しいブラウザータブでビデオが開き、再生されます。

Markdown を使用して、これらの形式のビデオファイルを課題の説明またはコメントテキストに埋め込むオプションもあります。詳細については、埋め込み動画を参照してください。

課題の添付ファイルごとに、次のファイルの詳細を表示できます。

  • ファイル名

  • ファイルサイズ

  • アップロード者

  • アップロード日

ファイルの詳細を表示するには:

  1. その他のアクションメニューを開きます:

    • サムネイル表示では、その他のアクションメニューは添付ファイルのサムネイル上にあります。

    • リストビューでは、ポインターを添付ファイルの上に移動すると、その他のアクションメニューが表示されます。

  2. ファイルの詳細を表示を選択します。

添付ファイルのオプション

課題の説明にある添付ファイルセクションには、 添付ファイルのオプションという設定メニューがあります。

これらの設定により、課題内の添付ファイルに対して次の制御が可能になります。

アクション

説明

リストとして表示

添付ファイルをリストとして表示します。サムネイルビューよりもコンパクトなので、課題に複数のファイルが添付されている場合に役立ちます。また、ファイル名で添付ファイルを見つけるのにも役立ちます。

選択すると、このオプションはサムネイルとして表示オプションに置き換えられます。

サムネイルとして表示

添付ファイルをサムネイルとして表示します。サムネイルにはイメージファイルのプレビューが表示されるため、特定のイメージ添付ファイルを見つけやすくなります。

選択すると、このオプションはリストとして表示オプションに置き換えられます。

すべてダウンロード

コメント添付ファイルを含む、課題のすべての添付ファイルをローカルディレクトリにダウンロードします。

日付でソート: 最新の順

添付ファイルを新しい順に表示します。

日付でソート: 古い順

添付ファイルを時系列順に表示します。

タイプでソート

添付ファイルをファイルの種類に応じてアルファベット順に表示します。

インラインイメージと動画を表示する

課題の説明またはコメントボックス内にある添付ファイルの表示を切り替えます。

インライン添付ファイルを非表示にすると、添付ファイルパネルに非表示の添付ファイルの数が表示されます。

コメントに添付されたファイルを個別に表示する

課題のコメント内にある添付ファイルの表示を切り替えます。

すべて削除

コメント添付ファイルを含むすべての添付ファイルを課題から削除します。この操作は元に戻せません。

添付ファイルをダウンロードする

添付ファイルのサムネイル上の ダウンロードアイコンをクリックすると、添付ファイルをローカルディレクトリにダウンロードできます。リストビューで、添付ファイルの上にポインターを移動すると、 ダウンロードアイコンが表示されます。

Download an attachment.
Download an attachment in list view.

イメージやビデオの添付ファイルは、YouTrack でファイルを開いた後、ライトボックスモードでダウンロードすることもできます。

イメージとビデオファイルを除くすべてのファイルの種類では、サムネイルまたはリスト項目をクリックすると、ファイルのコピーがローカルディレクトリにダウンロードされます。

添付ファイルのオプションから すべてダウンロードを選択すると、すべての添付ファイルを一度にダウンロードできます。

Download all attachments.

ファイルを他のアプリにドラッグする

Google Chrome、Microsoft Edge、Opera などの Chromium ベースの Web ブラウザーで YouTrack を使用している場合は、添付ファイルパネルからファイルを直接ドラッグしてローカル環境のフォルダーにダウンロードしたり、コンピューター上の別のアプリにアップロードしたりできます。メールクライアントのようなワークステーション。

添付ファイルをマウスで選択してドラッグし、保存またはコピーしたい場所にファイルをドロップするだけです。

添付ファイルパネルを非表示にする

追加のコントロールを使用すると、 添付パネルを折りたたむことができます。これは、多数のスクリーンショットやその他のアタッチファイルが含まれる課題の場合に特に便利です。

このコントロールを使用してサムネイルを非表示にすると、課題の説明と以下のコメントセクション間のスレッドをたどることができます。

Control that collapses the Attachments panel in an issue.

添付ファイルの編集または削除

ファイル名を更新したり、課題の可視性をいつでも変更することができます。

添付ファイルを編集するには:

  1. クイックビューまたは単一の課題ビューで課題を開きます。

  2. 添付ファイルのサムネイルまたはリストビューで更新する添付ファイルの行にある 編集アイコンをクリックします。

    Edit attachment
    • 添付ファイルがイメージの場合、ファイルはイメージエディターで開きます。詳しくは、イメージを編集するを参照してください。

    • 添付ファイルがイメージではない場合は、添付ファイルの編集ダイアログが開きます。

      Edit attachment dialog
  3. 添付ファイルのプロパティを更新するには、次のオプションを使用します。

    オプション

    説明

    新しい名前

    ファイルの名前を変更してください。

    表示対象

    添付ファイルの表示設定を変更するには、グループを選択します。

    キャンセル

    変更を破棄してダイアログを閉じます。

  4. 保存ボタンをクリックして変更を適用し、ダイアログを閉じます。

添付ファイルを編集するには:

  1. 課題を単一の課題ビューで開きます。

  2. 添付ファイルのサムネイルまたはリストビューで更新する添付ファイルの行にある 編集アイコンをクリックします。

    Edit attachment
    • 添付ファイルがイメージの場合、ファイルはイメージエディターで開きます。詳しくは、イメージを編集するを参照してください。

    • 添付ファイルがイメージではない場合は、添付ファイルの編集ダイアログが開きます。

      Edit attachment dialog
  3. 添付ファイルのプロパティを更新するには、次のオプションを使用します。

    オプション

    説明

    新しい名前

    ファイルの名前を変更してください。

    表示対象

    添付ファイルの表示設定を変更するには、グループを選択します。

    キャンセル

    変更を破棄してダイアログを閉じます。

  4. 保存ボタンをクリックして変更を適用し、ダイアログを閉じます。

添付ファイルの その他のアクションアイコンをクリックし、 削除を選択すると、課題から個々の添付ファイルを削除できます。

添付ファイルのオプションアイコンをクリックし、 すべて削除を選択すると、コメント添付ファイルを含むすべての添付ファイルを課題から削除できます。この操作は元に戻せないことを理解していることを確認するには、削除をクリックしてください。

YouTrack を使用すると、添付ファイルへの直接リンクを生成できます。これらのリンクにより、リンクを送信されたすべてのユーザーがファイルにアクセスできます。セキュリティ上の理由から、手動で生成および共有されたリンクは 3 日後に期限切れになります。

課題に添付されたすべてのファイルには Web アドレスが割り当てられます。このアドレスがローカルネットワークの外部からアクセスできる場合、YouTrack インストールに保存されているファイルにアクセスできない人々と共有することができます。許可されたユーザーがこれらのリンクを生成して共有すると、このリンクをたどった人は誰でも、添付ファイルに保存されている情報に無制限にアクセスできます。

YouTrack の添付ファイルを発行するための直接リンクは、次の状況で生成されます。

  • 課題の添付ファイルを表示するアクセス権を持つユーザーは、添付ファイルのリンクアドレスをコピーして、この URL をオンラインで共有できます。

  • 通知では、添付ファイルの参照は自動的にリンクに変換されます。これらの通知とそれらに含まれるリンクは、より幅広いユーザーと共有できます。

  • メールボックス統合を使用するプロジェクトでは、メールの返信に変換されるコメントにファイルがアタッチされると、アタッチファイルリンクが生成されます。これらのメールメッセージ内のファイルへのリンクを受信する未登録のユーザーは、アタッチファイルを指す URL をどこにでも投稿したり、リンクを含むメールを転送したりできます。

アクセスを簡略化するために、添付ファイルへの直接リンクには署名が含まれています。このシグネチャーは、課題にファイルを添付したユーザーが利用できる権限に基づいて、ファイルへのアクセスを許可します。これにより、ユーザーは YouTrack にログインしなくても、これらのファイルに直接アクセスできます。YouTrack は、次の理由でこの動作をサポートしています。

  • メールボックス統合を使用するプロジェクトでは、これにより、YouTrack に登録されたアカウントがない場合でも、メール受信者がファイルへのリンクを開くことができます。

  • 通知の場合、ユーザーはブラウザーにアクティブな YouTrack セッションがない場合でも、添付ファイルを簡単に表示できます。また、イメージの添付ファイルをメールメッセージに確実に埋め込むことができます。

添付リンクを介して機密情報が誤って共有されるのを減らすために、次の方法で署名が生成されます。

  • URL 署名には、ユーザー固有とファイル固有の 2 つのシークレットが含まれます。つまり、URL 署名は特定のファイルに対してのみ機能します。

  • 署名付き URL には、それを作成したユーザーに関する情報が含まれています。YouTrack は、ファイルへのアクセスを誰が要求したかに関係なく、データがアクセスされるたびに、このユーザーの現在の権限をチェックします。

  • ファイルを添付したユーザーが課題またはコメントにアクセスする権限を失うと、生成されたリンクは無効になり、機能しなくなります。

  • オンラインで生成されたリンクの署名は 3 日後に期限切れになります。

  • 通知およびワークフローメッセージ用に生成されたリンクの署名は、2 週間後に期限切れになります。

ユーザーが機密情報を含むファイルを添付していて、権限のないユーザーがリンクにアクセスできると思われる場合は、次のようにリンクを無効にすることができます。

  • 課題またはコメントの表示を制限して、ファイルを添付したユーザーを除外します。

  • 課題からファイルを削除します。

  1. 共有したい添付ファイルを含む YouTrack 課題を開きます。

  2. アクティビティストリームには課題履歴を表示します。

  3. 共有したい添付ファイルへのリンクを右クリックしますを見つけます。

  4. リンクアドレスをコピーを選択します。

    Link to issue attachment
    • 添付ファイルのリンクアドレスがクリップボードにコピーされました。

    • このアドレスがローカルネットワークの外部からアクセスできる場合、YouTrack インストールに保存されているファイルにアクセスできない人々と共有することができます。

    • リンクを生成して共有すると、このリンクをたどった人は誰でも、添付ファイルに保存されている情報に無制限にアクセスできます。

イメージ添付ファイル内のテキスト

YouTrack には、添付イメージのテキストを操作できる光学式文字認識 (OCR) サービスが組み込まれています。テキスト認識機能を有効にすると、添付イメージ内のテキストを表示およびコピーできます。この機能をアクティブにして使用する方法については、「テキスト認識」を参照してください。

YouTrack がイメージの処理を終了し、テキストを検出すると、接続ファイルのプレビューのイメージサムネイルに テキストの表示アイコンが表示されます。リストビューでは、接続ファイルのポインターを移動すると、 テキストの表示アイコンが表示されます。

The text recognition icon

インラインイメージには テキストの表示アイコンも表示されます。

The text recognition icon on an inline image

テキストの表示アイコンをクリックするとテキストビューが開き、イメージから認識されたテキストを表示、選択、コピーすることができます。

Text view

attachment text 検索属性またはそのエイリアス image text を使用して、特定のテキストを含むイメージを含む課題や記事を検索することもできます。

検索クエリのサンプル: attachment text: sample text

関連する検索属性の詳細については、添付テキストを参照してください。

関連ページ:

コメントを追加

コメントは、課題に詳細を追加したり、説明を明確にするために質問をするのに最適な方法です。課題が報告されたら、課題にコメントを追加できます。issue の下書きにコメントを追加することはできません。あなたや他のユーザーは、質問に回答するためのコメントを追加したり、課題の解決に役立つ追加情報を提供したりできます。課題リストにコメントを追加する:課題のリストを操作していて、コメントを投稿したい場所が表示されている場合は、リストを移動せずに、課題をクイックビューで開いてコメントを追加できます。クイック...

課題、コメント、添付ファイルの可視性を設定する

課題、コメント、添付ファイルには、可視性に関する個別の設定があります。つまり、課題を表示できるグループとユーザーを指定できます。コメントまたは添付ファイルに個別の可視性制限を適用することもできます。デフォルトでは、すべての課題とコメントは、課題が割り当てられているプロジェクトで読み取り課題権限を付与されているすべてのユーザーに表示されます。可視性が制限されていない課題では、課題は課題の読者に表示されます。課題またはコメントに機密情報が含まれている場合は、課題を作成または更新するときに表示設定を変...

外観メニューオプション

YouTrack には、アプリケーションの外観を管理する設定があります。現在の設定に合わせて外観をカスタマイズできるようにするために、YouTrack では外観メニューからこれらの設定に直接アクセスできます。このメニューにアクセスするには、アプリケーションヘッダーでアバターをクリックします。テーマオプション:外観メニューのこのセクションのオプションを使用すると、ユーザーインターフェースに適用する配色を選択できます。次のオプションを使用できます。ライトライトテーマは、白またはライトグレーの背景に...

テキスト認識

YouTrack には、添付イメージのテキストを操作できる光学式文字認識 (OCR) サービスが組み込まれています。テキスト認識機能を有効にすると、次のことが可能になります。課題、記事、チケット内の特定のテキストを含むイメージを検索します。イメージ添付ファイル内のテキストを表示してコピーします。テキスト認識を実行するために、YouTrack は Tesseract ライブラリを利用したサービスを採用します。システム要件:YouTrack サーバーは、追加の計算リソースを消費する Tesseract...

Markdown の構文

YouTrack では、Markdown マークアップ構文を使用してテキストをフォーマットできます。課題の説明、補足テキストフィールド、コメント、作業項目の説明のテキストをフォーマットできます。このタイプのマークアップは、リッチテキストエディターのビジュアルフォーマットツールの代わりに提供されます。テキストのフォーマットに使用できるオプションの詳細については、リッチテキストエディターを参照してください。YouTrack の Markdown 実装は、拡張機能付きの CommonMark の仕様に従...

イメージを編集する

イメージは難しい概念を説明し、アイデアを表現するのに最適な方法です。単純なグラフィックまたはダイアグラム表は、課題を識別して解決できます。YouTrack には、イメージにイラストを描いたり、コメントを追加したりできる独自のイメージ編集ツールが組み込まれています。イメージエディターは、コミュニケーションとコラボレーションのための便利なツールです。イメージをインラインで編集:インラインイメージエディターを使用すると、他のコンテンツを作成するときに、イメージの切り抜き、ハイライト、描画、ぼかしを行...