Die oxaion Bedienerhilfe ist über die URL https://docs.oxaion.de/ öffentlich zugänglich. Sie basiert auf dem Online-Dokumentationssystem Confluence.
Zugriff per Web-Browser (Mobil oder Desktop)
Die URL https://docs.oxaion.de/ kann mit handelsüblichen Web-Browsern geöffnet werden. Die Hilfe kann hierin ohne Kontext der oxaion-Anwendung geöffnet und durchsucht werden.
Je nachdem, ob der Zugriff über ein mobiles Endgerät oder einen Desktop-PC stattfindet, passt sich das Layout an unterschiedliche Bildschirmgrößen an (responsives Design).
Bildbeschreibung: Desktop-Layout und mobiles Layout in der Gegenüberstellung
Bildschirmaufbau
Bildbeschreibung: Die oxaion Docs v5.1 Hauptseite
Für die direkte Navigation steht auf der linken Seite eine Baum- / Explorernavigation zur Verfügung ("Pagetree"). Sie ist auf der Haupt- und allen Unterseiten sichtbar und kann bei Bedarf eingeklappt werden. Alternativ kann direkt die Suchfunktion über die entsprechenen Suchfenster aufgerufen werden. Der Fokus der Hauptseite liegt dabei auf übergreifenden Funktionen, Anleitungen und Anwendungsmöglichkeiten ("Handbücher").
Die Online-Bedienerhilfe
Die Online-Bedienerhilfe richtet sich an Anwender, die gezielt nach Programminformationen suchen. Konkrete Inhalte findet man entweder durch Eingabe des entsprechenden Suchbegriffs im Suchfenster (z.B. "Geschäftspartner"), oder aber über den eigenen Verzeichnisbaum auf der separat verlinkten Online-Bedienerhilfe-Seite.
Bildbeschreibung: Online-Bedienerhilfe
Die Online-Bedienerhilfe enthält Informationen zu:
Somit ist es möglich, zu jedem Feld, jedem Programm und jeder Tabelle in oxaion die benötigten Informationen zu recherchieren.
Bildbeschreibung: Suchen und Finden
Das Navigieren in die Breite und in die Tiefe der Seitenstruktur erfolgt wahlweise über die horizontale Navigationsleiste oder die eingeblendete Pagetree-Struktur.
Bildbeschreibung: Horizontale Navigationsleiste
Mehrsprachigkeit
Die oxaion Bedienerhilfe ist zweisprachig. Sie wird in deutscher und in englischer Sprache angeboten. Die englische Version betrifft aktuell nur den Bereich oxaion open 5.1. Hier gibt es Übersetzungen für folgende Themenstrukturen:
Anhand der im Browser eingestellten Sprache erkennt das Confluence-System, ob es die Dokumentation in deutscher oder englischer Sprache einblenden soll. Englisch wird angezeigt, sobald die Browsersprache nicht Deutsch ist.
Alternativ kann die Browsersprache auch manuell gewechselt werden, um die englische, bzw. deutsche Version einer Seite zu sehen. Seiten ohne englische Übersetzung sind entsprechend gekennzeichnet. Es wird zusätzlich der deutsche Text angezeigt.
Bildbeschreibung: Sprachumschaltung
Ein Übersetzungsprozess stellt sicher, dass alle Änderungen und Neuerungen im Bereich oxaion open 5.1 auch in der englischen Version frühestmöglich verfügbar sind. Bilder und eingebettete Diagramme sind vorerst von der Übersetzung ausgenommen.
Zugriff aus oxaion heraus
Die Programmhilfe kann direkt aus der oxaion Programmoberfläche aufgerufen werden. Es stehen folgende Wege zur Verfügung:
Über den Button "Handbücher"
Bildbeschreibung: Dokumentationsaufruf via "Handbücher"-Piktogramm
Im Karteireiter "Hilfe" am oberen Rand des Hauptfensters finden Sie das "Handbücher"-Piktogramm (vgl. Bild oben). Ein Mausklick auf dieses Piktogramm öffnet die Hauptseite der oxaion open 5.1 Dokumentation.
Über das Hilfe-Piktogramm
Bildbeschreibung: Dokumentationsaufruf aus oxaion heraus via Hilfe-Piktogramm
Aktivieren Sie zunächst in oxaion das Hilfe-Piktogramm mit der linken Maustaste. Der Maus-Cursor verwandelt sich daraufhin in einen Zeiger mit Fragezeichen. Je nachdem, auf welche Lasche, Piktogramm, bzw. Programmoberfläche, Tabelle oder Datenfeld der nächste Mausklick gesetzt wird, öffnet sich der im Betriebssystem voreingestellte Standard-Browser mit der jeweils passenden Confluence-Hilfeseite, die über den Mausklick angefragt wurde. Wurde ein Feld angeklickt, wird zum entsprechenden Anker auf der betreffenden Hilfeseite verknüpft, d.h. die Seitendarstellung beginnt direkt bei der Beschreibung des angefragten Feldes.
Per Kontextmenü-Aktivierung
Bildbeschreibung: Dokumentationsaufruf aus oxaion heraus via "Hilfetext anzeigen"-Kontextmenüeintrag
Von jedem Ort aus, von dem oxaion den Kontextmenüeintrag "Hilfetext anzeigen" anbietet, ist es möglich, die zugehörige Confluence-Hilfeseite per Linksklick auf den Kontextmenüeintrag zu öffnen. Dies betrifft Felder, Tabellen, Laschen, Piktogramme und Programmoberflächen.
Per "F1"-Tastenaufruf
Anstelle des Hilfe-Fiktogramms kann auch die Funktionstaste "F1" aus oxaion heraus verwendet werden. Zum jeweils aktiven Programm, Tabelle oder Feld öffnet sich dann der am Client voreingestellte Standard-Browser mit der zugehörigen Confluence-Hilfeseite.
Wie kann man Confluence-Inhalte exportieren, verändern oder erstellen?
Die Dokumentation unter https://docs.oxaion.de/ steht kostenlos der Allgemeinheit zur Verfügung. Jedoch vergibt oxaion keine Benutzerzugänge für externe Anwender. Ohne Benutzerzugang kann man Dokumentation durchsuchen, online lesen und auch als PDF oder Word-Datei exportieren. Ohne Benutzeranmeldung sind dagegen weder Kommentare noch Seitenänderungen möglich. Die redaktionelle Pflege der oxaion Dokumentation verbleibt ausschließlich bei oxaion.
Trotzdem ist es oxaion-Kunden möglich, eigene Seiten anzulegen, die offizielle oxaion-Dokumentation an eigene Zwecke anzupassen und auch Confluence-Dokumentation für selbst entwickelte Zusatzfunktionen hochzuladen. Die Möglichkeiten von oxaion-Kunden für Export, Erstellung und Änderung von Confluence-Seiten werden im Folgenden beschrieben.
Export von Confluence-Seiten
Einzelne Confluence-Dokumentationsseiten unter https://docs.oxaion.de/ können auf zwei Wegen exportiert werden: Als Word-Datei oder als PDF.
Word-Export
Bildbeschreibung: Word-Export
Der Word-Export kann auf jeder beliebigen Confluence-Seite über das Brotkrumen-Menü am rechten oberen Fensterrand ausgelöst werden (vgl. Bild oben).
PDF-Export
Bildbeschreibung: PDF-Druck
Der PDF-Export erfolgt über die Druckfunktion des jeweils verwendeten Browsers. Hierbei ist der browser-interne PDF-Drucker oder ein externer PDF-Drucker auszuwählen.
Bedingung für das Erstellen und Ändern eigener Confluence-Seiten
Bildbeschreibung: Confluence-Lizenzierung
Um Confluence-Seiten erstellen, ändern oder kommentieren zu können benötigen oxaion-Kunden eine eigene Confluence-Instanz. Diese kann ab 10,- $ vom Kunden selbst erworben werden. Die Herstellerfirma Atlassian beschreibt ihre Preismodelle unter https://www.atlassian.com/de/software/confluence/pricing?tab=self-managed.
Erstellen und Ändern eigener Confluence-Seiten
Sobald man als oxaion-Kunde eine eigene Confluence-Instanz nachweisen kann, lassen sich eigene Bereiche und Seiten für das firmeninterne Wissensmanagement erstellen und im Firmen-Intranet verankern. Es gibt eine große Bandbreite an verfügbaren Plugins und Anpassungsmöglichkeiten. Die Inhalte können je nach Bedarf sowohl unternehmensintern als auch unternehmensextern zur Verfügung gestellt werden.
Einige mögliche Anwendungsfelder:
- QM-Dokumentation
- Arbeitsanweisungen
- e-Collaboration / webbasiertes Projektmanagement
- Produktdokumentation
- Media Wiki
Für Confluence gibt es reichhaltige Beratungs- und Schulungsangebote und eine Vielzahl von Firmen, die sich auf Confluence spezialisiert haben. Das Erstellen und Verändern von Seiten ist ähnlich intuitiv wie bei Wikipedia und vergleichbaren Media-Wikis. Ihr oxaion Kundenbetreuer berät Sie, falls Sie weitere Hilfe bei der Einführung von Confluence in Ihrem Hause benötigen. Neben zahlreichen weiteren Informationsquellen im Internet bietet sich die offizielle Anwenderdokumentation der Herstellerfirma Atlassian als Einstieg an: https://confluence.atlassian.com/doc/confluence-server-documentation-135922.html.
Erstellen eigener Kundenversionen und Dokumentation zu Eigenentwicklungen
Sobald eine kundeneigene Confluence-Instanz vorhanden ist, besteht in Abstimmung mit oxaion die Möglichkeit, eigene Seitenversionen von offiziellen oxaion-Dokumentationsseiten zu führen und zu unterhalten. Außerdem ist es möglich, Confluence-Dokumentation zu Eigenentwicklungen in der kundeneigenen Confluence-Instanz abzubilden.
Diagrammbeschreibung: Confluence Kundenversionen
Für jedes Major Release (5.1, 6.0, tbd.) kopiert oxaion einen neuen Dokumentationsbereich in die Confluence Kunden-Instanz, der die gesamte Dokumentation zum betreffenden Release enthält. Diese Confluence-Bereichskopien sind Original-Vorlagen, die nicht zum Ändern gedacht sind, sondern als Kopier- und Wiederherstellungsgrundlage. Möchte ein oxaion-Kunde eine eigene Seitenversion einer oxaion Confluence-Seite erstellen, kann er über eine Sonderfunktion im oxaion Client die Generierung einer Kundenvariante einer bestehenden oxaion Confluence-Seite veranlassen. Hierbei legt der oxaion Client von derjenigen Confluence-Seite eine Kundenkopie an, die sich auf das oxaion-Programm bezieht aus dem heraus der Aufruf stattfand.
Die vom oxaion Kunden erzeugten Arbeitskopien werden in einem hierfür vorgesehenen Kunden-Bereich abgelegt, wo sie nach Belieben verändert werden können. Mit jedem neuen Major Release erhält der oxaion Bestandskunde einen Change Report. Dieser enthält für den oxaion Kunden eine Auflistung aller Confluence-Seiten, die verändert, gelöscht oder zusammengelegt wurden und von denen er eine modifizierte Seitenkopie besitzt. Es ist dann in der Verantwotung des oxaion Kunden, seine Seitenmodifikationen an den aktuellsten Stand anzupassen.
Darüber hinaus bietet oxaion eine weitere Dokumentationsmöglichkeit für oxaion Kunden an, die eigene Softwareentwicklung für ihr oxaion ERP-System betreiben. In diesem Fall exportiert der oxaion Generator die Programmdokumentation in einen eigenen Bereich in der Confluence Kunden-Instanz, der die Dokumentation für Eigenentwicklungen von oxaion-Kunden enthält.
Für die Erstellung und Änderung eigener Confluence-Seiten bietet oxaion gesonderte Hilfe an. Bitte wenden Sie sich hierzu an ihren oxaion Kundenbetreuer oder an info@oxaion.de.