Entities

Entities are primarily assemblages of catalog records intended to represent DWC:Organisms, but could easily be extended to other types of records and other types of assemblies.

Usage

Entities serve initially and primarily to provide a resolvable identifier for use as Organism ID.

Model

Entity

Entity is the “core” table. Entities consist of a unique identifier (in the form of a URL) and a type. Entity type is controlled by ctentity_type

Entity Assertion

Entity assertions are metadata which clarify the Entity. An Entity can have any number of Assertions. Datatype is loosely enforced; Assertions are primarily intended as a discovery mechanism.

Fields include:

Examples

The simplest use case involves simply creating an Entity. Creation is available to authorized users after search results; users are expected to ensure that they are not creating functional duplicates. (True duplicates are prevented.)

Screen Shot 2021-05-12 at 8 46 58 AM

This results in an Entity ID suitable for use as an Organism ID.

Screen Shot 2021-05-12 at 8 48 18 AM

It is not possible to modify an Entity after creation, but a preferred alternative can be asserted.

Screen Shot 2021-05-12 at 8 49 52 AM

Any number of assertions may be added. The edit form contains a method of pulling metadata for component assertions.

Screen Shot 2021-05-12 at 8 52 03 AM

Screen Shot 2021-05-12 at 8 52 16 AM

Checks against “local” data are provided, including records wearing the Entity ID as Organism ID but not listed in the Organism:

Screen Shot 2021-05-12 at 8 53 12 AM

And records listed which do not wear the identifier:

Screen Shot 2021-05-12 at 8 54 29 AM

Catalog records bearing an Entity ID as Organism ID will link to the Entity, and provide a link to locate all other records which share the ID.

Screen Shot 2021-05-12 at 8 56 11 AM

The Process

Find some “components.” We’ll use http://test.arctos.database.museum/guid/MSB:Mamm:269648 and http://test.arctos.database.museum/guid/DMNS:Mamm:13708.

Search for an Entity; make sure this doesn’t exist. Click Create.

Screen Shot 2021-05-19 at 4 34 17 PM

Provide a name, pick a type, click.

Screen Shot 2021-05-19 at 4 35 03 PM

You’ll get dumped on the edit screen. Enter the “components” as components, save. Value needs sorted out and documented; URL is the critical part of this.

Screen Shot 2021-05-19 at 4 36 05 PM

Save

Screen Shot 2021-05-19 at 4 37 35 PM

Scroll down, click pull

Screen Shot 2021-05-19 at 4 38 09 PM

accept

Screen Shot 2021-05-19 at 4 38 32 PM

You now have a workable “entity” and can be done. Optionally, provide more data.

Screen Shot 2021-05-19 at 4 40 30 PM

Don’t forget to save, then return to the “detail page”

Screen Shot 2021-05-19 at 4 41 17 PM

Click “copy” to get the ID into your clipboard.

Screen Shot 2021-05-19 at 4 41 57 PM

Click the two “component” links to open the catalog records, add Organism ID

Screen Shot 2021-05-19 at 4 42 56 PM

Screen Shot 2021-05-19 at 4 43 14 PM

The process is now complete, and the edit entity form will provide comforting messages.

Screen Shot 2021-05-19 at 4 44 11 PM

The Process: V2

Open Entities Screen Shot 2021-05-25 at 7 26 47 AM

Follow the directions Screen Shot 2021-05-25 at 7 26 59 AM

click Screen Shot 2021-05-25 at 7 27 08 AM

pick, type, click Screen Shot 2021-05-25 at 7 28 57 AM

paste in components Screen Shot 2021-05-25 at 7 30 12 AM

save

Screen Shot 2021-05-25 at 7 30 29 AM

export Screen Shot 2021-05-25 at 7 31 48 AM

import Screen Shot 2021-05-25 at 7 32 24 AM Screen Shot 2021-05-25 at 7 32 34 AM Screen Shot 2021-05-25 at 7 32 47 AM Screen Shot 2021-05-25 at 7 32 59 AM Screen Shot 2021-05-25 at 7 33 07 AM

let it run, confirm Screen Shot 2021-05-25 at 7 34 08 AM Screen Shot 2021-05-25 at 7 34 35 AM Screen Shot 2021-05-25 at 7 36 06 AM Screen Shot 2021-05-25 at 7 36 29 AM Screen Shot 2021-05-25 at 7 36 52 AM

Choosing Organism ID

[ Consider moving this to Other ID documentation ]

Any string may be used as Organism ID. Some possibilities and their implications include:

Arctos Entity ID

Arctos Entities are currently our recommended Organism ID.

Other Resolvable Identifiers

Other Resolvable Identifiers are more or less “anything with a URL.” These include WikiData, and potentially things like zoo records (should such come online). These are “good” identifiers by virtue of being globally unique and resolvable, but may vary wildly on attributes such as:

Non-resolvable Identifiers

Non-resolvable Identifiers are strings, generally issued by some (perhaps unknown) Agent. These are generally “less good” identifiers in that they:

Examples include: