RemoteAdmin:RemoteAdmin Standards
From OpenSimulator
(Difference between revisions)
												
			m (moved Remoteadmin:ReamoteAdmin Standards to RemoteAdmin:RemoteAdmin Standards: spelling)  | 
			m  | 
			||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 9: | Line 9: | ||
Base Syntax: admin_Category_Function  | Base Syntax: admin_Category_Function  | ||
| − | =Naming=  | + | = Naming =  | 
Function and parameter names should use US English spelling. <!-- Why? What's the rationale behind this? Please explain. -->  | Function and parameter names should use US English spelling. <!-- Why? What's the rationale behind this? Please explain. -->  | ||
Function should be clearly named & indicative of purpose  | Function should be clearly named & indicative of purpose  | ||
| − | ==Parameters==  | + | == Parameters ==  | 
Parameters should be clearly named & use a common syntax  | Parameters should be clearly named & use a common syntax  | ||
| Line 20: | Line 20: | ||
use ''region_id'' and NOT region_uuid, region_ID or any other variation  | use ''region_id'' and NOT region_uuid, region_ID or any other variation  | ||
| − | ===common Parameters are ===  | + | === common Parameters are ===  | 
Note: The following paramenters are NOT standard in older commands!  | Note: The following paramenters are NOT standard in older commands!  | ||
| Line 28: | Line 28: | ||
* ''agent_first_name'', ''agent_last_name'' - name of avatar  | * ''agent_first_name'', ''agent_last_name'' - name of avatar  | ||
* ''agent_id'' - uuid of an avatar  | * ''agent_id'' - uuid of an avatar  | ||
| + | * ''user_firstname'', ''user_lastname'' - name of user's account  | ||
| + | * ''user_password'' - password of user's account  | ||
| + | * ''object_id'' - uuid of an object  | ||
| + | * ''object_name'' - name of an object  | ||
| − | ===commonly returned Parameters are ===  | + | === commonly returned Parameters are ===  | 
Note: The following paramenters are NOT standard in older commands!  | Note: The following paramenters are NOT standard in older commands!  | ||
* ''success'' - returns true/false when a function is executed  | * ''success'' - returns true/false when a function is executed  | ||
* ''error'' - returns the error message when an error occures  | * ''error'' - returns the error message when an error occures  | ||
| + | |||
| + | |||
| + | [[Category:RemoteAdmin]]  | ||
Latest revision as of 15:16, 24 October 2015
POLICY PROPOSAL: This document is a proposal for naming standards and is not yet active.
Base Syntax: admin_Category_Function
[edit] Naming
Function and parameter names should use US English spelling.
Function should be clearly named & indicative of purpose
[edit] Parameters
Parameters should be clearly named & use a common syntax
Eg. use region_id and NOT region_uuid, region_ID or any other variation
[edit] common Parameters are
Note: The following paramenters are NOT standard in older commands!
- region_id - uuid of a region
 - region_name - name of a region
 - filename - name and location of a file eg. "c:/bin/my_backup.oar", "my_backup.oar", "http://www.foo.bar/my_backup.oar"
 - agent_first_name, agent_last_name - name of avatar
 - agent_id - uuid of an avatar
 - user_firstname, user_lastname - name of user's account
 - user_password - password of user's account
 - object_id - uuid of an object
 - object_name - name of an object
 
[edit] commonly returned Parameters are
Note: The following paramenters are NOT standard in older commands!
- success - returns true/false when a function is executed
 - error - returns the error message when an error occures