構成Webサービスでの属性グループのリスト表示と作成

構成Webサービスを使用して、属性グループの作成とリスト表示、各グループの詳細情報の取得、さらに属性グループのインポートとエクスポートを行うことができます。

構成Webサービスに含まれる属性グループの操作は、importGroups、exportGroups、listGroups、getGroups、putGroups、deleteGroupsおよびupdateGroupConfigsです。操作の説明のリストは、「構成Webサービスの操作」を参照してください。

これらの各操作では、最上位の要素としてconfigTransactionを指定し、その後にグループ操作の1つを指定する必要があります。

たとえば、次のリクエストは、putGroupsを使用してグループRatingsを作成します。

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
   xmlns:ns="http://www.endeca.com/MDEX/config/services/types/2/0" 
   xmlns:ns1="http://www.endeca.com/MDEX/config/XQuery/2009/09">
 <soapenv:Header/>
  <soapenv:Body>
   <ns:configTransaction>
    <ns:putGroups>
      <ns1:group  key="Ratings" displayName="Ratings">
       <mdex-property_Key>PriceRange</mdex-property_Key>
       <mdex-property_Key>ReviewScore</mdex-property_Key>
       <mdex-property_Key>Designation</mdex-property_Key>
      </ns1:group>
     </ns:putGroups>
    </ns:configTransaction>
  </soapenv:Body>
</soapenv:Envelope>

このグループには3つの属性が含まれます。

Endecaデータ・ドメインで属性グループを作成する手順:

Oracle Endeca Serverとデータ・ドメインが実行されていることを確認します。データ・ドメインの構成Webサービスにアクセスします(http://localhost:<port>/ws/config/dataDomain?wsdl)。
前述のように、新しいグループのキーと表示名を指定して、構成WebサービスにSOAPリクエストを行います。(他のオプション属性はEndeca Serverで使用されないため指定を省略します)。
リクエストに成功した場合、レスポンスは次の省略された例のようになります。
```
<soapenv:Body>
 <config-types:results xmlns:config-types="http://www.endeca.com/MDEX/config/services/types/2/0"/>
</soapenv:Body>
```
このグループが含まれることを確認するために、次の例のように、グループをリスト表示するリクエストを発行します。
```
<ns:configTransaction>
   xmlns:ns="http://www.endeca.com/MDEX/config/services/types/1/0"
   xmlns:ns1="http://www.endeca.com/MDEX/config/XQuery/2009/09">
		  <ns:listGroups/>
</ns:configTransaction>
```
レスポンスにはRatingsグループが含まれます。