Direktlink zu HISinOne-Lehrveranstaltungen

[mlopin]

Direktlinks

Um später erfolgreich Direktlink zu HISinOne-Lehrveranstaltungen in ILIAS anzeigen zu können, sollte in den JSON-Daten das Attribut url mit dem Direktlink zur HISinOne-Lehrveranstaltung gefüllt werden. (siehe Zeile 183 in JsonBuilder.php)

Direktlink-Beispiel

https://{HISinOne}/qisserver/pages/startFlow.xhtml?_flowId=detailView-flow&unitId={unitId}&periodId={periodId}

{HISinOne}

Es sollte einen neue Option für die HISinOne-(Frontend)-URL geben. Diese kann in unterschiedlichen Szenarien von der bestehenden Option 'url' in der config.json abweichen, bspw. wenn für die Abfrage der Webservices ein Proxy zum Einsatz kommt.

{unitId}

Der nötige Wert sollte bereits in den aktuellen Daten der jeweiligen Lehrveranstaltung vorhanden sein, welche aus HISinOne abgerufen werden.

{periodId}

Die benötigte PeriodId kann über den Webservice PeriodService ermittelt werden.
Hier ein Beispiel Request:

   <soapenv:Envelope xmlns:soapenv=["http://schemas.xmlsoap.org/soap/envelope/"](http://schemas.xmlsoap.org/soap/envelope/ "http://schemas.xmlsoap.org/soap/envelope/") xmlns:per=["http://www.his.de/ws/PeriodService"](http://www.his.de/ws/PeriodService "http://www.his.de/ws/PeriodService")>  
   <soapenv:Header/>  
   <soapenv:Body>  
      <per:getPeriod>  
         <per:termYear>2025</per:termYear>  
         <per:termTypeId>30</per:termTypeId>  
         <per:usageText> </per:usageText>  
         <per:periodUsageHiskey>7</per:periodUsageHiskey>  
      </per:getPeriod>  
   </soapenv:Body>  
</soapenv:Envelope>

Der Wert für usageText kann eine beliebige, auch leere Zeichenfolge sein, da er aktuell nicht weiter ausgewertet wird. Zusätzlich muss periodUsageHiskey mit dem Wert 7 angegeben werden. Die Werte für termYear und termTypeId sind ja berei

Die entsprechende Response des Webservices sieht wie folgt aus:

<soapenv:Envelope xmlns:soapenv=["http://schemas.xmlsoap.org/soap/envelope/"](http://schemas.xmlsoap.org/soap/envelope/ "http://schemas.xmlsoap.org/soap/envelope/")>  
   <soapenv:Header/>  
   <soapenv:Body>  
      <his:getPeriodResponse xmlns:his=["http://www.his.de/ws/PeriodService"](http://www.his.de/ws/PeriodService "http://www.his.de/ws/PeriodService")>  
         <his:period>  
            <his:id>226</his:id>  
            <his:uniquename>20251</his:uniquename>  
            <his:startdate>2025-03-01T00:00:00</his:startdate>  
            <his:enddate>2025-08-31T23:59:59</his:enddate>  
         </his:period>  
      </his:getPeriodResponse>  
   </soapenv:Body>  
</soapenv:Envelope>