Sharing IDA files
A file stored in IDA can be made accessable by describing it as a dataset and publishing it in Etsin research data finder. This makes your dataset citable and your data discoverable for others. The dataset description in Etsin can have a direct download link to the data stored in IDA, or you can share your data in a more controlled way by granting data access rights on application via Etsin.
For the time being only a single file can be added to Etsin's dataset description. If you dataset consist of multiple files you can compress (zip) them into a single file before uploading the file to IDA. If your data consists of multiple large (over 100 GB) files you can also upload them separately to IDA and link the dataset descriptions together in Etsin.
Before publishing the dataset description in Etsin you should make the file stored in IDA downloadable. This requires setting the right metadata (see below) into the file directory and the file.
Before the file is openly downloadable, the file in question and the folder in which it is located needs to have specific metadata fields. General instructions for managing metadata with browser: http://openscience.fi/ida-browser-metadata. Instructions for managing file opening related metadata with command line: http://openscience.fi/ida-commands-sharing.
Please note, that at the moment only the user who has uploaded the file or created the folder in IDA can edit its metadata with browser user interface.
- Set correct folder metadata in IDA
The file needs to be stored in IDA's automatically generated "published" folder or in another folder, which has a metadata field with the name "metamodel" with a value "Etsin". You can add metadata fields in the browser user interface by clicking the Add-button. Note that the metadata name and value are case sensitive. Save before closing the window.
- Set correct file metadata in IDA
Add a metadata field to the file itself with the name "availability" and value "direct_download" (see screenshot above). Again, you can add metadata fields by clicking the Add-button. Note that the metadata name and value are case sensitive. Save before closing the window.
- See file identifier in IDA
A file gets an automatically generated metadata field called "Identifier.series" a few minutes after the upload is complete. Copy the value and paste it e.g. on a notepad for later.
- Optional step: direct download link to the file
The changes made in steps 1-3 are registered in the system within a few minutes. After that you can check that the opening of the file was successful by adding the "Identifier.series" value together with the url "http://avaa.tdata.fi/openida/dl.jsp?pid=". Example of a direct download link to the file: http://avaa.tdata.fi/openida/dl.jsp?pid=urn:nbn:fi:csc-ida-3x201703172015017954033s . Note that this link not permanent and may change in the future. Permanent citations should be made with Etsin description's permanent identifier.
- Create dataset description in Etsin
Next, log into Etsin – research data finder with your Haka ID and click "Add dataset". Follow the instructions to describe your data. More help available at http://openscience.fi/add-datasets.
- Insert IDA file indentifier in Etsin
Go to the "Access information" section: select "directly downloadable" and follow the link "direct download from IDA". Insert the value of "Identifier.series" metadata field of you IDA file to include a download link to your file.
- Complete the description and publish dataset via Etsin
Add other information to the description and when it is ready, publish it. Your dataset will have a public description page with a link called "Access this dataset freely". Your file download starts by clicking this link.
If your dataset consists of multiple files you can describe them separately in Etsin and link them together by using the "Related dataset" part in Etsin description's "Identifier" section. More information in Etsin user instructions.
When citing your dataset or linking it always use the dataset description's permanent identifier (Etsin page). The permanent identifier will link to the description in Etsin. The permanent identifier created by Etsin can be found from the dataset description's "Identifier" field and it has the form:
You can also present the permanent identifier as a link, which starts working the next day after the description has been published:
It is important to refer to the dataset's description page when citing the data, so do not use the IDA identifier when citing. Etsin also offers dataset citing guidelines for users.
If you need more control over sharing the file, it is also possible to grant use rights for the file via an application form. With access rights management service it is possible to grant the rights to file download only to specified Haka users.
- Set correct folder metadata in IDA and see IDA file identifier
The file must be saved within a folder in IDA whose metadata contains a field "metamodel" that has "Etsin" as its value (such as the ready-made published folder). Again, see the file's metadata field called "Identifier.series" and copy its value on e.g. notepad for later.
- Set file availability in Etsin and insert IDA file identifier
Go to Etsin description's "Access information" section and select that the dataset is available for use by "using access rights management service". Then choose "Manage access rights using the default service". Enter the "Identifier.series" value from the IDA file metadata in the field below ("Enter identifier for the dataset" field).
- Set distributor
Go to the "Actors" section. Insert the Haka email address of the person who will be handling the applications in the Etsin description's "Distributor" field. Information regarding applications will be sent to this person's email. The inserted email has to be in the form of <Haka id>@<organization>.fi.
- Complete the description and publish via Etsin
After publishing the description the distributor will receive an invitation to the access right management service. The distributor must follow the link in the email to begin using the service.
Notice: The access rights to the data can only be applied by persons with Haka ID.