DITAVAL エディター ditaval-editor

DITAVAL ファイルは、条件付き出力の生成に使用されます。 単一のトピックで、要素の属性を使用してコンテンツの条件を設定する条件を追加できます。 次に、DITAVAL ファイルを作成します。このファイルでは、コンテンツを生成するために取得する必要がある条件と、最終的な出力から除外する必要がある条件を指定します。

Adobe Experience Manager Guidesでは、DITAVAL エディタを使用して DITAVAL ファイルを簡単に作成および編集できます。 DITAVAL エディタは、システムで定義されている属性（条件として使用できる）を取得し、これらを使用して DITAVAL ファイルを作成または編集できます。 Adobe Experience Managerでの条件の作成と管理について詳しくは、Adobe Experience Manager ドキュメントの タグの管理の節を参照してください。

以下の節では、Experience Manager Guidesの DITAVAL ファイルで使用できるオプションについて説明します。

DITAVAL ファイルの作成

DITAVAL ファイルを作成するには、以下の手順を実行します。

指定したパスにトピックが作成されます。 また、エディターでトピックが開いて編集できます。

DITAVAL ファイルの編集

DITAVAL トピックを作成すると、エディタで開いて編集できます。 既存の DITAVAL トピックを編集するには、DITAVAL トピックが存在するフォルダまたはマップに移動し、オプション メニューから 編集 を選択します。

DITAVAL エディタでは、エディタのツールバーのオプションを使用して、以下に示すように複数のタスクを実行できます。

エディターツールバーオプション

メニュードロップダウン

メニュードロップダウンから、編集アクション、検索と置換、バージョン履歴、バージョンラベル、結合、レビュータスクの作成、変更の追跡、タグ機能にアクセスできます。
詳しくは、「 メニュー」ドロップダウンオプションを参照してください。

Prop を追加

DITAVAL ファイルに 1 つのプロパティを追加します。

{width="650"}

最初のドロップダウンには、DITAVAL ファイルで使用できる DITA 属性が表示されます。

2 つ目のドロップダウンリストには、選択した属性に設定された値が表示されます。 次に、選択した属性に対して設定できるアクションが次のドロップダウンリストに表示されます。 アクションドロップダウンで使用できる値は、include、exclude、passthrough、flag です。 これらの値について詳しくは、OASIS DITA 文書の prop 要素の定義を参照してください。 属性に追加されたプロパティのアクションの詳細については、 プロパティのアクションを参照してください。

収益プロパティを追加

XML のタグに特定のリビジョン番号を追加するには、Add rev prop オプションを使用します。 rev 属性がタグに追加され、その値は、プロパティに対して選択したアクションと共に、「値」フィールドで定義された値となります。 このリビジョン属性は、後で出力の生成時に、指定されたリビジョン番号に基づいて関連する XML コンテンツをフィルタリングするために使用できます。

{width="650"}

すべての Prop を追加

システムで定義されているすべての条件付きプロパティまたは属性を 1 回のクリックで追加する場合は、すべての prop の追加機能を使用します。 アクションドロップダウンで使用できる値は、include、exclude、passthrough、flag です。 これらのアクションの詳細については、以下で説明します。

{width="650"}

プロパティのアクション

特定のプロパティで使用できるアクションは主に 4 つあり、次のようにリストされています。

Include: 出力にコンテンツを含めます。 特に設定しない限り、これはデフォルトの動作です。

除外： コンテンツを出力から除外します（特定の属性のすべての値が除外される場合）。

パススルー： 出力に内容を含め、属性値を出力ストリームの一部として保持して、実行時エンジンによるさらに処理（個々のユーザー設定に基づく実行時フィルタリングなど）を行います。

フラグの追加： 出力内のコンテンツにフラグを立てるには、ファイル内の目的の属性のアクションとしてフラグを設定します。 また、以下のスニペットに示すように、フラグスタイル ドロップダウンを使用して、様々なフラグスタイルを適用することもできます。

{width="650"}

バージョン情報と新しいバージョンとして保存

バージョン情報と新しいバージョンとして保存機能は、バージョントラッキングとコンテンツ保存を 1 つの機能に統合したものです。
詳しくは、「新しいバージョンとして保存 を参照してください

ロック/ロック解除

現在のファイルをロックまたはロック解除します。 ファイルをロックすると、そのファイルへの排他的な書き込みアクセスが可能になります。
詳しくは、 ファイルのロック解除を参照してください

コンテンツを保存

DITAVAL ファイルの編集が完了したら、タブバーの 保存 を選択します。

DITAVAL エディタ ビュー

Adobe Experience Manager Guidesの DITAVAL Editor では、次の 2 つの異なるモードまたはビューでの DITAVAL ファイルの表示がサポートされています。

オーサー: これは、DITAVAL エディタの What You See が What You Get \（WYSISYG\） ビューを表示する典型的なものです。 プロパティ、値、アクションをドロップダウンリストに表示するシンプルなユーザーインターフェイスを使用して、プロパティを追加または削除できます。 オーサービューには、個々のプロパティを挿入し、1 回のクリックですべてのプロパティを挿入するオプションがあります。

また、ファイル名の上にカーソルを置くと、現在作業中の DITAVAL ファイルのバージョンを見つけることができます。

Source: Source ビューには、DITAVAL ファイルを構成する基になる XML が表示されます。 作成者は、このビューで通常のテキスト編集を行うだけでなく、スマートカタログを使用してプロパティを追加または編集することもできます。

スマートカタログを呼び出すには、任意のプロパティ定義の末尾にカーソルを置いて、「<」と入力します。 エディターには、その場所に挿入できるすべての有効な XML 要素のリストが表示されます。

Assets UI での DITAVAL ファイルの操作

Assets UI から DITAVAL ファイルを作成することもできます。 新しい DITAVAL トピックを作成する手順は次のとおりです。

DITAVAL エディタで編集するために DITAVAL ファイルを開くか、またはAdobe Experience Manager リポジトリにトピック ファイルを保存するかを選択できます。

既存の DITAVAL ファイルを編集するには、以下の手順を実行します。