Create a project from the Beyond template

Create a project in Beyond Projects from a template version you choose. The version is recorded with the project, and the project receives the identity that Workspace, Delegate and CDN share.

  • Availability: Experimental
  • Evidence: Recorded run
  • How-to guide

Before you start

You need both of these in the organization shown in the header:

  • a role that can create projects: Owner, Administrator or Developer. A Viewer cannot;
  • Workspace development access: the box Workspace development must say "You can develop in Workspace in this organization."

Without either, New project is absent and the list says "Creating a project needs Workspace development access and a role that can create projects." See I cannot create a project.

Create the project

  1. In Projects, choose New project.
  2. Fill in Project name, up to 120 characters. It is for people: you can rename it later.
  3. Choose the Template. The templates offered are the ones your installation configured. The Beyond web application template is named beyond-web.
  4. Choose the Template version. The first option, "Latest (x.y.z)" with the actual number, takes the newest version the installation offers; the others name one exact version.
  5. Choose Create project. The button reads "Creating…" while it works.

Expected outcome: the project opens, and the screen says "The project was created."

An empty name is refused with "Give the project a name." If the dialog says "No template is configured in this installation, so a project cannot be created yet.", nobody can create a project from a template there until the people who run the installation configure one.

Pressing Create project again after an uncertain answer does not create a second project: the dialog repeats the same request until one succeeds.

The template version is recorded, and never changes your source

The dialog says it: "The project starts from the template version you choose. That version is recorded with the project and later template versions never change your source."

On the project, Created from shows that record as the template name, the version and the first characters of the exact source revision, as in "beyond-web 0.1.0, revision" followed by the revision. It is a statement of origin. A newer template version does not update your project, and nothing offers to.

What the project contains is described for developers in The project template.

The project identity

Under Project identity, the screen says "The same identity is used in Workspace, Delegate and CDN." and shows a value such as prj_0f3c9a1b2d4e5f6071829304: prj_ followed by 24 lowercase hexadecimal characters.

  • Choose Copy beside it. The button answers "Copied".
  • The identity never changes, also when you rename the project, and it is never given to another project.
  • Search projects finds a project by it, and you paste it when you adopt an existing Delegate project.

Limits

  • A project is created in the organization shown in the header and stays there. Moving it to another organization is not possible.
  • Creating a project opens nothing and publishes nothing. There is no publish action in Projects.
  • An external repository cannot be imported as a project. For work that already exists in Delegate or CDN, register an existing project instead.

Next action

Open the project in Workspace, Delegate or CDN.