<sharing>

Summary

This element is a container for the sharing information about a URI (document or URL). It contains one or more <share> elements, one for each group the URI is shared with.

For a more detailed discussion on share documents, see document sharing.

Usage context

Attributes

This element includes the following attributes:

@status

This attribute’s value shows whether the URI is “shared” to other groups or “private” to a single group. The value is one of the following:

• shared
• private

@hidden

This attribute’s value is the number of groups that the URI is shared with but that the member cannot see.

@public

Flag whether public has permission to view the URI, this optional attribute’s default value is false.

Examples

<sharing status="private">
  <share default="true"
         editable="true"
         addcomments="true">
    <group id="56"
           name="app-testing"
           description="App testing group"
           owner="app"
           access="member"
           common="false"/>
  </share>
</sharing>
<sharing status="shared"
         hidden="1"
         public="true">
  <share default="true"
         editable="true"
         addcomments="true">
    <group id="12"
           name="dev-group1"
           description="Dev group 1"
           owner="dev"
           access="member"
           common="false"/>
  </share>
  <share editable="false"
         addcomments="true">
    <group id="82"
           name="dev-group2"
           description="Dev group 2"
           owner="dev"
           access="member"
           common="false"
           relatedurl="http://dev.example.org/home.html"/>
  </share>
</sharing>

Schema

XML Schema

<xs:element name="sharing">
  <xs:sequence>
    <xs:element name="share" type="share" maxOccurs="unbounded"/>
  </xs:sequence>
  <xs:attribute name="status" use="required">
    <xs:simpleType>
      <xs:restriction base="xs:string">
        <xs:enumeration value="private" />
        <xs:enumeration value="shared" />
      </xs:restriction>
    </xs:simpleType>
  </xs:attribute>
  <xs:attribute name="hidden"  type="xs:positiveInteger" />
  <xs:attribute name="public"  type="boolean"       fixed="true"/>
</xs:element>

Compatibility

No change since initial API release.