Services und API
GRIS stellt verschiedene Funktionen zur verfügung, die Daten an externe Anwendungen (z. B. Typo3) senden können. Dadurch können beispielsweise Profildaten extern dargestellt werden.
gris_profiles_json.php
Liefert Profilinformationen zur Person aus.
Methode
GET
Parameter
Parameter |
Typ |
Wertebereich/Format |
Beschreibung |
|---|---|---|---|
lang |
String |
de|en |
Sprache |
pub |
int |
0|1 |
Publikationen mitausgeben |
pid |
int |
[1-9]+[0-9]* |
Suche nach Person-ID |
name |
String |
firstname.lastname |
Suche nach Namen (statt ID) |
Testaufruf
http://localhost/gris/service/gs_profiles_json.php?pid=60
http://localhost/gris/service/gs_profiles_json.php?name=holger.heuser
http://localhost/gris/service/gs_profiles_json.php?name=holger.heuser&pub=1
http://localhost/gris/service/gs_profiles_json.php?name=holger.heuser&lang=en
http://localhost/gris/service/gs_profiles_json.php?name=holger.heuser&pub=1&lang=en
gris_contact_json.php
Liefert Kontaktinformationen zur Person aus.
Methode
GET
Parameter
Parameter |
Typ |
Wertebereich/Format |
Beschreibung |
|---|---|---|---|
lang |
String |
de|en |
Sprache |
name |
String |
firstname.lastname |
Suche nach Namen |
Testaufruf
http://localhost/gris/service/gs_contact_json.php?name=holger.heuser
http://localhost/gris/service/gs_contact_json.php?name=holger.heuser&lang=en
gs_units.php
Liefert das komplette Organigramm oder nur die an Personen vergebenen Teile aus.
Methode
GET
Parameter
Parameter |
Typ |
Wertebereich/Format |
Beschreibung |
|---|---|---|---|
used |
String |
*|NULL (kein Wert übergeben) |
Nur verwendete Units ausgeben |
Testaufruf
http://localhost/gris/service/gs_units.php
http://localhost/gris/service/gs_units.php?used=true
gs_personlist.php
Liefert alle Personen aus, deren Nachname mit einem bestimmten Buchstaben beginnen. Alternativ alle Personen, die einer bestimmten Unit zugewiesen sind.
Methode
GET
Parameter
Parameter |
Typ |
Wertebereich/Format |
Beschreibung |
|---|---|---|---|
alpha [1] |
String |
[a-z] |
Aller Personen mit diesem Anfangsbuchstaben im Nachnamen |
alpha |
String |
[all] |
Alle Anfangsbuchstaben, für die Personen vorhanden sind |
lang |
String |
[de|en] |
Sprache |
order [2] |
String |
true|Null (keine Übergabe) |
Gibt nur die Reihenfolge der Rollen zurück |
unit |
Int |
### |
Unit-ID (Alternativ zu |
filter |
String |
[all|head] |
Funktioniert nur mit |
[1] Alpha ist exklusiv: Alle anderen Parameter werden ignoriert, wenn alpha valide gesetzt wurde
[2] Order ist exklusiv: :Alle anderen Parameter außer alpha werden ignoriert, wenn order valide gesetzt wurde
Testaufruf
http://localhost/gris/service/gs_personlist.php?alpha=a
http://localhost/gris/service/gs_personlist.php?unit=3
http://localhost/gris/service/gs_personlist.php?unit=3&filter=head
gs_export.php
Exportiert alle Ressourcen einer Person als Bibtex.
Methode
GET
Parameter
Parameter |
Typ |
Wertebereich/Format |
Beschreibung |
|---|---|---|---|
raw |
String |
[true|false] |
Rohdaten zurückgeben |
name |
String |
firstname.lastname |
Suche nach Namen (nur falls kein ID vorhanden) |
id |
Int |
### |
Die Personen-ID |
Testaufruf
http://localhost/gris/service/gs_export.php?id=60
http://localhost/gris/service/gs_export.php?id=60&raw=true
http://localhost/gris/service/gs_export.php?name=holger.heuser
gs_bibtex_dump.php
Exportiert alle Ressourcen Bibtex. Die Variable show wird berücksichtigt.
Methode
GET
Parameter
keine
Testaufruf
http://localhost/gris/service/gs_bibtex_dump.php
gs_cat_import.php
Importiert alle Kategorien aus einer bestehenden Typo3-Instanz. Dazu muss auf dem Typo3-Server ein entsprechendes Script installier werden, das die Daten ausliefert.
Methode
GET
Parameter
keine
Testaufruf
http://localhost/gris/service/gs_cat_import.php