Projects

Simplifier organizes all content (e.g. resources and Implementation Guides) in projects. A project can be used to share all your FHIR resources and documentation with the community as well as to collaborate with other project members.

Project page

Each project contains a couple of tabs depending on the settings of the project and your role in the project. The tabs described below are visible for each user in each Simplifier project.

Introduction

This section serves as an overview of your project. This is a good area to share information about your project with people that may be team members or viewing your project for the first time.

On the Introduction page of a project you can find:

  • A summary text as added by the project owners
  • A summary table describing the contents of the project:
  • Total number of resources per resource type
  • Total number of examples per resource type
  • The canonical base URLs supported in the project
  • The workflow statuses supported in the project

When clicking on a resource type in the summary table (e.g. profiles) you navigate to the Resources tab, where the resources will be filtered on the selected resource type.

Resources

On the Resources tab you can find all the Conformance and Example Resources for the project. This tab also offers a search and filter option. You can filter your results to include or exclude certain Resource categories, Core base types, Example Resources type, FHIR status, and Workflow status.

Guides

The Guides tab shows all Implementation Guides for this project built in Simplifier. Click on the Guide or hit the Browse button to go to the Implementation Guide. Use the IG-editor to create and edit Implementation Guides.

Members

On the Members tab you can find all project members and their role. This tab also offers a search option, allowing you to search for other members using their full name or username. Depending on your role in the project you can add project members here.

Log

On the Log tab you can see all the changes that have been made to this project in the past. This is a good way to stay in touch with whats happening within your favorite projects.

Issues

On the Issues tab you can leave your issues regarding the project. Note that this tab is not visible in all projects. The Issue Tracker is a paid functionality that allows project members to collect feedback from other project members or (depending on the project settings) other Simplifier users.

Milestones

The Milestones tab shows all released versions of a project. Project members may use this beta functionality to release project versions containing (a selection of) resources as a package.

Bookmarks

To stay informed in real time click the Bookmark button in the top right. You do not have to be a member of a project to stay up to date on the latest developments.

Create a project

In the Projects tabs on your Portal page you can find the button labeled Create. Clicking this button will allow you to create a new project by entering a Display Name, Description, and Scope. Once the project has been created you can then customize project information, add resources, add members, and follow changes that are occurring in that project.

Project Settings

You can always change your project settings by clicking on the Settings button in the right upper corner. There are a couple of options in the Settings menu, which will be explained below.

Properties

Here you can edit the following properties: - The title and subtitle of your project - The FHIR version (DSTU2 or STU3) - The scope of your project (core, international, national, institute, regional or test). As choosing the right scope will make it easier for others to find your project, please use test for all test projects and test projects only. - Issue tracking by project members and other Simplifier users - Publishing project resources to the FHIR registry (registry.fhir.org)

Project url

Here you can edit the URL key to your project on Simplifier, which is by default the name of your project. Be careful editing the URL key in a later stadium as it will break all existing links to your project.

Documentation url

If you have any external documentation on your project, you can add the link here.

Avatar

Choose this option to add your company logo or just any cool picture you like!

Workflow

Here you can select one of the custom workflows of your organization to use it in your project. The workflows are configured and mapped to the FHIR workflow add the organizational level.

Canonical base urls

Project owners can customize their base canonical URLs to brand their projects. Canonical URLs of resources will only be valid if they match the canonical base URL of their project. Make note that by choosing a canonical URL you are also certifying that it is within your rights to do so.

Import log

Use this option to retrieve a log with all uploads to your project.

Administration

This option is only available for project members with an admin role. Use this option if you want to delete your project or if you want to change its visibility to either public or private.

Add resources to your project

On the Resources tab you can find all the Conformance and Example Resources for the project.

If you have “Write” rights to a project you will see an option to +Upload resources at the top of the Project Page. Here you can choose one of the following options:

1. Upload a local file

The following Upload options are available:

  • You can upload .json or .xml
  • You can upload a single resource or multiple in a bundle
  • You can upload a .zip file containing multiple files

2. Fetch a resource from another FHIR server

If you choose to add resources from a FHIR server, you can do a simple GET or a FHIR search. The first will add a single resource, the latter will let you add multiple resources at once.

Examples:

  • To add a Patient resource with id “example” :
    http://example.org/fhir/Patient/example
  • To add all Patient resources that conform to the DAF profile:
    http://example.org/fhir/Patient?profile=http://hl7.org/fhir/StringDefinition/daf-patient

3. Copy/Paste json or xml code

By selecting the Copy/Paste option, you can add your own json or xml code to add a single resource or a bundle of resources. If your code contains a bundle, you can either upload it as a single resource or select the split bundle check box to upload all entries as separate resources.

Adding multiple resources at once

If you add a batch of resources (via a bundle, a zip, or a search query), you can choose how to publish the resources that are part of the batch. The following options are available:

  • Do not publish these resources automatically
  • Publish these resources when their status is “Active” (examples will always be published)
  • Publish all of them

Add project members

The Members tab displays a list of all the members with rights to that project. In this section you can invite Simplifier and non-Simplifier members to your project by clicking the +Invite User button and typing in an emailaddress.

When adding new members to your project you have the option to assign “Admin”, “Writer”, or “Reader” rights to that user. This assigns their rights within that particular project and can be changed at any time should someone’s function change. Users have the following rights within each role:

  • Admin- Has the rights to change anything within the project with the exception of project ownership.
  • Writer- Has the rights to add, change, and delete resources within the project.
  • Reader- Has the rights to view anything within the project but cannot make any addtions or changes.

Along the top of the Members tab you will find a summary of User information for your project. The number of users, the max users allowed for this project (in accordance with the type of plan you have), and the number of invitations you have pending (the number of users who have a not yet accepted an invitation).

../_images/Numberofmembers.png

Track Project Changes

On the Log tab you will find event tracking of a project. This log keeps a list of all changes made to resources within the project, along with the name of the person that made changes and the time the changes were made.

At the top of the screen you will find the Atom feed button. This allows you to subscribe to stay informed about any changes being made within your projects. To utilize this feature, navigate to a project on Simplifier.net that you are interested in following. Once there click on the “Subscribe” button in the upper right hand corner and copy the link into a feed reader of your choice. You are then ready to start receiving updates.

Issue Tracker

Would you like to capture feedback about your resources from users? The Issue tracker option is a great way to do this. If you go to the Options dropdown and then select Edit Project Properties. You will see the option to Enable Issues at the bottom of your screen. By selecting the On option, you enable the issue tracking feature of your project. There are two additional options that display once you have turned the Issue tracking on. You have the option to limit Issue visibility to project members or make them publicly visible. The issues that are reported by the community can also be limited to be viable only to your projects member or visible to the public. These issues can either be reported at a resource level or at a project level. At the project level you will see issues that are project specific and issues from all the resources in that project on the Issues tab.