RemoteAdmin:RemoteAdmin Standards
From OpenSimulator
(Difference between revisions)
(→common Parameters are) |
m (Robot: Cosmetic changes) |
||
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 31: | Line 31: | ||
* ''object_name'' - name 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! | ||
Revision as of 20:05, 3 March 2012
POLICY PROPOSAL: This document is a proposal for naming standards and is not yet active.
Base Syntax: admin_Category_Function
Naming
Function and parameter names should use US English spelling.
Function should be clearly named & indicative of purpose
Parameters
Parameters should be clearly named & use a common syntax
Eg. use region_id and NOT region_uuid, region_ID or any other variation
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
- object_id - uuid of an object
- object_name - name of an object
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