Differences

This shows you the differences between two versions of the page.

--- eln-guide-basic-data-dryad [2026/04/06 19:39] – csdunham
+++ eln-guide-basic-data-dryad [2026/04/06 21:51] (current) – [Step 5: Lock & Export] saejinoh
@@ Line 7: / Line 7: @@
 //Fig 1. ELN navigation bar. Users can access the Data Dryad Launchpad from the navigation bar.//
 \\
 ====== Dryad Dataset Workflow ======
 The Data Dryad workflow is described in the following sections.
 ===== Step 1: API token =====
-In order to submit data to Data Dryad, you must first obtain an API token from your Data Dryad account page. Upon activating the API account, you will see the ability to generate an API token at the bottom of the page, as shown in Fig 2. Upon generating a token, it will remain active/usable for 10 years. After 10 hours, the user will need to get a new token.
+In order to submit data to Data Dryad, you must first obtain an API token from your Data Dryad account page. Upon activating the API account, you will see the ability to generate an API token at the bottom of the page, as shown in Fig 2. Upon generating a token, it will remain active/usable for 10 hours. After 10 hours, the user will need to get a new token.
 \\
 \\
@@ Line 18: / Line 19: @@
 //Fig 2. Data dryad token generator. Clicking the button to get a new token will provide the user with an API token. This token lasts for 10 hours, after which a new token must be generated.//
 \\
+----
 ===== Step 2: Create a Dataset =====
 Data Dryad datasets are created using the form shown in Fig 3. Many of the fields are required by default from Dryad, including: a title, author information, funder information, keywords, field of science, and so on. The first two fields -- Pages Relevant to Dataset and DataDryad API token -- are not part of the standard Data Dryad dataset creation process, but are necessary for the Launchpad. Why?
@@ Line 43: / Line 47: @@
 {{:dryad-dataset-view.png?600|}}
 \\
-//Fig 5. Landing page when Viewing a Dataset. Shows the dataset editing form, available and attached (uploaded to Dryad) files, and README editor.//
+//Fig 5. Landing page when Viewing a Dataset. Shows the dataset editing form, available and uploaded-to-Dryad files, and README editor.//
 \\
+----
 ===== Step 3: Sending Files to Dryad =====
-As you link ELN pages to your Dataset, any and all attached files that are available to the ELN page become available to direct upload to Data Dryad.
+As you link ELN pages to your Dataset, any and all attached files that are available to the ELN page become available to direct upload to Data Dryad. Fig 6 shows this window in more detail. Clicking 'Add to Dryad' expands the file card to display a form with fields for your API token and a file description. Successful submission of this form will move the file from the 'Available for Upload' column to the 'Uploaded to Dryad' column, and the button text will change to 'In Dryad'.
+\\
+\\
+{{:dryad-send-files.png?600|}}
+\\
+//Fig 6. Dryad file management window. This window shows two panels, or columns, one for Available for Upload and another for Upload to Dryad.//
+\\
+\\
+Once a file has been uploaded to Dryad, it cannot be deleted from the Dataset without going directly to Data Dryad to do so. This is due to limitations in the Data Dryad API. A future update will permit file deletion from the LIMS in a manner similar to what exists for deleting a dataset from the LIMS (see the 'Launchpad Caveats' section).
-===== Step 4: README File =====
+----
-TBD...
-===== Step 5: Lock & Export =====
+===== Step 4: README File Editor =====
-TBD...
+All Data Dryad submissions require a README file. Details of the README file can, and should, be viewed at the Data Dryad website. Data Dryad README files are written in the Markdown language, and in order to help you write your READMEs for Dryad, we've produced a rich text-to-Markdown editor (Fig 7) that looks and works exactly like the ELN's text editor you're familiar with, except it outputs Markdown content! It also has had some features removed that are not Markdown-compatible.
+\\
+\\
+{{:dryad-readme-editor.png?600|}}
+\\
+//Fig 7. Rich text-to-Markdown editor. The editor content is always loaded with the default Markdown template provided by Data Dryad to get you started with your README file.//
+\\
+\\
+The Markdown editor here has an autosave feature, and any content entered into the editor is automatically saved every 2 seconds. Successful saves display a timestamp for the last time they were saved. The Markdown editor supports standard Markdown features, such as: header levels, ordered and unordered lists, tables, and basic text formatting. These README files are not intended to hold image-based information, so image and video uploads are disabled.
+\\
+\\
+**An important note:** Data Dryad has an expectation, really a requirement, that the README file contain at least a bit of information for every file that you've uploaded as part of your dataset. This information is often expected in the form of //**'[file_name]': description of file contents and how to use it correctly**//. However, Data Dryad's API does not communicate information about README file deficiencies like this, nor does it allow editing of an uploaded README over the API (or, at least, those methods aren't exposed; we will revise this section if that changes). A consequence of this is that we are not able to enforce some of Dryad's README conventions in the ELN's README editor, and so, you will need to reconcile discrepancies via the Data Dryad website (reminder: you can always access the Data Dryad website for your dataset by clicking the 'Link to Dryad' link on the dataset card).
+----
+===== Step 5: Lock & Export =====
+Once you've finished sending files to Dryad, editing your Dataset's metadata, and formatting your README file, the time will come to close up shop for this Dataset and lock and export your README file to Data Dryad. This is where the Lock & Export feature is used. Clicking this button reveals a form field for your Dryad API token. Upon providing the token and clicking Confirm Export, another dialog box will pop up to remind you of the consequences of this action: the editor will become locked, editing the Dataset metadata in the Launchpad utility will be disabled, and files will no longer be available to upload to Dryad from this dataset. In short, it deactivates all mechanisms to send data from the Launchpad Dataset to Dryad. Please make sure this is the action you want and are ready for!
 ====== Launchpad Caveats ======