Wiki source code of Melinda-integraation ohje

Last modified by Ville Huhtala on 2024/04/09 12:56
Show last authors
1 {{toc/}}
2
3 == Integraatioprofiilin luonti ja päivitys ==
4
5 Luo/päivitä integraatioprofiili MELINDA-ALEPH
6
7 (% style="color:#32322f" %)Alma adminina: Configuration → General → (External systems) → Integration Profiles
8
9 === General Information välilehti ===
10
11 (% style="color:#32322f" %)[[image:attach:image2020-2-4_10-44-11.png]]
12
13 === Actions välilehti - ASETUKSET ===
14
15 {{error}}
16 * Tuotanto-Alma: tuotanto-Melindan asetukset
17 * (Premium) sandbox: testi-Melindan asetukset
18
19 //Sääntöjen, normalisointiprosessien ja importtiprofiilin pitää olla valmiina ennen integraatiprofiilin muokkausta//
20 {{/error}}
21
22 * Section Central Catalog System
23 ** System: Aleph
24 * Section Contribution Configuration
25 ** Host: (% class="nolink" %)https:~/~/melinda.kansalliskirjasto.fi(%%)
26 ** Test: (% class="nolink" %)https:~/~/aleph-x-proxy.api.melinda-test.kansalliskirjasto.fi(%%)
27 ** Library: FIN01
28 ** System no prefix: (FI-MELINDA)
29 ** Fix routine in central catalog: --ALMA-- **uusi arvo: ALMA3**
30 ** Username and password (to Melinda)
31 ** Allow delete (ei vaikutusta, sillä Melinda ei salli tietueen poistamista)
32 ** Correct the data using normalization rules: 368LUMIKKO Contribute an ALMA record to Melinda
33 * Section Central Catalog Record Changes Configuration
34 ** Host: melinda.kansalliskirjasto.fi
35 ** Test: melinda-test.kansalliskirjasto.fi
36 ** Port: 5221
37 ** Local Catalog ID, Username and password
38 ** BIB library: FIN01
39 ** Choose merge routine: – ℹ huomiot VST prosessista, ks alasivu
40 ** Non preferred record action during merge
41 * Section Data Retrieval Configuration (Z39.50)
42 ** Host: z3950.api.melinda.kansalliskirjasto.fi 
43 *** Port: 10211
44 ** Test: z3950.api.melinda-test.kansalliskirjasto.fi 
45 *** Port: 10212
46 ** Base: fin01alma
47 ** Search attribute: 1=12
48 ** Repository Import Profile: 358LUMIKKO Import MELINDA record to ALMA
49 ** Merge Routine for Copy Cataloging: 358LUMIKKO Melinda to ALMA CopyCat merge
50
51 === Sääntöpäivitykset: kuva hierarkiasta ===
52
53 Kuvassa merkitty **paksulla viivalla** minne päivitetty sääntö on asetettava. Integraatioprofiilin muokkaus vaatii täydet administrator oikeudet.
54
55 {{gliffy border="true" chrome="min" size="1200" displayName="Sääntöhierarkia" name="Sääntöhierarkia" pagePin="7"/}}
56
57 == Merge- ja normalisoinsisäännöt ==
58
59 === Ohjeet Community alueella olevan säännön kopioimiseen ===
60
61 Säännön kopiointi:
62
63 * Normalisointisäännöt: Metadata Editor → Rules → Normalization → Community
64 * Mergesäännöt: Metadata Editor → Rules → Merge → Community
65
66 Klikkaa hiiren oikalla näppäimellä sääntöä. Avautuneessa valikossa vaihtoehdot:
67
68 (% class="wrapped" %)
69 |=(((
70 Toiminto
71 )))|=(((
72 Selitys
73 )))
74 |(((
75 View
76 )))|(((
77 Sääntö avautuu esikatselumuodossa. Tarkista esimerkiksi versio
78 )))
79 |(((
80 Duplicate
81 )))|(((
82 Säännön kopioiminen omaan kantaan.
83
84 * Oletusmuodossa Name ja Description muodossa "Copy Of <säännön nimi>". Voit uudelleen nimetä molemmat
85 * Voit valita radionapista, kopioidaanko sääntö private vai shared kansioon. Oletuksena shared.
86 * **Huom. Jos shared tai private kansioissa on jo saman niminen sääntö, niin kopioitavan säännön nimeä täytyy muuttaa**
87 )))
88 |(((
89 Properties
90 )))|(((
91 Lisätietoa säännöstä: milloin sääntö on luotu, missä organisaatiossa, kuka säännön on luonut yhteystietoineen
92 )))
93
94 Huomaa, että normalisointi- ja mergesääntöjen nimet voivat olla Almassasi erilaiset kuin tässä ohjeessa. Almassa täytyy nimetä:
95
96 * normalisointiprosessi (ja siten viittaukset: importtiprofiili & integraatioprofiili)
97 * importtiprofiili
98 * integraatioprofiili
99
100 Tarkista versiotiedot!
101
102 === Mergesäännöt ===
103
104 ==== 358LUMIKKO (% style="color:#32322f" %)Melinda to ALMA CopyCat merge(%%) ====
105
106 * Jos haluat säilyttää Voyagerin BIB-ID:n, poista kommenttimerkki kentästä 035 ja anna migraation luoma koodi
107 * Useammassa sääntökohdassa on käytetty 'FI-Alma' tunnusta
108 ** korvaa se oman organisaatiosi ISIL-tunnuksella
109 ** jos käytät useampaa ISIL-tunnusta, niin JOKAINEN ISIL TARVITSEE OMAN RIVINSÄ
110
111 ==== 358LUMIKKO post Melinda contribution merge ====
112
113 * (% style="color:#32322f" %)Ei muokattavaa
114
115 === Normalisointisäännöt ===
116
117 ==== (% style="color:#32322f" %)358LUMIKKO Fix a Melinda record before saving in ALMA(%%) ====
118
119 * Vapaakappalekirjastot: Lisää kommentoinmerkki # kenttiin 506, 540 ja 856 jos haluat vapaakappalemerkinnät
120 * Jos Melindasta haluaa enemmän luokituksia ja sanastoja kuin pakolliset, niin ne voidaan lisätä kenttiin 084, 600, 610, 611, 630, 648, 650, 651, 655 (mutta lisättyjä kenttiä ei voi kontribuoida takaisin Melindaan)
121
122 ==== (% class="auto-cursor-target" style="color:#32322f" %)358LUMIKKO Contribute an ALMA record to Melinda(%%) ====
123
124 * (% class="auto-cursor-target auto-cursor-target" style="color:#32322f" %)Ei muokattavaa
125
126 ==== (% style="color:#32322f" %)358LUMIKKO Publish LOW fields to Melinda  –  ExL TEKEMÄ(%%) ====
127
128 * (% style="color:#32322f" %)Tämä on automaattinen prosessi
129
130 * (% style="color:#32322f" %)Exl luonut
131
132 == (% style="color:#32322f" %)Alman asetukset - säännöt, normalisointiprosessit ja importtiprofiili(%%) ==
133
134 Näiden täytyy olla valmiita ennen integraatioprofiilin muokkasta
135
136 (% style="color:#32322f" %)Tee asetukset alla olevassa järjestyksessä!
137
138 === (% style="color:#32322f" %)Merge-säännöt(%%) ===
139
140 Resources -> Open Metadata Editor -> Rules -> Merge -> Shared
141
142 Sääntö
143
144 * 358LUMIKKO Melinda to ALMA CopyCat merge
145 ** (% style="color:#32322f" %)anna sama nimi ja 'Description'
146 * 358LUMIKKO post Melinda contribution merge
147 ** (% style="color:#32322f" %)anna sama nimi ja 'Description'
148
149 === (% style="color:#32322f" %)Normalisointisäännöt(%%) ===
150
151 Resources → Open Metadata Editor → Rules → Normalization → Shared
152
153 Sääntö
154
155 * 358LUMIKKO Contribute an ALMA record to Melinda
156 ** (% style="color:#32322f" %)anna sama nimi ja 'Description'
157 * 358LUMIKKO Fix a Melinda record before saving in ALMA
158 ** (% style="color:#32322f" %)anna sama nimi ja 'Description'
159 * 358LUMIKKO Publish LOW fields to Melinda   **(ExL hoitaa)**
160
161
162 === {{id name="NRasNRP"/}}Normalisointisääntö osana normalisointiprosessia ===
163
164 Näiden täytyy olla osa normalisointiprosessia:
165
166 * 358LUMIKKO Contribute an ALMA record to Melinda
167 * 358LUMIKKO Fix a Melinda record before saving in ALMA
168 * 358LUMIKKO Publish LOW fields to Melinda   **(ExL hoitaa)**
169
170 Configuration → Resources → [Cataloging] → Metadata Configuration
171 Valitse 'MARC21 Bibliographic'
172 Välilehti 'Normazation Processes'
173
174 Jos normalisointiprosesi puuttuu, lisää se 'Add Process' nappulasta
175
176 Esimerkki. 358LUMIKKO Contribute an ALMA record to Melinda
177
178 [[image:attach:image2020-2-4_10-4-50.png]]
179
180 Nimen ja kuvauksen voi antaa kuten haluaa. Selkeyden vuoksi käytetty normalisointisäännön nimeä
181
182
183 [[image:attach:image2020-2-4_10-6-27.png]]
184
185 Jos 'MarcDroolNormalization' ei ole valmiina, lisää se 'Add Tasks' nappulan kautta
186
187
188 [[image:attach:image2020-2-4_10-8-43.png]]
189
190 Valitse käytettävä normalisointisääntö
191
192 === (% style="color:#32322f" %)Importtiprofiili(%%) ===
193
194 Resources → Manage Import Profiles
195
196 profiili: '358LUMIKKO Import MELINDA record to ALMA'
197
198 [[image:attach:image2020-2-4_10-14-16.png]]
199
200 [[image:attach:image2020-2-4_10-14-53.png]]
201
202 * (% class="displayTableCell lineHeight16 verticalMiddle" style="color:#555555" %)"Correct the data using(%%)' → valitaan tähän normalisointiprosessi '358LUMIKKO Fix a Melinda record before saving in ALMA'
203 * 'Filter out the data using' → jos tietueita halutaan päivittää automaattisesti Melidasta, niin tähän voi laittaa rajoittavan filtterin – TAI luo uusi profiili tätä varten! Indikointisääntö luodaan metadataeditorissa, Resources -> Open Metadata Editor -> Rules -> Indication rules
204
205 [[image:attach:image2020-5-6_16-21-9.png]]
206
207 [[image:attach:image2020-2-14_18-45-45.png]]
208
209
210 * Serial/Non Serial match method: 035 (Other System Identifier) Match Method
211 * System Identifier Prefix: (FI-MELINDA)
212 * 358LUMIKKO post Melinda contribution merge
213 ** nimi tulee merge-säännön 'Description' osiosta
214 * Sivun lopussa 'No Match' osio: valitse Upon no match → Import
215
216 **Loput välilehdet**
217
218 * Set Management Tags: No / Don't publish
219 * Inventory Information: none
220
221