RemoteAdmin:RemoteAdmin Standards

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Parameters)
m
 
(8 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
Personal tools
General
About This Wiki