CoPlanner 10 - Benutzerbeiträge [de-formal]

CoPlanner-Portal

2022-11-14T08:54:16Z

Admin:

<div id="hauptseite">
<div class="hauptseite-oben" id="hauptseite-willkommen">

Dieses Portal bietet Ihnen Neuigkeiten, Informationen und Hilfestellungen rundum die Software von CoPlanner. Damit Sie einen sicheren Einstieg haben und die Vorteile von der CoPlanner-Software optimal nutzen können, wird das Online-Hilfesystem kontinuierlich aktualisiert. Sie haben noch Fragen oder Verbesserungsvorschläge zu diesem Portal? Zögern Sie nicht uns diese zu schicken, wir freuen uns über Ihr [mailto:support@coplanner.com?subject=CoPlanner%20Portal E-Mail].

{{Hinweis|Kategorie=Hinweis|Text=Sie verwenden noch die CoPlanner Version 9.5? Das CoPlanner-Portal für diese Version finden Sie [https://copsupport.coplanner.com/help95/index.php/CoPlanner-Portal hier].}}

{{Hinweis|Kategorie=Hinweis|Text=Sie verwenden schon die CoPlanner Version 11? Das CoPlanner-Portal für diese Version finden Sie [https://copsupport.coplanner.com/help11/index.php/CoPlanner-Portal hier].}}

 <div class="inhalt"><div class="portale imagemap-inline" align="left"><div class="hauptseite-header-mitte">[[Enterprise Edition]] · [[Framework]]</div>
<div class="hauptseite-header-mitte">[[Excel Client]] . [[Word Add-in]] . [[PowerPoint Add-in]]</div>
[[Portal:Artikel nach Themen|Artikel nach Themen]] · [[Spezial:Alle Seiten|Alphabetischer Index]] · [[:Kategorie:!Hauptkategorie|Artikel nach Kategorien]]
</div>
 

{| width="100%" |

|}

{| width="80%" |
|-
|<div class="hauptseite-header">Tutorials</div>
|-
|[[Tutorial:Anlegen eines neuen Dimensionselements|Anlegen eines neuen Dimensionselements]]
|-
|[[Framework:BI_Center:CoPlanner_W%C3%BCrfel_erstellen|Erstellen eines CoPlanner Würfels für die Umsatzplanung]]
|-
|[[Tutorial:Dynamische_Measurebezeichnungen|Dynamische Measurebezeichnungen]]
|}

__NOTOC__ __NOEDITSECTION____NOTOC__ __NOEDITSECTION__

 
[[en:CoPlanner-Portal]]

Framework:Szenariomanager

2022-09-26T09:55:12Z

Admin:

__TOC__
==Allgemein==

Der Szenariomanager dient als Administrationstool von Plänen und Forecasts. Berechtigungen, Tasks und Szenarioeigenschaften werden hier verwaltet.

[[Image:Fw_Szenariomanager.jpg|thumb|center|Framework, Szenariomanager]]

'''Der Baum'''

Dieser dient als Navigationsinstrument. Er beinhaltet Ordner und Pläne/Forecasts.

Die Symbole in der Ribbonleiste haben folgende Funktionen:

{| class="wikitable" width="857"
|- {{Tabellentitel}}
| Schaltfläche
| Aktion
|-
| [[Image:Ein_Auschecken_der_Dimension.jpg‎]]
| Ein-/Auschecken der Dimension zum Bearbeiten Diese Schaltfläche kann verschiedene Zustände darstellen:
|-
| [[Image:Ein_Auschecken_der_Dimension.jpg‎]]
| Die Dimension kann „Ausgecheckt“ werden.
|-
| [[Image:Ausgechecken_der_Dimension.jpg‎]]
| Die Dimension ist „Ausgecheckt“ und zum Bearbeiten verfügbar.
|-
| [[Image:Bereits_geoeffnet_der_Dimension.jpg‎]]
| Die Dimension ist von einem anderen User dereit geöffnet
|-
| [[Image:Zuruecksetzen_der_Dimension.jpg]]
| Zurücksetzen der Dimension
|-
| [[Image:Icon Speichern.jpg]]
| Speichert alle Änderungen
|-
| [[Image:Icon Loeschen.jpg]]
| Löscht das ausgewählte Element
|-
| [[Image:Element_auf_der_darunterliegenden_Ebene.jpg]]
| Legt ein neues Element auf der darunterliegenden Ebene an
|-
| [[Image:Sortiert-die-Dimensionselem.jpg]]
| Sortiert die Dimensionselemente alphabetisch
|-
| [[Image:Icon_Excel_Export.jpg‎]]
| [[Enterprise_Edition:Excel_Export|Export]] in eine Excel – Datei
|-
| [[Image:Icon Suchen.jpg]]
| Öffnet das Dialogfeld Suchen
|}

==Funktionalitäten des Navigationsbaumes==

===Kontextmenü===

Durch einen Rechtklick auf einen Ordner oder ein Szenario erscheint folgendes Menü:

[[Image:Fw_SM_Kontextmenue.jpg|thumb|center|Framework, Szenariomanager, Kontextmenü]]

Funktionalität der Menüpunkte:

'''Neues Szenario, Neuer Ordner'''

Neu angelegt werden können Ordner und Szenarios. Vergeben Sie einen Namen im darauf folgenden Dialog. Im Baum ist danach der neue Ordner oder das neue Szenario eingefügt und bereits im System gespeichert.

'''Szenario kopieren'''

[[Image:Fw_SM_Szenariodaten kopieren.jpg|thumb|center|Framework, Szenariomanager, Szenariodaten kopieren]]

Das im Baum selektierte Szenario wird kopiert. Vergeben Sie den gewünschten Namen, den die Kopie erhalten soll. Wählen Sie des Weiteren den Ordner, in dem die Kopie angelegt werden soll. Möchten Sie nur die Struktur des Szenarios kopieren, deaktivieren Sie die Option „Daten mit kopieren“. Sollen auch die Daten des Szenarios kopiert werden, aktivieren Sie die Option „Daten mit kopieren“.

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Die Struktur des Plans wird immer kopiert.
|}

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Gibt es ein Makro mit dem Namen scenarioexec wird dieses ab CoP 10 HF 3.0 immer nach dem Kopieren ausgeführt. Dazu wird man auf das kopierte Szenario angemeldet. Somit braucht der Benutzer die Standardkonfiguration in der Benutzerverwaltung, dass er neue Pläne zumindest lesen darf und der Plan muss für die Anmeldung verfügbar sein. Ist das nicht gegeben, werden weder die Daten übernommen, noch das Makro ausgeführt.
|}

'''Szenariodaten importieren'''

[[Image:Fw_SM_Daten importieren.jpg|thumb|center|Framework, Szenariomanager, Daten importieren]]

Die Daten des Szenarios, der als Quelle ausgewählt ist, werden in den im Baum selektierten Szenarios importiert. Sollen die vorhandenen Daten des Zielplans zuerst gelöscht werden, setzen Sie den Haken bei „Daten des ZielSzenario entfernen“.

'''Element löschen'''

Löscht den selektieren Ordner/Szenario.

'''Deaktiviertes Szenario löschen'''

Vorgehensweise:

:1) Plan aktivieren
:2) Server neu starten
:3) Element löschen

Durch diese Vorgehensweise ist gewährleistet, dass die zugehörigen Plandatensätze vollständig entfernt werden.

==Funktionalität des Registers „Plan“==

[[Image:Fw_SM_Register Plan.jpg|thumb|center|Framework, Szenariomanager, Register Plan]]

'''Plan deaktiviert'''

Aktivieren Sie diese Option, wenn Sie das Szenario deaktivieren wollen. Ein Login auf diesen ist danach nicht mehr möglich.

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Da jedes aktive Szenario zum Speicherverbrauch des CoPlanner beiträgt, können aktuell nicht mehr benötigte Szenarios deaktiviert werden. Die Daten werden nicht gelöscht, jedoch aus dem aktuellen Speicher entfernt. Deaktivierte Szenarios können jederzeit wieder aktiviert werden, sofern Sie sie wieder benötigen.
Bitte beachten Sie außerdem, dass Änderungen von Aktivierungen/Deaktivierungen von Szenarios werden erst nach einem Neustart des CoPlanner-Service wirksam werden.
|}

'''Eingabe sperren'''

Aktivieren Sie diese Option, wenn Sie das Szenario für die gesamte Dateneingabe sperren möchten.

'''Macroexecutor Anmeldung'''

Mit dieser Option ist es möglich im [[Framework:MakroExecutor|MakroExecutor]] mehrere Pläne hintereinander auszuführen. Ist diese Option aktiviert und im [[Framework:MakroExecutor|MakroExecutor]] ist in der SessionSettings.xml für Plan das Keyword [MAKROPLANS] eingetragen, dann wird das Makro auch für diesen Plan ausgeführt.

'''Für Anmeldung verfügbar'''

Der Login ist nur auf Szenarios möglich, die diese Option gesetzt haben. Diese Option hat keine Auswirkung auf Plan-Filter in Masken, Berichten, usw.. Dort werden diese auch angezeigt, wenn die Option nicht gesetzt ist.

'''Name'''

Bezeichnung des Szenarios

'''Typ'''

Plan, bzw. Forecast. Wählen Sie als Typ Forecast, erscheint eine weitere Einstellungsgruppe.

[[Image:Fw_SM_Forecasteinstellungen.jpg|thumb|center|Framework, Szenariomanager, Forecasteinstellungen]]

Tragen Sie hier den Zeitraum ein, der als Ist-Periode für den Forecast herangezogen werden soll. Ist der Haken bei „Istzeitraum für Eingaben sperren“ gesetzt, so ist eine Eingabe in diesem Zeitraum nicht möglich.

'''Vergleichsszenario 1/Vergleichsszenario 2'''

Dies sind Szenarios, auf die in Planungsfunktionen des aktuellen Szenarios „Bezug“ genommen wird. Bei „Vergleichsszenario 1“ ist das Ist-Budget einzustellen, bei „Vergleichsszenario 2“ das Top Down Planungsbudget.

'''Beschreibung'''

Hier können Informationen zum Szenario hinterlegt werden.

[[Image:Fw_SM_Einstellungen Planungszeitraum.jpg|thumb|center|Framework, Szenariomanager, Einstellungen Planungszeitraum]]

'''Planjahr'''

Tagen Sie hier das Jahr ein, das Sie planen möchten. Drücken Sie danach die Schaltfläche [[Image:Icon_Jahr_übernehmen.jpg]] und automatisch werden die Daten für Planjahrstart und das Planende eingetragen. Sie können das Planende jederzeit überschreiben, wenn Sie eine Mehrjahresplanung (oder eine rollierende Planung) erstellen möchten.

'''Eingabe nur im Planzeitraum'''

Setzen Sie den Hacken, wenn Sie die Eingabe von Planwerten nur im definierten Planzeitraum erlauben möchten. Der Planer wird bei der Eingabe von Daten außerhalb des Planzeitraums darauf hingewiesen, dass dies nicht möglich ist.

'''Schaltfläche Szenario'''

Mit einem Klick auf die Schaltfläche [[Image:Icon_Ummelden.jpg]] können Sie sich sofort an ein neu angelegtes Szenario anmelden.

'''Schaltfläche Forecast berechnen'''

Mit einem Klick auf die Schaltfläche [[Image:Icon_Forecast.jpg]] können Sie die automatische Erstellung eines Forecasts starten.

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Diese Schaltfläche ist nur sichtbar, wenn ein [[Framework:Makros|Makro]] „forecastexec“ vorhanden ist.
|}

__NOEDITSECTION__

[[Category:Framework|Szenariomanager]]
[[kategorie:Administration|Szenariomanager]]

[[en:Framework:Scenario_manager]]

WebApps:Diagramm

2022-05-11T11:35:46Z

Admin:

__TOC__

Verfügbar ab 9.5 HF 3.6

=Systemvoraussetzungen=

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

=Aufruf Diagrammdesigner=
@Session_WebAppUrl@/diagram/?diagramId=<Diagrammname>

Beispiel:

<nowiki>https://servername:4444/coplanner/diagram/?diagramId=Mein erstes Diagramm</nowiki>

===Erweiterter Aufruf===

:* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.

=Aufruf für das Erstellen eines Diagramms=
Über die [[WebApps:Tiles|Tiles]] können über folgenden Aufruf neue Diagramme erstellt werden.

@Session_WebAppUrl@/Diagram/?diagramId=[new]

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Funktioniert nur im PowerUser Modus
|}

=Diagrammdesigner=

==Menü==

{| class="wikitable" width="857"
|- {{Tabellentitel}}
| Schaltfläche
| Aktion
|-
| [[Image:ReportViewer_CoPlanner.JPG]]
| Zurück zur letzten davor aufgerufenen Seite.
|-
| [[Image:ReportViewer_MenueOpenClose.JPG]]
| Öffnen/Schließen der Anzeigetexte des Menüs.
|-
| [[Image:Web_Speichern.PNG]]
| Speichert alle Änderungen
|-
|[[Image:ReportViewer_Aktualisieren.JPG]]
|Aktualisieren der Daten.
|}

==Allgemein==
Wählen Sie allgemeine Einstellungen für das Diagramm wie den Typ, die Art der Nullwertunterdrückung, usw.

==Daten==
Über diesen Bereich können Sie sich Measures beliebig ein- und ausblenden, Filter hinzufügen/entfernen, Dimensionen auf Achsen geben und wegnehmen. Das können Sie machen, indem Sie das entsprechende Element im Felderbereich unter Measures, Spalten, Zeilen oder Filter ziehen.

===Dimensionen===
Hier werden die zur Verfügung stehenden Dimensionen angezeigt. Via Drag&Drop können diese unten im Felderbereich in den entsprechenden Bereich gezogen werden.

===Measures===
Hier werden die zur Verfügung stehenden Measures angezeigt. Über den Schalter vor den Measures können diese ein-/ausgeblendet werden.

==Layout==
Hier treffen Sie die Layouteinstellungen für das Diagramm

==Legende==
:*Ausrichtung: wo die Legende angezeigt wird
:*Richtung: wie die Elemente angeordnet werden
:*Schrift: die Schriftart der Legende

==Achsen==
Je nachdem auf welcher Achse Sie eine Dimension haben, stehen Ihnen für die X- oder Y-Achse folgende Optionen zur Verfügung:

:*Schrift: Schriftart der Achsenbeschriftung
:*Linien: welche Linien sollen im Diagramm angezeigt werden
:*Openelementtyp: Wie soll die Dimension geöffnet werden
:*Spezialdefinition: Hier können nur Rulefilter angegeben werden
:*Summenelemente: sollen Summenelemente eingeblendet werden oder nicht
:*Alternative Bezeichnung: Alternativer Anzeigetext für die Dimensionselemente

==Serien==
Wenn Sie mehrere Serien definiert haben, können Sie über die Auswahlbox "Serie auswählen" die Serie wählen, die Sie bearbeiten wollen.

Um die Einstellungen von einer Serie auf eine andere zu übertragen, können Sie den "Serieneinstellungen übertragen" Button verwenden.

Je nach Diagrammtypen stehen Ihnen unterschiedliche Einstellungsmöglichkeiten zur Verfügung. U.a. sind das z.B.:
:*Typ: Anzeigetyp des Measures
:*Schrift: Schriftart, in der die Beschriftung dargestellt wird
:*Caption: Angezeigter Name in der Legende
:*Beschriftung: wird die Beschriftung dargestellt und wo
:*Format: Formatierung der Beschriftung (z.B. N0, N2,...)
:*Rand: werden die Elemente mit einem Rand dargestellt und ihn welcher Farbe
:*Tooltip Position: was wird im Tooltipp bei einem Datenpunkt angezeigt
:*Sichtbarkeit in Legende:

__NOEDITSECTION__

[[Category:WebApps|Diagramm]]
[[en:WebApps:Diagram]]

Enterprise Edition:Statusleiste

2022-05-11T08:12:31Z

Admin:

Der CoPlanner zeigt in der Statusleiste (am unteren Ende des Fensters) an, mit welchen Einstellungen Sie angemeldet sind.

[[Image:EE_Statusleiste.jpg|thumb|center|Enterprise Edition, Statusleiste ]]

'''CoPlanner Würfel'''

Im rechten Bereich befindet sich ein sog. CoPlanner Würfel. Dieser Würfel kann drei verschiedene Zustände je nach Farbe (Blau, Gelb oder Rot) darstellen.
Im Regelfall ist der CoPlanner Würfel blau.

Ist der Würfel gelb, wird gerade Ihre Anforderung wie z.B. „Öffnen eines Berichts“, am CoPlanner Server bearbeitet.

Der rote Würfel deutet auf ein Problem hin. Er erscheint beispielsweise bei falsch angelieferten Datenformaten für automatisierte Istdatenimporte. Sollte dieser rote Würfel erscheinen, kontaktieren Sie bitte ihren [[Framework:Entwicklermodus#PowerUser|PowerUser]].

'''Supportbutton'''

Ab CoP 10 HF 3.3:

Sofern in der [[Technik:CoPlanner-Server#SvrConfig.xml|Serverkonfiguration]] nichts anderes angegeben ist, öffnet sich über den Button Ihr Browser mit dem CoPlanner Supportformular. Hier können Sie die weiteren Informationen hinzufügen/bearbeiten und das Formular dann abschicken.

Bis CoP 10 HF 3.3:

Das Feature dient dazu, mehr Informationen bei Supportanfragen zu erhalten.
Ist das Feature aktiv, wird die Statusleiste um den Button Support erweitert.

[[Image:EE_Statusleiste_mit_Supportbutton.png|center|Enterprise Edition, Statusleiste]]

Bei Klick auf diesen Button öffnet sich ein Fenster, über welches Benutzer anfragen stellen können.

[[Image:EE_Supportanfrage.png|thumb|center|Enterprise Edition, Supportanfrage Fenster]]

Welche Informationen hier angezeigt werden und wie diese verschickt werden können kann man über die [[Technik:CoPlanner-Server#SvrConfig.xml|SvrConfig.xml]] einstellen.

__NOEDITSECTION__

[[Category:Enterprise_Edition|Statusleiste]]
[[Category:Erste Schritte|Statusleiste]]
[[Category:Benutzeroberfläche|Statusleiste]]

[[en:Enterprise_Edition:Status_Bar]]

Enterprise Edition:Statusleiste

2022-05-11T08:12:05Z

Admin:

Der CoPlanner zeigt in der Statusleiste (am unteren Ende des Fensters) an, mit welchen Einstellungen Sie angemeldet sind.

[[Image:EE_Statusleiste.jpg|thumb|center|Enterprise Edition, Statusleiste ]]

'''CoPlanner Würfel'''

Im rechten Bereich befindet sich ein sog. CoPlanner Würfel. Dieser Würfel kann drei verschiedene Zustände je nach Farbe (Blau, Gelb oder Rot) darstellen.
Im Regelfall ist der CoPlanner Würfel blau.

Ist der Würfel gelb, wird gerade Ihre Anforderung wie z.B. „Öffnen eines Berichts“, am CoPlanner Server bearbeitet.

Der rote Würfel deutet auf ein Problem hin. Er erscheint beispielsweise bei falsch angelieferten Datenformaten für automatisierte Istdatenimporte. Sollte dieser rote Würfel erscheinen, kontaktieren Sie bitte ihren [[Framework:Entwicklermodus#PowerUser|PowerUser]].

'''Supportbutton'''

Ab CoP 10 HF 3.3:

Sofern in der [[Technik:CoPlanner-Server#SvrConfig.xml|Serverkonfiguration]] nichts anderes angegeben ist, öffnet sich über den Button Ihr Browser mit dem CoPlanner Supportformular. Hier können Sie die weiteren Informationen hinzufügen/bearbeiten und das Formular dann abschicken.

Bis CoP 10 HF 3.3:

Das Feature dient dazu, mehr Informationen bei Supportanfragen zu erhalten.
Ist das Feature aktiv, wird die Statusleiste um den Button Support erweitert.

[[Image:EE_Statusleiste_mit_Supportbutton.png|center|Enterprise Edition, Statusleiste]]

Bei Klick auf diesen Button öffnet sich ein Fenster, über welches Benutzer anfragen stellen können.

[[Image:EE_Supportanfrage.png|thumb|center|Enterprise Edition, Supportanfrage Fenster]]

Welche Informationen hier angezeigt werden und wie diese verschickt werden können kann man über die [[Technik:CoPlanner-Server#SvrConfig.xml|SvrConfig.xml]] einstellen.

__NOEDITSECTION__

[[Category:Enterprise_Edition|Statusleiste]]
[[Category:Erste Schritte|Statusleiste]]
[[Category:Benutzeroberfläche|Statusleiste]]

[[en:Enterprise_Edition:Status_Bar]]

Enterprise Edition:Statusleiste

2022-05-11T08:11:58Z

Admin:

Der CoPlanner zeigt in der Statusleiste (am unteren Ende des Fensters) an, mit welchen Einstellungen Sie angemeldet sind.

[[Image:EE_Statusleiste.jpg|thumb|center|Enterprise Edition, Statusleiste ]]

'''CoPlanner Würfel'''

Im rechten Bereich befindet sich ein sog. CoPlanner Würfel. Dieser Würfel kann drei verschiedene Zustände je nach Farbe (Blau, Gelb oder Rot) darstellen.
Im Regelfall ist der CoPlanner Würfel blau.

Ist der Würfel gelb, wird gerade Ihre Anforderung wie z.B. „Öffnen eines Berichts“, am CoPlanner Server bearbeitet.

Der rote Würfel deutet auf ein Problem hin. Er erscheint beispielsweise bei falsch angelieferten Datenformaten für automatisierte Istdatenimporte. Sollte dieser rote Würfel erscheinen, kontaktieren Sie bitte ihren [[Framework:Entwicklermodus#PowerUser|PowerUser]].

'''Supportbutton'''
Ab CoP 10 HF 3.3:

Sofern in der [[Technik:CoPlanner-Server#SvrConfig.xml|Serverkonfiguration]] nichts anderes angegeben ist, öffnet sich über den Button Ihr Browser mit dem CoPlanner Supportformular. Hier können Sie die weiteren Informationen hinzufügen/bearbeiten und das Formular dann abschicken.

Bis CoP 10 HF 3.3:

Das Feature dient dazu, mehr Informationen bei Supportanfragen zu erhalten.
Ist das Feature aktiv, wird die Statusleiste um den Button Support erweitert.

[[Image:EE_Statusleiste_mit_Supportbutton.png|center|Enterprise Edition, Statusleiste]]

Bei Klick auf diesen Button öffnet sich ein Fenster, über welches Benutzer anfragen stellen können.

[[Image:EE_Supportanfrage.png|thumb|center|Enterprise Edition, Supportanfrage Fenster]]

Welche Informationen hier angezeigt werden und wie diese verschickt werden können kann man über die [[Technik:CoPlanner-Server#SvrConfig.xml|SvrConfig.xml]] einstellen.

__NOEDITSECTION__

[[Category:Enterprise_Edition|Statusleiste]]
[[Category:Erste Schritte|Statusleiste]]
[[Category:Benutzeroberfläche|Statusleiste]]

[[en:Enterprise_Edition:Status_Bar]]

Enterprise Edition:Statusleiste

2022-05-11T08:11:49Z

Admin:

Der CoPlanner zeigt in der Statusleiste (am unteren Ende des Fensters) an, mit welchen Einstellungen Sie angemeldet sind.

[[Image:EE_Statusleiste.jpg|thumb|center|Enterprise Edition, Statusleiste ]]

'''CoPlanner Würfel'''

Im rechten Bereich befindet sich ein sog. CoPlanner Würfel. Dieser Würfel kann drei verschiedene Zustände je nach Farbe (Blau, Gelb oder Rot) darstellen.
Im Regelfall ist der CoPlanner Würfel blau.

Ist der Würfel gelb, wird gerade Ihre Anforderung wie z.B. „Öffnen eines Berichts“, am CoPlanner Server bearbeitet.

Der rote Würfel deutet auf ein Problem hin. Er erscheint beispielsweise bei falsch angelieferten Datenformaten für automatisierte Istdatenimporte. Sollte dieser rote Würfel erscheinen, kontaktieren Sie bitte ihren [[Framework:Entwicklermodus#PowerUser|PowerUser]].

'''Supportbutton'''
Ab CoP 10 HF 3.3:
Sofern in der [[Technik:CoPlanner-Server#SvrConfig.xml|Serverkonfiguration]] nichts anderes angegeben ist, öffnet sich über den Button Ihr Browser mit dem CoPlanner Supportformular. Hier können Sie die weiteren Informationen hinzufügen/bearbeiten und das Formular dann abschicken.

Bis CoP 10 HF 3.3:
Das Feature dient dazu, mehr Informationen bei Supportanfragen zu erhalten.
Ist das Feature aktiv, wird die Statusleiste um den Button Support erweitert.

[[Image:EE_Statusleiste_mit_Supportbutton.png|center|Enterprise Edition, Statusleiste]]

Bei Klick auf diesen Button öffnet sich ein Fenster, über welches Benutzer anfragen stellen können.

[[Image:EE_Supportanfrage.png|thumb|center|Enterprise Edition, Supportanfrage Fenster]]

Welche Informationen hier angezeigt werden und wie diese verschickt werden können kann man über die [[Technik:CoPlanner-Server#SvrConfig.xml|SvrConfig.xml]] einstellen.

__NOEDITSECTION__

[[Category:Enterprise_Edition|Statusleiste]]
[[Category:Erste Schritte|Statusleiste]]
[[Category:Benutzeroberfläche|Statusleiste]]

[[en:Enterprise_Edition:Status_Bar]]

CoPlanner-Portal

2022-05-10T12:24:56Z

Admin:

<div id="hauptseite">
<div class="hauptseite-oben" id="hauptseite-willkommen">
<div class="inhalt">
 Dieses Portal bietet Ihnen Neuigkeiten, Informationen und Hilfestellungen rund um die CoPlanner Produkte. Damit Sie einen sicheren Einstieg haben und die Vorteile der CoPlanner Produkte optimal nutzen können, wird das Online-Hilfesystem ständig aktualisiert und verfügt über alle Neuheiten.

Sie haben noch Fragen oder Verbesserungsvorschläge zu diesem Portal? Zögern Sie nicht uns diese zu schicken, wir freuen uns über Ihr [mailto:support@coplanner.com?subject=CoPlanner%20Portal E-Mail].

{{Hinweis|Kategorie=Hinweis|Text=Sie verwenden noch die CoPlanner Version 9.5? Das CoPlanner-Portal für diese Version finden Sie [https://copsupport.coplanner.com/help95/index.php/CoPlanner-Portal hier].}}

{|width="100%" |
 
 

</div></div>
<div class="inhalt"><div class="portale imagemap-inline" align="left"><div class="hauptseite-header-mitte">[[Enterprise Edition|Enterprise Edition]] · [[Framework|Framework]]</div>
<div class="hauptseite-header-mitte">[[Excel Client|Excel Client]] . [[Word_Add-in|Word Add-in]] . [[PowerPoint_Add-in|PowerPoint Add-in]]</div>
[[Portal:Artikel nach Themen|Artikel nach Themen]] · [[Spezial:Alle Seiten|Alphabetischer Index]] · [[:Kategorie:!Hauptkategorie|Artikel nach Kategorien]]
</div>
 

|}

{|width="80%" |
|-
| <div class="hauptseite-header">Tutorials</div>
|-
|[[Tutorial:Anlegen eines neuen Dimensionselements|Anlegen eines neuen Dimensionselements]]
|-
|[[Framework:BI_Center:CoPlanner_W%C3%BCrfel_erstellen|Erstellen eines CoPlanner Würfels für die Umsatzplanung]]
|-
|[[Tutorial:Dynamische_Measurebezeichnungen|Dynamische Measurebezeichnungen]]
|}

__NOTOC__ __NOEDITSECTION__</div>
 
[[en:CoPlanner-Portal]]

CoPlanner-Portal

2022-05-10T12:20:52Z

Admin:

<div id="hauptseite">
<div class="hauptseite-oben" id="hauptseite-willkommen">
<div class="inhalt">
 Dieses Portal bietet Ihnen Neuigkeiten, Informationen und Hilfestellungen rund um die CoPlanner Produkte. Damit Sie einen sicheren Einstieg haben und die Vorteile der CoPlanner Produkte optimal nutzen können, wird das Online-Hilfesystem ständig aktualisiert und verfügt über alle Neuheiten.

Sie haben noch Fragen oder Verbesserungsvorschläge zu diesem Portal? Zögern Sie nicht uns diese zu schicken, wir freuen uns über Ihr [mailto:support@coplanner.com?subject=CoPlanner%20Portal E-Mail].

Sie verwenden noch die CoPlanner Version 9.5? Das CoPlanner-Portal für diese Version finden Sie [https://copsupport.coplanner.com/help95/index.php/CoPlanner-Portal hier].

{|width="100%" |
 
 

</div></div>
<div class="inhalt"><div class="portale imagemap-inline" align="left"><div class="hauptseite-header-mitte">[[Enterprise Edition|Enterprise Edition]] · [[Framework|Framework]]</div>
<div class="hauptseite-header-mitte">[[Excel Client|Excel Client]] . [[Word_Add-in|Word Add-in]] . [[PowerPoint_Add-in|PowerPoint Add-in]]</div>
[[Portal:Artikel nach Themen|Artikel nach Themen]] · [[Spezial:Alle Seiten|Alphabetischer Index]] · [[:Kategorie:!Hauptkategorie|Artikel nach Kategorien]]
</div>
 

|}

{|width="80%" |
|-
| <div class="hauptseite-header">Tutorials</div>
|-
|[[Tutorial:Anlegen eines neuen Dimensionselements|Anlegen eines neuen Dimensionselements]]
|-
|[[Framework:BI_Center:CoPlanner_W%C3%BCrfel_erstellen|Erstellen eines CoPlanner Würfels für die Umsatzplanung]]
|-
|[[Tutorial:Dynamische_Measurebezeichnungen|Dynamische Measurebezeichnungen]]
|}

__NOTOC__ __NOEDITSECTION__</div>
 
[[en:CoPlanner-Portal]]

WebApps:Benutzerverwaltung

2022-05-05T13:50:30Z

Admin:

__TOC__

Verfügbar ab CoP 10 HF 3.0

Mit der Benutzerverwaltung können Benutzer und Benutzerrollen verwaltet werden. Ein Benutzer selbst hat keine spezifischen Rechte, sondern bekommt diese erst durch Zuweisung einer oder mehrerer Benutzergruppen. Es zieht immer das Schreibrecht vor dem Leserecht vor keinem Recht. Besitzt ein Benutzer über eine Rolle das Schreibrecht auf ein Element, auf einer zweiten Rolle auf dieses Element nur ein Leserecht und aus einer dritten Rolle gar keine Rechte, so darf der Benutzer auf dem Element schreiben.

=Systemvoraussetzungen=

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

=Aufruf=
<WebAppUrl des Servers (das + durch Servername/IP Adresse ersetzt)>/useradministration

Zum Beispiel:

<nowiki>https://server:4443/coplanner/useradministration</nowiki>

Aufrufe über z.B. Tiles sollten mit der Session-Variable @Session_WebAppUrl@ gemacht werden. z.B.:

@Session_WebAppUrl@/useradministration

===Erweiterter Aufruf===

:* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.

=Menü=

{| class="wikitable" width="857"
|- {{Tabellentitel}}
| Schaltfläche
| Aktion
|-
| [[Image:ReportViewer_CoPlanner.JPG]]
| Zurück zur letzten davor aufgerufenen Seite.
|-
| [[Image:ReportViewer_MenueOpenClose.JPG]]
| Öffnen/Schließen der Anzeigetexte des Menüs.
|-
| [[Image:ReportViewer_Checkout.JPG]]
| Ein-/Auschecken
|-
|[[Image:ReportViewer_Aktualisieren.JPG]]
|Aktualisieren der Daten in der Maske.
|-
| [[Image:Web Einstellungen Kontursymbol.png]]
| Grundeinstellung für neue und importierte Rollen ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web Useradministration Matrixmaske.png|36px]]
| Öffnet die Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web_Speichern.PNG]]
| Speichert alle Änderungen
|-
| [[Image:Web_Loeschen.PNG]]
| Löscht das ausgewählte Element
|-
| [[Image:Web_NeueRolle.PNG]]
| Neue Benutzerrolle erstellen
|-
| [[Image:Web_NeuerBenutzer.PNG]]
| Neuen Benutzer erstellen
|-
| [[Image:Web_ADImport.PNG]]
| Import aus dem AD
|-
| [[Image:Web Useradministration CopyPermissions.png|36px]]
| Berechtigungen von einer Rolle auf die andere Rolle übertragen ''(Ab CoP 10 HF 3.3)''
|}
=Benutzer=
Für den Benutzer können hier die generellen Einstellungen definiert werden und die Zuteilung zu den Rollen gemacht werden.

'''Anmeldeoptionen'''

:* CoPlanner-Authentifizierung: Der Benutzer wird im CoPlanner System erstellt. D.h. Passwort wird im CoPlanner vergeben.
:* Windows-Authentifizierung: Der Benutzer existiert in der Domäne Ihres Systems. Passwort ist dann selbiges, wie beim Login von Windows. Optional kann auch ein Benutzer einer anderen Domain / eines anderen Rechners angegeben werden. In diesem Fall ist der Benutzername in der Form <Domänenname>\<Benutzername> anzugeben. Also zum Beispiel „meineUnternehmensdomaene\H.Maier“, wobei in diesem Fall beim Login ebenfalls der gesamte Pfad eingegeben werden muss. Beim Login wird dann versucht, den Benutzer auf dieser Domäne anzumelden.
:* SAML-Authentifizierung: die Authentifizierung erfolgt über [[Technik:SAML_2.0|SAML]]

'''Rollenzugehörigkeit'''

Aus dem Baum links können via Drag-and-drop die Benutzerrollen unter dem Suchfeld hineingezogen werden. Mit dem roten x können Zuordnungen wieder entfernt werden.
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn ein Benutzer keiner Rolle zugewiesen ist, wird dieser gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
=Rollen=
Bei den Rollen gibt es die allgemeinen Einstellungen und die detaillierten Berechtigungen.

==Allgemeine Einstellungen==
Neben dem Namen und der Beschreibung kann man definieren ob Benutzer dieser Gruppe auch Szenarien bearbeiten dürfen ohne in den PowerUser-Modus wechseln zu müssen.

'''Neuanlage'''

Zudem werden hier die Defaulteinstellungen für die Rolle vergeben, also, ob zum Bespiel initial alle Elemente aller Dimensionen ein Schreibrecht bekommen oder ein Leserecht oder eben gar keines. Diese Einstellungen werden initial nach dem erstmaligen Speichern der Gruppe angewendet. Ändert man später diese Standardeinstellungen, so wirken diese nur mehr für neu angelegte Dimensionen. Bei bestehenden Dimensionen werden keine Rechte und kein Default geändert. Dies kann man unter Berechtigungen machen.

'''Mitglieder'''

Hier können Mitglieder aus dem Baum links via Drag-and-drop zur Gruppe hinzugefügt werden. Über das rote x können diese auch wieder entfernt werden.

{{Eingabe|Kategorie=Bedienhinweis: Multiselektion (Verschiedene Benutzer einer Rolle zuweisen oder einem Benutzer mehrere Rollen zuweisen)''(Ab CoP 10 HF 3.3)''|Text= 
Es können sowohl mehrere Benutzer in einem Schritt einer Rolle hinzugefügt werden, als auch einem Benutzer mehrere Rollen auf einmal. Beschreibung anhand des Beispiels der Zuweisung mehrerer Benutzer zu einer Rolle. 
1. Markieren Sie die gewünschte Rolle links in der Seitenleiste. 
2. Klicken Sie nun mit gedrückt gehaltener STRG-Taste auf einen der Benutzer, den Sie der Rolle zuweisen möchten. (Das Drücken der STRG-Taste ist WICHTIG da ansonsten eine neue Auswahl erfolgt und damit die gewünschte Zielrolle rechts nicht mehr angezeigt wird) 
3. Nun können Sie sowohl mit der SHIFT-Taste eine ganze Reihe an Benutzer markieren oder mit der STRG-Taste weitere einzelne Benutzer auswählen 
4. Wenn Sie die gewünschten Benutzer ausgewählt haben, können Sie diese nun per Drag and Drop rechts unten in die Mitgliederliste der Rolle ziehen. 

Alternativ kann die Zuordnung der Benutzer zur Rolle auch ohne die Benutzung der Fensterteilung nur in der linken Seitenleiste erfolgen. Markieren Sie dazu mehrere Benutzer links in der Seiteleiste und schieben Sie die markierten Benutzer per Drag and drop ebenfalls in der Seitenleiste auf die gewünschte Rolle.}}

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn eine Rolle keinen Benutzer enthält, wird diese gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
==Berechtigungen==
Die Berechtigungen gliedern sich in die gemeinsamen Objekte, die Szenarien und alle Dimensionen/Subsets.

Auf gemeinsame Objekte können nur Leserechte vergeben werden. Bei den Szenarien können Lese- und Schreibrechte vergeben werden. Hier scheinen keine Defaulteinstellungen auf, da diese über die erste Seite der Rolle definiert wird.

In der Übersicht signalisiert
:* ein grünes Häckchen: das Recht ist für alle Elemente gesetzt
:* ein gelbes Häckchen: das Recht ist für einen Teil der Elemente gesetzt. Ein Tooltip zeigt die Anzahl an, wieviele von wievielen hier vergeben sind.
:* ein rotes Häckchen: das Recht ist für kein Element gesetzt

Bei den Dimensionen kann man zusätzlich zu den Lese- und Schreibrechten auch noch den Standard für diese Dimension für neue Elemente ändern. Ändert man das z.B. von Lesen auf Schreiben, dann können Benutzer dieser Gruppe automatisch auf neu angelegte Dimensionselemente in dieser Struktur schreiben. Bei bestehenden Elementen bleiben die bestehenden Einstellungen auch bei einem Wechsel unverändert.

Mit dem Klick auf den Dimensionsnamen öffnet sich eine Detailansicht der Struktur, auf welcher die Rechte für einzelne Dimensionselemente geändert werden können. Um die gesamte Substruktur zu ändern, klicken Sie auf den Elementnamen und dem entsprechenden Symbol oben neben dem Suchfeld.

= Weitere Menüs/Funktionen =

== Import von Benutzern aus dem Active Directory ==
Das Menü kann über den Button [[Datei:Web ADImport.PNG|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In CoPlanner können Sie Rollen und Benutzer aus dem „Active Directory“ übernehmen. Nach einem Klick auf das Symbol in der Seitenleiste öffnet das folgende Fenster:
[[Datei:WEB IMPORT AD.png|links|rahmenlos|568x568px]]
'''Domäne angeben:'''

Geben Sie in das Feld „Definieren Sie eine LDAP-Abfrage" die Domain an, aus welcher Gruppen und/oder Benutzer nach CoPlanner importiert werden sollen.

Beispiel wenn die Domain lautet: wien.Firma1.com

Folgende Notation ist zulässig: CN=Users, DC=wien, DC=Firma1, DC=com

Ein Klick auf die Schaltfläche laden zeigt die Objekte aus dem „Active Directory“ an.

'''Domänenbezeichnung bei Benutzern voranstellen:'''

Diese Option bewirkt, dass beim Import von Benutzern die Domänenbezeichnung aus dem Textfeld vor dem Benutzernamen eingefügt wird.

'''Rollenzugehörigkeit beibehalten:'''

Aktivieren Sie diese Option, wenn beim Import von Benutzern die Gruppenzugehörigkeit beibehalten werden soll. Anderenfalls werden die Benutzer im CoPlanner unter der Systemgruppe „Jeder“ angelegt.
 

== Grundeinstellungen ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Einstellungen Kontursymbol.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. Es können hier die Standardzugriffsrechte für neu angelegte Rollen definiert werden.

== Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Useradministration Matrixmaske.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In diesem Menü könnnen Berechtigungen je Rolle/Benutzer/Objekt dargestellt werde. Es werden nur Kombinationen dargestellt die keinen Vollzugriff haben.

[[Datei:WebUseradministrationBerechtigungsuebersicht.png|rahmenlos|1346x1346px]]

'''Zugänglich %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der Dimensionselemente ein genereller Zugriff (lesend ODER schreibend) besteht.

'''Lesezugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselemente Lesezugriff besteht.

'''Vollzugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselement Schreibzugriff besteht.

Über einen Klick auf die drei Punkte wird ein Detailsatzsprung durchgeführt. Dadurch kann ich mir die einzelnen Elemente der Dimension anzeigen lassen und kann mir zusätzlich einblenden, von welcher Benutzerrolle, der Benutzer die Berechtigung auf dieses Element bekommen hat.

= Optimierungsmöglichkeiten =
Um z.B. die Performance zu steigern und auch das Handling der Benutzerverwaltung zu erleichtern, kann man im Windowsclient in der Objektverwaltung auf den einzelnen Dimensionen angeben, ob diese in der Benutzerverwaltung verfügbar sein sollten oder nicht. Sofern man "In Benutzerverwaltung verfügbar" deaktiviert, dann haben alle Rollen automatisch Vollzugriff auf diese Dimension. Dies wirkt sich auch positiv auf die Performance beim Speichern in der Benutzerverwaltung aus.

__NOEDITSECTION__

[[Category:WebApps|Benutzerverwaltung]]
[[en:WebApps:UserAdministration]]

WebApps:Benutzerverwaltung

2022-05-05T12:44:22Z

Admin:

__TOC__

Verfügbar ab CoP 10 HF 3.0

Mit der Benutzerverwaltung können Benutzer und Benutzerrollen verwaltet werden. Ein Benutzer selbst hat keine spezifischen Rechte, sondern bekommt diese erst durch Zuweisung einer oder mehrerer Benutzergruppen. Es zieht immer das Schreibrecht vor dem Leserecht vor keinem Recht. Besitzt ein Benutzer über eine Rolle das Schreibrecht auf ein Element, auf einer zweiten Rolle auf dieses Element nur ein Leserecht und aus einer dritten Rolle gar keine Rechte, so darf der Benutzer auf dem Element schreiben.

=Systemvoraussetzungen=

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

=Aufruf=
<WebAppUrl des Servers (das + durch Servername/IP Adresse ersetzt)>/useradministration

Zum Beispiel:

<nowiki>https://server:4443/coplanner/useradministration</nowiki>

Aufrufe über z.B. Tiles sollten mit der Session-Variable @Session_WebAppUrl@ gemacht werden. z.B.:

@Session_WebAppUrl@/useradministration

===Erweiterter Aufruf===

:* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.

=Menü=

{| class="wikitable" width="857"
|- {{Tabellentitel}}
| Schaltfläche
| Aktion
|-
| [[Image:ReportViewer_CoPlanner.JPG]]
| Zurück zur letzten davor aufgerufenen Seite.
|-
| [[Image:ReportViewer_MenueOpenClose.JPG]]
| Öffnen/Schließen der Anzeigetexte des Menüs.
|-
| [[Image:ReportViewer_Checkout.JPG]]
| Ein-/Auschecken
|-
|[[Image:ReportViewer_Aktualisieren.JPG]]
|Aktualisieren der Daten in der Maske.
|-
| [[Image:Web Einstellungen Kontursymbol.png]]
| Grundeinstellung für neue und importierte Rollen ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web Useradministration Matrixmaske.png|36px]]
| Öffnet die Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web_Speichern.PNG]]
| Speichert alle Änderungen
|-
| [[Image:Web_Loeschen.PNG]]
| Löscht das ausgewählte Element
|-
| [[Image:Web_NeueRolle.PNG]]
| Neue Benutzerrolle erstellen
|-
| [[Image:Web_NeuerBenutzer.PNG]]
| Neuen Benutzer erstellen
|-
| [[Image:Web_ADImport.PNG]]
| Import aus dem AD
|-
| [[Image:Web Useradministration CopyPermissions.png|36px]]
| Berechtigungen von einer Rolle auf die andere Rolle übertragen ''(Ab CoP 10 HF 3.3)''
|}
=Benutzer=
Für den Benutzer können hier die generellen Einstellungen definiert werden und die Zuteilung zu den Rollen gemacht werden.

'''Anmeldeoptionen'''

:* CoPlanner-Authentifizierung: Der Benutzer wird im CoPlanner System erstellt. D.h. Passwort wird im CoPlanner vergeben.
:* Windows-Authentifizierung: Der Benutzer existiert in der Domäne Ihres Systems. Passwort ist dann selbiges, wie beim Login von Windows. Optional kann auch ein Benutzer einer anderen Domain / eines anderen Rechners angegeben werden. In diesem Fall ist der Benutzername in der Form <Domänenname>\<Benutzername> anzugeben. Also zum Beispiel „meineUnternehmensdomaene\H.Maier“, wobei in diesem Fall beim Login ebenfalls der gesamte Pfad eingegeben werden muss. Beim Login wird dann versucht, den Benutzer auf dieser Domäne anzumelden.
:* SAML-Authentifizierung: die Authentifizierung erfolgt über [[Technik:SAML_2.0|SAML]]

'''Rollenzugehörigkeit'''

Aus dem Baum links können via Drag-and-drop die Benutzerrollen unter dem Suchfeld hineingezogen werden. Mit dem roten x können Zuordnungen wieder entfernt werden.
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn ein Benutzer keiner Rolle zugewiesen ist, wird dieser gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
=Rollen=
Bei den Rollen gibt es die allgemeinen Einstellungen und die detaillierten Berechtigungen.

==Allgemeine Einstellungen==
Neben dem Namen und der Beschreibung kann man definieren ob Benutzer dieser Gruppe auch Szenarien bearbeiten dürfen ohne in den PowerUser-Modus wechseln zu müssen.

'''Neuanlage'''

Zudem werden hier die Defaulteinstellungen für die Rolle vergeben, also, ob zum Bespiel initial alle Elemente aller Dimensionen ein Schreibrecht bekommen oder ein Leserecht oder eben gar keines. Diese Einstellungen werden initial nach dem erstmaligen Speichern der Gruppe angewendet. Ändert man später diese Standardeinstellungen, so wirken diese nur mehr für neu angelegte Dimensionen. Bei bestehenden Dimensionen werden keine Rechte und kein Default geändert. Dies kann man unter Berechtigungen machen.

'''Mitglieder'''

Hier können Mitglieder aus dem Baum links via Drag-and-drop zur Gruppe hinzugefügt werden. Über das rote x können diese auch wieder entfernt werden.

{{Eingabe|Kategorie=Bedienhinweis: Multiselektion (Verschiedene Benutzer einer Rolle zuweisen oder einem Benutzer mehrere Rollen zuweisen)''(Ab CoP 10 HF 3.3)''|Text= 
Es können sowohl mehrere Benutzer in einem Schritt einer Rolle hinzugefügt werden, als auch einem Benutzer mehrere Rollen auf einmal. Beschreibung anhand des Beispiels der Zuweisung mehrerer Benutzer zu einer Rolle. 
1. Markieren Sie die gewünschte Rolle links in der Seitenleiste. 
2. Klicken Sie nun mit gedrückt gehaltener STRG-Taste auf einen der Benutzer, den Sie der Rolle zuweisen möchten. (Das Drücken der STRG-Taste ist WICHTIG da ansonsten eine neue Auswahl erfolgt und damit die gewünschte Zielrolle rechts nicht mehr angezeigt wird) 
3. Nun können Sie sowohl mit der SHIFT-Taste eine ganze Reihe an Benutzer markieren oder mit der STRG-Taste weitere einzelne Benutzer auswählen 
4. Wenn Sie die gewünschten Benutzer ausgewählt haben, können Sie diese nun per Drag and Drop rechts unten in die Mitgliederliste der Rolle ziehen. 

Alternativ kann die Zuordnung der Benutzer zur Rolle auch ohne die Benutzung der Fensterteilung nur in der linken Seitenleiste erfolgen. Markieren Sie dazu mehrere Benutzer links in der Seiteleiste und schieben Sie die markierten Benutzer per Drag and drop ebenfalls in der Seitenleiste auf die gewünschte Rolle.}}

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn eine Rolle keinen Benutzer enthält, wird diese gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
==Berechtigungen==
Die Berechtigungen gliedern sich in die gemeinsamen Objekte, die Szenarien und alle Dimensionen/Subsets.

Auf gemeinsame Objekte können nur Leserechte vergeben werden. Bei den Szenarien können Lese- und Schreibrechte vergeben werden. Hier scheinen keine Defaulteinstellungen auf, da diese über die erste Seite der Rolle definiert wird.

In der Übersicht signalisiert
:* ein grünes Häckchen: das Recht ist für alle Elemente gesetzt
:* ein gelbes Häckchen: das Recht ist für einen Teil der Elemente gesetzt. Ein Tooltip zeigt die Anzahl an, wieviele von wievielen hier vergeben sind.
:* ein rotes Häckchen: das Recht ist für kein Element gesetzt

Bei den Dimensionen kann man zusätzlich zu den Lese- und Schreibrechten auch noch den Standard für diese Dimension für neue Elemente ändern. Ändert man das z.B. von Lesen auf Schreiben, dann können Benutzer dieser Gruppe automatisch auf neu angelegte Dimensionselemente in dieser Struktur schreiben. Bei bestehenden Elementen bleiben die bestehenden Einstellungen auch bei einem Wechsel unverändert.

Mit dem Klick auf den Dimensionsnamen öffnet sich eine Detailansicht der Struktur, auf welcher die Rechte für einzelne Dimensionselemente geändert werden können. Um die gesamte Substruktur zu ändern, klicken Sie auf den Elementnamen und dem entsprechenden Symbol oben neben dem Suchfeld.

= Weitere Menüs/Funktionen =

== Import von Benutzern aus dem Active Directory ==
Das Menü kann über den Button [[Datei:Web ADImport.PNG|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In CoPlanner können Sie Rollen und Benutzer aus dem „Active Directory“ übernehmen. Nach einem Klick auf das Symbol in der Seitenleiste öffnet das folgende Fenster:
[[Datei:WEB IMPORT AD.png|links|rahmenlos|568x568px]]
'''Domäne angeben:'''

Geben Sie in das Feld „Definieren Sie eine LDAP-Abfrage" die Domain an, aus welcher Gruppen und/oder Benutzer nach CoPlanner importiert werden sollen.

Beispiel wenn die Domain lautet: wien.Firma1.com

Folgende Notation ist zulässig: CN=Users, DC=wien, DC=Firma1, DC=com

Ein Klick auf die Schaltfläche laden zeigt die Objekte aus dem „Active Directory“ an.

'''Domänenbezeichnung bei Benutzern voranstellen:'''

Diese Option bewirkt, dass beim Import von Benutzern die Domänenbezeichnung aus dem Textfeld vor dem Benutzernamen eingefügt wird.

'''Rollenzugehörigkeit beibehalten:'''

Aktivieren Sie diese Option, wenn beim Import von Benutzern die Gruppenzugehörigkeit beibehalten werden soll. Anderenfalls werden die Benutzer im CoPlanner unter der Systemgruppe „Jeder“ angelegt.
 

== Grundeinstellungen ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Einstellungen Kontursymbol.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. Es können hier die Standardzugriffsrechte für neu angelegte Rollen definiert werden.

== Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Useradministration Matrixmaske.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In diesem Menü könnnen Berechtigungen je Rolle/Benutzer/Objekt dargestellt werde. Es werden nur Kombinationen dargestellt die keinen Vollzugriff haben.

[[Datei:WebUseradministrationBerechtigungsuebersicht.png|rahmenlos|1346x1346px]]

'''Zugänglich %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der Dimensionselemente ein genereller Zugriff (lesend ODER schreibend) besteht.

'''Lesezugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselemente Lesezugriff besteht.

'''Vollzugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselement Schreibzugriff besteht.

Über einen Klick auf die drei Punkte wird ein Detailsatzsprung durchgeführt. Dadurch kann ich mir die einzelnen Elemente der Dimension anzeigen lassen und kann mir zusätzlich einblenden, von welcher Benutzerrolle, der Benutzer die Berechtigung auf dieses Element bekommen hat.

__NOEDITSECTION__

[[Category:WebApps|Benutzerverwaltung]]
[[en:WebApps:UserAdministration]]

WebApps:Benutzerverwaltung

2022-05-05T12:42:49Z

Admin:

__TOC__

Verfügbar ab CoP 10 HF 3.0

Mit der Benutzerverwaltung können Benutzer und Benutzerrollen verwaltet werden. Ein Benutzer selbst hat keine spezifischen Rechte, sondern bekommt diese erst durch Zuweisung einer oder mehrerer Benutzergruppen. Es zieht immer das Schreibrecht vor dem Leserecht vor keinem Recht. Besitzt ein Benutzer über eine Rolle das Schreibrecht auf ein Element, auf einer zweiten Rolle auf dieses Element nur ein Leserecht und aus einer dritten Rolle gar keine Rechte, so darf der Benutzer auf dem Element schreiben.

=Systemvoraussetzungen=

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

=Aufruf=
<WebAppUrl des Servers (das + durch Servername/IP Adresse ersetzt)>/useradministration

Zum Beispiel:

<nowiki>https://server:4443/coplanner/useradministration</nowiki>

Aufrufe über z.B. Tiles sollten mit der Session-Variable @Session_WebAppUrl@ gemacht werden. z.B.:

@Session_WebAppUrl@/useradministration

===Erweiterter Aufruf===

:* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.

=Menü=

{| class="wikitable" width="857"
|- {{Tabellentitel}}
| Schaltfläche
| Aktion
|-
| [[Image:ReportViewer_CoPlanner.JPG]]
| Zurück zur letzten davor aufgerufenen Seite.
|-
| [[Image:ReportViewer_MenueOpenClose.JPG]]
| Öffnen/Schließen der Anzeigetexte des Menüs.
|-
| [[Image:ReportViewer_Checkout.JPG]]
| Ein-/Auschecken
|-
|[[Image:ReportViewer_Aktualisieren.JPG]]
|Aktualisieren der Daten in der Maske.
|-
| [[Image:Web Einstellungen Kontursymbol.png]]
| Grundeinstellung für neue und importierte Rollen ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web Useradministration Matrixmaske.png|36px]]
| Öffnet die Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web_Speichern.PNG]]
| Speichert alle Änderungen
|-
| [[Image:Web_Loeschen.PNG]]
| Löscht das ausgewählte Element
|-
| [[Image:Web_NeueRolle.PNG]]
| Neue Benutzerrolle erstellen
|-
| [[Image:Web_NeuerBenutzer.PNG]]
| Neuen Benutzer erstellen
|-
| [[Image:Web_ADImport.PNG]]
| Import aus dem AD
|-
| [[Image:Web Useradministration CopyPermissions.png|36px]]
| Berechtigungen von einer Rolle auf die andere Rolle übertragen ''(Ab CoP 10 HF 3.3)''
|}
=Benutzer=
Für den Benutzer können hier die generellen Einstellungen definiert werden und die Zuteilung zu den Rollen gemacht werden.

'''Anmeldeoptionen'''

:* CoPlanner-Authentifizierung: Der Benutzer wird im CoPlanner System erstellt. D.h. Passwort wird im CoPlanner vergeben.
:* Windows-Authentifizierung: Der Benutzer existiert in der Domäne Ihres Systems. Passwort ist dann selbiges, wie beim Login von Windows. Optional kann auch ein Benutzer einer anderen Domain / eines anderen Rechners angegeben werden. In diesem Fall ist der Benutzername in der Form <Domänenname>\<Benutzername> anzugeben. Also zum Beispiel „meineUnternehmensdomaene\H.Maier“, wobei in diesem Fall beim Login ebenfalls der gesamte Pfad eingegeben werden muss. Beim Login wird dann versucht, den Benutzer auf dieser Domäne anzumelden.
:* SAML-Authentifizierung: die Authentifizierung erfolgt über [[Technik:SAML_2.0|SAML]]

'''Rollenzugehörigkeit'''

Aus dem Baum links können via Drag-and-drop die Benutzerrollen unter dem Suchfeld hineingezogen werden. Mit dem roten x können Zuordnungen wieder entfernt werden.
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn ein Benutzer keiner Rolle zugewiesen ist, wird dieser gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
=Rollen=
Bei den Rollen gibt es die allgemeinen Einstellungen und die detaillierten Berechtigungen.

==Allgemeine Einstellungen==
Neben dem Namen und der Beschreibung kann man definieren ob Benutzer dieser Gruppe auch Szenarien bearbeiten dürfen ohne in den PowerUser-Modus wechseln zu müssen.

'''Neuanlage'''

Zudem werden hier die Defaulteinstellungen für die Rolle vergeben, also, ob zum Bespiel initial alle Elemente aller Dimensionen ein Schreibrecht bekommen oder ein Leserecht oder eben gar keines. Diese Einstellungen werden initial nach dem erstmaligen Speichern der Gruppe angewendet. Ändert man später diese Standardeinstellungen, so wirken diese nur mehr für neu angelegte Dimensionen. Bei bestehenden Dimensionen werden keine Rechte und kein Default geändert. Dies kann man unter Berechtigungen machen.

'''Mitglieder'''

Hier können Mitglieder aus dem Baum links via Drag-and-drop zur Gruppe hinzugefügt werden. Über das rote x können diese auch wieder entfernt werden.

{{Eingabe|Kategorie=Bedienhinweis: Multiselektion (Verschiedene Benutzer einer Rolle zuweisen oder einem Benutzer mehrere Rollen zuweisen)<style="color: black;">''(Ab CoP 10 HF 3.3)''</style>|Text=
Es können sowohl mehrere Benutzer in einem Schritt einer Rolle hinzugefügt werden, als auch einem Benutzer mehrere Rollen auf einmal. Beschreibung anhand des Beispiels der Zuweisung mehrerer Benutzer zu einer Rolle. 
1. Markieren Sie die gewünschte Rolle links in der Seitenleiste. 
2. Klicken Sie nun mit gedrückt gehaltener STRG-Taste auf einen der Benutzer, den Sie der Rolle zuweisen möchten. (Das Drücken der STRG-Taste ist WICHTIG da ansonsten eine neue Auswahl erfolgt und damit die gewünschte Zielrolle rechts nicht mehr angezeigt wird) 
3. Nun können Sie sowohl mit der SHIFT-Taste eine ganze Reihe an Benutzer markieren oder mit der STRG-Taste weitere einzelne Benutzer auswählen 
4. Wenn Sie die gewünschten Benutzer ausgewählt haben, können Sie diese nun per Drag and Drop rechts unten in die Mitgliederliste der Rolle ziehen. 

Alternativ kann die Zuordnung der Benutzer zur Rolle auch ohne die Benutzung der Fensterteilung nur in der linken Seitenleiste erfolgen. Markieren Sie dazu mehrere Benutzer links in der Seiteleiste und schieben Sie die markierten Benutzer per Drag and drop ebenfalls in der Seitenleiste auf die gewünschte Rolle.}}

{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn eine Rolle keinen Benutzer enthält, wird diese gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
==Berechtigungen==
Die Berechtigungen gliedern sich in die gemeinsamen Objekte, die Szenarien und alle Dimensionen/Subsets.

Auf gemeinsame Objekte können nur Leserechte vergeben werden. Bei den Szenarien können Lese- und Schreibrechte vergeben werden. Hier scheinen keine Defaulteinstellungen auf, da diese über die erste Seite der Rolle definiert wird.

In der Übersicht signalisiert
:* ein grünes Häckchen: das Recht ist für alle Elemente gesetzt
:* ein gelbes Häckchen: das Recht ist für einen Teil der Elemente gesetzt. Ein Tooltip zeigt die Anzahl an, wieviele von wievielen hier vergeben sind.
:* ein rotes Häckchen: das Recht ist für kein Element gesetzt

Bei den Dimensionen kann man zusätzlich zu den Lese- und Schreibrechten auch noch den Standard für diese Dimension für neue Elemente ändern. Ändert man das z.B. von Lesen auf Schreiben, dann können Benutzer dieser Gruppe automatisch auf neu angelegte Dimensionselemente in dieser Struktur schreiben. Bei bestehenden Elementen bleiben die bestehenden Einstellungen auch bei einem Wechsel unverändert.

Mit dem Klick auf den Dimensionsnamen öffnet sich eine Detailansicht der Struktur, auf welcher die Rechte für einzelne Dimensionselemente geändert werden können. Um die gesamte Substruktur zu ändern, klicken Sie auf den Elementnamen und dem entsprechenden Symbol oben neben dem Suchfeld.

= Weitere Menüs/Funktionen =

== Import von Benutzern aus dem Active Directory ==
Das Menü kann über den Button [[Datei:Web ADImport.PNG|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In CoPlanner können Sie Rollen und Benutzer aus dem „Active Directory“ übernehmen. Nach einem Klick auf das Symbol in der Seitenleiste öffnet das folgende Fenster:
[[Datei:WEB IMPORT AD.png|links|rahmenlos|568x568px]]
'''Domäne angeben:'''

Geben Sie in das Feld „Definieren Sie eine LDAP-Abfrage" die Domain an, aus welcher Gruppen und/oder Benutzer nach CoPlanner importiert werden sollen.

Beispiel wenn die Domain lautet: wien.Firma1.com

Folgende Notation ist zulässig: CN=Users, DC=wien, DC=Firma1, DC=com

Ein Klick auf die Schaltfläche laden zeigt die Objekte aus dem „Active Directory“ an.

'''Domänenbezeichnung bei Benutzern voranstellen:'''

Diese Option bewirkt, dass beim Import von Benutzern die Domänenbezeichnung aus dem Textfeld vor dem Benutzernamen eingefügt wird.

'''Rollenzugehörigkeit beibehalten:'''

Aktivieren Sie diese Option, wenn beim Import von Benutzern die Gruppenzugehörigkeit beibehalten werden soll. Anderenfalls werden die Benutzer im CoPlanner unter der Systemgruppe „Jeder“ angelegt.
 

== Grundeinstellungen ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Einstellungen Kontursymbol.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. Es können hier die Standardzugriffsrechte für neu angelegte Rollen definiert werden.

== Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Useradministration Matrixmaske.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In diesem Menü könnnen Berechtigungen je Rolle/Benutzer/Objekt dargestellt werde. Es werden nur Kombinationen dargestellt die keinen Vollzugriff haben.

[[Datei:WebUseradministrationBerechtigungsuebersicht.png|rahmenlos|1346x1346px]]

'''Zugänglich %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der Dimensionselemente ein genereller Zugriff (lesend ODER schreibend) besteht.

'''Lesezugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselemente Lesezugriff besteht.

'''Vollzugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselement Schreibzugriff besteht.

Über einen Klick auf die drei Punkte wird ein Detailsatzsprung durchgeführt. Dadurch kann ich mir die einzelnen Elemente der Dimension anzeigen lassen und kann mir zusätzlich einblenden, von welcher Benutzerrolle, der Benutzer die Berechtigung auf dieses Element bekommen hat.

__NOEDITSECTION__

[[Category:WebApps|Benutzerverwaltung]]
[[en:WebApps:UserAdministration]]

WebApps:Benutzerverwaltung

2022-05-05T12:41:23Z

Admin:

__TOC__

Verfügbar ab CoP 10 HF 3.0

Mit der Benutzerverwaltung können Benutzer und Benutzerrollen verwaltet werden. Ein Benutzer selbst hat keine spezifischen Rechte, sondern bekommt diese erst durch Zuweisung einer oder mehrerer Benutzergruppen. Es zieht immer das Schreibrecht vor dem Leserecht vor keinem Recht. Besitzt ein Benutzer über eine Rolle das Schreibrecht auf ein Element, auf einer zweiten Rolle auf dieses Element nur ein Leserecht und aus einer dritten Rolle gar keine Rechte, so darf der Benutzer auf dem Element schreiben.

=Systemvoraussetzungen=

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

=Aufruf=
<WebAppUrl des Servers (das + durch Servername/IP Adresse ersetzt)>/useradministration

Zum Beispiel:

<nowiki>https://server:4443/coplanner/useradministration</nowiki>

Aufrufe über z.B. Tiles sollten mit der Session-Variable @Session_WebAppUrl@ gemacht werden. z.B.:

@Session_WebAppUrl@/useradministration

===Erweiterter Aufruf===

:* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.

=Menü=

{| class="wikitable" width="857"
|- {{Tabellentitel}}
| Schaltfläche
| Aktion
|-
| [[Image:ReportViewer_CoPlanner.JPG]]
| Zurück zur letzten davor aufgerufenen Seite.
|-
| [[Image:ReportViewer_MenueOpenClose.JPG]]
| Öffnen/Schließen der Anzeigetexte des Menüs.
|-
| [[Image:ReportViewer_Checkout.JPG]]
| Ein-/Auschecken
|-
|[[Image:ReportViewer_Aktualisieren.JPG]]
|Aktualisieren der Daten in der Maske.
|-
| [[Image:Web Einstellungen Kontursymbol.png]]
| Grundeinstellung für neue und importierte Rollen ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web Useradministration Matrixmaske.png|36px]]
| Öffnet die Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web_Speichern.PNG]]
| Speichert alle Änderungen
|-
| [[Image:Web_Loeschen.PNG]]
| Löscht das ausgewählte Element
|-
| [[Image:Web_NeueRolle.PNG]]
| Neue Benutzerrolle erstellen
|-
| [[Image:Web_NeuerBenutzer.PNG]]
| Neuen Benutzer erstellen
|-
| [[Image:Web_ADImport.PNG]]
| Import aus dem AD
|-
| [[Image:Web Useradministration CopyPermissions.png|36px]]
| Berechtigungen von einer Rolle auf die andere Rolle übertragen ''(Ab CoP 10 HF 3.3)''
|}
=Benutzer=
Für den Benutzer können hier die generellen Einstellungen definiert werden und die Zuteilung zu den Rollen gemacht werden.

'''Anmeldeoptionen'''

:* CoPlanner-Authentifizierung: Der Benutzer wird im CoPlanner System erstellt. D.h. Passwort wird im CoPlanner vergeben.
:* Windows-Authentifizierung: Der Benutzer existiert in der Domäne Ihres Systems. Passwort ist dann selbiges, wie beim Login von Windows. Optional kann auch ein Benutzer einer anderen Domain / eines anderen Rechners angegeben werden. In diesem Fall ist der Benutzername in der Form <Domänenname>\<Benutzername> anzugeben. Also zum Beispiel „meineUnternehmensdomaene\H.Maier“, wobei in diesem Fall beim Login ebenfalls der gesamte Pfad eingegeben werden muss. Beim Login wird dann versucht, den Benutzer auf dieser Domäne anzumelden.
:* SAML-Authentifizierung: die Authentifizierung erfolgt über [[Technik:SAML_2.0|SAML]]

'''Rollenzugehörigkeit'''

Aus dem Baum links können via Drag-and-drop die Benutzerrollen unter dem Suchfeld hineingezogen werden. Mit dem roten x können Zuordnungen wieder entfernt werden.
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn ein Benutzer keiner Rolle zugewiesen ist, wird dieser gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
=Rollen=
Bei den Rollen gibt es die allgemeinen Einstellungen und die detaillierten Berechtigungen.

==Allgemeine Einstellungen==
Neben dem Namen und der Beschreibung kann man definieren ob Benutzer dieser Gruppe auch Szenarien bearbeiten dürfen ohne in den PowerUser-Modus wechseln zu müssen.

'''Neuanlage'''

Zudem werden hier die Defaulteinstellungen für die Rolle vergeben, also, ob zum Bespiel initial alle Elemente aller Dimensionen ein Schreibrecht bekommen oder ein Leserecht oder eben gar keines. Diese Einstellungen werden initial nach dem erstmaligen Speichern der Gruppe angewendet. Ändert man später diese Standardeinstellungen, so wirken diese nur mehr für neu angelegte Dimensionen. Bei bestehenden Dimensionen werden keine Rechte und kein Default geändert. Dies kann man unter Berechtigungen machen.

'''Mitglieder'''

Hier können Mitglieder aus dem Baum links via Drag-and-drop zur Gruppe hinzugefügt werden. Über das rote x können diese auch wieder entfernt werden.

{{Eingabe|Kategorie=Bedienhinweis: Multiselektion (Verschiedene Benutzer einer Rolle zuweisen oder einem Benutzer mehrere Rollen zuweisen)''(Ab CoP 10 HF 3.3)''|Text=
Es können sowohl mehrere Benutzer in einem Schritt einer Rolle hinzugefügt werden, als auch einem Benutzer mehrere Rollen auf einmal. Beschreibung anhand des Beispiels der Zuweisung mehrerer Benutzer zu einer Rolle. 
1. Markieren Sie die gewünschte Rolle links in der Seitenleiste. 
2. Klicken Sie nun mit gedrückt gehaltener STRG-Taste auf einen der Benutzer, den Sie der Rolle zuweisen möchten. (Das Drücken der STRG-Taste ist WICHTIG da ansonsten eine neue Auswahl erfolgt und damit die gewünschte Zielrolle rechts nicht mehr angezeigt wird) 
3. Nun können Sie sowohl mit der SHIFT-Taste eine ganze Reihe an Benutzer markieren oder mit der STRG-Taste weitere einzelne Benutzer auswählen 
4. Wenn Sie die gewünschten Benutzer ausgewählt haben, können Sie diese nun per Drag and Drop rechts unten in die Mitgliederliste der Rolle ziehen. 

Alternativ kann die Zuordnung der Benutzer zur Rolle auch ohne die Benutzung der Fensterteilung nur in der linken Seitenleiste erfolgen. Markieren Sie dazu mehrere Benutzer links in der Seiteleiste und schieben Sie die markierten Benutzer per Drag and drop ebenfalls in der Seitenleiste auf die gewünschte Rolle.}}

{| {{Bausteindesign2}}
|-
| '''Bedienhinweis: Multiselektion (Verschiedene Benutzer einer Rolle zuweisen oder einem Benutzer mehrere Rollen zuweisen)''' ''(Ab CoP 10 HF 3.3)''  

|}
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn eine Rolle keinen Benutzer enthält, wird diese gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
==Berechtigungen==
Die Berechtigungen gliedern sich in die gemeinsamen Objekte, die Szenarien und alle Dimensionen/Subsets.

Auf gemeinsame Objekte können nur Leserechte vergeben werden. Bei den Szenarien können Lese- und Schreibrechte vergeben werden. Hier scheinen keine Defaulteinstellungen auf, da diese über die erste Seite der Rolle definiert wird.

In der Übersicht signalisiert
:* ein grünes Häckchen: das Recht ist für alle Elemente gesetzt
:* ein gelbes Häckchen: das Recht ist für einen Teil der Elemente gesetzt. Ein Tooltip zeigt die Anzahl an, wieviele von wievielen hier vergeben sind.
:* ein rotes Häckchen: das Recht ist für kein Element gesetzt

Bei den Dimensionen kann man zusätzlich zu den Lese- und Schreibrechten auch noch den Standard für diese Dimension für neue Elemente ändern. Ändert man das z.B. von Lesen auf Schreiben, dann können Benutzer dieser Gruppe automatisch auf neu angelegte Dimensionselemente in dieser Struktur schreiben. Bei bestehenden Elementen bleiben die bestehenden Einstellungen auch bei einem Wechsel unverändert.

Mit dem Klick auf den Dimensionsnamen öffnet sich eine Detailansicht der Struktur, auf welcher die Rechte für einzelne Dimensionselemente geändert werden können. Um die gesamte Substruktur zu ändern, klicken Sie auf den Elementnamen und dem entsprechenden Symbol oben neben dem Suchfeld.

= Weitere Menüs/Funktionen =

== Import von Benutzern aus dem Active Directory ==
Das Menü kann über den Button [[Datei:Web ADImport.PNG|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In CoPlanner können Sie Rollen und Benutzer aus dem „Active Directory“ übernehmen. Nach einem Klick auf das Symbol in der Seitenleiste öffnet das folgende Fenster:
[[Datei:WEB IMPORT AD.png|links|rahmenlos|568x568px]]
'''Domäne angeben:'''

Geben Sie in das Feld „Definieren Sie eine LDAP-Abfrage" die Domain an, aus welcher Gruppen und/oder Benutzer nach CoPlanner importiert werden sollen.

Beispiel wenn die Domain lautet: wien.Firma1.com

Folgende Notation ist zulässig: CN=Users, DC=wien, DC=Firma1, DC=com

Ein Klick auf die Schaltfläche laden zeigt die Objekte aus dem „Active Directory“ an.

'''Domänenbezeichnung bei Benutzern voranstellen:'''

Diese Option bewirkt, dass beim Import von Benutzern die Domänenbezeichnung aus dem Textfeld vor dem Benutzernamen eingefügt wird.

'''Rollenzugehörigkeit beibehalten:'''

Aktivieren Sie diese Option, wenn beim Import von Benutzern die Gruppenzugehörigkeit beibehalten werden soll. Anderenfalls werden die Benutzer im CoPlanner unter der Systemgruppe „Jeder“ angelegt.
 

== Grundeinstellungen ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Einstellungen Kontursymbol.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. Es können hier die Standardzugriffsrechte für neu angelegte Rollen definiert werden.

== Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Useradministration Matrixmaske.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In diesem Menü könnnen Berechtigungen je Rolle/Benutzer/Objekt dargestellt werde. Es werden nur Kombinationen dargestellt die keinen Vollzugriff haben.

[[Datei:WebUseradministrationBerechtigungsuebersicht.png|rahmenlos|1346x1346px]]

'''Zugänglich %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der Dimensionselemente ein genereller Zugriff (lesend ODER schreibend) besteht.

'''Lesezugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselemente Lesezugriff besteht.

'''Vollzugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselement Schreibzugriff besteht.

Über einen Klick auf die drei Punkte wird ein Detailsatzsprung durchgeführt. Dadurch kann ich mir die einzelnen Elemente der Dimension anzeigen lassen und kann mir zusätzlich einblenden, von welcher Benutzerrolle, der Benutzer die Berechtigung auf dieses Element bekommen hat.

__NOEDITSECTION__

[[Category:WebApps|Benutzerverwaltung]]
[[en:WebApps:UserAdministration]]

WebApps:Benutzerverwaltung

2022-05-05T12:40:30Z

Admin:

__TOC__

Verfügbar ab CoP 10 HF 3.0

Mit der Benutzerverwaltung können Benutzer und Benutzerrollen verwaltet werden. Ein Benutzer selbst hat keine spezifischen Rechte, sondern bekommt diese erst durch Zuweisung einer oder mehrerer Benutzergruppen. Es zieht immer das Schreibrecht vor dem Leserecht vor keinem Recht. Besitzt ein Benutzer über eine Rolle das Schreibrecht auf ein Element, auf einer zweiten Rolle auf dieses Element nur ein Leserecht und aus einer dritten Rolle gar keine Rechte, so darf der Benutzer auf dem Element schreiben.

=Systemvoraussetzungen=

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

=Aufruf=
<WebAppUrl des Servers (das + durch Servername/IP Adresse ersetzt)>/useradministration

Zum Beispiel:

<nowiki>https://server:4443/coplanner/useradministration</nowiki>

Aufrufe über z.B. Tiles sollten mit der Session-Variable @Session_WebAppUrl@ gemacht werden. z.B.:

@Session_WebAppUrl@/useradministration

===Erweiterter Aufruf===

:* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.

=Menü=

{| class="wikitable" width="857"
|- {{Tabellentitel}}
| Schaltfläche
| Aktion
|-
| [[Image:ReportViewer_CoPlanner.JPG]]
| Zurück zur letzten davor aufgerufenen Seite.
|-
| [[Image:ReportViewer_MenueOpenClose.JPG]]
| Öffnen/Schließen der Anzeigetexte des Menüs.
|-
| [[Image:ReportViewer_Checkout.JPG]]
| Ein-/Auschecken
|-
|[[Image:ReportViewer_Aktualisieren.JPG]]
|Aktualisieren der Daten in der Maske.
|-
| [[Image:Web Einstellungen Kontursymbol.png]]
| Grundeinstellung für neue und importierte Rollen ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web Useradministration Matrixmaske.png|36px]]
| Öffnet die Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web_Speichern.PNG]]
| Speichert alle Änderungen
|-
| [[Image:Web_Loeschen.PNG]]
| Löscht das ausgewählte Element
|-
| [[Image:Web_NeueRolle.PNG]]
| Neue Benutzerrolle erstellen
|-
| [[Image:Web_NeuerBenutzer.PNG]]
| Neuen Benutzer erstellen
|-
| [[Image:Web_ADImport.PNG]]
| Import aus dem AD
|-
| [[Image:Web Useradministration CopyPermissions.png|36px]]
| Berechtigungen von einer Rolle auf die andere Rolle übertragen ''(Ab CoP 10 HF 3.3)''
|}
=Benutzer=
Für den Benutzer können hier die generellen Einstellungen definiert werden und die Zuteilung zu den Rollen gemacht werden.

'''Anmeldeoptionen'''

:* CoPlanner-Authentifizierung: Der Benutzer wird im CoPlanner System erstellt. D.h. Passwort wird im CoPlanner vergeben.
:* Windows-Authentifizierung: Der Benutzer existiert in der Domäne Ihres Systems. Passwort ist dann selbiges, wie beim Login von Windows. Optional kann auch ein Benutzer einer anderen Domain / eines anderen Rechners angegeben werden. In diesem Fall ist der Benutzername in der Form <Domänenname>\<Benutzername> anzugeben. Also zum Beispiel „meineUnternehmensdomaene\H.Maier“, wobei in diesem Fall beim Login ebenfalls der gesamte Pfad eingegeben werden muss. Beim Login wird dann versucht, den Benutzer auf dieser Domäne anzumelden.
:* SAML-Authentifizierung: die Authentifizierung erfolgt über [[Technik:SAML_2.0|SAML]]

'''Rollenzugehörigkeit'''

Aus dem Baum links können via Drag-and-drop die Benutzerrollen unter dem Suchfeld hineingezogen werden. Mit dem roten x können Zuordnungen wieder entfernt werden.
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn ein Benutzer keiner Rolle zugewiesen ist, wird dieser gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
=Rollen=
Bei den Rollen gibt es die allgemeinen Einstellungen und die detaillierten Berechtigungen.

==Allgemeine Einstellungen==
Neben dem Namen und der Beschreibung kann man definieren ob Benutzer dieser Gruppe auch Szenarien bearbeiten dürfen ohne in den PowerUser-Modus wechseln zu müssen.

'''Neuanlage'''

Zudem werden hier die Defaulteinstellungen für die Rolle vergeben, also, ob zum Bespiel initial alle Elemente aller Dimensionen ein Schreibrecht bekommen oder ein Leserecht oder eben gar keines. Diese Einstellungen werden initial nach dem erstmaligen Speichern der Gruppe angewendet. Ändert man später diese Standardeinstellungen, so wirken diese nur mehr für neu angelegte Dimensionen. Bei bestehenden Dimensionen werden keine Rechte und kein Default geändert. Dies kann man unter Berechtigungen machen.

'''Mitglieder'''

Hier können Mitglieder aus dem Baum links via Drag-and-drop zur Gruppe hinzugefügt werden. Über das rote x können diese auch wieder entfernt werden.

{{Eingabe|Kategorie=Bedienhinweis: Multiselektion (Verschiedene Benutzer einer Rolle zuweisen oder einem Benutzer mehrere Rollen zuweisen)|Text=Es können sowohl mehrere Benutzer in einem Schritt einer Rolle hinzugefügt werden, als auch einem Benutzer mehrere Rollen auf einmal. Beschreibung anhand des Beispiels der Zuweisung mehrerer Benutzer zu einer Rolle. 
1. Markieren Sie die gewünschte Rolle links in der Seitenleiste. 
2. Klicken Sie nun mit gedrückt gehaltener STRG-Taste auf einen der Benutzer, den Sie der Rolle zuweisen möchten. (Das Drücken der STRG-Taste ist WICHTIG da ansonsten eine neue Auswahl erfolgt und damit die gewünschte Zielrolle rechts nicht mehr angezeigt wird) 
3. Nun können Sie sowohl mit der SHIFT-Taste eine ganze Reihe an Benutzer markieren oder mit der STRG-Taste weitere einzelne Benutzer auswählen 
4. Wenn Sie die gewünschten Benutzer ausgewählt haben, können Sie diese nun per Drag and Drop rechts unten in die Mitgliederliste der Rolle ziehen. 

Alternativ kann die Zuordnung der Benutzer zur Rolle auch ohne die Benutzung der Fensterteilung nur in der linken Seitenleiste erfolgen. Markieren Sie dazu mehrere Benutzer links in der Seiteleiste und schieben Sie die markierten Benutzer per Drag and drop ebenfalls in der Seitenleiste auf die gewünschte Rolle.}}

{| {{Bausteindesign2}}
|-
| '''Bedienhinweis: Multiselektion (Verschiedene Benutzer einer Rolle zuweisen oder einem Benutzer mehrere Rollen zuweisen)''' ''(Ab CoP 10 HF 3.3)''  

|}
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn eine Rolle keinen Benutzer enthält, wird diese gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
==Berechtigungen==
Die Berechtigungen gliedern sich in die gemeinsamen Objekte, die Szenarien und alle Dimensionen/Subsets.

Auf gemeinsame Objekte können nur Leserechte vergeben werden. Bei den Szenarien können Lese- und Schreibrechte vergeben werden. Hier scheinen keine Defaulteinstellungen auf, da diese über die erste Seite der Rolle definiert wird.

In der Übersicht signalisiert
:* ein grünes Häckchen: das Recht ist für alle Elemente gesetzt
:* ein gelbes Häckchen: das Recht ist für einen Teil der Elemente gesetzt. Ein Tooltip zeigt die Anzahl an, wieviele von wievielen hier vergeben sind.
:* ein rotes Häckchen: das Recht ist für kein Element gesetzt

Bei den Dimensionen kann man zusätzlich zu den Lese- und Schreibrechten auch noch den Standard für diese Dimension für neue Elemente ändern. Ändert man das z.B. von Lesen auf Schreiben, dann können Benutzer dieser Gruppe automatisch auf neu angelegte Dimensionselemente in dieser Struktur schreiben. Bei bestehenden Elementen bleiben die bestehenden Einstellungen auch bei einem Wechsel unverändert.

Mit dem Klick auf den Dimensionsnamen öffnet sich eine Detailansicht der Struktur, auf welcher die Rechte für einzelne Dimensionselemente geändert werden können. Um die gesamte Substruktur zu ändern, klicken Sie auf den Elementnamen und dem entsprechenden Symbol oben neben dem Suchfeld.

= Weitere Menüs/Funktionen =

== Import von Benutzern aus dem Active Directory ==
Das Menü kann über den Button [[Datei:Web ADImport.PNG|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In CoPlanner können Sie Rollen und Benutzer aus dem „Active Directory“ übernehmen. Nach einem Klick auf das Symbol in der Seitenleiste öffnet das folgende Fenster:
[[Datei:WEB IMPORT AD.png|links|rahmenlos|568x568px]]
'''Domäne angeben:'''

Geben Sie in das Feld „Definieren Sie eine LDAP-Abfrage" die Domain an, aus welcher Gruppen und/oder Benutzer nach CoPlanner importiert werden sollen.

Beispiel wenn die Domain lautet: wien.Firma1.com

Folgende Notation ist zulässig: CN=Users, DC=wien, DC=Firma1, DC=com

Ein Klick auf die Schaltfläche laden zeigt die Objekte aus dem „Active Directory“ an.

'''Domänenbezeichnung bei Benutzern voranstellen:'''

Diese Option bewirkt, dass beim Import von Benutzern die Domänenbezeichnung aus dem Textfeld vor dem Benutzernamen eingefügt wird.

'''Rollenzugehörigkeit beibehalten:'''

Aktivieren Sie diese Option, wenn beim Import von Benutzern die Gruppenzugehörigkeit beibehalten werden soll. Anderenfalls werden die Benutzer im CoPlanner unter der Systemgruppe „Jeder“ angelegt.
 

== Grundeinstellungen ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Einstellungen Kontursymbol.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. Es können hier die Standardzugriffsrechte für neu angelegte Rollen definiert werden.

== Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Useradministration Matrixmaske.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In diesem Menü könnnen Berechtigungen je Rolle/Benutzer/Objekt dargestellt werde. Es werden nur Kombinationen dargestellt die keinen Vollzugriff haben.

[[Datei:WebUseradministrationBerechtigungsuebersicht.png|rahmenlos|1346x1346px]]

'''Zugänglich %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der Dimensionselemente ein genereller Zugriff (lesend ODER schreibend) besteht.

'''Lesezugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselemente Lesezugriff besteht.

'''Vollzugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselement Schreibzugriff besteht.

Über einen Klick auf die drei Punkte wird ein Detailsatzsprung durchgeführt. Dadurch kann ich mir die einzelnen Elemente der Dimension anzeigen lassen und kann mir zusätzlich einblenden, von welcher Benutzerrolle, der Benutzer die Berechtigung auf dieses Element bekommen hat.

__NOEDITSECTION__

[[Category:WebApps|Benutzerverwaltung]]
[[en:WebApps:UserAdministration]]

WebApps:Benutzerverwaltung

2022-05-05T12:39:53Z

Admin:

__TOC__

Verfügbar ab CoP 10 HF 3.0

Mit der Benutzerverwaltung können Benutzer und Benutzerrollen verwaltet werden. Ein Benutzer selbst hat keine spezifischen Rechte, sondern bekommt diese erst durch Zuweisung einer oder mehrerer Benutzergruppen. Es zieht immer das Schreibrecht vor dem Leserecht vor keinem Recht. Besitzt ein Benutzer über eine Rolle das Schreibrecht auf ein Element, auf einer zweiten Rolle auf dieses Element nur ein Leserecht und aus einer dritten Rolle gar keine Rechte, so darf der Benutzer auf dem Element schreiben.

=Systemvoraussetzungen=

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

=Aufruf=
<WebAppUrl des Servers (das + durch Servername/IP Adresse ersetzt)>/useradministration

Zum Beispiel:

<nowiki>https://server:4443/coplanner/useradministration</nowiki>

Aufrufe über z.B. Tiles sollten mit der Session-Variable @Session_WebAppUrl@ gemacht werden. z.B.:

@Session_WebAppUrl@/useradministration

===Erweiterter Aufruf===

:* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.

=Menü=

{| class="wikitable" width="857"
|- {{Tabellentitel}}
| Schaltfläche
| Aktion
|-
| [[Image:ReportViewer_CoPlanner.JPG]]
| Zurück zur letzten davor aufgerufenen Seite.
|-
| [[Image:ReportViewer_MenueOpenClose.JPG]]
| Öffnen/Schließen der Anzeigetexte des Menüs.
|-
| [[Image:ReportViewer_Checkout.JPG]]
| Ein-/Auschecken
|-
|[[Image:ReportViewer_Aktualisieren.JPG]]
|Aktualisieren der Daten in der Maske.
|-
| [[Image:Web Einstellungen Kontursymbol.png]]
| Grundeinstellung für neue und importierte Rollen ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web Useradministration Matrixmaske.png|36px]]
| Öffnet die Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web_Speichern.PNG]]
| Speichert alle Änderungen
|-
| [[Image:Web_Loeschen.PNG]]
| Löscht das ausgewählte Element
|-
| [[Image:Web_NeueRolle.PNG]]
| Neue Benutzerrolle erstellen
|-
| [[Image:Web_NeuerBenutzer.PNG]]
| Neuen Benutzer erstellen
|-
| [[Image:Web_ADImport.PNG]]
| Import aus dem AD
|-
| [[Image:Web Useradministration CopyPermissions.png|36px]]
| Berechtigungen von einer Rolle auf die andere Rolle übertragen ''(Ab CoP 10 HF 3.3)''
|}
=Benutzer=
Für den Benutzer können hier die generellen Einstellungen definiert werden und die Zuteilung zu den Rollen gemacht werden.

'''Anmeldeoptionen'''

:* CoPlanner-Authentifizierung: Der Benutzer wird im CoPlanner System erstellt. D.h. Passwort wird im CoPlanner vergeben.
:* Windows-Authentifizierung: Der Benutzer existiert in der Domäne Ihres Systems. Passwort ist dann selbiges, wie beim Login von Windows. Optional kann auch ein Benutzer einer anderen Domain / eines anderen Rechners angegeben werden. In diesem Fall ist der Benutzername in der Form <Domänenname>\<Benutzername> anzugeben. Also zum Beispiel „meineUnternehmensdomaene\H.Maier“, wobei in diesem Fall beim Login ebenfalls der gesamte Pfad eingegeben werden muss. Beim Login wird dann versucht, den Benutzer auf dieser Domäne anzumelden.
:* SAML-Authentifizierung: die Authentifizierung erfolgt über [[Technik:SAML_2.0|SAML]]

'''Rollenzugehörigkeit'''

Aus dem Baum links können via Drag-and-drop die Benutzerrollen unter dem Suchfeld hineingezogen werden. Mit dem roten x können Zuordnungen wieder entfernt werden.
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn ein Benutzer keiner Rolle zugewiesen ist, wird dieser gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
=Rollen=
Bei den Rollen gibt es die allgemeinen Einstellungen und die detaillierten Berechtigungen.

==Allgemeine Einstellungen==
Neben dem Namen und der Beschreibung kann man definieren ob Benutzer dieser Gruppe auch Szenarien bearbeiten dürfen ohne in den PowerUser-Modus wechseln zu müssen.

'''Neuanlage'''

Zudem werden hier die Defaulteinstellungen für die Rolle vergeben, also, ob zum Bespiel initial alle Elemente aller Dimensionen ein Schreibrecht bekommen oder ein Leserecht oder eben gar keines. Diese Einstellungen werden initial nach dem erstmaligen Speichern der Gruppe angewendet. Ändert man später diese Standardeinstellungen, so wirken diese nur mehr für neu angelegte Dimensionen. Bei bestehenden Dimensionen werden keine Rechte und kein Default geändert. Dies kann man unter Berechtigungen machen.

'''Mitglieder'''

Hier können Mitglieder aus dem Baum links via Drag-and-drop zur Gruppe hinzugefügt werden. Über das rote x können diese auch wieder entfernt werden.

{{Eingabe|Kategorie=Bedienhinweis: Multiselektion (Verschiedene Benutzer einer Rolle zuweisen oder einem Benutzer mehrere Rollen zuweisen)'|Text=Es können sowohl mehrere Benutzer in einem Schritt einer Rolle hinzugefügt werden, als auch einem Benutzer mehrere Rollen auf einmal. Beschreibung anhand des Beispiels der Zuweisung mehrerer Benutzer zu einer Rolle. 
1. Markieren Sie die gewünschte Rolle links in der Seitenleiste. 
2. Klicken Sie nun mit gedrückt gehaltener STRG-Taste auf einen der Benutzer, den Sie der Rolle zuweisen möchten. (Das Drücken der STRG-Taste ist WICHTIG da ansonsten eine neue Auswahl erfolgt und damit die gewünschte Zielrolle rechts nicht mehr angezeigt wird) 
3. Nun können Sie sowohl mit der SHIFT-Taste eine ganze Reihe an Benutzer markieren oder mit der STRG-Taste weitere einzelne Benutzer auswählen 
4. Wenn Sie die gewünschten Benutzer ausgewählt haben, können Sie diese nun per Drag and Drop rechts unten in die Mitgliederliste der Rolle ziehen. 

Alternativ kann die Zuordnung der Benutzer zur Rolle auch ohne die Benutzung der Fensterteilung nur in der linken Seitenleiste erfolgen. Markieren Sie dazu mehrere Benutzer links in der Seiteleiste und schieben Sie die markierten Benutzer per Drag and drop ebenfalls in der Seitenleiste auf die gewünschte Rolle.}}

{| {{Bausteindesign2}}
|-
| '''Bedienhinweis: Multiselektion (Verschiedene Benutzer einer Rolle zuweisen oder einem Benutzer mehrere Rollen zuweisen)''' ''(Ab CoP 10 HF 3.3)''  

|}
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn eine Rolle keinen Benutzer enthält, wird diese gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
==Berechtigungen==
Die Berechtigungen gliedern sich in die gemeinsamen Objekte, die Szenarien und alle Dimensionen/Subsets.

Auf gemeinsame Objekte können nur Leserechte vergeben werden. Bei den Szenarien können Lese- und Schreibrechte vergeben werden. Hier scheinen keine Defaulteinstellungen auf, da diese über die erste Seite der Rolle definiert wird.

In der Übersicht signalisiert
:* ein grünes Häckchen: das Recht ist für alle Elemente gesetzt
:* ein gelbes Häckchen: das Recht ist für einen Teil der Elemente gesetzt. Ein Tooltip zeigt die Anzahl an, wieviele von wievielen hier vergeben sind.
:* ein rotes Häckchen: das Recht ist für kein Element gesetzt

Bei den Dimensionen kann man zusätzlich zu den Lese- und Schreibrechten auch noch den Standard für diese Dimension für neue Elemente ändern. Ändert man das z.B. von Lesen auf Schreiben, dann können Benutzer dieser Gruppe automatisch auf neu angelegte Dimensionselemente in dieser Struktur schreiben. Bei bestehenden Elementen bleiben die bestehenden Einstellungen auch bei einem Wechsel unverändert.

Mit dem Klick auf den Dimensionsnamen öffnet sich eine Detailansicht der Struktur, auf welcher die Rechte für einzelne Dimensionselemente geändert werden können. Um die gesamte Substruktur zu ändern, klicken Sie auf den Elementnamen und dem entsprechenden Symbol oben neben dem Suchfeld.

= Weitere Menüs/Funktionen =

== Import von Benutzern aus dem Active Directory ==
Das Menü kann über den Button [[Datei:Web ADImport.PNG|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In CoPlanner können Sie Rollen und Benutzer aus dem „Active Directory“ übernehmen. Nach einem Klick auf das Symbol in der Seitenleiste öffnet das folgende Fenster:
[[Datei:WEB IMPORT AD.png|links|rahmenlos|568x568px]]
'''Domäne angeben:'''

Geben Sie in das Feld „Definieren Sie eine LDAP-Abfrage" die Domain an, aus welcher Gruppen und/oder Benutzer nach CoPlanner importiert werden sollen.

Beispiel wenn die Domain lautet: wien.Firma1.com

Folgende Notation ist zulässig: CN=Users, DC=wien, DC=Firma1, DC=com

Ein Klick auf die Schaltfläche laden zeigt die Objekte aus dem „Active Directory“ an.

'''Domänenbezeichnung bei Benutzern voranstellen:'''

Diese Option bewirkt, dass beim Import von Benutzern die Domänenbezeichnung aus dem Textfeld vor dem Benutzernamen eingefügt wird.

'''Rollenzugehörigkeit beibehalten:'''

Aktivieren Sie diese Option, wenn beim Import von Benutzern die Gruppenzugehörigkeit beibehalten werden soll. Anderenfalls werden die Benutzer im CoPlanner unter der Systemgruppe „Jeder“ angelegt.
 

== Grundeinstellungen ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Einstellungen Kontursymbol.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. Es können hier die Standardzugriffsrechte für neu angelegte Rollen definiert werden.

== Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Useradministration Matrixmaske.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In diesem Menü könnnen Berechtigungen je Rolle/Benutzer/Objekt dargestellt werde. Es werden nur Kombinationen dargestellt die keinen Vollzugriff haben.

[[Datei:WebUseradministrationBerechtigungsuebersicht.png|rahmenlos|1346x1346px]]

'''Zugänglich %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der Dimensionselemente ein genereller Zugriff (lesend ODER schreibend) besteht.

'''Lesezugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselemente Lesezugriff besteht.

'''Vollzugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselement Schreibzugriff besteht.

Über einen Klick auf die drei Punkte wird ein Detailsatzsprung durchgeführt. Dadurch kann ich mir die einzelnen Elemente der Dimension anzeigen lassen und kann mir zusätzlich einblenden, von welcher Benutzerrolle, der Benutzer die Berechtigung auf dieses Element bekommen hat.

__NOEDITSECTION__

[[Category:WebApps|Benutzerverwaltung]]
[[en:WebApps:UserAdministration]]

WebApps:Benutzerverwaltung

2022-05-05T12:34:56Z

Admin:

__TOC__

Verfügbar ab CoP 10 HF 3.0

Mit der Benutzerverwaltung können Benutzer und Benutzerrollen verwaltet werden. Ein Benutzer selbst hat keine spezifischen Rechte, sondern bekommt diese erst durch Zuweisung einer oder mehrerer Benutzergruppen. Es zieht immer das Schreibrecht vor dem Leserecht vor keinem Recht. Besitzt ein Benutzer über eine Rolle das Schreibrecht auf ein Element, auf einer zweiten Rolle auf dieses Element nur ein Leserecht und aus einer dritten Rolle gar keine Rechte, so darf der Benutzer auf dem Element schreiben.

=Systemvoraussetzungen=

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

=Aufruf=
<WebAppUrl des Servers (das + durch Servername/IP Adresse ersetzt)>/useradministration

Zum Beispiel:

<nowiki>https://server:4443/coplanner/useradministration</nowiki>

Aufrufe über z.B. Tiles sollten mit der Session-Variable @Session_WebAppUrl@ gemacht werden. z.B.:

@Session_WebAppUrl@/useradministration

===Erweiterter Aufruf===

:* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.

=Menü=

{| class="wikitable" width="857"
|- {{Tabellentitel}}
| Schaltfläche
| Aktion
|-
| [[Image:ReportViewer_CoPlanner.JPG]]
| Zurück zur letzten davor aufgerufenen Seite.
|-
| [[Image:ReportViewer_MenueOpenClose.JPG]]
| Öffnen/Schließen der Anzeigetexte des Menüs.
|-
| [[Image:ReportViewer_Checkout.JPG]]
| Ein-/Auschecken
|-
|[[Image:ReportViewer_Aktualisieren.JPG]]
|Aktualisieren der Daten in der Maske.
|-
| [[Image:Web Einstellungen Kontursymbol.png]]
| Grundeinstellung für neue und importierte Rollen ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web Useradministration Matrixmaske.png|36px]]
| Öffnet die Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''
|-
| [[Image:Web_Speichern.PNG]]
| Speichert alle Änderungen
|-
| [[Image:Web_Loeschen.PNG]]
| Löscht das ausgewählte Element
|-
| [[Image:Web_NeueRolle.PNG]]
| Neue Benutzerrolle erstellen
|-
| [[Image:Web_NeuerBenutzer.PNG]]
| Neuen Benutzer erstellen
|-
| [[Image:Web_ADImport.PNG]]
| Import aus dem AD
|-
| [[Image:Web Useradministration CopyPermissions.png|36px]]
| Berechtigungen von einer Rolle auf die andere Rolle übertragen ''(Ab CoP 10 HF 3.3)''
|}
=Benutzer=
Für den Benutzer können hier die generellen Einstellungen definiert werden und die Zuteilung zu den Rollen gemacht werden.

'''Anmeldeoptionen'''

:* CoPlanner-Authentifizierung: Der Benutzer wird im CoPlanner System erstellt. D.h. Passwort wird im CoPlanner vergeben.
:* Windows-Authentifizierung: Der Benutzer existiert in der Domäne Ihres Systems. Passwort ist dann selbiges, wie beim Login von Windows. Optional kann auch ein Benutzer einer anderen Domain / eines anderen Rechners angegeben werden. In diesem Fall ist der Benutzername in der Form <Domänenname>\<Benutzername> anzugeben. Also zum Beispiel „meineUnternehmensdomaene\H.Maier“, wobei in diesem Fall beim Login ebenfalls der gesamte Pfad eingegeben werden muss. Beim Login wird dann versucht, den Benutzer auf dieser Domäne anzumelden.
:* SAML-Authentifizierung: die Authentifizierung erfolgt über [[Technik:SAML_2.0|SAML]]

'''Rollenzugehörigkeit'''

Aus dem Baum links können via Drag-and-drop die Benutzerrollen unter dem Suchfeld hineingezogen werden. Mit dem roten x können Zuordnungen wieder entfernt werden.
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn ein Benutzer keiner Rolle zugewiesen ist, wird dieser gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
=Rollen=
Bei den Rollen gibt es die allgemeinen Einstellungen und die detaillierten Berechtigungen.

==Allgemeine Einstellungen==
Neben dem Namen und der Beschreibung kann man definieren ob Benutzer dieser Gruppe auch Szenarien bearbeiten dürfen ohne in den PowerUser-Modus wechseln zu müssen.

'''Neuanlage'''

Zudem werden hier die Defaulteinstellungen für die Rolle vergeben, also, ob zum Bespiel initial alle Elemente aller Dimensionen ein Schreibrecht bekommen oder ein Leserecht oder eben gar keines. Diese Einstellungen werden initial nach dem erstmaligen Speichern der Gruppe angewendet. Ändert man später diese Standardeinstellungen, so wirken diese nur mehr für neu angelegte Dimensionen. Bei bestehenden Dimensionen werden keine Rechte und kein Default geändert. Dies kann man unter Berechtigungen machen.

'''Mitglieder'''

Hier können Mitglieder aus dem Baum links via Drag-and-drop zur Gruppe hinzugefügt werden. Über das rote x können diese auch wieder entfernt werden.
{| {{Bausteindesign2}}
|-
| '''Bedienhinweis: Multiselektion (Verschiedene Benutzer einer Rolle zuweisen oder einem Benutzer mehrere Rollen zuweisen)''' ''(Ab CoP 10 HF 3.3)''  Es können sowohl mehrere Benutzer in einem Schritt einer Rolle hinzugefügt werden, als auch einem Benutzer mehrere Rollen auf einmal. Beschreibung anhand des Beispiels der Zuweisung mehrerer Benutzer zu einer Rolle. 
1. Markieren Sie die gewünschte Rolle links in der Seitenleiste. 
2. Klicken Sie nun mit gedrückt gehaltener STRG-Taste auf einen der Benutzer, den Sie der Rolle zuweisen möchten. (Das Drücken der STRG-Taste ist WICHTIG da ansonsten eine neue Auswahl erfolgt und damit die gewünschte Zielrolle rechts nicht mehr angezeigt wird) 
3. Nun können Sie sowohl mit der SHIFT-Taste eine ganze Reihe an Benutzer markieren oder mit der STRG-Taste weitere einzelne Benutzer auswählen 
4. Wenn Sie die gewünschten Benutzer ausgewählt haben, können Sie diese nun per Drag and Drop rechts unten in die Mitgliederliste der Rolle ziehen. 

Alternativ kann die Zuordnung der Benutzer zur Rolle auch ohne die Benutzung der Fensterteilung nur in der linken Seitenleiste erfolgen. Markieren Sie dazu mehrere Benutzer links in der Seiteleiste und schieben Sie die markierten Benutzer per Drag and drop ebenfalls in der Seitenleiste auf die gewünschte Rolle.
|}
{| {{Bausteindesign1}}
|-
| '''Hinweis'''  Wenn eine Rolle keinen Benutzer enthält, wird diese gelb visualisiert. ''(Ab CoP 10 HF 3.3)''
|}
==Berechtigungen==
Die Berechtigungen gliedern sich in die gemeinsamen Objekte, die Szenarien und alle Dimensionen/Subsets.

Auf gemeinsame Objekte können nur Leserechte vergeben werden. Bei den Szenarien können Lese- und Schreibrechte vergeben werden. Hier scheinen keine Defaulteinstellungen auf, da diese über die erste Seite der Rolle definiert wird.

In der Übersicht signalisiert
:* ein grünes Häckchen: das Recht ist für alle Elemente gesetzt
:* ein gelbes Häckchen: das Recht ist für einen Teil der Elemente gesetzt. Ein Tooltip zeigt die Anzahl an, wieviele von wievielen hier vergeben sind.
:* ein rotes Häckchen: das Recht ist für kein Element gesetzt

Bei den Dimensionen kann man zusätzlich zu den Lese- und Schreibrechten auch noch den Standard für diese Dimension für neue Elemente ändern. Ändert man das z.B. von Lesen auf Schreiben, dann können Benutzer dieser Gruppe automatisch auf neu angelegte Dimensionselemente in dieser Struktur schreiben. Bei bestehenden Elementen bleiben die bestehenden Einstellungen auch bei einem Wechsel unverändert.

Mit dem Klick auf den Dimensionsnamen öffnet sich eine Detailansicht der Struktur, auf welcher die Rechte für einzelne Dimensionselemente geändert werden können. Um die gesamte Substruktur zu ändern, klicken Sie auf den Elementnamen und dem entsprechenden Symbol oben neben dem Suchfeld.

= Weitere Menüs/Funktionen =

== Import von Benutzern aus dem Active Directory ==
Das Menü kann über den Button [[Datei:Web ADImport.PNG|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In CoPlanner können Sie Rollen und Benutzer aus dem „Active Directory“ übernehmen. Nach einem Klick auf das Symbol in der Seitenleiste öffnet das folgende Fenster:
[[Datei:WEB IMPORT AD.png|links|rahmenlos|568x568px]]
'''Domäne angeben:'''

Geben Sie in das Feld „Definieren Sie eine LDAP-Abfrage" die Domain an, aus welcher Gruppen und/oder Benutzer nach CoPlanner importiert werden sollen.

Beispiel wenn die Domain lautet: wien.Firma1.com

Folgende Notation ist zulässig: CN=Users, DC=wien, DC=Firma1, DC=com

Ein Klick auf die Schaltfläche laden zeigt die Objekte aus dem „Active Directory“ an.

'''Domänenbezeichnung bei Benutzern voranstellen:'''

Diese Option bewirkt, dass beim Import von Benutzern die Domänenbezeichnung aus dem Textfeld vor dem Benutzernamen eingefügt wird.

'''Rollenzugehörigkeit beibehalten:'''

Aktivieren Sie diese Option, wenn beim Import von Benutzern die Gruppenzugehörigkeit beibehalten werden soll. Anderenfalls werden die Benutzer im CoPlanner unter der Systemgruppe „Jeder“ angelegt.
 

== Grundeinstellungen ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Einstellungen Kontursymbol.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. Es können hier die Standardzugriffsrechte für neu angelegte Rollen definiert werden.

== Berechtigungsübersicht ''(Ab CoP 10 HF 3.3)''==
Das Menü kann über den Button [[Datei:Web Useradministration Matrixmaske.png|22x22px]] in der seitlichen Symbolleiste aufgerufen werden. In diesem Menü könnnen Berechtigungen je Rolle/Benutzer/Objekt dargestellt werde. Es werden nur Kombinationen dargestellt die keinen Vollzugriff haben.

[[Datei:WebUseradministrationBerechtigungsuebersicht.png|rahmenlos|1346x1346px]]

'''Zugänglich %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der Dimensionselemente ein genereller Zugriff (lesend ODER schreibend) besteht.

'''Lesezugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselemente Lesezugriff besteht.

'''Vollzugriff %:''' Über diese Spalte wird angezeigt auf wieviel Prozent der zugänglichen Dimensionselement Schreibzugriff besteht.

Über einen Klick auf die drei Punkte wird ein Detailsatzsprung durchgeführt. Dadurch kann ich mir die einzelnen Elemente der Dimension anzeigen lassen und kann mir zusätzlich einblenden, von welcher Benutzerrolle, der Benutzer die Berechtigung auf dieses Element bekommen hat.

__NOEDITSECTION__

[[Category:WebApps|Benutzerverwaltung]]
[[en:WebApps:UserAdministration]]

WebApps:Eingabemaske

2022-05-05T12:33:19Z

Admin:

__TOC__

Verfügbar ab 9.5 HF 2.1

=Systemvoraussetzungen=

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

=Aufruf=
@Session_WebAppUrl@/pivottable/?pivotform=<Maskenname>

Beispiel:

<nowiki>https://servername:4444/coplanner/pivottable/?pivotform=EM Bilanz PLAN</nowiki>

{| {{Bausteindesign1}}
|-
|'''Hinweis'''  Die Groß-/Kleinschreibung des Maskennamens muss richtig sein, sonst öffnet sich die Maske nicht.
|}

==Erweiterter Aufruf==

:* Title: Der Name, der anstatt dem Maskennamen angezeigt wird
:* Description: Beschreibung, welche optional unter dem Title/Maskenname angezeigt wird
:* ShowFields: Definiert, ob der Felderbereich beim Öffnen der Maske schon angezeigt wird. Der Default beim Öffnen ist false.

Beispiel:

<nowiki>https://servername:4444/coplanner/pivottable/?pivotform=EM Bilanz PLAN&Title=Bilanz PLAN&Description=Planen Sie hier Ihre Bilanz&ShowFields=true</nowiki>
:* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.
:* disableFields: Definiert, ob der Felderbereich angezeigt werden kann oder nicht (true bedeutet, dass der Felderbereich nicht eingeblendet werden kann). Der Default beim Öffnen ist false.
:* contextFilters: Definiert die Filterwerte, mit der die Maske geöffnet wird
:* contextDimensions: Definiert die Elemente der Achsen, mit der denen die Maske geöffnet wird

Beispiel:

Übergabe auf Filter Zeit, Filteroperator =, Element 2 und Unternehmen, Filteroperator me+under, Element 1

&contextFilters=Zeit eq 2 and Unternehmen mu 1

Übergabe auf Achse Zeit mit den Elementen 1,2,2010010101 und Achse Unternehmen mit 2
&contextDimensions=Zeit:1,2,2010010101 and Unternehmen:2

Bei Verwendung von " and " im Filternamen bzg. übergebenen Wert oder Leerzeichen muss wie folgt vorgegangen werden:

&contextFilters="Mein Textfilter" eq "Text mit Leerzeichen"

&contextDimensions="My time and test dimension:1,2,2010010101"

Beispiel für die Verwendung in einem berechneten Measure im Cube. Hier wird die Maske MAX_Rueckstellungen aufgerufen und die Filter SonstigeErloesundKostenarten, die Zeit und die PC/KST übergeben. Zusätzlich wird noch der Titel Rückstellungen für die Maske definiert und die Session übergeben.

Link für den Windowsclient:

IIF([ErloesKosten LC]<>0,'cop://name=Rückstellungen & aktion=Matrix Builder Eingabemaske & p1=MAX_Rueckstellungen_PLAN & p2= & p3= & p4=ContextFiltersetting:SonstigeErloesundKostenarten=[Attribut_SonstigeErloesundKostenarten]=2=FilterDim=SonstigeErloesundKostenarten|Zeit=[Attribut_Zeit]=2=FilterDim=Zeit|PC/KST=[Attribut_PCKST]=2=FilterDim=PCKST & frmlocation=Work & name=Rückstellungen','')

entspricht für den Webclient:

IIF([ErloesKosten LC]<>0,'@Session_WebAppUrl@/pivottable/?pivotform=MAX_Rueckstellungen_PLAN&contextFilters="SonstigeErloesundKostenarten" mu [Attribut_SonstigeErloesundKostenarten] and "Zeit" mu [Attribut_Zeit] and "PC/KST" mu [Attribut_PCKST]&title=Rückstellungen&SessionID=@Session_ID@','')

Operatoren:
{| class="wikitable" width="857px"
|- {{Tabellentitel}}
| Filteroperator
| Aufruf im Kontext
| Beschreibung
|-
| [[Image:Filter_Operand_Alle.jpg]]
| mu
| Ausgewähltes Element und alle Ebenen darunter werden dargestellt.
|-
| [[Image:Filter_Operand_ParentChild.jpg]]
| mf
| Ausgewähltes Element und eine Ebenen darunter werden dargestellt.
|-
| [[Image:Filter_Operand_OhneParent.jpg]]
| fu
| Alle Ebenen unter dem ausgewähltem Element werden dargestellt.
|-
| [[Image:Filter_Nur_Ebene_darunter.jpg]]
| un
| Eine Ebene unter dem ausgewähltem Element wird dargestellt.
|-
| =
| eq
| Nur Werte dieses Dimensionselement werden dargestellt.
|-
| <>
| ne
| Alle Werte werden dargestellt, nur die des ausgewählten Filterelements nicht.
|}

In Datensatzmasken stehen für Wertfelder folgende Operatoren zur Verfügung:

{| class="wikitable" width="857px"
|- {{Tabellentitel}}
| Filteroperand
| Aufruf im Kontext
| Beschreibung
|-
| =
| eq
| Standardmäßig wird der Operator “=“ vorgeschlagen, alle Datensätze werden angezeigt.
|-
| <
| lt
| Datensätze kleiner als der eingegebene Wert werden angezeigt.
|-
| >
| gt
| Datensätze größer als der eingegebene Wert werden angezeigt.
|-
| <=
| le
| Datensätze kleiner oder gleich dem eingegebenen Wert werden angezeigt.
|-
| >=
| ge
| Datensätze größer oder gleich dem eingegebenen Wert werden angezeigt.
|-
| <>
| ne
| Jene Datensätze, die größer oder kleiner als der eingegebene Wert sind, werden angezeigt.
|-
| LIKE
| lk
| Jene Datensätze, die den eingegebenen Ausdruck enthalten, werden angezeigt.
|}

=Menü=

{| class="wikitable" width={{{breite|50%}}}
|-
|[[Image:ReportViewer_CoPlanner.JPG]]
|Zurück zur letzten davor aufgerufenen Seite.
|-
|[[Image:ReportViewer_MenueOpenClose.JPG]]
|Öffnen/Schließen der Anzeigetexte des Menüs.
|-
|[[Image:ReportViewer_Aktualisieren.JPG]]
|Aktualisieren der Daten in der Maske.
|-
|[[Image:ReportViewer_Filterbereich.JPG]]
|Ein-/Ausblenden des Filterbereichs.
|-
|[[Image:Pivotform_Felderbereich.JPG]]
|Ein-/Ausblenden des Felderbereichs.
|-
|[[Image:ReportViewer_Nullwertunterdrueckung.JPG]]
|Aktivieren/Deaktivieren der Nullwertunterdrückung.
|-
|[[Image:Pivotform_Detailsatz.JPG]]
|Aktivieren/Deaktivieren Detailsatzsprung.
|-
|[[Image:Pivotform_Loeschen.JPG]]
|Löschen der Daten.
|-
|[[Image:Pivotform_Zurueck.JPG]]
|Zurück zur übergeordneten Maske.
|-
|[[Image:Veroeffentlichen.JPG]]
|[[WebApps:Veröffentlichen|Veröffentlichen]] der Maske.
|-
|[[Image:Pivotform_ExcelExport.PNG]]
|Öffnet einen [[WebApps:Eingabemaske_Excel_Export|Dialog]] für den Export in eine XLSX-Datei.
|-
|[[Image:Pivotform_CSVExport.PNG]]
|Öffnet einen [[WebApps:Eingabemaske_CSV_Export|Dialog]] für den Export der Maske im CSV-Format.
|-
|[[Image:Pivotform_ExcelExport_AutoLogin.PNG]]
|Exportiert die Maske nach Excel und führt einen automatischen Login für das Excel Addin durch. Der Button ist nur sichtbar, wenn die Option AutomatedLoginAfterExcelExportAvailable in der Maske aktiviert ist. Das CoPlanner Excel Addin muss am Clientrechner installiert sein, damit das funktioniert. Zusätzlich muss im Excel die Option 'Geschützte Ansicht für Dateien aus den Internet aktivieren' deaktiviert sein.
|-
|[[Image:Web_Achsendrehen.PNG]]
|Dreht die Achsen. Halten Sie die Steuerungstaste gedrückt, um nur die Measures auf die gegenüberliegende Achse zu legen.
|}

Menü mit Anzeigetexten:

[[Image:Pivotform_Menue.JPG]]

=Aufbau der Maske=
[[Image:Web_EM_Allgmein.png|1400px]]

==Felderbereich==
Über den Felderbereich können Sie sich Measures beliebig ein- und ausblenden, Filter hinzufügen/entfernen, Dimensionen auf Achsen geben und wegnehmen, Achsen tauschen, die Achse wechseln, auf welcher die Measures angezeigt werden. Das können Sie machen, indem Sie Measures oder Dimensionen via Drag&Drop direkt in der Maske an die gewünschte Position ziehen, oder das entsprechende Element im Felderbereich unter Measures, Spalten, Zeilen oder Filter ziehen.

Der Felderbereich ist über das Menü auf-/zuklappbar. Über die URL kann gesteuert werden, ob dieser Bereich initial angezeigt wird oder nicht.

===Suche===
Über die Suche können Sie die Measures und Dimensionen nach Namen filtern.

===Dimensionen===
Hier werden die zur Verfügung stehenden Dimensionen angezeigt. Via Drag&Drop können diese entweder direkt in der Maske auf eine gewünschte Position oder unten im Felderbereich in den entsprechenden Bereich gezogen werden.

===Measures===
Hier werden die zur Verfügung stehenden Measures angezeigt. Über den Schalter vor den Measures können diese ein-/ausgeblendet werden. Mit dem angezeigten Namen "Alle" können Sie alle Measures mit nur einem Klick einblenden. Beim Ausblenden bleibt immer ein Measure aktiv, da die Maske mindestens ein Measure beinhalten muss.

Die Measures können aber auch via Drag&Drop entsprechend in die Maske oder unten in den Felderbereich "Measures" gezogen werden.

===Anzeigedefinition===
In der Anzeigedefinition wird angezeigt, welche Dimensionen auf welcher Achse dargestellt werden, welche Measures angezeigt werden und welche Filter gesetzt sind.

Über das Markieren eines Elements und "Entf" können Element gelöscht werden. Alternativ können diese auch zurück in den Dimensionen/Measurebereich oberhalb gezogen werden, um sie zu entfernen.

Die Dimensionen, welche auf den Zeilen/Spalten definiert sind, können über das Filtersymbol neben dem Dimensionsnamen gefiltert werden.

Die Achsen können über das Symbol zwischen dem Spalten und Zeilenbereich getauscht werden.

Die Measures können auf die andere Achse geschoben werden, indem man auf das Symbol rechts neben dem Measures klickt.

==Filterleiste==
Über die Filter in der Filterleiste können Sie wie im Windowsclient die Daten einschränken.

==Datenbereich==
Im Datenbereich werden wie gewohnt, die Measures und Achsen angezeigt und können geändert werden. Im Datenbereich sehen Sie jene Measures, welche im Felderbereich als Measures definiert sind.

==Umgesetzte Funktionen==
Eine Liste der umgesetzten Funktionen der Eingabemasken finden sie [[WebApps:Eingabemaske:_Umgesetzte_Funktionen|hier]].

__NOEDITSECTION__

[[Category:WebApps|Eingabemaske]]
[[en:WebApps:Input_Mask]]

Vorlage:Bausteindesign2

2022-05-05T12:06:46Z

Admin:

cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid hsl(50deg 100% 45%); position:relative;"
<noinclude>
 
{| {{Bausteindesign2}}
|-
|'''Eingabe'''  Geben Sie hier Ihren Text ein.
|}
 

[[Kategorie:Vorlage:Formatierungshilfe|Bausteindesign2]]
</noinclude>

Vorlage:Bausteindesign1

2022-05-05T12:06:12Z

Admin:

cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #24a7d3; position:relative;"
<noinclude>
 
{| {{Bausteindesign1}}
|-
|'''Hinweis'''  Geben Sie hier Ihren Text ein.
|}
 

[[Kategorie:Vorlage:Formatierungshilfe|Bausteindesign1]]
</noinclude>

Vorlage:Hinweis

2022-05-05T12:05:12Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #24a7d3; position:relative;"
|-
|{{{Kategorie}}}  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Hinweis|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Hinweis]]
</noinclude>

Vorlage:Eingabe

2022-05-05T12:04:55Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid hsl(50deg 100% 45%); position:relative;"
|-
|{{{Kategorie}}}  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Eingabe|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Eingabe]]
</noinclude>

Vorlage:Eingabe

2022-05-05T12:03:39Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid hsl(50deg 100% 45%); position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Eingabe|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Eingabe]]
</noinclude>

Vorlage:Eingabe

2022-05-05T12:03:31Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid hsl(50deg 100% 45%); position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Eingabe|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Eingabe]]
</noinclude>

Vorlage:Eingabe

2022-05-05T12:02:01Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid hsl(50,100%,75%); position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Eingabe|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Eingabe]]
</noinclude>

Vorlage:Eingabe

2022-05-05T12:01:50Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid hsl(50,100%,75%); position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Eingabe|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Eingabe]]
</noinclude>

Vorlage:Hinweis

2022-05-05T11:59:30Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #24a7d3; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Hinweis|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Hinweis]]
</noinclude>

Vorlage:Eingabe

2022-05-05T11:58:26Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #F5D471; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Eingabe|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Eingabe]]
</noinclude>

Vorlage:Eingabe

2022-05-05T11:57:44Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #E1B629; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Eingabe|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Eingabe]]
</noinclude>

Vorlage:Eingabe

2022-05-05T11:56:57Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #F5DA81 ; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Eingabe|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Eingabe]]
</noinclude>

Vorlage:Eingabe

2022-05-05T11:55:58Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #ffd700 ; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Eingabe|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Eingabe]]
</noinclude>

Vorlage:Eingabe

2022-05-05T11:54:25Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #d9d2b6 ; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Eingabe|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Eingabe]]
</noinclude>

Framework:Makros

2022-05-05T11:39:20Z

Admin:

__TOC__

Um ein neues Makro zu erstellen, wechseln Sie zunächst in den Entwicklermodus und wählen den Menüpunkt [[Framework:Objektverwaltung|Objektverwaltung]].

Ein Makro ist eine Gruppe von Aktionen, die jeweils eine bestimmte Operation ausführen, wie z.B. das Öffnen eines Formulars oder das Ausführen eines Serverbefehles. Mit Hilfe von Makros können Sie häufig vorkommende Aufgaben automatisieren. Sie können z.B. ein Makro erstellen, das einen [[Framework:Importe|Import]] ausführt, d. h. Daten löscht, diese neu importiert und z. B. im Anschluss einen Erfolgsbericht öffnet, wenn ein Benutzer dieses über einen Menüpunkt aufruft.

Um das Makro mit Eigenschaften zu versehen, öffnet man mit Klick auf die Schaltfläche „Entwurf“, per Klick mit der rechten Maustaste das Kontext-Menü oder per Doppelklick den Batchdesigner. Über den Menüpunkt „Neu“ kann hier auch ein neues Makro angelegt werden.

Zur Verfügung stehende Aktionen:
:*NavAktion
:*ServerBefehl
:*Meldung

Die erstellten Aktionen werden im Batchdesigner dann nach einander abgearbeitet. Um die Reihenfolge der Abarbeitung zu ändern stehen der Button [[image:Icon Pfeil Up.jpg]] als auch [[image:Icon Pfeil Down.jpg]] zur Verfügung.

[[image:Fw_Makrodesigner.jpg|thumb|center|Framework, Batchdesigner]]

Je nach ausgewählter Aktion stehen dem Anwender verschiedene Konfigurationsmöglichkeiten zur Verfügung.

==NavAktion==

NavAktionen ermöglichen es zum Beispiel, Masken, Dimensionen etc. zu öffnen. Zusätzlich können NavAktionen auch zum Beispiel [[Framework:Formeln|Formeln]], [[Framework:Importe|Importe]] etc. ausführen. Eine Beschreibung aller [[Framework:Navigationsaktionen|NavAktionen]] finden Sie [[Framework:Navigationsaktionen|hier]].

[[image:Fw_Makrodesigner_Navaktion.jpg|thumb|center|Framework, NavAktion]]

==ServerBefehl==

Hier stehen verschiedenste Serverbefehle zur Auswahl.

{| class="wikitable" width={{{breite|80%}}}
|-
! Befehl
! Beschreibung
|-
| DBC Execute Procedure
| Es können Stored Procedures ausgeführt werden. Der Name der Stored Procedure muss dabei genau dem Namen der Stored Procedure des SQL Server entsprechen (bspw. sp_calc_table). Zusätzlich können hier auch noch Parameter der Stored Procedure übergeben werden. Die einzelnem Parameter werden dabei durch „;“ getrennt, und beginnen jeweils mit einem „@“ (bspw: @param1=ErsterParameter;@param2=ZweiterParameter). Als Parameter können auch Session Variablen übergeben werden. (bspw.: @Session_PLAN_ID@) Der Datenbank Conneciton String sieht wie folgt aus: Server=ServerName;Initial Catalog=DatabaseName;user id=MyUserId; password=MyPassword
|-
| Plansätze löschen
| Der ServerBefehl Plansätze löschen, löscht alle Datensätze des ausgewählten Plans aller planabhängigen Tabellen. Wird der Plan auf „Aktueller Plan“ gestellt werden nur Datensätze des Planes gelöscht an den der Benutzer angemeldet ist.
|-
| Formula activate
| Dieser Serverbefehl kann [[Framework:Formeln|Formeln]] aktivieren bzw. deaktivieren. Zusätzlich kann die [[Framework:Formeln|Formel]] „Makroaktiv“ gesetzt werden.
|-
| Formelwerk aktivieren
| Aktiviert das CoPlanner Formelwerk.
|-
| Formelwerk deaktivieren
| Deaktiviert das CoPlanner Formelwerk.
|-
| PlanSecurity neu laden
| Lädt die Security für den aktuellen Plan neu.
|-
| Plan kopieren
| Kopiert alle Datensätze von einem Plan in einen anderen Plan.
|-
| Tabellensätze kopieren
| Es werden alle Datensätze innerhalb des ausgewählten Planes einer Tabelle in eine andere Tabelle kopiert. Zusätzlich können hier XML Filter für die Datensätze angegeben werden.
|-
| Tabellensätze löschen
| Es werden alle Datensätze innerhalb des ausgewählten Planes einer Tabelle gelöscht. Zusätzlich können hier XML Filter für die Datensätze angegeben werden.
Neben der Auswahl der Tabelle muss auch ein zu löschender Plan gewählt werden. Dies kann durch explizite Auswahl eines bestimmten Plans oder mit der Funktion „Aktueller Plan“ automatisch bezogen auf den Plan der Anmeldung erfolgen. Bei Wahl der Option „planunabhängig“ werden die Daten der gewählten Tabelle aus allen Plänen gelöscht!
Siehe nachfolgendes Beispiel.
|-
| Tabelle dieses Plans neu rechnen
| Es werden alle Datensätze innerhalb des ausgewählten Planes einer Tabelle neu berechnet. Zusätzlich können hier XML Filter für die Datensätze angegeben werden.
|-
| [[Framework:Importe|Import]] am Server starten
| Startet ein [[Framework:Importe|Importobjekt]] am Server. Da jedes [[Framework:Importe|Importobjekt]] eine Erfolgsmeldung zurückgibt, kann diese Erfolgsmeldung über den Parameter „Rückmeldung aktivieren“ unterdrückt werden.
|-
| Datenbank synchronisieren
| Erzwingt die Synchronisation des CoPlanner Servers und des SQL Servers bevor weitere CoPlanner - Serverbefehle abgearbeitet werden.
|-
| Datenobjekt synchronisieren
| Erzwingt die Synchronisation der angegebenen Tabelle/Dimension und des SQL Servers bevor weitere CoPlanner - Serverbefehle abgearbeitet werden.
|-
| OffeneBerechnungen abschliessen
| Erzwingt die Abarbeitung aller offenen Berechnungen ([[Framework:Formeln|Formeln]]). Anschließend wird einen Datenbanksynchronisation erzwungen, bevor weitere Serverbefehle abgearbeitet werden.
|-
| [[Framework:Formeln|Formel]] ausführen
| Führt die ausgewählte [[Framework:Formeln|Formel]] aus.
|-
| Session Parameter ändern
| Ändert Sessioneigenschaften. Hier kann bspw. angegeben werden, dass der Sessionkontext im Makromode ausgeführt wird, damit in weiterer Folge [[Framework:Formeln|Formeln]] ausgeführt werden deren Eigenschaft ‚Ausführen im Makromode’ gesetzt ist. Dazu geben Sie bitte folgende Parameter an:
Um in den Makromodus zu wechseln: MakroMode=1

Um den Makromodus zu verlassen: MakroMode=0
|-
|OLAP refresh
|Makrobefehl zur Aktualisierung von OLAP-Verbindungen (Verbindungen vom CoPlanner-Server zu SSAS werden geschlossen und bei Bedarf neu aufgebaut). Neben dem Aktualisieren der Dimensionen zielt dieser Befehl auch darauf ab eventuelle AdoMD-Caches (Security) zuverlässig löschen zu können. Nach einem Neustart des Clients sollten geänderte Dimensionselemente im CoPlanner ersichtlich sein.
|-
|Log Level setzen
|Zu Entwicklungszwecken kann man sich sämtliche Meldungen die im Log generiert werden in der Console/Telnet ausgeben lassen. Im Echtbetrieb wird das nicht empfohlen da es zu Performanceverschlechterungen kommen kann.
Konfiguration:
[[image:Fw_Makrodesigner_Loglevel_setzen.jpg|thumb|center|Framework, Makro - Loglevel konfigurieren]]
|-
|Skript am Server ausführen
|Wenn die Option AllowBatchProcessingViaMacro in der svrconifg.xml auf true gesetzt ist, dann kann man diesen Befehl auswählen. Am Server muss dafür ein Ordner Skripts vorhanden sein, welcher die Skriptdateien enthält, die ausgeführt werden können. Zusätzlich kann man Session-Variablen als Parameter übergeben.
|}

===Beispiel Tabellensätze löschen===

Es sollen mit einem Makro alle Datensätze aus einer Tabelle gelöscht werden die zum angemeldeten Plan gehören.
Legen Sie dazu ein neues Makro an und wählen Sie als Aktion „Serverbefehl“ und treffen Sie die Einstellungen wie in folgender Abbildung dargestellt.

[[image:Fw_Makrodesigner_Makro Tabellensaetze loeschen.jpg|thumb|center|Framework, Makro – Tabellensätze löschen]]

Rufen Sie den Filter – Editor auf mit einem Klick auf die Schaltfläche [[image:Icon_Dateiauswahl.jpg‎]].

[[image:Fw_Makrodesigner_Makro Filter Editor.jpg|thumb|center|Framework, Makro – Filter - Editor]]

Wählen Sie aus dem Kombinationslistenfeld den Eintrag „BAB_Plan“ und im Filter „Unternehmen“ die „Bike GmbH“ aus. Mit einem Klick auf die Schaltfläche „Hinzufügen“ wird diese Einstellung übernommen. Durch das Ersetzen des Kriteriums mit der [[Framework:Session-Variablen|Sessionvariable]] @Session_Unternehmen_ID@ bezieht sich dieser Filter immer auf das angemeldete Unternehmen.

Sollten Sie diese Filter mehrmals benötigen, können Sie diesen mit dem Befehl „Filter speichern“ sichern und mit „Filter laden“ wieder einfügen.

===Beispiel Tabellensätze in Abhängigkeit eines Dimensionsattributes löschen===

Es sollen mit einem Makro alle Datensätze aus einer Tabelle gelöscht werden, die einer Attributausprägung in einer Dimension entsprechen. In diesem Beispiel werden aus der Tabelle "Tab1" alle Datensätze gelöscht, die in der Dimension im Attribut "AttribFeld" den Wert "True" enthalten.

[[image:Fw_Makrodesigner_Makro Filter Editor01.png|thumb|center|Framework, Makro – Filter - Editor]]

{| class="wikitable" width={{{breite|50%}}}
|-
! Spalte
! Ausdruck
|-
|Feld
|Standard Dimension Column Name
|-
|Vergleichstyp
|Muss zum Datentyp passen (me ist =, not_me ist <>, usw.)
|-
|Kriterium
|Muss auch zum Datentyp passen
|-
|Type
|BY_ATTRIBVAL_FeldNameInDim (In diesem Beispiel heißt das Attributsfeld in der Dimension "AttribFeld"
|}

===Beispiel Tabellensätze in Abhängigkeit einer Anwendungseigenschaft löschen===

Es sollen mit einem Makro alle Datensätze aus einer Tabelle gelöscht werden, die einem Dimensionselement aus den Anwendungseigenschaften entsprechen.

[[image:Fw_Makrodesigner_Makro Filter Editor02.png|thumb|center|Framework, Makro – Filter - Editor]]

===Tabellensätze in Abhängigkeit einer anderen Tabelle löschen===
Über ein FKT_GetRecord im Kriterium kann eine Eigenschaft aus einer anderen Tabelle abgerufen werden. Hier muss vor dem FKT_GetRecord ein Transform= stehen.

z.B.: Transform=FKT_GetRecord(TabRecordToDelete.Zeit_1,Unternehmen != @Session_Unternehmen_ID@)

Holt den Eintrag der Zeit aus der Zeile der Tabelle TabRecordToDelete, bei der das Unternehmen dem Unternehmen entspricht, auf dem man angemeldet ist.

==Meldung==

Dem Anwender können mit Meldungen Informationen über die Ausführung des Makros am Client angezeigt werden. Dazu wird der Meldungstext, Meldungstitel und der Meldungstyp eingegeben.

[[image:Fw_Makrodesigner_Meldung.jpg|thumb|center|Framework, Makro - Meldung]]

===Meldungstypen===

{| class="wikitable" width={{{breite|100%}}}
|-
|'''Fehler'''

[[image:Fw_Makrodesigner_Meldung_Fehler.jpg|thumb|center|Framework, Makro - Meldung - Fehler]]
|'''Ausnahme'''

[[image:Fw_Makrodesigner_Meldung_Ausnahme.jpg|thumb|center|Framework, Makro - Meldung - Ausnahme]]
|'''Information'''

[[image:Fw_Makrodesigner_Meldung_Information.jpg|thumb|center|Framework, Makro - Meldung - Information]]
|'''Frage'''

[[image:Fw_Makrodesigner_Meldung_Frage.jpg|thumb|center|Framework, Makro - Meldung - Frage]]
|-
|'''Kein Symbol'''

[[image:Fw_Makrodesigner_Meldung_Kein_Symbol.jpg|thumb|center|Framework, Makro - Meldung - Kein Symbol]]
|'''Stop'''

[[image:Fw_Makrodesigner_Meldung_Stop.jpg|thumb|center|Framework, Makro - Meldung - Stop]]
|'''Warnung'''

[[image:Fw_Makrodesigner_Meldung_Warnung.jpg|thumb|center|Framework, Makro - Meldung - Warnung]]
|}

==URL==
Ab CoP 10 HF 2.5

Bietet die Möglichkeit bei im Webclient ausgeführten Makros z.B. andere Masken zu öffnen.

{| {{Bausteindesign2}}
|-
| '''ACHTUNG'''  Nach diesem Schritt werden keine weiteren Schritte des Makros ausgeführt. Sollte es sich bei dem Makro um ein Submakro handeln, werden auch die weiteren Schritte des aufrufenden Makros nicht weiter ausgeführt. Sollte der Schritt durch z.B. eine Fortsetzungsbedingung nicht ausgeführt werden läuft das Makro wie bisher weiter.
|}

Der Kontext kann bei diesem Befehl verwendet werden. Wird das Makro z.B. aus einer Maske aufgerufen und es werden Filter übergeben, so kann man auf diese mit @Context.<Filtername>@ zugreifen. Wird z.B. der Filter PC/KST übergeben, dann könnte so ein Link folgendermaßen aussehen: @Session_WebAppUrl/pivottable/?pivotform=EM Umsatzerloese PLAN&contextFilters="PC/KST" mu @Context.PC/KST@

==Fortsetzungsbedingung==

Die Fortsetzungsbedingung dient dazu, um die Weiterführung des Makros steuern zu können. Wird sie aktiv geschalten, muss die Bedingung zutreffen, um mit dem Makro fortzufahren. Trifft die Bedingung nicht zu, wird das Makro genau an der Stelle beendet. Es besteht die Möglichkeit mittels einer Meldung auf den Abbruch hinzuweisen.

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Inaktiv.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung - Inaktiv]]

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Aktiv.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung - Aktiv]]

Es müssen für die Bedingung beide Ausdrucksfelder befüllt werden. Ein Ausdruck kann eine Abfrage zum CoPlanner Server mittels der Funktionen die das Rechenwerk bereitstellt, ein SQL Statement auf die CoPlanner Systemdatenbank oder ein konstanter Wert sein. Die Abfrage zum CoPlanner Server wird mittels Transform=, eine SQL Server Abfrage mittels Sql= gekennzeichnet. Ein konstanter Wert wird ohne besondere Kennung eingetragen.

Beispiele:

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Sql kombiniert mit CoPlanner Abfrage.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung – Sql kombiniert mit CoPlanner Abfrage]]

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Sql kombiniert mit konstantem Wert.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung - Sql kombiniert mit konstantem Wert]]

[[image:Fw_Makrodesigner_Fortsetzungsbedingung_SessionVariable_Text.png|thumb|center|Framework, Makro - Fortsetzungsbedingung - Session-Variable kombiniert mit konstantem Wert]]

Bei konstanten Werten muss der Datentyp beachtet werden. Liefert die SQL bzw. CoPlanner Abfrage als Ergebnis eine Zeichenfolge, muss der Wert unter einfache Anführungszeichen gestellt werden. Liefert die Abfrage als Ergebnis einen numerischen Wert, entfallen die Anführungszeichen.
Wird eine SQL Abfrage definiert, welche nicht genau einen Wert, sondern eine Ergebnistabelle liefert, wird der Wert der linken, oberen Ecke für den Vergleich herangezogen.

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Ergebnis bei Abfrage mit Tabelle als Ergebnis.jpg|center|Framework, Makro - Fortsetzungsbedingung - Ergebnis bei Abfrage mit Tabelle als Ergebnis]]

Im folgenden SQL Statement-Beispiel wird überprüft ob in der Tabelle CPM_TBL_BUD_PAYMENTS für den aktuellen Plan und das Project an dem der Benutzer gerade angemeldet ist Datensätze vorhanden sind:

''Sql=select cast(count(*) as bigint) from CPM_TBL_BUD_PAYMENTS where COPSYS_PLAN_ID = @Session_PLAN_ID@ and Projects = (select top 1 value from tb_SessionParameters where Name = 'Projects' and COP_SESSION_ID = @Session_ID@)''

Liefert die SQL Abfrage keine einzige Zeile, so kann dies mittels der Konstante ‘NULL‘ abgefragt werden.

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Abfrage ob Datensaetze geliefert werden.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung - Abfrage ob Datensätze geliefert werden]]

Ausdrücke können auch mit CoPlanner [[Framework:Session-Variablen|Sessionvariablen]] versehen werden. Vor der eigentlichen Evaluierung des Ausdrucks werden diese durch den entsprechenden Wert ersetzt. [[Framework:Session-Variablen|Sessionvariablen]] können auch als konstanter Wert verwendet werden.

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Abfrage mit Session Variable.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung - Abfrage mit Session Variable]]

Ist die Option „Meldung bei Nichterfüllung“ aktiviert, wird bei Abbruch des Makros dem Benutzer die Meldung mit dem entsprechenden Text angezeigt. Ist die Option nicht aktiv, wird das Makro ohne weitere Meldung beendet.

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Meldung bei Nichterfuellung.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung - Meldung bei Nichterfüllung]]
__NOEDITSECTION__

[[Category:Framework|Makros]][[Category:Framework Objekte|Makros]]
[[en:Framework:Macros]]

Framework:Makros

2022-05-05T11:38:27Z

Admin:

__TOC__

Um ein neues Makro zu erstellen, wechseln Sie zunächst in den Entwicklermodus und wählen den Menüpunkt [[Framework:Objektverwaltung|Objektverwaltung]].

Ein Makro ist eine Gruppe von Aktionen, die jeweils eine bestimmte Operation ausführen, wie z.B. das Öffnen eines Formulars oder das Ausführen eines Serverbefehles. Mit Hilfe von Makros können Sie häufig vorkommende Aufgaben automatisieren. Sie können z.B. ein Makro erstellen, das einen [[Framework:Importe|Import]] ausführt, d. h. Daten löscht, diese neu importiert und z. B. im Anschluss einen Erfolgsbericht öffnet, wenn ein Benutzer dieses über einen Menüpunkt aufruft.

Um das Makro mit Eigenschaften zu versehen, öffnet man mit Klick auf die Schaltfläche „Entwurf“, per Klick mit der rechten Maustaste das Kontext-Menü oder per Doppelklick den Batchdesigner. Über den Menüpunkt „Neu“ kann hier auch ein neues Makro angelegt werden.

Zur Verfügung stehende Aktionen:
:*NavAktion
:*ServerBefehl
:*Meldung

Die erstellten Aktionen werden im Batchdesigner dann nach einander abgearbeitet. Um die Reihenfolge der Abarbeitung zu ändern stehen der Button [[image:Icon Pfeil Up.jpg]] als auch [[image:Icon Pfeil Down.jpg]] zur Verfügung.

[[image:Fw_Makrodesigner.jpg|thumb|center|Framework, Batchdesigner]]

Je nach ausgewählter Aktion stehen dem Anwender verschiedene Konfigurationsmöglichkeiten zur Verfügung.

==NavAktion==

NavAktionen ermöglichen es zum Beispiel, Masken, Dimensionen etc. zu öffnen. Zusätzlich können NavAktionen auch zum Beispiel [[Framework:Formeln|Formeln]], [[Framework:Importe|Importe]] etc. ausführen. Eine Beschreibung aller [[Framework:Navigationsaktionen|NavAktionen]] finden Sie [[Framework:Navigationsaktionen|hier]].

[[image:Fw_Makrodesigner_Navaktion.jpg|thumb|center|Framework, NavAktion]]

==ServerBefehl==

Hier stehen verschiedenste Serverbefehle zur Auswahl.

{| class="wikitable" width={{{breite|80%}}}
|-
| Befehl
| Beschreibung
|-
| DBC Execute Procedure
| Es können Stored Procedures ausgeführt werden. Der Name der Stored Procedure muss dabei genau dem Namen der Stored Procedure des SQL Server entsprechen (bspw. sp_calc_table). Zusätzlich können hier auch noch Parameter der Stored Procedure übergeben werden. Die einzelnem Parameter werden dabei durch „;“ getrennt, und beginnen jeweils mit einem „@“ (bspw: @param1=ErsterParameter;@param2=ZweiterParameter). Als Parameter können auch Session Variablen übergeben werden. (bspw.: @Session_PLAN_ID@) Der Datenbank Conneciton String sieht wie folgt aus: Server=ServerName;Initial Catalog=DatabaseName;user id=MyUserId; password=MyPassword
|-
| Plansätze löschen
| Der ServerBefehl Plansätze löschen, löscht alle Datensätze des ausgewählten Plans aller planabhängigen Tabellen. Wird der Plan auf „Aktueller Plan“ gestellt werden nur Datensätze des Planes gelöscht an den der Benutzer angemeldet ist.
|-
| Formula activate
| Dieser Serverbefehl kann [[Framework:Formeln|Formeln]] aktivieren bzw. deaktivieren. Zusätzlich kann die [[Framework:Formeln|Formel]] „Makroaktiv“ gesetzt werden.
|-
| Formelwerk aktivieren
| Aktiviert das CoPlanner Formelwerk.
|-
| Formelwerk deaktivieren
| Deaktiviert das CoPlanner Formelwerk.
|-
| PlanSecurity neu laden
| Lädt die Security für den aktuellen Plan neu.
|-
| Plan kopieren
| Kopiert alle Datensätze von einem Plan in einen anderen Plan.
|-
| Tabellensätze kopieren
| Es werden alle Datensätze innerhalb des ausgewählten Planes einer Tabelle in eine andere Tabelle kopiert. Zusätzlich können hier XML Filter für die Datensätze angegeben werden.
|-
| Tabellensätze löschen
| Es werden alle Datensätze innerhalb des ausgewählten Planes einer Tabelle gelöscht. Zusätzlich können hier XML Filter für die Datensätze angegeben werden.
Neben der Auswahl der Tabelle muss auch ein zu löschender Plan gewählt werden. Dies kann durch explizite Auswahl eines bestimmten Plans oder mit der Funktion „Aktueller Plan“ automatisch bezogen auf den Plan der Anmeldung erfolgen. Bei Wahl der Option „planunabhängig“ werden die Daten der gewählten Tabelle aus allen Plänen gelöscht!
Siehe nachfolgendes Beispiel.
|-
| Tabelle dieses Plans neu rechnen
| Es werden alle Datensätze innerhalb des ausgewählten Planes einer Tabelle neu berechnet. Zusätzlich können hier XML Filter für die Datensätze angegeben werden.
|-
| [[Framework:Importe|Import]] am Server starten
| Startet ein [[Framework:Importe|Importobjekt]] am Server. Da jedes [[Framework:Importe|Importobjekt]] eine Erfolgsmeldung zurückgibt, kann diese Erfolgsmeldung über den Parameter „Rückmeldung aktivieren“ unterdrückt werden.
|-
| Datenbank synchronisieren
| Erzwingt die Synchronisation des CoPlanner Servers und des SQL Servers bevor weitere CoPlanner - Serverbefehle abgearbeitet werden.
|-
| Datenobjekt synchronisieren
| Erzwingt die Synchronisation der angegebenen Tabelle/Dimension und des SQL Servers bevor weitere CoPlanner - Serverbefehle abgearbeitet werden.
|-
| OffeneBerechnungen abschliessen
| Erzwingt die Abarbeitung aller offenen Berechnungen ([[Framework:Formeln|Formeln]]). Anschließend wird einen Datenbanksynchronisation erzwungen, bevor weitere Serverbefehle abgearbeitet werden.
|-
| [[Framework:Formeln|Formel]] ausführen
| Führt die ausgewählte [[Framework:Formeln|Formel]] aus.
|-
| Session Parameter ändern
| Ändert Sessioneigenschaften. Hier kann bspw. angegeben werden, dass der Sessionkontext im Makromode ausgeführt wird, damit in weiterer Folge [[Framework:Formeln|Formeln]] ausgeführt werden deren Eigenschaft ‚Ausführen im Makromode’ gesetzt ist. Dazu geben Sie bitte folgende Parameter an:
Um in den Makromodus zu wechseln: MakroMode=1

Um den Makromodus zu verlassen: MakroMode=0
|-
|OLAP refresh
|Makrobefehl zur Aktualisierung von OLAP-Verbindungen (Verbindungen vom CoPlanner-Server zu SSAS werden geschlossen und bei Bedarf neu aufgebaut). Neben dem Aktualisieren der Dimensionen zielt dieser Befehl auch darauf ab eventuelle AdoMD-Caches (Security) zuverlässig löschen zu können. Nach einem Neustart des Clients sollten geänderte Dimensionselemente im CoPlanner ersichtlich sein.
|-
|Log Level setzen
|Zu Entwicklungszwecken kann man sich sämtliche Meldungen die im Log generiert werden in der Console/Telnet ausgeben lassen. Im Echtbetrieb wird das nicht empfohlen da es zu Performanceverschlechterungen kommen kann.
Konfiguration:
[[image:Fw_Makrodesigner_Loglevel_setzen.jpg|thumb|center|Framework, Makro - Loglevel konfigurieren]]
|-
|Skript am Server ausführen
|Wenn die Option AllowBatchProcessingViaMacro in der svrconifg.xml auf true gesetzt ist, dann kann man diesen Befehl auswählen. Am Server muss dafür ein Ordner Skripts vorhanden sein, welcher die Skriptdateien enthält, die ausgeführt werden können. Zusätzlich kann man Session-Variablen als Parameter übergeben.
|}

===Beispiel Tabellensätze löschen===

Es sollen mit einem Makro alle Datensätze aus einer Tabelle gelöscht werden die zum angemeldeten Plan gehören.
Legen Sie dazu ein neues Makro an und wählen Sie als Aktion „Serverbefehl“ und treffen Sie die Einstellungen wie in folgender Abbildung dargestellt.

[[image:Fw_Makrodesigner_Makro Tabellensaetze loeschen.jpg|thumb|center|Framework, Makro – Tabellensätze löschen]]

Rufen Sie den Filter – Editor auf mit einem Klick auf die Schaltfläche [[image:Icon_Dateiauswahl.jpg‎]].

[[image:Fw_Makrodesigner_Makro Filter Editor.jpg|thumb|center|Framework, Makro – Filter - Editor]]

Wählen Sie aus dem Kombinationslistenfeld den Eintrag „BAB_Plan“ und im Filter „Unternehmen“ die „Bike GmbH“ aus. Mit einem Klick auf die Schaltfläche „Hinzufügen“ wird diese Einstellung übernommen. Durch das Ersetzen des Kriteriums mit der [[Framework:Session-Variablen|Sessionvariable]] @Session_Unternehmen_ID@ bezieht sich dieser Filter immer auf das angemeldete Unternehmen.

Sollten Sie diese Filter mehrmals benötigen, können Sie diesen mit dem Befehl „Filter speichern“ sichern und mit „Filter laden“ wieder einfügen.

===Beispiel Tabellensätze in Abhängigkeit eines Dimensionsattributes löschen===

Es sollen mit einem Makro alle Datensätze aus einer Tabelle gelöscht werden, die einer Attributausprägung in einer Dimension entsprechen. In diesem Beispiel werden aus der Tabelle "Tab1" alle Datensätze gelöscht, die in der Dimension im Attribut "AttribFeld" den Wert "True" enthalten.

[[image:Fw_Makrodesigner_Makro Filter Editor01.png|thumb|center|Framework, Makro – Filter - Editor]]

{| class="wikitable" width={{{breite|50%}}}
|-
| Spalte
| Ausdruck
|-
|Feld
|Standard Dimension Column Name
|-
|Vergleichstyp
|Muss zum Datentyp passen (me ist =, not_me ist <>, usw.)
|-
|Kriterium
|Muss auch zum Datentyp passen
|-
|Type
|BY_ATTRIBVAL_FeldNameInDim (In diesem Beispiel heißt das Attributsfeld in der Dimension "AttribFeld"
|}

===Beispiel Tabellensätze in Abhängigkeit einer Anwendungseigenschaft löschen===

Es sollen mit einem Makro alle Datensätze aus einer Tabelle gelöscht werden, die einem Dimensionselement aus den Anwendungseigenschaften entsprechen.

[[image:Fw_Makrodesigner_Makro Filter Editor02.png|thumb|center|Framework, Makro – Filter - Editor]]

===Tabellensätze in Abhängigkeit einer anderen Tabelle löschen===
Über ein FKT_GetRecord im Kriterium kann eine Eigenschaft aus einer anderen Tabelle abgerufen werden. Hier muss vor dem FKT_GetRecord ein Transform= stehen.

z.B.: Transform=FKT_GetRecord(TabRecordToDelete.Zeit_1,Unternehmen != @Session_Unternehmen_ID@)

Holt den Eintrag der Zeit aus der Zeile der Tabelle TabRecordToDelete, bei der das Unternehmen dem Unternehmen entspricht, auf dem man angemeldet ist.

==Meldung==

Dem Anwender können mit Meldungen Informationen über die Ausführung des Makros am Client angezeigt werden. Dazu wird der Meldungstext, Meldungstitel und der Meldungstyp eingegeben.

[[image:Fw_Makrodesigner_Meldung.jpg|thumb|center|Framework, Makro - Meldung]]

===Meldungstypen===

{| class="wikitable" width={{{breite|100%}}}
|-
|'''Fehler'''

[[image:Fw_Makrodesigner_Meldung_Fehler.jpg|thumb|center|Framework, Makro - Meldung - Fehler]]
|'''Ausnahme'''

[[image:Fw_Makrodesigner_Meldung_Ausnahme.jpg|thumb|center|Framework, Makro - Meldung - Ausnahme]]
|'''Information'''

[[image:Fw_Makrodesigner_Meldung_Information.jpg|thumb|center|Framework, Makro - Meldung - Information]]
|'''Frage'''

[[image:Fw_Makrodesigner_Meldung_Frage.jpg|thumb|center|Framework, Makro - Meldung - Frage]]
|-
|'''Kein Symbol'''

[[image:Fw_Makrodesigner_Meldung_Kein_Symbol.jpg|thumb|center|Framework, Makro - Meldung - Kein Symbol]]
|'''Stop'''

[[image:Fw_Makrodesigner_Meldung_Stop.jpg|thumb|center|Framework, Makro - Meldung - Stop]]
|'''Warnung'''

[[image:Fw_Makrodesigner_Meldung_Warnung.jpg|thumb|center|Framework, Makro - Meldung - Warnung]]
|}

==URL==
Ab CoP 10 HF 2.5

Bietet die Möglichkeit bei im Webclient ausgeführten Makros z.B. andere Masken zu öffnen.

{| {{Bausteindesign2}}
|-
| '''ACHTUNG'''  Nach diesem Schritt werden keine weiteren Schritte des Makros ausgeführt. Sollte es sich bei dem Makro um ein Submakro handeln, werden auch die weiteren Schritte des aufrufenden Makros nicht weiter ausgeführt. Sollte der Schritt durch z.B. eine Fortsetzungsbedingung nicht ausgeführt werden läuft das Makro wie bisher weiter.
|}

Der Kontext kann bei diesem Befehl verwendet werden. Wird das Makro z.B. aus einer Maske aufgerufen und es werden Filter übergeben, so kann man auf diese mit @Context.<Filtername>@ zugreifen. Wird z.B. der Filter PC/KST übergeben, dann könnte so ein Link folgendermaßen aussehen: @Session_WebAppUrl/pivottable/?pivotform=EM Umsatzerloese PLAN&contextFilters="PC/KST" mu @Context.PC/KST@

==Fortsetzungsbedingung==

Die Fortsetzungsbedingung dient dazu, um die Weiterführung des Makros steuern zu können. Wird sie aktiv geschalten, muss die Bedingung zutreffen, um mit dem Makro fortzufahren. Trifft die Bedingung nicht zu, wird das Makro genau an der Stelle beendet. Es besteht die Möglichkeit mittels einer Meldung auf den Abbruch hinzuweisen.

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Inaktiv.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung - Inaktiv]]

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Aktiv.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung - Aktiv]]

Es müssen für die Bedingung beide Ausdrucksfelder befüllt werden. Ein Ausdruck kann eine Abfrage zum CoPlanner Server mittels der Funktionen die das Rechenwerk bereitstellt, ein SQL Statement auf die CoPlanner Systemdatenbank oder ein konstanter Wert sein. Die Abfrage zum CoPlanner Server wird mittels Transform=, eine SQL Server Abfrage mittels Sql= gekennzeichnet. Ein konstanter Wert wird ohne besondere Kennung eingetragen.

Beispiele:

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Sql kombiniert mit CoPlanner Abfrage.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung – Sql kombiniert mit CoPlanner Abfrage]]

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Sql kombiniert mit konstantem Wert.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung - Sql kombiniert mit konstantem Wert]]

[[image:Fw_Makrodesigner_Fortsetzungsbedingung_SessionVariable_Text.png|thumb|center|Framework, Makro - Fortsetzungsbedingung - Session-Variable kombiniert mit konstantem Wert]]

Bei konstanten Werten muss der Datentyp beachtet werden. Liefert die SQL bzw. CoPlanner Abfrage als Ergebnis eine Zeichenfolge, muss der Wert unter einfache Anführungszeichen gestellt werden. Liefert die Abfrage als Ergebnis einen numerischen Wert, entfallen die Anführungszeichen.
Wird eine SQL Abfrage definiert, welche nicht genau einen Wert, sondern eine Ergebnistabelle liefert, wird der Wert der linken, oberen Ecke für den Vergleich herangezogen.

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Ergebnis bei Abfrage mit Tabelle als Ergebnis.jpg|center|Framework, Makro - Fortsetzungsbedingung - Ergebnis bei Abfrage mit Tabelle als Ergebnis]]

Im folgenden SQL Statement-Beispiel wird überprüft ob in der Tabelle CPM_TBL_BUD_PAYMENTS für den aktuellen Plan und das Project an dem der Benutzer gerade angemeldet ist Datensätze vorhanden sind:

''Sql=select cast(count(*) as bigint) from CPM_TBL_BUD_PAYMENTS where COPSYS_PLAN_ID = @Session_PLAN_ID@ and Projects = (select top 1 value from tb_SessionParameters where Name = 'Projects' and COP_SESSION_ID = @Session_ID@)''

Liefert die SQL Abfrage keine einzige Zeile, so kann dies mittels der Konstante ‘NULL‘ abgefragt werden.

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Abfrage ob Datensaetze geliefert werden.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung - Abfrage ob Datensätze geliefert werden]]

Ausdrücke können auch mit CoPlanner [[Framework:Session-Variablen|Sessionvariablen]] versehen werden. Vor der eigentlichen Evaluierung des Ausdrucks werden diese durch den entsprechenden Wert ersetzt. [[Framework:Session-Variablen|Sessionvariablen]] können auch als konstanter Wert verwendet werden.

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Abfrage mit Session Variable.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung - Abfrage mit Session Variable]]

Ist die Option „Meldung bei Nichterfüllung“ aktiviert, wird bei Abbruch des Makros dem Benutzer die Meldung mit dem entsprechenden Text angezeigt. Ist die Option nicht aktiv, wird das Makro ohne weitere Meldung beendet.

[[image:Fw_Makrodesigner_Fortsetzungsbedingung Meldung bei Nichterfuellung.jpg|thumb|center|Framework, Makro - Fortsetzungsbedingung - Meldung bei Nichterfüllung]]
__NOEDITSECTION__

[[Category:Framework|Makros]][[Category:Framework Objekte|Makros]]
[[en:Framework:Macros]]

Vorlage:Achtung

2022-05-05T10:17:53Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid black; background-color: white; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Achtung|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Hinweis]]
</noinclude>

Vorlage:Achtung

2022-05-05T10:16:34Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid red; background-color: white; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Achtung|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Hinweis]]
</noinclude>

Vorlage:Achtung

2022-05-05T10:16:25Z

Admin: Die Seite wurde neu angelegt: „{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid red; background-color: white; position:relative;" |- |<span style="colo…“

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid red; background-color: white; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Hinweis|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Hinweis]]
</noinclude>

Vorlage:CoPFormel

2022-05-05T08:12:03Z

Admin:

style="color:#0000ff;"
<noinclude>
Geben Sie hier Ihre CoPlanner Formel ein.
[[Kategorie:Vorlage:Formatierungshilfe|CoPFormel]]
</noinclude>

Vorlage:Eingabe

2022-05-04T09:46:57Z

Admin: Die Seite wurde neu angelegt: „{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #d9d2b6; background-color: #fffdf3 ; position:relative;" |- |<span styl…“

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #d9d2b6; background-color: #fffdf3 ; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Eingabe|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Eingabe]]
</noinclude>

Vorlage:Hinweis

2022-05-04T09:46:51Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #24a7d3; background-color: #f6fcfe; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Hinweis|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Hinweis]]
</noinclude>

Vorlage:Hinweis

2022-04-28T14:56:06Z

Admin:

Vorlage:Hinweis

2022-04-28T14:53:01Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #d9d2b6; background-color: #fffdf3 ; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

{{Hinweis|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Bausteindesign2]]
</noinclude>

Vorlage:Hinweis

2022-04-28T14:52:42Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #d9d2b6; background-color: #fffdf3 ; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>

{{Hinweis|Kategorie=Par1|Text=Par2}}

Erster Parameter: Kategorie (hier "Par1")
Zweiter Parameter: Text (hier "Par2")

[[Kategorie:Vorlage:Formatierungshilfe|Bausteindesign2]]
</noinclude>

WebApps:Migrationstool

2022-04-28T14:51:23Z

Admin:

__TOC__

''Verfügbar ab CoP 10 HF 3.4''

Für bestehende Projekte soll mit dem Migrationstool Unterstützung geboten werden, um vorhandene Komponenten auf neue Technologie umzustellen und den dafür nötigen Aufwand zu reduzieren.

==Systemvoraussetzungen==

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

==Aufruf Migrationstool==
@Session_WebAppUrl@/migrationtool

Beispiel:

<nowiki>https://servername:4444/coplanner/migrationtool</nowiki>
===Erweiterter Aufruf===

* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.

==Allgemein==
1. Auswahl

In der Tabelle befinden sich initial immer alle Objekte, für die noch eine Migration offen ist. Um zu überprüfen, ob eine Migration auch tatsächlich durchgeführt werden kann, kann man entweder in der Zeile auf "Überprüfen" klicken, oder unter Punkt 2. Prüfung die Überprüfung für alle Objekte starten. Nach der Überprüfung ändert sich die Schaltfläche entweder auf "Zusätzliche Informationen anzeigen", sofern eine Konvertierung nicht möglich ist oder "Konvertieren", sofern eine Konvertierung möglich ist. Über das rote x in der Kopfzeile kann die gesamte Tabelle geleert werden. Danach hat man die Möglichkeit über den Objektbrowser (links) via Drag-and-drop wieder Objekte in die Liste hinzuzufügen. Objekte, die sich nicht in dem Objektbrowser befinden sind bereits migriert.

2. Überprüfung

Über den Button "Prüfung starten" können Sie die Überprüfung für alle Objekte aus der Auswahltabelle ausführen. Bitte beachten Sie, dass dies je nach Anzahl der Objekte einiges an Zeit beanspruchen kann.

In der Auswahlliste sehen Sie nach der Prüfung den Status, ob Objekte umgestellt werden können oder nicht. Sofern eine Migration nicht möglich ist, können Sie die Informationen dazu, warum es nicht möglich ist je Objekt einsehen. Zusätzlich haben Sie über den Exportbutton die Möglichkeit das Ergebnis der Prüfung zu exportieren. Alle Objekte mit Fehlern werden nach oben sortiert in der Auswahlliste.

Unter dem "Prüfung starten" bzw. "Exportieren"-Buttons sehen Sie, wieviele Objekte umgestellt werden können oder nicht und für wieviele Objekte überprüft wurden.

3. Konvertierung

Mit dem Button "Konvertierung" kann man einfach die Umwandlung für alle Elemente in der Auswahlliste starten. Die Elemente werden hier nochmals geprüft und sofern Sie nicht umwandelbar sind, werden sie wieder in der Auswahlliste mit dem Problem der Konvertierung angeführt und bleiben unverändert.

==CoPlanner-Würfel==
Für CoPlanner-Würfel gibt es die Möglichkeit diese auf die CoPlanner-Würfel (neu) umzustellen ohne jeden einzelnen Würfel öffnen und überprüfen zu müssen.

__NOEDITSECTION__

[[Category:WebApps|Migrationstool]]
[[en:WebApps:Migration tool]]

Vorlage:Hinweis

2022-04-28T14:47:02Z

Admin:

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #d9d2b6; background-color: #fffdf3 ; position:relative;"
|-
|'''{{{Kategorie}}}'''  {{{Text}}}
|}

<noinclude>
{{Hinweis|Kategorie=Par1|Text=Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Bausteindesign2]]
</noinclude>

WebApps:Migrationstool

2022-04-28T14:44:06Z

Admin:

Vorlage:Hinweis

2022-04-28T14:42:16Z

{| cellspacing="3" cellpadding="3" style="width: 100%; font-size:100%; border:2px solid #d9d2b6; background-color: #fffdf3 ; position:relative;"
|-
|'''{{{1}}}'''  {{{2}}}
|}

<noinclude>
{{Hinweis|Par1|Par2}}

[[Kategorie:Vorlage:Formatierungshilfe|Bausteindesign2]]
</noinclude>

WebApps:Migrationstool

2022-04-28T14:18:25Z

Admin:

WebApps:Migrationstool

2022-04-28T13:50:20Z

Admin:

__TOC__

Verfügbar ab CoP 10 HF 3.4

Für bestehende Projekte soll mit dem Migrationstool Unterstützung geboten werden, um vorhandene Komponenten auf neue Technologie umzustellen und den dafür nötigen Aufwand zu reduzieren.

==Systemvoraussetzungen==

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

==Aufruf Migrationstool==
@Session_WebAppUrl@/migrationtool

Beispiel:

<nowiki>https://servername:4444/coplanner/migrationtool</nowiki>
===Erweiterter Aufruf===

* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.

==Allgemein==
1.

In der Tabelle befinden sich initial immer alle Objekte, für die noch eine Migration offen ist. Um zu überprüfen, ob eine Migration auch tatsächlich ausgeführt werden kann, kann man entweder neben dem Element an sich die Prüfung ausführen, oder das unter Punkt 2. die Überprüfung für alle Objekte starten. Über das rote x in der Kopfzeile kann die gesamte Objektliste geleert werden. Danach hat man die Möglichkeit über den Objektbrowser (links) wieder Objekte in die Liste hinzuzufügen. Objekte, die sich nicht in dem Objektbrowser befinden sind bereits migriert.

2. Überprüfen

Über den Button "Überprüfung starten" können Sie die Überprüfung für alle Objekte aus der Liste (1.) ausführen. Bitte beachten Sie, dass dies je nach Anzahl der Objekte einiges an Zeit beanspruchen kann.
In der Liste (1.) sehen Sie nach der Prüfung den Status, ob Objekte umgestellt werden können oder nicht. Sofern dies nicht der Fall ist, können Sie die Informationen dazu, warum die Migration nicht möglich ist je Objekt einsehen. Zusätzlich haben Sie über den Exportbutton die Möglichkeit das Ergebnis der Prüfung zu exportieren.

==CoPlanner-Würfel==
Für CoPlanner-Würfel gibt es die Möglichkeit diese auf die CoPlanner-Würfel (neu) umzustellen ohne jeden einzelnen Würfel öffnen und überprüfen zu müssen.

__NOEDITSECTION__

[[Category:WebApps|Migrationstool]]
[[en:WebApps:Migration tool]]

WebApps:Migrationstool

2022-04-28T07:40:47Z

Admin:

WebApps:Migrationstool

2022-04-28T07:40:09Z

Admin:

__TOC__

Verfügbar ab CoP 10 HF 3.4

Für bestehende Projekte soll mit dem Migrationstool Unterstützung geboten werden, um vorhandene Komponenten auf neue Technologie umzustellen und den dafür nötigen Aufwand zu reduzieren.

==Systemvoraussetzungen==

Die Voraussetzungen finden Sie [[WebApps:Voraussetzungen|hier]].

==Aufruf Migrationstool==
@Session_WebAppUrl@/migrationtool

Beispiel:

<nowiki>https://servername:4444/coplanner/migrationtool</nowiki>
===Erweiterter Aufruf===

* hideSessionHeader: Definiert, ob der [[WebApps:Header|Header]] angezeigt werden soll oder nicht (true blendet [[WebApps:Header|Header]] aus). Der Default beim Öffnen ist false.

==Allgemein==
1.
In der Tabelle befinden sich initial immer alle Objekte, für die noch eine Migration offen ist. Um zu überprüfen, ob eine Migration auch tatsächlich ausgeführt werden kann, kann man entweder neben dem Element an sich die Prüfung ausführen, oder das unter Punkt 2. die Überprüfung für alle Objekte starten.
Über das rote x in der Kopfzeile kann die gesamte Objektliste geleert werden. Danach hat man die Möglichkeit über den Objektbrowser (links) wieder Objekte in die Liste hinzuzufügen. Objekte, die sich nicht in dem Objektbrowser befinden sind bereits migriert.

2.) Überprüfen
Über den Button "Überprüfung starten" können Sie die Überprüfung für alle Objekte aus der Liste (1.) ausführen. Bitte beachten Sie, dass dies je nach Anzahl der Objekte einiges an Zeit beanspruchen kann.
In der Liste (1.) sehen Sie nach der Prüfung den Status, ob Objekte umgestellt werden können oder nicht. Sofern dies nicht der Fall ist, können Sie die Informationen dazu, warum die Migration nicht möglich ist je Objekt einsehen. Zusätzlich haben Sie über den Exportbutton die Möglichkeit das Ergebnis der Prüfung zu exportieren.

==CoPlanner-Würfel==
Für CoPlanner-Würfel gibt es die Möglichkeit diese auf die CoPlanner-Würfel (neu) umzustellen ohne jeden einzelnen Würfel öffnen und überprüfen zu müssen.