PLANET-ROCKLOG ermöglicht den Zugriff auf Daten und Prozesse von PLANET-ROCKLOG nach definierten Kriterien. Der Zugriff erfolgt über Publiclinks. Ein Publiclink ist eine wohldefinierte, optional zeitlich begrenzt gültige URL, über die ein Benutzer Karten angezeigt bekommt und die das Ausführen wohldefinierter Prozesse wie zum Beispiel:
erlaubt.
Publiclinks können mandantenspezifisch gestaltet werden und bieten Zugriff in einem definierten Rahmen.
Publiclinks können als REST Webservice genutzt werden um aus anderen Anwendungen auf PLANET-ROCKLOG Daten zugreifen zu können. Die Authorisierung erfolgt anhand eines APIKEY.
Das nun folgende Beispiel beschreibt die Anlage ein Publiclink zum Anzeigen aller Artikel mit einer bestimmten Eigenschaft
Gruppe=Beeren
Die Einschränkung ist willkürlich. Es ist jede Einschränkung anwendbar die indirekt oder direkt auf die anzuzeigenden Karten gültig ist. Hat man zum Beispiel Artikel einer Artikelgruppe zugeordnet, so kann man einen Publiclink definieren der alle Artikel anzeigt, deren zugeordnete Artikelgruppe einer bestimmten Einschränkung genügt.
Zur Definition einen Publiclink clicken Sie im Carddesk auf den Kartentype cardtype.
Wählen Sie über dem Kartentyp, für welchen Sie einen Publiclink erzeugen wollen die Funktion Teilen via Public Link und Tabin und schliesslich Public Link anlegen zum öffentlichen Zugriff auf Karten
Nun wählen Sie im Carddesk den Kartentyp Public Link.
Bearbeiten Sie die zuletzt erzeugte Karte. Diese hat den Feldwert (hier article) im Feld cardtype entsprechend des Kartentypen, für welchen der Publiclink definiert wurde.
Geben Sie eine Beschreibung für den Publiclink an, dieser hat nur informativen Charakter. Anschliessend geben Sie noch eine Sucheinschränkung ein. Diese Sucheinschränkung erlaubt dem Nutzer des Publiclinks nur Zugriff auf die Karten, welche mindestens dieser Einschränkung genügen. Speichern Sie schliesslich die Karte.
Um die für den erzeugten Publiclink passende URL zu finden und zu verwenden, öffnen Sie im Carddesk den Kartentyp für den der Publiclink definiert wurde (hier article).
Wählen Sie im rechten Funktionsmenü Teilen via Public Link und Tabin.
Kopieren Sie die URL des neu definierten Publiclink oder öffnen Sie diesen direkt in einem neuen Browsertab.
Ein Publiclink stellt Karten dar. Für jede Karte werden
dargestellt.
Stellen Sie sich Primärinformationen als die wichtigsten Informationen einer Karte und die Tertiärinformationen als die am wenigsten wichtigen aber denoch im Publiclink anzuzeigenden Kartenfelder vor.
Um ein Feld auf den Karten eines Publiclink darzustellen bearbeiten Sie eine beliebige Karte des entsprechenden Kartentyps und öffnen Sie Weitere Einstellungen.
Aktivieren Sie für alle Felder, die auf den Karten des Publiclink sichtbar sein sollen die Option Minikarte. Definieren Sie ob das Feld eine Primär-, Sekundär- oder aber Tertiärinformation ist. Die Reihenfolge der Felder entspricht der Reihenfolge in Karte in der Hauptanwendung. Diese Reihenfolge kann durch die Funktionen Position nach oben und nach unten angepasst werden.
Lässt der Feldwert keinen eindeutigen Rückschluss auf den Feldnamen zu, dann kann die Option Feldname auf Minicard aktiviert werden.
Die Darstellung des Feldes einer Karte im Publiclink ändert sich dann von
auf
Die im Rahmen eines Publiclink verfügbaren Daten können über einen REST Webservice bezogen werden. Dafür ist die Zuteilung eines APIKEY notwendig, der den Zugriff für authorisierte Personen und Drittprogramme regelt.
Öffen Sie im Carddesk den Kartentyp API key.
Legen Sie eine neue Karte an, wenn notwendig.
Sie können die Einstellungen wie gegeben übernehmen und die Karte speichern.
Optional können Sie den Zugriff mittels dieses APIKEY aber auch einschränken
Der Zugriff auf den Publiclink per Webservice erfolgt nun über die URL
<Basis URL>/pd/<ID des Publiclink>?apikey=<ID des APIKEY>
in diesem Beispiel also über
https://hub3.planet-rocklog.com/p38pzvs6a4/pd/aAFAgc1npj?apikey=GSEUqPwfDL
Sollen nur Karten zurückgegeben werden, die neben der Basiseinschränkung des Publiclink noch einer weiteren Einschränkung genügen, so kann letztere im URL GET parameter query angegeben werden.
Beispielsweise liefert
https://hub3.planet-rocklog.com/p38pzvs6a4/pd/aAFAgc1npj?apikey=GSEUqPwfDL&query=sauer
