<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
</head>
<body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; color: rgb(0, 0, 0); font-size: 14px; font-family: Calibri, sans-serif;">
<div>Hi David,</div>
<div><br>
</div>
<div>I hope you are well.</div>
<div><br>
</div>
<div>This stems from the community developed <i>Darwin Core</i> (DwC) standard building on top of the
<i>Dublin Core</i> (DC) standard, rather than something GBIF have introduced.  I’m afraid it is a little messy, but I will try and explain.</div>
<div><br>
</div>
<div>The original thinking by the DwC authors was that <i>dwc:occurrenceID</i> would be used to identify an occurrence in nature, while
<i>dc:identifier</i> would be a digital record identifier.</div>
<div>In practice almost everyone mapped their database foreign key to occurrenceID and thus they became pretty synonymous.</div>
<div><br>
</div>
<div>GBIF recommend that publishers put unique identifiers on records using dwc:occurrenceID.  The IPT helps enforce this.  This way the publisher can very easily control how many records they wish to appear in GBIF.  We pass through
<i>dc:identifier</i> as you notice, but simply treat it like any other non-interpreted field – we have never interpreted this field, and it will not control how we identify records in the GBIF.org index.  However, it makes sense to provide it, as there could
 well be systems other than GBIF indexing data, and they may likely recognise Dublin Core terms.  </div>
<div><br>
</div>
<div>Historically, where users have not provided occurrenceID they must have given data mapped with
<i>dwc:insitutuionCode</i>, <i>dwc:collectionCode</i> and <i>dwc:catalogNumber</i> or the equivalent in the
<i>ABCD standard</i>.</div>
<div>If a provider adds occurrenceID and leaves those 3 fields the same, we will recognise this and update the records.  If they were to remove one of those triplets, we would insert new records and the old ones would be deleted at some point.  It is a manual
 process to allow us to engage with publishers before running deletions.</div>
<div><br>
</div>
<div>I notice that the dataset you linked to was published in 2007, before dwc:occurrenceID existed.  It is therefore using the <i>dwc:insitutuionCode</i>, <i>dwc:collectionCode</i> and <i>dwc:catalogNumber
</i>identifier strategy.</div>
<div><br>
</div>
<div>Please note, that Darwin Core recommends concatenating the 3 fields to create a <i>dwc:occurrenceID</i>.  Please be aware that this approach means that should someone chose to e.g. change the collection code, the occurrence record ID will also change thus
 removing all linkability.  If this is expected, then forging unique ids for records using e.g. UUIDs or similar would be a more robust longer term solution and in general we recommend targeting this.</div>
<div><br>
</div>
<div>We do recommend people strive to provide occurrenceID, even on older data.  This simplifies things going forward.</div>
<div><br>
</div>
<div>I hope this helps, but please feel free to ask me any questions around this.</div>
<div><br>
</div>
<div>This is off topic, but while you are reading please know that we expect stateOrProvince to be a filter on GBIF next week along with locality, protocol, license, organismID, publishingOrgKey (API only), crawlID (API only).  I know you have interest in this
 functionality.</div>
<div><br>
</div>
<div>Best wishes,</div>
<div>Tim</div>
<div><br>
</div>
<div><br>
</div>
<div><br>
</div>
<span id="OLK_SRC_BODY_SECTION">
<div style="font-family:Calibri; font-size:11pt; text-align:left; color:black; BORDER-BOTTOM: medium none; BORDER-LEFT: medium none; PADDING-BOTTOM: 0in; PADDING-LEFT: 0in; PADDING-RIGHT: 0in; BORDER-TOP: #b5c4df 1pt solid; BORDER-RIGHT: medium none; PADDING-TOP: 3pt">
<span style="font-weight:bold">From: </span>API-users <<a href="mailto:api-users-bounces@lists.gbif.org">api-users-bounces@lists.gbif.org</a>> on behalf of Herbario SANT <<a href="mailto:sant.herbarium@gmail.com">sant.herbarium@gmail.com</a>><br>
<span style="font-weight:bold">Date: </span>Sunday 28 August 2016 at 16:00<br>
<span style="font-weight:bold">To: </span>"<a href="mailto:api-users@lists.gbif.org">api-users@lists.gbif.org</a>" <<a href="mailto:api-users@lists.gbif.org">api-users@lists.gbif.org</a>><br>
<span style="font-weight:bold">Subject: </span>Re: [API-users] What happens to previous data after dataset/crawl?<br>
</div>
<div><br>
</div>
<div>
<div>
<div dir="ltr">
<div>
<div>Hi<br>
<br>
</div>
I take the opportunity to ask about the difference between two GBIF terms:<br>
<br>
</div>
What is the difference of "occurrenceID" compared to "identifier"?  Both have the same value in this dataset:<br>
<div><a href="http://www.gbif.org/occurrence/1291766512/verbatim">http://www.gbif.org/occurrence/1291766512/verbatim</a><br>
<a href="http://api.gbif.org/v1/occurrence/1291766512">http://api.gbif.org/v1/occurrence/1291766512</a><br>
<br>
</div>
<div>I see "occurrenceID" well explained here:<br>
<a href="http://gbif.blogspot.com.es/2014/04/ipt-v21.html">http://gbif.blogspot.com.es/2014/04/ipt-v21.html</a><br>
<a href="http://rs.tdwg.org/dwc/terms/#occurrenceID">http://rs.tdwg.org/dwc/terms/#occurrenceID</a><br>
<div><br>
But I can't find the explanation for "identifier", which I think some institutions have been incorrectly understanding as "occurrenceID".<br>
</div>
<div>For example:  <br>
<a href="http://www.gbif.org/occurrence/142907792/verbatim">http://www.gbif.org/occurrence/142907792/verbatim</a><br>
<a href="http://api.gbif.org/v1/occurrence/142907792">http://api.gbif.org/v1/occurrence/142907792</a><br>
</div>
<br>
There is an "identifier" in that occurrence, but no "occurrenceID".<br>
</div>
<div>1) What is exactly the meaning of that "identifier"?  Why is it not explained in dwc terms page?<br>
2) What happens if the data provider keeps all data UNCHANGED, but adds the "occurrenceID" which was missing?<br>
</div>
<div>    Would next GBIF reindex keep the same number of records and add their occurrenceIDs? (perhaps looking at the triplet in that "identifier"?)<br>
</div>
<div>    Would later on be safe to change any fields in the dataset (even "identifier", "catalognumber", ...) if that data provider keeps those occurrenceIDs stable?<br>
</div>
<div><br>
</div>
<div>Thanks<br>
</div>
<div><br>
</div>
<div class="gmail_extra"><br>
<div class="gmail_quote">On 27 August 2016 at 08:01, Roderic Page <span dir="ltr">
<<a href="mailto:Roderic.Page@glasgow.ac.uk" target="_blank">Roderic.Page@glasgow.ac.uk</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div>
<div>Just wanted to check the consequences of the following dataset operation.</div>
<div><br>
</div>
<div>Say I have a dataset with 10 occurrences with occurrence ids 1-10. In my local database I now assign those 10 occurrences new identifiers a-j. If I create a new DwCA file for my data and crawl the new archive, my expectation is:</div>
<div><br>
</div>
<div>1. Old data with ids 1-10 is deleted from GBIF index </div>
<div>2. New data with ids a-j is indexed</div>
<div><br>
</div>
<div>So, end result is dataset has 10 occurrences. I'm asking because I know in the past the some datasets have changed identifiers and this has resulted in records with old and new identifiers coexisting in GBIF index, resulting in duplicated data.</div>
<div><br>
</div>
<div>Obviously it would be nice to have stable, unchanging identifiers for occurrences, but the for data set I'm working with the creators have changed their minds between versions of the data :(</div>
<div><br>
</div>
<div>Regards,</div>
<div><br>
</div>
<div>Rod<br>
<br>
<div>Get <a href="https://aka.ms/o0ukef" target="_blank">Outlook for iOS</a></div>
<br>
</div>
</div>
<br>
______________________________<wbr>_________________<br>
API-users mailing list<br>
<a href="mailto:API-users@lists.gbif.org">API-users@lists.gbif.org</a><br>
<a href="http://lists.gbif.org/mailman/listinfo/api-users" rel="noreferrer" target="_blank">http://lists.gbif.org/mailman/<wbr>listinfo/api-users</a><br>
<br>
</blockquote>
</div>
<br>
<br clear="all">
<br>
-- <br>
<div class="gmail_signature" data-smartmail="gmail_signature">
<div>David García San León</div>
Herbario SANT
<div>Facultade de Farmacia - Laboratorio de Botánica</div>
<div>Universidade de Santiago de Compostela</div>
<div>15782 - Galicia (Spain)</div>
<div><a href="http://www.usc.es/herbario" target="_blank">http://www.usc.es/herbario</a></div>
<br>
</div>
</div>
</div>
</div>
</div>
</span>
</body>
</html>