グローバルプロファイルの設定

グローバルプロファイルを設定するには、次の手順を実行します。

  1. Adobe Experience Managerに管理者としてログインします。

  2. 上部の「Adobe Experience Manager」リンクをクリックし、「ツール」を選択します。

  3. ツールのリストから「ガイド」を選択し、「フォルダープロファイル」をクリックします。

    初めて、フォルダープロファイルページがグローバルプロファイルタイルのみで表示されます。

  4. グローバルプロファイル タイルをクリックします。

  5. 条件属性 を設定するには、 グローバルプロファイルまたはフォルダーレベルのプロファイルの条件属性の設定を参照してください。

  6. テンプレート を設定するには、 オーサリングテンプレートの設定を参照してください。

  7. 出力プリセット を設定するには、 出力プリセットの設定を参照してください。

  8. XML エディター設定を設定するには、XML エディターの設定とカスタマイズを参照してください。

  9. 必要な更新をすべて行ったら、グローバルプロファイル を保存して閉じます。

フォルダーレベルのプロファイルの作成と設定

フォルダーレベルのプロファイルを設定するには、次の手順を実行します。

  1. Adobe Experience Managerに管理者としてログインします。

  2. 上部の「Adobe Experience Manager」リンクをクリックし、「ツール」を選択します。

  3. ツールのリストから ガイド を選択し、フォルダープロファイル タイルをクリックします。

    初めて使用する場合、フォルダープロファイルページにはデフォルトのグローバルプロファイルタイルのみが表示されます。

  4. 作成」をクリックします。

  5. フォルダープロファイルを作成 ダイアログに、次の詳細を入力します。

    • フォルダープロファイルの名前。

    • プロファイルが適用されるフォルダーのパス。

      NOTE
      1 つのフォルダーに複数のフォルダープロファイルを適用することはできません。 ここで選択しているフォルダーには、他のプロファイルが適用されていないことを確認してください。 親子フォルダーに独自の特定プロファイルがある場合、子フォルダーはその独自のプロファイルの設定を使用します。 親フォルダーの設定は、子フォルダーの設定を上書きしません。
  6. 作成」をクリックします。

    フォルダープロファイルという名前の新しいタイルがフォルダープロファイル ページに作成されます

  7. 編集するフォルダープロファイルタイルをクリックします。

    フォルダープロファイルの名前と設定済みのフォルダー情報を含む「一般」タブが表示されます。

  8. 複数のフォルダーと、フォルダープロファイルを変更するための管理アクセス権を持つユーザーを追加するには、「編集」をクリックします。

    NOTE
    ここに追加するユーザーには、このフォルダープロファイルに設定された条件属性、テンプレートおよび出力プリセットを更新するための管理者権限が与えられます。
  9. フォルダーを追加するには、フォルダーパスの「参照」アイコンをクリックし、フォルダーに移動して選択します。次に、「追加」をクリックし、フォルダーをこのプロファイルに追加します。

    NOTE
    ここで選択したフォルダーには、他のフォルダーレベルのプロファイルが関連付けられていないことを確認してください。
  10. ユーザーを追加するには、「管理者ユーザー」ドロップダウンからユーザーを選択し、「追加」をクリックします。

    NOTE
    ドロップダウンリストからフォルダープロファイルに複数のユーザーを追加できます。 ユーザー ID の横にある削除アイコンをクリックして、リストから既存の管理者ユーザーを削除することもできます。
  11. 必要なフォルダーとユーザーをすべてフォルダープロファイルに追加したら、「保存」をクリックします。

これで、条件付き属性、テンプレート、出力プリセットおよび XML エディターを設定する準備が整いました。

IMPORTANT
フォルダープロファイルを作成すると、デフォルトではテンプレートは含まれません。 作成者が使用できるように、必要なテンプレートをフォルダープロファイルに追加する必要があります。

グローバルプロファイルまたはフォルダーレベルのプロファイルの条件属性の設定

次の手順を実行して、グローバルまたはフォルダーレベルで標準の DITA サポート条件付き属性を設定します。

  1. フォルダーレベルのプロファイルで、管理者または管理者権限を持つユーザーとしてAdobe Experience Managerにログインします。

  2. 上部の「Adobe Experience Manager」リンクをクリックし、「ツール」を選択します。

  3. ツールのリストから ガイド を選択し、フォルダープロファイル タイルをクリックします。

  4. 設定するプロファイルタイルをクリックします。

    NOTE
    条件付き属性は、グローバルプロファイルまたはフォルダーレベルのプロファイルで設定するように選択できます。
  5. プロファイルページで、「条件付き属性 タブをクリックします。

  6. 編集」をクリックします。

  7. 追加」をクリックします。

  8. 条件属性の 名前ラベル を入力します。

    属性名のみを持つプロファイルを保存できます。 ただし、属性は、値が指定されている場合にのみ使用できます。 属性に – 値とラベルの両方を指定した場合、Web エディタには条件付き属性のラベルが表示されます。 また、条件付きプリセットの作成時に、ラベルが公開管理者に表示されます。

    次のスクリーンショットは、可能な値とラベルを含んだ platform 属性の定義を示しています。

  9. 同じ属性に対してさらに値を追加する場合は、+ アイコンをクリックし、追加の値とラベルを入力します。

  10. さらに属性を追加する場合は、「追加」をクリックします。

  11. 保存」をクリックします。

カスタム属性を使用する場合は、DTD でサポートされている有効な DITA 属性である必要があります。 標準の DITA 属性ではない任意の属性を使用する場合は、次の追加手順を実行します。

  1. カスタム属性を DTD ファイルに追加します。 たとえば、DTD ファイルが commonElements.mod の場合、このファイルを DTD ディレクトリ内に配置する必要があります。 システム DTD ファイルのデフォルトパスは次のとおりです。

    /libs/fmdita/dita_resources/DITA-1.3/dtd/base/dtd/commonElements.mod

    IMPORTANT
    専用の DTD ファイルは、カスタムコード配置の一部である必要があります。 /apps の下の DTD は製品デプロイメントの一部なので、新しいリリースのインストールで上書きされます。 特殊な DTD を/var/dxml/dita_resources の下にプロジェクトフォルダ内に追加し、DTD/カタログパスを DITA プロファイルに含めることをお勧めします。詳しくは、DITA 特殊化の統合を参照してください。
  2. パッケージマネージャーを使用して/libs/fmdita/config/condAttrList.xml ファイルをダウンロードします。

  3. condAttrList.xml ファイルのコピーを、Cloud Manager Git リポジトリ内の次の場所に作成します。

    /apps/fmdfmdita/config/condAttrList.xml

  4. ファイルを保存します。

  5. グローバルまたはフォルダーレベルのプロファイルにカスタム属性を追加します。

テンプレートの設定

AEM Guidesには、7 つの標準トピックテンプレート、2 つの DITA マップテンプレート、3 つのPDF テンプレートが付属しています。 作成者と公開者が使用できるテンプレートを数個だけ選択できます。 カスタムテンプレートを使用している場合は、これと同じテンプレートを設定して、オーサリングと公開に使用できます。 フォルダープロファイル設定の「テンプレート」タブを使用して、グローバルプロファイルまたはフォルダーレベルのプロファイルに対して、トピック、マップまたはPDFのテンプレートの追加や削除を行います。

グローバルレベルまたはフォルダーレベルでトピック、マップまたはPDFのテンプレートを設定する前でも、カスタムテンプレートを保存する場所を定義できます。 テンプレートを保存するカスタムの場所を設定するには、 カスタム DITA テンプレート フォルダ パスを設定を参照してください。

次の手順を実行して、トピック、マップまたはPDFのテンプレートをフォルダープロファイルに追加します。

  1. フォルダーレベルのプロファイルで、管理者または管理者権限を持つユーザーとしてAdobe Experience Managerにログインします。

  2. 上部の「Adobe Experience Manager」リンクをクリックし、「ツール」を選択します。

  3. ツールのリストから ガイド を選択し、フォルダープロファイル タイルをクリックします。

  4. 設定するプロファイルタイルをクリックします。

    NOTE
    グローバルプロファイルまたはフォルダーレベルのプロファイルでテンプレートの設定を選択できます。
  5. プロファイルページで、「テンプレート」タブをクリックします。

  6. 編集」をクリックします。

    トピック、マップ、PDFの各テンプレートを追加するオプションを使用するには、デフォルトの場所から検索するか、テンプレートを参照します。

    NOTE
    デフォルトでは、すべてのテンプレートが/content/dam/dita-templates フォルダに保存されます。 dita-templates フォルダーには、トピック、マップ、PDFのテンプレートを格納する topicsmapsPDF のサブフォルダーが含まれています。 カスタムテンプレート \(.dita,.xml, or .ditamapfiles\)をデフォルトテンプレートフォルダに追加できます。 デフォルトフォルダーにテンプレートを追加すると、それらをグローバルプロファイルまたはフォルダープロファイルに追加できるようになります。 Web エディターを使用してカスタムテンプレートを作成する方法について詳しくは、「 カスタムオーサリングテンプレートの作成」を参照してください。

  7. 必要なトピック、マップおよびPDF テンプレートをプロファイルに追加します。

    テンプレートを追加するには、次のいずれかの操作を行います。

    • 検索またはタイプ を選択して、ドロップダウンリストからテンプレートの名前を入力または選択します。 ドロップダウンリストは、すべてのデフォルトテンプレートと、作成した新しいテンプレートで構成されます。

    • 参照 をクリックし、DAM からテンプレートを選択します。

  8. 追加」をクリックします。

    選択したテンプレートがテンプレートリストに追加されます。

    NOTE
    テンプレートの順序を変更するには、リストの目的の位置にテンプレートをドラッグ&ドロップします。 テンプレートの位置は、トピックまたはマップ作成ワークフローでのブループリントページに表示される順序を制御します。
  9. 翻訳ルールを設定するには、SRX の場所を参照し、SRX ファイルを含むフォルダーを見つけます。 SRX \(Segmentation Rules eXchange\)形式は、異なるユーザーや翻訳環境の間でセグメント化ルールを交換するための標準です。 フォルダーを作成し、それにカスタム SRX ファイルを追加できます。

    SRX ファイルを含むフォルダーを作成したら、フォルダープロファイル内の 翻訳 SRX の場所 設定にフォルダーパスを追加できます。

    AEM Guidesでは、翻訳プロジェクトのソース言語に従って SRX ルールが選択されます。 言語のカスタム SRX ファイルを探し、カスタム SRX ファイルを定義しない場合は、標準の翻訳ルールに従ってルールが選択されます。

  10. 保存」をクリックします。

フォルダーレベルのプロファイルでテンプレートを設定した場合、設定済みのテンプレートは、設定済みのフォルダーに関連付けられます。 設定済みフォルダーの下に作成されたすべてのプロジェクトは、フォルダーレベルのプロファイルの下に設定されたテンプレートにのみアクセスできます。

カスタムオーサリングテンプレートの作成

AEM Guidesでは、オーサリングテンプレートを簡単に作成できます。 システム管理者は、web エディターを使用してオーサリングテンプレートを最初から作成できます。 その後、グローバルプロファイルに新しいテンプレートを追加するか、フォルダー固有のプロファイルを使用して特定のフォルダーに割り当てることができます。

カスタムオーサリングテンプレートを作成するには、次の手順を実行します。

  1. Adobe Experience Managerに管理者としてログインします。

  2. Assets UI で、テンプレートファイルを格納するように設定されたフォルダーに移動します。 デフォルトでは、すべてのトピックテンプレートは/content/dam/dita-templates/topics フォルダーに保存されます。

    NOTE
    トピックまたはマップ テンプレートを保存するカスタムの場所を設定するには、 カスタム DITA テンプレート フォルダ パスの設定を参照してください。
  3. 作成 > DITA テンプレート をクリックします。

  4. 「ブループリント」ページで、作成する DITA トピックテンプレートのタイプを選択します。

    NOTE
    空白テンプレートを使用してゼロから開始できます。 空白テンプレートには構造も要素も含まれていません。
  5. 次へ」をクリックします。

  6. 新しいテンプレートのプロパティページで、テンプレートの タイトル名前 および 説明 を入力します。

    NOTE
    テンプレートのタイトルに基づいて、名前が自動的に提案されます。 名前を手動で指定する場合は、「名前」にスペース、アポストロフィ、または中括弧が含まれず、.dita で終わっていることを確認してください。
  7. \(オプション\) テンプレートのブラウザーに関連付ける サムネールを追加 ボタンをクリックし、テンプレートに関連付けるサムネールを選択します。

  8. 作成」をクリックします。

    「トピックを作成しました」のメッセージが表示されます。

    編集するテンプレートを Web エディターで開くか、テンプレートの保存場所にテンプレート ファイルを保存するかを選択できます。 テンプレートを作成したら、web エディターを使用して、オーサリングのニーズに合わせてテンプレートをカスタマイズできます。 テンプレートを配置したら、必ずグローバルプロファイルまたはフォルダーレベルのプロファイルに関連付けます。

出力プリセットの設定

一般的なエンタープライズ設定では、異なる製品やユーザーガイドに異なる出力テンプレートを使用できます。 また、すべてのパブリッシャーが使用する共通の出力生成プロセスと、特定のパブリッシャーまたはプロジェクトのグループに対する特定の出力生成プロセスのセットが存在する場合もあります。

AEM Guidesでは、管理者は、特定の設定を使用して出力プリセットを作成し、それをすべてまたは特定のパブリッシャーが使用して出力を生成できます。 例えば、管理者は 1 つの出力プリセットを作成して、すべての公開者に共通のユーザーガイドを生成できます。 もう 1 つは、パブリッシャーのセットに固有のプログラミングユーザーマニュアルを作成することです。 これらのプリセットは両方とも、異なる出力テンプレートを使用するように設定できます。 この例では、ユーザーガイドを生成するための一般的な公開プリセットをグローバルレベルで設定できます。 また、プログラミングユーザマニュアルを生成するための出力プリセットは、フォルダレベルで設定することができる。

システムにデフォルトの出力プリセットが作成されると、それ以降に作成されたすべての DITA マップはデフォルトのプリセットを使用して出力を生成します。 ただし、既存のすべての DITA マップは、以前に設定された出力プリセットを引き続き使用します。 既存のすべての DITA マップに新しい出力プリセットを適用する場合は、「プリセット変更の適用」ワークフローを実行する必要があります。

パブリッシャーには、グローバルレベルまたはエンタープライズレベルで設定されるプリセットに加えて、さらに出力プリセットを作成する権限も残ります。 ただし、これらのプリセットは、作成対象の DITA マップに関連付けられています。 DITA マップの通常の出力プリセットの作成について詳しくは、『Adobe Experience Manager Guides as a Cloud Serviceの使用 ガイド』の「出力プリセットの作成、編集、複製、削除 を参照してください。

グローバルまたはフォルダー固有の出力プリセットを設定するには、次の手順を実行します。

  1. フォルダー固有のプロファイルに対する管理者権限を持つユーザーまたは管理者としてAdobe Experience Managerにログインします。

  2. 上部の「Adobe Experience Manager」リンクをクリックし、「ツール」を選択します。

  3. ツールのリストから ガイド を選択し、フォルダープロファイル タイルをクリックします。

  4. 設定するプロファイルタイルをクリックします。

    NOTE
    出力プリセットは、グローバルプロファイルまたはフォルダー固有のプロファイルで設定できます。
  5. プロファイルページ。 「出力プリセット」タブをクリックします。

    標準提供の出力プリセット(AEM Site、PDF、HTML5、EPUB、CUSTOM など)のリストが表示されます。

  6. 出力プリセットを作成または編集するには、以下のいずれかの操作を行います。

    • 作成」をクリックして、新しい出力プリセットを最初から作成します。

    • 「複製」をクリックして、選択した出力プリセットのコピーを作成します。 複製したプリセットに変更を加えて保存することができます。

    • 編集 をクリックして、選択したプリセットの設定を編集用に開きます。

      出力プリセットの設定については、『Adobe Experience Manager Guides as a Cloud Serviceの使用 ガイドの「出力プリセットについて を参照してください。

  7. 保存 をクリックして、プリセット設定を保存します。

この後に作成またはアップロードされたすべての DITA マップには、新しい出力プリセットまたは更新された出力プリセットが設定されます。

プリセットの変更の適用

グローバルレベルで作成された新しい出力プリセットは、今後作成するすべての新しい DITA マップで使用できます。 同様に、新しい出力プリセットがフォルダーレベルで作成された場合、そのプリセットは、設定済みのフォルダーに作成されるすべてのマップで使用できるようになります。 デフォルトでは、新しい出力プリセットは既存の DITA マップでは使用できません。

既存の出力プリセットを更新した場合、または既存の DITA マップで新しい出力プリセットを使用できるようにする場合は、次の手順を実行します。

  1. フォルダー固有のプロファイルに対する管理者権限を持つユーザーまたは管理者としてAdobe Experience Managerにログインします。

  2. 上部の「Adobe Experience Manager」リンクをクリックし、「ツール」を選択します。

  3. ツールのリストから ガイド を選択し、フォルダープロファイル タイルをクリックします。

  4. 設定するプロファイルタイルをクリックします。

    NOTE
    出力プリセットは、グローバルプロファイルまたはフォルダー固有のプロファイルで設定できます。
  5. プロファイルページ。 「出力プリセット」タブをクリックします。

    標準提供の出力プリセット(AEM Site、PDF、HTML5、EPUB、CUSTOM など)のリストが表示されます。

  6. 既存の DITA マップに適用する出力プリセットを選択します。

  7. メインツールバーの「プリセットの変更を適用」をクリックします。

  8. プリセットの変更を適用ダイアログでは、次の中から選択できます。

    • 「既存のプリセットを上書き」オプションの選択:このオプションを選択すると、既存の出力プリセットで行った更新によって、そのプリセットが使用されている既存のすべての DITA マップの設定が上書きされます。 ただし、その場合、マップに関連付けられた既存の条件付きプリセットおよびベースライン情報は失われます。

    • 「既存のプリセットを上書き」オプションを選択しない:このオプションを選択しない場合、既存の出力プリセットで行った更新は、既存の DITA マップには影響しません。 新しく追加されたプリセットのみが既存の DITA マップに追加されます。 新しく作成された DITA マップには、更新された出力プリセットと新しく追加されたプリセットの両方が取り込まれます。

  9. OK をクリックして、選択した出力プリセットからの変更を既存のすべての DITA マップに適用します。

スマートヘルプとオーサリングのための AI アシスタントの設定

AEM cloud Experience Manager Guides as a Cloud Serviceの場合。

Adobe Experience Manager Guidesの AI アシスタントは、スマートオーサリングとコンテンツ再利用エクスペリエンスを通じてコンテンツを強化するように設計された、強力な AI 駆動ツールです。 オーサリングヘルプ の 2 つの堅牢な AI 機能がExperience Manager Guides インターフェイスに統合されているため、ドキュメントを作成し、より迅速かつ効率的に情報にアクセスできます。

設定の詳細については、AI Assistant configuration を参照してください。

AI を活用してスマートな提案を設定

AI を活用してスマートな提案を設定し、作成者が既存のコンテンツを再利用して、正しい一貫性のあるコンテンツ参照を簡単に作成できるようにします。 「AI 設定」タブを使用すると、web エディターの AI アシスタントパネルから 再利用可能なコンテンツを提案 の設定を制御できます。

グローバルレベルまたはフォルダーレベルのプロファイルで標準 AI 設定を設定するには、次の手順を実行します。

  1. フォルダーレベルのプロファイルの管理者または管理者権限を持つユーザーとしてAdobe Experience Managerにログインします。

  2. 上部の Adobe Experience Manager リンクを選択し、「ツール」を選択します。

  3. ツールのリストから ガイド を選択し、フォルダープロファイル タイルを選択します。

  4. 設定するプロファイルタイルを選択します。

    NOTE
    グローバルプロファイルまたはフォルダーレベルのプロファイルに対して、AI ベースのスマートな提案を設定できます。
  5. プロファイルページで、「AI 設定」タブを選択します。

    グローバルプロファイルの「AI 設定」タブ

  6. 編集」を選択します。

  7. 管理者は、次の設定を行うことができます。

    最小文字数:作成者が提案を取得するために入力する必要がある最小文字数を入力します。 例えば、この数値が 7 の場合、作成者がスマート提案を表示するには、7 文字以上追加する必要があります。

    最大候補:作成者がコンテンツのオーサリング中に取得できる候補の最大数を入力します。 例えば、この数値が 5 の場合、作成者は 5 つ以下のスマート候補を表示できます。

    ファイルとフォルダー:スマート候補を表示するファイルまたはフォルダーを選択します。 コンテンツの一貫性を保つため、リスト内の 2 つのエントリの間に共通のファイルを持つことはお勧めしません。 ファイルとフォルダーを選択すると、一覧表示されます。

  8. 保存」をクリックします。

    NOTE
    ファイルを保存すると、最後にインデックス付けされたステータスの詳細が上部に表示されます。

Web エディターでのオーサリング中にコンテンツ参照を追加する AI ベースのスマート候補を表示および追加する方法について説明します。

スマートヘルプのデフォルトの質問のカスタマイズ

AEM cloud Experience Manager Guides as a Cloud Serviceの場合。

AI を活用したスマートな ヘルプ を設定すると、作成者が質問したり、Experience Manager Guides ドキュメントから必要なコンテンツを簡単に見つけたりするのに役立ちます。

XML エディター設定」タブでは、「ヘルプ パネルのデフォルトの質問を設定できます。

NOTE
デフォルトの質問は最大 10 個まで設定できます。

デフォルトの質問を設定するには、次の手順を実行します。

  1. フォルダーレベルのプロファイルの管理者または管理者権限を持つユーザーとしてAdobe Experience Managerにログインします。

  2. 上部の Adobe Experience Manager リンクを選択し、「ツール」を選択します。

  3. ツールのリストから ガイド を選択し、フォルダープロファイル タイルを選択します。

  4. 設定するプロファイルタイルを選択します。

    NOTE
    スマートヘルプパネル のデフォルトの質問を、グローバルプロファイルまたはフォルダーレベルのプロファイルに設定できます。
  5. XML エディター設定」タブを選択します。

  6. 上部の 編集 アイコンをクリックします。

  7. XML エディターの UI 設定」セクションで「ダウンロード」アイコンを選択して、ui_config.json ファイルをローカルシステムにダウンロードします。

  8. ui_config.json ファイルに、サンプルの質問を追加します。

    サンプル質問の例:

    "assistantSampleQuestions": [
    "How to create a new topic",
    "How to create a new map",
    "What is a baseline" ]
    
  9. ファイルを保存してアップロードします。

    NOTE
    ファイルを保存すると、デフォルトの質問が スマートヘルプ パネルに表示されます。

AI を利用したスマートヘルプを使用して、必要なコンテンツを見つける方法について詳しくは、Experience Manager Guides ドキュメントを参照してください。