Changes

315 bytes removed ,  18:57, 3 July 2013
Line 135: Line 135:  
To download a Sugar Activity bundle from the Sugar Network, it is required to find out the GUID of ''Implementation'' with the required activity version. To make this process more convenient for users, there is special command that requires only ''Context'' GUID (which is, in most cases, equal to Sugar Activity bundle id).
 
To download a Sugar Activity bundle from the Sugar Network, it is required to find out the GUID of ''Implementation'' with the required activity version. To make this process more convenient for users, there is special command that requires only ''Context'' GUID (which is, in most cases, equal to Sugar Activity bundle id).
   −
  '''GET''' /context/''GUID''?cmd='''clone'''[&version=''VERSION''][&stability=''STABILITY''][&requires=''REQUIRES'',..]
+
  '''GET''' /context/''GUID''?cmd='''clone'''[&requires=''REQUIRES''][&''PROP''=''VALUE'']
   −
This command finds out required ''Implementation'', using passed parameters, and returns its bundle. Command parameters are:
+
Using passed parameters, this command finds out proper ''Implementation'' and returns its bundle. If there are more than one implementation, the most recent version will be chosen.
   −
* {{Code|VERSION}}<br>Version to download; if omitted, most recent will be used;
+
Command parameters might be any [[Sugar_Network/Resources|Implementation]] property values, such as ''stability'' or ''version'', to filter implementations by. The ''requires'' parameter has a special meaning, it is intended to select an implementation by its dependency list. Dependency parameter is multiple and should confirm Sugar Network [[Sugar_Network/Recipe_Specification#Dependencies|recipe specification]].
* {{Code|STABILITY}}<br>[[#Sugar_Network_resources|stability]] ''Implementation'' value; if omitted, ''stable'' will be used;
  −
* {{Code|REQUIRES}}<br>while uploading new versions, system will keep dependency information in ''requires'' property of ''Implementations'' resources; it is not strict information and is not used for processing dependencies while launching, ''requires'' property exists only to simplify user-driven searching; {{Code|REQUIRES}} specifies ''requires'' property to search versions (option might be multiple); for the first time, the only guarantied ''requires'' values are {{Code|sugar-''VERSION''}} with information on what Sugar version is required.
      
=== Notifications ===
 
=== Notifications ===