Share via

KM Steuerelement (gehostetes Steuerelement)

  • Artikel

Verwenden Sie das neue KM Steuerelement des Typs Wissensverwaltung, um die Wissensdatenbankartikel in Ihrer Agent-Anwendung anzuzeigen. Mit dem neuen gehosteten Steuerelement können Ihre Servicemitarbeiter Artikel suchen, einen Artikel einer Anfrage zuordnen und die Zuordnung aufheben, einen Link in einen Artikel kopieren, und ihn per E-Mail oder Chat senden, ohne die Anwendungen wechseln zu müssen. Weitere Informationen: Wissen für effektives Customer Engagement nutzen und Unified Service Desk für die Verwendung modellbasierter Apps konfigurieren

Erstellen eines gehosteten Wissensverwaltungs-Steuerelements

Beim Erstellen eines neuen gehosteten Steuerelements variieren die Felder auf dem Bildschirm Neues gehostetes Steuerelement basierend auf dem Typ des gehosteten Steuerelements, das Sie erstellen möchten. Dieser Abschnitt enthält Informationen zu den spezifischen Feldern, die für gehostete Steuerelemente des Typs Wissensverwaltung eindeutig sind. Ausführliche Informationen zum Erstellen eines Aufgabendatensatzes siehe Gehostete Steuerelement erstellen und anzeigen.

Gehostetes Steuerelement für die Wissensverwaltung.

Gehen Sie im Bildschirm Neues gehostetes Steuerelement wie folgt vor:

  • Wählen Sie im Bereich Unified Service Desk die Option KM Steuerelement aus der Dropdownliste Unified Service Desk-Komponententyp aus.

  • Die Dropdownliste Mehrere Seiten zulassen wird für diesen Typ des gehosteten Steuerelements nicht unterstützt.

  • Die Dropdownliste Hosting-Typ zeigt an, wie dieses Steuerelement gehostet werden soll. Sie können Chrome-Prozess auswählen. Weitere Informationen finden Sie unter Wählen Sie eine Hostingmethode für gehostete Steuerelemente aus.

  • Wählen Sie im Bereich Allgemeine Eigenschaften das Kontrollkästchen Anwendung ist global, um das gehostete Steuerelement als global festzulegen. Globale gehostete Steuerelemente können außerhalb einer Kundensitzung angezeigt werden. Steuerelemente wie das Dashboard des Agenten, Pinnwand oder Suche sind typische Einsatzgebiete für gehostete Steuerelemente. Globale Steuerelemente haben keinen sitzungsspezifischen Status; wenn Sie Sitzungen wechseln, bleiben die gehosteten Steuerelemente daher bestehen. Wenn das Kontrollkästchen nicht aktiviert ist, wird das gehostete Steuerelement sitzungsbasiert. Sitzungsbasierte Steuerelemente bestehen im Kontext mit Kundensitzungen. Wenn der Benutzer in eine andere Sitzung wechselt, werden alle Sitzungsseiten der vorherigen Sitzung ausgeblendet.

  • Das Feld Anzeigegruppe zeigt das Fenster an, in dem dieses gehostete Steuerelement angezeigt wird. Im Wissensverwaltungspaket wird die Wissensverwaltung im RighPanel angezeigt. Allerdings können Sie festlegen, dass sie im RighttPanel oder MainPanel angezeigt wird, ganz nach Bedarf. Informationen über die verschiedenen in Unified Service Desk verfügbaren Bedienfelder finden Sie unter Bedienfelder, Bedienfeldtypen und Bedienfeldlayouts in Unified Service Desk.

    Informationen zu den Allgemein Feldern finden Sie unter Gehostete Steuerelemente erstellen oder bearbeiten

Vordefinierte UII-Aktionen

Dies sind die vordefinierten Aktionen für diese Art gehosteter Steuerelemente.

Zuordnen

Ordnet einen Wissensdatenbankdatensatz in Microsoft Dataverse dem Datensatz der übergeordneten Entität in Wissensverwaltung zu.

Parameter Beschreibung
entitytypename Der logische Name der übergeordneten Entität, zu der der Wissensdatenbankdatensatz zuzuordnen ist. Beispiel: entitytypename=incident
recordid Die ID des Datensatzes der übergeordneten Entität, zu dem der Wissensdatenbankdatensatz zuzuordnen ist.
articleuniqueid Die eindeutige ID des Artikels, den Sie zuordnen möchten. Beispiel: articleuniqueid=7924/8112/Article/41
articletitle Ein Zeichenfolgenwert, der den Titel des Artikels darstellt, den Sie zuordnen möchten. Beispiel: articletitle=Diffused Sunlight and Weather Conditions
articlepublicurl Die öffentliche URL des Artikels, den Sie zuordnen möchten. Wenn Sie die systemeigene Dataverse-Wissensdatenbank verwenden, sollten die Artikel bereits an ein externes Portal veröffentlicht sein (wählen Sie Externes Portal verwenden im Dialofeld Einstellungen für die Verwaltung der Wissensdatenbank in Dataverse aus), damit Sie den Artikel URL in diesem Parameter verwenden können.

Beispiel: articlepublicurl=https://support.microsoft.com/kb/{kbnum}

Schließen

Schließt das gehostete Steuerelement Wissensverwaltung.

Zuordnung aufheben

Hebt die Zuordnung eines Wissensdatenbankdatensatzes auf, der bereits dem Datensatz der übergeordneten Entität in Wissensverwaltung zugeordnet ist.

Parameter Beschreibung
articleuniqueid Die eindeutige ID des Artikels, dessen Zuweisung Sie aufheben möchten. Beispiel: articleuniqueid=7924/8112/Article/41
relatedentityrecordid Die ID des Datensatzes der übergeordneten Entität, dem der Wissensdatenbankdatensatz zugeordnet ist.
entityname Der logische Name der übergeordneten Entität, der der Wissensdatenbankdatensatz zugeordnet ist. Beispiel: entitytypename=incident

FireEvent

Löst ein benutzerdefiniertes Ereignis vom gehosteten Steuerelement Wissensverwaltung aus.

Parameter Beschreibung
name Name des benutzerdefinierten Ereignisses.

Alle folgenden Name=Wert-Paare werden die Parameter des Ereignisses. Weitere Informationen zum Erstellen eines benutzerdefinierten Berichts Ereignisses.

MoveToPanel

Verschiebt das gehostete Steuerelement zur Laufzeit in das angegebene Panel in Unified Service Desk.

Parameter Beschreibung des Dataflows
app Name des zu verschiebenden gehosteten Steuerelements.
panel Name des Zielbereichs, in den das gehostete Steuerelement zu verschieben ist.

Zeigt eine URL aus dem gehosteten Steuerelement an und führt die Fensternavigationsregeln dafür aus, um das Popup an den richtigen Ort zu leiten.

Parameter Beschreibung
url Leitet ein Popup vom gehosteten Steuerelement mit dieser URL weiter, als wäre dies ein von dem angezeigten Steuerelement angefragtes Popup.
frame Der Frame, von dem das Popup stammt.

RealignWindow

Zeigt das gehostete Steuerelement an der angegebenen Stelle auf einem Bildschirm. Sie können das gehostete Steuerelement auf bis zu zwei Monitoren anzeigen. Diese Aktion ist für gehostete Steuerelementinstanzen verfügbar, die zur Platzierung in einem Bereich des Typs USDFloatingPanel oder USDFloatingToolPanel konfiguriert sind.

Parameter Beschreibung
Bildschirm Gibt den Bildschirm an, auf dem das gehostete Steuerelement angezeigt werden soll. Gültige Werte sind 1 oder 2. Wird dieser Parameter nicht angegeben, wird 1 als Standard verwendet.
left Gibt die Position in Prozent von der linken Bildschirmkante auf dem Zielbildschirm an, auf dem das gehostete Steuerelement angezeigt werden soll. Gültige Werte sind 0–100. Wird dieser Parameter nicht angegeben, wird 0 als Standard verwendet.
oben Gibt die Position in Prozent von der oberen Bildschirmkante auf dem Zielbildschirm an, auf dem das gehostete Steuerelement angezeigt werden soll. Gültige Werte sind 0–100. Wird dieser Parameter nicht angegeben, wird 0 als Standard verwendet.
width Gibt die Breite in Prozent auf dem Zielbildschirm an, die das gehostete Steuerelement haben soll. Gültige Werte sind 1–100. Wird dieser Parameter nicht angegeben, wird 100 als Standard verwendet.
height Gibt die Höhe in Prozent auf dem Zielbildschirm an, die das gehostete Steuerelement haben soll. Gültige Werte sind 1–100. Wird dieser Parameter nicht angegeben, wird 100 als Standard verwendet.

Sucht nach Datensätzen in der Wissensverwaltung durch Übergeben der Suchzeichenfolge als Parameter.

Parameter Beschreibung
query Ein im gehosteten Steuerelement zu suchender Zeichenfolgenwert. Beispiel: query=contoso. Dies ruft alle Wissensdatenbankartikel von modellgesteuerten Apps oder ab, die Namen enthalten, die mit dem Begriff "contoso" starten.
Ergebnisse Ein ganzzahliger Wert, der die Anzahl der Suchergebnisse angibt, die im gehosteten Steuerelement angezeigt werden sollen. Beispielsweise werden bei Angabe von results=5 fünf Suchergebnisse im gehosteten Steuerelement angezeigt. Wenn kein Wert oder ein falscher Wert für diesen Datenparameter bereitgestellt wird, dann wird der Standardwert (10) verwendet. Der maximale Wert, der für diesen Datenparameter zulässig ist, ist 20.
Filter Ein ganzzahliger Wert, der den Typ des Wissensdatenbankartikels angibt, der im gehosteten Steuerelement angezeigt werden soll:

- 1: Alle (Standard)
- 2: Alle Entwürfe
- 3: Alle Veröffentlicht
- 4: Veröffentlicht-Privat
- 5: Published-Public
- 6: Veröffentlicht-Abgelaufen

Geben Sie z. B. filter=3 an, um nur veröffentlichte Wissensdatenbankartikel anzuzeigen.

Wenn kein Wert oder ein falscher Wert bereitgestellt wird, dann wird der Standardwert (1) verwendet.
blockClick Ein ganzzahliger Wert, der angibt, ob die Inline-Anzeige des Inhalts verhindert wird, wenn ein Suchergebnis im gehosteten Steuerelement geklickt wird. Legen Sie ihn auf 0 fest, um den Inhalt beim Klicken inline zu öffnen; und auf 1, um das Inline-Öffnen des Inhalts zu verhindern. Beispiel: blocked=1

Wenn kein Wert oder ein falscher Wert bereitgestellt wird, dann wird der Standardwert (0) verwendet. Wenn Sie den Wert auf "1" gesetzt haben, um den Inhalt zu sperren, wird das ResultOpen-Ereignis weiterhin ausgelöst.
Sortieren Ein ganzzahliger Wert, der die Sortierungsoptionen für die Wissensdatenbankartikel im Suchergebnis angibt:

- 1: Relevanz (Standard)
- 2: Bewertung
- 3: Anzahl der Aufrufe
- 4: Letztes Änderungsdatum (das älteste zuerst)
- 5: Letztes Änderungsdatum (das neueste zuerst)

Geben Sie z. B. sort=2 an, um die Artikel nach Bewertung zu sortieren.

Wenn kein Wert oder ein falscher Wert bereitgestellt wird, dann wird der Standardwert (1) für den Datenparameter verwendet.

SetArticleContext

Fügt dem aktuellen Wissensdatenbankartikel Daten in Wissensverwaltung hinzu.

Parameter Beschreibung
articleapplication Name des gehosteten Steuerelements, bei dem der Wissensdatenbankartikel angezeigt wird.
articledata Ein Artikeldatensatz-Objektwert, der vom ResultOpen-Ereignis übergeben wurde.

SetSearchProps

Aktiviert unterschiedliche Typen von Filtern für die Suche nach Wissensdatenbankartikeln in Wissensverwaltung.

Parameter Beschreibung
showFilter Gibt an, ob der Artikeltypfilter zum Durchsuchen von Wissensdatenbankartikeln aktiviert wird. Setzen Sie ihn auf 0, um den Filter auszublenden, und auf 1, um den Filter anzuzeigen. Beispiel: showFilter=1.

Wenn kein Wert oder ein falscher Wert bereitgestellt wird, dann wird der Standardwert (0) verwendet.
showLang Gibt an, ob der Sprachfilter zum Durchsuchen von Wissensdatenbankartikeln aktiviert wird. Setzen Sie ihn auf 0, um den Filter auszublenden, und auf 1, um den Filter anzuzeigen. Beispiel: showLang=1.

Wenn kein Wert oder ein falscher Wert bereitgestellt wird, dann wird der Standardwert (0) verwendet.
showDept Gibt an, ob der Abteilungsfilter zum Durchsuchen von Wissensdatenbankartikeln aktiviert wird. Setzen Sie ihn auf 0, um den Filter auszublenden, und auf 1, um den Filter anzuzeigen. Beispiel: showDept=1.

Wenn kein Wert oder ein falscher Wert bereitgestellt wird, wird der Standardwert (0) verwendet.

SetSize

Legt die Breite und Höhe des gehosteten Steuerelements fest. Dies ist besonders dann nützlich, wenn Sie in Ihren Bereichslayouts "Auto" verwenden.

Parameter Beschreibung
width Die Breite des gehosteten Steuerelements.
height Die Höhe des gehosteten Steuerelements.

SetUserCanClose

Ermöglicht dem Benutzer, das gehostete Steuerelement zu schließen, indem auf das X-Symbol oben rechts auf der Registerkarte des gehosteten Steuerelements geklickt wird.

Parameter Beschreibung
UserCanClose Setzen Sie dies auf true, damit der Benutzer das gehostete Steuerelement schließen kann. Setzen Sie es andernfalls auf false.

Vordefinierte Ereignisse

Das folgenden vordefinierten Ereignisse sind mit dem gehosteten Steuerelement dieses Typs verknüpft.

PopupRouted

Tritt auf, nachdem ein Popup vom System weitergeleitet wurde.

Parameter Beschreibung
url Die URL des Popup-Fensters, das weitergeleitet wurde.

ResultOpen

Tritt auf, wenn ein Suchergebnis zum Lesen von Inhalten geöffnet wird in Wissensverwaltung.

Parameter Beschreibung
postdata Das Formdata Objekt enthält Datensatz Schlüssel-Wertpaare für Formularfelder und deren Werte für einen Wissensartikel.

SearchComplete

Tritt auf, nachdem die Wissensdatenbank-Artikelsuche abgeschlossen ist, und die Suchergebnisse im gehosteten Steuerelement geladen wurden.

SelectionChange

Tritt auf, wenn ein Ergebnis in Wissensverwaltung ausgewählt ist.

Parameter Beschreibung
postdata Das Formdata Objekt enthält Datensatz Schlüssel-Wertpaare für Formularfelder und deren Werte für einen Wissensartikel.

Siehe auch

Nutzen Sie Wissen für eine effektive Kundenbindung.
Unified Service Desk für die Verwendung von modellgesteuerten Apps konfigurieren
Exemplarische Vorgehensweise 8: Verwendung von Wissensdatenbank innerhalb der Agent-Anwendung
Typen gehosteter Steuerelemente und Referenz zu Aktionen/Ereignissen