条件式を使用してコンテンツ クエリを構築する

• クエリでは、大文字と小文字が区別される。
• 1 つの句から成る単体クエリまたは複数句から成る複合クエリを指定できる。複合クエリでは、クエリの複数の句の評価順序を括弧で指定し、句の評価に and (&&) や or (||) ロジックを使用します。
• プレースホルダでは、一度に表示できるコンテンツ項目は 1 つのみ。プレースホルダを使ってキャンペーンおよび独自のデフォルト クエリからクエリを実行する場合、複数のクエリを実行可能ですが、一度に実行できるクエリは 1 つのみであり、実行可能なクエリはプレースホルダの重み付け方法によって決まります。クエリの実行結果として複数のコンテンツ項目が返される場合がありますが、プレースホルダには取得したコンテンツ項目のうちの 1 つのみが表示されます。

• 開発用サーバを起動し、WebLogic Workshop でテスト用プレースホルダまたはコンテンツ セレクタを作成し、[コンテンツ検索] ウィンドウの [詳細] タブでクエリを作成する。取得したコンテンツは WebLogic Workshop の [コンテンツ プレビュー] ウィンドウに表示されます。userProperty() フォーマットでクエリの値を取得する場合、[コンテンツ プレビュー] ウィンドウの [プレビュー ユーザ] フィールドにユーザ名を入力してユーザの値を取得し、取得したコンテンツ項目を表示する必要があります。
• [詳細] クエリ ウィンドウでは、コードに色を付けてクエリのコンテキスト エラーを強調表示することができる。
• 既存のクエリを [詳細] クエリ ウィンドウに貼り付けて再使用することができる。

プロパティ

コンテンツにはユーザ定義コンテンツ プロパティと明示的 (システム) コンテンツ プロパティの 2 種類があり、どちらもクエリで使用できます。

ユーザ定義コンテンツ プロパティは、WebLogic Administration Portal で定義されたタイプ セットに格納されます。たとえば、「Book」(本) というタイプを作成して、「title」(タイトル)、「author」(著者)、「pub_date」(出版日)、「isbn」(ISBN) などのプロパティを追加することができます。

明示的なコンテンツ プロパティは、コンテンツ項目をコンテンツ リポジトリに追加したときにすべてのコンテンツ項目に自動的に関連付けられ、コンテンツ項目の値も自動的に割り当てられます。明示的なコンテンツ プロパティの一覧を以下に示します。これらのプロパティは com.bea.content.expression.Search クラスにも含まれています。

クエリにプロパティ名を指定する場合、引用符を付ける必要はありません。

たとえば、title <比較演算子> <値> のように指定します。

ただし、プロパティ名にスペース、二重引用符、ダッシュが含まれている場合は、toProperty() フォーマット内のプロパティ名を引用符で囲む必要があります。

たとえば、toProperty('Favorite Author') <比較演算子> <値> のように指定します。

このクエリでは、すべてのコンテンツ タイプのプロパティ名が検索対象となり、コンテンツ項目がクエリの条件を満たしていれば、指定したプロパティ値を持つすべてのコンテンツ項目が返されます。これに対して、指定したタイプのプロパティのみを抽出することもできます。たとえば、タイプ「books」とタイプ「articles」があり、どちらにも「title」プロパティがある場合、タイプ「books」のみから特定の「title」を持つコンテンツ項目を取り出すことができます。それには cm_objectClass プロパティを使用します。

たとえば、title likeignorecase '*Adventure' && cm_objectClass = 'books' のように指定します。

比較演算子

比較演算子は、クエリのプロパティとユーザが入力した値とを比較するロジックです。クエリの条件を満たしているコンテンツ項目が返されます。クエリで使用できる比較演算子を以下に示します。

値

値はクエリから取得するコンテンツを表します。クエリに値を指定することにより、コンテンツ項目に格納されている値に基づいて取得または無視するコンテンツをクエリに指示します。

たとえば、コンテンツ タイプ「book」にプロパティ「title」がある場合、「book」に関連付けられたすべてのコンテンツ項目に「title」フィールドが存在します。各「title」の値はユニークであるため、クエリにユニークな値を入力すれば、使用する比較演算子に応じて特定のコンテンツ項目が取得または無視されます。

値の入力は、クエリにハード コーディングする方法と、ユーザ プロファイルなどのプロパティ セット (セッションおよびリクエスト) から値を取得する方法の 2 種類があります。

値をハード コーディングする場合は取得するコンテンツを特定できるため、クエリ結果を予測できます。

値をユーザ プロファイル、セッション、またはリクエスト のプロパティ セットから作成する場合、指定した各ユーザ プロファイル、セッション、またはリクエストのプロパティの値がプログラム的にクエリに挿入されるため、現在のユーザのプリファレンスあるいは現在のセッションまたはリクエストに基づいてパーソナライズされたクエリを作成できます。たとえば、クエリのコンテンツ プロパティが「author」の場合、ユーザの「FavoriteAuthor」プロファイルのプロパティ値を取得してその値をクエリに指定すると、ユーザの好きな著者に関連付けられたコンテンツを取得できます。

クエリに値を指定する場合のガイドラインを以下に示します。

• 文字列リテラル値は単一引用符で囲む。たとえば、'pending' のように指定します。
• 単一引用符または二重引用符を指定するには、バックスラッシュを引用文字に使用する (Unicode 文字はサポートされない)。たとえば、本のタイトルが "The Crazy Adventure" のように二重引用符で囲まれている場合、値は '\"The Crazy Adventure\"' のように入力します。本のタイトルが単一引用符で囲まれている場合、値は title = '\'The Crazy Adventure\'' のように入力します。
• Unicode ("\u6565" など)、8 進数 ("\7"、"\65"、"\377" など)、および Java の標準エスケープ シーケンス ("\n"、"\r"、"\b" など) を文字列リテラル内で使用できる。
• ブール リテラルは、キーワード true または false のいずれかである (小文字で指定し、引用符は付けない)。
• 数値リテラルは、Java 形式である (浮動小数点表記がサポートされる)。
• 日付/時間リテラルは toDate('formatStr', 'dateStr') の書式で示す。formatStr には使用する日付/時間フォーマット ('MM/dd/yyyy' など) を指定し、dateStr には入力する日付/時間を指定します。
  
  formatStr には有効な java.text.SimpleDateFormat 文字列を指定する必要があります。formatStr を省略した場合、toDate() では 'MM/dd/yyyy HH:mm:ss z' (z は MDT などのタイム ゾーンを示す) が使用されます。たとえば、toDate('12/01/2004 06:00:00 MDT') のように指定します。
  
  日付のみを指定するには、formatStr の書式を入力します。たとえば、日付のみを指定するには、toDate('MM/dd/yyyy', '12/01/2004') のように指定します。年月のみを示すには、'MM-yyyy' のように指定します。
  
  実行時の式の解析時刻を指定するには、now キーワードを使用します。
• クエリの値をユーザ、リクエスト、またはセッションのプロパティから指定するには、<タイプ>Property(<プロパティ セット>, <プロパティ名>) という書式を使用する。タイプは user、request、session のいずれかです。たとえば、userProperty('userpreferences', 'FavoriteAuthor') のように指定します。

複合クエリのガイドライン

複数の独立したクエリ句を and (&&) や or (||) ロジックで結合し、代数式の評価順序を括弧で制御することができます。これにより複雑なクエリが作成可能になります。括弧でグループ化した句の前に感嘆符を付けて、複合クエリに「not」ロジック (!) を指定することもできます。このトピックのクエリのサンプルに複合クエリの例を示します。「not」ロジックの使用例も示しています。

クエリのサンプル

次の図は、BEA の仮想コンテンツ リポジトリに格納されているグラフィックのプロパティ セットを示しています。

図の後のクエリ例は、このサンプル コンテンツ項目のプロパティを使って記述されています。また、各サンプル クエリの解説では、クエリでコンテンツ項目が取得されるかどうかを示しています。