Organization Initial Setup Tool
Javapackage: com.etendoerp.copilot.devassistant
Overview
The OrgInitTool assists with initializing or creating a new organization in the Etendo system. It interactively gathers all required information, invokes the backend function to provision the organization and its administrator, and validates successful creation.
Info
To be able to include this functionality, the Copilot Extensions Bundle must be installed. To do that, follow the instructions from the marketplace: Copilot Extensions Bundle. For more information about the available versions, core compatibility and new features, visit Copilot Extensions - Release notes.
Functionality
This tool automates the organization provisioning process in Etendo by:
-
Receiving Parameters
- Accepts an input object with:
org_name
(string)org_username
(string)password
(string)confirm_password
(string)client_admin_user
(string or null)client_admin_password
(string or null)remote_host
(string or null)
- Accepts an input object with:
-
Creating the Organization
- Validates matching passwords.
- Calls the
OrgInitTool
function to:- Create the organization environment.
- Set up the administrator account.
-
Returning the Result
- Returns a JSON response indicating success or failure.
- On success: includes a confirmation message, the new organization ID, and admin username.
Usage Example
Creating a new organization
Input
{
"org_name": "EventsCo",
"org_username": "eventsadmin",
"password": "Passw0rd!",
"confirm_password": "Passw0rd!",
"client_admin_user": "acmeadmin"
}
Output
{
"status": "success",
"org_id": "67890",
"admin_username": "eventsadmin",
"message": "Organization 'EventsCo' initialized successfully."
}
Note
After successful creation, instruct the user to log in with the administrator credentials to continue setting up the organization.