Zuletzt bearbeitet vor einem Monat
von Margit Link-Rodrigue

Handbuch:Qualitätsmanagement und Setup:Installationsanleitung/Systemvorbereitung/Windows/Elasticsearch: Unterschied zwischen den Seiten

(Unterschied zwischen Seiten)
Keine Bearbeitungszusammenfassung
 
(Die Seite wurde neu angelegt: „{{Hint|file=icon_optional.png|text=Elasticsearch ist Voraussetzung für den Betrieb der Erweiterten Suche. Die hier aufgeführten Schritte sind deshalb optiona…“)
Markierung: 2017-Quelltext-Bearbeitung
 
Zeile 1: Zeile 1:
{{TOClimit|limit=1}}
{{Hint|file=icon_optional.png|text=Elasticsearch ist Voraussetzung für den Betrieb der Erweiterten Suche. Die hier aufgeführten Schritte sind deshalb optional und nur erforderlich, wenn Sie diese in Ihrer BlueSpice-Installation verwenden möchten.}}
Um die Qualität einer Wikiseite zu gewährleisten, gibt es zahlreiche Werkzeuge zum Qualitätsmanagement.


==Dokumentenlenkung==
{{Hint|file=hint.png|text=Für den Betrieb der Elasticsearch ist [[Setup:Installationsanleitung/Systemvorbereitung/Windows/OpenJDK|OpenJDK]] Voraussetzung. Sollten Sie dies noch nicht installiert haben so folgen Sie dem eben genannten Link.}}
In BlueSpice können viele  Benutzer Informationen  erstellen. Spezialisten können den Inhalt dann überprüfen. Dies stellt sicher, dass die Qualität der Inhalte den Standards Ihrer Organisation entspricht. Dabei ist zu beachten, dass rigide Qualitätskontrollen und -prozesse schnell die Autonomie der Mitarbeiter einschränken. Trotz der Möglichkeit zur Qualitätskontrolle sollten Sie daher immer sicherstellen, dass Sie keine unnötigen Hürden einbauen, die die Akzeptanz des Wikis beeinträchtigen.<section begin="training-maintainer"></section><div>
==Download==
Folgende Bereiche sollten für die Qualitätssicherung im Wiki im Auge behalten werden:
{{Hint|file=hint.png|text=Der Inhalt dieses Abschnitts verweist auf externe Quellen und ist zum Zeitpunkt der Erstellung dieser Dokumentation aktuell. Wir können nicht garantieren, wie lange diese Quellen in Ihrer Form so Bestand haben. Informieren Sie uns gerne, wenn Sie hier Abweichungen feststellen.}}


#Dokumentenqualität ([[Handbuch:Qualitätsmanagement#Qualitätswerkzeuge|Qualitätswerkzeuge]], Vorlagen)
BlueSpice ist derzeit mit Elasticsearch 6.x ab Version 6.8.21 kompatibel. Elasticsearch > 6.8.x wird derzeit nicht unterstützt.
#Inhaltsorganisation im Wiki (Strukturierungsmechanismen, Portalseiten, Abfragen)
#Wikipflege (Wartungsseiten, Prozesse, Beobachtungen, Benachrichtigungen)
</div>


==Qualitätswerkzeuge==
Die jeweils aktuelle Version können Sie [https://github.com/elastic/elasticsearch/releases dieser Liste] entnehmen. Daraus ergibt sich folgender direkter Download-Link: https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-<Versionsnummer>.zip also bspw. <code>https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.8.23.zip</code>.
[[Datei:Handbuch:qualitätsmanagement.png|alternativtext=Screenshot of quality tools on the user interface|zentriert|mini|750x750px|(1) Seitenfreigabe, (2) Workflows, (3) Aktualität, (4) Erinnerung, (5) Zuweisung, (6) Seiteninformationen, (7) IMS Vorlage]]


===BlueSpice free===
Folgen Sie dabei den Download-Anweisungen Ihres Browsers.
*Zuweisung (5)
*Seiteninformationen (6)


=== BlueSpice pro===
{{Hint|file=hint.png|text=Im Folgenden wird die Elasticsearch-Version 6.8.23 verwendet und dient nur beispielhaft für die jeweils aktuellste Version der Versionsreihe 6.x, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.}}
==Entpacken des ZIP-Archivs==
Entpacken Sie das soeben heruntergeladene ZIP-Archiv in einen sinnvollen Systempfad auf Ihrer Festplatte.


*Freigabe (1)
{{Hint|file=hint.png|text=Diese Dokumentation geht von der von uns [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur unter Windows|empfohlenen Ordnerstruktur]] aus. Aus diesem Grund wird an dieser Stelle PHP in den Ordner C:\bluespice\bin\elasticsearch-6.8.23 entpackt. Haben Sie individuelle Wünsche, so passen Sie diese Pfade nach eigenem Verständnis an.}}
*Workflow (2)
*Aktualität (3)


*Erinnerung (4)
==Installation des Plugins ingest-attachment==
Wechseln Sie in das Verzeichnis "C:\bluespice\bin\elasticsearch-6.8.23\bin" (1) und führen auf eine freie Fläche des Explorer-Fensters einen Rechtsklick mit gedrückter Shift-Taste aus. Klicken Sie dann auf "PowerShell-Fenster hier öffnen" (2) bzw auf älteren Windows-Versionen auf "Eingabeaufforderung hier öffnen":


*Zuweisung (5)
[[File:Setup:systempreparation_elasticsearch_01.png|border|center|600px|Elasticsearch 01]]


*Seiteninformationen (6)
{{Hinweisbox|boxtype=Hinweis|icon=|Note text=Zur formalen Unterstützung der Dokumentenlenkung eignen sich zusätzlich die [[Vorlagen_Download/IMS_Dokumente|IMS Vorlagen]] zur Erstellung prozessbezogener Wikiseiten.|bgcolor=}}


== Freigabe==
Führen Sie dort den Befehl ".\elasticsearch-plugin.bat install -b ingest-attachment" aus:
<section begin="training-intro-freigabe"></section><div>Wenn die Seiten in einem Namesraum eine veröffentlichte und eine Entwurfsversion haben sollen, muss die Einstellung [[Referenz:Flagged Revisions|Freigabe]] für diesen Namesraum aktiviert werden. Alle Änderungen an einer Seite werden in einer Entwurfsversion erfasst, bis ein Benutzer mit Freigaberechten die Seite akzeptiert.</div><section end="training-intro-freigabe"></section>


In der Konfigurationsvewaltung gibt es eine globale Option, mit der festgelegt werden kann, welche Benutzergruppen unveröffentlichte Inhalt lesen dürfen. Standardmäßig können alle angemeldeten Benutzer Entwürfe einsehen.
[[File:Setup:systempreparation_elasticsearch_02.png|border|center|600px|Elasticsearch 02]]


===Eigenschaften===
<section begin="training-freigabe"></section>


*'''Revisionsbasiert:''' Unterscheidung zwischen Erstentwurf, Entwurf, und freigegeben
{{Hint|file=hint.png|text=Sollte Ihr Server über keine aktive Internetverbindung verfügen, so [https://artifacts.elastic.co/downloads/elasticsearch-plugins/ingest-attachment/ingest-attachment-6.8.23.zip downloaden Sie das Plugin ingest-attachment als zip-Archiv]. Achten Sie dabei auf die korrekte Versionsnummer in diesem Downloadlink. Installieren Sie das Plugin anschließend wie [https://www.elastic.co/guide/en/elasticsearch/plugins/current/plugin-management-custom-url.html direkt beim Hersteller dokumentiert].}}
*'''Externe Dateien:''' Eingebettete Medien und Vorlagen werden "eingefroren"
==Installation des Elasticsearch Dienstes==
*'''Automatische Freigabe''' als Ergebnis einer Begutachtung möglich
Führen Sie anschließend den Befehl "elasticsearch-service.bat install" aus und warten Sie, bis der Prozess abgeschlossen ist:
*'''Leserechte''' für Entwürfe können (mit Vorsicht) konfiguriert werden
<section end="training-freigabe"></section>


==Begutachtung==
[[File:Setup:systempreparation_elasticsearch_03.png|border|center|600px|Elasticsearch 03]]
<section begin="training-intro-begutachtung"></section><div>Wenn ein strukturierter Überprüfungsprozess mit mehreren Benutzern erforderlich ist, können Benutzer einen Begutachtungsworkflow erstellen. Dieser Workflow  ist das einzige Qualitätsmanagement-Tool, das die Seite für die Bearbeitung während der Überprüfungsphase sperren kann.</div><section end="training-intro-begutachtung"></section>


Jeder Benutzer kann hier der Seite zustimmen oder diese ablehnen.


Die Seite wird auf der Spezialseite ''Begutachtung'' unter ''Globale Aktionen'' und auf der persönlichen Begutachtungsseite der zugewiesenen Begutachter aufgeführt.
==Elasticsearch Dienst konfigurieren und starten==
Geben Sie die Tastenkombination Windows + R ein.


===Eigenschaften===
Im folgenden Dialog tragen Sie "services.msc" ein (1) und bestätigen mit "OK" (2):
<section begin="training-begutachtung"></section>


*'''Nur eine aktive Begutachtung''' pro Seite
[[File:Setup:systempreparation_elasticsearch_04.png|border|center|Elasticsearch 04]]
*'''Typen:''' Sequentiell oder parallel
*'''Zustimmung''' oder '''Ablehnung''' der Teilnehmer
*'''Sperrung:''' Seite ist zur Bearbeitung gesperrt (mögliche Ausnahme: Begutachter)
*'''Automatischer Neustart''' eines Workflows nach Ablehnung möglich
*'''Versionierung:''' Einträge in der Versionsgeschichte der Seite (konfigurierbar)
*'''Kombinierbar''' mit Freigabe
<section end="training-begutachtung"></section>


==Aktualität==
<section begin="training-intro-aktualität"></section><div>Wenn eine Seite Inhalte mit einem bekannten Lebenszyklus enthält, kann festgelegt werden, dass die Seite an einem bestimmten Datum abläuft. Am Ablaufdatum wird der Seite ein Wasserzeichen "Veraltet" hinzugefügt, wenn die entsprechende Option im [[Handbuch:Erweiterung/BlueSpiceConfigManager|ConfigManager]] eingestellt ist. Darüber hinaus kann eine Erinnerung festgelegt werden, damit der Benutzer eine Benachrichtigung erhält, wenn die Seite abläuft. Der Ablauf kann jederzeit von der Seite gelöscht werden.</div><section end="training-intro-aktualität"></section>


===Eigenschaften===
Suchen Sie den Service "Elasticsearch 6.8.23" und öffnen diesen mit einem Doppelklick:
<section begin="training-aktualität"></section>


*'''Wasserzeichen''' im Seitenhintergrund und im PDF (abhängig von globaler Konfiguration)
[[File:Setup:systempreparation_elasticsearch_05.png|border|center|600px|Elasticsearch 05]]
*'''Übersichtsliste''': ''Spezial:Veraltete_Seiten''
*'''Erinnerung''' beim Erstellen aktivierbar
*'''Dauer:''' Veraltung ist jederzeit löschbar
<section end="training-aktualität"></section>


==Erinnerung==
<section begin="training-intro-erinnerungen"></section><div>Ein Benutzer kann eine Erinnerung für eine Seite erstellen, indem er ein Erinnerungsdatum auswählt und einen optionalen Kommentar hinzufügt. Erinnerungen können von Administratoren auch für andere Benutzer erstellt werden und sind eine schnelle und informelle Möglichkeit, Fälligkeitstermine für seitenbezogene Aufgaben festzulegen.</div><section end="training-intro-erinnerungen"></section>


===Eigenschaften===
Wählen Sie als Starttyp "Automatisch" (1) und starten Sie den Dienst (2). Nachdem der Dienst gestartet ist schließen das Fenster mit "OK" (3):
<section begin="training-erinnerungen"></section>


*'''Benachrichtigung''' über eigene Erinnerungen erhält eine Benachrichtigung (in Benutzereinstellungen deaktivierbar)
[[File:Setup:systempreparation_elasticsearch_06.png|border|center|Elasticsearch 06]]
*'''Wiederkehrende Erinnerungen''' möglich
*'''Erinnerungsliste:''' Spezialseite für Administratoren (unter Globale Aktionen)
*'''Schnellzugriff''' über das persönliche Benutzermenü
<section end="training-erinnerungen"></section>


==Zuweisung==
<section begin="training-intro-seitenzuweisungen" /><div class="training">Seitenzuweisungen bieten die Möglichkeit, einem oder mehreren Benutzern oder Benutzergruppen die redaktionelle Verantwortung für eine Seite zu übertragen. </div>Es ist auch möglich, einen Namensraum so einzurichten, dass zugewiesene Benutzer eine Lesebestätigung für jede größere Änderung an einer Seite abgeben müssen. Da Zuweisungen im Wiki als Seitenattribut zur Verfügung stehen, können sie in [[SMW-Abfragen|semantischen Abfragen]] verwendet werden.<section end="training-intro-seitenzuweisungen" />


===Eigenschaften===
==Nächster Schritt==
<section begin="training-seitenzuweisungen" />
Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt [[Setup:Installationsanleitung/Systemvorbereitung/Windows/Python|Python]].
 
*'''Benachrichtigung''' bei Änderung der Seitenzuweisung (in Benutzereinstellungen deaktivierbar)
*'''Transparenz:''' Zugewiesene Benutzer sind in den Seiteninformationen aufgeführt
*'''Zuweisungsverwaltung:''' Spezialseite für Administratoren
*'''Schnellzugriff''' auf eigene Zuweisungen über das persönliche Benutzermenü
*'''Lesebestätigung möglich:''' Zugewiesene Benutzer müssen dann das Lesen von Änderungen an der Seite bestätigen (Namensraum-spezifisch)
<section end="training-seitenzuweisungen" />
 
==Seiteninformationen==
<section begin="training-intro-seiteninformationen"></section><div>Die Seiteninformationen geben Ihnen einige interessante Statistiken über die Seite. Anhand dieser Informationen können Sie entscheiden, welche Maßnahmen zur Qualitätssicherung der Seite erforderlich sind.</div><section end="training-intro-seiteninformationen"></section>
 
Informationen, die auf dieser Seite aufgelistet sind:
 
*Anzahl der Beobachter der Seite
*Alle Bearbeiter, letzte Bearbeitung
*Eigenschaften: Eingebundene Vorlagen, eingebundene Bilder, interne und externe Links,  Kategorien
*Aktualität der Seite
*Autoren der Seite
* Leser der Seite (nur für Administratoren sichtbar)
*Erinnerungen (alle Erinnerungen nur für Administratoren sichtbar, ansonsten eigene Erinnerungen)
 
==Berechtigungen==
 
Diese Berechtigungstabelle zeigt, welche Rollen das erforderliche Recht haben, verschiedene Qualitätssicherungsaktionen durchzuführen. Der Name des Rechts, das eine bestimmte Berechtigung erteilt, wird in Klammern angezeigt:
<br />
{| class="sortable widefirst table-scroll"
!QM-Aktion
!user (read)
!editor
!reviewer
!admin
!maintenance-admin
!bot
|-
|Kann '''Seitenzuweisungen''' für alle Benutzer erstellen und verwalten ''(pageassignments)''
|
|
|x
| x
|x
|
|-
|Kann einer '''Seite zugewiesen''' werden ''(pageassigneable)''
|x
|
|
|
|
|
|-
|Kann '''Erinnerungen''' für alle Benutzer erstellen und managen. ''(remindereditall)''
|
|
|
|x
|x
|
|-
|Kann eigene '''Erinnerungen''' erstellen und verwalten ''(read)''
|x
|
|
|
|
|
|-
|Kann das '''Veralten''' von Seiten erstellen und verwalten. ''(expirearticle)''
|
|x
|
|x
|x
|
|-
|Kann '''Begutachtungen''' erstellen und verwalten ''(workflowedit)''
|
| x
|x
| x
|x
|
|-
|Kann einer '''Begutachtung''' zugewiesen werden ''(read)''
|x
|
|
|
|
|
|-
|Kann die '''Begutachtung''' auf einer Seite einsehen ''(workflowview)''
|x
| x
|x
|x
|x
|
|-
|Kann die Liste aller '''Begutachtungen''' einsehen ''(workflowlist)''
|
| x
|x
|x
|x
|
|-
|Kann eine Seite '''freigeben''' ''(review)''
|
|
|x
|x
|x
|
|-
|Eigene Änderungen werden '''automatisch freigegeben''' ''(autoreview)''
|
|
|
|
|x
| x
|-
|Zurückgerollte Änderungen werden '''automatisch freigegeben'''''(autoreviewrestore)''
|
|
|
|
|x
| x
|}<br />{{Box_Links
|Thema1= [[Handbuch:Erweiterung/FlaggedRevs| Seitenfreigabe]]
|Thema2= [[Handbuch:Erweiterung/Workflows|Begutachtungsprozess]]
| Thema3 = | Thema4 = }}
<br />
[[de:{{FULLPAGENAME}}]]
[[En:Manual:Quality management]]
 
[[Category:Qualität]]

Version vom 11. März 2022, 11:39 Uhr

icon optional.png
Elasticsearch ist Voraussetzung für den Betrieb der Erweiterten Suche. Die hier aufgeführten Schritte sind deshalb optional und nur erforderlich, wenn Sie diese in Ihrer BlueSpice-Installation verwenden möchten.


hint.png
Für den Betrieb der Elasticsearch ist OpenJDK Voraussetzung. Sollten Sie dies noch nicht installiert haben so folgen Sie dem eben genannten Link.

Download

hint.png
Der Inhalt dieses Abschnitts verweist auf externe Quellen und ist zum Zeitpunkt der Erstellung dieser Dokumentation aktuell. Wir können nicht garantieren, wie lange diese Quellen in Ihrer Form so Bestand haben. Informieren Sie uns gerne, wenn Sie hier Abweichungen feststellen.


BlueSpice ist derzeit mit Elasticsearch 6.x ab Version 6.8.21 kompatibel. Elasticsearch > 6.8.x wird derzeit nicht unterstützt.

Die jeweils aktuelle Version können Sie dieser Liste entnehmen. Daraus ergibt sich folgender direkter Download-Link: https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-<Versionsnummer>.zip also bspw. https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.8.23.zip.

Folgen Sie dabei den Download-Anweisungen Ihres Browsers.

hint.png
Im Folgenden wird die Elasticsearch-Version 6.8.23 verwendet und dient nur beispielhaft für die jeweils aktuellste Version der Versionsreihe 6.x, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.

Entpacken des ZIP-Archivs

Entpacken Sie das soeben heruntergeladene ZIP-Archiv in einen sinnvollen Systempfad auf Ihrer Festplatte.

hint.png
Diese Dokumentation geht von der von uns empfohlenen Ordnerstruktur aus. Aus diesem Grund wird an dieser Stelle PHP in den Ordner C:\bluespice\bin\elasticsearch-6.8.23 entpackt. Haben Sie individuelle Wünsche, so passen Sie diese Pfade nach eigenem Verständnis an.


Installation des Plugins ingest-attachment

Wechseln Sie in das Verzeichnis "C:\bluespice\bin\elasticsearch-6.8.23\bin" (1) und führen auf eine freie Fläche des Explorer-Fensters einen Rechtsklick mit gedrückter Shift-Taste aus. Klicken Sie dann auf "PowerShell-Fenster hier öffnen" (2) bzw auf älteren Windows-Versionen auf "Eingabeaufforderung hier öffnen":

Elasticsearch 01


Führen Sie dort den Befehl ".\elasticsearch-plugin.bat install -b ingest-attachment" aus:

Elasticsearch 02


hint.png
Sollte Ihr Server über keine aktive Internetverbindung verfügen, so downloaden Sie das Plugin ingest-attachment als zip-Archiv. Achten Sie dabei auf die korrekte Versionsnummer in diesem Downloadlink. Installieren Sie das Plugin anschließend wie direkt beim Hersteller dokumentiert.

Installation des Elasticsearch Dienstes

Führen Sie anschließend den Befehl "elasticsearch-service.bat install" aus und warten Sie, bis der Prozess abgeschlossen ist:

Elasticsearch 03


Elasticsearch Dienst konfigurieren und starten

Geben Sie die Tastenkombination Windows + R ein.

Im folgenden Dialog tragen Sie "services.msc" ein (1) und bestätigen mit "OK" (2):

Elasticsearch 04


Suchen Sie den Service "Elasticsearch 6.8.23" und öffnen diesen mit einem Doppelklick:

Elasticsearch 05


Wählen Sie als Starttyp "Automatisch" (1) und starten Sie den Dienst (2). Nachdem der Dienst gestartet ist schließen das Fenster mit "OK" (3):

Elasticsearch 06


Nächster Schritt

Haben Sie alle vorgenannten Schritte erfolgreich abgeschlossen, so gehen Sie zum nächsten Schritt Python.




Feedback zur Dokumentation ist im Community-Forum möglich.

Keine Kategorien vergebenBearbeiten

Diskussionen