Haftungsausschluss: Dieser Artikel wurde durch maschinelle Übersetzung erstellt.

URL-Zuordnung

Prev Next

Pläne, die das Wissensdatenbank-Widget unterstützen

Professional
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 Knowledgebase-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 zur Registerkarte URL-Zuordnung im Widget () in der Knowledge base portal.

  2. 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 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.

  3. 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 im Knowledge base portalzu Widget ().

  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 Blatt 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 im Knowledge base portalzu Widget ().

  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 Widget () im Knowledge base portal > Konfigurieren und verbinden.

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

  3. 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.

  4. 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 Platzhaltern 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.