Oracle Cloud Infrastructure Documentation

Manage the Organization

From the Organization page, you can manage projects and update the organization’s properties.

Update the Organization’s Display Name and Description

By default, the organization's display name is <your_vbstudio_instance_name>-<your_oracle_account_name>.
  1. In the navigation menu, click Organization Organization.
  2. Click the Properties tab.
  3. In Name, edit the organization name.
  4. In the Confirm Organization Name Change dialog box, click Yes.
  5. In Description, if necessary, enter or edit the organization's description.

Set the Organization’s Default Wiki Markup Language

When you create a project, the project creation wizard displays the organization's default wiki markup language. If you don’t change the wiki markup language, the default markup language is used as the project’s markup language. You can change the default markup language for new projects, but note that existing projects continue to use their original markup language.

  1. In the navigation menu, click Organization Organization.
  2. Click the Properties tab.
  3. In Markup Language, select the default wiki markup language.

Restrict Project Creation to Organization Administrators

By default, all VB Studio users (users with the DEVELOPER_ADMINISTRATOR IDCS role or the DEVELOPER_USER IDCS role) can create a project. As the Organization Administrator, if required, you can restrict project creation to yourself and other organization administrators (users with the DEVELOPER_ADMINISTRATOR IDCS role).

  1. In the navigation menu, click Organization Organization.
  2. Click the Properties tab.
  3. Select the Limit project creation to organization administrators only check box.
The + Create button on the All Projects page and in the Switch Project menu is now hidden for users assigned the DEVELOPER_USER IDCS role. To allow them to create projects, deselect the Limit project creation to organization administrators only check box.

Restrict Sharing a Project to Organization Administrators Only

By default, all VB Studio users can create shared projects. Users who are project owners can share their private projects and make them accessible to all users of the organization.

As the Organization Administrator, if required, you can restrict the users' ability to create a shared project or share a private project. Once this restriction is set, only you and other organization administrators can create a shared project or share a private project.
  1. In the navigation menu, click Organization Organization.
  2. Click the Properties tab.
  3. Select the Limit shared project to organization administrators only check box.
After the check box is selected, the Shared option under Security in the New Project wizard and the Project Administration > Properties page is disabled for users who are assigned the DEVELOPER_USER IDCS role. They can't change a private project's security to shared, but they can change a shared project's security to private.

Assign a Project's Ownership to Another User

At times, you may want to assign a project's ownership to another user. For example, when a project's owners are removed or have left the organization, you should assign the Project Owner role to another project user.

  1. In the navigation menu, click Organization Organization.
  2. Click the Projects tab.
  3. Click the Owner filter button.

    If you can't find the project in the filtered list, you aren't assigned the project's Project Owner membership. You should assign the project's ownership to yourself before you assign it to another user.

    1. Click the All filter button.
    2. Locate the project.
    3. Click Update Project Actions.
    4. Select Assign Me as Owner.
  4. Click the project's name to open it.
  5. Click the Team tab.
  6. If the user whom you want to assign the ownership is already a member, click the Change Membership Change Membership icon icon and select Project Owner.
    If the user is not a member, add the user to the project.
    1. Click + Add Member.
    2. Click the Username drop-down list and select the user.
    3. Select the Project Owner membership.
    4. Click Add.
  7. After adding the user, you can remove yourself from the project. Click Remove the remove icon next to your name. In the dialog box that opens, click OK.

Manage Your Organization's Projects

As the Organization Administrator, you can access and manage all projects. You can assign a project’s Project Owner role to yourself, delete a project, revoke the project's deletion, or postpone the project's deletion by a few days.

  1. In the navigation menu, click Organization Organization.

  2. Click the Projects tab.

Example:

Description of organization_admin.png follows

Here are the project management actions you can perform:

Action How To

Create a project

 Click + Create.

See Create a Project.

Open a project In the Name column, click the project name.

See Open a Project.

You can open a project only if you're a member or an owner. Projects where you aren't a member or an owner don't appear as links. You can't open a project that's in the deleted state.

View a project's team members The Members column shows the gravatars of the project's team members. A blue circle around a user's gravatar indicates the user is assigned the project's Project Owner role. Click the gravatars to display names and email addresses of all team members.
Search for projects In the search box above the projects list, enter the search term.

The term is matched against your organization's project names and their descriptions, as well as their members' names, usernames and email addresses.
Filter projects

In Member/Owner/Favorite/All, click a filter option to enable it and filter the projects list.

Click Owner to view projects where you're a Project Owner. Click the Member button to view projects where you're a team member (any membership including Project Owner). Click Favorite to view your favorite projects. Click All to view organization's all projects.

To see more filter options, click Detailed Filter the Filter icon.

Mark a project as a favorite In the Favorite column, click Favorite the Star icon to add it to your favorites list.

Assign a project’s Project Owner role to yourself

You can assign a project’s Project Owner role to yourself. This is usually helpful in a case when all project's owners are removed or have left the organization. As the Organization Administrator, you can then take the ownership of such projects and then assign the Project Owner role to another project user.

For the project whose ownership you want to assign to yourself, click Update Project Actions and select Assign Me as Owner.

Delete a project

As the Organization Administrator, you can delete any project.

  1. For the project you want to delete, click Update Project Actions and select Delete.

  2. In the Delete Project dialog box, click Delete.

The project’s State is marked as Deleted - Project will be removed automatically in N days., but the project isn’t removed immediately. In the Delete Project dialog box, read the message before you click Delete. Also, check the project’s delete message to know when the project will be permanently removed. To immediately remove the project permanently, click Actions and select Remove Forever.

Postpone a deleted project's removal

At times, you may be unsure if you want to revoke a project's deletion that’s close to its permanent removal date. For such projects, you can choose to postpone their removal by a few days.

For the deleted project you want to postpone, click Update Project Actions and select Postpone Removal.

The project’s permanent removal date is rescheduled and the message is displayed at the top. In Status, check the project’s delete message to know when the project will be permanently removed.

Undelete a project

When you undelete a project, you get an option to update the name and description of the project. When the deletion is revoked, the project URLs will change if a different name of the deleted project is specified.

  1. For the deleted project you want to undelete, click Update Project Actions and select Undelete.

  2. In the Undelete Project dialog, if necessary, update the project name in Name, and update the description in Description.

    You would have to change the project name if another project with the same name was created after this project was deleted.

  3. Click Undelete.

Select multiple projects

You can select multiple projects and perform a common action on them.

  1. If necessary, filter and sort the projects as desired.

  2. Press the Ctrl key or the Shift key and select project rows.

    To select all projects, click the check box to the left of the Name column header.

  3. Click Update Selected and select the desired action from the menu.

Some options, such as Undelete, are not available in the Update Selected menu.

View usage metrics of projects

Next to the Detailed Filterthe Filter icon , review the projects and the disk usage metrics of the organization.

For each project, the Disk Usage column shows the project's disk usage. Click the number to open a pop-up with details of usage by each service in the project.

Manage Your Organization's Groups

In VB Studio, you can create groups of your VB Studio organization's users or import existing Oracle Identity Cloud Service (IDCS) groups, and then add these groups to VB Studio projects. When you add a group to a project, you assign a common membership type to all group's users.

After creating a group, you can add more members to it and add the group to projects. You can also import IDCS groups to VB Studio, but can't add or remove users from the imported IDCS group. To do that, sign in to the IDCS Console. Note that the imported IDCS group is synced with IDCS every five minutes.

This table describes the actions you can perform to create and manage groups.

Action How To

Create a VB Studio group

  1. In the navigation menu, click Organization Organization.
  2. Click the Groups tab.
  3. Click + Create Group.
  4. In Type, if not already selected, select the VB Studio tile.
  5. In Name and Description (optional), enter the group's name and description.
  6. To see all members you can add, click the members list. Users who are assigned the DEVELOPER_ADMINISTRATOR or the DEVELOPER_USER IDCS role are displayed.
  7. From the users drop-down list, select users to add to the group.

    If you can't find a particular user, enter the user's name or username in the search box. As you type, the drop-down list displays users matching the search term.

  8. Click Create.
Import an IDCS group
  1. In the navigation menu, click Organization Organization.
  2. Click the Groups tab.
  3. Click + Create Group.
  4. In Type, select the IDCS tile.
  5. Under the filter box, select the group to import.

    The drop-down list displays IDCS groups that are assigned either the DEVELOPER_ADMINISTRATOR or the DEVELOPER_USER IDCS role.

    To select multiple groups, press the Ctrl key or the Shift key, and then select groups. If you can't find a particular group, enter the group's name in the search box. As you type, the drop-down list displays groups matching the search term.

  6. Click Create.

From VB Studio, you can't add or remove users of an IDCS group. You can do that from the IDCS Console. See Manage Oracle Identity Cloud Service Groups.

See a group's members
  1. In the navigation menu, click Organization Organization.
  2. Click the Groups tab.
  3. Locate the VB Studio group and click the user gravatars in the Members column.
Add members to an existing VB Studio group
  1. In the navigation menu, click Organization Organization.
  2. Click the Groups tab.
  3. Locate the VB Studio group and click Add Member to the Group Add user.
  4. Click the members drop-down list. All users who are assigned the DEVELOPER_ADMINISTRATOR or the DEVELOPER_USER IDCS role are displayed.
  5. Select the user from the drop-down list.

    If you can't find the user, enter the user's name or username in the search box. As you type, users matching the search term are displayed.

  6. Click Add.
  7. In the Members tab, verify the added members.
  8. Click Close.
Remove members from a VB Studio group
  1. In the navigation menu, click Organization Organization.
  2. Click the Groups tab.
  3. Locate and double-click the VB Studio group.
  4. In the Members tab, select the members to remove.
  5. Click Remove Members.
  6. Click Remove Members to confirm.
Add a group to a project

To add a group to a project, you must be assigned the project's Project Owner membership.

  1. In the navigation menu, click Organization Organization.
  2. Click the Groups tab.
  3. Locate the VB Studio group and click Add Group to a Project Add group to a project
  4. From the project drop-down list, select the project.
  5. From the roles list, select the role you want to assign to the group's members.
  6. Click Add.
  7. Click Close.
Remove a group from a project

To remove a group from a project, you must be assigned the project's Project Owner membership.

  1. In the navigation menu, click Organization Organization.
  2. Click the Groups tab.
  3. Locate and double-click the VB Studio group.
  4. In the Projects tab, select the projects to remove.
  5. Click Remove Group from Projects.
  6. Click Remove Group from Projects to confirm.
See the projects a group is added to
  1. In the navigation menu, click Organization Organization.
  2. Click the Groups tab.
  3. Locate the VB Studio group and click the user gravatars in the Projects column.
  4. Click Close.
Edit a group's name or description
  1. In the navigation menu, click Organization Organization.
  2. Click the Groups tab.
  3. Locate and double-click the VB Studio group.
  4. Click Actions Actions menu and select Edit.
  5. Update the group's name and description
  6. Click Save.
  7. Click Close.
Delete a group
  1. In the navigation menu, click Organization Organization.
  2. Click the Groups tab.
  3. Locate the VB Studio group.
  4. Click Delete.
  5. Click Delete to confirm.