ART Project Editor

Revision as of 20:05, 30 October 2014 by Ahenket (talk | contribs) (Maintaining a local OID Registry)

External services

The external services that can be configured on the project-tab:

  • The ART-DECOR Automatic Notifier System (ADANS)

Reference a building block repository

In order to use concepts, value sets, and templates from a BBR (building block repository), it is necessary to first add a reference to a repository. Follow these steps to add a reference to a BBR from a project:

  • Log in as decor-admin
  • Go to tab Project/General
  • Click on Add building block repository. This will show a list of BBR's (depending on the server settings, these can include BBR's that reside on this server and/or BBR's that reside on external servers. See also the ART maintenance manual).
  • Select a BBR
  • Click add to add a BBR-reference in the current project

Screenshot that shows the user-interface for adding a BBR-reference from a project: En project bbr reference.png

  • Click Save to update the project information
  • After saving the project information, the BBR-reference is shown like:

En project bbr reference added.png

  • After adding the BBR-reference: when adding dataset concepts, value sets or templates, content from the BBR is also presented in the current project

Adding authors to a project

Before a user can edit a project, the following steps must be performed:

  • the user must have a personal ART-DECOR user account, please Contact us to obtain one
  • the user must have the proper group permissions (See also the ART maintenance manual)
  • Now the user can be added to the project by a decor-admin from the project:
    • Log in as decor-admin
    • Go to tab Project/Authors
    • Add a user to the current project by clicking Add author
    • Select the user
    • Click Add
    • Click Save to update the project information

Project specific author settings

Any ART-DECOR user may be active in multiple projects. He may be acting from different organizations depending on the project, and he may be more or (temporarily) less involved. For these reasons ART-DECOR supports switching on/off notification settings for ADANS on a project specific level. Any user with 'decor-admin' rights in the project can adjust the settings for any project author. In addition to that, the decor-admin project user may switch the ADANS notifier on/off for the entire project. All other project (issue) authors can adjust their own settings.

The notifiers work as follows:

  • project notifier is on when it is '---' or 'on'. project notifier is off when it is 'off' (project opt-out)
  • user notifier is on when it is 'on'. project notifier is off when it is '---' or 'off' (user opt-in)

normal user view

decor-admin user view

Creating a new version / release / publication request

ART supports the creation of a project publication. For the publication feature to work, ADRAM needs to be installed and configured for this project. The creation of a version/release works as follows:

  • Log in as decor-admin
  • Check that ADRAM is configured for this project. On the tab 'Project/General', Publication location should contain a URL where the publication is going to be published. Behind the 'Publication location' it should show 'Release and Archive Manager configured' (this checks that ADRAM is configured for this project at the publication location).

normal user view

  • On the tab 'Project/Version information', create a new version/release/publication request:

normal user view

  • This will open a dialog where information detailing the version/release/publication request can be entered:
    • Description: enter a text describing the version or release.
    • Type: Intermediate version, or Release. For a release a release label can be entered.
    • Save compilations in the following languages: languages can be de-selected to exclude them from the publication.
    • Publication request: selecting this checkbox will trigger ADRAM to create a publication at the publication location shown.
    • Select 'Add' to confirm.
Error creating thumbnail: Unable to save thumbnail to destination
  • ADRAM will check periodically for new publication requests and will create the publication at the publication location. Typically a review should be done after which the publication status can be upgraded to 'Draft/Active/Retired/Cancelled' via the tab 'Project/ Versions/Releases'. The status for a publication can now be updated in the column 'Edit':

normal user view

  • ADRAM will re-check and update the publication status at the publication location. Visit the publication location URL to see the various releases:

normal user view

Maintaining a local OID Registry

ART-DECOR has a central place for registration of OIDs but you can certainly have your own local registrations. This is useful for example when your project contain references to code systems not maintained in ART-DECOR, nor administered in one of the hosted central OID Registries. Please note that centralized registration is usually to be preferred.

To view the local ids, you don't need to login. To update them you need to have decor-admin privileges and be author in the project. In both cases, go to the Ids tab on the Project form.

The Ids tab is divided in two sections "External Ids" and "Base Ids". The External Ids is meant for OID, defined and potentially registered outside the project, and used in the project. The External Ids may be of any type like Identifiers, Identification systems, Code systems etc. The Base Ids are used as an Identification system for the identification of various DECOR project artifacts and are normally derived from the project id.

Add a new id in either section using the appropriate [+] button. Update a description by updating the appropriate fields. Don't forget to Save.

The base ids also sport the option "Default". When you have multiple base ids for a specific type, you may switch the default base id. Switching the default means that new artifacts of that type will be created using this new default unless you override.

project ids