Zum Inhalt

Einrichtung von App-Benachrichtigungen

Business Portals nutzt App-Benachrichtigungen für die Business Portals Mobile App, um Benutzer über wichtige Ereignisse wie Bestellbestätigungen, Bestellstatusaktualisierungen und mehr zu informieren. Die Plattform ermöglicht die Erstellung benutzerdefinierter App-Benachrichtigungen, die eine dynamische Integration mit Daten für ein personalisiertes Benutzererlebnis ermöglichen. Zusätzlich unterstützt diese Funktion mehrsprachige Fähigkeiten, sodass Benachrichtigungen in der mehrere Sprache des Benutzers gesendet werden können.

Erstellen einer neuen App-Benachrichtigung

Um eine neue App-Benachrichtigung für die Mobile App zu erstellen, gehen Sie wie folgt vor:

  1. Klicken Sie im Business Portals Rollencenter auf Portal Setup in der Ribbon-Leiste.
  2. Navigieren Sie zu den App-Benachrichtigungen.
  3. Klicken Sie auf die Schaltfläche Neu, um eine neue App-Benachrichtigung zu erstellen.
  4. Geben Sie den Code als eindeutigen Identifikator für die App-Benachrichtigung ein.
  5. Füllen Sie das Feld Beschreibung mit einer kurzen Beschreibung der App-Benachrichtigung aus. Dieses Feld ist nur für den Business Central-Benutzer sichtbar.

  6. Füllen Sie das Feld Icon mit dem FontAwesome Icon für die App-Benachrichtigung aus. Dieses Icon wird in der Benachrichtigung der Mobile App angezeigt. Wenn das Icon leer gelassen wird, wird kein Icon in der App angezeigt.

    Warnung

    • Stellen Sie sicher, dass der Klassenname korrekt und vollständig ist, um Probleme mit der Anzeige des Icons zu vermeiden.
    • Verwenden Sie immer nur den Klassenname aus dem HTML-Code, nicht den gesamten HTML-Code.
      • ❌ <i class="fa-solid fa-house"></i>
      • ✅ fa-solid fa-house

  7. Füllen Sie das Feld Icon Color mit der gewünschten Farbangabe für die App-Benachrichtigung.

    Info

    Die Icon-Farbe muss im Hex-Code angegeben werden, zum Beispiel #e0f542, was eine gelbe Farbe ergibt. Wenn die Farbe leer bleibt, wird automatisch das Standard-Farbthema der App verwendet.

  8. Wählen Sie die Source Table mit der Lookup-Funktion aus. Wählen Sie eine Quelltabelle aus, die den Anforderungen der Benachrichtigung entspricht.

  9. Konfigurieren Sie den Platzhalter nach Bedarf.

  10. Klicken Sie im Bereich Zeilen auf den Sprach Code und wählen Sie die gewünschte Sprache aus.

    Info

    Es wird empfohlen, jeden Sprachcode auszufüllen, den das Business Portal basierend auf der Sprachkonfiguration dem Benutzer zur Verfügung stellt.

  11. Geben Sie den Titel für die App-Benachrichtigung ein.

  12. Geben Sie die Nachricht für die App-Benachrichtigung ein.

Tipp

Das Pro-Icon von FontAwesome kann ebenfalls in Business Portals verwendet werden.

Beispiel: Lieferbestätigungsbenachrichtigung

In diesem Beispiel zeigen wir, wie eine Benachrichtigung für eine Lieferbestätigung erstellt wird. Dabei wird die Source Table und der Placeholder vollständig genutzt. Wir beginnen direkt mit der App-Benachrichtigungs-Karte, die durch die vorherigen Schritte zugänglich gemacht wird.

  1. Geben Sie den Code für die App-Benachrichtigung ein. In diesem Fall nennen wir sie BESTELLBESTÄTIGUNG.
  2. Füllen Sie eine kurze Beschreibung für die Business Central-Benutzer ein. In diesem Fall schreiben wir Lieferbestätigung der Bestellung.
  3. Als Nächstes wählen wir ein Box-Icon für das Symbol, das später in der App angezeigt wird, wir schreiben fa-solid fa-box in das Icon-Feld und es wird in der App angezeigt. Probieren Sie gerne eine andere Symbolkombination aus.
  4. Für dieses Beispiel bleibt das Feld Icon Color leer, sodass die App automatisch das Standard-Farbthema der App verwendet.
  5. Da diese Benachrichtigung eine Lieferbestätigung für einen Artikel ist, wählen wir die Quelltabelle Item oder die Tabellennummer 27.
  6. Um die Quelltabelle zu nutzen, öffnen Sie die Placeholder-Karte, indem Sie die Nummer im Placeholder-Feld anklicken oder die Aktion Notification Placeholder in der Ribbon-Leiste verwenden.
  7. In der Placeholder-Karte wird automatisch ein neuer Placeholder Text erstellt. Da es der erste Placeholder ist, wird er automatisch als %1 festgelegt. Verwenden Sie die Lookup-Funktion im Field Name-Feld, um alle Felder anzuzeigen, die aus der ausgewählten Source Table verfügbar sind.
  8. In diesem Beispiel möchten wir, dass der %1-Placeholder den Artikelnamen enthält, daher wählen wir die Beschreibung aus.
  9. Schließen Sie die Tabelle nach Abschluss der Placeholder-Konfiguration.
  10. Klicken Sie im Bereich Zeilen auf das Dropdown-Menü Language Code und wählen Sie die Sprache aus, die in den Business Portals - Sprachen konfiguriert ist.
  11. Für dieses Beispiel verwenden wir Englisch, der Language Code lautet ENU und der Titel wird als Lieferbestätigung eingegeben.
  12. Schreiben Sie die Nachricht und verwenden Sie den Placeholder, in diesem Beispiel Ihre %1 wurde geliefert.
  13. Die Konfiguration ist nun abgeschlossen, und diese Benachrichtigung kann verwendet werden.

Dies ist das Beispiel für die Einrichtung einer App-Benachrichtigung. Wenn der Artikelname OFFICE Chair lautet, wird in der App das Icon mit dem Titel Lieferbestätigung und der Nachricht Ihr OFFICE Chair wurde geliefert in der englischen Benachrichtigung angezeigt.

Verwendung der App-Benachrichtigung

Die App-Benachrichtigung kann auf zwei Arten genutzt werden: Die erste Methode besteht darin, Prozesse und Status zu verwenden, während die zweite Methode über eine Codeunit-Aktion erfolgt.

Verwendung von Prozessen und Status

Um App-Benachrichtigungen für Statusaktualisierungen und Prozesse zu verwenden, müssen zunächst die entsprechenden Status und Prozesse erstellt werden. Sobald diese festgelegt sind, können App-Benachrichtigungen im Status konfiguriert werden, um ausgelöst zu werden, wenn ein bestimmter Status erreicht wird.

Siehe auch