# Creating and submitting a data request

{% hint style="info" %}
Data requests can only be created and submitted by Researchers and Data Facilitators
{% endhint %}

In order to access the data contained within a dataset, Researchers and Data Facilitators can create and submit a data request. These can then go on to be approved by a Data Request Approver or Administrator, which can in turn lead to the Researcher(s) or Data Facilitator(s) who submitted the request being 'onboarded' (granted access to the requested data).

### How to create and submit a data request

1. Select 'Dataset Library'.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FWEqXXcU29ceKLOTe3NE3%2Fimage.png?alt=media&#x26;token=870e146d-52cf-4b7b-9b6c-fe626db8a710" alt=""><figcaption></figcaption></figure>

2. Select the dataset you wish to request access to.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2F35tSYjIgGOm15WQcneCI%2Fimage.png?alt=media&#x26;token=9a215171-22df-489b-a666-a008a8c37bd1" alt=""><figcaption></figcaption></figure>

**Note:** If your chosen dataset requires a specific data passport or other requirements, they will be listed in the 'Data Passport Required' and 'Additional Requirements' columns respectively.

3. Ensure the data contained in your chosen dataset's 'Example Data' field is what you wish to request.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2Fil5lYtsIxkjWOYV7940J%2Fimage.png?alt=media&#x26;token=314d1f8e-8ed2-49ae-8211-a7fce837b098" alt=""><figcaption></figcaption></figure>

4. **If you wish to request access to this dataset**, select 'Start data request'. **If this is not the dataset you wish to request access to**, repeat steps 2 and 3 until you find the desired data.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FEsRo3v2PhjLaXHnONeKk%2Fimage.png?alt=media&#x26;token=f175dcbc-3011-4253-bfac-90f067103c2d" alt=""><figcaption></figcaption></figure>

**Note:** The user who starts a data request this way **automatically becomes a Project Lead**.

5. Name your data request via the 'Title' field.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FQjtyZUoKmof74YqXPTfD%2Fimage.png?alt=media&#x26;token=1bd1b123-04d5-42a0-bdae-9be42dc6ed31" alt=""><figcaption></figcaption></figure>

**Note:** From this stage onwards, a data request can be saved and exited safely at any time by selecting 'Save & Exit' (below).

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FCgabzkwSAQp56hM6gzU4%2Fimage.png?alt=media&#x26;token=b3c55976-d033-4048-8ff4-dd47283dc592" alt=""><figcaption></figcaption></figure>

6. Select whether you are requesting this data as an individual or a team.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2F98705s66TKJkQeO9753F%2Fimage.png?alt=media&#x26;token=0a2f8ce0-a31e-46c6-bc50-d00d3ff09655" alt=""><figcaption></figcaption></figure>

**Notes:**

* This setting cannot be adjusted later. If any team members plan to join/contribute to this data request in future, you must select 'Team'
* Only researchers and data facilitators can be invited as team members.

7. **If you selected 'Team'**, input the email of the first team member you wish to invite to the data request. **If you selected 'Individual'**, proceed to step 11.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2F80AVwuyEER4TqjaWi8ew%2Fimage.png?alt=media&#x26;token=944db071-2765-40d0-bddf-383032caa325" alt=""><figcaption></figcaption></figure>

8. Select the email.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FNBCcjxkAlpVhemHz7IY7%2Fimage.png?alt=media&#x26;token=64a66f31-9f55-4e6b-b214-5c8a92237b28" alt=""><figcaption></figcaption></figure>

**Note:** If the email address you entered into the text field was not complete (for example, it was missing its '.com'), the selectable version of the email will not appear.

9. Select whether the user you are inviting will act as the Project Lead, a Discussant or an Analyst.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2Fljs2zaH7vQwrFbyzfxLs%2Fimage.png?alt=media&#x26;token=89fe8284-67cc-4f08-a139-99c43a342447" alt=""><figcaption></figcaption></figure>

10. Repeat steps 7 to 9 until all relevant team members have been listed and assigned the intended role.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FmGkrfPm45cYvHvICuLp8%2Fimage.png?alt=media&#x26;token=598f7bd7-ee38-4be9-92fd-9c047ab358c7" alt=""><figcaption></figcaption></figure>

**Note:** Emails/team members can be removed from this list before they are invited via the delete icons (below).

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FKl6UbkvFAvCHggtPEtJf%2Fimage.png?alt=media&#x26;token=4426ade0-ed2c-4247-a627-690edcfd3fd2" alt=""><figcaption></figcaption></figure>

11. Complete any mandatory, and optionally any non-mandatory questions attached to this dataset.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FitCeuAybSKXsTV9lZCfQ%2Fimage.png?alt=media&#x26;token=c07dee92-1969-4a75-a12c-5384d7fe63cc" alt=""><figcaption></figcaption></figure>

**Note:** Mandatory questions are marked with a red asterisk (as is beside 'Today's Date' above).

12. Select 'Next Section' once satisfied.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FJROf3AOo2yKlOONzahhe%2Fimage.png?alt=media&#x26;token=0e38ceb3-f384-49e3-8aa9-f186d1a003a9" alt=""><figcaption></figcaption></figure>

13. Input the purpose of the data request.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2Fglh7yZvrhOdTqQ6WCkyr%2Fimage.png?alt=media&#x26;token=da04cffc-2292-41ec-a926-9cf09725cb81" alt=""><figcaption></figcaption></figure>

14. Select 'Next Section.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2F6ARdSJ9QJzAFymZMFStP%2Fimage.png?alt=media&#x26;token=fbd5c5b0-7800-4219-a5c7-1e5751e430fe" alt=""><figcaption></figcaption></figure>

15. Select the variables that represent the data that you or your team wish to access once onboarded.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FtjH7Wo1jKaoqfNOJ5GOd%2Fimage.png?alt=media&#x26;token=dcde80b0-b22b-411a-9444-385fdcef45b2" alt=""><figcaption></figcaption></figure>

16. **If you are a Project Lead**, select 'Submit'. **If you are not a Project Lead**, you will need to contact a Project Lead to submit the data request for your team.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FDKr6znCo0zNLLGbbhwAc%2Fimage.png?alt=media&#x26;token=96e4b7c7-8fb1-46d8-a274-d239c04dbc5c" alt=""><figcaption></figcaption></figure>

17. **If the dataset requires you to complete a data undertaking** (as shown by the red notification below), select 'complete'. **If the dataset does not require you to complete a data undertaking,** proceed to step 19.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2F74TpP8i8jYetaUHohlrm%2Fimage.png?alt=media&#x26;token=56bf149d-63b8-437e-8ce8-771a359f5669" alt=""><figcaption></figcaption></figure>

**Notes:**

* Outstanding actions that require completion before a data request can progress will appear beneath 'Correspondence', in the 'Data Request Checklist' (below)
  * This checklist will include incomplete undertakings
  * See [here](https://tablion-help.aristotlemetadata.com/data-requests/creating-and-submitting-a-data-request/data-request-checklist) for a list of all outstanding actions.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FcbP5juBm7bV1OhayJwr8%2Fimage.png?alt=media&#x26;token=58ca2166-b128-4b52-89db-da61aeeb9e09" alt=""><figcaption></figcaption></figure>

18. Read the data undertaking, then acknowledge that you have done so by checking the 'I acknowledge that I have read the data undertaking' checkbox.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FmiGxduQeR01xqxsRDpyi%2Fimage.png?alt=media&#x26;token=c917ef50-e4f3-4c62-a438-6c45c6ba17c0" alt=""><figcaption></figcaption></figure>

19. Select 'Submit acknowledgement'.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FuXtQkcc3HaPnvU0VJapF%2Fimage.png?alt=media&#x26;token=a5b84169-fc0a-47a4-8dba-ed642ce7c9ad" alt=""><figcaption></figcaption></figure>

20. **If you wish to download a copy of the signed data undertaking,** select 'Download Signed \[*Undertaking Name*]'. **If you do not wish to download a copy of the signed data undertaking, or once you have downloaded one already**, select 'Return to the data request'.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2F4fJhRSv8xzUV9aZhPUtO%2Fimage.png?alt=media&#x26;token=12572954-8955-4bcb-bb52-790c3b6b0dd3" alt=""><figcaption></figcaption></figure>

21. **If you have submitted a team data request and wish to invite more team members**, select 'Update Request', then 'Yes' to mark the request as a draft. **If you do not need to invite any team members**, proceed to step 24.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FWgasCj9T33icRi1nQK6M%2Fimage.png?alt=media&#x26;token=aeae2f57-411f-4629-8e98-c24cde3af61d" alt=""><figcaption></figcaption></figure>

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FSYuvvF9khwkoGZRmk8cj%2Fimage.png?alt=media&#x26;token=04a3894b-4493-453e-ba69-dfe98052a30e" alt=""><figcaption></figcaption></figure>

**Note:** 'Update Request' can be selected whenever updates need to be made to a data request. Once a data request is submitted, changes can only be made to it if it is reverted to draft status this way.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FluUDFt4mpfIa8YEv1LqC%2Fimage.png?alt=media&#x26;token=a6feed3a-e5b5-4905-8c16-dc310821674f" alt=""><figcaption></figcaption></figure>

23. Type and select the email of the user you wish to invite.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FIL5bnLGFJfspTZN064C7%2Fimage.png?alt=media&#x26;token=57f4301c-1cb0-4cf4-b0a0-11ff39c2a8ca" alt=""><figcaption></figcaption></figure>

24. Select whether the user you are inviting will act as the Project Lead, a Discussant or an Analyst.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FsbQ192js6HetSUFRcQyz%2Fimage.png?alt=media&#x26;token=8cc9cf90-6fd6-491c-8e65-8cab8c273ea3" alt=""><figcaption></figcaption></figure>

25. Select 'Add'. The user will be invited via the provided email address.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FFdXlUZD69QcFqyDtHL8A%2Fimage.png?alt=media&#x26;token=c7350471-449c-487d-82df-29ae3521947d" alt=""><figcaption></figcaption></figure>

26. **If you wish to communicate with fellow team members or approvers**, navigate to the 'Summary' tab, and use the 'Correspondence' section to do so. **You can proceed to step 25 once a Data Request Approver or Administrator has approved the data request.**

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2F054KJKIFhlWzsnxLV52g%2Fimage.png?alt=media&#x26;token=8be1164b-772b-4d88-bf44-33ac44956420" alt=""><figcaption></figcaption></figure>

**Note:** The data request, correspondence, and relevant variables can all be downloaded from the 'Summary' tab by selecting 'Download Request', 'Download Correspondence' or 'Download Variables' respectively (below).

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FZoSMkFLEPv8pyZ51v8wk%2Fimage.png?alt=media&#x26;token=85e47acb-2e14-4ca9-bb07-b9d9e6cfd378" alt=""><figcaption></figcaption></figure>

27. Once the data request has been approved, you are able to revert it. **If you wish to revert the data request,** select 'Revert Request'. Otherwise, **you can proceed to step 21 once you have been both approved as an Analyst or Project Lead and onboarded by a Data Request Approver or Administrator.**

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2FpbajJvWJ143QAZ4znINH%2Fimage.png?alt=media&#x26;token=b5a2dd24-3a79-455a-a87c-75edaa32d658" alt=""><figcaption></figcaption></figure>

**Note:** If a Data Request Approver or Administrator approves you as a Discussant, you cannot be onboarded (see '[Data Request Roles](https://tablion-help.aristotlemetadata.com/data-requests/..#data-request-roles)').

28. Once:

    1. A Data Request Approver or Administrator has approved your role as either an Analyst or Project Leader
    2. A Data Request Approver or Administrator has onboarded you

    An email will be sent to whatever email was set as this dataset's onboarding email containing further information and instruction for data onboarding.

<figure><img src="https://683603551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeaKzA2mZwMc13WvgBV9%2Fuploads%2Fy4zgHlijrnewDaCQl1oL%2Fimage.png?alt=media&#x26;token=9e4218d5-1581-4797-bd78-702145598d23" alt=""><figcaption></figcaption></figure>

**Note:** The possible data request statuses are defined below:

* **Draft:** This stage is only visible to the requesters themselves. It signifies that the request is still in the preliminary phase and is being worked on or reviewed
* **Closed:** Also visible only to the requesters, this state indicates that the data request has been finalised or concluded and is no longer active
* **Submitted:** This stage is visible to both the requesters and assigned approvers. It shows that the data request has been submitted for consideration and is awaiting a response or decision
* **Denied:** Visible to requesters and assigned approvers, this state signifies that the data request has been declined or rejected
* **Approved:** This stage is visible to both requesters and assigned approvers. It indicates that the data request has been approved and the necessary access permissions have been granted
* **Partially Onboarded:** This state represents partial onboarding of a request's team. It indicates that some but not all of a request's researchers have either been onboarded, or denied
  * This status will also be applied when data requests by a single researcher have not yet had that researcher onboarded or denied
* **Fully Onboarded:** This stage indicates that the data request has been fully processed and implemented, and all relevant researchers have been successfully onboarded.
