<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
<style type="text/css" style="display:none;"> P {margin-top:0;margin-bottom:0;} </style>
</head>
<body dir="ltr">
<div style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<b style="font-weight:normal">
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:Arial;color:#000000;font-weight:400">Dear IMs,</span></p>
<br>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:Arial;color:#000000;font-weight:400">We, EDI, have been discussing how best to populate the entity@id attribute field in EML and I would like to open
this discussion up and get your input. Analyzing the existing EML files I see that two sites (HFR, KBS) are consistently using this attribute, while all other sites use it only occasionally or not at all.</span></p>
<br>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1d1c1d;font-weight:400"><dataTable id="12345"></span></p>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1d1c1d;font-weight:400"> <entityName>...</entityName></span></p>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1d1c1d;font-weight:400"> <...></span></p>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1d1c1d;font-weight:400"></dataTable></span></p>
<br>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:Arial;color:#000000;font-weight:400">So far, we have come up with three use cases where this id attribute would be important:</span></p>
<br>
<ol style="margin-top:0;margin-bottom:0;padding-inline-start:48px">
<li dir="ltr" style="list-style-type:decimal;font-size:11pt;font-family:Arial;color:#000000;font-weight:400">
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span>Reference an entity in a different data package. This may be used to document provenance in a derived dataset.</span></p>
</li><li dir="ltr" style="list-style-type:decimal;font-size:11pt;font-family:Arial;color:#000000;font-weight:400">
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span>Documenting which entity has been accessed in a scripted workflow. The distribution/download URL would also be unique, of course, but doesn’t specify that it is an entity ID in EML.
Hence, it would be cleaner documentation in EML if we populate the entity@id.</span></p>
</li><li dir="ltr" style="list-style-type:decimal;font-size:11pt;font-family:Arial;color:#000000;font-weight:400">
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span>Reference an entity from within the EML document when the goal is to keep all annotations together within the <annotations> element. (Annotations may also be added directly at the
entity level and no reference is needed.) </span></p>
</li></ol>
<blockquote style="margin-top:0;margin-bottom:0">e.g.:<br>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#000000;font-weight:400"><annotations></span></p>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#000000;font-weight:400"> <annotation references=</span><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1d1c1d;font-weight:400">"12345"</span><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#000000;font-weight:400">></span></p>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1d1c1d;font-weight:400"> <propertyURI label="is about"></span><a href="http://purl.obolibrary.org/obo/IAO_0000136"><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1155cc;font-weight:400">http://purl.obolibrary.org/obo/IAO_0000136</span></a><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1d1c1d;font-weight:400"></propertyURI></span></p>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1d1c1d;font-weight:400"> <valueURI label="grassland biome"></span><a href="http://purl.obolibrary.org/obo/ENVO_01000177"><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1155cc;font-weight:400">http://purl.obolibrary.org/obo/ENVO_01000177</span></a><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1d1c1d;font-weight:400"></valueURI></span></p>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1d1c1d;font-weight:400"> </annotation></span></p>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:9pt;font-family:Consolas,sans-serif;color:#1d1c1d;font-weight:400"><annotations></span></p>
</blockquote>
<br>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:Arial;color:#000000;font-weight:400">The issues we would like to discuss are:</span></p>
<br>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:Arial;color:#000000;font-weight:400">How are you using the entity@id? Is it important in your local management system?</span></p>
<br>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:Arial;color:#000000;font-weight:400">We think that by the time the data package is in the EDI system the entity should have an EDI identifier fully
qualified for the EDI system. However, that may either enable the three use cases or cause problems with all three of them depending on how the attribute is used locally at the site.</span></p>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:Arial;color:#000000;font-weight:400"><br>
</span></p>
<p dir="ltr" style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span style="font-size:11pt;font-family:Arial;color:#000000;font-weight:400">thanks,</p>
<div>Corinna</div>
</span>
<p></p>
</b><br>
</div>
</body>
</html>