3 Get Started with Project and Workspaces

A project is a logical grouping of notebooks and experiments within a workspace. A workspace is a virtual space where your projects reside, and multiple users can work on different projects. Permissions are granted on workspaces, and not on projects.

• Create Projects
  A project is a logical grouping of notebooks and experiments within a workspace. While you may own many projects, other workspaces and projects may be shared with you.
• Create and Manage Workspaces and Projects
  You can create and manage new projects and workspaces, provide access to your workspaces, manage permissions for users, and edit and delete workspaces.
• Grant Workspace Permissions
  You can collaborate with other users in Oracle Machine Learning User Interface (UI) by granting permissions to access your workspace. A workspace consists of projects. Projects consist of notebooks and experiments.

3.1 Create Projects

A project is a logical grouping of notebooks and experiments within a workspace. While you may own many projects, other workspaces and projects may be shared with you.

The initial workspace and the default project is created for you when you log in to Oracle Machine Learning User Interface (UI) for the first time. To create a new project:

1. On the top right corner of Oracle Machine Learning UI home page, click the project drop-down list. The project name and the workspace, in which the project resides, are displayed here. In this screenshot, the project name is OMLUSER, and the workspace name is also OMLUSER. If a default project exists, then the default project name is displayed here.

   Note:

   The last project that you have worked on is stored in the browser cache and is the default project. If you clear the cache, then no default exists and you must select a project.
   You can create projects in two ways:

   • Use the New Project option: Click the down arrow next to the Project field and then click New Project. The Create Project dialog opens.
   • Use the Create option on the Workspaces page: Click the down arrow next to the Project field and click Manage Workspace. On the Manage Workspace page, under the Projects in Workspace section, click Create. The Create Project dialog opens.
2. In the Create Project dialog, enter the following:

   Figure 3-1 Create Project dialog

   
   1. Name: Enter a name for your project.
   2. Comments: Enter comments, if any.
   3. Workspace: The default workspace is selected. This is a non-editable field. To select a different workspace or to create a new workspace, go to Manage Workspace.
3. Click OK.

The project Project A is created and is assigned to the default workspace. In this example, the default workspace is OMLUSER.

3.2 Create and Manage Workspaces and Projects

You can create and manage new projects and workspaces, provide access to your workspaces, manage permissions for users, and edit and delete workspaces.

The Workspaces page comprises two sections, one for workspaces and the other for projects.

Create and Manage Workspace

To create and manage workspaces:

1. On the top right corner of your home page, click the down arrow next to the Project field, and click Manage Workspaces. The Workspaces page opens
2. On the Workspaces page, you can create and manage workspaces and projects. To create and manage workspaces:
   • On the upper section for workspace, click Create to create new workspace. In the Create Workspace dialog, enter a name for the workspace and click OK.
   • Click Edit to edit the selected workspace. In the Edit Workspace dialog, you can edit the workspace name, and click OK.
   • Click Delete to delete the selected workspace. Click OK to confirm the deletion of the selected workspace.
   • Click Permissions to grant permissions to the selected users to access the workspace. In the Workspace Permission dialog, you can also delete users and modify their permissions.

Create and Manage Projects

You can create and manage projects in the Projects in Workspaces section on the Workspaces page.

To create and manage projects:

1. On the upper section for workspace, click on the workspace in which you want to create the project.
2. On the lower section for projects, click Create to create a new project. The Create Project dialog opens. Enter a project name, enter comments if any, and click OK. Note that the Workspace field displays the workspace that you selected on the upper section.
3. Click on the project that you want to modify. The following options are enabled.
   • Click Edit to change the project name.
   • Click Delete to delete the selected project from the workspace.
   • Click Move to move the selected project to another workspace.
   • Click Set as Current to set the selected project as the default or current project.

3.3 Grant Workspace Permissions

You can collaborate with other users in Oracle Machine Learning User Interface (UI) by granting permissions to access your workspace. A workspace consists of projects. Projects consist of notebooks and experiments.

By granting different types of permissions such as Manager, Developer, and Viewer, you can allow another user to view your workspace and perform different tasks in your projects and notebooks such as edit, create, update, delete, run, view notebooks and so on. For more information about the permission types, see About Workspace Permission Types.

Caution:

If you grant the permission type Manager or Developer, the user can also drop tables, create tables, and run any scripts at any time on your account. The user with Viewer permission type can only view your notebooks and is not authorized to run or make any changes to your notebooks.

To grant permission to another user:

1. On the top right corner of Oracle Machine Learning UI home page, click the project and workspace drop-down list and select Workspace Permission.
   The Permissions dialog box opens.
2. In the Permissions dialog box, select a user from the Username drop-down list.
   
   
   Description of the illustration select_workspace_permission.eps
   
3. In the Permissions drop-down list, select the permission type you want to grant to the selected user.
   • Manager
   • Developer
   • Viewer
   
   Description of the illustration workspace_permission.eps
4. Click Add.
   The selected user is granted the assigned permission. The user name is displayed in the Permissions dialog box, along with the permission type.
5. Click OK. This completes the task of granting permission to a user. To delete a user and the associated permission, select the user and click Delete.

• About Workspace Permission Types
  Oracle Machine Learning UI allows three types of permissions. Depending on the permission type, you can allow the user to view or perform different tasks in your workspace, projects, and notebooks.

3.3.1 About Workspace Permission Types

Oracle Machine Learning UI allows three types of permissions. Depending on the permission type, you can allow the user to view or perform different tasks in your workspace, projects, and notebooks.

The permissions are privileges granted to shared objects in a given workspace. Here, operations that are allowed on shared objects, for example notebooks, are discussed. For instance, the user to whom the Developer permission is granted can only view scheduled jobs on shared notebooks; he cannot run these jobs. However, the user with Developer permission can always view and run scheduled jobs on notebooks that are created by him. The three types of permissions are listed in the following table along with the actions that are allowed.

Note:

Permissions are granted on workspaces, and not on projects.

Permission Types	Actions based on permission
Manager	Project: Create, update, view and delete. Workspace: View only. Notebooks: Create, update, duplicate, run, export, import, and delete. Jobs: Schedule and run jobs.
Developer	Project: View only. Workspace: View only. Notebooks: Create, update, run, duplicate, import, export, and delete notebooks. Note: A user with Developer permission can update, run, duplicate, import, export, and delete only those notebooks that were created by the user. Jobs: View and run jobs of shared notebooks only. Note: A user with Developer permission cannot create jobs for notebooks that are shared.
Viewer	Project: View only. Workspace: View only. Notebooks: View only. Jobs: View jobs and job runs of shared notebooks only.

For tasks that can be performed by an Administrator, see: Oracle Machine Learning Administration Tasks