Rest - Work - Session Groups

Purpose

Used for creating, editing and deleting sessiongroups from the Views system.

Base URL

http://app.views.coop/api/restful/work/sessiongroups

Schema

http://app.views.coop/api/restful/work/sessiongroups/schema(.xml|.json|.xsd)

Searching for Session Groups

curl --url <Base URL>/search?q=<query> -u<username>:<password> -H Content-Type:text/xml 

• query - This is a text string to use to search for in the session group records

Extra search parameters are:

• BookingMode - The filters on the booking mode of the session group (None|Session|SessionGroup)
• Archived - By default, only non-archived results are returned. Setting this parameter to 1 result in searching archived records

You can search for any field for a specific value by setting the field as a parameter. Please refer to the schema for fieldnames.

There are also a series of fields that you use -from and -to modifiers to express a range:

• StartDate - yyyy-mm-dd
• EndDate - yyyy-mm-dd
• PlannedSessions - int
• AgeGroupFrom - int
• AgeGroupTo - int
• Created - yyyy-mm-dd
• Updated - yyyy-mm-dd
• Archived - yyyy-mm-dd

Searching for Bookable Session Groups

curl --url <Base URL>/bookable?q=<query> -u<username>:<password> -H Content-Type:text/xml 

This is exactly the same the normal Search API, with the exception that BookingMode is set to SessionGroup AND Session and thus passing a value of None to the BookingMode param will result in the parameter being ignored.

There are also a couple of extra fields that you can use the -from and -to modifiers to express a range:

• Cost - int
• BookingFee - int

Fetching a Session Group

curl --url <Base URL>/<id> -u<username>:<password> -H Content-Type:text/xml

Creating Session Groups

Once you have created your data file, you can send it using the following:

curl --url <Base URL> -u<username>:<password> -H Content-Type:text/xml -X POST -d "<xml>"

If there is a problem with creating that record, you will get a response containing all the errors, plus a copy of the translated data you supplied.

If the record was created successfully, the service will return a complete reocrd for the newly created record if the attribute id set as the newly created id.

Updating a sessiongroups

curl --url <Base URL>/<id> -u<username>:<password> -H Content-Type:text/xml -X PUT -d "<xml>"

• id - The ID of the session group

The XML should be in the same format as the create XML.

Archiving a sessiongroups

curl --url <Base URL>/<id> -u<username>:<password> -H Content-Type:text/xml -X PUT -d '<status>1</status>'

• id - The ID of the session group

This will set the archive flag on a session group. If you set the status to 0, then it will remove the archive flag.

Deleting a sessiongroups

curl --url <Base URL>/<id> -u<username>:<password> -H Content-Type:text/xml -X DELETE

• id - The ID of the sessiongroups

This should be used with great care as it will permenently delete a session groups record.