Web Actions

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 (Sicherheitsschlü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 (Sicherheitsschlüssel) (optional)
    Je nachdem, welche Aktion erforderlich ist, ist ein Sicherheitsschlüssel mit anzugeben:
    • Unternehmensschlüssel
      Jedes Unternehmen hat einen eigenen Schlüssel (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 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.

War dieser Artikel hilfreich?