h1. ARCHE import

h2. Usage of ARCHE import

h3. Enable ARCHE import

The ARCHE import is deactivated by default. To enable it, add the following dictionary to instance/production.py:
<pre>
ARCHE = {
    'id': 1390136,  # ID of the Top Collection (acdh:TopCollection)
    'collection_ids': [1390141],  # ID of different collections containing metadata.json files (acdh:Collection)
    'base_url': 'https://arche-curation.acdh-dev.oeaw.ac.at/',  # Base URL to get data from
    'thumbnail_url': 'https://arche-thumbnails.acdh.oeaw.ac.at/'  # URL of ARCHE thumbnail service, no changes needed}
</pre>

h3. Import ARCHE data

If the feature is enabled, every user can see an additional button in _Admin_  -> _Data_, called _ARCHE_, which lead to an information page of data provided at instance/production.py. 
!{width:600px}arche_import_1.jpg! !{width:600px}arche_import_2.jpg!

If the user belongs to the *manager* user group, a button called _Fetch_ is displayed. Pressing _Fetch_ will fetch data from ARCHE. This will check if the data has already been imported into OpenAtlas (based on the artifact). If an entry is not present, a summary table is displayed with the graffiti that will be imported. 
!{width:600px}arche_import_3.jpg!

By pressing the button _Import ARCHE data_ the data will be imported and if necessary new types, persons, etc. will be created. 
!{width:600px}arche_import_4.jpg!

h2. Data used from ARCHE

All data is gathered from [IMAGE_NAME]_metadata.json:
<pre>
'image_id': image_id (ARCHE)
'image_link': image_url (ARCHE)
'image_link_thumbnail': thumbnail_url (ARCHE)
'creator': EXIF:Artist
'latitude': EXIF:GPSLatitude
'longitude': EXIF:GPSLongitude
'description': XMP:Description
'name': IPTC:ObjectName
'license': EXIF:Copyright
'date': EXIF:CreateDate
</pre>

h2. Entities created by OpenAtlas (if not existing)

h3. Types

* Custom Hierarchy *Relevance* for Persons (E21) with items: Photographer and Graffito artist
* Involvement for production event with items:  Photographer 
* Additional license types when needed -> EXIF:Copyright

h3. External Reference System ARCHE (E32)

Data provided from production.py:

<pre>
ARCHE = {
    'id': 1390136,
    'collection_ids': [1390141],
    'base_url': 'https://arche-curation.acdh-dev.oeaw.ac.at/',
    'thumbnail_url': 'https://arche-thumbnails.acdh.oeaw.ac.at/'}
</pre>


h3. Entities

* Artifact (E22): Graffito, name (IPTC:ObjectName), description (XMP:Description), linked (P67) to ARCHE reference system (E32) 
* Location (E53): Location of Graffito, linked (P53) to Artifact (EXIF:GPSLatitude, EXIF:GPSLongitude)
* Production event (E12): Date (EXIF:CreateDate) linked (P11) to person (EXIF:Artist) and linked (P108) to artifact
* File (E31): linked (P2) to license type (EXIF:Copyright), linked (P67) to artifact
* Person (E21): name (EXIF:Artist), linked (P2) to type Relevance -> Photographer

h2. Flowchart
!ARCHE_import_OpenAtlas.jpg!