Hilfe

Web Actions (HTTP Requests) oder auch Aktionslinks ermöglichen über den direkten Browseraufruf verschiedene Aktionen.

Dokumentation im Aufbau

Aufbau

Der Aufbau ist eine einfache URL mit verschiedenen Parametern für verschiedene Aktionen.

https://hr-adsys.de/?action={task}&{params...}

Je nach dem für welchen Zweck sie genutzt werden soll, kann die URL mit oder ohne Hash (Schlüssel) aufgerufen werden.
Im Folgenden gehen wir auf die möglichen Parameter ein.

• action
  Ist die Aktion, welche ausgeführt werden soll, z. B. Aufruf der Anzeigenvorschau.
  Die einzelnen Aktionen sind mit Titel (action) jeweils separat beschrieben.
  
  
• key (Schlüssel) (optional)
  Je nachdem, welche Aktion erforderlich ist, ist ein Schlüssel mit anzugeben:
  

  • Public Key (Öffentlicher Unternehmensschlüssel)
    Jedes Unternehmen hat einen eigenen und öffentlichen Unternehmensschlüssel.
    Dieser Schlüssel lässt Sie innerhalb von HR AdSys Aktionen beim jeweiligen Unternehmen ausführen.
    So dient der Unternehmensschlüssel auch für den einfachen Zugriff, z. B. zum Zugriff auf die Anzeigenvorschau über einen Direktlink (auch ohne API Authentifizierung oder Login).

    Mehr zum Thema und den verschiedenen Schlüsseln finden Sie in der Customer API-Dokumentation unter Customer Hash.

  • Aktionsschlüssel
    Wird vom System speziell für die Aktion generiert und wird in der Aktionsbeschreibung gesondert behandelt.
    
    

• login (optional)
  Einige Web Actions funktionieren sowohl mit als auch ohne Login. Über den Parameter login wird der Benutzer zur Anmeldung aufgefordert bevor die Aktion ausgeführt werden kann. Eine Funktion, für die es einer Anmeldung bedarf, ist beispielsweise die Anzeigenvorschau.

  Achtung: Der Parameter login entscheidet nicht über die Sicherheit des Zugriffs, da der Link stets mit oder ohne Parameter aufgerufen werden kann. Dies ist lediglich eine Hilfestellung, um die Aktion benutzerfreundlicher zu machen. Ein geteilter Link kann auch ohne HR AdSys-Benutzerkonto im Lesezugriff benutzt werden.

• params
  Hierbei kann es sich um verschiedene individuelle Parameter handeln, welche bei der jeweiligen Funktion mit angefügt werden müssen.

Nachfolgend gehen wir auf die einzelnen Funktionen ein und behandeln auch die individuellen Parameter gesondert.

Web Action: Anzeigenvorschau

Die Anzeigenvorschau öffnet ein Fenster mit der Anzeigenvorschau und den wichtigsten Angaben (z. B. Jobbörse, Kennziffer, Standort).

URL:

https://hr-adsys.de/?action=ad.preview&order_number={Auftragsnummer}&key={Unternehmensschlüssel}

Parameter:

• action=ad.preview (erforderlich)

• order_number={Auftragsnummer} (erforderlich)
  Die Auftragsnummer zur jeweilgen Anzeige

• key={Unternehmensschlüssel} (erforderlich)
  Der Customer Hash des zur Anzeige gehörigen Unternehmens.

Der Aktionslink dient dazu, die Anzeigenvorschau zu versenden. So können auch Dritte ohne Anmeldung direkt die Anzeige zur Überprüfung einsehen.
Wenn Sie im System angemeldet sind, können Sie über diese Aktion Ihre Anzeige prüfen und weitere Aktionen ausführen.

Hinweis: Mehr zum Thema finden Sie im separaten Handbucheintrag Anzeigen.

Web Action: Tabelleneintrag teilen (verlinken)

Tabelleneinträge können geteilt (verlinkt) werden.

Beim Folgen des Aktionslinks wird der geteilte Eintrag in der Tabellenansicht ganz nach oben gesetzt und grün hinterlegt hervorgehoben.
So kann man auf einen speziellen Eintrag in einer Tabelle verweisen.

Tipp: Beim jeweiligen Eintrag steht über das Aktionsmenü auch eine Teilen Funktion zur Verfügung, worüber Sie den entsprechenden Aktionslink oder die ID auslesen können.

URL:

https://hr-adsys.de/?action={view}.share&hid={ID}

Parameter:

• action={view}.share (erforderlich)

  Für folgende Ansichten (Views) ist die Teilen-Funktion implementiert:

  Ansicht	Action (view.share)
  Online-Anzeigen	ad.share
  Verträge	contract.share
  Angebote	offer.share
  Bestellungen	oder.share
  Unternehmen	customer.share
  Benutzer	user.share
  Reportings	reporting.share

• hid={ID} (erforderlich)
  Die ID zum jeweiligen Eintrag ist in der Spalte ID (falls vorhanden) zu finden oder über das Aktionsmenü des Eintrages bzw. über die Teilen-Funktion auslesbar.