publishRawCategories Element

Article
05/23/2014

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Publishes a set of user-defined categories.

Syntax

<publishRawCategories rid="string value"/>

Attributes

Attribute	Data Type	Description
rid	string	Request Id. This is a string value assigned by the Unified Communications client. This is a required attribute.

Element Information

Parent Element

Element	Description
cwaRequests	Contains one or more methods that a Unified Communications AJAX API Client sends to a Communicator Web Access server.

Child Elements

Element	Occurrences	Description
rawCategory	1 or more	The raw category data to be published.

Remarks

This request allows the user to publish his custom category. A category can contain any data that can be put into an XML blob element. The user subscribing to the publishing users custom category must have the ability to parse the XML data contained within the custom category.

An example of a custom category might be a price list. The publisher might be a provider of goods or services. The subscribing user might be a consumer of those goods.

Examples

In this example, the publishing user is a real estate agent. He wants to publish a list of the properties he is currently brokering. The raw category he is publishing is placed in container 200. Container 200 is a well-known Communicator Web Access container and represents an access control list for the workplace. The other employees in his workplace have the ability to see this list because the Unified Communications API enabled application written for the company recognizes this raw category by name and can parse the XML snippet contained within.

<publishRawCategories rid="22">
   <rawCategory name="housesForSale" instanceMask="1" version="1"
   container="200" expireType="static" expires="...">
      <houses>
         <house address="1232 Main Street" salePrice="199000">
         <house address="9999 West Avenue" salePrice="299000">
      </houses>
   </rawCategory>
</publishRawCategories>

Share via