moparisthebest
/
xeps
mirror of https://github.com/moparisthebest/xeps
1
0
Fork 0
Code Issues Releases Wiki Activity

0.0.3

This commit is contained in:
stpeter 2012-01-09 20:33:02 -07:00
parent 95f2d5af79
commit f7a02f86c1
1 changed files with 80 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

81
inbox/network.xml
View File

@ -21,11 +21,17 @@
<supersededby/>
<shortname>NOT_YET_ASSIGNED</shortname>
&stpeter;
<revision>
<version>0.0.3</version>
<date>2012-01-09</date>
<initials>psa</initials>
<remark><p>Defined ad-hoc command for triggering outbound presence subscription.</p></remark>
</revision>
<revision>
<version>0.0.2</version>
<date>2012-01-09</date>
<initials>psa</initials>
<remark><p>Second draft; added ad-hoc command and defined data sharing via PEP.</p></remark>
<remark><p>Defined data sharing via PEP.</p></remark>
</revision>
<revision>
<version>0.0.1</version>
@ -125,6 +131,79 @@ Directory Server
to='xmpp.net'
type='subscribed'/>
]]></example>
<section3 topic='Administrator Triggers Presence Subscription' anchor='gather-buddy-trigger'>
<p>The server administator needs a way to trigger the server to send a presence subscription to the directory. This can be done by using &xep0050; as in &xep0133;. Therefore we define a new server administration use case. The command node for this use case SHOULD be "http://jabber.org/protocol/admin#server-buddy".</p>
<p>A sample protocol flow for this use case is shown below.</p>
<example caption='Admin Requests to Add Server Buddy'><![CDATA[
<iq from='stpeter@jabber.org/squire'
id='server-buddy-1'
to='jabber.org'
type='set'
xml:lang='en'>
<command xmlns='http://jabber.org/protocol/commands'
action='execute'
node='http://jabber.org/protocol/admin#server-buddy'/>
</iq>
]]></example>
<p>Unless an error occurs, the service SHOULD return the appropriate form.</p>
<example caption='Service Returns Server Buddy Form to Admin'><![CDATA[
<iq from='jabber.org'
id='server-buddy-1'
to='stpeter@jabber.org/squire'
type='result'
xml:lang='en'>
<command xmlns='http://jabber.org/protocol/commands'
node='http://jabber.org/protocol/admin#server-buddy'
sessionid='server-buddy:20120109T0310Z'
status='executing'>
<x xmlns='jabber:x:data' type='form'>
<title>Adding a Server Buddy</title>
<instructions>Fill out this form to add a "server buddy".</instructions>
<field type='hidden' var='FORM_TYPE'>
<value>http://jabber.org/protocol/admin</value>
</field>
<field label='The server to add'
type='jid-single'
var='peerjid'>
<required/>
</field>
</x>
</command>
</iq>
]]></example>
<example caption='Admin Submits Server Buddy Form to Service'><![CDATA[
<iq from='stpeter@jabber.org/squire'
id='server-buddy-2'
to='xmpp.net'
type='set'
xml:lang='en'>
<command xmlns='http://jabber.org/protocol/commands'
node='http://jabber.org/protocol/admin#server-buddy'
sessionid='server-buddy:20120109T0310Z'>
<x xmlns='jabber:x:data' type='submit'>
<field type='hidden' var='FORM_TYPE'>
<value>http://jabber.org/protocol/admin</value>
</field>
<field var='peerjid'>
<value>xmpp.net</value>
</field>
</x>
</command>
</iq>
]]></example>
<example caption='Service Informs Admin of Completion'><![CDATA[
<iq from='jabber.org'
id='server-buddy-2'
to='stpeter@jabber.org/squire'
type='result'
xml:lang='en'>
<command xmlns='http://jabber.org/protocol/commands'
node='http://jabber.org/protocol/admin#server-buddy'
sessionid='server-buddy:20120109T0310Z'
status='completed'/>
</iq>
]]></example>
</section3>
</section2>
<section2 topic='Directory Queries Server' anchor='gather-query'>