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.
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.
Voor archief : https://dams-a.antwerpen.be/oai/request?verb=ListRecords&metadataPrefix=oai_dc&set=BrocadeArchief
Voor bibliotheek : https://dams-a.antwerpen.be/oai/request?verb=ListRecords&metadataPrefix=oai_dc&set=BrocadeBibliotheek
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