ヘルプ > DITA オーサリングの概要 > DITA サポートユーザーインタフェース > リソースマネージャ > 「属性の修正 - キー定義」ダイアログボックス
  
「属性の修正 - キー定義」ダイアログボックス
「属性の修正 – キー定義」ダイアログボックスを使用して、DITA マップのキー定義を修正することができます。「属性の修正」ダイアログボックス、文書マップ、および列ビューを使用して属性を修正する場合に、リソースマネージャを開きます。キー定義を修正するときは、keys 属性の横にある「ブラウズ」ボタン を選択して、リソースマネージャを表示します。この場合、リソースマネージャには修正可能な「キー定義」を修正するインタフェースのみが表示されます。ditakeyrefui アドバンス環境設定によって、リソースマネージャで該当するオプションが使用できるかどうかが決まります。
「属性の修正 – キー定義」ダイアログボックスの状態は 2 種類あります。第 1 の状態は、ローカル文書のキー定義の修正です。もう 1 つは、インターネット上の文書に対するキー定義の修正です。また、編集中の DITA マップのタイプによって、タブでどのオプションを使用できるかが決まります。編集しているのが DITA キー定義マップである場合は、より多くのオプションを使用できます。
ローカル文書のキー定義を修正する場合のオプション
ローカル文書のキー定義を修正する場合、「キー定義」タブに次のオプションが含まれます。
• 「検索先」 - リソースマネージャブラウザに表示するコンテンツの場所を指定します。
ドロップダウンリストから場所を選択します。このフィールドにはブラウザで現在使用可能な場所が常に表示されます。ブラウザでフォルダをダブルクリックすると、そのフォルダが「検索先」フィールドに表示されます。このリストで「Web」を選択した場合は、「キー定義」タブの状態が変わり、インターネット上の文書のキー定義の修正が可能になります。
このリストには「お気に入りの場所」 の選択が含まれます。このオプションを選択すると、ブラウザに表示される場所が「お気に入りの場所」ノードに変わり、ここに保存済みのお気に入りの場所のリストが一覧表示されます。
リストには「履歴」 オプションも含まれます。このオプションを選択すると、ブラウザに表示される場所が「履歴」ノードに変わり、ここに現在のセッションで訪れたすべての場所のリストが一覧表示されます。
• 「メニュー」ボタン - 以下のオプションを選択できるメニューが表示されます。
◦ 「開く」 (後ろに文書名) - ブラウザ内で文書を選択している場合は、新しいウィンドウが開いてその文書が表示されます。
選択している文書のタイプが XML、DITA、SGML、または HTML である場合、その文書は Arbortext Editor の新規ウィンドウで開かれます。その他のタイプの文書やグラフィックは、それぞれに関連付けられているアプリケーションで開かれます。たとえば、グラフィックはお手元のグラフィック用デフォルトアプリケーションで開かれます。
◦ 「履歴をクリア」 - ブラウザの「履歴」ノードから訪問した場所のリストが消去されます。
このオプションは、「履歴」ノードが選択されている場合のみ表示されます。
◦ 「お気に入りに追加」 - 選択した場所を「お気に入りの場所」に追加します。
このオプションは、ファイルシステムフォルダ、コンテンツ管理システム (CMS) フォルダ、または同様の場所がブラウザで選択されている場合のみ表示されます。
◦ 「お気に入りから除去」 - 選択した場所を「お気に入りの場所」から除去します。
このオプションは、「お気に入りの場所」リストでアイテムが選択されている場合のみ表示されます。
◦ 「上へ移動」 - 「お気に入りの場所」リストのアイテムを、リスト内で 1 レベル上へ移動します。
このオプションは、「お気に入りの場所」リストでアイテムが選択されている場合のみ表示されます。
◦ 「下へ移動」 - 「お気に入りの場所」リストのアイテムを、リスト内で 1 レベル下へ移動します。
このオプションは、「お気に入りの場所」リストでアイテムが選択されている場合のみ表示されます。
◦ 「お気に入りをエクスポート」 - 「名前を付けて保存」ダイアログボックスが開き、現在のお気に入りの場所のリストを XML ファイルに保存できます。
このオプションは、ブラウザで「お気に入りの場所」ノードが選択されている場合のみ表示されます。このオプションではお気に入りが XML ファイルに保存されます。「お気に入りをインポート」メニュー項目を使用して、このファイルをお気に入りのリストとしてインポートすることができます。この XML ファイルは、お気に入りのリストの保存目的のみのものなので、修正しないでください。
◦ 「お気に入りをインポート」 - 「開く」ダイアログボックスが開き、エクスポートされた「リソースマネージャ」のお気に入りリストを含む XML ファイルを選択できます。
このオプションは、ブラウザで「お気に入りの場所」ノードが選択されている場合のみ表示されます。このオプションでは、「お気に入りをエクスポート」メニュー項目を使用してエクスポートしたお気に入りのリストとしてインポートできます。
「開く」ダイアログボックスでファイルを選択して「開く」をクリックすると、別のダイアログボックスが開き、現在のお気に入りのリストとマージするか置換するかを尋ねられます。インポートしたリストにあり、現在のリストにはまだ存在していない場所を、お気に入りのリストに追加するには、「マージ」をクリックします。現在のお気に入りのリストをインポートしたリストによって完全に置き換えるには、「置換」をクリックします。
◦ 「チェックアウトして編集」 - 選択した CMS オブジェクトを開いて Arbortext Editor で編集します。
オブジェクトをまだチェックアウトしていない場合、リソースマネージャがオブジェクトを自動的にチェックアウト (ロック) します。一度の操作で依存するオブジェクトをチェックアウトすることもできます。このメニューは PTC サーバー接続オブジェクトのみに使用します。
◦ 「チェックアウト」 - 選択したロックされていない CMS オブジェクトをチェックアウト (ロック) します。
一度の操作で依存するオブジェクトをチェックアウトすることもできます。このメニューは PTC サーバー接続オブジェクトのみに使用します。
◦ 「チェックアウトを解除」 - CMS オブジェクトのチェックアウトをキャンセルして、チェックアウトしたバージョンに加えた変更をすべて破棄します。
チェックアウトをキャンセルした後にその文書オブジェクトを Arbortext Editor で開くと、読み取り専用に変わります。このメニューは PTC サーバー接続オブジェクトのみに使用します。
◦ 「プロパティ」 - 選択したオブジェクトのプロパティを含むオブジェクトのプロパティダイアログボックスを表示します。
このメニューは PTC サーバー接続オブジェクトのみに使用します。
◦ 「CMS のサーチ結果をクリア」 - リソースマネージャブラウザの「CMS のサーチ結果」パートに追加された CMS オブジェクトを消去します。
このメニュー項目は、サポートされる CMS アダプタに対してのみ使用できます。このオプションは、オブジェクトを CMS から除去するわけではありません。リソースマネージャブラウザから除去するだけです。
• 「前のフォルダ」ボタン () - ブラウザの表示を、1 つ前に表示したフォルダに戻します。
リソースマネージャは現在のセッションで表示したフォルダの履歴を保持しており、このボタンを使用してブラウザのフォルダ表示を戻すことができます。現在のセッションで 1 つしかフォルダを表示していない場合、このボタンは無効です。
• 「1 レベル上に移動」ボタン - ブラウザに表示する場所を、現在の階層の 1 レベル上に移動します。
階層の最上位になっている場合、このボタンは無効です。
• 「現在の文書のフォルダ」ボタン () - ブラウザに表示される場所が、現在のドキュメントを含むフォルダに変わります。
• 「再表示」ボタン - ブラウザの表示を更新して、ブラウザに表示されているオブジェクトに加えられた変更を反映します。
• 「Web をブラウズ」ボタン - 「キー定義」タブの状態を、インターネットから参照を修正する状態に変更します。
• 「CMS オブジェクトブラウザを使用」ボタン - PTC サーバー接続またはリポジトリアダプタ用のブラウザを開きます。
このボタンはコンテンツ管理システム (CMS) に PTC サーバー接続またはリポジトリアダプタ経由で接続しているときにだけ使用可能です。
• 「CMS のサーチ」ボタン - 「サーチ」ダイアログボックスを開きます。
このボタンは PTC サーバー接続 オブジェクトに対してのみ使用できます。「サーチ」ダイアログボックスでは、サーチ基準に一致する CMS オブジェクトすべてを検索するクエリを入力できます。サーチ結果は「リソースマネージャ」ブラウザの「CMS のサーチ結果」パートに表示されます。
• 「フィルタ」 - ブラウザに表示されるファイルおよび文書のエレメントのリストをフィルタできます。
このオプションにテキストを入力すると、ブラウザに表示されるファイルおよび文書のエレメントのリストがフィルタされ、入力したテキストがラベルに含まれるファイルまたはエレメントのみが表示されるようになります。この場合、「フィルタ」オプションでは、ブラウザの背景色が薄い黄色になり、ブラウザのコンテンツがフィルタ中であることを示します。
たとえば、"test" と入力すると、ラベルに "Test"、"testing"、"test cases" などを含むオブジェクトのみがブラウザに表示されます。文書を展開して文書内のエレメントを表示している場合は、表示されるエレメントもフィルタされます。この場合、ラベルにフィルタのテキストが含まれていない場合でも、文書はブラウザに表示されたままになります。
フィルタリングでは大文字と小文字は区別されません。フォルダ (およびフォルダ的なオブジェクト) はフィルタされません。「フィルタ」オプションに複数の用語を入力した場合、一致するラベルにはこれらすべての用語が含まれる必要があります。
• リソースマネージャブラウザ - ファイルシステム、コンテンツ管理システム (CMS)、文書階層を表示します。
リソースマネージャブラウザでは、ファイルシステムまたは CMS にあるコンテンツを見つけて文書に挿入できます。ブラウザはファイルシステムまたは CMS のコンテンツを階層表示します。フォルダとファイルの表示に加えて、DITA 文書のコンテンツを表示することもできます。たとえば「キー定義」タブを使用しているときは、ブラウザには文書の現在のコンテキストに基づいてキー定義のターゲットとして使用できる DITA 文書のエレメントが表示されます。エレメントにタイトルが付いている場合は、ブラウザのエレメントの横にタイトルが表示されます。エレメントの ID (ditahideids アドバンス環境設定に依存) と、すべての href 属性値も表示されます。
ブラウザに表示されるエレメントが、keyref 属性にキー参照値をすでに含んでいる場合、これはアイコン によって示されます。ブラウザでエレメントを選択すると、ダイアログボックスの「キープロパティ」セクションのオプションの一部が自動的に入力されます。たとえば、選択したエレメントが title エレメントを含む場合、そのエレメントのコンテンツが「タイトル」オプションに入力されます。入力されるオプションは、選択したエレメントによって決まります。
ブラウザには、保存したお気に入りの場所のリストを含む「お気に入りの場所」 () ノードが含まれます。お気に入りの 1 つをダブルクリックすると、その場所がブラウザに表示されます。場所が削除された、または CMS フォルダなのに CMS にログオンしていないなど、お気に入りの場所が現在使用できない場合、フォルダにはそのステータスを示す特別なアイコン が表示されます。
ブラウザには現在のセッションで訪れたすべての場所を含む「履歴」 ノードも表示されます。場所をダブルクリックすると、その場所がブラウザに表示されます。
階層のプラス記号 (+) をクリックすると、階層の下位レベルまたは文書のコンテンツが表示されます。マイナス記号 ( - ) をクリックすると、階層のレベルまたは文書が閉じられます。階層内のオブジェクトを選択するには、そのオブジェクトをクリックします。フォルダにブラウザのフォーカスを移動するには、そのフォルダをダブルクリックします。
ブラウザで「Web」ノードをダブルクリックすると、タブの状態が変わり、インターネット上の文書への参照を修正できるようになります。
• 「タイプ」 - リソースマネージャブラウザに表示する文書のタイプを指定します。
このドロップダウンリストを使用して、ブラウザに表示する文書を文書のタイプによって絞り込みます。以下の文書のタイプを選択できます。
◦ 「トピック、マップ、またはイメージ」 - DITA マップ、トピック文書、およびグラフィックファイルのいずれかを表示します。
◦ 「トピック」 - DITA トピック文書だけを表示します。
◦ 「トピックまたはマップ」 - DITA マップ文書またはトピック文書を表示します。
◦ 「マップ」 - DITA マップ文書だけを表示します。
◦ 「イメージ」 - グラフィックファイルだけを表示します。
◦ 「PDF」 - PDF 文書だけを表示します。
◦ 「HTML」 - HTML 文書だけを表示します。
◦ 「任意」 - すべてのタイプの文書を表示します。
• 「表示」 - リソースマネージャのブラウザに表示する DITA 文書のエレメントタイプを指定します。
このドロップダウンリストを使用して、ブラウザに表示するエレメントをエレメントのタイプによって絞り込みます。以下のエレメントのタイプを選択できます。
◦ 「すべてのエレメント」
◦ 「すべてのエレメントと IDs」
◦ 「キー定義」
◦ 「キー参照」
• 「キープロパティ」 - キー定義のプロパティを指定できます。
リソースマネージャのこのセクションのオプションを使用して、定義しているキーのプロパティを設定します。使用できるオプションの数は、編集している DITA マップのタイプによって決まります。編集しているのが DITA キー定義マップである場合は、より多くのオプションを使用できます。これらの追加オプションによって、「キー参照の挿入」ダイアログボックスでのキーに関する詳細が提示されます。
以下のキープロパティを使用できます。
◦ 「クリア」ボタン - キープロパティオプションに入力したすべてのコンテンツを除去します。
いずれかのキープロパティオプションにコンテンツを入力すると、そのオプションのラベルが青色になります。プロパティのコンテンツを修正すると、ブラウザで選択を変更したときに、これが更新されなくなります。このボタンをクリックすると、修正されたすべてのオプションからコンテンツが消去されてラベルが黒に戻り、すべてがデフォルト値に戻されます。
◦ 「名前」 - キー名を提示します。
1 つまたは複数のキー名を、スペースで区切って入力できます。すでにキー参照が定義されているブラウザでエレメントを選択すると、デフォルトで Keyref 属性がこのオプションに挿入されます。無効なキー名を入力すると、このオプションのラベルが赤く表示され、ステータスバーにエラーが表示されます。メッセージは、キー名が同じキーコンテキストの別のキー定義と重複している場合も、ステータスバーに表示されます。
◦ 「タイトル」 - キーのタイトルを提示します。
ここでの値はキー定義の navtitle 属性に保存されます。
◦ 「説明」 - キーの説明を提示します。
このオプションは、DITA キー定義マップを編集している場合のみ使用できます。ここでの値はキー定義の keydescription エレメントに保存されます。
◦ 「エレメント ID」 - ブラウザで選択したエレメントの ID を提示します。
選択したエレメントにすでに ID がある場合、デフォルトでその ID の値がこのオプションに挿入されます。選択したエレメントに ID がない場合、「ID を生成」ボタンを使用して ID を生成することができます。
このオプションは、DITA キー定義マップを編集している場合のみ使用できます。ここでの値はキー定義の keysubelementid エレメントの value 属性に保存されます。
◦ 「ID を生成」 ボタン - ブラウザで選択されているエレメントの ID を生成し、エレメントを含む文書を更新します。
このオプションは、DITA キー定義マップを編集している場合のみ使用できます。
◦ 「参照タグ」 - キーを参照するエレメントのリストが表示されます。
1 つまたは複数のエレメント名を、スペースで区切って入力できます。ブラウザで選択されているエレメントによって、デフォルトで一部のエレメントタグが挿入されます。このフィールドは、タグ名が有効であるかどうかを確認するために、チェックされません。
このオプションは、DITA キー定義マップを編集している場合のみ使用できます。ここでの値はキー定義の keyreftags エレメントの value 属性に保存されます。
• 「修正」ボタン - 現在のキー定義を修正して、新しいプロパティと一致させます。
インターネット上の文書のキー定義を修正する場合のオプション
インターネット上の文書のキー定義を修正する場合、「キー定義」タブには以下のオプションが表示されます。
• 「検索先」 - 「キー定義」タブの状態を決定します。
インターネット上の文書のキー定義修正の場合、このオプションは常に「Web」に設定されます。ドロップダウンリストから別の場所を選択すると、ローカル文書の定義を修正する状態にタブの状態が変わります。
「メニュー」ボタン () - 以下のオプションを選択できるメニューが表示されます。
◦ 「開く」 (後ろに文書名) - 選択は無効になります。
◦ 「CMS のサーチ結果をクリア」 - リソースマネージャブラウザの「CMS のサーチ結果」パートに追加された CMS オブジェクトを消去します。
• 「前のフォルダ」ボタン () - ブラウザの表示を、1 つ前に表示したフォルダに戻します。
ブラウザで最後に表示した場所が「Web」でない場合、ローカル文書への参照を修正できるようにタブの状態が変わります。
• 「1 レベル上に移動」ボタン - 無効になります。
• 「現在の文書のフォルダ」ボタン () - ブラウザに表示される場所が、現在のドキュメントを含むフォルダに変わります。
タブは、ローカル文書の参照を修正する状態に変わります。
• 「再表示」ボタン - 無効になります。
• 「Web をブラウズ」ボタン - 無効になります。
• 「CMS オブジェクトブラウザを使用」ボタン - PTC サーバー接続またはリポジトリアダプタ用のブラウザを開きます。
このボタンはコンテンツ管理システム (CMS) に PTC サーバー接続またはリポジトリアダプタ経由で接続しているときにだけ使用可能です。
• 「CMS のサーチ」ボタン - 「サーチ」ダイアログボックスを開きます。
このボタンは PTC サーバー接続 オブジェクトに対してのみ使用できます。「サーチ」ダイアログボックスでは、サーチ基準に一致する CMS オブジェクトすべてを検索するクエリを入力できます。サーチ結果は「リソースマネージャ」ブラウザの「CMS のサーチ結果」パートに表示されます。
• 「URL」 - キー定義に挿入する URL が表示されます。
このフィールドを編集して必要な URL を追加することも、「ブラウザの URL を取得」ボタンを選択して現在アクティブな Web ブラウザに表示されている Web ページの URL をオプションに挿入することもできます。
• 「ブラウザを開く」 - デフォルトの Web ブラウザを開きます。
「URL」オプションに URL が含まれている場合、Web ブラウザが開いてその Web ページが表示されます。このオプションを使用するには、お使いのオペレーティングシステム、または「環境設定」ダイアログボックスの「ファイルの場所」環境設定で、デフォルトの Web ブラウザを設定しておく必要があります。
• 「ブラウザの URL を取得」 - 現在アクティブな Web ブラウザに表示されている Web ページの URL を「URL」オプションに挿入します。
このオプションを使用するには、お使いのオペレーティングシステム、または「環境設定」ダイアログボックスの「ファイルの場所」環境設定で、デフォルトの Web ブラウザを設定しておく必要があります。
• 「キープロパティ」 - キー定義のプロパティを指定できます。
リソースマネージャのこのセクションのオプションを使用して、定義しているキーのプロパティを設定します。使用できるオプションの数は、編集している DITA マップのタイプによって決まります。編集しているのが DITA キー定義マップである場合は、より多くのオプションを使用できます。これらの追加オプションによって、「キー参照の挿入」ダイアログボックスでのキーに関する詳細が提示されます。
以下のキープロパティを使用できます。
◦ 「クリア」ボタン - キープロパティオプションに入力したすべてのコンテンツを除去します。
いずれかのキープロパティオプションにコンテンツを入力すると、そのオプションのラベルが青色になります。プロパティのコンテンツを修正すると、ブラウザで選択を変更したときに、これが更新されなくなります。このボタンをクリックすると、修正されたすべてのオプションからコンテンツが消去されてラベルが黒に戻り、すべてがデフォルト値に戻されます。
◦ 「名前」 - キー名を提示します。
1 つまたは複数のキー名を、スペースで区切って入力できます。無効なキー名を入力すると、このオプションのラベルが赤く表示され、ステータスバーにエラーが表示されます。メッセージは、キー名が同じキーコンテキストの別のキー定義と重複している場合も、ステータスバーに表示されます。
◦ 「タイトル」 - キーのタイトルを提示します。
ここでの値はキー定義の navtitle 属性に保存されます。
◦ 「説明」 - キーの説明を提示します。
このオプションは、DITA キー定義マップを編集している場合のみ使用できます。ここでの値はキー定義の keydescription エレメントに保存されます。
◦ 「エレメント ID」 - このオプションは無効化されています。
◦ 「ID を生成」 ボタン - このオプションは無効化されています。
◦ 「参照タグ」 - キーを参照するエレメントのリストが表示されます。
1 つまたは複数のエレメント名を、スペースで区切って入力できます。一部のエレメントタグが、デフォルトで挿入されます。このフィールドは、タグ名が有効であるかどうかを確認するために、チェックされません。
このオプションは、DITA キー定義マップを編集している場合のみ使用できます。ここでの値はキー定義の keyreftags エレメントの value 属性に保存されます。
• 「修正」ボタン - 現在のキー定義を修正して、新しいプロパティと一致させます。