Analytics und Job-Verarbeitung Michael Voss UB Humboldt-Universität zu Berlin mvoss@ub.hu-berlin.de
Michael Voss - Analytics und Job-Verarbeitung Themen Analytics erste Reports und Widgets Nutzung von Analytics zur Implementation fehlender Funktionalitäten Jobsteuerung über API 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Michael Voss - Analytics und Job-Verarbeitung täglicher Abzug von Daten aus ALMA (Achtung: bestimmte Daten nur monatliches Update -> Title-Dimension) https://knowledge.exlibrisgroup.com/Alma/Product_Documentation/Alma_Online_Help_(English)/Analytics/Titles Start täglich um ... es gibt keine garantierte Ende-Uhrzeit (auch nicht ermittelbar) 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Beispiele für fehlende Funktionalitäten Abräumliste für Lesesaal-Ausleihen (Ende der Leihfrist) -> Verhindern von Mahnschreiben,... Liste von erlassenen Gebühren (für die Akten) Sperren von Lesern, wenn Gebühren ein bestimmtes Alter erreichen; Löschen dieser Sperre, wenn Gebühren vollständig bezahlt sind 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Abräumliste Lesesaal-Ausleihen Lesesaal-Circ Desc Benutzer-ID und Barcode Leihfristende (aktueller Tag) Medien-Barcode 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Michael Voss - Analytics und Job-Verarbeitung AbräumlisteLesesaal Definiert als Widget Staff mit bestimmten Rollen dürfen ansehen 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Liste erlassener Gebühren monatliche Liste Ablage in den Zweigbibliotheken Vorlage von FU (Danke!) Auswahlprameter definieren Analytics Configuration and Subscription (Analytics- Konfiguration und Abonnement 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Gebührenmahnen (Vortrag 2015) Landeshaushaltsordnung Mahnen und Eintreiben offener Gebühren Leistungsbescheide/Verwaltungsvollstreckungsverfahren Befristete und unbefristete Niederschlagung Adress-Ermittlung Haushaltsabteilung (Debitor) Kapazitäten zur Übernahme von Teilaufgaben Probleme: Kleinstbeträge, Anzahl der Vorgänge; Veränderungen in der Höhe der Sollstellung Rechnungsstellung 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Sperren setzen/löschen Sperre (11) „Benutzer hat überfällige Gebühren“ Benutzer hat Gebühren, die älter als 30 Tage sind Sperre wird gelöscht, wenn alle Gebühren beglichen sind Reduzierung der Kleinschulden Basis für weitergehende Gebührenmahn-Routinen 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Michael Voss - Analytics und Job-Verarbeitung Sperre 11 setzen Ermitteln der Nutzer, die offene Gebühren haben (hierzu wird über die API ein Analytics Report aufgerufen, der die NutzerIDs liefert) - 1 ApiCall pro Durchlauf Ermitteln der Nutzer, die die Sperren "(11) Ausstehende Gebühren" haben (hierzu wird über die API ein Analytics Report aufgerufen, der die NutzerIDs liefert) - 1 ApiCall pro Durchlauf nun wird ermittelt, welche Nutzer mit Gebühren die Sperre "(11) Ausstehende Gebühren" noch bekommen müssen (Vergleich der beiden ermittelten Listen) alle Nutzer, denen die Sperre noch fehlt, bekommen die Sperre - 1 ApiCall pro Nutzer 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Michael Voss - Analytics und Job-Verarbeitung Sperre 11 – löschen Export: Patron mit Sperren -> Alma-IntegrationProfile "Export User Blocks". Er exportiert alle Nutzer mit Sperren des Type "General" die Datei enthält Nutzer mit Angabe ihrer Blocks und ihrer aktuellen offenen Gebühren - ermittelt werden die PrimaryIDs der Nutzer, die die gesuchte Sperre "(11) Ausstehende Gebühren" und keine offenen Gebühren mehr haben diese Nutzer werden einzeln geladen, die fragliche Sperre wird aus der Liste der Sperren entfernt, und dann wird der Nutzer zurückgeschrieben - 2 APICalls pro Nutzer 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Michael Voss - Analytics und Job-Verarbeitung Jobsteuerung manuell Alma Schedule API Achtung: In Alma definierte Jobs haben eine JobID. Beim Start von Jobs über API muß die JobID angegeben werden. Es ist essentiell wichtig zu wissen, dass die JobID sich immer ändert, wenn ein Profil gesichert wurde. 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Michael Voss - Analytics und Job-Verarbeitung Jobsteuerung Was funktioniert: Starten von Jobs (mit allen Möglichkeiten von cron) Was fehlt: Jobs melden Verarbeitungsende Jobs melden Ergebnisse (Rückkehr, Fehlercodes,...) 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Jobsteuerung – nächste Schritte Nutzung von Web-Hooks die Auswertung des Erfolgs/Misserfolgs bei der Jobausführung, Steuerung der gegenseitigen Abhängigkeit von Jobs siehe: https://developers.exlibrisgroup.com/blog/tag/Webhooks 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Kontrolle API-Veränderungen Die XSD von Exlibris beschreiben die innerhalb der Alma-API benutzten Objekte. Mit jedem Release (monatlich) könnten sich diese Objekte strukturell verändern. Dieses Projekt hat die Aufgabe das von Alma festgelegten Modell (in Form von XSD Dateien) auf Änderungen zu überprüfen und die Historie in Form von Versionierungen sichtbar zu machen. Bei Veränderung erfolgt eine Meldung. 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung
Michael Voss - Analytics und Job-Verarbeitung Dr. Michael Voss (030) 2093 99 350 mvoss@ub.hu-berlin.de Dank an: Florian Steinborn Heiko Miersch TTollkühn 21.6. 2017 Michael Voss - Analytics und Job-Verarbeitung