For Spring 2017, one of the OME development sprints will include the ability to explicitly create and tag a 'template' in your OME account that can be recycled to pre-fill metadata elements that may be common to multiple records you create (e.g., contact information, keywords, entity & attributes that are shared by multiple datasets). Right now, however, there is an alternative and easy way to create a kind of template that will serve the same purpose.
CREATE YOUR TEMPLATE:
- Choose 'create a new record' from the OME main screen. You will have to make a decision as to whether your template will be a Core CSDGM or a Biological Data Profile template, based upon which flavor of the standard you use most often; however, there is a workaround to change a template from Core to BDP, which will be explained at the end of this document.
- Once you have your new record open, give your template a title, e.g., 'Core CSDGM Record Template' or 'BDP CSDGM Record Template.'
- Fill in any fields that you believe will be shared across records you create. As a best practice, Quick Save after each tab in which you enter metadata.
- Do a final Quick Save. Your template is now ready to use.
USE YOUR TEMPLATE:
There are currently 2 ways to utilize this template record within the OME. The method you choose will depend upon your personal preference, as well as whether you want to share the template with other colleagues who may also be developing metadata for your center or program.
Option 1: A template that 'lives' inside your OME account. This option works well if you don't need to share your template with others, and if the OME is your primary tool for creating metadata.
Whenever you open an existing record, change the Title of the record, and then Save, you are performing a 'Save As'; in other words, you are creating a new record with this new title, while maintaining the original version of the record with its existing title in your account. (NOTE: as of this time, you cannot delete records, including 'old versions,' from your account yourself; this capability will be added in Spring 2017). This behavior can be leveraged to use an existing record - your template - and edit it to generate a new record for a specific dataset.
- From the OME main page, find your Template in your dropdown menu of Existing Records, and choose Load Record.
- Edit the Title of the Template to reflect the title of the new dataset you need to describe. Click Quick Save. You have now started a new metadata record for your new dataset; your Template is preserved in its original state.
- Continue to edit and generate new metadata for your new dataset.
Option 2: A template that lives outside of the OME as an XML file on your local drive. This option works well if you want to share your template with colleagues, or if you often move between metadata editors (e.g., you want to start your metadata in the OME, but you may finish it in an XML editor, TKME, or the Metadata Wizard).
- If you have just finished and saved your metadata template, click 'Download Draft XML Without Validating.' If you have previously 'Save(d) & Close(d)' your Template, Reload it, and then click 'Download Draft XML Without Validating.'
- You now have a copy of your Template on your local drive. You can share it with colleagues, or open it in other XML editors.
- To use your Template to create a new record in the OME, login to the OME, and from the Main screen, go to 'Upload an Existing CSDGM File' and choose the version of the CSDGM (Core Schema or BDP) that matches the Template you are using.
- When the editor launches with your template pre-filling your default values, edit the Title of your metadata record to match the title of the dataset you will be describing. Click Quick Save. Your new record has now been started.
I created my Template using 'Core CSDGM,' but now I need to write a record that complies with the Biological Data Profile. How can I re-use my Core CSDGM Template to do this?
You will need to use Option 2 to convert your Template from one version of the CSDGM to the other. After following the instructions for Option 2:
- From the OME main screen, go to 'Upload an Existing CSDGM File' and choose the version of the CSDGM (Core Schema or BDP) that you now need to use to write your record. The OME will override whatever schema is declared in your Template and replace it with the new schema you are choosing for this new record.
- Edit the Title of your record from 'Template' to the actual Title of your new dataset.