Your GoodData Organization

Related Tags: getting started project administration provisioning

Organizations

In GoodData, an organization is the data entity in which all users and projects associated with a single GoodData customer are stored within the GoodData platform. At the technical level, this structure corresponds to a partition in the database.

  • A legacy term for “organization” is domain.
  • Typically, each GoodData customer has one domain. However, white-labeled projects must be stored in a separate domain.

Within your defined organization, you have special permissions for managing the users and projects stored there. For user provisioning, you may add, edit, and delete users in your organization and also provision these users directly into the GoodData projects within the organization.

Your GoodData organization has the following characteristics:

  • A customer-specific partition of GoodData user database
  • You have full control over users within your organization.
  • Organization is managed via a special account, the organization owner account.

    Tip: Avoid tying this account to a specific individual or individual’s email address, in case that person leaves your organization.

  • To guarantee uniqueness, usernames must be appended with the domain name. For example, you could use the following structure:
    First.Last+MyDomain@MyDomain.com

    Tip: The above structure is helpful if you have multiple GoodData organizations associated with your enterprise. Using this structure, an individual may have accounts tied to different domains. However, some email servers do not support this structure. For more information, please contact your IT staff.

Creating an Organization

To establish a GoodData organization, you must complete the following steps.

Steps:

  1. Choose an organization name. This name should be consistent with your company name. It must be lower-case and without spaces. For example, the My Company organization should be:
    mycompany
  2. Create the domain owner account in GoodData.
    • This account should not be tied to an individual.
    • This account should be unique within your organization and tied to the name of the organization.
    • It must be formatted as a valid email address, although it does not have to be an address. For example, you might create the domain owner account to be:
      gooddata@mycompany.com
  3. When the above items have been defined, please create a support ticket in GoodData to create the domain.
    • Please define the Summary of the issue to be:
      Create Domain for My Company
    • Please provide contact information to resolve any issues.
    • To register a support ticket, please visit GoodData Customer Support.
  4. After the ticket has been created, the organization is created by GoodData.

The Organization Owner Role

Organizations are managed by organization owners who have full control over organizations’ projects and users. Owners can provision new projects and create and delete project users. While owners are the default administrators of any project they provision, a single project can have multiple administrators. Any user can be made an administrator of one or more projects.

  • The domain owner does not need to be a project administrator, and vice-versa.
  • Projects may be created by other users, who have been provided the appropriate project authorization token. Projects do not need to be tied to the organization.

Organization and Owner Account
Organization and Owner Account

Through the organization’s owner account, you may perform the following actions:

  • Create users in the organization
  • Edit users in the organization or delete them
  • Add users into projects owned by the organization admin

Project Provisioning APIs

For provisioning multiple projects, you should build the provisioning tools to manage the process using the GoodData APIs.

  1. For more information, see Build Project Provisioning.
  2. You may also modify a set of GoodData scripts to manage the provisioning APIs. For more information, see How to Provision GoodData Projects Programmatically.

User Provisioning APIs

For provisioning large numbers of users to many projects, you should build the provisioning tools to manage the process using the GoodData APIs.

  1. For more information, see User Provisioning.
  2. You may also modify a set of GoodData scripts to manage the provisioning APIs. For more information, see How to Provision GoodData Projects Programmatically.