Haftungsausschluss: Dieser Artikel wurde durch maschinelle Übersetzung erstellt.

URL-Zuordnung

Prev Next

Pläne, die diese Funktion unterstützen: Business Enterprise

Mit der URL-Zuordnungsfunktion im Wissensdatenbank-Widget können Sie die Anzeige bestimmter Artikel und Kategorien basierend auf den von Ihren Endbenutzern besuchten Seiten anpassen. Diese Funktion verbessert nicht nur die Benutzererfahrung, indem sie Benutzer zu relevanten Inhalten leitet, sondern ermöglicht es Ihnen auch, das Wissensdatenbank-Widget auf bestimmten URLs auszublenden oder eine Suchleiste mit benutzerdefinierten Platzhaltern bereitzustellen, die Benutzer anleiten, was gesucht werden soll.


Verwenden der URL-Zuordnung

Um die URL-Zuordnung zu konfigurieren, führen Sie bestimmte Aktionen im Wissensdatenbank-Widget für bestimmte URLs aus.

Aktionen

Es gibt vier Aktionen, die Sie mit der URL-Zuordnung ausführen können:

  1. Artikel anzeigen: Zeigt einen einzelnen Artikel unter der angegebenen URL an.

  2. Liste der Artikel anzeigen: Listet ausgewählte Artikel im Abschnitt "Empfohlen " im Widget "Wissensdatenbank" unter der angegebenen URL auf.

  3. Suchergebnisse anzeigen: Ermöglicht es Ihnen, einen bestimmten Suchbegriff festzulegen, um Ihre Wissensdatenbank abzufragen und relevante Suchergebnisse unter der angegebenen URL zurückzugeben.

  4. Widget ausblenden: Verhindert, dass das Symbol des Wissensdatenbank-Widgets in der angegebenen URL angezeigt wird.

Sie finden diese Aktionen auf der Registerkarte URL-Zuordnung oder beim Bearbeiten einer vorhandenen Zuordnung.

ANMERKUNG

Damit die URL-Zuordnung funktioniert, muss das Wissensdatenbank-Widget auf Ihrer Website oder in Ihrer App installiert sein. Weitere Informationen finden Sie im Artikel auf Installing the Knowledge base widget.

URL-Parameter

Bei der Konfiguration der URL des Wissensdatenbank-Widgets können Sie drei Arten von Parametern einbeziehen:

  1. Pfad einschließen: /thisis/a/path

  2. Abfrage einschließen: ?animal=bear

  3. Hash einschließen: #inbox

Sie können auch den Umschalter Is Regex aktivieren, um reguläre Ausdrücke in Ihre URL-Konfigurationen zu integrieren.


Hinzufügen von URL-Mapping zu Ihrem Widget

Um das gewünschte Widget in Ihre Wissensdatenbank zu integrieren, gehen Sie folgendermaßen vor:

  1. Navigieren Sie zu Knowledge base Widget () in der linken Navigationsleiste Ihres Knowledge base portal.

  2. Klicken Sie auf die Registerkarte URL-Zuordnung .

  3. Klicken Sie auf Neue URL-Zuordnung , und geben Sie Folgendes an:

    • Name - Der Name der URL-Zuordnung wird nur im URL-Zuordnungsdatensatz in Document360 angezeigt.

    • URL-Struktur - Wählen Sie den gewünschten URL-Parametertyp aus (Pfad einschließen/Abfrage einschließen/Hash einschließen). Sie müssen mindestens einen URL-Parameter aktivieren

    • Geben Sie die URL ein, unter der der Artikel/die Kategorie angezeigt werden soll oder die Aktion ausgeführt werden soll.

      ANMERKUNG

      Ihr Domainname ist nicht im URL-Pfad enthalten. Zum Beispiel https://document360.com/ebook/rapid-guide-to-launch-your-knowledge-base/wäre Ihr URL-Pfad /ebook/rapid-guide-to-launch-your-knowledge-base/

    • Aktion - Wählen Sie die gewünschte Aktion aus.

    • Arbeitsbereich auswählen - Wählen Sie die gewünschte Version aus (wenn Sie mehrere Versionen haben).

    • Sprache bis - Wählen Sie die gewünschte Sprache aus (wenn Sie mehrere Sprachen haben).

    • Anzuzeigender Beitrag - Wählen Sie in der Suchleiste die Artikel/Kategorien aus, die Sie aus Ihrer Wissensdatenbank-Dokumentation anzeigen möchten.

    ANMERKUNG

    Ordnerkategorien stehen nicht zur Auswahl. Es stehen nur Seiten - und Indexkategorietypen zur Auswahl.

  4. Klicken Sie auf Erstellen.

1_URLmapping.gifSobald ein Endbenutzer auf den von Ihnen angegebenen URL-Pfad zugreift und das Widget "Wissensdatenbank" öffnet, wird der zugeordnete Artikel/die zugeordnete Kategorie angezeigt. Diese Informationen bleiben konsistent, wenn sie zwischen den Registerkarten des Wissensdatenbank-Widgets in derselben Version und Sprache navigieren.


Bearbeiten der URL-Zuordnung

So ändern Sie eine vorhandene URL-Zuordnung:

  1. Navigieren Sie zu Knowledge base Widget () in der linken Navigationsleiste Ihres Knowledge base portal.

  2. Bewegen Sie den Mauszeiger über das gewünschte Wissensdatenbank-Widget und klicken Sie auf das Symbol Bearbeiten ().

    Auf der Registerkarte URL-Mapping finden Sie die Liste der verfügbaren URL-Mappings.

  3. Bewegen Sie den Mauszeiger über die gewünschte URL-Zuordnung und klicken Sie auf das Symbol Bearbeiten ().

    Das Fenster "URL-Zuordnung aktualisieren " wird angezeigt.

  4. Aktualisieren Sie die gewünschten Informationen und klicken Sie auf Aktualisieren.

2_urlmapping_edit.gif


Löschen der URL-Zuordnung

Sie können eine festgelegte URL-Zuordnung löschen.

3_urlmapping_delete.png

  1. Navigieren Sie zu Wissensdatenbank-Widget () in der linken Navigationsleiste Ihrer Knowledge base portal.

  2. Bewegen Sie den Mauszeiger über das gewünschte Wissensdatenbank-Widget und klicken Sie auf das Symbol Bearbeiten ().

  3. Auf der Registerkarte URL-Mapping finden Sie die Liste der verfügbaren URL-Mappings.

  4. Bewegen Sie den Mauszeiger über die gewünschte URL-Zuordnung und klicken Sie auf das Symbol Löschen ().

  5. Klicken Sie in der Löschbestätigungsaufforderung auf Ja.


Einstellungen für die URL-Zuordnung

Sie können das Verhalten des Wissensdatenbank-Widgets für URLs definieren, für die keine Zuordnung konfiguriert ist. Das Definieren dieses Verhaltens kann die Benutzerfreundlichkeit und den Zugriff auf die Dokumentation verbessern.

4_urlmapping_settings.png

  1. Navigieren Sie zu Knowledge base Widget () in der linken Navigationsleiste Ihres Knowledge base portal.

  2. Klicken Sie auf die Registerkarte Konfigurieren und verbinden .

  3. Erweitern Sie im Abschnitt Steuerelemente festlegen den Abschnitt URL-Zuordnungseinstellungen .

  4. Wählen Sie die gewünschte Option aus:

    • Zur Seitenhilfe/Wissensdatenbank navigieren: Wählen Sie diese Option aus, um den Artikel/die Kategorie in der Seitenhilfe oder auf der Registerkarte Wissensdatenbank im Widget anzuzeigen.

    • Nehmen Sie keine Änderungen an der bestehenden Einrichtung vor: Wählen Sie diese Option, um den zuletzt geöffneten Artikel/die zuletzt geöffnete Kategorie im Widget anzuzeigen.

  5. Klicken Sie auf Speichern.


Grundlegender URL-Abgleich

Das Verständnis des URL-Abgleichs ist entscheidend für ein effektives URL-Mapping. Ein allgemeiner Regex für den Abgleich typischer URLs sieht folgendermaßen aus:

^https?://?[a-zA-Z0-9.-]+/[a-zA-Z0-9/._-]*??[a-zA-Z0-9=&._-]*?#[a-zA-Z0-9_-]*?$

Erläuterung der Bestandteile

  • ^https?://?: Entspricht dem Protokoll (z. B http:// . oder https://). Das ? macht das Protokoll optional.

    ANMERKUNG

    Stellen Sie sicher, dass Sie vor jedem Schrägstrich (/) einen umgekehrten Schrägstrich (\) hinzufügen, während Sie Ihre URL auf https://regex101.com testen.

  • [a-zA-Z0-9.-]+: Entspricht dem Domainnamen, einschließlich Buchstaben, Zahlen, Punkten (.) und Bindestrichen (-).

  • /[a-zA-Z0-9/._-]*?: Stimmt mit dem Pfad nach der Domäne überein und lässt Schrägstriche, alphanumerische Zeichen, Punkte, Unterstriche und Bindestriche zu.

  • ?[a-zA-Z0-9=&._-]*?: Stimmt mit optionalen Abfrageparametern überein (z. B ?key=value. ), wodurch dieser Teil optional wird.

  • #[a-zA-Z0-9_-]*?: Stimmt mit dem Fragment überein (z. B #section. ), was ebenfalls optional ist.


Beispiele für URL-Mapping mit Regex

Zuordnen von URLs zu bestimmten Pfaden

Um ein URL-Muster wie /users/{id}zuzuordnen, verwenden Sie Folgendes:

^/users/[0-9]+$

Dadurch wird eine Benutzer-ID dynamisch erfasst.

Beispiel-Matches

  • /users/123

  • /users/456

Zuordnen von URLs mit Abfrageparametern

Für URLs wie /search?q={query}wäre der reguläre Ausdruck wie folgt:

^/search?q=[a-zA-Z0-9]+$

Beispiel-Matches

  • /search?q=apple

  • /search?q=123abc

Zuordnen von URLs mit optionalen Parametern

Für ein URL-Muster wie /products/{category}/{id}, wobei category optional ist:

^/products/[a-zA-Z]+?/[0-9]+$

Beispiel-Matches

  • /products/123

  • /products/electronics/123

Zuordnen von URLs mit einem Platzhalter oder mehreren Pfaden

Für /blog/*:

^/blog/.*?$

Beispiel-Matches

  • /blog

  • /blog/how-to-code

  • /blog/2021/10

Zuordnen von URLs zu Subdomains
Für Subdomain-URLs:

^https?://?[a-zA-Z0-9-]+.example.com$

Beispiel-Matches

  • http://blog.example.com

  • https://shop.example.com

Kombinieren mehrerer Komponenten

Um komplexere URL-Mappings zu bewältigen, können Sie die verschiedenen Komponenten nach Bedarf kombinieren. Der umfassende reguläre Ausdruck, der einer URL mit einem optionalen Protokoll, einer Domäne, einem Pfad, Abfrageparametern und einem Fragment entspricht, sieht wie folgt aus:

^https?://?[a-zA-Z0-9.-]+/[a-zA-Z0-9/._-]*??[a-zA-Z0-9=&._-]*?#[a-zA-Z0-9_-]*?$

Häufig gestellte Fragen

Wie kann ich die Seitenhilfe und die Suchleiste aus dem Widget entfernen, wenn die URL-Zuordnung für einen einzelnen Beitrag konfiguriert ist?

So entfernen Sie die Seitenhilfe und die Suchleiste aus dem Widget, wenn die URL-Zuordnung für einen einzelnen Beitrag konfiguriert ist:

  1. Navigieren Sie im Wissensdatenbank-Portal zu Widget ().

  2. Bewegen Sie den Mauszeiger über das gewünschte Widget und klicken Sie auf das Symbol Bearbeiten ().

  3. Fügen Sie den bereitgestellten Code auf der Registerkarte Benutzerdefiniertes CSS ein:

    li#page-help-tab {
        display: none;
    }
    
    .article-header .article-back-icon {
        display: none;
    }
    
    .search-container {
        display: none !Important;
    }
  4. Fügen Sie den bereitgestellten Code auf der Registerkarte Benutzerdefiniertes JavaScript ein:

    setTimeout(function() { $('.search-container').hide();}, 2000);
    setTimeout(function() { $("#knowledge-base-tab").click();}, 2000);
  5. Klicken Sie auf Speichern.

Dadurch werden die Registerkarte "Seitenhilfe" und die Suchleiste im Widget auf der Wissensdatenbank-Website ausgeblendet, wenn die URL-Zuordnung für einen einzelnen Beitrag konfiguriert ist.

Wie kann ich die Aktualisierungen sofort im KB-Widget sehen, nachdem ich eine URL-Map hinzugefügt oder aktualisiert habe?

Die Updates werden aus Performance-Gründen auf dem Server zwischengespeichert und automatisch alle 15 Minuten aktualisiert. Wenn Sie die Änderungen jedoch sofort sehen müssen, können Sie den Anwendungscache leeren.

Warum wird eine konfigurierte URL-Zuordnung als fehlerhaft angezeigt?

Die URL-Zuordnung würde aufgrund von Änderungen in der Konfiguration "Widget-Inhalt filtern" auf der Registerkarte "Installation & Setup" unterbrochen. Überprüfen Sie die URL-Zuordnung, und aktualisieren Sie die Konfiguration.

Was ist URL-Mapping?

Mit der URL-Zuordnung können Sie festlegen, dass bestimmte Artikel und Kategorien im Wissensdatenbank-Widget angezeigt werden, je nachdem, auf welcher Seite sich der Endbenutzer befindet. Sie können die URL-Zuordnung auch verwenden, um das Wissensdatenbank-Widget unter einer bestimmten URL auszublenden, oder eine Suchleiste mit einem benutzerdefinierten Platzhalter bereitstellen, um Endbenutzer in die richtige Richtung zu weisen, was gesucht werden soll.

Kann ich reguläre Ausdrücke (Regex) in der URL-Zuordnung hinzufügen?

Sie können reguläre Ausdrücke in Ihre URL einschließen, indem Sie den Schalter Is Regex aktivieren.

Was ist Regex?

Regex, kurz für "regulärer Ausdruck", ist eine Zeichenfolge mit der Definition eines Suchmusters, das zum Abgleichen und Bearbeiten von Textzeichenfolgen verwendet wird.

Sie können z. B. Regex verwenden, um eine einzelne URL-Zuordnung für mehrere Artikel mit ähnlichen URLs zu konfigurieren. Stellen Sie sich ein Szenario vor, in dem Sie die URL-Zuordnung für die folgenden Artikel mit der Basis-URL konfigurieren möchten 'https://example.com/docs/drive':

  • https://example.com/drive-General

  • https://example.com/drive-settings

  • https://example.com/drive-functionA

  • https://example.com/drive-functionB

  • https://example.com/drive-functionC

  • https://example.com/drive-functionD

  • https://example.com/drive-functionE

Ohne regulären Ausdruck müssten Sie für jede URL individuelle URL-Zuordnungen hinzufügen. Wenn Sie jedoch Regex aktivieren, können Sie mit einer einzigen URL-Zuordnung hinzufügen: Wählen Sie die Option "Pfad einschließen" aus und fügen Sie sie im URL-Feld hinzu docs/drive . Sie können Regex verwenden, um einen effizienteren und optimierten Zuordnungsprozess zu erzielen.

Kann ich eine URL-Zuordnung für Kategorien hinzufügen?

Ja, Sie können eine URL-Zuordnung für Kategorien hinzufügen. Sie gilt nur für Seiten- und Indexkategorien.