Ordermanager/docs/html/manual/Aufgaben/Aktionen.html

281 lines
14 KiB
HTML

<!DOCTYPE html>
<html class="no-js" lang="de">
<head>
<title>Aktionen - Auftragsmanager</title>
<meta name="description" content="">
<meta name="author" content="D³ Data Development">
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link rel="icon" href="../../themes/d3/img/favicon.png" type="image/x-icon">
<!-- Mobile -->
<meta name="apple-mobile-web-app-capable" content="yes" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- Font -->
<!-- CSS -->
<link href='../../themes/d3/css/theme-blue.min.css' rel='stylesheet' type='text/css'><link href='../../themes/d3/css/d3.css' rel='stylesheet' type='text/css'>
<!-- Tipue Search -->
<link href="../../tipuesearch/tipuesearch.css" rel="stylesheet">
<!--[if lt IE 9]>
<script src="../../themes/d3/js/html5shiv-3.7.3.min.js"></script>
<![endif]-->
</head>
<body class=" ">
<div class="Columns content">
<aside class="Columns__left Collapsible">
<button type="button" class="Button Collapsible__trigger">
<span class="Collapsible__trigger__bar"></span>
<span class="Collapsible__trigger__bar"></span>
<span class="Collapsible__trigger__bar"></span>
</button>
<a class="Brand" href="../../index.html"><i class='fab fa-d3 d3fa-color-blue'></i> Auftragsmanager</a>
<div class="Search">
<svg class="Search__icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 451 451">
<path d="M447.05 428l-109.6-109.6c29.4-33.8 47.2-77.9 47.2-126.1C384.65 86.2 298.35 0 192.35 0 86.25 0 .05 86.3.05 192.3s86.3 192.3 192.3 192.3c48.2 0 92.3-17.8 126.1-47.2L428.05 447c2.6 2.6 6.1 4 9.5 4s6.9-1.3 9.5-4c5.2-5.2 5.2-13.8 0-19zM26.95 192.3c0-91.2 74.2-165.3 165.3-165.3 91.2 0 165.3 74.2 165.3 165.3s-74.1 165.4-165.3 165.4c-91.1 0-165.3-74.2-165.3-165.4z"/>
</svg>
<input type="search" id="tipue_search_input" class="Search__field" placeholder="Suchen..." autocomplete="on"
results=25 autosave=text_search>
</div>
<div class="Collapsible__content">
<!-- Navigation -->
<ul class='Nav'><li class='Nav__item '><a href="../../manual/Handbuch.html">Handbuch</a></li><li class='Nav__item has-children'><a href="../../manual/Einstellungen/Grundeinstellungen.html" class="folder"><i class="Nav__arrow">&nbsp;</i>Einstellungen</a><ul class='Nav'><li class='Nav__item '><a href="../../manual/Einstellungen/Grundeinstellungen.html">Grundeinstellungen</a></li><li class='Nav__item '><a href="../../manual/Einstellungen/Aufgabeneinstellungen.html">Aufgabeneinstellungen -> Ordner</a></li><li class='Nav__item '><a href="../../manual/Einstellungen/allgemeine_Cronjobeinstellungen.html">allgemeine Cronjobeinstellungen</a></li><li class='Nav__item '><a href="../../manual/Einstellungen/Cronjobeinstellungen_fuer_Cronjob-ID.html">Cronjobeinstellungen für Cronjob-ID "X"</a></li></ul></li><li class='Nav__item Nav__item--open has-children'><a href="../../manual/Aufgaben/index.html" class="folder"><i class="Nav__arrow">&nbsp;</i>Aufgaben</a><ul class='Nav'><li class='Nav__item '><a href="../../manual/Aufgaben/Stamm.html">Stamm</a></li><li class='Nav__item '><a href="../../manual/Aufgaben/Mall.html">Mall</a></li><li class='Nav__item '><a href="../../manual/Aufgaben/Uebersicht.html">Übersicht</a></li><li class='Nav__item '><a href="../../manual/Aufgaben/Ausloeser.html">Auslöser</a></li><li class='Nav__item '><a href="../../manual/Aufgaben/Bedingungen.html">Bedingungen</a></li><li class='Nav__item Nav__item--active'><a href="../../manual/Aufgaben/Aktionen.html">Aktionen</a></li></ul></li><li class='Nav__item '><a href="../../manual/Logging.html">Logging</a></li><li class='Nav__item '><a href="../../manual/Aufgaben_automatisch_ausfuehren.html">Aufgaben automatisch ausführen</a></li><li class='Nav__item '><a href="../../manual/Cronjobs_fuer_unterschiedlich_zu_steuernde_Aufgaben.html">Cronjobs für unterschiedlich zu steuernde Aufgaben</a></li><li class='Nav__item '><a href="../../manual/Aufgaben_fuer_alle_relevanten_Bestellungen_manuell_ausfuehren.html">Aufgaben für alle relevanten Bestellungen manuell ausführen</a></li><li class='Nav__item '><a href="../../manual/Aufgaben_fuer_einzelne_Bestellung_manuell_ausfuehren.html">Aufgaben für einzelne Bestellung manuell ausführen</a></li><li class='Nav__item '><a href="../../manual/Anzeige_der_gefundenen_Bestellungen_als_Liste.html">Anzeige der gefundenen Bestellungen als Liste</a></li><li class='Nav__item '><a href="../../manual/relevante_Bestellungen_einschraenken.html">Bestellungen mit globaler Einstellung einschränken</a></li><li class='Nav__item '><a href="../../manual/Weiterentwicklung.html">Weiterentwicklung</a></li></ul>
<div class="Links">
<hr/>
<a href="https://www.oxidmodule.com" target="_blank">Shop</a><br />
<a href="https://blog.oxidmodule.com" target="_blank">Blog</a><br />
<a href="https://faq.d3data.de" target="_blank">FAQ</a><br />
<a href="https://docs.oxidmodule.com" target="_blank">Dokumentationen</a><br />
<a href="https://support.oxidmodule.com" target="_blank">D³ Support Center</a><br />
<a href="https://www.oxidmodule.com/kontakt" target="_blank">Kontakt</a><br />
<a href="https://www.oxidmodule.com/impressum" target="_blank">Impressum</a><br />
</div>
</div>
</aside>
<div class="Columns__right Columns__right--full">
<div class="Columns__right__content">
<div class="doc_content">
<article class="Page">
<div class="Page__header">
<h1><a href="../../manual/Aufgaben/index.html">Aufgaben</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../../manual/Aufgaben/Aktionen.html">Aktionen</a></h1>
<span class="ModifiedDate">
10.12.2021 </span>
</div>
<div class="s-content">
<p>Haben Sie die Bedingungen gesetzt, setzen Sie nun die Aktionen, die ausschließlich auf die gefundenen Bestellungen angewendet werden.</p>
<p>Auch hier verzichten wir in diesem Handbuch auf die Auflistung der Aktionen, da diese normalerweise selbsterklärend sind. Im Folgenden sind nun Besonderheiten aufgeführt, auf die Sie speziell achten sollten:</p>
<h3 id="page_Bestellung-loschen">&quot;Bestellung löschen&quot;</h3>
<p>Beachten Sie, dass die Aktion „Löschen von Bestellungen“ nicht rückgängig gemacht werden kann. Lassen Sie bei solchen Aktionen erst während eines Testzeitraums die Infomails zusenden, mit denen Sie prüfen können, ob die Löschaktionen auch die richtigen Bestellungen betreffen. Wir übernehmen keine Gewährleistung bei Datenverlust auf Grund von unzureichend geprüften Aufgaben.</p>
<h3 id="page_Aktionen-mit-Wahrungsmengen">Aktionen mit Währungsmengen</h3>
<p>Alle Aktionen, die sich auf Währungsmengen beziehen (z.B. Versandkosten oder Rabatte), verwenden die Angabe immer in der Shop-Hauptwährung. Rechnen Sie Angaben in Fremdwährung für die Aktionen daher bitte immer um.</p>
<h3 id="page_Feld-auf-Wert-prufen-mit-Wert-fullen">&quot;Feld auf Wert prüfen / mit Wert füllen&quot;</h3>
<p>Geben Sie bei Veränderung eines Freitextfeldes als Feldname immer das Stammfeld an. Die Angabe des sprachabhängigen Suffix (z.B. ..._1) wird vom Modul bei Bedarf selbst
vorgenommen.</p>
<h3 id="page_E-Mail-senden">&quot;E-Mail senden&quot;</h3>
<p>Beim Versand von Mails können Sie als Quelle Ihres Mailinhalts CMS-Bausteine aus Ihrem Shop oder komplette Templatedateien verwenden. In beiden Möglichkeiten haben Sie die folgenden Variablen zur Verfügung, um die Mail zu individualisieren:</p>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Inhalt</th>
</tr>
</thead>
<tbody>
<tr>
<td>$oShop</td>
<td>enthält das Shop-Objekt und alle seine Möglichkeiten</td>
</tr>
<tr>
<td>$shop</td>
<td>enthält das Shop-Objekt und alle seine Möglichkeiten</td>
</tr>
<tr>
<td>$oViewConf</td>
<td>enthält das Shop-Objekt und alle seine Möglichkeiten</td>
</tr>
<tr>
<td>$oOrder</td>
<td>enthält das Bestellungen-Objekt und alle seine Möglichkeiten</td>
</tr>
<tr>
<td>$order</td>
<td>enthält das Bestellungen-Objekt und alle seine Möglichkeiten</td>
</tr>
<tr>
<td>$oUser</td>
<td>enthält das Benutzer-Objekt und alle seine Möglichkeiten</td>
</tr>
<tr>
<td>$user</td>
<td>enthält das Benutzer-Objekt und alle seine Möglichkeiten</td>
</tr>
<tr>
<td>$shopTemplateDir</td>
<td>enthält das Verzeichnis zum Template</td>
</tr>
<tr>
<td>$charset</td>
<td>enthält den Zeichensatz für die Mail</td>
</tr>
<tr>
<td>$basket</td>
<td>enthält das Warenkorb-Objekt und alle seine Möglichkeiten (erfordert, dass alle Artikel noch im Stamm vorhanden sind)</td>
</tr>
<tr>
<td>$payment</td>
<td>enthält das Bezahlarten-Objekt und alle seine Möglichkeiten</td>
</tr>
<tr>
<td>$oDelSet</td>
<td>enthält das Versandarten-Objekt und alle seine Möglichkeiten</td>
</tr>
<tr>
<td>$currency</td>
<td>enthält das Währungs-Objekt und alle seine Möglichkeiten</td>
</tr>
</tbody>
</table>
<p>Legen Sie die Templatedateien im auszuwählenden Ordner ab.</p>
<h3 id="page_Push-Benachrichtigung-senden">&quot;Push-Benachrichtigung senden&quot;</h3>
<p>Hierbei wird eine Benachrichtigung an eine eigene Schnittstelle oder einen Dienst (z.B. <a href="https://ifttt.com/" class="Link--external">IFTTT</a> oder <a href="https://automate.io/" class="Link--external">Automate.io</a>) gesendet, der damit weitere Aktionen auslösen kann. Welche Aktionen möglich sind, hängt vom verwendeten Dienst ab.</p>
<p>Bei Push-Benachrichtigungen können der Benachrichtung Daten mitgegeben werden, die vom benachrichtigten Dienst ausgewertet werden können. Der mögliche Funktionsumfang ist so groß, dass wir nur ein Beispiel mitgeben. Möchten Sie die Daten über den konfigurierbaren Umfang hinaus verändern, stehen Ihnen dazu diese Funktionen zur Verfügung, die modular überladen werden können.</p>
<table>
<thead>
<tr>
<th>Element</th>
<th>Klasse</th>
<th>Methode</th>
<th>Parameter</th>
<th>erwarteter Rückgabetyp</th>
</tr>
</thead>
<tbody>
<tr>
<td>Headerangaben</td>
<td>d3ordermanager_action_sendpushnotification</td>
<td>getHeaders</td>
<td>keine</td>
<td>Array</td>
</tr>
<tr>
<td>Nachrichtenbody</td>
<td>d3ordermanager_action_sendpushnotification</td>
<td>getSubmittedBody</td>
<td>keine</td>
<td>String</td>
</tr>
<tr>
<td>alle zu übertragenden Optionen</td>
<td>d3ordermanager_action_sendpushnotification</td>
<td>getSubmittedOptions</td>
<td>keine</td>
<td>Array</td>
</tr>
<tr>
<td>Übertragungsmethode</td>
<td>d3ordermanager_action_sendpushnotification</td>
<td>getRequestMethod</td>
<td>keine</td>
<td>String</td>
</tr>
<tr>
<td>Zieladresse</td>
<td>d3ordermanager_action_sendpushnotification</td>
<td>getRequestUrl</td>
<td>keine</td>
<td>String</td>
</tr>
</tbody>
</table>
<p>In den meisten Fällen wird das Anpassen des Nachrichtenbody ausreichen. Im Standard werden dort benötigte Felder als json encodetes Array zurückgegeben.</p>
<p>GET-Parameter innerhalb der Anfrage-URL können mit Platzhaltern angepasst werden. Platzhaltervariablen werden in doppelte geschweifte Klammern gefasst &quot;{{var1}}&quot;. Die verfügbaren Variablen sehen Sie am Hilfetext der URL im Adminbereich der Aktion.</p>
<p>Bei der Verwendung der POST-Übertragsmethode werden optionale GET-Parameter der URL automatisch an den schon bestehenden Nachrichtenbody angefügt.</p>
<p>Innerhalb der Methoden stehen folgende Objekte und deren Eigenschaften zur Verfügung:</p>
<table>
<thead>
<tr>
<th>Aufruf</th>
<th>Inhalt</th>
</tr>
</thead>
<tbody>
<tr>
<td>$this-&gt;getManager()</td>
<td>enthält die Auftragsmanager-Aufgabe und alle seine Möglichkeiten</td>
</tr>
<tr>
<td>...-&gt;getId()</td>
<td>die eindeutige Identnummer</td>
</tr>
<tr>
<td>...-&gt;getFieldData('oxtitle')</td>
<td>den Aufgabentitel</td>
</tr>
<tr>
<td>...-&gt;getFieldData('oxsort')</td>
<td>die Aufgabensortiernummer</td>
</tr>
<tr>
<td>...-&gt;getFieldData('d3_cronjobid')</td>
<td>die Cronjob-ID</td>
</tr>
<tr>
<td></td>
<td></td>
</tr>
<tr>
<td>$this-&gt;getManager()-&gt;getCurrentItem()</td>
<td>enthält das Bestellungsobjekt und alle seine Möglichkeiten</td>
</tr>
<tr>
<td>$this-&gt;getManager()-&gt;getCurrentItem()-&gt;getOrderUser()</td>
<td>enthält das Kundenobjekt der Bestellung und alle seine Möglichkeiten</td>
</tr>
</tbody>
</table>
<p>Benötigen Sie Unterstützung bei der Einrichtung, kontaktieren Sie uns bitte.</p>
</div>
<nav>
<ul class="Pager">
<li class=Pager--prev><a href="../../manual/Aufgaben/Bedingungen.html">Zurück</a></li> <li class=Pager--next><a href="../../manual/Logging.html">Weiter</a></li> </ul>
</nav>
</article>
</div>
</div>
</div>
</div>
<!-- JS -->
<script src="../../themes/d3/js/jquery-1.11.3.min.js"></script><script src="../../themes/d3/js/highlight.pack.js"></script><script src="../../themes/d3/js/daux.js"></script><script src="../../themes/d3/js/fontawesome-all.js"></script>
<!-- Tipue Search -->
<script type="text/javascript" src="../../tipuesearch/tipuesearch.js"></script>
<script>
window.onunload = function(){}; // force $(document).ready to be called on back/forward navigation in firefox
$(function() {
tipuesearch({
'base_url': '../../'
});
});
</script>
</body>
</html>