#218 OpenSong API

[Roland]

/presentation/slide/song[/folder:name]/song:name[/after:slide_number][/order:presentationorder]
according to spec order should be comma separated list, e.g. 'V1,C,V2,B,V2,V3'
This is not working: Opensong returns error 403
However a space separated list, e.g. 'V1 C V2,B V2 V3' does work

[Roland]

insert of song or scripture in OpenSong itself pushes a status update to the api
insert of song via api does NOT push a status update to the api

[Vwout]

This is a bug, OpenSong just passes the argument to its interal function for adding songs. Internally, spaces are used. Since spaces needs special handling, the API specifies the use of commas. Comma support is added in source revision 1165.

While testing I discovered that pushing a notification upon insertion of songs is broken. The latest code does not send a notification ever.

[Vwout]

Notifications are solved in commit 1167. An additional attribute 'reason' is added to a notification message so that a client can perform additional actions, e.g. reload the list of slides.

Examples:
<?xml version="1.0" encoding="UTF-8"?><response resource="presentation" action="status" reason="change"><presentation running="1"><screen mode="N">normal</screen><slide itemnumber="6"><name>Colossians 1:11-14</name><title>Colossians 1:11-14</title></slide></presentation></response>
or
<?xml version="1.0" encoding="UTF-8"?><response resource="presentation" action="status" reason="insert_song"><presentation running="1"><screen mode="N">normal</screen><slide itemnumber="6"><name>Colossians 1:11-14</name><title>Colossians 1:11-14</title></slide></presentation></response>