LimeSurvey dla TYPO3

LimeSurvey to zgodna z RODO odpowiedź na ankiety enterprise, które nie mogą kończyć w Google Forms

Kto w Polsce przeprowadza profesjonalne ankiety (badania pracownicze, badania rynku, badania ewaluacyjne, naukowe zbieranie danych) i potrzebuje przy tym zgodności z RODO, pełnej suwerenności danych i porządnego śladu audytowego, niemal z konieczności trafia na LimeSurvey. Oprogramowanie open source działa na własnym serwerze, przechowuje dane odpowiedzi wyłącznie we własnej bazie danych i oferuje wszystkie typy pytań, których wymaga poważne badanie. Dla operatorów TYPO3 nie stoi pytanie, czy używają LimeSurvey, tylko jak integrują go ze swoją istniejącą stroną.

Grupą docelową są zazwyczaj uczelnie, instytucje badawcze, administracje publiczne, szpitale, koncerny z mandatem rady pracowniczej i NGO z wrażliwymi badaniami grup docelowych. Przykład: Uniwersytet Warszawski z 18 000 studentów przeprowadza co semestr ewaluację nauczania i chce odtworzyć wyniki na własnej stronie TYPO3, bez konieczności przełączania się przez studentów między dwoma systemami.

Typowe scenariusze zastosowania

Pierwszym scenariuszem jest płynne uczestnictwo w ankiecie na stronie TYPO3. Zamiast wysyłać studentów na oddzielną domenę LimeSurvey, kwestionariusz jest pokazywany bezpośrednio na stronie witryny. Odpowiedzi przepływają przez API do LimeSurvey, a studenci widzą znajomą nawigację strony. To znacząco obniża współczynnik porzuceń.

Drugim scenariuszem jest identyfikacja uczestników oparta na SSO. Sieć szpitali z 8000 pracownikami przeprowadza badanie pracownicze. Uczestnicy logują się w intranecie TYPO3, klikają link ankietowy i lądują w LimeSurvey bez konieczności ponownego logowania. SSO-Bridge gwarantuje, że każdy pracownik bierze udział tylko raz i że dane osobowe z TYPO3 nie przepływają do odpowiedzi ankiety.

Trzecim scenariuszem jest prezentacja wyników bezpośrednio na stronie. Administracja gminna przeprowadza ankietę wśród mieszkańców na temat inwestycji budowlanej i chce pokazywać codzienne stany pośrednie jako wykres słupkowy na stronie projektu. Zadanie sync pobiera anonimowe agregaty przez API i renderuje je w elemencie treści TYPO3, bez konieczności dotykania przez surowe dane instalacji TYPO3.

Czwartym scenariuszem jest studium longitudinalne w badaniach naukowych. Projekt badawczy dotyczący obciążenia pracą w sektorze opiekuńczym bada tę samą kohortę cztery razy rocznie przez dwa lata. Strona TYPO3 służy jako punkt informacji i wejścia, LimeSurvey trzyma badania, a integracja dba o to, żeby każdy uczestnik przez spersonalizowany link docierał do swoich kolejnych ankiet, bez konieczności pielęgnowania danych kontaktowych w LimeSurvey przez badaczy.

Architektura techniczna

LimeSurvey udostępnia dwa dostępy API: klasyczny interfejs RemoteControl2 na bazie JSON-RPC i nowsze REST-API w aktualnych wersjach. Dla integracji TYPO3 RemoteControl2 pozostaje kotwicą stabilności, bo jest dostępne w starszych instalacjach LimeSurvey i pokrywa pełne uwierzytelnianie, zarządzanie uczestnikami i zapytania o odpowiedzi.

Integracja TYPO3 działa z reguły jako własne rozszerzenie. Warstwa usługi enkapsuluje wywołania API, plugin dostarcza elementy treści dla osadzania ankiet, a middleware implementuje logikę SSO. Dla osadzania istnieją dwa warianty: ankieta jest wywoływana przez podpisany token i osadzana przez iFrame, lub pytania są czytane przez API i bezpośrednio renderowane jako szablon Fluid. To drugie oferuje najlepsze doświadczenie użytkownika, ale wymaga większego nakładu rozwoju.

SSO-Bridge opiera się na podpisanym tokenie, który TYPO3 generuje, a LimeSurvey waliduje. W LimeSurvey konfigurowany jest do tego plugin, który odczytuje token z URL i zakłada uczestnika jako anonimowy token w tabeli uczestników ankiety. Ważne, żeby token był ograniczony czasowo i ważny tylko jednorazowo per uczestnik.

Częste problemy i rozwiązania

Pierwszym problemem jest obsługa sesji między TYPO3 a LimeSurvey. Oba systemy mają własne sesje, a gdy wybrane jest podejście iFrame, powstają problemy z cookies third-party w nowoczesnych przeglądarkach. Rozwiązaniem jest prowadzenie LimeSurvey pod subdomeną instalacji TYPO3, żeby cookies były akceptowane jako first-party, lub użycie wariantu API z serwerowym renderowaniem.

Drugim problemem jest kryzys wydajności przy prezentacji wyników. Kto przy każdym wywołaniu strony pyta API o agregaty, niepotrzebnie obciąża serwer LimeSurvey. Rozwiązaniem jest zadanie sync, które w regularnych interwałach (np. cogodzinnych) zapisuje agregaty w tabeli TYPO3, a element treści renderuje z tej tabeli cache.

Trzecim problemem jest zgodne z RODO obchodzenie się z danymi osobowymi. Przy ankietach pracowniczych pracodawca z reguły nie może rozpoznać, kto udzielił jakiej odpowiedzi. Rozwiązaniem jest porządna koncepcja rozdzielenia: TYPO3 udostępnia tylko anonimowe tokeny, LimeSurvey zapisuje odpowiedzi bez odniesienia zwrotnego, a agregacja odbywa się wyłącznie przez wskaźniki, które nie pozwalają na wnioskowanie o pojedynczych osobach.

Czwartym problemem są słabości wyświetlania mobilnego w trybie iFrame. Ankiety LimeSurvey są wprawdzie responsywne, ale w iFrame TYPO3 dochodzi do podwójnych pasków przewijania i ucinanych przycisków na małych ekranach. Rozwiązaniem jest, aby dla użycia mobilnego przechodzić na serwerowe renderowanie lub dynamicznie dostosowywać iFrame do treści, żeby kontener layoutu strony przejmował pełną wysokość.

Migracja i kompatybilność wersji

Integracje LimeSurvey działają na TYPO3 v11, v12 i v13. Większym wyzwaniem jest strona LimeSurvey: między LimeSurvey 3.x, 5.x i 6.x zmieniły się szczegóły API i procedury uwierzytelniania. Kto podnosi istniejącą integrację na nową wersję LimeSurvey, powinien weryfikować wywołania API wobec odpowiedniej dokumentacji wersji i najlepiej uruchamiać zautomatyzowany test integracyjny wobec instancji staging LimeSurvey.

Gosign wdraża integracje LimeSurvey dla uczelni, szpitali i instytucji publicznych. Klient API powstaje ze wsparciem AI z dokumentacji RemoteControl2, SSO-Bridge jest indywidualnie dopasowywana do istniejącego zarządzania tożsamością, a wdrożenie odbywa się wzdłuż jasnej dokumentacji RODO, która zdejmuje pracę z inspektora ochrony danych.