Benutzerhandbuch Abbrechen

Veröffentlichen in der ServiceNow-Wissensdatenbank

  1. Benutzerhandbuch zu RoboHelp
  2. Einführung
    1. Erste Schritte im RoboHelp-Arbeitsbereich
    2. Neuerungen bei RoboHelp (2022 release)
      1. Neuerungen in Update 5
      2. Neuerungen in Update 4
      3. Neuerungen in Update 3
      4. Neuerungen in Update 2
      5. Neuerungen in Update 1
    3. Behobene Probleme in RoboHelp
    4. Systemanforderungen für RoboHelp
    5. Herunterladen von RoboHelp für Windows und macOS
    6. Herunterladen und Installieren der Adobe-App
    7. Häufig gestellte Fragen zu RoboHelp
    8. Neuerungen bei RoboHelp (2020 release)
      1. Neuerungen in Update 8
      2. Neuerungen in Update 7
      3. Neuerungen in Update 6
      4. Neuerungen in Update 5
      5. Neuerungen in Update 4
      6. Neuerungen in Update 3
      7. Neuerungen in Update 2
      8. Neuerungen in Update 1
  3. Projekte
    1. Planen Ihres RoboHelp-Projekts
    2. Erstellen eines Projekts
    3. Verwalten von Projekten
    4. Arbeiten mit Themen und Ordnern
    5. Generieren von Berichten
    6. Arbeiten mit kontextsensitiver Hilfe
    7. Verwalten von Verweisen
    8. Festlegen von Einstellungen in RoboHelp
  4. Zusammenarbeit mit Autoren
    1. Zusammenarbeit mithilfe von Git
    2. Zusammenarbeit mithilfe von SharePoint Online
    3. Zusammenarbeit mit von Azure DevOps (Team Foundation Server)
  5. PDF-Layout
    1. PDF-Vorlagen
    2. Designen eines Seitenlayouts
    3. PDF-Ausgabe veröffentlichen
    4. Arbeiten mit den gängigen Inhaltsstilen
    5. Komponenten einer PDF-Vorlage
    6. Unterstützung für Sprachvariablen
    7. Anpassen von PDFs
  6. Bearbeiten und Formatieren
    1. Formatieren Ihres Inhalts
    2. Erstellen und Verwalten von Querverweisen
    3. Erstellen und Verwalten von Verknüpfungen
    4. Snippets als Einzelquellenelemente
    5. Arbeiten mit Bildern und Multimedia
    6. Erstellen und Verwenden von Variablen für einfache Updates
    7. Arbeiten mit Variablensätzen
    8. Verwenden des Tools „Suchen und Ersetzen“
    9. Automatisches Speichern Ihrer Inhalte
    10. Bearbeitung nebeneinander in der geteilten Ansicht
    11. Verwenden der Rechtschreibprüfungsfunktion
    12. Erstellen und Bearbeiten von Lesezeichen
    13. Einfügen und Aktualisieren von Feldern
    14. Wechseln zwischen mehreren Ansichten
    15. Automatische Nummerierung in CSS
  7. Importieren und Verknüpfen
    1. Importieren von Markdown-Dateien in ein Projekt
    2. Importieren von Word-Dokumenten in ein Projekt
    3. Importieren von FrameMaker-Dokumenten in ein Projekt
  8. Inhaltsverzeichnisse, Indizes, Glossare und Zitate
    1. Erstellen und Verwalten von Inhaltsverzeichnissen
    2. Erstellen und Verwalten von Indizes
    3. Erstellen und Verwalten eines Glossars
    4. Erstellen und Verwalten von Zitaten
    5. Abfolgen erstellen und verwalten
    6. Arbeiten mit „Siehe auch“ und verwandten Themen
  9. Bedingter Inhalt
    1. Was ist bedingter Inhalt?
    2. Bedingungs-Tags erstellen und anwenden
    3. Konfigurieren von Ausgabevorgaben für bedingten Inhalt
    4. Bedingten Inhalt optimieren und verwalten
  10. Microcontent
    1. Microcontent
  11. Überprüfung und Zusammenarbeit
    1. Überprüfung und Zusammenarbeit
  12. Übersetzung
    1. Übersetzen von Inhalten in mehrere Sprachen
    2. Konfigurieren eines Übersetzungsframeworks für einen Dienstleister
  13. Generieren der Ausgabe
    1. Generieren der Ausgabe
    2. Generieren einer Frame-los-Ausgabe
    3. Generieren der Wissensdatenbankausgabe
    4. Generieren von PDF-Ausgabe
    5. Generieren einer interaktiven HTML5-Ausgabe
    6. Generieren einer Worddokument-Ausgabe
    7. Generieren einer „Nur Inhalt“-Ausgabe
    8. Generieren einer E-Book-Ausgabe
    9. Generieren einer Microsoft HTML Help-Ausgabe in RoboHelp
    10. Generieren einer App-Ausgabe
  14. Ausgabe veröffentlichen
    1. Veröffentlichen auf einem RoboHelp-Server
    2. Veröffentlichen auf einem FTP-Server, einem sicheren FTP-Server oder einem Dateisystem
    3. Veröffentlichen in SharePoint Online
    4. Veröffentlichen im Zendesk-Hilfe-Center
    5. Veröffentlichen in der Salesforce-Wissensdatenbank
    6. Veröffentlichen in der ServiceNow-Wissensdatenbank
    7. Veröffentlichen in der Zoho-Wissensdatenbank
    8. Veröffentlichen in Adobe Experience Manager
    9. Veröffentlichen in der Atlassian Confluence-Wissensdatenbank
  15. Anhang
    1. Adobe RoboHelp Scripting-Referenz
    2. RoboHelp-Tastaturbefehle

Erfahren Sie, wie Sie Ihre Inhalte direkt in der ServiceNow-Wissensdatenbank veröffentlichen.

Musterseiten, die in der PDF- oder Word-Ausgabevorlage verwendet werden, wurden in "Seitenlayout" umbenannt.

Musterseiten, die für Themenvorlagen oder Onlineausgaben verwendet werden, wurden in "Themenlayouts" umbenannt.

Weitere Informationen finden Sie unter Vorlagen in Adobe RoboHelp.

Mit der ServiceNow-Integration hat Adobe RoboHelp seine Veröffentlichungsfunktionen erweitert, um die Veröffentlichung in Wissensdatenbankausgaben direkt in der Wissensdatenbank als KBs vorzunehmen.

Voraussetzungen

Bevor Sie beginnen, Wissensdatenbanken und Wissensartikel zu erstellen, müssen Sie ServiceNow Knowledge Management einrichten. Um ein Setup unter Anleitung durchzuführen, beachten Sie die folgenden Punkte:

  • Schritt-für-Schritt-Anleitung zum Konfigurieren von ServiceNow Knowledge Management in Ihrer Instanz.Weitere Informationen finden Sie unter Nutzen des Setups unter Anleitung.
  • Rechte zum Erstellen und Veröffentlichen für ServiceNow-Artikel (kb_knowledge-Tabelle CRUD Operation-Rechte). Weitere Informationen finden Sie unter Erstellen eines Wissensartikels.
  • Um Schlüsselwörter als Tags zu verwenden, zusätzliche Berechtigungen zum Erstellen und Schreiben von „label_entry.table“ und „lable_entry.table_key“. Weitere Informationen finden Sie unter Verwalten von Tags.

Einrichten des Workflows

Im Folgenden finden Sie die Schritte zum Konfigurieren der ServiceNow-Wissensdatenbank Base vor der Veröffentlichung Ihrer Ausgabe.

Ausgabevorgabe erstellen

So erstellen Sie eine Ausgabevoreinstellung in RoboHelp:

  1. Führen Sie in einem geöffneten Projekt einen der folgenden Schritte aus:

    • Klicken Sie auf der linken Seite der Standardsymbolleiste auf die Registerkarte Ausgabe.
    • Klicken Sie in der Standardsymbolleiste in der rechten oberen Ecke auf Schnell erstellen  und dann auf das Symbol Einstellungen bearbeiten .

    Die Ansicht „Ausgabe“ wird geöffnet.

  2. Klicken Sie in der Symbolleiste „Ausgabe“ auf Ausgabevorgaben.Daraufhin wird der Bereich „Ausgabevorgaben“ geöffnet.

  3. Klicken Sie im Bereich Ausgabevorgaben auf .

  4. Geben Sie im Dialogfeld „Neue Vorgabe“ die folgenden Optionen an:

    Typ Wählen Sie in der Dropdown-Liste den voreingestellten Wissensdatenbank-Typ aus.

    Name Geben Sie einen Namen für die Ausgabevorgabe an.

    Ziel Wählen Sie in der Ziel-Dropdown-Liste ServiceNow-Wissensdatenbank.

  5. Klicken Sie auf Fertig.

    Sie haben im Bereich Ausgabevorgaben in der Symbolleiste Ausgabe Zugriff auf die Ausgabevorgaben. Stattdessen können Sie auch im Dialogfeld Schnell erstellen des Authoring-Fensters auf die Ausgabevorgabe zugreifen.

Konfigurieren einer ServiceNow-Wissensdatenbank-Ausgabevoreinstellung

Sie können mit den folgenden Einstellungen die Ausgabevorgabe Wissensdatenbank konfigurieren:

Allgemein

Geben Sie mit den folgenden Optionen grundlegende Ausgabeeinstellungen wie Titel, Ausgabepfad, Kodierung usw. an.

Titel Geben Sie den Titel für die generierte Ausgabe an.

Sie können Variablen im Titel verwenden. Geben Sie dazu STRG+1 ein, und wählen Sie eine Variable aus der Dropdown-Liste aus. Drücken Sie anschließend die Eingabetaste. Wenn Sie während der Ausgabegenerierung einen Variablensatz auf der Registerkarte „Inhalt > Variablensatz“ angegeben haben, wird der Wert der ausgewählten Variablen aus dem Variablensatz ausgewählt.

Ziel Wählen Sie in der Dropdown-Liste „ServiceNow-Wissensdatenbank“ zum Generieren der ausgewählten Ausgabe.

Ausgabepfad Geben Sie einen Speicherort für die Ausgabe an. Um einen Speicherort auszuwählen, klicken Sie auf .

Stellen Sie sicher, dass sich der Ausgabepfad NICHT im Projektordner befindet.Wenn sich der Ausgabepfad im Projektordner befindet, schlägt die Ausgabegenerierung fehl. Außerdem sollte der von Ihnen ausgewählte Ordner KEINE Inhalte enthalten, die Sie benötigen. RoboHelp löscht den Inhalt des Ordners, bevor die Ausgabe generiert wird.

Ausgabepfad relativ zum Projekt speichern: Wenn diese Option aktiviert ist und Sie zum Ausgabepfad navigieren, ist der Pfad zur Ausgabe nun ein relativer statt ein absoluter Wert. 

Kodierung Wählen Sie in der Dropdown-Liste den Typ des Zeichenkodierungsformats aus, der für Ihren Inhalt verwendet werden soll.

Skript nach der Generierung Um Ihr benutzerdefiniertes Skript nach der Ausgabegenerierung auszuführen, wählen Sie die .js-Skriptdatei in der Dropdownliste aus.

Inhalt

Geben Sie mit den folgenden Optionen inhaltsbezogene Ausgabeeinstellungen wie die Einstellungen für Inhaltsverzeichnis, Bedingungsausdruck und Variablensatz an.

Inhaltsverzeichnis Wählen Sie in der Dropdownliste das Inhaltsverzeichnis aus, das in der Ausgabe enthalten sein soll. Diese Dropdownliste zeigt die in Ihrem Projekt verfügbaren Inhaltsverzeichnisse an. Das erste Inhaltsverzeichnis in dieser Dropdownliste ist standardmäßig ausgewählt.

Der Satz von Dateien und ihre Referenzen, die im ausgewählten Inhaltsverzeichnis enthalten sind, werden in der generierten Ausgabe angezeigt.

Bedingungsausdruck Geben Sie mithilfe der Dropdownliste den Bedingungsausdruck für Ihre Ausgabe an. Mit dieser Einstellung können Sie Inhalte abhängig vom gewünschten Ausgabetyp oder von der Benutzerbasis einfach ein- oder ausschließen. Klicken Sie auf , um den ausgewählten Bedingungsausdruck zu bearbeiten. Sie können in der Dropdown-Liste auch „Keine“ auswählen, um keinen Bedingungsausdruck anzugeben.

Variablensatz Geben Sie mithilfe der Dropdownliste den Variablensatz für Ihre Ausgabe an. In der Dropdownliste können Sie <Standardvariablensatz> auswählen, um den Standardvariablensatz des Projekts zu verwenden. Mit Variablensätzen können Sie die ausgabenspezifische Verwendung von Variablen implementieren.Sie können beispielsweise verschiedene Variablensätze zum Generieren von Ausgaben für Kunden und interne Benutzer verwenden.

Erweiternde Textinhalte einschließen Diese Option ist für das Veröffentlichen in der ServiceNow-Wissensdatenbank nicht gültig.

Inhalt des Dropdowntexts einbeziehen Diese Option ist für das Veröffentlichen in der ServiceNow-Wissensdatenbank nicht gültig.

Hinweis:

Beachten Sie unbedingt, dass ServiceNow das Hinzufügen von JavaScript oder Cascading Style Sheets (CSS) in den Artikeln nicht zulässt, sodass Ihre Publikation keinen Dropdowntext, Expanding-Text oder Miniaturbilder enthalten darf. Wenn sie jedoch verwendet werden, wird der eingeschlossene Text als einfacher Text beibehalten.

Layout

ServiceNow

Geben Sie mit den folgenden Optionen ServiceNow-Veröffentlichungseinstellungen an, z. B. „Veröffentlichungsprofil“, „RecordType“, „Kategorien“:

Veröffentlichungsprofil Wählen Sie in der Dropdown-Liste Ihr ServiceNow-Verbindungsprofil aus. Informationen zum Erstellen eines Veröffentlichungsprofils finden Sie unter Konfigurieren von Veröffentlichungsprofilen.

Wissensdatenbank Wählen Sie mit diesem Feld die erforderliche ServiceNow-Wissensdatenbank aus.

Der Benutzer kann „Wissensdatenbank“ auf der ServiceNow-Website konfigurieren, um den Inhalt basierend auf den Berechtigungen zu speichern.Alle aus diesem Projekt veröffentlichten Artikel können in diesen Wissensdatenbanken veröffentlicht werden. 

Alle Artikel in derselben Kategorie veröffentlichen Wählen Sie diese Option aus, um alle Themen des Inhaltsverzeichnisses in einer einzigen Kategorie und einem Abschnitt auf der ServiceNow-Website zu veröffentlichen.

Alle Stile in Inlinestile umwandeln Wählen Sie diese Option aus, um sicherzustellen, dass die in RoboHelp verwendete Stile beibehalten werden, wenn Sie Ihre Ausgabe in der ServiceNow-Wissensdatenbank veröffentlichen.

Schlüsselwörter aus Thema als Artikel-Tags verwenden Verwenden Sie Tags zum Filtern und Anzeigen markierter Artikel. Wählen Sie diese Option aus, um Ihre Artikel mit Schlüsselwörtern zu markieren.

ServiceNow verwendet Artikel-Tags mit Ihren Schlüsselwörtern. Tags können für jeden Benutzer (global), nur für bestimmte Gruppen oder Benutzer (gemeinsam genutzt) oder für einen einzelnen Benutzer (privat) sichtbar sein.

Beispielsweise können in einem Artikel über das Einrichten der Übersetzung in mehreren Sprachen die folgenden Systemtags angewendet werden: „Übersetzung“, „mehrere“, „Sprachen“ usw. Beim Suchen oder Durchsuchen eines Artikels können Benutzer auf ein Tag klicken, um ihre Suchergebnisse zu verfeinern.

Hochladen als Entwurf Wählen Sie diese Option aus, um das Thema zur Freigabe als Entwurf hochzuladen, bevor Sie es den Benutzern zur Verfügung stellen.

Bilder hochladen Wählen Sie diese Option aus, wenn Bilder in Themen in die veröffentlichte Ausgabe aufgenommen werden sollen.

Verknüpfte Dokumente hochladen Wählen Sie diese Option, wenn in Themen verknüpfte Dokumente wie PPT, PPTX, DOC, DOCX und PDF in die veröffentlichte Ausgabe aufgenommen werden sollen.

Konfigurieren von Veröffentlichungsprofilen

Sie müssen ein Profil erstellen und konfigurieren, bevor Sie Ihre Ausgabe in der ServiceNow-Wissensdatenbank veröffentlichen. So erstellen und konfigurieren Sie ein Profil:

  1. Wählen Sie Bearbeiten > Veröffentlichungsprofile.

    Das Dialogfeld Veröffentlichungseinstellungen wird geöffnet.

  2. Klicken Sie auf , um ein Profil zu erstellen.

  3. Wählen Sie im Feld Servertyp die Option ServiceNow-Wissensdatenbank.

  4. Führen Sie für den Servertyp ServiceNow-Wissensdatenbank folgende Schritte aus:

    • Name Zeigt den Standardprofilnamen an. Ändern Sie gegebenenfalls den Namen.
    • Website-URL Fügen Sie einen Websitenamen hinzu, um die Website-URL abzuschließen. 
                   Beispiel: https://devInstance.service-now.com
  5. Klicken Sie auf Speichern.

    RoboHelp speichert das Profil und zeigt den Profilnamen in der Spalte Profile an. Um ein Profil zu bearbeiten, klicken Sie auf den Profilnamen und bearbeiten Sie die Felder. Um ein Profil zu löschen, klicken Sie für die Farbe auf .

Konfigurieren der Struktur des Inhaltsverzeichnisses für die ServiceNow-Wissensdatenbank

Im letzten Schritt vor der Veröffentlichung überprüfen Sie, ob Ihr Inhaltsverzeichnis dazu organisiert ist, Ihre Inhalte in Kategorien und Abschnitten zu veröffentlichen, wobei Sie die folgenden Richtlinien berücksichtigen:

  • Da die oberste Ebene des Inhaltsverzeichnisses in Kategorien und die zweite Ebene in Abschnitte konvertiert wird, sollten Sie ein zweistufiges Inhaltsverzeichnis erstellen.
  • Veröffentlichte Artikel, die nicht in diese Struktur fallen, werden in Kategorien und Abschnitte umgeordnet.
Zweistufiges Inhaltsverzeichnis
Eine Illustration des zweistufigen Inhaltsverzeichnisses

Veröffentlichen in der ServiceNow-Wissensdatenbank

Sie können die Ausgabevoreinstellung Wissensdatenbank so konfigurieren, dass sie mit ServiceNow verknüpft ist, und dann Ihre Inhalte in der ServiceNow-Wissensdatenbank veröffentlichen.

  1. Klicken Sie auf die Registerkarte Ausgabe in der Standard-Symbolleiste.In der Symbolleiste Ausgabevorgaben ist die Standardauswahl in der Ausgabesymbolleiste. 

  2. Doppelklicken Sie im Bereich Ausgabevorgaben auf eine Ausgabevoreinstellung, um sie zu bearbeiten.

  3. Klicken Sie im Ausgabevoreinstellungseditor auf die Registerkarte Veröffentlichen, um das in der ServiceNow-Registerkartenkonfiguration ausgewählte Profil anzuzeigen.

    Sie können die Serverinformationen auch im Dialogfeld Profil veröffentlichen bearbeiten, das Sie durch Klicken auf starten können. 

  4. Wählen Sie die Profile (Server) aus, auf denen Sie Inhalte veröffentlichen möchten.

  5. Klicken Sie im Bereich „Ausgabevorgaben“ auf das Symbol „Vorgabe generieren“ 

    Sie können dann einen Fortschrittsbalken neben der ausgewählten Ausgabevorgabe im Bereich „Ausgabevorgaben“ anzeigen. Sobald die Ausgabegenerierung abgeschlossen ist, wird in der unteren rechten Ecke des Bildschirms das Dialogfeld „Erfolg“ angezeigt. 

    Klicken Sie nach Abschluss der Ausgabegenerierung im Bereich „Ausgabevorgaben“ auf , um die Ausgabe anzuzeigen.

  6. Um in den ausgewählten Profilen (Servern) zu veröffentlichen, klicken Sie auf die Ausgabevorgabe und dann in der Standardsymbolleiste auf . Oder klicken Sie mit der rechten Maustaste auf die Ausgabevorgabe, und klicken Sie auf „Veröffentlichen“.

  7. RoboHelp pusht den Inhalt an ServiceNow. Um die veröffentlichte Ausgabe anzuzeigen, klicken Sie auf das -Symbol, um zur Landingpage der ServiceNow-Wissensdatenbank zu gelangen, wo Sie zu Ihrem Artikel navigieren können.

  8. Um die veröffentlichte Ausgabe anzuzeigen, klicken Sie auf das -Symbol, um zur Landingpage der ServiceNow-Wissensdatenbank zu gelangen, wo Sie zu Ihrem Artikel navigieren können.

Schneller und einfacher Hilfe erhalten

Neuer Benutzer?