6. Koppeling tusen Brocade en DAMS

6.1. Inleiding

DAMS is de databank van de stad Antwerpen die gebruikt wordt om de digitale collectie van de Antwerpse musea en erfgoedinstellingen te beheren. Ten behoeve van de Anet-partners van de stad Antwerpen werd een koppeling gelegd tussen Brocade en DAMS.

6.2. Werkproces

6.2.1. Ophalen metadata uit Brocade in DAMS

  • Voor achiefobjecten gebeurt dit via OAI Dublin Core xml : https://anet.be/oai/thing/server.phtml?verb=GetRecord&metadataPrefix=thingdc&;identifier=<value

  • Voor catalogus records gebeurt dit via OAI MARCxml : https://anet.be/oai/catgeneric/server.phtml?verb=GetRecord&;metadataPrefix=marc21&identifier=<value>

In de praktijk zal een medewerker van de stad Antwerpen inloggen op DAMS en de identifier van het Brocade record ingeven (een tg-loi of oloi). Onderhuids wordt een OAI request gestuurd naar Brocade en de terugkerende XML wordt door DAMS in de DAMS toepassing verwerkt. Vervolgens kan de medewerker van de stad Antwerpen de digitale data opladen in DAMS als ook de digitalisering verder beschrijven.

  1. Vanuit de metadata wordt vastgelegd welke data door Brocade in de OAI wordt aangeboden:

  • Voor achiefobjecten werd hiervoor per objetensysteem een Dublin Core export profiel aangemaakt via Archieven - Objectbeschrijvingen - Beheersfuncties - Externe relaties [link] en een OAI-PMH target thing.

  • Voor catalogus records wordt gebruik gemaakt van het bestaande OAI-PMH target catgeneric via Digitaal platform - Beheersfuncties - Upload omgevingen [link] (JAn)

6.2.2. Ophalen metadata uit DAMS in Brocade

Van zodra een object in DAMS als asset aanwezig is, moet Brocade gevoed kunnen worden met volgende gegevens:

  • Brocade ID

  • Asset ID (ter creatie van een link naar de digitalisering)

  • Publiek toegankelijk of niet

  • representatie image (display in OAPC full record en in resultatenlijst)

DAMS heeft hiervoor een OAI infrastructuur opgezet die toelaat om een request te plaatsen voor alle Brocade assets in DAMS.

Brocade zal dagelijks via OAI data kunnen overhalen van records die 2 dagen ervoor zijn aangepast in DAMS. Heel dit proces wordt gestuurd door metadata en zal uiteindelijk resulteren in de creatie of aanpassing van een dgloi (= beschrijving van een digitalisering).

6.3. Metadata

Om dit te verwezenlijken werd een nieuw type metadata gecrëerd (DAMS bronnen) alsook nieuwe metadata toegevoegd bij bestaande types. Ook werd een nieuw automatisch proces standard.dams gecreëerd.

Ter hoogte van het objectensysteem kan men via het veld Geassocieerde catalografische instelling aangeven tot welke catalgrafsiche intelling dat objectensysteem behoort. Brocade kan op deze manier vanuit de tgloi, de juiste catalografische instelling afleiden om vervolgens de digitalisering te linken met het juiste digitaal platform (via veld Digitaal systeem in de DAMS bron). Op deze manier kan elke instelling blijven gebruik maken van hetzelfde digitaal platform). Voor catalogus records kan deze informatie rechtstreeks vanuit de oloi afgeleid worden.

6.4. Configuratie van scanners

Een DAMS bron levert informatie aan over een alternatieve plaatsing van digitale bronnen.

Actief [active: boolese waarde]

Stip aan of deze bron moet worden doorzocht

OAI URL [oaiurl: tekst]

Geef de OAI URL die moet worden gehanteerd bij de bevraging van dit DAMS systeem

OAI URL met resumption token [oaiurlres: tekst]

Geef de OAI URL met resumptiontoken.

Dit is een Brocade template met resumptiontoken als sleutel.

Gebruiker [oaiuserid: tekst]

Specificeer de corresponderende gebruikersidentificatie

Wachtwoord [oaipw: tekst]

Specificeer het corresponderende wachtwoord

URL-type [urlty: tekst]

Het urltype laat toe om de URL samen te stellen van een DAMS target

DOCMAN databank [docmandb: tekst]

Dit is de naam van een DOCMAN databank.

Deze moet reeds bestaan.

URL-type voor lowres afbeelding [lowresurlty: tekst]

Dit is de toegangscode voor de lowres afbeeldingen.

Dit wordt enkel gebruikt bij bibliografische brschrijvingen en hoeft enkel te worden ingevuld indien deze 'lowres' afbeelding moet worden getoond in de publikesomgeving.

Toegangscode [caccess: tekst]

[N?say:N.metaDams.caccess]

Lowres type [lowrestype: tekst]

Geef het type van de lowres afbeelding.

Opgelet!

  • bij c-loi's en o-loi's is dit het URL-type

  • bij tg-loi's is dit het illustratie type

Thumbnail type [thumbtype: tekst]

Geef het type van de thumbnail afbeelding.

Opgelet!

  • bij c-loi's en o-loi's is dit het URL-type

  • bij tg-loi's is dit het illustratie type

Digitaal systeem [digsys: tekst]

Geef aan wat het correponderende digitaal systeem is. Dit is een template die het systeem genereert.

De sleutels voor de template:

  • loi: het recordnummer

  • type: tg of o

  • system: de tweede component van het recordnummer

  • lib: de catalografische instelling

Status [state: tekst]

Geef de passende status voor digitalisering aan.

Dit is een template die word omgezet de status. Dit is vooral van belang voor het geassocieerde identiteitsveld.

De sleutels voor de template:

  • loi: het recordnummer

  • type: tg of o

  • system: de tweede component van het recordnummer

  • lib: de catalografische instelling

Splitter [splitter: tekst]

Dit is een Brocade template die werkt met url (de aangeleverde URL) als sleutel. Het resultaat is de waarde die samen met het URL-type de gevraagde URL terug oplevert.

Scanner [scanner: tekst]

Dit is een template die word omgezet naar een geassocieerde scanner. Dit is vooral van belang voor het geassocieerde identiteitsveld.

De sleutels voor de template:

  • loi: het recordnummer

  • type: tg of o

  • system: de tweede component van het recordnummer

  • lib: de catalografische instelling

Mail bij fout [badmail: label]

Vul dit tekstfragment aan:

- de titel: wordt het onderwerp van de mail
- de scope: wordt de inhoud van de mail

Beiden worden als templates gezien. De sleutels zijn:

- *damssys*: de identifier van het DAMS systeem
- *docman*: de DOCMAN URL van de spreadsheet
- *begindate*: begindatum van de OAI-request
- *enddate*: einddatum van de OAI-request
Mailadressen bij fout [badmailaddress: herhaalbaar, tekst]

Geef de geadresseerden op van de e-mail. Dit kunnen zowel e-mailadressen als gebruikersidentificaties zijn.

De helpdesk wordt steeds verwittigd.

Mail bij succes [goodmail: label]

Vul dit tekstfragment aan:

- de titel: wordt het onderwerp van de mail
- de scope: wordt de inhoud van de mail

Beiden worden als templates gezien. De sleutels zijn:

- *damssys*: de identifier van het DAMS systeem
- *docman*: de DOCMAN URL van de spreadsheet
- *begindate*: begindatum van de OAI-request
- *enddate*: einddatum van de OAI-request
Mailadressen bij succes [goodmailaddress: herhaalbaar, tekst]

Geef de geadresseerden op van de mail. Dit kunnen zowel mailadressen als gebruikersidentificaties zijn.

Status van verwerking [runstatus: keuze]

Er zijn 3 status aanduidingen:.

  • busy: het DAMS proces loopt nog of werd onderbroken

  • success: het DAMS proces eindigde succesvol

  • fail: het DAMS proces eindigde met fouten: consulteer de spreadsheet.

Keuze uit:

  • Proces loopt/is onderbroken [busy]

  • Proces eindigde succesvol [success]

  • Proces eindigde foutief [fail]

Laatste verwerking [update: tekst]

Het tijdstip van laatste verwerking

CSV file [csvfile: tekst]

Spreadsheet met de verwerkingsgegevens