# CrossRef Event Update

### 1. Overview and Context

This procedure updates the <span class="mw-headline">Crossref\_Event</span> table in the [SQL Database](https://docs.punctumbooks.com/books/service-component-library/page/sql-database).

### 2. Triggers

The execution of this procedure is usually triggered by

- [Metrics](https://docs.punctumbooks.com/books/service-portfolio-management-spm/page/metrics-process)

### 3. Steps to Be Performed

#### 3.1 Download

<span class="mw-headline">CrossRef event data are plucked directly from their [Query API](https://www.eventdata.crossref.org/guide/service/query-api/). There are two DOI prefixes punctum uses, so we need records for both. Just fill in the correct start and end dates:</span>

`https://api.eventdata.crossref.org/v1/events?mailto=vincent@punctumbooks.com&obj-id.prefix=10.53288&from-occurred-date=2023-07-01&until-occurred-date=2023-07-31`

`https://api.eventdata.crossref.org/v1/events?mailto=vincent@punctumbooks.com&obj-id.prefix=10.21983&from-occurred-date=2023-07-01&until-occurred-date=2023-07-31`

You can use [Postman](https://www.postman.com/web) as a useful API GUI.

#### 3.2 Clean

- You get a JSON file that needs to be [converted](https://www.convertcsv.com/json-to-csv.htm) to CSV.
- Clean up the occurred\_at column by replacing "T" and "Z" with a space, and set data format to timestamp.
- Make sure all columns line up, and all columns have at least one cell filled (even with a dummy)
- Delete header row

#### 3.3 Upload

- <span class="mw-headline">Navigate to phpMyAdmin table "Crossref\_Event"</span>
- select Import tab;
- select file
- click "Go."
- archive files under Punctum Admin &gt; Metrics &gt; Crossref Event Data


### 4. Additional Information

### 5. Document Control

<table border="1" id="bkmrk-document-id-srm-001-" style="border-collapse: collapse; width: 100%; height: 176.2px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.3667px;"><td style="height: 29.3667px;">**Document ID**</td><td style="height: 29.3667px;">PRO-045</td></tr><tr style="height: 29.3667px;"><td style="height: 29.3667px;">**Document Owner**</td><td style="height: 29.3667px;">Vincent</td></tr><tr style="height: 29.3667px;"><td style="height: 29.3667px;">**Version**</td><td style="height: 29.3667px;">1.0</td></tr><tr style="height: 29.3667px;"><td style="height: 29.3667px;">**Last Date of Change**</td><td style="height: 29.3667px;">March 26, 2026</td></tr><tr style="height: 29.3667px;"><td style="height: 29.3667px;">**Next Review Due Date**</td><td style="height: 29.3667px;">  
</td></tr><tr style="height: 29.3667px;"><td style="height: 29.3667px;">**Version &amp; Change Tracking**</td><td style="height: 29.3667px;">  
</td></tr></tbody></table>