Unterstützung benutzerdefinierter URLs

Auslösen von Aktionen

Aktionen im Agenten-Interface können automatisch über einen speziellen URL-Parameter namens TriggerAction ausgelöst werden. Der unten beschriebene Ansatz funktioniert für jede Aktion, die für die aktuelle Ansicht registriert ist.

Lassen Sie uns zum Beispiel die Aktion Freie Felder ändern auslösen, die in der Ticket-Detailansicht verfügbar ist.

1. Identifizieren Sie den Slug-Namen der fraglichen Ansicht. Für die Ticket-Detailansicht und das Ticket mit der ID 1 ist dies:

   /agent/ticket/1
   

   Sie können das Ticket über die Ticket-Nummer aufrufen, die Sie auf den Slug-Namen der Ansicht weiterleitet. Wenn das Ticket mit der ID 1 die Ticketnummer 2022042710123456 hat, können Sie diese verwenden:

   /agent/ticket/number/2022042710123456
   

2. Identifizieren Sie den BusinessObjectType der Ansicht, in der die Aktion ausgelöst werden soll. In unserem Fall, für die Ticket-Detailansicht, ist dies der BusinessObjectType:

   Ticket
   

3. Gehen Sie zur Systemkonfiguration im Administrator-Interface und suchen Sie nach der betreffenden Aktionsregistrierungs-Einstellung. In unserem Fall ist dies:

   AgentFrontend::Ticket::Action###FreeText
   

4. Identifizieren Sie den Wert des Schlüssels Komponente in der Einstellung, das ist der Name der Front-End-Komponente. In unserem Fall ist das der Name:

   TicketFreeText
   

5. Konstruieren Sie den Aktionsbezeichner in Form von <BusinessObjectType>::<Komponente>. In unserem Fall ist dies:

   Ticket::TicketFreeText
   

6. Hängen Sie einen Abfrageparameter an die URL der Detailansicht mit dem Namen TriggerAction an und setzen Sie ihn auf den Action Identifier, dessen Wert im vorherigen Schritt konstruierte wurde:

   /agent/ticket/1?TriggerAction=Ticket%3A%3ATicketFreeText
   

   Bemerkung

   Im Falle von benutzerdefinierten URL-Abfrageparameterwerten müssen wir darauf achten, alle Sonderzeichen zu kodieren, die normalerweise in URLs verwendet werden (z.B. doppelte Anführungszeichen). Dieser Prozess wird als „URL-Kodierung“ bezeichnet und kann mit jedem frei verfügbaren Online-Tool, wie den Online Text Tools, durchgeführt werden.

Beim Besuch der URL, wie oben konstruiert, wird die Aktion automatisch ausgelöst:

Vorbefüllen von Formularfeldern

OTRS-Formularfelder können mit Werten vorbefüllt werden, die über URL-Abfrageparameter geliefert werden. Der unten beschriebene Ansatz funktioniert für jedes Formular im Agenten und im externen Interface.

Sehen wir uns zum Beispiel an, wie wir das Feld Titel des Aktionsformulars Freie Felder ändern vorbefüllen können, das wir im vorherigen Beispiel ausgelöst haben.

Da diese Aktion zunächst nicht auf der Ansicht angezeigt wird, behalten wir den Parameter trigger action bei und fügen ihn einfach hinzu:

/agent/ticket/1?TriggerAction=Ticket%3A%3ATicketFreeText

1. Identifizieren Sie den Namen des betreffenden Formularfeldes.

   In unserem Fall haben wir es mit der folgenden Form zu tun:

   Forms###AgentFrontend::Ticket::Action::FreeText
   

   Gemäß der the form fields reference wird das Feld treffend benannt:

   Title
   

2. Hängen Sie einen Query-Parameter mit dem Namen des Feldes an die URL der Detailansicht an und setzen Sie ihn auf den gewünschten Wert:

   /agent/ticket/1?TriggerAction=Ticket%3A%3ATicketFreeText&Title=Some+text
   

   Bemerkung

   Zusätzliche URL-Abfrageparameter können mit einem kaufmännischen Und-Zeichen (&) verkettet werden.

   Bemerkung

   Im Falle von benutzerdefinierten URL-Abfrageparameterwerten müssen wir darauf achten, alle Sonderzeichen zu kodieren, die normalerweise in URLs verwendet werden (z.B. doppelte Anführungszeichen). Dieser Prozess wird als „URL-Kodierung“ bezeichnet und kann mit jedem frei verfügbaren Online-Tool, wie den Online Text Tools, durchgeführt werden.

Beim Besuch der URL, wie oben konstruiert, wird die Aktion automatisch ausgelöst und das Feld vorbelegt:

Der Ansatz kann für alle anderen Felder des Formulars wiederholt werden, z.B. wenn wir auch das Feld Service (Feldname ServiceID) auf einen hypothetischen Wert Service 2 mit einer ID von 2 setzen möchten, können wir es so zur bestehenden URL hinzufügen:

/agent/ticket/1?TriggerAction=Ticket%3A%3ATicketFreeText&Title=Some+text&ServiceID=2

Beim Besuch der URL, wie oben konstruiert, wird die Aktion automatisch ausgelöst und beide Felder werden vorausgefüllt:

Übermitteln von Aktionen

Aktionen im Agenten-Interface können automatisch über einen speziellen URL-Parameter namens SubmitForm übermittelt werden. Der unten beschriebene Ansatz funktioniert für jede Aktion, die für die aktuelle Ansicht registriert ist.

Sehen wir uns zum Beispiel an, wie wir das Aktionsformular Freie Felder ändern übermitteln können, das wir bereits in früheren Beispielen ausgelöst und vorausgefüllt haben.

Da diese Aktion zunächst nicht auf der Ansicht angezeigt wird, werden wir den Parameter trigger action sowie einige form field parameters beibehalten und einfach ergänzen:

/agent/ticket/1?TriggerAction=Ticket%3A%3ATicketFreeText&Title=Some+text&ServiceID=2

Hängen Sie einen Query-Parameter an die URL der Detailansicht namens SubmitForm an und setzen Sie 1 als Wert:

/agent/ticket/1?TriggerAction=Ticket%3A%3ATicketFreeText&Title=Some+text&ServiceID=2&SubmitForm=1

Beim Besuch der URL, wie oben konstruiert, wird die Aktion automatisch ausgelöst, beide Felder vorbelegt und die Aktion sofort eingereicht:

Benutzerdefinierte Business-Objekt-Listen

Alle statischen Listen von Business-Objekten im Agent-Interface unterstützen die benutzerdefinierte Konfiguration über einen speziellen URL-Parameter namens Config. Die im Folgenden skizzierte Vorgehensweise funktioniert für ähnliche Ansichten, die unter im folgenden Abschnitt aufgelistet sind, sowie für alle in der YAML-Referenz dokumentierten Schlüssel.

Sehen wir uns zum Beispiel an, wie wir eine aktive Filtervoreinstellung für eine Business-Objektliste festlegen können, indem wir sorgfältig eine direkte URL für die Ansicht konstruieren.

1. Identifizieren Sie den slug name der betreffenden Ansicht. Wir werden AgentFrontend::TicketList::Static verwenden, die diesen Slug hat:

   /agent/tickets/static
   

2. Gehen Sie auf Systemkonfiguration im Administrator-Interface und suchen Sie nach der betreffenden Ansicht der Systemkonfigurations-Einstellung, in unserem Fall ist dies:

   AgentFrontend::TicketList::Static###DefaultConfig
   

2. Stellen Sie sicher, dass der Schlüssel AllowGETConfig in der Ansicht Konfiguration die Eigenschaften FilterPresets und FilterPresetSelected enthält, die wir über den Query-Parameter übergeben werden.

   Um diese Schlüssel ändern zu können, müssen sie in der Liste vorhanden sein, sonst werden sie ignoriert. Weitere Informationen finden Sie in der Schlüsselreferenz.

   

3. Konstruieren Sie eine gültige YAML-Konfiguration, die eine benutzerdefinierte Filtervoreinstellung definiert und als vorgewählt setzt.

   ---
   FilterPresets:
     "Total Tickets":
       CustomerID:
         Value: my-customer@otrs.com
   FilterPresetSelected: "Total Tickets"
   

4. Konvertieren Sie die YAML-Struktur aus dem vorherigen Schritt in die JSON-Syntax, da YAML für die Übergabe über Parameter ungeeignet ist. Wenn wir dies tun, erhalten wir die folgende analoge Struktur.

   {
      "FilterPresets": {
         "TotalTickets": {
            "CustomerID": {
               "Value": "my-customer@otrs.com"
            }
         }
      },
      "FilterPresetSelected": "Total Tickets"
   }
   

4. Entfernen Sie den gesamten zusätzlichen weißen Bereich, um diese Konfiguration in eine einzige Zeile zu komprimieren.

   {"FilterPresets":{"Total Tickets":{"CustomerID":{"Value":"my-customer@otrs.com"}}},"FilterPresetSelected":"Total Tickets"}
   

5. Um die Konfiguration an die Ansicht unter /agent/tickets/static zu übergeben, müssen wir nur einen URL-Abfrageparameter namens Config definieren und die obige JSON-Struktur als seinen Wert festlegen.

   Bemerkung

   Im Falle von benutzerdefinierten URL-Abfrageparameterwerten müssen wir darauf achten, alle Sonderzeichen zu kodieren, die normalerweise in URLs verwendet werden (z.B. doppelte Anführungszeichen). Dieser Prozess wird als „URL-Kodierung“ bezeichnet und kann mit jedem frei verfügbaren Online-Tool, wie den Online Text Tools, durchgeführt werden.

   /agent/tickets/static?Config=%7B%22FilterPresets%22%3A%7B%22Total%20Tickets%22%3A%7B%22CustomerID%22%3A%7B%22Value%22%3A%22my-customer%40otrs.com%22%7D%7D%7D%2C%22FilterPresetSelected%22%3A%22Total%20Tickets%22%7D