semanticEntityの一般的な構文

<semanticAttribute name="?" displayName="?" datatype="?" 
   isDimension="?" isKeyColumn="?" description="?">
   <property key="?">?</property>
</semanticAttribute>

• nameには、属性の一意の識別子を指定します。識別子はNCName書式に従う必要があります。
• displayNameは、わかりやすい形式でのエンティティ属性の名前です。表示名にはNCName以外の書式を使用できます。
• datatypeには、mdex:stringなどの有効なデータ型を指定します。有効な型はmdex.xsdにリストされています。
• isDimensionは、GROUP BYの実行に役立つ属性でtrueに設定されます。たとえば、Size、Region、Categoryなどの属性にはisDimension="true"が必要ですが、これは、これらが階層を含む管理属性であり、EQLのGROUP BY文の候補であることを示します。
• isKeyColumnは、この属性がエンティティの複合キーの一部である場合、trueに設定されます。エンティティの複合キーは、isKeyColumnがtrueに設定される場合、エンティティ属性のセットになります。デフォルトはfalseです。
• descriptionには、属性の簡単な説明を提供します。
• propertyには、この属性の名前(key)と文字列メタデータの値を設定します。キー名はNCName書式である必要があります。

<attributes>
  <semanticAttribute name="SalesAmount" displayName="Sales Amount" datatype="mdex:double"
     isDimension="false" isKeyColumn="true" description="sales info">
     <property key="locale">EN</property>
  </semanticAttribute>
  ...
</attributes>

<metrics>
  <metric name="?" displayName="?" datatype="?" description="?">
     <definition>?</definition>
     <property key="?">?</property>
  </metric>
</metrics>

• nameには、メトリックの一意識別子を指定します。識別子はNCName書式に従う必要があります。
• displayNameは、わかりやすい形式でのメトリックの名前です。表示名にはNCName以外の書式を使用できます。
• datatypeには、mdex:doubleなどの有効なデータ型を指定します。
• descriptionには、メトリックの簡単な説明を指定します。
• definitionは、メトリックを定義するEQL文です。definition要素には、エンティティの属性に対して問合せを行うときに集約に使用したEQLの算術式が含まれている必要があります。
• propertyには、このメトリックの名前(key)と文字列メタデータの値を設定します。キー名はNCName書式である必要があります。

<metrics>
  <metric name="TotalSales" displayName="Total Sale" datatype="mdex:double">
    <definition>sum(SalesAmount)</definition>
    <property key="currency">$</property>
  </metric>
</metrics>

<groups>
  <group key="?" displayName="?">
     <semanticAttributeKey name="?">
     <property key="?">?</property>
  </group>
</groups>

• group keyは、エンティティ属性グループの一意の識別子です。識別子は、NCName書式に従う必要はありません。
• displayNameには、グループに対してさらにユーザーフレンドリな名前を指定できます。
• semanticAttributeKey (そのname属性を介する)は、グループに追加されるエンティティ属性を指定します。そのため、semanticAttributeKeyのname属性は、前述のsemanticAttribute要素のname属性に対応します。
• propertyには、このグループの名前(key)と文字列メタデータの値を設定します。キー名はNCName書式である必要があります。

<semanticEntity key="Product" displayName="Product" isActive = "true">
   <definition>
    DEFINE Product AS SELECT productId AS productId, description AS description, price AS price
   </definition>
   <attributes>
      <semanticAttribute name="productId" datatype="mdex:string" 
         isDimension="true" isKeyColumn="true">
      </semanticAttribute>
      <semanticAttribute name="description" datatype="mdex:string" 
         isDimension="true" isKeyColumn="false">
      </semanticAttribute>
      <semanticAttribute name="price" datatype="mdex:double" 
         isDimension="true" isKeyColumn="false">
         <property key="currency">$</property>
      </semanticAttribute>
   </attributes>
   <metrics/>
   <groups>
      <group key="ProdDescription" displayName="ProductId and Description Group">
         <semanticAttributeKey name="productId"/>
         <semanticAttributeKey name="description"/>
         <property key="sortBy">productId</property>
      </group>
   </groups>
   <property key="SalesArea">North America</property>
</semanticEntity>