Page Comparison

...

The CloudOS Subscription Event Protocol provides an event based model for managing subscriptions between Personal Clouds. The current implementation of the protocol will create a symmetric relationship between both Personal Clouds. In order to used use the Subscription Event Protocol the CloudOS ruleset must be installed in the Personal Cloud for both the originating originator and target.

Subscribe

The system:subscribe event is used to create a Personal Channel channel between two Personal Clouds.

• domain: cloudos
• type: subscribe
• attributes:
  • channelName
  • namespace
  • relationship
  • targetChannel

• The channelName attribute is a label associated with the subscription that should convey meaning to developer. The channelName is only used as a component in the creation of the event channel tokenidentifier. If no channelName is specified the value of "orphan" will be used.
• The namespace attribute is provided as a means for the developer to group subscriptions within a single, or group, or applications. The namespace is used to filter the list of subscriptions returned by the subscriptionList() function. If not no namespace is specified the value of "shared" will be used.
• The relationship attribute is provided as a means for allows the developer to characterize the relationship between the originating originator and target Personal Cloudclouds. The relationship attribute should be specified as a pair of values separated by a dash (e.g. parent-child, peer-peer, master-slave). The first value of the relationship attribute will be stored with the originating Personal Cloud subscription, the second value will be stored with the target Personal Cloud subscription. The relationship attribute values are used to filter the list of subscriptions returned by the subscriptionList() function. If not no relationship is specified the value of "peer-peer" will be used.
• The targetChannel attribute is the Personal Channel token event channel identifier for the target Personal Cloud cloud to which the subscription is to be made.

fired {
  raise cloudos event subscribe
    with channelName   = "Coworkers Bob+Ted"
    and  namespace     = "MyFriends"
    and  relationship  = "friend-friend"
    and  targetChannel = "3f15b820-af7f-012f-4c6e-00163ebczzzz"
    and  _api = "sky";
}

rule receive_subscriptionRequestAdded
  select when cloudos subscriptionRequestAdded
    namespace re/MyFriends/"
    channelName re/Coworkers Bob+Ted/
    relationship re/friend-friend/

Subscription Approval or Rejection

...

rule receive_CloudOS_subscriptionRemoved
  select when cloudos CloudOS_subscriptionRemoved
    namespace re/MyFriends/
    channelName re/Coworkers Bob+Ted/
    relationship re/friend-friend/

...