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
pub	int	0	1
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
name	string	firstname.lastname	Suche nach Namen (statt ID)

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)

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 (exklusiv)	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]
order (exklusiv)	string	true	Null (keine Übergabe)
unit	int	###	Unit-ID (Alternativ zu alpha)
filter	string	[all	head]

• Alpha ist exklusiv: Alle anderen Parameter werden ignoriert, wenn alpha valide gesetzt wurde
• 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]
used	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