Dialogfenster Schlüssel und Schlüsselreferenzen
Dieses Dialogfenster ermöglicht es Ihnen, Informationen zu den Schlüsseldefinitionen und den Schlüsselreferenzen in einer DITA-Map anzuzeigen, sowie die Themen und Zuordnungen, auf die die Zuordnung referenziert. Wenn der Schlüsselkontext für die aktuelle Zuordnung auf eine andere DITA-Map festgelegt ist, gelten die Informationen im Dialogfenster für die Zuordnung, die Schlüsselkontext ist, nicht für die aktuelle Zuordnung. Sie können dieses Dialogfenster auch in einem DITA-Thema öffnen. In diesem Fall enthält es nur Informationen über die Schlüsselreferenzen, die in diesem Thema enthalten sind, sowie die zugehörigen Informationen für diese Referenzen, wie sie in der Zuordnung definiert sind, die den aktuellen Schlüsselkontext bildet. Wenn es länger als einige Sekunden dauert, die Schlüsselinformationen zu sammeln und im Dialogfenster auszugeben, wird eine Statusanzeige angezeigt.
Beachten Sie, dass eine Schlüsselreferenz einen aktiven Schlüsselkontext haben muss und dass der zugehörige Schlüssel in diesem Kontext definiert sein muss, damit eine Schlüsselreferenz Informationen über ihre Schlüsseldefinition enthalten kann. Ein Schlüsselkontext ist eine DITA-Map, die Schlüsseldefinitionen enthält. Der Wert, der der set-Option ditakeycontext zugewiesen ist, bestimmt den Schlüsselkontext für ein Dokument. Diese Option kann explizit oder in bestimmten Fällen von Arbortext Editor automatisch festgelegt werden. Wenn Sie beispielsweise ein referenziertes Thema aus einer Zuordnung öffnen, die Schlüsseldefinitionen enthält, wird diese Zuordnung zum Schlüsselkontext.
Sie können dieses Dialogfenster in der Menüauswahl > aufrufen. Sie können auch die Menüoption Schlüsselreferenzen suchen im Menü Extras und im Kontextmenü verwenden, um dieses Dialogfenster in einer DITA-Map nur für die in dem Tag, der den Cursor enthält, definierten Schlüssel zu öffnen.
Das Dialogfenster Schlüssel und Schlüsselreferenzen enthält folgende Optionen:
• Schlüssel- und Schlüsselreferenzinformationen – Enthält Informationen über die Schlüsseldefinitionen und die zugehörigen Schlüsselreferenzen in dem aktuellen Dokument.
In diesem Bereich des Dialogfensters werden die in der Zuordnung festgelegten Schlüsseldefinitionen aufgelistet, wie auf die Stellen, an der diese Schlüssel in den Dokumenten verwendet werden, auf die von der Zuordnung referenziert wird. Hier werden auch alle anderen Schlüsselreferenzen angezeigt, die in den Dokumenten festgelegt sind, die von der aktuellen Zuordnung referenziert werden, und denen im aktuellen Schlüsselkontext keine Schlüsseldefinition zugeordnet ist. Für Schlüssel mit Definitionen und Schlüsselreferenzen können Sie in der Struktur auf die Definition oder Referenz klicken, um sie auszuwählen und dann die Schaltfläche Gehe zu verwenden, um das Dokument zu öffnen, das diese Schlüsseldefinitionen oder Schlüsselreferenzen enthält.
Bei Schlüsseln mit Definitionen wird ein Schlüsselsymbol angezeigt

, gefolgt vom Namen des Schlüssel und dem Wert des Attributs
href in der Definition. Wenn die Zuordnung oder die Dokumente, die von der Zuordnung referenziert werden, Referenzen zu diesem Schlüssel enthalten, werden diese Referenzen unter der Schlüsseldefinition eingefügt. Sie können die Liste der Referenzen unter dem Schlüssel erweitern und minimieren. Das Element, das die aufgelistete Schlüsselreferenz enthält, wird durch folgende Symbole angezeigt:
◦ 
– Zeigt eine Topic-Referenz an (
topicref).
Für diese und die anderen Schlüsselreferenzen (im Attribut keyref) folgt dem Symbol der Name des Elements, das die Schlüsselreferenz enthält, gefolgt vom Dateinamen des Dokuments, das die Schlüsselreferenz enthält. Wenn das Dokument, das die Referenz enthält, ein Content-Management-System (CMS) ist und nicht das Dateisystem, ist der Name entweder der CMS-Objektname oder die logische ID.
◦ 
– Zeigt einen Querverweis
xref oder
link an.
◦ 
– Zeigt ein
image an.
◦ 
– Zeigt eine Inhaltsschlüsselreferenz an.
Für Inhaltsschlüsselreferenzen (im Attribut conkeyref) folgt dem Symbol der Name des Elements im Dokument, das das Ziel der Inhaltsreferenz ist, gefolgt vom Dateinamen des Dokuments, das die Referenz enthält, gefolgt von conkeyref.
Bei Schlüsselreferenzen, denen keine Definition zugeordnet ist, wird ein Schlüsselsymbol mit einem roten x angezeigt

, gefolgt vom Namen des Schlüssels in der Schlüsselreferenz, gefolgt von
(keine Definition). Hierunter folgen die Referenzen auf den nicht definierten Schlüssel, die sich in den Dokumenten befinden, die von der aktuellen Zuordnung referenziert werden.
• Alle einblenden – Erweitert alle Schlüsselreferenzen unterhalb der aufgelisteten Schlüssel.
• Alle ausblenden – Minimiert alle Schlüsselreferenzen unterhalb der aufgelisteten Schlüssel.
• Gehe zu – Öffnet das Dokument, das die ausgewählte Schlüsseldefinition enthält oder referenziert diese Schlüsseldefinition im Dokument und hebt sie hervor.
• Aktualisieren – Aktualisiert die Liste der Schlüsseldefinitionen auf den neuesten Stand.