RemoteAdmin:RemoteAdmin Standards
From OpenSimulator
(Difference between revisions)
(Created page with "__NOTOC__ {{Quicklinks}} <br /> POLICY PROPOSAL: This document is a proposal for naming standards and is not yet active. Base Syntax: admin_Category_Function =Naming= Functio...") |
m |
||
(9 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! | ||
+ | |||
* ''region_id'' - uuid of a region | * ''region_id'' - uuid of a region | ||
* ''region_name'' - name of a region | * ''region_name'' - name of a region | ||
Line 26: | 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 === | ||
+ | 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 | ||
+ | |||
+ | |||
+ | [[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