出力生成設定の設定 id181AI0B0E30
AEM Guidesには、出力生成プロセスをカスタマイズするための多くの設定オプションが用意されています。 このトピックでは、出力生成プロセスの設定に役立つすべての設定とカスタマイズについて説明します。
DITA マップダッシュボードの「ベースライン」タブの設定 id223MD0D0YRM
以下のタブでは、Experience Manager Guidesの設定に基づいてDITA マップダッシュボードの「ベースライン」タブを非表示にする手順を示します。Cloud Serviceまたはオンプレミス。
- 設定ファイルを作成するには、設定の上書きの手順を使用します。
- 設定ファイルで、マップダッシュボードの「ベースライン」タブを設定するために、次の\(プロパティ\)詳細を指定します。
| table 0-row-3 1-row-3 | ||
|---|---|---|
| PID | プロパティキー | プロパティの値 |
com.adobe.fmdita.config.ConfigManager |
hide.tabs.baseline |
Boolean\(true/false\)。デフォルト値: true |
| note note |
|---|
| NOTE |
| この設定はデフォルトで有効になっており、「ベースライン」タブはマップダッシュボードで使用できません。 |
-
Adobe Experience Manager Web コンソールの設定ページを開きます。
設定ページにアクセスするためのデフォルトのURLは次のとおりです。
code language-http http://<server name>:<port>/system/console/configMgr -
com.adobe.fmdita.config.ConfigManager バンドルを検索してクリックします。
-
「ベースラインタブを非表示」オプションを選択します。
-
「保存」をクリックします。
| note note |
|---|
| NOTE |
| この設定はデフォルトで無効になっており、「ベースライン」タブはマップダッシュボードで使用できます。 |
既存のAEM サイト内でのブレンド公開の設定 id1691I0V0MGR
DITA コンテンツを含むAEM サイトがある場合は、AEM サイト出力を設定して、DITA コンテンツをサイト内の事前定義された場所に公開できます。 例えば、AEM サイトページの次のスクリーンショットでは、ditacontent ノードはDITA コンテンツを保存するために予約されています。
ページ内の残りのノードは、AEM サイトエディターから直接作成されます。 DITA コンテンツを事前定義された場所に公開するように公開設定を設定すると、既存のDITA以外のコンテンツがAEM Guides公開プロセスによって変更されなくなります。
既存のサイトで次の設定を実行して、事前定義されたノードにDITA コンテンツを公開できるようにする必要があります。
-
サイトのテンプレートプロパティを設定する
-
サイト内のノードを追加してDITA コンテンツを公開する
次のタブには、Experience Manager Guidesの設定に基づいて既存のサイトのテンプレートプロパティを設定する手順が示されています。Cloud Serviceまたはオンプレミス。
-
パッケージマネージャーを使用して、/libs/fmdita/config/templates/default ファイルをダウンロードします。
note note NOTE libsノードで使用できる既定の構成ファイルのカスタマイズを行わないでください。libsノードでappsノードのオーバーレイを作成し、appsノードでのみ必要なファイルを更新する必要があります。 -
以下のプロパティを追加します。
table 0-row-3 1-row-3 2-row-3 プロパティ名 タイプ 値 topicContentNode文字列 DITA コンテンツを公開するノード名を指定します。 例えば、AEM GuidesがDITA コンテンツを公開するデフォルトノードは
ですjcr:content/contentnodetopicHeadNode文字列 DITA コンテンツのメタデータ情報を保存するノード名を指定します。 例えば、AEM Guidesがメタデータ情報を保存するデフォルトのノードは
ですjcr:content/headnode
次回、サイトのテンプレート設定を使用してDITA コンテンツを公開すると、コンテンツはtopicContentNodeおよびtopicHeadNode プロパティで指定されたノードに公開されます。
-
AEMにログインし、CRXDE Lite モードを開きます。
-
サイトのテンプレート設定ノードに移動します。 例えば、AEM Guidesでは、デフォルトのテンプレート設定が次のノードに保存されます。
/libs/fmdita/config/templates/defaultnote note NOTE libsノードで使用できる既定の構成ファイルのカスタマイズを行わないでください。libsノードでappsノードのオーバーレイを作成し、appsノードでのみ必要なファイルを更新する必要があります。 -
以下のプロパティを追加します。
table 0-row-3 1-row-3 2-row-3 プロパティ名 タイプ 値 topicContentNode文字列 DITA コンテンツを公開するノード名を指定します。 例えば、AEM GuidesがDITA コンテンツを公開するデフォルトノードは jcr:content/contentnodeですtopicHeadNode文字列 DITA コンテンツのメタデータ情報を保存するノード名を指定します。 例えば、AEM Guidesがメタデータ情報を保存するデフォルトのノードは jcr:content/headnodeです
次のスクリーンショットは、AEM Guidesのデフォルトテンプレートノードに追加されたプロパティを示しています。
次回、サイトのテンプレート設定を使用してDITA コンテンツを公開すると、コンテンツはtopicContentNodeおよびtopicHeadNode プロパティで指定されたノードに公開されます。
ただし、既存のサイトの場合は、topicContentNodeとtopicHeadNode ノードを手動で追加する必要があります。
次の手順を実行して、必要なノードを既存のサイトに追加します。
-
AEMにログインし、CRXDE Lite モードを開きます。
-
サイトノード内の
jcr:contentを見つけます。 -
サイトのテンプレート設定で指定した名前と同じ名前の
topicContentNodeおよびtopicHeadNode個のノードを追加します。
公開用の基本出力場所の設定
次のタブには、Experience Manager Guidesの設定に基づいてベース出力場所を設定する手順が示されています。Cloud Serviceまたはオンプレミス。
-
設定ファイルを作成するには、設定の上書きの手順を使用します。
-
設定ファイルで、次の(プロパティ)詳細を指定して、ベース出力の場所を設定します。
table 0-row-3 1-row-3 PID プロパティキー プロパティの値 com.adobe.fmdita.config.ConfigManagerbase.output.pathデフォルト値: "/content/dam/fmdita-outputs"
-
Adobe Experience Manager Web コンソールの設定ページを開きます。
設定ページにアクセスするためのデフォルトのURLは次のとおりです。
code language-http http://<server name>:<port>/system/console/configMgr -
com.adobe.fmdita.config.ConfigManager バンドルを検索して選択します。
-
プロパティ Base Output Locationを更新して、公開後にPDFが保存されるAEM リポジトリのデフォルトパスを指定します。 さらに、無効なパスが入力されると、デフォルトのパス
/content/dam/fmdita-outputsに自動的に戻ります。 -
「保存」をクリックします。
DITA-OTを介した出力の公開でメタデータを使用する id191LF0U0TY4
AEM Guidesでは、DITA-OTを使用して出力を公開する際に、カスタムメタデータを渡す方法を提供します。 管理者およびパブリッシャーは、次のタスクを実行して、パブリッシュされた出力でカスタムメタデータを設定および使用する必要があります。
-
管理者として、システムに必要なメタデータを追加して、DITA マップのプロパティページで使用できるようにします。
-
管理者として、メタデータリストにカスタムメタデータを追加して、DITA マップコンソールに表示されるようにします。
-
パブリッシャーとして、DITA マップでカスタムメタデータを設定および追加し、必要な出力を生成します。
システムに必要なメタデータを追加するには、次の手順を実行します。
-
Adobe Experience Managerに管理者としてログインします。
-
上部のAdobe Experience Manager リンクをクリックし、ツールを選択します。
-
ツールのリストから「Assets」を選択します。
-
「メタデータスキーマ」タイルをクリックします。
メタデータスキーマのForms ページが表示されます。
-
リストからdefault フォームを選択します。
note note NOTE DITA マップのプロパティページに表示されるプロパティは、このフォームから取得されます。 -
「編集」をクリックします。
-
公開出力で使用するカスタムメタデータを追加します。 例えば、次の手順を使用してオーディエンスメタデータを追加します。
-
フォームを作成 コンポーネント リストから、単一行テキスト コンポーネントをフォームにドラッグ&ドロップします。
-
新しいフィールドを選択して、フィールドの 設定 を開きます。
-
フィールドラベルに、メタデータ名「オーディエンス」を入力します。
-
「プロパティにマッピング」設定で、を指定します。/jcr:content/metadata/< メタデータの名前> この例では、にを設定します。/jcr:content/metadata/audience.
これらの手順を使用して、必要なすべてのメタデータパラメーターを追加します。
-
-
「保存」をクリックします。
新しいパラメーターが、すべてのDITA マップのプロパティページに表示されるようになりました。
次に、カスタムメタデータをDITA マップコンソールで使用できるようにする必要があります。 次のタブには、Experience Manager Guidesの設定に基づいて、カスタムメタデータをDITA マップダッシュボードで使用できるようにする手順が示されています。Cloud Serviceまたはオンプレミス。
-
パッケージマネージャーを使用して、Cloud ManagerのGit リポジトリの次の場所にあるmetadataList ファイルにアクセスします。
/libs/fmdita/config/metadataList
note note NOTE metadataList ファイルには、マップダッシュボードのDITA マップのプロパティ ドロップダウンリストに表示されるプロパティのリストが含まれています。 デフォルトでは、このファイルには、docstate、dc:language、dc:description、dc:titleの4つのプロパティが一覧表示されます。 -
Metadata Schema Forms ページに追加したカスタムメタデータを追加します。 この例では、オーディエンスパラメーターをデフォルトリストの最後に追加します。
-
AEMにログインし、CRXDE Lite モードを開きます。
-
次の場所にあるmetadataList ファイルにアクセスします。
/libs/fmdita/config/metadataList
note note NOTE metadataList ファイルには、マップダッシュボードのDITA マップのプロパティ ドロップダウンリストに表示されるプロパティのリストが含まれています。 デフォルトでは、このファイルには、docstate、dc:language、dc:description、dc:titleの4つのプロパティが一覧表示されます。 -
Metadata Schema Forms ページに追加したカスタムメタデータを追加します。 この例では、オーディエンスパラメーターをデフォルトリストの最後に追加します。
-
「すべて保存」をクリックします。
これで、カスタムメタデータがDITA マップコンソールのプロパティ ドロップダウンリストに表示されます。
最後に、パブリッシャーは、パブリッシュされた出力にカスタムメタデータを含める必要があります。 出力の生成中にカスタムメタデータを処理するには、次の手順を実行します。
-
Assets UIで、公開するDITA マップに移動します。
-
DITA マップファイルを選択し、そのプロパティページを開きます。
-
プロパティ ページで、カスタムメタデータの値を指定します。 この例では、audience パラメーターにExternalの値を指定しています。
-
「保存して閉じる」をクリックします。
-
DITA マップファイルをクリックして、DITA マップコンソールを開きます。
-
「出力プリセット」タブで、出力の生成に使用する出力プリセットを選択します。
-
「編集」をクリックします。
-
プロパティ ドロップダウンリストから、公開プロセスに渡すプロパティを選択します。
選択したプロパティ/メタデータは公開プロセスに渡され、最終出力で使用できるようになります。
DITA-OTに渡されたメタデータを検証して処理します(Cloud Serviceのみ)
DITA-OTに渡されたメタデータ値を検証するには、クラウド対応のjarを使用したローカル環境を使用できます。 クラウド上のローカルファイルシステムにはアクセスできないので、メタデータファイルを検証する唯一の方法はクラウド対応のjarを使用することです。
-
ファイル名:metadata.xml
-
ファイルの場所:crx-quickstart/profiles/ditamaps/<ditamap-1234>
metadata.xmlにアクセスするには:
- AEM インスタンスが実行されているサーバーの場所にログインします。
- crx-quickstart/profiles/ditamaps/<new-created-directory-name>/metadata.xmlに移行します。
-
サンプルファイル形式:
metadata.xml
code language-xml <?xml version="1.0" encoding="UTF-8" standalone="no"?> <root> <Path id="/absolutePath/sampleMap.ditamap"> <metadata> <meta isArray="false" key="dc:description">This is a file</meta> <meta isArray="false" key="dc:title">Myfile</meta> <meta isArray="true" key="multivalueText">One;Two;Three</meta> </metadata> </Path> <Path id="/absolutePath/sampleTopic.dita"> <metadata> <meta isArray="false" key="dc:description">description for the accountability</meta> <meta isArray="false" key="dc:title">accountability title</meta> <meta isArray="true" key="multivalueText">value1</meta> </metadata> </Path> </root> -
isArray: メタデータが複数値\(Array\)であるかどうかを定義するブール値の属性。 値はセミコロンで区切られます。
-
パス id: temp ディレクトリの下に保存されているファイルへの絶対パス。
ルートマップメタデータを受け入れるようにDITA-OT コマンドライン引数フィールドを設定します(Cloud Serviceのみ)
DITA-OT コマンドライン引数フィールドを使用してルートマップメタデータを渡すには、次の手順を実行します。
- 設定ファイルを作成するには、設定の上書きの手順を使用します。
- 設定ファイルで、次の\(property\)詳細を指定して、プリセットのDITA-OT コマンドライン引数フィールドを設定します。
com.adobe.fmdita.config.ConfigManagerpass.metadata.args.cmd.linetrue/false\)。デフォルト値: true- プロパティ値を true に設定すると、DITA-OT コマンドライン機能が有効になり、DITA-OT コマンドラインを通じてメタデータを渡すことができます。
- プロパティ値を false に設定すると、DITA-OT コマンドライン機能が無効になります。 次に、プリセットの「プロパティ」フィールドを使用して、メタデータを渡すことができます。
DITA マップコンソールのカスタマイズ id188HC08M0CZ
AEM Guidesでは、DITA マップコンソールの機能を柔軟に拡張できます。 例えば、AEM Guidesで使用できるレポートとは異なるレポートセットがある場合、そのようなレポートをマップコンソールに追加できます。 マップコンソールをカスタマイズするには、必要な機能を実行するためのコードを含むAEM Client Library \(またはClientLib\)を作成する必要があります。
AEM Guidesには、マップコンソールをカスタマイズするためのapps.fmdita.dashboard-extn カテゴリが用意されています。 マップコンソールが読み込まれると、apps.fmdita.dashboard-extn カテゴリで作成された機能が実行され、読み込まれます。
出力生成時の画像レンディションの処理 id177BF0G0VY4
AEMには、アセットを処理するためのデフォルトワークフローとメディアハンドルのセットが付属しています。 AEMには、最も一般的なMIME タイプのアセット処理を処理するための定義済みワークフローがあります。 通常、AEMでは、アップロードした画像ごとに、同じ画像の複数のレンディションがバイナリ形式で作成されます。 これらのレンディションのサイズは異なり、解像度も異なり、透かしが追加されたり、その他の特性が変更されたりします。 AEMでのアセットの処理方法について詳しくは、AEM ドキュメントの「Media HandlersとWorkflowsを使用したAssetsの処理」を参照してください。
AEM Guidesでは、ドキュメントの出力を生成する際に使用する画像レンディションを設定できます。 例えば、デフォルトの画像レンディションのいずれかを選択するか、作成した画像レンディションを使用してドキュメントを公開できます。 ドキュメントを公開するための画像レンディションマッピングは、/libs/fmdita/config/ **renditionmap.xml** ファイルに保存されます。 renditionmap.xml ファイルのスニペットは次のとおりです。
renditionmap.xml フォルダーにapps ファイルのコピーを作成することをお勧めします。<renditionmap>
<mapelement>
<mimetype>image/png</mimetype>
<rendition output="AEMSITE">cq5dam.web.1280.1280.jpeg</rendition>
<rendition output="PDF">original</rendition>
<rendition output="HTML5">cq5dam.web.1280.1280.jpeg</rendition>
<rendition output="HTML5" outputName="ditahtml5">cq5dam.thumbnail.319.319.png</rendition>
<rendition output="EPUB">cq5dam.web.1280.1280.jpeg</rendition>
<rendition output="CUSTOM">cq5dam.web.1280.1280.jpeg</rendition>
</mapelement>
...
</renditionmap>
mimetype要素は、ファイル形式のMIME タイプを指定します。 rendition output要素は、指定された出力の公開に使用する出力形式のタイプとレンディション \(例:cq5dam.web.1280.1280.jpeg\)の名前を指定します。 サポートされているすべての出力形式(AEMSITE、PDF、HTML5、EPUB、カスタム)に使用する画像レンディションを指定できます。
出力プリセットに異なる画像レンディションを指定する場合は、outputName属性を使用して、その値をプリセットのタイトルに設定し、同じ出力タイプの特定の出力プリセットに対するカスタムレンディションを定義できます。 これは、様々な公開シナリオに対して異なる画像サイズまたは形式が必要な場合に便利です。
例:
<renditionmap>
<mapelement>
<mimetype>image/png</mimetype>
<rendition output="HTML5">cq5dam.web.1280.1280.jpeg</rendition>
<rendition output="HTML5" outputName="ditahtml5">cq5dam.thumbnail.319.319.png</rendition>
</mapelement>
...
</renditionmap>
上記のレンディションでは、outputName属性がditahtml5 (プリセットタイトル)に設定されている場合、ditahtml5 プリセットはサムネール画像cq5dam.thumbnail.319.319.pngを使用します。 outputName属性が指定されていない場合、すべてのHTML5出力で大きな画像cq5dam.web.1280.1280.jpegが使用されます。
指定したレンディションが存在しない場合、AEM Guides公開プロセスは最初に指定した画像のweb レンディションを検索します。 Web レンディションが見つからない場合でも、画像の元のレンディションが使用されます。
出力履歴の自動削除期間の設定 id19AAI070V8Q
出力を生成すると、出力は出力ログと共に作成されます。 大規模なDITA マップの場合、これらのログはリポジトリ内で大きなスペースを取る可能性があります。 デフォルトでは、ログはリポジトリ内の次の場所に保存されます。
/var/dxml/metadata/outputHistory
時間の経過とともに、すべてのログファイルの合計サイズがGBに達する可能性があります。 AEM Guidesでは、これらのログファイルをリポジトリに保持する期間を設定できます。 指定された期間が経過すると、出力生成履歴と共にログがリポジトリから削除されます。
履歴パージ機能を設定すると、リポジトリ内のすべてのDITA マップの出力生成に影響します。 DITA マップの「出力」タブでは、履歴は指定された日数の後、設定で指定された時間に消去されます。
次のタブでは、Experience Manager Guidesの設定に基づいて出力履歴とログをパージする日時を設定する手順を示します。Cloud Serviceまたはオンプレミス。
設定ファイルを作成するには、設定の上書きの手順を使用します。 設定ファイルに次の\(property\)詳細を指定して、出力履歴とログをパージする日時を設定します。
| table 0-row-3 1-row-3 2-row-3 | ||
|---|---|---|
| PID | プロパティキー | プロパティの値 |
com.adobe.fmdita.config.ConfigManager|output.history.purgeperiod |
出力ログとともに出力履歴が消去されるまでの日数を指定します。 この機能を無効にする場合は、このプロパティで指定された日数より前に生成された出力に対してパージ処理が実行される指定された時間に、このプロパティを0.Everydayに設定します。 | デフォルト値: 5 |
output.history.purgetime |
パージ処理が開始される時間を指定します。 | デフォルト値: 0:00 \(または12:00 midnight\) |
-
Adobe Experience Manager Web コンソールの設定ページを開きます。
設定ページにアクセスするためのデフォルトのURLは次のとおりです。
code language-http http://<server name>:<port>/system/console/configMgr -
com.adobe.fmdita.config.ConfigManager バンドルを検索してクリックします。
-
出力履歴のパージ期間 プロパティで、出力ログと共に出力履歴がパージされるまでの日数を指定します。 デフォルトでは、5日に設定されています。 この機能を無効にする場合は、このプロパティを0に設定します。
-
出力履歴パージ時間 プロパティで、パージ プロセスが開始される時間を指定します。 デフォルトでは、0:00 \(または12:00 midnight\)に設定されています。 この時点では、パージ処理は毎日、出力履歴パージ期間 プロパティで指定された日数より前に生成された出力に対して実行されます。
note note NOTE デフォルトでは、パージ機能は5日より古い出力で毎晩0時に実行されます。 -
「保存」をクリックします。
最近生成された出力リストの制限を変更する id1679JH0H0O2
DITA マップの「出力」タブに表示される生成された出力の最大数を変更できます。
設定ファイルを作成するには、設定の上書きの手順を使用します。 設定ファイルで、リストに表示する出力数を変更するには、次の\(property\)詳細を指定します。
| table 0-row-3 1-row-3 | ||
|---|---|---|
| PID | プロパティキー | プロパティの値 |
com.adobe.fmdita.config.ConfigManager |
output.historylimit |
整数値。 デフォルト値: 25 |
com.adobe.fmdita.config.ConfigManager設定を更新します。出力生成パフォーマンスの最適化(オンプレミスのみ) id176LB050VUI
AEM Guidesでは、同時に実行される出力生成プロセスの数を制御する出力生成プロセスのプールサイズを設定できます。 デフォルトでは、プロセスプールサイズは、システムで使用可能な処理コアの数に1を加えた数に設定されます。 順次公開する場合は、この値を1に変更できます。 この場合、最初の公開タスクが実行され、次の公開タスクが公開キューに保存されます。
出力生成処理プールのサイズを変更するには、バンドルの生成プールのサイズ com.adobe.fmdita.publish.manager.PublishThreadManagerImpl設定を更新します。
FrameMaker Publishing Serverの設定(オンプレミスのみ) id1678G0Z0TN6
FrameMaker Publishing Server \(FMPS\)を使用して、DITA コンテンツの出力を生成できます。 FMPSを設定すると、FMPSでサポートされている複数の形式で出力を生成できます。
FMPSを使用するようにAEM Guidesを設定するには、Web コンソールでcom.adobe.fmdita.config.ConfigManager バンドルの次のプロパティを更新します。
~ FMPS 2019以前のIP アドレスまたはドメイン名
- FMPS 2020:
http://<fmps_ip>:<port> \(http://192.168.1.101:7000\)- FMPS 2019以前:
http://<fmps_ip>:<port>/fmserver/v1/として指定します- FMPS 2020: 2020
- FMPS 2019以前: 2019または2017として指定します
デフォルト値:300秒\(5分\)
http://<server-name>:<port>/ のように指定します。