Manage platform projects

Any HERE platform user can create platform projects. Org admins and projects admins can give/remove apps, groups and users access to/from a project. The user who creates a project becomes the project admin for that project. Org admins and project admins can change project admin permissions of users, including their own. Project admins can only administer those projects for which they have admin permissions. Org admins can manage all projects, even if they haven’t been explicitly granted project admin permissions.

Note

When working with platform projects including the creation of project resources or viewing lists of resources in a project, you will observe the project context displayed. For example:



You may change the project context to another project, opt to view all projects or simply remove the project context filter altogether depending on what resources you’re interested in.

Create a platform project

  1. Sign in to the HERE platform.
  2. Open the Projects Manager from the launcher.
  3. Click Create new project.
  4. Enter a name for the project (project names don't have to be unique).
  5. Enter a project ID. Project IDs must be unique with an org and cannot be changed for the lifetime of the org. Project IDs must be between 4 and 16 characters in length.
  6. Enter an optional description.
  7. Click Save.

Grant access to a platform project

  1. Sign in to the HERE platform.
  2. In the Projects Manager, click the project to which you want to give a user, group or an app access to. Select the Access and permissions tab to view a list of users, groups and apps with access to the project.
  3. Click Give access.
  4. Select from either user, group or app type.
  5. Enter the name in the search field to find the desired user, group or app by name.
  6. Select the desired name and click Give access. The name is now listed.

Note

By default, all members (inlcuding users, groups, and apps) of the project will have available access to all resources in the project. You can set up granular access to project resources through the platform and/or custom policies using the Command Line Interface (CLI). Please see the [CLI User Guide] (https://developer.here.com/documentation/open-location-platform-cli/user_guide/topics/projects-workflows.html) for details on how to set up these policies.

Remove access to a platform project

  1. Sign in to the HERE platform.
  2. In the Projects Manager, click the project in which you want to remove a user, group or an app access from. Select the Access and permissions tab to view a list of users, groups and apps with access to the project.
  3. Click the ellipsis menu to remove the user, group or app access to the project. A Remove from project button appears.
  4. On the popup dialog, click Remove to confirm.

Specify a default platform project for apps

Any manager of an app can set or change the default project for the app from the app details page by selecting the Change default project menu option. Subsequently selecting a project in the dialog will set that project as the default project scope for the app. The manager can permit access to other projects by the app as well.

Grant or revoke platform project admin permissions

Only org and project admins can change user project permissions. Org admins can change user permissions on any project. Project admins are restricted to change user permissions for only those projects for which they have admin permissions.

Note

While an app cannot be given org admin or group admin rights, you can make an app a project admin in the same manner as you may make a user a project admin. Groups cannot be project admins.

  1. Sign in to the HERE platform.
  2. Click on the Access and Permissions tab of your project to view a list of users, apps and groups with access to the project.
  3. Click the ellipsis menu to change project admin permissions for a user or an app. A Make project admin button appears if the user or app is not already an admin. A Revoke project admin button appears if the user or app is an admin. Clicking the appropriate button will immediately change the project admin permissions for the user or app.

To add a catalog to a project, you may create a new catalog in a project, link to an existing HERE catalog from a project, or link to a catalog that's been created in another project in your org and made available for linking to your project.

  1. Sign in to the HERE platform
  2. In the Projects Manager, click the project to which you want to add a catalog and select the Resources tab.
  3. Click Add catalog and choose to either Link a catalog or Create a new catalog.
  4. When linking a catalog you are presented with a list of catalogs provided by HERE, as well as catalogs that have been made available for linking from other project(s) within your organization. Click the Link button for the desired catalog. If a choice is available, select the desired permissions, eg "read" and/or "write". The catalog will appear in your list of project catalogs with a link icon next to the catalog name and the linked permissions.
  5. To unlink a catalog from your project, click on the three dots and select Unlink.
  6. To change the permissions of a linked catalog, eg from "read" to "write", click on the three dots, select Manage permissions and follow the prompts.
  7. When creating a new catalog, complete all of the required fields and click the Save button. Ensure that you leave the Create catalog in a project option selected and validate the Home Project field matches the name of the project you want the catalog to be created in.

Sharing a catalog: Make a catalog in your platform project available/unavailable to other projects in your organization for linking

When you create a catalog in a project, you may choose to make that catalog available to all or specified projects within your organization for linking with permissions that you set ("read" and/or "write"). Note that this is a two-step process. Once you make the catalog available, a member of the project that wants to link to it will need to do so as described in step 4. in the section above.

  1. Sign in to the HERE platform
  2. In the Projects Manager, click the project that contains the catalog you want to share with one or more projects in your organization.
  3. Click the three dots next to the catalog you would like to share and select Set catalog availability. Specify the project to which you want to share the catalog or choose to "Make availalable to all projects in your organization". Specify the permissions to the catalog you want to share, ie "read" and/or "write", and click Set.
  4. To change the available permissions to a catalog after you have shared it, click the three dots next to the catalog and select Set catalog availability. Change the permissions by selecting the desired checkboxes. Note that this will not change the permissions to the catalog for any project that has already linked to the catalog.
  5. To revoke the availability of a catalog after you have shared it, click the three dots next to the catalog and select Set catalog availability. If you previously selected "Make available to all projects in your organization", you may deselect that option. However, reverting availability of a catalog will not unlink it from a project to which it is already linked.
  6. The steps above describe this functionality in the context of Projects Manager. This functionality is also accessible to users with manage access to a catalog from the catalog detail page in the Data section of the portal. In addition, users with manage access to a catalog can unlink that catalog from a project from the Availability tab of the catalog detail page in the Data section of the portal. The steps for all of these actions are described in the Data User Guide.

Add or remove a pipeline resource to/from a platform project

Only new pipelines can be created in a project.

  1. Sign in to the HERE platform.
  2. In the Projects Manager, click the project to which you want to add a pipeline to and select the Resources tab.
  3. Click Create new pipeline, complete all of the required fields, clicking Next and Save as required. Ensure that you leave the Create pipeline in a project option selected and validate the Home Project field matches the name of the project you want the pipeline to be created in.

Add a schema resource

Only new schemas can be associated with a project except for schemas of HERE catalogs that are linked from a project.

results matching ""

    No results matching ""