README

Beim HISinOne TYPO3 Connector handelt es sich um eine TYPO3 Extension, die es ermöglicht, Forschungsdaten aus HISinOne (HIO) in TYPO3 zu importieren und anzuzeigen.

Die Extension unterstützt aktuell die folgenden Datentypen:

Personen
Projekte
Publikationen
Organisationseinheiten
Promotionen
Ausgründungen
Habilitationen
Patente

Damit die Extension genutzt werden kann, muss die Middleware "HIO-Publisher - Publisher für HISinOne" installiert und konfiguriert sein. Nähere Informationen dazu finden Sie hier https://hio-publisher.de.

➡️ Changelog – Alle Änderungen, neue Features und Breaking Changes

Für Agenturen

Die HISinOne TYPO3 Connector Extension ist eine Open Source TYPO3 Extension, die von der WEBTEAM LEIPZIG GmbH entwickelt wurde. Sie ist für den Einsatz in TYPO3 Version 12.4 und höher geeignet und kann von Agenturen und TYPO3 Entwicklerinnen und Entwicklern genutzt werden, um Forschungsdaten aus HISinOne in TYPO3 zu integrieren.

Solltet Ihr bei der Integration der HISinOne TYPO3 Connector Extension in Euer Projekt Unterstützung benötigen, könnt Ihr Euch gerne an uns wenden.

WEBTEAM LEIPZIG GmbH
Gutenbergplatz 1
04103 Leipzig

Email: info+hio@wtl.de
Web: https://hio-publisher.de

Initiales Setup

Im TYPO3 Backend:

unter Admin Tools -> Extensions -> Extension Manager die Extension hio-typo3-connector installieren
im Modul Page die benötigten Speicherseiten (Storage pages) für die importierten Datentypen anlegen

Empfohlen ist je Datentyp eine eigene Speicherseite, zum Beispiel:

HISinOne Personen
HISinOne Projekte
HISinOne Publikationen
HISinOne Organisationseinheiten
HISinOne Promotionen
HISinOne Habilitationen
HISinOne Patente
HISinOne Nominierungen
HISinOne Forschungsinfrastrukturen
HISinOne Ausgründungen

Diese Speicherseiten werden für die Import-Tasks und Reactions als Storage page ID verwendet. Sie sind nicht dasselbe wie die Zielseiten im Frontend.

Configuration

Im TYPO3 Backend:

Anpassung der TypoScript-Konstanten für die Zielseiten der einzelnen Datentypen
bei Nutzung von Site Sets: Set HIO TYPO3 Connector einbinden; die Datei Configuration/Sets/HioTypo3Connector/constants.typoscript wird dann mitgeladen
ohne Site Sets: Configuration/TypoScript/constants.typoscript als Grundlage einbinden

Wichtig:

Storage page ID in Scheduler-Tasks und Reactions verweist auf die Systemordner mit den importierten Datensätzen
...TargetPageUid in TypoScript verweist auf die Frontend-Seite, auf die aus Listen- und Detailansichten verlinkt wird

Die Zahlen in der Konfiguration stehen also nicht für die Import-Speicherorte, sondern für Zielseiten im Frontend.

Beispielkonfiguration:

plugin.tx_hiotypo3connector {
  settings {
    publications {
      personTargetPageUid = 110
    }
    persons {
      publicationTargetPageUid = 120
      projectTargetPageUid = 130
      patentTargetPageUid = 140
      doctoralProgramTargetPageUid = 150
    }
    orgUnits {
      personTargetPageUid = 110
      publicationTargetPageUid = 120
      projectTargetPageUid = 130
      patentTargetPageUid = 140
      doctoralProgramTargetPageUid = 150
    }
    doctoralPrograms {
      personTargetPageUid = 110
    }
    habilitations {
      personTargetPageUid = 110
    }
    patents {
      personTargetPageUid = 110
    }
    projects {
      personTargetPageUid = 110
    }
    nominations {
      personTargetPageUid = 110
      orgUnitTargetPageUid = 160
      projectTargetPageUid = 130
      publicationTargetPageUid = 120
    }
    spinoffs {
      personTargetPageUid = 110
    }
    projectDetails {
      persons {
        filterProjectLead = Projektleiter/-in
      }
    }
    featuredProjects {
      projectTargetPageUid = 130
    }
    featuredPublications {
      publicationTargetPageUid = 120
    }
  }
}

Die Datei ExampleConfigs/constants.typoscript enthält dieselbe Beispielstruktur als kopierbare Vorlage.

Konfiguration HIO-Publisher - Direktimport Kommandos (Middleware - Pull)

Im TYPO3 Backend:

unter Admin Tools -> Scheduler -> die folgenden Import Tasks anlegen:
- hio:doctoral-programs:import - Importiert Promotionen aus HISinOne
- hio:habilitations:import - Importiert Habilitationen aus HISinOne
- hio:nominations:import - Importiert Preisanerkennungen aus HISinOne
- hio:org-units:import - Importiert Organisationseinheiten aus HISinOne
- hio:patents:import - Importiert Patente aus HISinOne
- hio:persons:import - Importiert Personen aus HISinOne
- hio:projects:import - Importiert Projekte aus HISinOne
- hio:publications:import - Importiert Publikationen aus HISinOne
- hio:research-infrastructures:import - Importiert Forschungsinfrastrukturen aus HISinOne
- hio:spinoffs:import - Importiert Ausgründungen aus HISinOne
jeder der genannten Tasks hat folgende Parameter:
- Storage page ID - die Speicherseite, unter der die importierten Datensätze gespeichert werden
- URL - die URL des Publisher für HISinOne REST API Endpoints
- username - optionaler BasicAuth-Username zum Zugriff auf die API; leer lassen, um den Umgebungsvariablen-Fallback zu verwenden
- password - optionales BasicAuth-Passwort zum Zugriff auf die API; leer lassen, um den Umgebungsvariablen-Fallback zu verwenden
- --no-basic-auth - optional, deaktiviert BasicAuth für diesen Task; Scheduler- und Umgebungsvariablen-Zugangsdaten werden ignoriert

BasicAuth kann zentral über Prozess-Umgebungsvariablen konfiguriert werden:

HIO_TYPO3_CONNECTOR_BASIC_AUTH_USERNAME="username"
HIO_TYPO3_CONNECTOR_BASIC_AUTH_PASSWORD="password"

Eine .env-Datei wird von dieser Extension nicht selbst geladen. Der Fallback greift nur, wenn diese Werte bereits als Umgebungsvariablen im PHP-Prozess verfügbar sind, zum Beispiel weil das Projekt, das Hosting oder ein Bootstrap eine .env-Datei lädt.

Die BasicAuth-Konfiguration wird in dieser Reihenfolge aufgelöst:

Wenn --no-basic-auth im Scheduler-Task gesetzt ist, wird kein BasicAuth verwendet.
Wenn username und password im Scheduler-Task gesetzt sind, werden diese Werte verwendet.
Wenn beide Umgebungsvariablen gesetzt sind, werden diese Werte verwendet.
Andernfalls wird kein BasicAuth verwendet.

Konfiguration HIO-Publisher - Asynchroner Import (Middleware - Push)

Die Middleware des "Publisher für HISinOne" ist in der Lage große Mengen an Forschungsdaten asynchron an TYPO3 zu übergeben. Dazu wird ein Webhook (Reaction) in TYPO3 benötigt, der die importierten Datensätze anlegt oder aktualisiert sowie ein TYPO3 Scheduler Tasks der Import des jeweiligen Datentyps (Projekt, Publikation, Person, ...) anstösst. Die Middleware ermittelt die zu importierenden Datensätze und übergibt diese in frei definierbaren "Paketgrößen" an den TYPO3 Webhook.

Voraussetzung für diesen Push-Mechanismus ist die installierte und aktive System-Extension reactions.

Im TYPO3 Backend:

unter Admin Tools -> Reactions -> die folgenden TYPO3 Webhooks (Reactions) anlegen:
- Receive doctoral program data from HIO Middleware - Webhook zum Import von Promotionen
- Receive habilitation data from HIO Middleware - Webhook zum Import von Habilitationen
- Receive nomination data from HIO Middleware - Webhook zum Import von Preisanerkennungen
- Receive orgUnit data from HIO Middleware - Webhook zum Import von Organisationseinheiten
- Receive patent data from HIO Middleware - Webhook zum Import von Patenten
- Receive person data from HIO Middleware - Webhook zum Import von Personen
- Receive project data from HIO Middleware - Webhook zum Import von Projekten
- Receive publication data from HIO Middleware - Webhook zum Import von Publikationen
- Receive research-infrastructure data from HIO Middleware - Webhook zum Import von Forschungsinfrastrukturen
- Receive spinoff data from HIO Middleware - Webhook zum Import von Ausgründungen
jeder der genannten Webhooks hat folgende Parameter:
- Storage page ID - die Speicherseite, unter der die importierten Datensätze gespeichert werden
- secret - das generierte Token zum Zugriff auf den TYPO3 Webhook muss in dem korrespondierenden Import Requests als x-api-key hinterlegt werden
unter Admin Tools -> Scheduler -> die folgenden Import Requests anlegen:
- hio:request:doctoralProgram:import - Startet den Import von Promotionen aus HISinOne
- hio:request:habilitation:import - Startet den Import von Habilitationen aus HISinOne
- hio:request:nomination:import - Startet den Import von Preisanerkennungen aus HISinOne
- hio:request:orgUnit:import - Startet den Import von Organisationseinheiten aus HISinOne
- hio:request:patent:import - Startet den Import von Patente aus HISinOne
- hio:request:person:import - Startet den Import von Personen aus HISinOne
- hio:request:project:import - Startet den Import von Projekte aus HISinOne
- hio:request:publication:import - Startet den Import von Publikationen aus HISinOne
jeder der genannten Tasks hat folgende Parameter:
- API Endpoint URl - die URL des Publisher für HISinOne REST API Endpoints
- API Basic auth username - optionaler API-BasicAuth-Username; leer lassen, um den Umgebungsvariablen-Fallback zu verwenden
- API Basic auth password - optionales API-BasicAuth-Passwort; leer lassen, um den Umgebungsvariablen-Fallback zu verwenden
- --api-no-basic-auth - optional, deaktiviert API-BasicAuth für diesen Task; Scheduler- und Umgebungsvariablen-Zugangsdaten werden ignoriert
- TYPO3 Webhook URl - die URl des TYPO3 Webhooks (TYPO3 Reaction), der die importierten Datensätze anlegt oder aktualisiert
- TYPO3 X-API-KEY - das Autorisierungs-Token zum Zugriff auf den TYPO3 Webhook (TYPO3 Reaction)

Für BasicAuth gelten dieselben Umgebungsvariablen und dieselbe Auflösungsreihenfolge wie bei den Direktimport-Kommandos.

Frontend plugins

Im TYPO3 Backend:

Im Module Page können die folgenden Frontend-Plugins eingefügt werden:

HISinOne Habilitationen - zeigt eine Liste von Habilitationen aus HISinOne an
HISinOne Organisationseinheiten - zeigt eine Liste von Organisationseinheiten aus HISinOne an
HISinOne Patente - zeigt eine Liste von Patenten aus HISinOne an
HISinOne Personen - zeigt eine Liste von Personen aus HISinOne an
HISinOne Projekte - zeigt eine Liste von Projekten aus HISinOne an
HISinOne Promotionen - zeigt eine Liste von Promotionen aus HISinOne an
HISinOne Publikationen - zeigt eine Liste von Publikationen aus HISinOne an
HISinOne Habilitationen der Person - zeigt die Liste aller freigegebenen Habilitationen einer ausgewählten Person an
HISinOne Organisationseinheiten der Person - zeigt die Liste aller freigegebenen Organisationseinheiten einer ausgewählten Person an
HISinOne Patente der Person - zeigt die Liste aller freigegebenen Patente einer ausgewählten Person an
HISinOne Projekte der Person - zeigt die Liste aller freigegebenen Projekte einer ausgewählten Person an
HISinOne Promotionen der Person - zeigt die Liste aller freigegebenen Promotionen einer ausgewählten Person an
HISinOne Publikationen der Person - zeigt die Liste aller freigegebenen Publikationen einer ausgewählten Person an

Legacy-Plugins

Die Plugins Display selected projects und Display selected publications sind deprecated. Sie bleiben aus Kompatibilitätsgründen technisch registriert, damit bestehende Inhaltselemente weiter funktionieren.

Für neue Inhalte sind diese beiden Legacy-Plugins im Backend jedoch bewusst ausgeblendet. Neue Konfigurationen sollen stattdessen über die Container-Elemente featuredProjects und featuredPublications aus wtl/hio-typo3-connector-frontend aufgebaut werden.

Beide Legacy-Plugins sind nur noch als Übergangslösung vorhanden und werden in v2 vollständig entfernt.

wtl / hio-typo3-connector

Package info

Security

Statistics

README

Für Agenturen

Initiales Setup

Configuration

Konfiguration HIO-Publisher - Direktimport Kommandos (Middleware - Pull)

Konfiguration HIO-Publisher - Asynchroner Import (Middleware - Push)

Frontend plugins

Legacy-Plugins