Statistikskripte

Zusammenfassung

Seit 2018 werden keine Handstatistiken mehr in der Erwerbung und der Erschließung geführt, sondern die relevanten Kennzahlen werden durch die Belegung des Feldes 4821 auswertbar gemacht.

Von Anfang an war klar, dass die Belegung des Feldes 4821 nicht händisch, sondern skriptunterstützt erfolgen soll, um Arbeit zu sparen und Fehler zu vermeiden. Defaultinhalte werden daher aus Elementen des vorliegenden Datensatzes ermittelt und dann in einer Eingabemaske präsentiert, in der sie noch verändert werden können, einige allerdings nur aus vorbelegten Popdown-Menü. Diese Abläufe sollten in die üblichen bisher genutzten Skripte der Zugangsbearbeitung und Formalerschließung integriert werden, also kein Extraschritt werden.

Ursprüngliche Anforderungsseite Erwerbung/Zugang: Maschinelle Statistik - Katalogisierungsumgebung - Erwerbungsstatistik - IT

Ursprüngliche Anforderungsseite Erschließung: Maschinelle Statistik - Katalogisierungsumgebung - Erschließungsstatistik - IT

Statistikfeld 4821

Relevante Unterfelder

• $a: Anzahl
• $c: Aktionscode
• $m: Materialart
• $z: Zweck
• $D: aktuelles Tagesdatum
• $N: Nutzerkennung/Sourcecode

Eingabemaske dnb_statistik.xul/dnb_statistik.js

Eingabemaske für die Inhalte von 4821 und weiteren Angaben bei der Medienbearbeitung. Die Maske wird immer dann aufgerufen, wenn Inhalte für ein neues Feld 4821 nicht aus einem vorhandene Feld 4821 übernommen werden können oder wenn dessen Inhalte händisch angepasst werden sollen

Hier werden alle erlaubten Inhalte für $c, $m und $z definiert. D.h. wenn hier neue Inhalte dazukommen, muss dnb_statistik.js angepasst werden

Variablen:

• mat_hash: umfasst alle möglichen Inhalte für $m
• akt_hash: umfasst alle möglichen Inhalte für $c
• zweck_hash: umfasst alle möglichen Inhalte für $z
• Variablen für die AKZ, Reihenangaben, etc.

So weit wie möglich wird versucht, für die Anzeige in der Eingabemaske die Inhalte der Felder bereits vorher zu belegen, d. h. in den aufrufenden Skripten werden Inhalte vorher anhand des vorliegenden Datensatzes ermittelt, ins Profil in den Bereich dnbStatistik geschrieben und beim Aufruf der Eingabemaske von dort wieder ausgelesen und entsprechend angezeigt.

Eingabemaske:

Skripte

__statAngaben(einzel, akt, mat, zweck)

Skript wird im Prinzip immer dann verwendet, wenn es noch gar kein Statistikfeld vorhanden ist, also beim Eingang von Medien, für die es bereits Bestellsätze gibt oder für die noch neue angelegt werden müssen. Zusätzlich zu 4821 werden auch die Felder 0600 und 0701/8100 gefüllt.

Parameter:

• einzel: Soll nur der eigene Standort oder auch der jeweils andere um ein Feld 4821 erweitert werden?
• akt: übergebener Aktionscode
• mat: übergebene Materialart
• zweck: Um welchen Statistikvorgang handelt es sich? Zugang (StatZUG?) Formalerschließung (StatFOE?) etc.

Ablauf:

• Zum Ermitteln der einzufügenden Inhalte Aufruf der XUL-Datenmaske dnb_statistik.xul/dnb_statistik.js . Auch die übergebenen Parameter können hier noch geändert werden. Ziel ist aber, so wenig wie möglich händisch eintragen zu müssen
  
• 0600 wird hinzugefügt
• 4821 wird am eigenen Standort hinzugefügt
• 4821 wird am anderen  Standort hinzugefügt (wenn einzel nicht "true" enthält)
• wenn nur eigener Standort belegt werden soll, wird die AKZ direkt in die 8100 geschrieben, bei beiden Standorten stattdessen in die 0701

Aufruf:

• bei der Anlage von neuen Datensätzen per Datenmaske, für die es nur einen Exemplarsatz an eigenem Standort geben soll, wird das Skript direkt aufgerufen: z.B. AaaAusl, Aaa_BAusl, AaaPflEinzel, Leihmaterial, Lizenz, MahnEingAusl, MahnEingPfl, NDEingPfl, NDEinzelPfl, NDEingAusl, SchallplRetro, TontrPflEinzel
• beim Eingang von Medien, für die es bereits Bestellsätze gibt, wird das Skript via __standardPflicht aufgerufen

__statOhneEingang(art)

Für die nachträgliche Erfassung von statistischen Angaben in einem Datensatz, d.h. nach dem Medieneingang. Wird daher größtenteils genutzt durch Skripte der Formalerschließung. Legt immer nur im eigenen Exemplarsatz ein Feld 4821 an. Einige Inhalte werden u.U. aus dem bereits vorhanden 4821 kopiert

Parameter:

• art: Art der Nacherfassung, steuert den Ablauf. Definitionen s. im Skript, Zsfassung am Anfang

Ablauf:

• Ermittlung von Defaults für die statistischen Angaben im Feld 4821
• wenn es noch keinen Exemplarsatz gibt, wird einer angelegt
• für Inhalte von art, die "FE" (Formalerschließung) enthalten, werden die Inhalte eines vorhandenen 4821 kopiert. Eingabemaske erscheint dann nicht, da nichts händisch angepasst werden muss.
• in anderen Fällen wird die Eingabemaske geöffnet, mit den bisher ermittelten Defaults als Voreinstellungen
• das so erzeugte 4821 wird in den Exemplarsatz eingefügt, in Sonderfällen auch gedoppelt mit unterschiedlichen Aktionscodes
• in einigen Fällen wird 4821 von der Funktion auch nur zurückgegeben, so dass es von der aufrufenden Funktion weiter verarbeitet werden kann

Aufruf:

• von Skripten der Formalerschließung (Monos, Zeitschriften): Aac_Aa, AaaAacAam_EaDiss, AaaAacAam_Kf, AdazAdxz_Advz, AbvzIR etc.
• wenn aus anderen Gründen ein weiteres Feld 4821 hinzugefügt werden soll: StatNacherf1, StatNacherf2

__standardPflicht(mat,felder_nachtragen)

Skript wird verwendet, wenn neue Datensätze mit Exemplarsätze an beiden Standorten erstellt werden sollen. Hierzu wird erst aus den Pflichtinhalten der aufrufenden Datenmaske ein kurzer temporärer Datensatz erstellt, um überhaupt zum anderen Standort wechseln zu können

Parameter:

• mat: Inhalt für 0500 des temporären Datensatzes ( = Aaa, Gaqm etc., muss sich um eine Materialart handeln, die beim Abschicken nicht validiert, da der temporäre Datensatz noch nicht vollständig ist)
• felder_nachtragen: Diese Felder/Feldinhalte aus der Datenmaske sollen erst nach Anlegen des temporären Datensatzes und nach dessen Erweiterung um das Feld 4821 in den Datensatz im Korrekturmodus eingefügt werden, da sie oft noch unvollständig und durch den/die Bearbeiter*in ergänzt werden müssen

Ablauf:

• Prüfen, ob bei den übergebenen Feldern in feldern_nachtragen Felder/Feldinhalte dabei sind, die für die Ermittlung der Inhalte für 4821 genutzt werden können
• Abfrage nach dem Titel (4000 ist Pflichtfeld), wenn nicht aus der aufrufenden Datenmaske vorhanden
• Erzeugen eines temporären Datensatzes, u.U. erweitert um relevante Felder aus feldern_nachtragen
• Aufruf von __statAngaben, mit dem temporären Datensatz als Grundlage
• zum Schluss Ergänzung um die übrigen übergebenen Felder, Datensatz bleibt im Korrekturstatus zur weiteren Bearbeitung
• falls __statAngaben durch den Nutzer abgebrochen wird, kommt eine Fehlermeldung, die darauf hinweist, dass es jetzt einen temporären Datensatz im System gibt, der händisch weiterbearbeitet oder gelöscht werden sollte

Aufruf:

• bei der Anlage von neuen Datensätzen per Datenmaske, bei denen an beiden Standorten Exemplarsätze erzeugt werden: z.B. AaaPflB, CDPflicht, fRTontr,

__statDefaultErmittlung (art)

Unterskript, um Default-Werte für die maschinelle Statistik zu ermitteln, falls sie im aufrufenden Skript nicht klar definiert werden können. Hierzu werden Inhalte aus den Datensätzen ausgewertet

Parameter:

• art: für welches Element soll der Defaultwert ermittelt werden? Möglich:
  
  • "mat: für $m (Materialart). Inhalt wird im Normalfall anhand des Inhalts von 0500 und 0501 ermittelt, auch 1130 oder 1800 werden in einigen Fällen berücksichtigt
  • "akt":  für $c (Aktionscode). Ermittlung anhand verschiedener Kritierien
  • "zweck": für $z (Zweck). Ermittlung im Normalfall anhand des Sourcodes des eingeloggten WinIBW-Users

__DatenmaskeStatistik(datenmaske)

Hiermit kann eine Datenmaske verwendet werden, an die sowohl am eigenen als auch am anderen Standort ein Exemplarsatz erfasst werden soll. Diese Unterfunktion wurde erst später entwickelt, daher gibt es auch Fälle, in denen im selben Fall diese Funktion noch nicht genutzt wird und Einzelschritte erfolgen.

Parameter:

• datenmaske: Welche Datenmaske soll genutzt werden?

Ablauf:

• der Inhalt der Datenmaske wird in ein Array eingelesen
• es wird __standardPflicht aufgerufen und dabei das Array übergeben

StatNacherf1(), StatNacherf2()

Skripte, die vom User direkt aufgerufen werden können, um ein 4821 an einem Datensatz zu erfassen. StatNacherf1 erzeugt ein 4821 nur am eigenen Exemplarsatz, StatNacherf2 zusätzlich auch am anderen.

Ablauf:

• StatNacherf1 prüft, ob sich der Titel im Korrekturmodus befindet und ruft dann __statOhneEingang("") auf

• StatNacherf2 ruft ebenfalls __statOhneEingang("") auf, wodurch im eigenen Exemplarsatz ein 4821 hinzugefügt wird. Das zurückgegebene 4821 wird dann genutzt, um es auch in den Exemplarsatz des anderen Standorts einzufügen

__EingPflichtNeu(str0701, einzel, autonom)

Hierbei handelt es sich um eine Umarbeitung des Skriptes __EingPflicht(str0701), dass auch vor der Einführung der maschinellen Statistik bei der Zugangsbearbeitung verwendet und jetzt entsprechend angepasst wurde. Es enthält aber eigentlich keine statistik-relevanten Elemente, wird daher hier nicht näher beschrieben.

Parameter:

• str0701: Inhalt, mit dem 0701 belegt werden soll
• einzel: wenn "true", soll nur der eigene Standort bearbeitet werden, der Exemplarsatz des anderen Standorts soll gelöscht werden
• autonom: muss "true" sein, wenn es nicht in Zusammenhang mit den Statistikskripten aufgerufen wird

Typische Abläufe

Eingangsbearbeitung eines Pflichttitels (zwei Exemplarsätze), Bestelldatensatz-Datensatz liegt vor

NDEingPfl [verwendet __statDefaultErmittlung("mat")] → __statAngaben [verwendet dnb_statistik.xul/dnb_statistik.js, __EingPflichtNeu("", einzel, "false"))]

Eingangsbearbeitung eines Pflicht-Exemplars (zwei Exemplarsätze), Bestelldatensatz-Datensatz liegt nicht vor

Felder der Datenmaske werden direkt übergeben:

AaaPfl → __standardPflicht("Aaa", ["1100 ", "1500 /1", "1700 /1XA-DE", "4030 "]) [verwendet __statAngaben("false","NEU",__statDefaultErmittlung("mat"),"StatZUG")]

Eingangsbearbeitung eines Pflicht-Exemplars (zwei Exemplarsätze), Bestelldatensatz-Datensatz liegt nicht vor

Felder der Datenmaske werden aus Datenmasken-Datei ausgelesen und dann übergeben:

AaaPflB → tags_array =__datenmaskeInArrEinlesen("AaaPflicht_B") → __standardPflicht("Aaa", tags_array) [verwendet __statAngaben("false","NEU",__statDefaultErmittlung("mat"),"StatZUG")]

Eingangsbearbeitung eines Auslandstitels (nur Exemplarsatz am eigenen Standort), Bestelldatensatz-Datensatz liegt nicht vor

AaaAusl() → DatenmaskeEinfuegen("Aaa") → __statAngaben("true", "NEU", "m1mw-p", "StatZUG")

Formalerschließung Aac-Satz (aus Eingangsbearbeitung vorhandene 4821 wird nachgenutzt)

Aac_Aa → __statOhneEingang("FE")

Änderungen/Anforderungen: was ... wenn ...

• Was muss getan werden, damit eine neue Materialart im Popup der Eingabemaske erscheint?
  • In dnb_statistik.js muss die Variable mat_hash um die neue Materialart erweitert werden
• Es soll eine neue Datenmaske eingeführt werden,  in der das Statistikfeld am eigenen Standort hinzugefügt werden soll
  • __statOhneEingang("FE") kann verwendet werden (s. als Bsp. odaz() in dnb_datenmasken.js)
• Es soll eine neue Datenmaske eingeführt werden,  in der das Statistikfeld an beiden Standorten hinzugefügt werden soll
  • __DatenmaskeStatistik(datenmaske) kann verwendet werden (s. als Bsp. VDI() in dnb_datenmasken.js)
• Bei einer neuen Datenmaske sollen in der Eingabemaske bestimmte Defaultwerte erscheinen, dies klappt aber nicht wie gewünscht
  • In den meisten Fällen ist hier eine Anpassung von __statDefaultErmittlung () notwendig. Dort sind nicht alle Fälle abgedeckt, sondern nur die bisher angeforderten. Man müsste also für den neuen Defaultwert eindeutige Kriterien erkennen und anhand dieser dann neue Bedingungen definieren. Es kann auch angehen, dass die Datenmasken, die sich teilweise sehr ähnlich sind, diese Unterschiede nicht hergeben, dann müsste man mit den Fachkolleg*innen sprechen, ob sie die Datenmaske nicht noch um einen Inhalt erweitern können, der uns eine Unterscheidung möglich macht (als Bsp. s. ILT-6730)