SOCML:Status

XML

<?xml version="1.0" encoding="UTF-8" ?>
<socml version="1.0">
<status>
    <identity>
        ...
    </identity>
    <datetime></datetime>
    <content></content>
</status>
</socml>

Abstract

The status object is a container object for all status updates that the user wishes to share with their network. The concept of a container object means that within the content field any number of SOCML objects can be embedded. For example, if the user wishes to "tag" another user in a post, that person's name would simple be wrapped in an identity tag.

See the example below to get a better idea how the object can be used.

Required Fields

GUID

XML Tag:

 
    <identity></identity>
    <!-- or as a nested attribute -->
    <identity guid="" ... />

Description:
All SOCML objects must have an owner identity assigned to them.

For more information on this particular tag see the Identity page.

Date & Time

XML Tag:

 
    <datetime></datetime>

Description:
Every status update must have a date time attached to them. All values must be in GMT.

Content

XML Tag:

 
    <content></content>

Description:
The field is where the status update content information is stored. Within this tag there can be nested SOCML object; however, the service can choose whether or not to display nested objects and can simply interpret the content field as plain text if so desired.

Example

<?xml version="1.0" encoding="UTF-8" ?>
<socml version="1.0">
<status>
    <identity>
        ...
    </identity>
    <datetime>2013-2-20 22:00:00</datetime>
    <content>
        Watching Monty Python and the Holy Grail with 
        <identity guid="21EC2020-3AEA-1069-A2DD-08002B30309D" firstname="John" lastname="Doe" ...>John Doe</identity>
    </content>
</status>
</socml>