¶ Funktionsbeschreibung
Mithilfe der Workflow-Action Task Notifier können Sie sich direkt in Ihrem Teams, Slack oder Google Chat Kanal über neue Workflow Aufgaben Benachrichtigen lassen.
¶ Konfiguration
Wie Sie eine Workflow-Action in einen Workflow hinzufügen können, erfahren Sie hier unter Einrichtung.
Um eine Workflow-Action zu konfigurieren, markieren Sie diese und klicken Sie auf die Schaltfläche Action bearbeiten.
Beschreibung der einzelnen Konfigurationswerte:
| Workflow Value | Beschreibung |
|---|---|
| Nachricht an alle Bearbeiter | Falls gesetzt wird an jeden Benutzer, dem diese Aufgabe zugewiesen wurde, eine separate Nachricht gesendet. |
| Gruppenadresse | WebHook-Adresse für eine Sammelgruppe. Es erfolgt eine Nachricht an diesen hinterlegten Kanal. |
| Konfiguration | Auswahl der zu verwendenden Konfiguration - vom Objekttyp Chat Boot - mit der entsprechenden Nachrichtenvorlage. |
Webhook-Adresse Benutzerchat
Um direkte Nachrichten an einen Benutzerchat zu senden, muss die entsprechende Adresse beim Benutzerobjekt eingetragen werden. Hierzu wird das Feld ChannelWebHook im Benutzerstamm verwendet.
¶ Vorlagenverwaltung
Die einzelnen Vorlagen für die jeweiligen Aufgaben bzw. Benachrichtigungen werden als Objekte in faktur:box Archive verwaltet.
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Name | eindeutiger Name der Konfiguration | Freigabe Eingangsrechnung |
| Beschreibung | Optionale Informationen | Wird im aidex-Workflow für die Freigabe verwendet |
| Teamware | Auswahl der verwendeten Team/Groupware Lösung | Teams |
| Template | Vorlage der zu versendenden Nachricht. | Abhängig von der verwendeten Teamware Lösung |
¶ Mögliche Platzhalter im Template
Im Template kann mit der selben Syntax, wie im Workflow auf Variablen zugegriffen werden. Nachfolgend ein paar Beispiele:
@@OBJECT.OBJ.VOUCHERNUMBER@@ -> Inhalt des Standardfeldes Belegnummer
@@TASK.TASKDESCRIPTION@@ -> Beschreibung des aktuellen Tasks
@@WORKFLOW.WORKFLOWDISPLAYNAME@@ -> Anzeigename des Workflows.
Mehr zur Verwendung von Workflowvariablen finden Sie auf der Seite Verwendung von Workflowvariablen.
¶ Beispiele für Templates
¶ Microsoft Teams
{
"@type": "MessageCard",
"@context": "http://schema.org/extensions",
"themeColor": "0076D7",
"summary": "Neue Aufgabe",
"sections": [
{
"activityTitle": "@@WORKFLOW.WORKFLOWDISPLAYNAME@@",
"activitySubtitle": "@@TASK.TASKDISPLAYNAME@@",
"activityImage": "https://fakturdigital.de/wp-content/uploads/2020/08/faktur-box-logo-inv_800x919.png",
"facts": [
{
"name": "Aufgabe:",
"value": "@@TASK.TASKDESCRIPTION@@"
},
{
"name": "Rechnung:",
"value": "@@OBJECT.OBJ.NAME@@<br>@@OBJECT.OBJ.DESCRIPTION@@"
},
{
"name": "Fällig bis:",
"value": "@@OBJECT.DueDateDateTime@@"
},
{
"name": "Rechnungsbetrag:",
"value": "@@OBJECT.GrandTotalAmount@@ @@OBJECT.InvoiceCurrencyCode@@"
}
],
"markdown": true
}
]
}
¶ Google Chat
{
"cards": [
{
"header": {
"title": " @@WORKFLOW.WORKFLOWDISPLAYNAME@@",
"subtitle": "@@TASK.TASKDISPLAYNAME@@",
"imageUrl": "https://fakturdigital.de/wp-content/uploads/2020/08/faktur-box-logo-inv_800x919.png",
"imageStyle": "IMAGE"
},
"sections": [
{
"widgets": [
{
"keyValue": {
"topLabel": "Aufgabe",
"content": "@@TASK.TASKDESCRIPTION@@"
}
},
{
"keyValue": {
"topLabel": "Rechnung",
"content": "@@OBJECT.OBJ.NAME@@<br>@@OBJECT.OBJ.DESCRIPTION@@"
}
},
{
"keyValue": {
"topLabel": "Fällig bis",
"content": "@@OBJECT.DueDateDateTime@@"
}
},
{
"keyValue": {
"topLabel": "Rechnungsbetrag",
"content": "@@OBJECT.GrandTotalAmount@@ @@OBJECT.InvoiceCurrencyCode@@"
}
}
]
},
{
"widgets": [
{
"buttons": [
{
"textButton": {
"text": "Zum faktur:box Archive",
"onClick": {
"openLink": {
"url": "https://ihrsystem.fakturbox.io/archive/services/web"
}
}
}
}
]
}
]
}
]
}
]
}
¶ Slack
{
"blocks": [
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*@@WORKFLOW.WORKFLOWDISPLAYNAME@@*\n@@TASK.TASKDISPLAYNAME@@"
}
},
{
"type": "divider"
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*Aufgabe:*\n@@TASK.TASKDESCRIPTION@@"
}
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*Rechnung:*\n@@OBJECT.OBJ.NAME@@\n@@OBJECT.OBJ.DESCRIPTION@@"
}
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*Fällig bis:* @@OBJECT.DueDateDateTime@@"
}
},
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*Rechnungsbetrag:* @@OBJECT.GrandTotalAmount@@ @@OBJECT.InvoiceCurrencyCode@@"
}
},
{
"type": "divider"
},
{
"type": "actions",
"block_id": "actionblock789",
"elements": [
{
"type": "button",
"text": {
"type": "plain_text",
"text": "Zum faktur:box Archive"
},
"url": "https://ihrsystem.fakturbox.io/archive/services"
}
]
}
]
}