# Track a version

The Errata Service is integrated with the [Persistent IDentifier (PID)](https://esgf-data.dkrz.de/projects/esgf-dkrz/pid) attached to each dataset during the ESGF publication process. The PIDs enable to request the [Handle Service](https://www.dkrz.de/mms/pdf/klimadaten/poster/EGU2012-web-services-and-handle.pdf) from DKRZ to get the version history of a (set of) file/dataset(s). Such a version tracker enables the end users to submit one or several files or datasets identifiers to get back all annotations related to each corresponding issue.

* [x] From the [Errata Service home page](https://errata.es-doc.org/), click on “**Search**”\


<figure><img src="https://2537050793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEvI8ffNvrSdp2bDII70v%2Fuploads%2FFBTvRuixVhZ1jg5bWSwQ%2Fpid_search.PNG?alt=media&#x26;token=ff74c184-6ec3-41b6-8e9d-9bedd71c1bda" alt=""><figcaption><p>PID search button</p></figcaption></figure>

* [x] Send your request with either:

-   A PID following the syntax :. PIDs can be found in the metadata of ESGF front-end or directly into the netCDF files as the tracking\_id global attribute.

    _Example_: `21.14100/81b0709b-1546-3cb7-b0d8-e6ad9d1cc727`
- A dataset identifier as a sequence of dot-separated facets that follows the _Data Reference Syntax_ of the corresponding project. The dataset identifiers has to append the dataset version number.\
  &#xNAN;_&#x45;xample_: `CMIP6.CMIP.IPSL.IPSL-CM6A-LR.1pctCO2.r1i1p1f1.Omon.si.gn#20180727`

<mark style="color:red;">**Note:**</mark> Several requests can be sent at once by uploading a local text file with one PID or dataset ID per line

* [x] Click on “**Search**”.

<figure><img src="https://2537050793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEvI8ffNvrSdp2bDII70v%2Fuploads%2FLmL17cHr58WKEZ256toV%2Fpid_search_field.png?alt=media&#x26;token=a28e8276-f5fa-4cfd-850a-e7320e963373" alt=""><figcaption><p>PID search field</p></figcaption></figure>

* [x] The Errata Service returns the result within a table per dataset. Each line corresponds to one version of the considered dataset in the chronological order. Useful labels are added to flag the first, last and queried dataset versions. On the right, the annotation picture links to the corresponding issue. The check mark means no known issues for the corresponding version, it is often associated to the corrected version, the latest published version.

<figure><img src="https://2537050793-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEvI8ffNvrSdp2bDII70v%2Fuploads%2FfRWrtvlW393YUAvv7AZx%2Fpid_result.png?alt=media&#x26;token=f0ee5db1-b09b-4bc2-a443-059c492c1a3a" alt=""><figcaption><p>Example of a PID search result</p></figcaption></figure>

\
