2.4. Project Authoring

Projects and the associated assets can be authored from the Project Explorer. The Project Explorer can be accessed from the Home screen by clicking on AuthoringProject Authoring.

Figure 2.2. The Project Explorer screen

A screenshot of the BRMS Project Explorer

The project authoring screen is divided into 3 sections:

  • Project Explorer: The left pane of the project authoring screen is the project explorer that allows you to navigate through projects and create the required packages and assets. Clicking on the ( 4345 ) button allows you to set the view to Project view or Repository view. The contents of the project can be navigated in a tree view by clicking on the Show as Folders or in a single-line path by clicking on the Show as Links.
  • Content area: The content area shows the assets which are opened for editing. It has a toolbar with buttons like Save, Delete, Rename, Copy, and Validate that can be used to perform the required actions on the assets that are being worked upon.
  • Problems: The problems area shows the validation errors of the project that occur while saving or validating a particular asset.

2.4.1. Changing the Layout

The layout of any panel can be changed by the user. Each panel can be resized and repositioned, except for the Project Explorer panel, which can only be resized and not repositioned.

Resizing the layout

The layout can be resized in the following ways:

  1. To resize the width of the screen:

    1. Move the mouse pointer over the vertical panel splitter. The pointer changes to 4620 .
    2. Adjust the width of the screen by dragging the splitter and setting it at the required position.
  2. To resize the height of the screen:

    1. Hover the cursor over the horizontal panel splitter. The pointer changes to 4619 .
    2. Adjust the height of the screen by dragging the splitter and setting the required position.
Repositioning the layout

To reposition the layout, do the following:

  1. Move the mouse pointer on the title of the panel. The pointer changes to 4621 .
  2. Press and hold the left click of the mouse and drag the screen to the required location. A 4622 symbol indicating the target position is displayed to set the position of the screen.

2.4.2. Creating new assets

Assets can be created using the New Item perspective menu option.

Figure 2.3. Creating new Asset screen

A screen shot of Creating New Asset

Clicking on an Asset from the New Item menu will open a Create new (Asset-type) pop-up dialog where a user can enter the name of the Asset.

Figure 2.4. Create new pop-up dialog

A screen shot of Create new pop-up dialog

2.4.3. Asset Metadata and Versioning

Most assets within Business Central have some metadata and versioning information associated with them. In this section, we will go through the metadata screens and version management for one such asset (a DRL asset). Similar steps can be used to view and edit metadata and versions for other assets.

Metadata Management

To open up the metadata screen for a DRL asset, click on the Overview tab. If an asset doesn’t have an Overview tab, it means that there is no metadata associated with that asset.

6593

The Overview section opens up in the Version history tab, and you can switch to the actual metadata by clicking on the Metadata tab.

The metadata section allows you to view or edit the Tags, Subject, Type, External Link and Source metadata for that asset. However, the most interesting metadata is the description of the asset that you can view/edit in the description field and the comments that you and other people with access to this asset can enter and view.

Comments can be entered in the text box provided in the comments section. Once you have finished entering a comment, press enter for it to appear in the comments section.

Important

You must hit the Save button for all metadata changes to be persisted, including the comments.

Version Management

Every time you make a change in an asset and save it, a new version of the asset is created. You can switch between different versions of an asset in one of two ways:

  • Click the Latest Version button in the asset toolbar and select the version that you are interested in. Business Central will load this version of the asset.

    6594
  • Alternatively, open up the Overview section. The Version history section shows you all the available versions. Select the version that you want to restore.

In both cases, the Save button will change to Restore. Click this button to persist changes.