CoPlanner 11 - Benutzerbeiträge [de-formal]

Technik:CoPlanner-Server

2022-09-26T07:24:23Z

Admin:

__TOC__

Der Ordner [[Technik:CoPlanner-Server_Installation|CoPlanner-Server]] muss auf jenem Rechner vorhanden sein, welcher als Server fungieren soll. Dieser enthält einige [[Technik:Konfigurationsdateien|Konfigurationsdateien]], welche Variablen, die Verbindung zu Clients, uvm. definieren. Diese müssen sorgfältig konfiguriert werden.

==SysCommands.xml==

Diese Datei ist im Serververzeichnis zu finden. Sie beinhaltet Informationen für CoPlanner Systemeinstellungen. Zu beachten ist hierbei nur, in welcher Sprache der SQL-Server installiert ist. Handelt es sich um ein deutsches Setup, so müssen Sie als Anwender nicht eingreifen. Handelt es sich um ein englisches Setup, muss die Datei ''„SysCommands.xml“'' gelöscht oder umbenannt und danach die Datei ''„SysCommands_EnSql.xml“'', welche ebenfalls im Serververzeichnis liegt, in ''„SysCommands.xml“'' umbenannt werden.

==SvrConfig.xml==

Diese Datei definiert Eigenschafen des CoPlanner-Servers. Sie befindet sich im Serververzeichnis.

<?xml version= "1.0" standalone="yes"?>
<SvrConfig.xml>
 <CopSettings>
 <Version>4</Version>
 <ConnectionString>Server=CopServer;Initial Catalog=COP_BIKE;Integrated Security=SSPI;pooling=false</ConnectionString>
 <DataBaseName>COP_BIKE</DataBaseName>
 <FiscalYear>0</FiscalYear>
 <ServiceName>copService</ServiceName>
 <TelnetDebugPort>6900</TelnetDebugPort>
 <DefaultLanguage>german</DefaultLanguage>
 <BackupPath>C:\temp\</BackupPath>
 <BackupRestoreLimitinMB>50</BackupRestoreLimitinMB>
 <WebAuthenticateUrl><nowiki>http://copsupport.coplanner.com/licence/get_cop_lic_v3.php</nowiki></WebAuthenticateUrl>
 <LicenceID>123</LicenceID>
 <ClientConnectionTimeOut>1440</ClientConnectionTimeOut>
 <EntitySecurity>true</EntitySecurity>
 <AllowNonPowerUserDeleteDimElementsWithData>false</AllowNonPowerUserDeleteDimElementsWithData>
 <MultiThreadCommand>true</MultiThreadCommand>
 <ProActiveCaching>true</ProActiveCaching>
 <SkipImportHistory>true</SkipImportHistory>
 <SecurityProxyLoad>false</SecurityProxyLoad>
 <CopSysIDStartOffset>0</CopSysIDStartOffset>
 <DebugMode>false</DebugMode>
 <StoredProcedureTimeout>3600</StoredProcedureTimeout>
 <ShowLostDBConnectionWaruning>true</ShowLostDBConnectionWaruning>
 <IISUserName></IISUserName>
 <TransportUserName></TransportUserName>
 <PowerUserModeViaADOnly>false</PowerUserModeViaADOnly>
 <ADGroupPowerUser></ADGroupPowerUser>
 <ADGroupPartnerUser></ADGroupPartnerUser>
 <ADGroupManufacturerUser></ADGroupManufacturerUser>
 <LoadAllEntityDimensionEntriesToClient>false</LoadAllEntityDimensionEntriesToClient>
 <FormulasUsePriorityQueue>false</FormulasUsePriorityQueue>
 <ReportServerUrl><nowiki>https://servername:4445/coplanner/reporting</nowiki></ReportServerUrl>
 <DoVersionCheck>true</DoVersionCheck>
 <UseNewDBSync>true</UseNewDBSync>
 <DBSyncMaxThreads>10</DBSyncMaxThreads>
 <DBCommandTimeout>600</DBCommandTimeout>
 <UseNewCaching>false</UseNewCaching>
 <CacheSizeFactor>0,5</CacheSizeFactor>
 <StartTabAdress></StartTabAdress>
 <LogonMaximumPerTimeframe>100</LogonMaximumPerTimeframe>
 <LogonMaximumTimeframeInSeconds>60</LogonMaximumTimeframeInSeconds>
 <SupportColumnTable>false</SupportColumnTable>
 <AllowBatchProcessingViaMacro>false</AllowBatchProcessingViaMacro>
 </CopSettings>
 <SSASSettings>
 <Server>CopServer</Server>
 <DataBaseName>cop_olap</DataBaseName>
 <XmlaLoadActive>true</XmlaLoadActive>
 <UseRealElementIDs>true</UseRealElementIDs>
 <UseMultipleHierarchies>true</UseMultipleHierarchies>
 <MultiSelectFilterActive>false</MultiSelectFilterActive>
 <LoadMeasureFormatAndType>true</LoadMeasureFormatAndType>
 <ReplaceNullValues>false</ReplaceNullValues>
 <DimensionLoadMode>AsDimAndHierarchy</DimensionLoadMode>
 <LoadDimensionsByAlias>true</LoadDimensionsByAlias>
 </SSASSettings>
 <SSRSSettings>
 <ReportServerUrl><nowiki>http://CopServer/reportserver</nowiki></ReportServerUrl>
 <ReportWebServiceUrl><nowiki>http://CopServer/reportserver/reportservice2005.asmx</nowiki></ReportWebServiceUrl>
 <RootFolder>/CoPlanner/Reports</RootFolder>
 <UserFolder>/CoPlanner/User</UserFolder>
 <TempFolder>/CoPlanner/Temp</TempFolder>
 <SharedDataSourceReference>/CoPlanner/DataSources/CoPlanner</SharedDataSourceReference>
 <Parameters></Parameters>
 </SSRSSettings>
 <DBCon>
 <Stage>Server=CopServer;Initial Catalog=COP_STAGE;Integrated Security=SSPI</Stage>
 </DBCon>
 <SupportConfig>
<SupportMailAddress>support@coplanner.com</SupportMailAddress>
 <SupportFormAddress><nowiki>https://copsupport.coplanner.com/support/</nowiki></SupportFormAddress>
 </SupportConfig>
 <WebConfig>
 <WebAppUrl><nowiki>https://+:4443/coplanner</nowiki></WebAppUrl>
 <LogonLanguages>Deutsch|English</LogonLanguages>
 <LogonWithCoPlannerSecurity>True</LogonWithCoPlannerSecurity>
 <LogonWithSSPI>True</LogonWithSSPI>
 <CorsAllowedOrigins><nowiki>https://servername:4443</nowiki></CorsAllowedOrigins>
 <EnableSwagger>False</EnableSwagger>
 <EnableCommandEndpoints>True</EnableCommandEndpoints>
 <EnableExperimentalEndpoints>True</EnableExperimentalEndpoints>
 <EnableMssEndpoints>False</EnableMssEndpoints>
 <EnableAuthWithSessionId>True</EnableAuthWithSessionId>
 <EnableHttpsRedirection>False</EnableHttpsRedirection>
 <HttpsRedirectionPort></HttpsRedirectionPort>
 <EnableHSTS>False</EnableHSTS>
 <StartUrl></StartUrl>
 <EnableResponseCompression>true</EnableResponseCompression>
 </WebConfig>
 <OlapServiceSettings>
 <OlapServiceUrl></OlapServiceUrl>
 </OlapServiceSettings>
</SvrConfig.xml>

===CopSettings===
Folgende Punkte müssen im Bereich CopSettings definiert werden:
{| class="wikitable" width="{{{breite|100%}}}"
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|ConnectionString
|
{| class="wikitable" width={{{breite|100%}}}
|-
|''Server''
|Name des Servers, auf dem sich die Datenbank befindet
|-
|''Initial Catalog''
|Name der Datenbank
|-
|''User id''
| Name des Benutzers, mit dem sich der CoPlanner-Server am SQL-Server anmeldet (standardmäßig sollte bereits die ID „sa“ existieren). Alternativ kann bzw. muss ein User mit entsprechenden Rechten am SQL-Server angelegt werden.
|-
|''Password''
|Passwort des Benutzers
|-
|''Pooling''
|Damit Restore Database (fix integriert im Entwicklermenü) funktioniert, muss im Connectionstring Pooling = false vorhanden sein!
|}
|-
|DataBaseName
|Name der SQL-Datenbank
|-
|FiscalYear
|Legt die Versetzung des Wirtschaftsjahres des Unternehmens zum Kalenderjahr fest. Dabei wird ausgehend vom Monat Jänner gerechnet.
:*0: keine Wirtschaftsjahrversetzung
:*-1: Anfang des Wirtschaftsjahres im Dezember des Vorjahres
:*1: Anfang des Wirtschaftsjahres im Februar desselben Jahres
|-
|ServiceName
|Name des CopService
|-
|TelnetDebugPort
|Es ist möglich, mittels Telnet ein Sichtfenster zum CoPlanner-Server aufzubauen. Dieser Eintrag legt die Portnummer für die Telnetverbindung fest. Die Verbindung erfolgt durch die DOS-Eingabeaufforderung (Start [[Image:arrow.jpg]] Ausführen [[Image:arrow.jpg]] cmd). Zum Aufruf der Verbindung geben Sie: telnet rechnername portnummer (Bsp: telnet hostname 6900) ein und drücken auf Return.
|-
|DefaultLanguage
|Die Defaultsprache des CoPlanner Servers.
|-
|BackupPath
|Legt den temporären Speicherplatz für ein Datenbankbackup, welches durch einen Client veranlasst werden kann, fest. Der SQL-Server muss Schreibrechte auf das angegebene Verzeichnis haben. Es darf kein Netzlaufwerk sein, sondern auf ein lokales Volume des SQL-Servers verweisen.
|-
|BackupRestoreLimitinMB
|Maximale Größe des Datenbankbackup in MB.
|-
|WebAuthenticateUrl
|Link zur Überprüfung der CoPlanner Lizenz.
|-
|LicenceID
|Wird zwingend für den Start des CoPlanner Servers benötigt. (ID der Lizenz bspw. 123)
|-
|ClientConnectionTimeOut
|Nach Ablauf wird die Client-Session am Server gelöscht. Angabe in Minuten. Default-Wert 1.440 Minuten.
|-
|EntitySecurity
|Durch diesen Eintrag kann man die Unternehmenssecurity deaktivieren, dass heißt der User kann nicht unternehmensübergreifend Werte erfassen. Ist der Eintrag nicht im Config File vorhanden, ist die Security per default aktiv.
|-
|AllowNonPowerUserDeleteDimElementsWithData
|Legt fest, ob nicht Poweruser Elemente mit Daten löschen dürfen.
|-
|MultiThreadCommand
|Legt fest, ob die Abarbeitung in mehreren Threads durchgeführt wird.
|-
|ProActiveCaching
|Bei CoPlanner Würfeln wird ein Tupel Caching aktiviert. Dies hat zur Folge, das mehrmals verwendete Zwischenergebnisse zwischengespeichert werden und somit eine Performanceverbesserung erreicht wird.
|-
|SkipImportHistory
|Ist dieser Eintrag auf true, werden Fehlermeldungen beim Datenimport nicht in die History-Tabelle geschrieben.
|-
|SecurityProxyLoad
|Ist dieser Eintrag auf true, wird die Security erst beim LogIn für den User aufbereitet.
|-
|CopSysIDStartOffset
|Die erste vom System vergebene CopSysID wird um diesen Offset erhöht. Werden mehrere Modell mit unterschiedlichen CopServices verwendet, werden so doppelte CopSysIDs vermieden.
|-
|DebugMode
|Ist dieser Eintrag auf true wird am Server detailierter gelogged.
|-
|StoredProcedureTimeout
|Optionale Angabe eines Timeouts in Sekunden ehe die Ausführung einer SQL Prozedur im CoPlanner abgebrochen wird. Per default ist diese auf 3600 Sekunden gesetzt.
|-
|ShowLostDBConnectionWarning
|Ist dieser Eintrag auf True wird am Client angezeigt wenn die Verbindung zur Datenbank verloren gegangen ist.
|-
|TransportUserName
|Relevant für das automatisierte Transportwesen. Bitte beachten Sie, dass der hier vergebene User immer Herstellerrechte hat, auch wenn er sich normal über den Client anmeldet. Es muss sich hier um einen vollqualifizierten Windows Domänenuser handeln.
|-
|PowerUserModeViaADOnly
|Definiert, ob man in den unten definierten AD Gruppen sein muss, um sich als Hersteller, Partner oder PowerUser anmelden zu können.
|-
|ADGroupPowerUser
|Definiert die AD Gruppe für den Zugriff als PowerUser.
|-
|ADGroupPartnerUser
|Definiert die AD Gruppe für den Zugriff als Partner.
|-
|ADGroupManufacturerUser
|Definiert die AD Gruppe für den Zugriff als Hersteller.
|-
|LoadAllEntityDimensionEntriesToClient
|Definiert, ob die Filterung der Elemente bei Mandantendimensionen erst am Client stattfindet oder schon am Server. False bedeutet, dass die Filterung am Server stattfindet.
|-
|FormulasUsePriorityQueue
|Wenn auf true werden die Formeln nach der im Modell vergebenen Priorität abgearbeitet. Sollte nur bei Projekten verwendet werden, die auch eine vergebene Priorität haben. Siehe: [[Technik:CoPlanner-Server#Exkurs_FormulasUsePriorityQueue|Exkurs FormulasUsePriorityQueue]]
|-
|DoVersionCheck
|Gibt an, ob bei Anmeldungen von den Clients geprüft werden soll, ob die Version und Hotfixnummer übereinstimmt.
|-
|UseNewDBSync
|Gibt an, ob der neue DB Sync verwendet wird. True heißt, dass der neue DB Sync aktiv ist.
|-
|DBSyncMaxThreads
|Gibt an, wie viele Threads zum Schreiben in die Datenbank verwendet werden, wenn der neue DB Sync aktiv ist. Wird kein Wert eingetragen, werden max. 2 Threads verwendet. Maximal wird der standardmäßig ermittelte Wert für die CPU (=Anzahl Cores – minus heuristischer Reduktion bei mehreren Cores) hergenommen, auch, wenn hier ein höherer Wert angegeben wäre. Ist hier ein niedrigerer Wert angegeben, wird der niedrigere Wert verwendet. Ist die Last beim Schreiben auf die Datenbank zu hoch, dann sollte dieser Wert reduziert werden.
|-
|DBCommandTimeout
|Datenbank-Kommando-Timeout für bestimmte Befehle. Dieses Timeout zieht z.B. bei der Datenbringung von Importen. Früher gab es hier ein hard-codiertes Timeout von 10 Minuten, wo der SQL Server die Daten für den Import bereitstellen muss. Nun kann man dieses Timeout hier setzen. 600 entspricht den 10 Minuten.
|-
|UseNewCaching
|Gibt an, ob das neue Caching aktiviert werden soll.
|-
|CacheSizeFaktor
|Nur Auswirkung bei UseNewCaching=true. Beim neuen Caching werden Daten, die in Masken angezeigt werden, in einem spaltenorientierten Cache abgelegt. Damit der Speicherverbrauch durch das neue Caching nicht zu groß wird, wird die Anzahl der Daten, die in spatenorientierten Caches abgelegt werden darf, begrenzt. Mit dem CacheSizeFactor wird diese Grenze grob in Relation zu den in den CoPlanner-Tabellen vorhandenen Daten festgelegt – ein Cache Faktor von 0,5 gibt an, dass der Cache in etwa halb so viele Daten halten darf wie in den CoPlanner-Tabellen vorhanden sind.
|-
|StartTabAdress
|Wenn diese Eigenschaft leer ist, wird wie bisher die Start.html als Startseite geladen. Man kann hier aber auch z.B. die Tiles als Startseite anzeigen lassen. Bsp.: @Session_WebAppUrl@/tiles/?menu=MeineStartseite&SessionID=@Session_ID@)
|-
|LogonMaximumPerTimeframe
|Maximale Anzahl von Loginversuchen pro Sekunden, welche bei LogonMaximumTimeframeInSeconds angegeben wurden. Wurde also z.B. LogonMaximumPerTimeframe auf 100 gesetzt und LogonMaximumTimeframeInSeconds auf 60, dann werden in 60 Sekunden 100 Loginversuche zugelassen. 0 steht für kein Limit.
|-
|LogonMaximumTimeframeInSeconds
| Anzahl von Sekunden in denen maximal so viele Logins, wie bei LogonMaximumPerTimeframe versucht werden können. Wurde also z.B. LogonMaximumPerTimeframe auf 100 gesetzt und LogonMaximumTimeframeInSeconds auf 60, dann werden in 60 Sekunden 100 Loginversuche zugelassen. 0 steht für kein Limit.
|-
|SupportColumnTable
| Derzeit eine Betavariante, die ohne Abstimmung nicht aktiviert werden sollte. Um die ColumnTable nutzen zu können müssen auch UseNewCaching und ForumulasUsePriorityQueue aktiviert sein.
|-
|AllowBatchProcessingViaMacro
| Wenn diese Option aktiviert wird, kann man Batchdateien, die im Serververzeichnis in dem Scripts-Ordner liegen, aus einem Makro aufrufen. Diese Option ist per Default deaktiviert und sollte dies aus security-technischen Gründen auch bleiben.
|-
|DaysToKeepSysLogSession
| Beim Serverstart werden Einträge der Sys_Log_Session Tabelle gelöscht. Mit diesem Parameter kann angegeben werden, wieviele Tage erhalten bleiben sollen.
|}

===SSASSettings===
Folgende Punkte müssen im Bereich SSASSettings definiert werden:

{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|Server
|Name des Servers, auf dem sich die OLAP-Datenbank befindet. Es muss der Name des Server bzw. die IP Adresse angegeben werden. Folgende Namen sind nicht zulässig: localhost, ., 127.0.0.1 und local.
|-
|DataBaseName
|Name der OLAP-Datenbank
|-
|XmlaLoadActive
|Ist dieser Eintrag auf true, werden Strukturdaten mittels XMLA geladen [[Image:arrow.jpg]] enormer Performancegewinn!
|-
|UseRealElementIDs
|Die echten OLAP-Keys werden verwendet unter der Voraussetzung, dass diese numerisch sind.
|-
|UseMultipleHierarchies
|Ist dieser Eintrag auf true, werden Alternativhierarchien von Olap Dimensionen geladen und können verwendet werden (ab SSAS 2005).
|-
|MultiSelectFilterActive
|Ist dieser Eintrag auf true, werden Dimensionen, die als Filter verwendet werden, mit Mehrfachauswahl (Multiselect) unterstützt. (Derzeit bis 9.3 werden keine MultiselectFilter für CoPlanner Dimensionen unterstüzt.)
|-
|LoadMeasureFormatAndType
|Ist dieser Eintrag auf true, werden Measureformat und Typ vom Olap Server pro Measure geladen. Bei false werden Measures immer als Text geladen und die Formatted Value verwendet (Achtung bei Culturevermischungen) (ab SSAS 2005).
|-
|ReplaceNullValues
|Ist dieser Eintrag auf true, werden Null Values vom Connector mit 0 ersetzt.
|-
|DimensionLoadMode
|Betrifft das Ladeverhalten von OLAP Dimensionen. Folgende Einträge sind zulässig: AsDimension (Defaultwert), AsDimHierarchy und AsDimAndHierarchy. Siehe: [[Technik:CoPlanner-Server#Exkurs_SSAS_Einstellungen|Exkurs SSAS Einstellungen]]
|-
|LoadDimensionsByAlias
|Diese Einstellung zieht wenn einem OLAP Cube eine Dimension mehrfach, mit unterschiedlichen Bezeichnungen, zugeordnet ist. Ist der Eintrag auf False gesetzt so wird die erste gefundene Dimension geladen, ist der Eintrag auf True gesetzt so werden alle Dimensionen geladen. Siehe: [[Technik:CoPlanner-Server#Exkurs_SSAS_Einstellungen|Exkurs SSAS Einstellungen]]
|}
{| {{Bausteindesign1}}
|-
| '''Wichtig'''  Werden die SSAS Einstellungen LoadDimensionByAlias bzw. DimensionLoadMode im Nachhinein geändert so müssen sämtliche Cubes die auf OLAP verweisen neu aufgebaut werden.
|}

===SSRSSettings===
Folgende Punkte müssen im Bereich SSRSSettings definiert werden:

{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|ReportServerUrl
|Das virtuelle Verzeichnis für den Berichtsserver.
|-
|ReportWebServiceUrl
|Der SOAP-Endpunkt für die Berichtsverwaltung.
|-
|RootFolder
|Das Basisverzeichnis für die Berichte am Berichtsserver.
|-
|UserFolder
|Das Verzeichnis für Berichte, die im [[Framework:BI_Center|BI-Center]] mit dem Berichtsassistenten erstellt werden. Fehlt die Angabe, wird das Basisverzeichnis verwendet.
|-
|TempFolder
|Das Verzeichnis für Berichte, die im [[Enterprise_Edition:Ad-hoc_Analyse#CoPlanner_Analyzer|Analyzer]] mit dem [[Berichtsassistent|Berichtsassistenten]] erstellt werden. Fehlt die Angabe, wird das Basisverzeichnis verwendet.
|-
|SharedDataSourceReference
|Pfad und Name zu einer bereits vorhandenen Datenquelle am Berichtsserver, die vom Berichtsassistenten beim Erstellen eines neuen Berichtes verwendet wird. Fehlt diese Angabe erzeugt der Berichtsassistent eine im Bericht eingebettete Datenquelle. Bei Berichten mit eingebetteten Datenquellen kann vom Reportbuilder keine Vorschau angezeigt werden.
|-
|Parameters
|Derzeit nicht in Verwendung.
|}

'''Folgende Punkte müssen im Bereich DBCon definiert werden:'''

{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|Stage
|
{| class="wikitable" width={{{breite|100%}}}
|-
|''Server''
|Name des Servers, auf dem sich die Datenbank befindet
|-
|''Initial Catalog''
|Name der Datenbank
|-
|''User id''
| Name des Benutzers, mit dem sich der CoPlanner-Server am SQL-Server anmeldet (standardmäßig sollte bereits die ID „sa“ existieren). Alternativ kann bzw. muss ein User mit entsprechenden Rechten am SQL-Server angelegt werden.
|-
|''Password''
|Passwort des Benutzers
|-
|''Pooling''
|Damit Restore Database (fix integriert im Entwicklermenü) funktioniert, muss im Connectionstring Pooling = false vorhanden sein!
|}
|}

'''Weitere Variablen:''' 
Variablen können zum Beispiel bei Importen benutzt werden. Importobjekte benötigen einen Connectionstring, um zB. eine Verbindung zu einer Vorsystemdatenbank aufbauen zu können. Um nun mit einem Eintrag mehrere Objekte gleichzeitig ändern zu können wird empfohlen, solche Connectionstrings als Variablen zu definieren, um Änderungen schneller vollziehen zu können.
<add key="Variablenname" value="Wert bzw. Eintrag, den die Variable haben soll"></add>

===SupportConfig===

{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|SupportMailAddress
|Wird für Aufrufe des Supports per Mail verwendet.
|-
|SupportFormAddress
|Formular, welches bei Aufruf des Support aufgerufen wird.
|}
===WebConfig===
Folgende Punkte müssen im Bereich WebConfig definiert werden:

{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|WebAppUrl
|Zwingend erforderlich. Über diese URL erfolgt die komplette Kommunikation mit den Clients.

Bei Verwendung müssen die Schritte, welche unter [[Technik:CoPlanner-Server#Einrichtung des CoPlanner-Servers mit HTTPS|Einrichtung des CoPlanner-Servers mit HTTPS]] angeführt sind, ausgeführt werden.

Es können mehrere URL durch | getrennt angegeben werden (z.B. https://+:4443/|http://+:8080/). Die erste angegebene URL ist jene, die für die Sessionvariable @Session_WebAppUrl@ verwendet wird. Mit den anderen kann man ebenfalls auf den CoPlanner zugreifen. Der Windowsclient und die AddIns sollten über die erste URL zugreifen.
|-
|ReportServerUrl
|URL über die mit dem Repotserver kommuniziert werden kann. Nur notwendig, wenn das Webreporting im Einsatz ist.
|-
|LogonLanguages
|Definiert in welchen Sprachen man sich am Webclient anmelden kann.
|-
|LogonWithCoPlannerSecurity
|Definiert, ob man sich im Webclient mit CoPlanner Security anmelden kann. Bei false steht die Option nicht zur Verfügung.
|-
|LogonWithSSPI
|Definiert, ob man sich im Webclient mit Single Sign-on anmelden kann. Bei false steht die Option nicht zur Verfügung.
|-
|CorsAllowedOrigins
|Wird von einem anderen Host auf die API zugegriffen, muss der Host hier definiert werden. z.B. Aufruf erfolgt über <nowiki>https://servername:5000/irgendeinaufruf</nowiki>, dann muss hier <nowiki>https://servername:5000</nowiki> vergeben werden. Mit <nowiki>|</nowiki> getrennt können mehrere angegeben werden.
|-
|EnableSwagger
|Definiert, ob man auf den Swagger zugreifen kann. Sofern das am System nicht benötigt wird, sollte die Option auf false sein.
|-
|ApiClientForPowerUserOnly
|Muss false sein, wenn man den Windowsclient, Reportserver oder ein Addin auch ohne den PowerUser-Modus verwenden möchte. Ist die Option true, kann man sich nur mehr als PowerUser, Partner oder Hersteller anmelden, außer im Webclient.
|-
|EnableExperimentalEndpoints
|Muss true sein, wenn Hilfeseiten, CSV-Upload, Cockpits oder etwas anderes aus dem Prototype aufgerufen wird. Sofern diese Apps nicht verwendet werden sollte man diese Option auf false setzen.
|-
|EnableMssEndpoints
|Aktiviert die Endpunkte, die für MSS Masken benötigt werden. Sofern diese Masken nicht im Einsatz sind sollte diese Option auf false sein.
|-
|EnableAuthWithSessionId
|Wird benötigt für die Übergabe der Session-ID im Windowsclient für MSS-Masken und die Prototype Dinge. Sofern diese nicht verwendet werden sollte diese Option auf false sein.
|-
|EnableHttpsRedirection
|Wenn die Option auf true ist, werden HTTP-Verbindungen auf den HTTPS-Port weitergeleitet. Gibt es in der WebAppUrl nur eine URL mit HTTPS, so wird automatisch dieser Port herangezogen. Gibt es mehrere HTTPS-URLs, so muss der Port, auf den umgeleitet werden soll bei HttpsRedirectionPort eingetragen werden.
|-
|HttpsRedirectionPort
|Hier kann der HTTPS-Port angegeben werden, auf welchen die HTTP-Verbindungen weitergeleitet werden.
|-
|EnableHSTS
|Mit dieser Option kann HTTP Strict Transport Security (HSTS) aktiviert werden.
|-
|StartUrl
|Mit dieser Option gibt es eine Weiterleitung, wenn man den Pfad der WebAppUrl direkt aufruft. Dieser Pfad sollte alles hinter dem Port beinhalten. z.B. /coplanner/tiles/?menu=Startmenue. Wird https://meinservername:4443/coplanner aufgerufen, gibt es hier eine automatische Weiterleitung auf https://meinservername:4443/coplanner/tiles/?menu=Startmenue.
|-
|EnableResponseCompression
|Möglichkeit zum Deaktivieren der ResponseCompression. Komprimierung und https kann zu Security-Problemen führen, weshalb es hier die Möglichkeit gibt, diese auch bei Bedarf zu deaktivieren.
|}

===OlapServiceSettings===
{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|OlapServiceUrl
|Es gibt die Möglichkeit künftig die Anbindung an den CoPlanner über ein eigenes [[Technik:OlapService|OLAP Service]] laufen zu lassen und nicht mehr direkt integriert. Will man das Service verwenden, muss man dieses konfigurieren, hier die URL des Service angegeben und den Server und den Databasename aus den [[Technik:CoPlanner-Server#SSASSettings|SSASSettings]] rausnehmen.
|}

===Exkurs SSAS Einstellungen===
Der CoPlanner-Server bietet mehrere Möglichkeiten SSAS-Dimensionen zu laden. Im Folgenden werden die zulässigen Einstellungen aufgelistet. 

{| class="wikitable" width={{{breite|100%}}}
|-
|DimensionLoadMode
|LoadDimensionByAlias
|Einstellung
|Ergebnis
|-
|AsDimension
|False
|[[Image:T_SSAS_AsDimension.jpg]]
|[[Image:T_SSAS_AsDimension01.jpg|thumb|center]]
|-
|AsDimension
|True
|[[Image:T_SSAS_AsDimensionTrue.jpg]]
|[[Image:T_SSAS_AsDimensionTrue01.jpg|thumb|center]]
|-
|AsDimHierarchy
|True
|[[Image:T_SSAS_AsDimHierarchy.jpg]]
|[[Image:T_SSAS_AsDimHierarchy01.jpg|thumb|center]]
|-
|AsDimAndHierarchy
|True
|[[Image:T_SSAS_AsDimAndHierarchy.jpg]]
|[[Image:T_SSAS_AsDimAndHierarchy01.jpg|thumb|center]]
|}

{| {{Bausteindesign1}}
| '''Wichtig'''   Per Default gelten folgende Einstellungen: DimensionLoadMode=AsDimHierarchy bzw. LoadDimensionByAlias=True.
|}

{| {{Bausteindesign1}}
|-
| '''Wichtig'''  Werden die SSAS Einstellungen LoadDimensionByAlias bzw. DimensionLoadMode im Nachhinein geändert so müssen sämtliche Cubes die auf OLAP verweisen neu aufgebaut werden.
|}

Nachfolgend werden die zulässigen OLAP Einstellungen näher beschrieben
{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|XmlaLoadActive
|
* Defaultwert = True, dieser Wert wird vom CoPlanner gesetzt, wenn die Einstellung nicht im SvrConfig getroffen wurde
* diese Einstellung gibt an mit welcher Methode die OLAP Dimensionselemente geladen werden:
- False: die DimensionsMembers werden mittels Level.GetMembers() geladen
- True: die DimensionsMembers werden aus SchemaDataSet geholt. (Die ADOMD Methode GetSchemaDataSet(…) wird verwendet.)
|}

===Exkurs FormulasUsePriorityQueue===
Im Formelwerk gibt es die Möglichkeit, eine Execution Order für Formeln zu definieren. Damit diese angewendet wird muss der Parameter „FormulasUsePriorityQueue“ im svrconfig.xml auf true gesetzt sein.

Mit dieser Option der Formelabarbeitung werden Formeln nicht wie bisher nach der Reihenfolge, in der die Formeln durch die Änderungen der Tabelle getriggert wurden, abgearbeitet, sondern nach Priorität.

Anhand eines einfachen Beispiels werden altes und neues Verhalten verglichen: wenn sich in der Gewinn- und Verlustrechnung die Umsätze ändern, dann ändert sich der Gewinnvortrag und auch die Bilanz muss neu gerechnet werden.

Ohne Anpassung der Priorität wird jetzt mit der Änderung eines Umsatzes im Jänner der Gewinn-/Verlustvortrag für den Februar angepasst und die Bilanz neu gerechnet, durch die Änderung des Gewinn-/Verlustvortrags im Februar ändert sich auch der Gewinn-/Verlustvortrag im März, und muss somit neu gerechnet werden. Beim Schreiben dieser Änderung wird auch wieder die Berechnung der Bilanz ausgelöst.

Vereinfacht gesagt, aus einer Umsatzänderung resultiert auch eine Gewinn-/Verluständerung, die monatsweise weitergeschrieben werden muss und bei jedem Weiterschreiben wird auch die Bilanz neu gerechnet.

Sinnvoll wäre es aber, zuerst die GuV fertig zu rechnen (d.h. den Gewinnvortrag bis Ende Jahr weiterzuschreiben), und erst dann die Daten einmal in die Bilanz zu übernehmen.

Dies kann über die PriorityQueue erreicht werden: hat die Formel für den Gewinn-/Verlustvortrag z.B. eine Priorität von 1 und die Formel, die die Bilanz aktualisiert, eine Priorität von 2, so wird bei jedem Weiterschreiben eine weitere Berechnung des Gewinn-/Verlustvortrags und eine Berechnung der Bilanz in die Berechnungsqueue gestellt.

In der PriorityQueue wird die Formel mit Priorität 1 vorgereiht, wodurch das Berechnen des Gewinn-/Verlustvortrags vor der Berechnung der Bilanz abgeschlossen wird. Zusätzlich erkennt das System, das es bereits eine Anforderung, die Bilanz neu zu rechnen, in der Queue hat und stellt diese Anforderung daher nicht mehr zusätzlich in die Queue.

====Festlegen der Reihenfolge====
Die Priorität für die Abarbeitung einer Formel wird anhand der Tabelle, deren Änderung die Berechnung der Formel triggert, festgelegt. Somit können Formeln mit unterschiedlicher Priorität ausgeführt werden (z.B. bei den variablen Kosten: wird die Neuberechnung der Variablen Kosten durch eine Änderung in der variablen Kosten-Planung ausgelöst, so will in der Maske auf das Ergebnis warten, wird die Berechnung hingegen durch eine Änderung in der Umsatzplanung getriggert, so soll diese Berechnung im Hintergrund passieren. Das lässt sich realisieren, indem man den beiden Tabellen „Umsatzerlöse“ und „Variable Kosten unterschiedliche Prioritäten im Formeldesigner zuweist)

Wird keine Reihenfolge vergeben, oder kann keine Reihenfolge ermittelt werden (z.B. Formel wird durch ein Makro aufgerufen), so wird die Reihenfolge auf 1 gesetzt.

====Vermeidung Queue Starvation====
Wenn Gefahr droht, dass eine Berechnungsanforderung „ewig“ in der Queue warten muss, wird dies vom System erkannt, und neue Berechnungsanforderungen werden ab dem Zeitpunkt des Erkennens hinter die bereits in der Queue befindlichen Berechnungsanforderungen gelegt – unabhängig von der vergebenen Priorität.

====Masken: Warten auf Berechnungen der ersten Ebene====
In Eingabemasken kann durch das Setzen des Flags „WaitForCalc“ festegelegt werden, ob auf Berechnungen gewartet wird. Im der bestehenden Implementierung zu Festlegung der Reihenfolge wird dabei auf alle Berechnungen gewartet, die direkt durch das Schreiben in eine Tabelle ausgelöst wurden (dies wird durch Kalkulationstiefe 1 gekennzeichnet). Dabei wird auf alle Formeln der Kalkulationstiefe 1 gewartet, unabhängig davon, ob die Berechnung durch den Benutzer selbst oder durch die Eingabe eines anderen Benutzers ausgelöst wurde.

Mit der PriorityQueue kann dies feiner gesteuert werden, es wird auf die Abarbeitung aller direkt durch die Eingabe ausgelösten Formeln, deren Reihenfolge < 0 ist gewartet (ebenfalls benutzerübergreifend). Um auf eine Formel zu warten, die auf einer anderen Tabelle als der Eingabetabelle rechnet, muss man diese Formel nur von der Eingabetabelle aus triggern und mit einer passenden Priorität (< 0) versehen.
Dies kann z.B. wie folgt genutzt werden: in einer Umsatztabelle wird über eine Update-Formel der Umsatzsteuersatz zum aktuellen Datensatz dazugeholt und die USt gerechnet, und über eine weitere Formel der Umsatz für eine GuV-Berechnung weitergeschrieben. In der Maske wird jetzt auf die Update-Formel gewartet, da USt und USt-Satz dem Benutzer angezeigt werden, auf das Weiterschreiben in Richtung GuV wird jedoch nicht gewartet.

====Sonderstellung der SAME-Formel====
Wird die Berechnung von SAME-Formeln durch eine Dateneingabe ausgelöst, so werden diese Formel direkt beim Speichern des Datensatzes synchron gerechnet (und nicht in die Liste eingefügt). Die Berechnung erfolgt somit nicht über die Liste mit durchzuführenden Berechnungen.

====Anmerkungen====
Es wird generell davon abgeraten, die PriorityQueue zu verwenden, ohne das Verhalten des Rechenwerks bei bestehenden Modellen ausführlich zu testen.
Die Änderung von Duplikaten musste im Rahmen der Implementierung der neuen Funktionsweise ebenfalls angepasst werden; dies kann in Ausnahmefällen dazu führen, dass die Berechnungs-reihenfolge in bestehenden Modellen anders ist als bisher.

===Konfigurationstool===

Zum Bearbeiten der CoPlanner Server Einstellungen steht im Server-Verzeichnis ein Konfigurationstool "SvrConfig.exe" zur Verfügung.

==NLog.Server.config bzw. NLog.Service.config==
Prinzipiell kann hier mehr angepasst werden, aber die grundlegenden Eigenschaften:

:* logDirectory: Verzeichnis ohne den Dateinamen, wo hingeloggt werden soll
:* fileName: Hier kann man den Dateinamen anpassen oder wenn man möchte auch den gesamten Pfad
:* archiveAboveSize: gibt an, ab welcher Dateigröße eine neue Datei geschrieben wird. Der Standard von 10000000 entspricht 10 MB.

== appsettings.json ==
Bei Verwendung von https wird in dieser Datei angegeben, woher das Zertifikat bezogen werden soll.

Das Zertifikat kann entweder als Datei abgespeichert oder aus dem Zertifikatsspeicher bezogen werden. Bei Pfadangaben müssen immer zwei \ und nicht nur einer verwendet werden (z.B. D:\\MyCertFolder\\MyCert.pfx).

==CoPlanner-Server als Dienst==
Der CoPlanner-Server kann auch als Dienst installiert werden. Wichtig hierbei ist, dass Sie Administratorrechte besitzen, um die Installation durchführen zu können.
Sie starten den Dienst mit der Schaltfläche "Install service", der unter CopSettings zu finden ist. Der Service wird mit dem Namen gestartet, der unter ServiceName angegeben ist.
Um den CoPlanner-Server als Dienst zu deinstallieren wählen Sie "Uninstall service".

===Mehrere CoPlanner Dienste auf einem Rechner installieren===

Auf einem Rechner können auch mehrere CoPlanner Services installiert werden. Dazu ist lediglich der ServiceName unter den CopSettings zu ändern und der Dienst erneut zu installieren.
Unter den Windows Diensten sind dann 2 voneinander unabhängige Dienste vorhanden.

[[Image:T_Codesnip4.jpg]]

==CoPlanner-Server als Applikation==

===Starten des Servers als Applikation===

Durch das Kopieren des Serververzeichnisses auf den Rechner ist die Installation eigentlich beendet. Sie müssen nur noch die Datei CopServer.exe starten. Ein Konsolenfenster erscheint. Hier können Sie mit verfolgen, welche Operationen der CoPlanner-Server gerade ausführt.

==Einrichtung des CoPlanner-Servers mit HTTPS==
Um eine sichere Kommunikation des Webclients mit dem CoPlanner-Server gewährleisten zu können, sollte unbedingt HTTPS eingesetzt werden.

Dies bietet insbesondere zwei Vorteile:
:* Verschlüsselung (es kann nicht mitgelesen werden)
:* Signaturprüfung (es ist sichergestellt, dass auch mit dem richtigen Server kommuniziert wird)

Um HTTPS nutzen zu können, wird ein Zertifikat benötigt. Dieses kann entweder selbst erstellt oder von diversen Anbietern bezogen werden. Beide Optionen haben Vor- und Nachteile.
Das Zertifikat muss ein "[https://de.wikipedia.org/wiki/X.509 X.509 Certificate]" sein (liegt meist als PFX-Datei vor) und für die Domain gültig sein, auf der der CoPlanner-Server laufen soll.

Beispiel:
Soll der Server unter <nowiki>https://sample.copserver.mycompany:8080/coplanner</nowiki> laufen, muss das Zertifikat für sample.copserver.mycompany gültig sein.

===Selbst erstellte Zertifikate ("self signed")===
Vorteile: Frei konfigurierbar, jederzeit verfügbar, unabhängig

Nachteile: Von gängigen Webbrowsern standardmäßig nicht akzeptiert

Soll ein selbst erstelltes Zertifikat verwendet werden, muss es auf den PCs der Endanwender für deren Browser als vertrauenswürdig markiert werden. Die genaue Einstellung unterscheidet sich je nach Browser und Betriebssystem.
Grundsätzlich beachten die meisten Webbrowser die Zertifikatseinstellungen des Betriebssystems (zum aktuellen Zeitpunkt mindestens Chrome, Edge und Internet Explorer). Firefox muss allerdings separat konfiguriert werden (siehe [https://support.mozilla.org/en-US/kb/setting-certificate-authorities-firefox diese Information] von Mozilla).

Es ist möglich, [https://docs.microsoft.com/en-us/windows-server/identity/ad-fs/deployment/distribute-certificates-to-client-computers-by-using-group-policy Zertifikate mittels Gruppenrichtlinie in Windows-Domänen zu verteilen].

===Zertifikat von einem Anbieter===
Vorteile: Von gängigen Webbrowsern ohne Konfiguration akzeptiert

Nachteile: Teilweise kostenpflichtig, unterschiedlicher Service je Anbieter

Anbieter für SSL-Zertifikate gibt es viele, die Preise ändern sich laufend.

Beispiele für Anbieter:

Let’s Encrypt: https://letsencrypt.org/de/

Kostenlos. Muss alle drei Monate erneuert werden.

Thawte: https://www.thawte.de/

Kostenpflichtig.

Der Prozess unterscheidet sich je nach Anbieter. Im Endeffekt sollte das Zertifikat als Datei vorliegen, die auf dem Server installiert werden kann.

===Einrichtung von HTTPS unter Windows Server===
Als Hosting-Komponente für den CoPlanner-Server wird Kestrel, ein plattformunabhängiger Webserver für ASP.NET Core verwendet. Diese kümmert sich auch um HTTPS.

Das Zertifikat muss für die Installation entweder als Datei vorliegen, oder bereits am Server installiert sein. Falls das Zertifikat bereits installiert ist, müssen Store, Location und Subject bekannt sein und der Serviceuser muss das Leserecht auf den Private-Key des Zertifikats besitzt.

Zusätzlich muss bekannt sein, für welchen Aufruf das Zertifikat gültig ist. Dieser muss der Adresse entsprechen, mit dem die Nutzer auf den CopServer zugreifen werden. Die WebAppUrl sollte ebenfalls auf genau diese Adresse gesetzt werden (es sollte kein "+" mehr darin verwendet werden).

Beispiele:

Unsicher: <nowiki>https://+:8080/coplanner</nowiki>

In Ordnung: <nowiki>https://*.copserver.mycompany:8080/coplanner</nowiki>

In Ordnung: <nowiki>https://sample.copserver.mycompany:8080/coplanner</nowiki>

===Anpassung SPN (Service Principal Name) für Single Sign-On am Server===
Entspricht der vollständige Computername nicht der URL, welche aufgerufen wird muss ein zusätzlicher Service Principal Name hinzugefügt werden, wenn man sich auch Server direkt auch mit Single Sign-On anmelden will.

z.B. vollständiger Computername ist myserver.test.coplanner.com und die URL über die zugegriffen wird ist myserver.coplanner.com

Ausgabe aller Service Principal Names (SPNs) für myserver:

setspn -L myserver

Mit setspn -S "HTTP/myserver.coplanner.com" MeinServiceBenutzername
kann der hinzufügen. Um dies zu machen braucht man hohe Rechte.

Nähere Infos zu setspn finden Sie unter https://social.technet.microsoft.com/wiki/contents/articles/717.service-principal-names-spn-setspn-syntax.aspx.

Firefox erlaubt standardmäßig keine Negotiate-Uris. Damit Firefox mit Negotiate funktioniert, muss mit "about:config" -> "network.negotiate-auth.trusted-uris" die Url freigeben werden.

Für den Zugriff aller Clients, die eine ClientConfig.xml besitzen (z.B. Windowsclient, MakroExecutor, AddIns,...), mit Single Sign-On direkt am Server muss in der ClientConfig.xml der Eintrag ServicePrincipalNameForServerUrl auf HOST/myserver gesetzt werden.

===Anpassung für Single Sign-On im Firefox===
Wenn beim Single Sing-On im Firefox noch eine Box kommt, wo man den Namen und Passwort nochmal eingeben muss, dann sollte man folgende Schritte ausführen oder diese per GPO ausrollen:

:* Firefox öffnen und in Adressleiste about:config eingeben und mit Enter bestätigen
:* Suchen nach dem Eintrag network.negotiate-auth.trusted-uris
:* Hier dann den Namen angeben, mit dem die Seite aufgerufen wird. z.B. servername, wenn der Aufruf über <nowiki>http://servername:4488/...</nowiki> erfolgt oder servername.coplanner.com, wenn der Aufruf über <nowiki>http://servername.coplanner.com:4488/...</nowiki> erfolgt. Sollte es für beide Varianten funktionieren, kann man bei dem Eintrag mehrere Namen mit , getrennt angeben.

===Anpassung für Single Sign-On in Chrome und Edge===
Wenn beim Single Sing-On im Chrome oder Edge noch eine Box kommt, wo man den Namen und Passwort nochmal eingeben muss, dann sollte man folgende Schritte ausführen oder diese per GPO ausrollen:

:* Öffnen Sie die Systemsteuerung > Internetoptionen.
:* Wählen der Registerkarte Sicherheit
:* Wählen Sie Lokales Intranet aus und klicken Sie auf Sites.
:* Klicken Sie auf Erweitert
:* Hier dann den Namen angeben, mit dem die Seite aufgerufen wird. Beispiel: https://servername.coplanner.com
:* Bestätigen mit Hinzufügen__NOEDITSECTION__

[[Category:Technik|Server]]
[[en:Technics:CoPlanner-Server]]

Power BI Connector

2022-09-23T07:09:47Z

Admin:

__TOC__

== Was ist ein Power BI-Connector ==
Konnektoren ermöglichen es Daten aus verschiedenen Quellen in Power BI zu beziehen. Power BI beinhaltet eine Vielzahl von Standardkonnektoren für gängige Datenquellen, wie z.B. Excel, SQL, usw.

Um Daten aus dem CoPlanner beziehen zu können wurde der CoPlanner Power BI Connector entwickelt. Dieser Konnektor wurde nach den Richtlinien von Microsoft zum Erstellen eines Custom Connectors für Power BI entwickelt.

Mit dem CoPlanner Power BI Connector ist es möglich Tabellen, Dimensionen, Subsets und Funktionen aus CoPlanner Modellen zu beziehen. Es können Daten aus beliebig vielen CoPlanner Serverinstanzen bezogen werden. Funktionen, welche über den Konnektor zur Verfügung gestellt werden, können dabei helfen die Performance zu steigern.

== Voraussetzungen ==

* Power BI Desktop ist installiert
* CoPlanner Server läuft unter https
* CoPlanner Lizenz muss Power BI freigeschalten haben

== Installation ==
Der Connector "CoPlanner.pqx" muss in das Verzeichnis C:\Users\<username>\Documents\Power BI Desktop\Custom Connectors gespeichert werden.

Damit der Konnektor funktioniert muss er als vertrauenswürdig gelten oder in Power BI muss unter den Optionen bei Data Extensions die Option aktiviert werden, dass Extensions ohne Validierungen oder Warnungen zugelassen werden.

Damit der Konnektor als vertrauenswürdig gilt, muss der Public Key des Zertifikats von CoPlanner (muss angefragt werden) ausgerollt werden (siehe https://docs.microsoft.com/en-us/power-bi/connect-data/desktop-trusted-third-party-connectors)

Am Client muss man dazu in der Policies den Thumbprint von CoPlanner angeben. Dies sollte ein Installer in Zukunft übernehmen. Manuelle Schritte:
1.) HKLM\SOFTWARE\Policies\Microsoft\Power BI Desktop
2.) TrustedCertificateThumbprints als REG_MULTI_SZ erstellen, oder wenn vorhanden öffnen
3.) 88ffa1db2ef91032e4ea20a510288bda4e6c7116 hinterlegen, oder ergänzen

== Verwendung ==
Bei dem Menüpunkt "Daten abrufen" befindet sich unter "Weitere..." ein Konnektor mit dem Namen CoPlanner.

Wählt man diesen aus, muss man die URL angeben unter welcher der Server erreichbar ist (z.B. <nowiki>https://meinservername:4443/coplanner</nowiki>) und kann optional die Sprache angeben.

Verbindet man sich erstmalig auf diese URL, so bekommt man dann einen Dialog, wo man sich entscheiden kann, ob man sich über Windowsauthentifizierung oder über den CoPlanner Benutzer anmelden will. Dieser Benutzer muss entsprechend im CoPlanner vorhanden und berechtigt sein.

Bei weiteren Zugriffen auf diese URL bekommt man diese Abfrage nicht mehr, will man den Benutzer ändern, dann muss man das über die Datenquelleneinstellungen anpassen.

Nach dem Zugriff bekommt man ein Fenster, den Navigator, in welchem Funktionen, Tabellen, Dimensionen und Subsets aufgelistet werden. Hier wählt man die entsprechenden Daten aus, die man in diesem Bericht anzeigen will und lädt diese.

Hat man Tabellen/Dimensionen vergessen oder möchte einfach den Bericht erweitern, kann man das einfach über die zuletzt verwendeten Quellen tun.

=== Beziehungen verwalten ===
Bei der Verwendung von mehr als einer Tabelle, welche auch die gleichen Dimensionen verwenden ist es wichtig die Beziehungen richtig zu pflegen. Wenn diese richtig gepflegt sind, kann man im Bericht nach den Dimensionen filtern.

Diese Verbindungen werden beim Erstellen angelegt, müssen dann allerdings überprüft werden, ob alle Beziehungen erstellt wurden und diese auch richtig sind.

=== Hierarchien erstellen ===
Dimensionen besitzen die Felder Level_0 bis Level_x. Um eine Hierarchie von der obersten Ebene weg zu erstellen, öffnen Sie mit der rechten Maustaste das Kontextmenü und wählen Sie Hierarchie erstellen. Wenn man danach z.B. auf Level_1 klickt, kann man über das Kontextmenü diesen Eintrag zur Hierarchie hinzufügen.

=== Caches leeren ===
Unter den Optionen von Power BI unter Daten laden gibt es die Möglichkeit Caches zu löschen. Dies kann sinnvoll sein, wenn man Performanceprobleme oder andere unerwartete Probleme hat bei Dingen, die schon funktioniert hatten.

__NOTOC__
__NOEDITSECTION__
[[Category:!Hauptkategorie]] [[Category:Power BI Connector]]
[[en:Power BI Connector]]

Power BI Connector

2022-09-22T14:51:50Z

Admin:

__TOC__

== Was ist ein Power BI-Connector ==
Konnektoren ermöglichen es Daten aus verschiedenen Quellen in Power BI zu beziehen. Power BI beinhaltet eine Vielzahl von Standardkonnektoren für gängige Datenquellen, wie z.B. Excel, SQL, usw.

Um Daten aus dem CoPlanner beziehen zu können wurde der CoPlanner Power BI Connector entwickelt. Dieser Konnektor wurde nach den Richtlinien von Microsoft zum Erstellen eines Custom Connectors für Power BI entwickelt.

Mit dem CoPlanner Power BI Connector ist es möglich Tabellen, Dimensionen, Subsets und Funktionen aus CoPlanner Modellen zu beziehen. Es können beliebig viele CoPlanner Serverinstanzen bezogen werden. Funktionen, welche über den Konnektor zur Verfügung gestellt werden, können dabei helfen die Performance zu steigern.

== Voraussetzungen ==

* Power BI Desktop ist installiert

* CoPlanner Server läuft unter https
* CoPlanner Lizenz muss Power BI freigeschalten haben

== Installation ==
Der Connector "CoPlanner.pqx" muss in das Verzeichnis C:\Users\<username>\Documents\Power BI Desktop\Custom Connectors gespeichert werden.

Damit der Konnektor funktioniert muss er als vertrauenswürdig gelten oder in Power BI muss unter den Optionen bei Data Extensions die Option aktiviert werden, dass Extensions ohne Validierungen oder Warnungen zugelassen werden.

Damit der Konnektor als vertrauenswürdig gilt, muss der Public Key des Zertifikats von CoPlanner (muss angefragt werden) ausgerollt werden (siehe https://docs.microsoft.com/en-us/power-bi/connect-data/desktop-trusted-third-party-connectors)

Am Client muss man dazu in der Policies den Thumbprint von CoPlanner angeben. Dies sollte ein Installer in Zukunft übernehmen. Manuelle Schritte:
1.) HKLM\SOFTWARE\Policies\Microsoft\Power BI Desktop
2.) TrustedCertificateThumbprints als REG_MULTI_SZ erstellen, oder wenn vorhanden öffnen
3.) 88ffa1db2ef91032e4ea20a510288bda4e6c7116 hinterlegen, oder ergänzen

== Verwendung ==
Bei dem Menüpunkt "Daten abrufen" befindet sich unter "Weitere..." ein Konnektor mit dem Namen CoPlanner.

Wählt man diesen aus, muss man die URL angeben unter welcher der Server erreichbar ist (z.B. <nowiki>https://meinservername:4443/coplanner</nowiki>) und kann optional die Sprache angeben.

Verbindet man sich erstmalig auf diese URL, so bekommt man dann einen Dialog, wo man sich entscheiden kann, ob man sich über Windowsauthentifizierung oder über den CoPlanner Benutzer anmelden will. Dieser Benutzer muss entsprechend im CoPlanner vorhanden und berechtigt sein.

Bei weiteren Zugriffen auf diese URL bekommt man diese Abfrage nicht mehr, will man den Benutzer ändern, dann muss man das über die Datenquelleneinstellungen anpassen.

Nach dem Zugriff bekommt man ein Fenster, den Navigator, in welchem Funktionen, Tabellen, Dimensionen und Subsets aufgelistet werden. Hier wählt man die entsprechenden Daten aus, die man in diesem Bericht anzeigen will und lädt diese.

Hat man Tabellen/Dimensionen vergessen oder möchte einfach den Bericht erweitern, kann man das einfach über die zuletzt verwendeten Quellen tun.

=== Beziehungen verwalten ===
Bei der Verwendung von mehr als einer Tabelle, welche auch die gleichen Dimensionen verwenden ist es wichtig die Beziehungen richtig zu pflegen. Wenn diese richtig gepflegt sind, kann man im Bericht nach den Dimensionen filtern.

Diese Verbindungen werden beim Erstellen angelegt, müssen dann allerdings überprüft werden, ob alle Beziehungen erstellt wurden und diese auch richtig sind.

=== Hierarchien erstellen ===
Dimensionen besitzen die Felder Level_0 bis Level_x. Um eine Hierarchie von der obersten Ebene weg zu erstellen, öffnen Sie mit der rechten Maustaste das Kontextmenü und wählen Sie Hierarchie erstellen. Wenn man danach z.B. auf Level_1 klickt, kann man über das Kontextmenü diesen Eintrag zur Hierarchie hinzufügen.

=== Caches leeren ===
Unter den Optionen von Power BI unter Daten laden gibt es die Möglichkeit Caches zu löschen. Dies kann sinnvoll sein, wenn man Performanceprobleme oder andere unerwartete Probleme hat bei Dingen, die schon funktioniert hatten.

__NOTOC__
__NOEDITSECTION__
[[Category:!Hauptkategorie]] [[Category:Power BI Connector]]
[[en:Power BI Connector]]

Power BI Connector

2022-09-22T13:35:02Z

Admin:

__TOC__

== Was ist ein Power BI-Connector ==
Konnektoren ermöglichen es Daten aus verschiedenen Quellen in Power BI zu beziehen. Power BI beinhaltet eine Vielzahl von Standardkonnektoren für gängige Datenquellen, wie z.B. Excel, SQL, usw.

Um Daten aus dem CoPlanner beziehen zu können wurde der CoPlanner Power BI Connector entwickelt. Dieser Konnektor wurde nach den Richtlinien von Microsoft zum Erstellen eines Custom Connectors für Power BI entwickelt.

Mit dem CoPlanner Power BI Connector ist es möglich Tabellen, Dimensionen, Subsets und Funktionen aus CoPlanner Modellen zu beziehen. Es können beliebig viele CoPlanner Serverinstanzen bezogen werden. Funktionen, welche über den Konnektor zur Verfügung gestellt werden, können dabei helfen die Performance zu steigern.

== Voraussetzungen ==

* Power BI Desktop ist installiert

* CoPlanner Server läuft unter https
* CoPlanner Lizenz muss Power BI freigeschalten haben

== Installation ==
Der Connector "CoPlanner.pqx" muss in das Verzeichnis C:\Users\<username>\Documents\Power BI Desktop\Custom Connectors gespeichert werden.

Damit der Konnektor funktioniert muss er als vertrauenswürdig gelten oder in Power BI muss unter den Optionen bei Data Extensions die Option aktiviert werden, dass Extensions ohne Validierungen oder Warnungen zugelassen werden.

Damit der Konnektor als vertrauenswürdig gilt, muss der Public Key des Zertifikats von CoPlanner (muss angefragt werden) ausgerollt werden (siehe https://docs.microsoft.com/en-us/power-bi/connect-data/desktop-trusted-third-party-connectors)

== Verwendung ==
Bei dem Menüpunkt "Daten abrufen" befindet sich unter "Weitere..." ein Konnektor mit dem Namen CoPlanner.

Wählt man diesen aus, muss man die URL angeben unter welcher der Server erreichbar ist. (z.B. <nowiki>https://meinservername:4443/coplanner</nowiki>)

Verbindet man sich erstmalig auf diese URL, so bekommt man dann einen Dialog, wo man sich entscheiden kann, ob man sich über Windowsauthentifizierung oder über den CoPlanner Benutzer anmelden will. Dieser Benutzer muss entsprechend im CoPlanner vorhanden und berechtigt sein.

Bei weiteren Zugriffen auf diese URL bekommt man diese Abfrage nicht mehr, will man den Benutzer ändern, dann muss man das über die Datenquelleneinstellungen anpassen.

Nach dem Zugriff bekommt man ein Fenster, in welchem man die Dimensionen und Tabellen aufgelistet werden. Hier wählt man die entsprechenden Daten aus, die man in diesem Bericht anzeigen will und lädt diese.

Hat man Tabellen/Dimensionen vergessen oder möchte einfach den Bericht erweitern, kann man das einfach über die zuletzt verwendeten Quellen tun.

=== Beziehungen verwalten ===
Bei der Verwendung von mehr als einer Tabelle, welche auch die gleichen Dimensionen verwenden ist es wichtig die Beziehungen richtig zu pflegen. Wenn diese richtig gepflegt sind, kann man im Bericht nach den Dimensionen filtern.

Diese Verbindungen werden beim Erstellen angelegt, müssen dann allerdings überprüft werden, ob alle Beziehungen erstellt wurden und diese auch richtig sind.

=== Hierarchien erstellen ===
Dimensionen besitzen die Felder Level_0 bis Level_x. Um eine Hierarchie von der obersten Ebene weg zu erstellen, öffnen Sie mit der rechten Maustaste das Kontextmenü und wählen Sie Hierarchie erstellen. Wenn man danach z.B. auf Level_1 klickt, kann man über das Kontextmenü diesen Eintrag zur Hierarchie hinzufügen.

=== Caches leeren ===
Unter den Optionen von Power BI unter Daten laden gibt es die Möglichkeit Caches zu löschen. Dies kann sinnvoll sein, wenn man Performanceprobleme oder andere unerwartete Probleme hat bei Dingen, die schon funktioniert hatten.

__NOTOC__
__NOEDITSECTION__
[[Category:!Hauptkategorie]] [[Category:Power BI Connector]]
[[en:Power BI Connector]]

Technik:CoPlanner-Server

2022-09-22T10:56:46Z

Admin:

__TOC__

Der Ordner [[Technik:CoPlanner-Server_Installation|CoPlanner-Server]] muss auf jenem Rechner vorhanden sein, welcher als Server fungieren soll. Dieser enthält einige [[Technik:Konfigurationsdateien|Konfigurationsdateien]], welche Variablen, die Verbindung zu Clients, uvm. definieren. Diese müssen sorgfältig konfiguriert werden.

==SysCommands.xml==

Diese Datei ist im Serververzeichnis zu finden. Sie beinhaltet Informationen für CoPlanner Systemeinstellungen. Zu beachten ist hierbei nur, in welcher Sprache der SQL-Server installiert ist. Handelt es sich um ein deutsches Setup, so müssen Sie als Anwender nicht eingreifen. Handelt es sich um ein englisches Setup, muss die Datei ''„SysCommands.xml“'' gelöscht oder umbenannt und danach die Datei ''„SysCommands_EnSql.xml“'', welche ebenfalls im Serververzeichnis liegt, in ''„SysCommands.xml“'' umbenannt werden.

==SvrConfig.xml==

Diese Datei definiert Eigenschafen des CoPlanner-Servers. Sie befindet sich im Serververzeichnis.

<?xml version= "1.0" standalone="yes"?>
<SvrConfig.xml>
 <CopSettings>
 <Version>4</Version>
 <ConnectionString>Server=CopServer;Initial Catalog=COP_BIKE;Integrated Security=SSPI;pooling=false</ConnectionString>
 <DataBaseName>COP_BIKE</DataBaseName>
 <FiscalYear>0</FiscalYear>
 <ServiceName>copService</ServiceName>
 <TelnetDebugPort>6900</TelnetDebugPort>
 <DefaultLanguage>german</DefaultLanguage>
 <BackupPath>C:\temp\</BackupPath>
 <BackupRestoreLimitinMB>50</BackupRestoreLimitinMB>
 <WebAuthenticateUrl><nowiki>http://copsupport.coplanner.com/licence/get_cop_lic_v3.php</nowiki></WebAuthenticateUrl>
 <LicenceID>123</LicenceID>
 <ClientConnectionTimeOut>1440</ClientConnectionTimeOut>
 <EntitySecurity>true</EntitySecurity>
 <AllowNonPowerUserDeleteDimElementsWithData>false</AllowNonPowerUserDeleteDimElementsWithData>
 <MultiThreadCommand>true</MultiThreadCommand>
 <ProActiveCaching>true</ProActiveCaching>
 <SkipImportHistory>true</SkipImportHistory>
 <SecurityProxyLoad>false</SecurityProxyLoad>
 <CopSysIDStartOffset>0</CopSysIDStartOffset>
 <DebugMode>false</DebugMode>
 <StoredProcedureTimeout>3600</StoredProcedureTimeout>
 <ShowLostDBConnectionWaruning>true</ShowLostDBConnectionWaruning>
 <IISUserName></IISUserName>
 <TransportUserName></TransportUserName>
 <PowerUserModeViaADOnly>false</PowerUserModeViaADOnly>
 <ADGroupPowerUser></ADGroupPowerUser>
 <ADGroupPartnerUser></ADGroupPartnerUser>
 <ADGroupManufacturerUser></ADGroupManufacturerUser>
 <LoadAllEntityDimensionEntriesToClient>false</LoadAllEntityDimensionEntriesToClient>
 <FormulasUsePriorityQueue>false</FormulasUsePriorityQueue>
 <ReportServerUrl><nowiki>https://servername:4445/coplanner/reporting</nowiki></ReportServerUrl>
 <DoVersionCheck>true</DoVersionCheck>
 <UseNewDBSync>true</UseNewDBSync>
 <DBSyncMaxThreads>10</DBSyncMaxThreads>
 <DBCommandTimeout>600</DBCommandTimeout>
 <UseNewCaching>false</UseNewCaching>
 <CacheSizeFactor>0,5</CacheSizeFactor>
 <StartTabAdress></StartTabAdress>
 <LogonMaximumPerTimeframe>100</LogonMaximumPerTimeframe>
 <LogonMaximumTimeframeInSeconds>60</LogonMaximumTimeframeInSeconds>
 <SupportColumnTable>false</SupportColumnTable>
 <AllowBatchProcessingViaMacro>false</AllowBatchProcessingViaMacro>
 </CopSettings>
 <SSASSettings>
 <Server>CopServer</Server>
 <DataBaseName>cop_olap</DataBaseName>
 <XmlaLoadActive>true</XmlaLoadActive>
 <UseRealElementIDs>true</UseRealElementIDs>
 <UseMultipleHierarchies>true</UseMultipleHierarchies>
 <MultiSelectFilterActive>false</MultiSelectFilterActive>
 <LoadMeasureFormatAndType>true</LoadMeasureFormatAndType>
 <ReplaceNullValues>false</ReplaceNullValues>
 <DimensionLoadMode>AsDimAndHierarchy</DimensionLoadMode>
 <LoadDimensionsByAlias>true</LoadDimensionsByAlias>
 </SSASSettings>
 <SSRSSettings>
 <ReportServerUrl><nowiki>http://CopServer/reportserver</nowiki></ReportServerUrl>
 <ReportWebServiceUrl><nowiki>http://CopServer/reportserver/reportservice2005.asmx</nowiki></ReportWebServiceUrl>
 <RootFolder>/CoPlanner/Reports</RootFolder>
 <UserFolder>/CoPlanner/User</UserFolder>
 <TempFolder>/CoPlanner/Temp</TempFolder>
 <SharedDataSourceReference>/CoPlanner/DataSources/CoPlanner</SharedDataSourceReference>
 <Parameters></Parameters>
 </SSRSSettings>
 <DBCon>
 <Stage>Server=CopServer;Initial Catalog=COP_STAGE;Integrated Security=SSPI</Stage>
 </DBCon>
 <SupportConfig>
<SupportMailAddress>support@coplanner.com</SupportMailAddress>
 <SupportFormAddress><nowiki>https://copsupport.coplanner.com/support/</nowiki></SupportFormAddress>
 </SupportConfig>
 <WebConfig>
 <WebAppUrl><nowiki>https://+:4443/coplanner</nowiki></WebAppUrl>
 <LogonLanguages>Deutsch|English</LogonLanguages>
 <LogonWithCoPlannerSecurity>True</LogonWithCoPlannerSecurity>
 <LogonWithSSPI>True</LogonWithSSPI>
 <CorsAllowedOrigins><nowiki>https://servername:4443</nowiki></CorsAllowedOrigins>
 <EnableSwagger>False</EnableSwagger>
 <EnableCommandEndpoints>True</EnableCommandEndpoints>
 <EnableExperimentalEndpoints>True</EnableExperimentalEndpoints>
 <EnableMssEndpoints>False</EnableMssEndpoints>
 <EnableAuthWithSessionId>True</EnableAuthWithSessionId>
 <EnableHttpsRedirection>False</EnableHttpsRedirection>
 <HttpsRedirectionPort></HttpsRedirectionPort>
 <EnableHSTS>False</EnableHSTS>
 <StartUrl></StartUrl>
 <EnableResponseCompression>true</EnableResponseCompression>
 </WebConfig>
 <OlapServiceSettings>
 <OlapServiceUrl></OlapServiceUrl>
 </OlapServiceSettings>
</SvrConfig.xml>

===CopSettings===
Folgende Punkte müssen im Bereich CopSettings definiert werden:
{| class="wikitable" width="{{{breite|100%}}}"
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|ConnectionString
|
{| class="wikitable" width={{{breite|100%}}}
|-
|''Server''
|Name des Servers, auf dem sich die Datenbank befindet
|-
|''Initial Catalog''
|Name der Datenbank
|-
|''User id''
| Name des Benutzers, mit dem sich der CoPlanner-Server am SQL-Server anmeldet (standardmäßig sollte bereits die ID „sa“ existieren). Alternativ kann bzw. muss ein User mit entsprechenden Rechten am SQL-Server angelegt werden.
|-
|''Password''
|Passwort des Benutzers
|-
|''Pooling''
|Damit Restore Database (fix integriert im Entwicklermenü) funktioniert, muss im Connectionstring Pooling = false vorhanden sein!
|}
|-
|DataBaseName
|Name der SQL-Datenbank
|-
|FiscalYear
|Legt die Versetzung des Wirtschaftsjahres des Unternehmens zum Kalenderjahr fest. Dabei wird ausgehend vom Monat Jänner gerechnet.
:*0: keine Wirtschaftsjahrversetzung
:*-1: Anfang des Wirtschaftsjahres im Dezember des Vorjahres
:*1: Anfang des Wirtschaftsjahres im Februar desselben Jahres
|-
|ServiceName
|Name des CopService
|-
|TelnetDebugPort
|Es ist möglich, mittels Telnet ein Sichtfenster zum CoPlanner-Server aufzubauen. Dieser Eintrag legt die Portnummer für die Telnetverbindung fest. Die Verbindung erfolgt durch die DOS-Eingabeaufforderung (Start [[Image:arrow.jpg]] Ausführen [[Image:arrow.jpg]] cmd). Zum Aufruf der Verbindung geben Sie: telnet rechnername portnummer (Bsp: telnet hostname 6900) ein und drücken auf Return.
|-
|DefaultLanguage
|Die Defaultsprache des CoPlanner Servers.
|-
|BackupPath
|Legt den temporären Speicherplatz für ein Datenbankbackup, welches durch einen Client veranlasst werden kann, fest. Der SQL-Server muss Schreibrechte auf das angegebene Verzeichnis haben. Es darf kein Netzlaufwerk sein, sondern auf ein lokales Volume des SQL-Servers verweisen.
|-
|BackupRestoreLimitinMB
|Maximale Größe des Datenbankbackup in MB.
|-
|WebAuthenticateUrl
|Link zur Überprüfung der CoPlanner Lizenz.
|-
|LicenceID
|Wird zwingend für den Start des CoPlanner Servers benötigt. (ID der Lizenz bspw. 123)
|-
|ClientConnectionTimeOut
|Nach Ablauf wird die Client-Session am Server gelöscht. Angabe in Minuten. Default-Wert 1.440 Minuten.
|-
|EntitySecurity
|Durch diesen Eintrag kann man die Unternehmenssecurity deaktivieren, dass heißt der User kann nicht unternehmensübergreifend Werte erfassen. Ist der Eintrag nicht im Config File vorhanden, ist die Security per default aktiv.
|-
|AllowNonPowerUserDeleteDimElementsWithData
|Legt fest, ob nicht Poweruser Elemente mit Daten löschen dürfen.
|-
|MultiThreadCommand
|Legt fest, ob die Abarbeitung in mehreren Threads durchgeführt wird.
|-
|ProActiveCaching
|Bei CoPlanner Würfeln wird ein Tupel Caching aktiviert. Dies hat zur Folge, das mehrmals verwendete Zwischenergebnisse zwischengespeichert werden und somit eine Performanceverbesserung erreicht wird.
|-
|SkipImportHistory
|Ist dieser Eintrag auf true, werden Fehlermeldungen beim Datenimport nicht in die History-Tabelle geschrieben.
|-
|SecurityProxyLoad
|Ist dieser Eintrag auf true, wird die Security erst beim LogIn für den User aufbereitet.
|-
|CopSysIDStartOffset
|Die erste vom System vergebene CopSysID wird um diesen Offset erhöht. Werden mehrere Modell mit unterschiedlichen CopServices verwendet, werden so doppelte CopSysIDs vermieden.
|-
|DebugMode
|Ist dieser Eintrag auf true wird am Server detailierter gelogged.
|-
|StoredProcedureTimeout
|Optionale Angabe eines Timeouts in Sekunden ehe die Ausführung einer SQL Prozedur im CoPlanner abgebrochen wird. Per default ist diese auf 3600 Sekunden gesetzt.
|-
|ShowLostDBConnectionWarning
|Ist dieser Eintrag auf True wird am Client angezeigt wenn die Verbindung zur Datenbank verloren gegangen ist.
|-
|TransportUserName
|Relevant für das automatisierte Transportwesen. Bitte beachten Sie, dass der hier vergebene User immer Herstellerrechte hat, auch wenn er sich normal über den Client anmeldet. Es muss sich hier um einen vollqualifizierten Windows Domänenuser handeln.
|-
|PowerUserModeViaADOnly
|Definiert, ob man in den unten definierten AD Gruppen sein muss, um sich als Hersteller, Partner oder PowerUser anmelden zu können.
|-
|ADGroupPowerUser
|Definiert die AD Gruppe für den Zugriff als PowerUser.
|-
|ADGroupPartnerUser
|Definiert die AD Gruppe für den Zugriff als Partner.
|-
|ADGroupManufacturerUser
|Definiert die AD Gruppe für den Zugriff als Hersteller.
|-
|LoadAllEntityDimensionEntriesToClient
|Definiert, ob die Filterung der Elemente bei Mandantendimensionen erst am Client stattfindet oder schon am Server. False bedeutet, dass die Filterung am Server stattfindet.
|-
|FormulasUsePriorityQueue
|Wenn auf true werden die Formeln nach der im Modell vergebenen Priorität abgearbeitet. Sollte nur bei Projekten verwendet werden, die auch eine vergebene Priorität haben. Siehe: [[Technik:CoPlanner-Server#Exkurs_FormulasUsePriorityQueue|Exkurs FormulasUsePriorityQueue]]
|-
|DoVersionCheck
|Gibt an, ob bei Anmeldungen von den Clients geprüft werden soll, ob die Version und Hotfixnummer übereinstimmt.
|-
|UseNewDBSync
|Gibt an, ob der neue DB Sync verwendet wird. True heißt, dass der neue DB Sync aktiv ist.
|-
|DBSyncMaxThreads
|Gibt an, wie viele Threads zum Schreiben in die Datenbank verwendet werden, wenn der neue DB Sync aktiv ist. Wird kein Wert eingetragen, werden max. 2 Threads verwendet. Maximal wird der standardmäßig ermittelte Wert für die CPU (=Anzahl Cores – minus heuristischer Reduktion bei mehreren Cores) hergenommen, auch, wenn hier ein höherer Wert angegeben wäre. Ist hier ein niedrigerer Wert angegeben, wird der niedrigere Wert verwendet. Ist die Last beim Schreiben auf die Datenbank zu hoch, dann sollte dieser Wert reduziert werden.
|-
|DBCommandTimeout
|Datenbank-Kommando-Timeout für bestimmte Befehle. Dieses Timeout zieht z.B. bei der Datenbringung von Importen. Früher gab es hier ein hard-codiertes Timeout von 10 Minuten, wo der SQL Server die Daten für den Import bereitstellen muss. Nun kann man dieses Timeout hier setzen. 600 entspricht den 10 Minuten.
|-
|UseNewCaching
|Gibt an, ob das neue Caching aktiviert werden soll.
|-
|CacheSizeFaktor
|Nur Auswirkung bei UseNewCaching=true. Beim neuen Caching werden Daten, die in Masken angezeigt werden, in einem spaltenorientierten Cache abgelegt. Damit der Speicherverbrauch durch das neue Caching nicht zu groß wird, wird die Anzahl der Daten, die in spatenorientierten Caches abgelegt werden darf, begrenzt. Mit dem CacheSizeFactor wird diese Grenze grob in Relation zu den in den CoPlanner-Tabellen vorhandenen Daten festgelegt – ein Cache Faktor von 0,5 gibt an, dass der Cache in etwa halb so viele Daten halten darf wie in den CoPlanner-Tabellen vorhanden sind.
|-
|StartTabAdress
|Wenn diese Eigenschaft leer ist, wird wie bisher die Start.html als Startseite geladen. Man kann hier aber auch z.B. die Tiles als Startseite anzeigen lassen. Bsp.: @Session_WebAppUrl@/tiles/?menu=MeineStartseite&SessionID=@Session_ID@)
|-
|LogonMaximumPerTimeframe
|Maximale Anzahl von Loginversuchen pro Sekunden, welche bei LogonMaximumTimeframeInSeconds angegeben wurden. Wurde also z.B. LogonMaximumPerTimeframe auf 100 gesetzt und LogonMaximumTimeframeInSeconds auf 60, dann werden in 60 Sekunden 100 Loginversuche zugelassen. 0 steht für kein Limit.
|-
|LogonMaximumTimeframeInSeconds
| Anzahl von Sekunden in denen maximal so viele Logins, wie bei LogonMaximumPerTimeframe versucht werden können. Wurde also z.B. LogonMaximumPerTimeframe auf 100 gesetzt und LogonMaximumTimeframeInSeconds auf 60, dann werden in 60 Sekunden 100 Loginversuche zugelassen. 0 steht für kein Limit.
|-
|SupportColumnTable
| Derzeit eine Betavariante, die ohne Abstimmung nicht aktiviert werden sollte. Um die ColumnTable nutzen zu können müssen auch UseNewCaching und ForumulasUsePriorityQueue aktiviert sein.
|-
|AllowBatchProcessingViaMacro
| Wenn diese Option aktiviert wird, kann man Batchdateien, die im Serververzeichnis in dem Scripts-Ordner liegen, aus einem Makro aufrufen. Diese Option ist per Default deaktiviert und sollte dies aus security-technischen Gründen auch bleiben.
|-
|DaysToKeepSysLogSession
| Beim Serverstart werden Einträge der Sys_Log_Session Tabelle gelöscht. Mit diesem Parameter kann angegeben werden, wieviele Tage erhalten bleiben sollen.
|}

===SSASSettings===
Folgende Punkte müssen im Bereich SSASSettings definiert werden:

{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|Server
|Name des Servers, auf dem sich die OLAP-Datenbank befindet. Es muss der Name des Server bzw. die IP Adresse angegeben werden. Folgende Namen sind nicht zulässig: localhost, ., 127.0.0.1 und local.
|-
|DataBaseName
|Name der OLAP-Datenbank
|-
|XmlaLoadActive
|Ist dieser Eintrag auf true, werden Strukturdaten mittels XMLA geladen [[Image:arrow.jpg]] enormer Performancegewinn!
|-
|UseRealElementIDs
|Die echten OLAP-Keys werden verwendet unter der Voraussetzung, dass diese numerisch sind.
|-
|UseMultipleHierarchies
|Ist dieser Eintrag auf true, werden Alternativhierarchien von Olap Dimensionen geladen und können verwendet werden (ab SSAS 2005).
|-
|MultiSelectFilterActive
|Ist dieser Eintrag auf true, werden Dimensionen, die als Filter verwendet werden, mit Mehrfachauswahl (Multiselect) unterstützt. (Derzeit bis 9.3 werden keine MultiselectFilter für CoPlanner Dimensionen unterstüzt.)
|-
|LoadMeasureFormatAndType
|Ist dieser Eintrag auf true, werden Measureformat und Typ vom Olap Server pro Measure geladen. Bei false werden Measures immer als Text geladen und die Formatted Value verwendet (Achtung bei Culturevermischungen) (ab SSAS 2005).
|-
|ReplaceNullValues
|Ist dieser Eintrag auf true, werden Null Values vom Connector mit 0 ersetzt.
|-
|DimensionLoadMode
|Betrifft das Ladeverhalten von OLAP Dimensionen. Folgende Einträge sind zulässig: AsDimension (Defaultwert), AsDimHierarchy und AsDimAndHierarchy. Siehe: [[Technik:CoPlanner-Server#Exkurs_SSAS_Einstellungen|Exkurs SSAS Einstellungen]]
|-
|LoadDimensionsByAlias
|Diese Einstellung zieht wenn einem OLAP Cube eine Dimension mehrfach, mit unterschiedlichen Bezeichnungen, zugeordnet ist. Ist der Eintrag auf False gesetzt so wird die erste gefundene Dimension geladen, ist der Eintrag auf True gesetzt so werden alle Dimensionen geladen. Siehe: [[Technik:CoPlanner-Server#Exkurs_SSAS_Einstellungen|Exkurs SSAS Einstellungen]]
|}
{| {{Bausteindesign1}}
|-
| '''Wichtig'''  Werden die SSAS Einstellungen LoadDimensionByAlias bzw. DimensionLoadMode im Nachhinein geändert so müssen sämtliche Cubes die auf OLAP verweisen neu aufgebaut werden.
|}

===SSRSSettings===
Folgende Punkte müssen im Bereich SSRSSettings definiert werden:

{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|ReportServerUrl
|Das virtuelle Verzeichnis für den Berichtsserver.
|-
|ReportWebServiceUrl
|Der SOAP-Endpunkt für die Berichtsverwaltung.
|-
|RootFolder
|Das Basisverzeichnis für die Berichte am Berichtsserver.
|-
|UserFolder
|Das Verzeichnis für Berichte, die im [[Framework:BI_Center|BI-Center]] mit dem Berichtsassistenten erstellt werden. Fehlt die Angabe, wird das Basisverzeichnis verwendet.
|-
|TempFolder
|Das Verzeichnis für Berichte, die im [[Enterprise_Edition:Ad-hoc_Analyse#CoPlanner_Analyzer|Analyzer]] mit dem [[Berichtsassistent|Berichtsassistenten]] erstellt werden. Fehlt die Angabe, wird das Basisverzeichnis verwendet.
|-
|SharedDataSourceReference
|Pfad und Name zu einer bereits vorhandenen Datenquelle am Berichtsserver, die vom Berichtsassistenten beim Erstellen eines neuen Berichtes verwendet wird. Fehlt diese Angabe erzeugt der Berichtsassistent eine im Bericht eingebettete Datenquelle. Bei Berichten mit eingebetteten Datenquellen kann vom Reportbuilder keine Vorschau angezeigt werden.
|-
|Parameters
|Derzeit nicht in Verwendung.
|}

'''Folgende Punkte müssen im Bereich DBCon definiert werden:'''

{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|Stage
|
{| class="wikitable" width={{{breite|100%}}}
|-
|''Server''
|Name des Servers, auf dem sich die Datenbank befindet
|-
|''Initial Catalog''
|Name der Datenbank
|-
|''User id''
| Name des Benutzers, mit dem sich der CoPlanner-Server am SQL-Server anmeldet (standardmäßig sollte bereits die ID „sa“ existieren). Alternativ kann bzw. muss ein User mit entsprechenden Rechten am SQL-Server angelegt werden.
|-
|''Password''
|Passwort des Benutzers
|-
|''Pooling''
|Damit Restore Database (fix integriert im Entwicklermenü) funktioniert, muss im Connectionstring Pooling = false vorhanden sein!
|}
|}

'''Weitere Variablen:''' 
Variablen können zum Beispiel bei Importen benutzt werden. Importobjekte benötigen einen Connectionstring, um zB. eine Verbindung zu einer Vorsystemdatenbank aufbauen zu können. Um nun mit einem Eintrag mehrere Objekte gleichzeitig ändern zu können wird empfohlen, solche Connectionstrings als Variablen zu definieren, um Änderungen schneller vollziehen zu können.
<add key="Variablenname" value="Wert bzw. Eintrag, den die Variable haben soll"></add>

===SupportConfig===

{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|SupportMailAddress
|Wird für Aufrufe des Supports per Mail verwendet.
|-
|SupportFormAddress
|Formular, welches bei Aufruf des Support aufgerufen wird.
|}
===WebConfig===
Folgende Punkte müssen im Bereich WebConfig definiert werden:

{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|WebAppUrl
|Zwingend erforderlich. Über diese URL erfolgt die komplette Kommunikation mit den Clients.

Bei Verwendung müssen die Schritte, welche unter [[Technik:CoPlanner-Server#Einrichtung des CoPlanner-Servers mit HTTPS|Einrichtung des CoPlanner-Servers mit HTTPS]] angeführt sind, ausgeführt werden.

Es können mehrere URL durch | getrennt angegeben werden (z.B. https://+:4443/|http://+:8080/). Die erste angegebene URL ist jene, die für die Sessionvariable @Session_WebAppUrl@ verwendet wird. Mit den anderen kann man ebenfalls auf den CoPlanner zugreifen. Der Windowsclient und die AddIns sollten über die erste URL zugreifen.
|-
|ReportServerUrl
|URL über die mit dem Repotserver kommuniziert werden kann. Nur notwendig, wenn das Webreporting im Einsatz ist.
|-
|LogonLanguages
|Definiert in welchen Sprachen man sich am Webclient anmelden kann.
|-
|LogonWithCoPlannerSecurity
|Definiert, ob man sich im Webclient mit CoPlanner Security anmelden kann. Bei false steht die Option nicht zur Verfügung.
|-
|LogonWithSSPI
|Definiert, ob man sich im Webclient mit Single Sign-on anmelden kann. Bei false steht die Option nicht zur Verfügung.
|-
|CorsAllowedOrigins
|Wird von einem anderen Host auf die API zugegriffen, muss der Host hier definiert werden. z.B. Aufruf erfolgt über <nowiki>https://servername:5000/irgendeinaufruf</nowiki>, dann muss hier <nowiki>https://servername:5000</nowiki> vergeben werden. Mit <nowiki>|</nowiki> getrennt können mehrere angegeben werden.
|-
|EnableSwagger
|Definiert, ob man auf den Swagger zugreifen kann. Sofern das am System nicht benötigt wird, sollte die Option auf false sein.
|-
|ApiClientForPowerUserOnly
|Muss false sein, wenn man den Windowsclient, Reportserver oder ein Addin auch ohne den PowerUser-Modus verwenden möchte. Ist die Option true, kann man sich nur mehr als PowerUser, Partner oder Hersteller anmelden, außer im Webclient.
|-
|EnableExperimentalEndpoints
|Muss true sein, wenn Hilfeseiten, CSV-Upload, Cockpits oder etwas anderes aus dem Prototype aufgerufen wird. Sofern diese Apps nicht verwendet werden sollte man diese Option auf false setzen.
|-
|EnableMssEndpoints
|Aktiviert die Endpunkte, die für MSS Masken benötigt werden. Sofern diese Masken nicht im Einsatz sind sollte diese Option auf false sein.
|-
|EnableAuthWithSessionId
|Wird benötigt für die Übergabe der Session-ID im Windowsclient für MSS-Masken und die Prototype Dinge. Sofern diese nicht verwendet werden sollte diese Option auf false sein.
|-
|EnableHttpsRedirection
|Wenn die Option auf true ist, werden HTTP-Verbindungen auf den HTTPS-Port weitergeleitet. Gibt es in der WebAppUrl nur eine URL mit HTTPS, so wird automatisch dieser Port herangezogen. Gibt es mehrere HTTPS-URLs, so muss der Port, auf den umgeleitet werden soll bei HttpsRedirectionPort eingetragen werden.
|-
|HttpsRedirectionPort
|Hier kann der HTTPS-Port angegeben werden, auf welchen die HTTP-Verbindungen weitergeleitet werden.
|-
|EnableHSTS
|Mit dieser Option kann HTTP Strict Transport Security (HSTS) aktiviert werden.
|-
|StartUrl
|Mit dieser Option gibt es eine Weiterleitung, wenn man den Pfad der WebAppUrl direkt aufruft. Dieser Pfad sollte alles hinter dem Port beinhalten. z.B. /coplanner/tiles/?menu=Startmenue. Wird https://meinservername:4443/coplanner aufgerufen, gibt es hier eine automatische Weiterleitung auf https://meinservername:4443/coplanner/tiles/?menu=Startmenue.
|-
|EnableResponseCompression
|Möglichkeit zum Deaktivieren der ResponseCompression. Komprimierung und https kann zu Security-Problemen führen, weshalb es hier die Möglichkeit gibt, diese auch bei Bedarf zu deaktivieren.
|}

===OlapServiceSettings===
{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|OlapServiceUrl
|Es gibt die Möglichkeit künftig die Anbindung an den CoPlanner über ein eigenes [[Technik:OlapService|OLAP Service]] laufen zu lassen und nicht mehr direkt integriert. Will man das Service verwenden, muss man dieses konfigurieren, hier die URL des Service angegeben und den Server und den Databasename aus den [[Technik:CoPlanner-Server#SSASSettings|SSASSettings]] rausnehmen.
|}

===Exkurs SSAS Einstellungen===
Der CoPlanner-Server bietet mehrere Möglichkeiten SSAS-Dimensionen zu laden. Im Folgenden werden die zulässigen Einstellungen aufgelistet. 

{| class="wikitable" width={{{breite|100%}}}
|-
|DimensionLoadMode
|LoadDimensionByAlias
|Einstellung
|Ergebnis
|-
|AsDimension
|False
|[[Image:T_SSAS_AsDimension.jpg]]
|[[Image:T_SSAS_AsDimension01.jpg|thumb|center]]
|-
|AsDimension
|True
|[[Image:T_SSAS_AsDimensionTrue.jpg]]
|[[Image:T_SSAS_AsDimensionTrue01.jpg|thumb|center]]
|-
|AsDimHierarchy
|True
|[[Image:T_SSAS_AsDimHierarchy.jpg]]
|[[Image:T_SSAS_AsDimHierarchy01.jpg|thumb|center]]
|-
|AsDimAndHierarchy
|True
|[[Image:T_SSAS_AsDimAndHierarchy.jpg]]
|[[Image:T_SSAS_AsDimAndHierarchy01.jpg|thumb|center]]
|}

{| {{Bausteindesign1}}
| '''Wichtig'''   Per Default gelten folgende Einstellungen: DimensionLoadMode=AsDimHierarchy bzw. LoadDimensionByAlias=True.
|}

{| {{Bausteindesign1}}
|-
| '''Wichtig'''  Werden die SSAS Einstellungen LoadDimensionByAlias bzw. DimensionLoadMode im Nachhinein geändert so müssen sämtliche Cubes die auf OLAP verweisen neu aufgebaut werden.
|}

Nachfolgend werden die zulässigen OLAP Einstellungen näher beschrieben
{| class="wikitable" width={{{breite|100%}}}
|-
|width="200pt" |Eintrag
|Beschreibung
|-
|XmlaLoadActive
|
* Defaultwert = True, dieser Wert wird vom CoPlanner gesetzt, wenn die Einstellung nicht im SvrConfig getroffen wurde
* diese Einstellung gibt an mit welcher Methode die OLAP Dimensionselemente geladen werden:
- False: die DimensionsMembers werden mittels Level.GetMembers() geladen
- True: die DimensionsMembers werden aus SchemaDataSet geholt. (Die ADOMD Methode GetSchemaDataSet(…) wird verwendet.)
|}

===Exkurs FormulasUsePriorityQueue===
Im Formelwerk gibt es die Möglichkeit, eine Execution Order für Formeln zu definieren. Damit diese angewendet wird muss der Parameter „FormulasUsePriorityQueue“ im svrconfig.xml auf true gesetzt sein.

Mit dieser Option der Formelabarbeitung werden Formeln nicht wie bisher nach der Reihenfolge, in der die Formeln durch die Änderungen der Tabelle getriggert wurden, abgearbeitet, sondern nach Priorität.

Anhand eines einfachen Beispiels werden altes und neues Verhalten verglichen: wenn sich in der Gewinn- und Verlustrechnung die Umsätze ändern, dann ändert sich der Gewinnvortrag und auch die Bilanz muss neu gerechnet werden.

Ohne Anpassung der Priorität wird jetzt mit der Änderung eines Umsatzes im Jänner der Gewinn-/Verlustvortrag für den Februar angepasst und die Bilanz neu gerechnet, durch die Änderung des Gewinn-/Verlustvortrags im Februar ändert sich auch der Gewinn-/Verlustvortrag im März, und muss somit neu gerechnet werden. Beim Schreiben dieser Änderung wird auch wieder die Berechnung der Bilanz ausgelöst.

Vereinfacht gesagt, aus einer Umsatzänderung resultiert auch eine Gewinn-/Verluständerung, die monatsweise weitergeschrieben werden muss und bei jedem Weiterschreiben wird auch die Bilanz neu gerechnet.

Sinnvoll wäre es aber, zuerst die GuV fertig zu rechnen (d.h. den Gewinnvortrag bis Ende Jahr weiterzuschreiben), und erst dann die Daten einmal in die Bilanz zu übernehmen.

Dies kann über die PriorityQueue erreicht werden: hat die Formel für den Gewinn-/Verlustvortrag z.B. eine Priorität von 1 und die Formel, die die Bilanz aktualisiert, eine Priorität von 2, so wird bei jedem Weiterschreiben eine weitere Berechnung des Gewinn-/Verlustvortrags und eine Berechnung der Bilanz in die Berechnungsqueue gestellt.

In der PriorityQueue wird die Formel mit Priorität 1 vorgereiht, wodurch das Berechnen des Gewinn-/Verlustvortrags vor der Berechnung der Bilanz abgeschlossen wird. Zusätzlich erkennt das System, das es bereits eine Anforderung, die Bilanz neu zu rechnen, in der Queue hat und stellt diese Anforderung daher nicht mehr zusätzlich in die Queue.

====Festlegen der Reihenfolge====
Die Priorität für die Abarbeitung einer Formel wird anhand der Tabelle, deren Änderung die Berechnung der Formel triggert, festgelegt. Somit können Formeln mit unterschiedlicher Priorität ausgeführt werden (z.B. bei den variablen Kosten: wird die Neuberechnung der Variablen Kosten durch eine Änderung in der variablen Kosten-Planung ausgelöst, so will in der Maske auf das Ergebnis warten, wird die Berechnung hingegen durch eine Änderung in der Umsatzplanung getriggert, so soll diese Berechnung im Hintergrund passieren. Das lässt sich realisieren, indem man den beiden Tabellen „Umsatzerlöse“ und „Variable Kosten unterschiedliche Prioritäten im Formeldesigner zuweist)

Wird keine Reihenfolge vergeben, oder kann keine Reihenfolge ermittelt werden (z.B. Formel wird durch ein Makro aufgerufen), so wird die Reihenfolge auf 1 gesetzt.

====Vermeidung Queue Starvation====
Wenn Gefahr droht, dass eine Berechnungsanforderung „ewig“ in der Queue warten muss, wird dies vom System erkannt, und neue Berechnungsanforderungen werden ab dem Zeitpunkt des Erkennens hinter die bereits in der Queue befindlichen Berechnungsanforderungen gelegt – unabhängig von der vergebenen Priorität.

====Masken: Warten auf Berechnungen der ersten Ebene====
In Eingabemasken kann durch das Setzen des Flags „WaitForCalc“ festegelegt werden, ob auf Berechnungen gewartet wird. Im der bestehenden Implementierung zu Festlegung der Reihenfolge wird dabei auf alle Berechnungen gewartet, die direkt durch das Schreiben in eine Tabelle ausgelöst wurden (dies wird durch Kalkulationstiefe 1 gekennzeichnet). Dabei wird auf alle Formeln der Kalkulationstiefe 1 gewartet, unabhängig davon, ob die Berechnung durch den Benutzer selbst oder durch die Eingabe eines anderen Benutzers ausgelöst wurde.

Mit der PriorityQueue kann dies feiner gesteuert werden, es wird auf die Abarbeitung aller direkt durch die Eingabe ausgelösten Formeln, deren Reihenfolge < 0 ist gewartet (ebenfalls benutzerübergreifend). Um auf eine Formel zu warten, die auf einer anderen Tabelle als der Eingabetabelle rechnet, muss man diese Formel nur von der Eingabetabelle aus triggern und mit einer passenden Priorität (< 0) versehen.
Dies kann z.B. wie folgt genutzt werden: in einer Umsatztabelle wird über eine Update-Formel der Umsatzsteuersatz zum aktuellen Datensatz dazugeholt und die USt gerechnet, und über eine weitere Formel der Umsatz für eine GuV-Berechnung weitergeschrieben. In der Maske wird jetzt auf die Update-Formel gewartet, da USt und USt-Satz dem Benutzer angezeigt werden, auf das Weiterschreiben in Richtung GuV wird jedoch nicht gewartet.

====Sonderstellung der SAME-Formel====
Wird die Berechnung von SAME-Formeln durch eine Dateneingabe ausgelöst, so werden diese Formel direkt beim Speichern des Datensatzes synchron gerechnet (und nicht in die Liste eingefügt). Die Berechnung erfolgt somit nicht über die Liste mit durchzuführenden Berechnungen.

====Anmerkungen====
Es wird generell davon abgeraten, die PriorityQueue zu verwenden, ohne das Verhalten des Rechenwerks bei bestehenden Modellen ausführlich zu testen.
Die Änderung von Duplikaten musste im Rahmen der Implementierung der neuen Funktionsweise ebenfalls angepasst werden; dies kann in Ausnahmefällen dazu führen, dass die Berechnungs-reihenfolge in bestehenden Modellen anders ist als bisher.

===Konfigurationstool===

Zum Bearbeiten der CoPlanner Server Einstellungen steht im Server-Verzeichnis ein Konfigurationstool "SvrConfig.exe" zur Verfügung.

==NLog.Server.config bzw. NLog.Service.config==
Prinzipiell kann hier mehr angepasst werden, aber die grundlegenden Eigenschaften:

:* logDirectory: Verzeichnis ohne den Dateinamen, wo hingeloggt werden soll
:* fileName: Hier kann man den Dateinamen anpassen oder wenn man möchte auch den gesamten Pfad
:* archiveAboveSize: gibt an, ab welcher Dateigröße eine neue Datei geschrieben wird. Der Standard von 10000000 entspricht 10 MB.

== appsettings.json ==
Bei Verwendung von https wird in dieser Datei angegeben, woher das Zertifikat bezogen werden soll.

Das Zertifikat kann entweder als Datei abgespeichert oder aus dem Zertifikatsspeicher bezogen werden.

==CoPlanner-Server als Dienst==
Der CoPlanner-Server kann auch als Dienst installiert werden. Wichtig hierbei ist, dass Sie Administratorrechte besitzen, um die Installation durchführen zu können.
Sie starten den Dienst mit der Schaltfläche "Install service", der unter CopSettings zu finden ist. Der Service wird mit dem Namen gestartet, der unter ServiceName angegeben ist.
Um den CoPlanner-Server als Dienst zu deinstallieren wählen Sie "Uninstall service".

===Mehrere CoPlanner Dienste auf einem Rechner installieren===

Auf einem Rechner können auch mehrere CoPlanner Services installiert werden. Dazu ist lediglich der ServiceName unter den CopSettings zu ändern und der Dienst erneut zu installieren.
Unter den Windows Diensten sind dann 2 voneinander unabhängige Dienste vorhanden.

[[Image:T_Codesnip4.jpg]]

==CoPlanner-Server als Applikation==

===Starten des Servers als Applikation===

Durch das Kopieren des Serververzeichnisses auf den Rechner ist die Installation eigentlich beendet. Sie müssen nur noch die Datei CopServer.exe starten. Ein Konsolenfenster erscheint. Hier können Sie mit verfolgen, welche Operationen der CoPlanner-Server gerade ausführt.

==Einrichtung des CoPlanner-Servers mit HTTPS==
Um eine sichere Kommunikation des Webclients mit dem CoPlanner-Server gewährleisten zu können, sollte unbedingt HTTPS eingesetzt werden.

Dies bietet insbesondere zwei Vorteile:
:* Verschlüsselung (es kann nicht mitgelesen werden)
:* Signaturprüfung (es ist sichergestellt, dass auch mit dem richtigen Server kommuniziert wird)

Um HTTPS nutzen zu können, wird ein Zertifikat benötigt. Dieses kann entweder selbst erstellt oder von diversen Anbietern bezogen werden. Beide Optionen haben Vor- und Nachteile.
Das Zertifikat muss ein "[https://de.wikipedia.org/wiki/X.509 X.509 Certificate]" sein (liegt meist als PFX-Datei vor) und für die Domain gültig sein, auf der der CoPlanner-Server laufen soll.

Beispiel:
Soll der Server unter <nowiki>https://sample.copserver.mycompany:8080/coplanner</nowiki> laufen, muss das Zertifikat für sample.copserver.mycompany gültig sein.

===Selbst erstellte Zertifikate ("self signed")===
Vorteile: Frei konfigurierbar, jederzeit verfügbar, unabhängig

Nachteile: Von gängigen Webbrowsern standardmäßig nicht akzeptiert

Soll ein selbst erstelltes Zertifikat verwendet werden, muss es auf den PCs der Endanwender für deren Browser als vertrauenswürdig markiert werden. Die genaue Einstellung unterscheidet sich je nach Browser und Betriebssystem.
Grundsätzlich beachten die meisten Webbrowser die Zertifikatseinstellungen des Betriebssystems (zum aktuellen Zeitpunkt mindestens Chrome, Edge und Internet Explorer). Firefox muss allerdings separat konfiguriert werden (siehe [https://support.mozilla.org/en-US/kb/setting-certificate-authorities-firefox diese Information] von Mozilla).

Es ist möglich, [https://docs.microsoft.com/en-us/windows-server/identity/ad-fs/deployment/distribute-certificates-to-client-computers-by-using-group-policy Zertifikate mittels Gruppenrichtlinie in Windows-Domänen zu verteilen].

===Zertifikat von einem Anbieter===
Vorteile: Von gängigen Webbrowsern ohne Konfiguration akzeptiert

Nachteile: Teilweise kostenpflichtig, unterschiedlicher Service je Anbieter

Anbieter für SSL-Zertifikate gibt es viele, die Preise ändern sich laufend.

Beispiele für Anbieter:

Let’s Encrypt: https://letsencrypt.org/de/

Kostenlos. Muss alle drei Monate erneuert werden.

Thawte: https://www.thawte.de/

Kostenpflichtig.

Der Prozess unterscheidet sich je nach Anbieter. Im Endeffekt sollte das Zertifikat als Datei vorliegen, die auf dem Server installiert werden kann.

===Einrichtung von HTTPS unter Windows Server===
Als Hosting-Komponente für den CoPlanner-Server wird Kestrel, ein plattformunabhängiger Webserver für ASP.NET Core verwendet. Diese kümmert sich auch um HTTPS.

Das Zertifikat muss für die Installation entweder als Datei vorliegen, oder bereits am Server installiert sein. Falls das Zertifikat bereits installiert ist, müssen Store, Location und Subject bekannt sein und der Serviceuser muss das Leserecht auf den Private-Key des Zertifikats besitzt.

Zusätzlich muss bekannt sein, für welchen Aufruf das Zertifikat gültig ist. Dieser muss der Adresse entsprechen, mit dem die Nutzer auf den CopServer zugreifen werden. Die WebAppUrl sollte ebenfalls auf genau diese Adresse gesetzt werden (es sollte kein "+" mehr darin verwendet werden).

Beispiele:

Unsicher: <nowiki>https://+:8080/coplanner</nowiki>

In Ordnung: <nowiki>https://*.copserver.mycompany:8080/coplanner</nowiki>

In Ordnung: <nowiki>https://sample.copserver.mycompany:8080/coplanner</nowiki>

===Anpassung SPN (Service Principal Name) für Single Sign-On am Server===
Entspricht der vollständige Computername nicht der URL, welche aufgerufen wird muss ein zusätzlicher Service Principal Name hinzugefügt werden, wenn man sich auch Server direkt auch mit Single Sign-On anmelden will.

z.B. vollständiger Computername ist myserver.test.coplanner.com und die URL über die zugegriffen wird ist myserver.coplanner.com

Ausgabe aller Service Principal Names (SPNs) für myserver:

setspn -L myserver

Mit setspn -S "HTTP/myserver.coplanner.com" MeinServiceBenutzername
kann der hinzufügen. Um dies zu machen braucht man hohe Rechte.

Nähere Infos zu setspn finden Sie unter https://social.technet.microsoft.com/wiki/contents/articles/717.service-principal-names-spn-setspn-syntax.aspx.

Firefox erlaubt standardmäßig keine Negotiate-Uris. Damit Firefox mit Negotiate funktioniert, muss mit "about:config" -> "network.negotiate-auth.trusted-uris" die Url freigeben werden.

Für den Zugriff aller Clients, die eine ClientConfig.xml besitzen (z.B. Windowsclient, MakroExecutor, AddIns,...), mit Single Sign-On direkt am Server muss in der ClientConfig.xml der Eintrag ServicePrincipalNameForServerUrl auf HOST/myserver gesetzt werden.

===Anpassung für Single Sign-On im Firefox===
Wenn beim Single Sing-On im Firefox noch eine Box kommt, wo man den Namen und Passwort nochmal eingeben muss, dann sollte man folgende Schritte ausführen oder diese per GPO ausrollen:

:* Firefox öffnen und in Adressleiste about:config eingeben und mit Enter bestätigen
:* Suchen nach dem Eintrag network.negotiate-auth.trusted-uris
:* Hier dann den Namen angeben, mit dem die Seite aufgerufen wird. z.B. servername, wenn der Aufruf über <nowiki>http://servername:4488/...</nowiki> erfolgt oder servername.coplanner.com, wenn der Aufruf über <nowiki>http://servername.coplanner.com:4488/...</nowiki> erfolgt. Sollte es für beide Varianten funktionieren, kann man bei dem Eintrag mehrere Namen mit , getrennt angeben.

===Anpassung für Single Sign-On in Chrome und Edge===
Wenn beim Single Sing-On im Chrome oder Edge noch eine Box kommt, wo man den Namen und Passwort nochmal eingeben muss, dann sollte man folgende Schritte ausführen oder diese per GPO ausrollen:

:* Öffnen Sie die Systemsteuerung > Internetoptionen.
:* Wählen der Registerkarte Sicherheit
:* Wählen Sie Lokales Intranet aus und klicken Sie auf Sites.
:* Klicken Sie auf Erweitert
:* Hier dann den Namen angeben, mit dem die Seite aufgerufen wird. Beispiel: https://servername.coplanner.com
:* Bestätigen mit Hinzufügen__NOEDITSECTION__

[[Category:Technik|Server]]
[[en:Technics:CoPlanner-Server]]

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]]

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]]

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]]

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]]

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:Matrixmaske

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: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>

Objektverwaltung: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]]

Objektverwaltung: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: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.