allegro
OAI-Browser
%=x #unX`#utX`if not $ResT end`#unX Nächster Abschnitt`var " (R.Token=" $ResT ")"`ins #utX% 
`Kurzfassung` 
`Hintergrund` 

Dieses Funktionspaket dient dazu, fremde OAI-Server ("data providers") über das Internet mit dem dafür zuständigen Protokoll abzufragen. Wenn man seine eigenen Daten mittels OAI im Netz anbieten, also selber als data provider agieren will, muß man die PHP-Skripte installieren und einige Inhalte dieser Skripte anpassen. 
Die Arbeit führt jeweils der FLEX  oai.flx  aus, falls nichts anderes angegeben ist.

`OAI-Server auswählen`  	%$Serv          
aus einer Liste von ca. 490 Servern weltweit. Die Liste steckt in der Datei  oai-serv.txt  auf HELP, und man kann sie sich beliebig ergänzen oder ändern. Dazu dient ganz unten die Funktion "Serverliste bearbeiten" 
 
`Daten des Servers anzeigen`  
Vom ausgewählten Server wird die standardisierte Auskunft angefordert, die man mit der OAI-Funktion "Identify" erhält. 

`Metadaten-Formate`  	%$Meta 
Welche Formate bietet der Server an? Eines davon auswählen. Oft ist nur der Standard oai_dc verfügbar ("Dublin Core"), diesen muß es immer geben. Wenn Sie die Daten dann auch umwandeln wollen, unbedingt dieses Format wählen oder an dieser Stelle nichts machen. 

`Sets`  	%$Set 
Auswahl eines der vorhandenen Sets und Abruf von Daten. Sets sind vom Datenbankbetreiber definierte Teilmengen der Sammlung, z.B. "books" oder "Dissertationen". Bei jedem Betreiber findet man eine andere Aufteilung - oder auch gar keine. 

`Datensatznummern` (ab bestimmtem Datum) 
IdNummern der seit dem Datum angefallenen Daten in dem gewählten Set. Es wird zuerst nach einem Datum gefragt. Diese Funktion nützt nicht viel, man erhält nur eine XML-Datei mit den Identnummern, die für sich genommen nichts aussagen. 
 
`Datensatz` 	%$Recn    
Einen bestimmten Datensatz abrufen, und zwar den, der in der Funktion "Datensatznummern" gewählt wurde. 

`Diesen Satz umwandeln` 

`Letzte Liste anzeigen (XML)`     [ xml-rtf.flx ]
Wenn vorher schon einmal die Funktion "Datensatznummern" ausgeführt wurde, wird die Ergebnisliste nochmals gezeigt. 

`Datensätze` (ab bestimmtem Datum) 
Die entspr. Datensätze im gewählten Format abrufen, in einer Datei oai-lr.xml speichern und auf Wunsch umwandeln. Hier bekommt man die echten Metadaten, verpackt in XML und mit den Feldern des gewählten Formats. Auf Wunsch kann man die Daten sofort umwandeln lassen, aber nur, wenn man das Format oai_dc gewählt hatte. Die umgewandelten Datensätze kommen in den Offline-Speicher, so als wären es manuell eingegebene Neuaufnahmen. Bei diesem Umwandeln (mit dem FLEX oai-dc.flx, also nicht mit Importparametern) wird auch festgestellt, ob die Lieferung vollständig war. Sonst: 
Achtung: Wenn der Server nicht in einem Rutsch alle Daten liefern kann, dann sendet er eine Anzahl Sätze - vielleicht 20, vielleicht 100, das ist nicht festgelegt - und am Ende ein besonderes Kennwort, den sog. "Resumption token". Mit diesem Kennwort kann man den Server danach veranlassen - das muß nicht sofort geschehen - die nächste Portion zu senden. Dies kann man fortsetzen, bis alle zugehörigen Sätze geliefert sind. Mit der letzten Portion wird ein leerer Resumption token gesendet. 

`Letzte Liste nachträglich umwandeln`    [ oai-dc.flx ]
Das Umwandeln der Datei oai-lr.xml wird wiederholt und auch erneut der "Resumption token" festgestellt. 

`Zuletzt abgerufene Liste anzeigen`    [ xml-rtf.flx ]
Wenn vorher schon einmal die Funktion "Datensätze" ausgeführt wurde, wird die Ergebnisdatei nochmals als XML-Datei gezeigt. 

Nächster Abschnitt
Diese Funktion gibt es nur, wenn gerade vorher ein "Resumption token" empfangen wurde. Mit Klick auf diesen Flip kann die nächste Portion angefordert werden. Das kann sich mehrfach wiederholen. 
                                                                 `%#unX`  %#utX 

`Offlinespeicher leeren`  
Wenn man die umgewandelten Datensätze nicht speichern oder exportieren will. Evtl. vorher mit Alt+q prüfen. 

`Serverliste bearbeiten` 
Die Datei  oai-serv.txt  wird in einem aresqa-Fenster gezeigt und kann darin bearbeitet werden. F1 informiert über die möglichen Funktionen, z.B. mit Entf-Taste Zeilen löschen oder mit Einfg-Taste neue einfügen, mit Maus kann man auch Zeilen verschieben. 

?OAI-Server auswählen=X oai Server 
?Metadaten-Formate=X oai ListMetadataFormats 
?Sets=X oai ListSets 
?Datensatznummern=X oai ListIdentifiers 
?Datensätze=X oai ListRecords 
?Datensatz=X oai GetRecord 
?Zuletzt abgerufene Liste anzeigen=X xml-rtf oai-lr.xml 
?Daten des Servers anzeigen=X oai Ident 
?Nächster Abschnitt=X oai resump 
?Letzte Liste anzeigen (XML)=X xml-rtf oai-li.xml 
?Letzte Liste nachträglich umwandeln=X oai-dc 
?Kurzfassung=h oai 
?Diesen Satz umwandeln=X oai-dc oai-gr.xml 
?Offlinespeicher leeren=x erase off`mes done 
?Serverliste bearbeiten=x var "*" P "help\\oai-serv.txt`aresqa 
?Hintergrund=h oaihint