After you’ve uploaded your file to the GEMShare server and decided you want to share it with others, your next step is registering the file. Registering makes GEMShare aware of the file so you can grant access to people, teams, or the world. It also allows you to add useful metadata that will not only help others find the file, but make it more interoperable with other data and help people use it more effectively.
Registering a file generally takes two steps:
If the file contains columnar data, there are four additional steps that can help make your file more usable by others:
GEMS will guess about the delimiters in your file and whether the first row of the file contains column names. If it guesses incorrectly about any of this you can change it here. If the first row of your file does not contain column names GEMS will use simple sequential names (column1, column2, etc.) for your columns, which you can change to more useful names on the column metadata screen.
You can change the names of any of the columns in your file on this page. This will not make any changes to your file. It will only change the column metadata that is included with it. You might have column names that are
Changing these names to more useful and recognizable names will help those who find your file more easily work with it.
You can add helpful notes for any of the columns in your file. This could be things like:
Using files from disparate sources on the same project is part of what GEMS is meant to enable, and one of the ways we encourage interoperability is by helping you link common concepts in different files using industry standard terms.
On the ontology match screen you can match each of your columns to industry terms from several domain-specific ontologies (ten as of this writing, though more are planned). When the page first loads you’ll see that GEMS has already filled in an ontology match in cases where there was an exact match with your column’s name. These are just initial suggestions, and you are free to change these.
There are two ways to change the matched term for a column:
Some columns in your file might have subtle variances in how the same values are presented (capital vs. lowercase, minor spelling differences between regions, etc.). GEMS will provide spelling suggestions for columns that are eligible, and can even make the suggested updates to a new copy of your file. This will not alter your original file.
To view the spelling suggestions, click the Select Corrections... button for the column whose suggestions you’d like to see.
The Spelling Change Recommendations dialogue box shows each instance of a potential misspelling in a column, the alternative recommended spelling, as well as how many times each spelling appears in the column.
If you would like GEMS to create a new file that features spelling recommendations you have accepted, click the Select Corrections... button for each column, select any spelling updates you’d like, then click the Save Changes at the bottom of the dialogue.
When you’ve completed your selections, click the Correct Spelling button and all the changes you specified will be made in a copy of your original file (your original file will not be altered). This new corrected file will now be the file you are registering.
The file metadata entry screen is the place to enter general information about your file as well as any relevant domain-specific qualities. General information includes not only the basics but things like keywords that will help people find the file, the date range that is covered by the file, any intellectual property rights that apply, etc. What you enter on this screen is meant to help people:
If you are unsure of how to fill in a specific field or what the term means, click the blue question mark next to the field name for a brief description.