管理属性値の追加

通常、複数の管理属性値を追加します。これらのセットを追加するには、最初に、値を関連付ける管理属性を定義します。次に、管理属性値を追加して、管理属性に関連付けます。

1. 次の例に示すように、Webサービス・リクエストを発行するsoapUIまたは別のツールで、構成Webサービスにアクセスします。

   http://localhost:7001/endeca-server/ws/config/data_domain?wsdl

   locallhostと7001はEndeca Serverのホストとポートで、data_domainはデータ・ドメインの名前です。

2. まず、管理属性に必要な構造を作成します。
   1. PDR "location"を作成します。

      <ns:configTransaction>
               <ns:putProperties>
                 <ns1:record>
                     <mdex-property_DisplayName>Location</mdex-property_DisplayName>
                     <mdex-property_IsSingleAssign>false</mdex-property_IsSingleAssign>
                     <mdex-property_IsTextSearchable>true</mdex-property_IsTextSearchable>
                     <mdex-property_IsUnique>false</mdex-property_IsUnique>
                     <mdex-property_IsPropertyValueSearchable>true</mdex-property_IsPropertyValueSearchable>
                     <mdex-property_Key>location</mdex-property_Key>
                     <mdex-property_TextSearchAllowsWildcards>true</mdex-property_TextSearchAllowsWildcards>
                     <mdex-property_Type>mdex:string</mdex-property_Type>
                 </ns1:record>
               </ns:putProperties>
             </ns:configTransaction>

      これにより、管理属性を作成するために必要な標準属性locationが作成されます。

      注意: この例では、このPDRにあるオプションのmdex-property_IsSingleAssignプロパティの値はfalseですが、このプロパティのデフォルト設定はtrueであることに注意してください(プロパティを指定しない場合は、trueの値が使用されます)。この場合は、関連付けられた管理属性に複数の値を割り当てられるように、falseの設定をお薦めします(必須ではありません)。
   2. DDR "location"を作成します。

      <ns:configTransaction>
                <ns:putDimensions>
                  <ns1:record>
                     <mdex-dimension_Key>location</mdex-dimension_Key>
                     <mdex-dimension_EnableRefinements>true</mdex-dimension_EnableRefinements>
                     <mdex-dimension_IsDimensionSearchHierarchical>true</mdex-dimension_IsDimensionSearchHierarchical>
                     <mdex-dimension_IsRecordSearchHierarchical>true</mdex-dimension_IsRecordSearchHierarchical>
                  </ns1:record>
               </ns:putDimensions>
              </ns:configTransaction>

      これにより、管理属性値のセットを追加する管理属性locationが作成されます。

      このリクエストでは、さらに索引内に仕様および親の2つのPDRが作成されます(listPropertiesを実行すると確認できます)。つまり、これにより以下が作成されます。

      <mdex-property_Key type="mdex:string" xmlns="">mdex-dimension_location_Parent</mdex-property_Key>
       <mdex-property_Key type="mdex:string" xmlns="">mdex-dimension_location_Spec</mdex-property_Key>

      • mdex-dimension_location_Specは、割当てが、追加する管理属性値の仕様である属性の名前で、これは管理属性値レコードを一意に識別します。
      • mdex-dimension_location_Parentは、割当てがこの管理属性値の親管理属性値の仕様である属性の名前です。

      仕様および親の属性に対する割当ては重要です(このメカニズムに基づいて、Endeca Serverによりレコードとして管理属性値がデータ・ドメインのその索引内に作成されます)。

      (例のステップ2.bで示すように)DDRを作成するリクエストにこれらの2つの属性を含めない場合は、現在の管理属性(location)の名前を付加することによって仕様および親のPDRの名前が自動的に割り当てられます。一方、次の別の例で示すように、リクエストにこれらの属性を明示的に含める場合は、独自の名前を割り当てることができます。この例では、これらの2つの属性に対して値loc_parentおよびloc_specを明示的に指定して管理属性locationを追加する方法を示しています。

      <ns:configTransaction>
               <ns:putDimensions>
                <ns1:record>
                 <mdex-dimension_Key>location</mdex-dimension_Key>
                 <mdex-dimension-value_Parent>loc_parent</mdex-dimension-value_Parent>
                 <mdex-dimension-value_Spec>loc_spec</mdex-dimension-value_Spec>
                 <mdex-dimension_EnableRefinements>true</mdex-dimension_EnableRefinements>
                 <mdex-dimension_IsDimensionSearchHierarchical>true</mdex-dimension_IsDimensionSearchHierarchical>
                 <mdex-dimension_IsRecordSearchHierarchical>true</mdex-dimension_IsRecordSearchHierarchical>
                </ns1:record>
               </ns:putDimensions>
              </ns:configTransaction>

      loc_parentは、stringタイプ、単一割当てである必要があり、データ・レコードからの割当てを持つことができないことに注意してください。loc_spec属性は、stringタイプ、一意、単一割当てである必要があり、データ・レコードからの割当てを持つことができません。

      この例は、これ以降の手順では使用しません。

      管理属性locationの追加が終了したら、それに対して階層的な編成で管理属性値を追加できます。

3. 管理属性値レコードUSAを追加します。

   <ns:configTransaction>
           <ns:putManagedAttributeValues>
           <ns1:mav>
               <name>USA</name>
               <spec>US</spec>
               <parent>/</parent>
               <managedAttribute>location</managedAttribute>
           </ns1:mav> 
         </ns:putManagedAttributeValues>
        </ns:configTransaction>

   これは階層内で最上位の値になるため、その親管理属性値が"/"となっていることに注目してください。この記号"/"は、ルート管理属性値に対して指定する必要があります。また、この値に対して関連付けられた管理属性はlocationです。これは、管理属性値の作成前に存在している必要があります。

4. 同様の方法で、同じ管理属性locationに対して、親の値USAの下に管理属性値MassachusettsおよびNew York Stateを追加します。

   <ns:configTransaction>
           <ns:putManagedAttributeValues>
           <ns1:mav>
               <name>Massachusetts</name>
               <spec>MA</spec>
               <parent>US</parent>
               <managedAttribute>location</managedAttribute>
            </ns1:mav>
            <ns1:mav>
               <name>New York State</name>
               <spec>NY</spec>
               <parent>US</parent>
               <managedAttribute>location</managedAttribute>
           </ns1:mav>  
         </ns:putManagedAttributeValues>
        </ns:configTransaction>

5. 同じ管理属性locationに対して、親管理属性値MassachusettsおよびNew York Stateの下に、それぞれ管理属性値BostonおよびNew York Cityを追加します。

   <ns:configTransaction>
           <ns:putManagedAttributeValues>
           <ns1:mav>
               <name>Boston</name>
               <spec>bos</spec>
               <parent>MA</parent>
               <managedAttribute>location</managedAttribute>
               <synonym>BeanTown</synonym>
               <synonym>The Hub</synonym>
           </ns1:mav>
           <ns1:mav>
               <name>New York city</name>
               <spec>nyc</spec>
               <parent>NY</parent>
               <managedAttribute>location</managedAttribute>
               <synonym>NYC</synonym>
               <synonym>the Big Apple</synonym>
           </ns1:mav>  
         </ns:putManagedAttributeValues>
        </ns:configTransaction>

   あるいは、単一のリクエストで(国、州および市の)すべての管理属性値を追加することもできます。

   それぞれの管理属性値に2つのシノニムがあることに注目してください。シノニムの詳細は、「操作のサマリー」を参照してください。