Technik:CoPlanner Win-Client

Sobald Sie das Clientverzeichnis auf dem Rechner, welcher als Win-Client fungieren soll, kopiert haben, ist der Client installiert. Sie müssen nur noch die Datei ClientConfig.xml auf Ihr System anpassen. Die Datei findet sich im Ausführungsverzeichnis des Clients.

ClientConfig.xml

Datei:T Codesnip6.jpg

Folgende Punkte müssen angepasst werden:

Server

• Rechnername, auf dem der CoPlanner-Server installiert wurde.

Port

• Portnummer des CoPlanner-Servers. Hier tragen Sie dieselbe Portnummer ein, die auch im SvrConfig.xml eingetragen wurde.

MaxRows

• Dies ist die Anzahl der Datensätze, die maximal vom Server empfangen werden kann. Diese sollte in Relation zur Leistung des Client-Rechners stehen. Wird beim Laden von Datensätzen in einer Eingabemaske die hier festgelegte maxi-male Datensatzanzahl überschritten, wird der Ladevorgang unterbrochen und eine Meldung ausgegeben, die auffordert, die Datenmenge mittels Filtern entsprechend einzuschränken.

MaxCells (ab 20080807)

• Gibt an, wie viele Zellen (Produkte Achsendimensionselemente) maximal vom CoPlanner Server via Matrix Builder geladen werden. Ist dieser Tag nicht vorhanden, oder wird 0 eingetragen, erfolgt keine Einschränkung.

TcpFormatter

• Legt den Übertragungsmodus zwischen Client und Server fest. Möglich ist die Aus-wahl zwischen „Bin“ für binäre Übertragung und „Text“ für Textübertragung. Der ge-wählte Modus muss sowohl am Server (SvrConfig.xml) als auch am Client eingestellt werden und übereinstimmen.

Bereich Languages Available

• Jene Sprachen, die hier angegeben werden, sind, wenn sie vom CoPlanner Server unterstützt werden, als Logon Sprache verfügbar. Die Sprachbezeichnung ist in Lan-dessprache und Landeszeichensatz einzugeben. Eine Liste der verfügbaren Spra¬chen finden Sie im PowerUser-Handbuch.

coplanner.exe.config Datei

Diese Datei beinhaltet allgemeine User Einstellungen. Die Datei findet sich im Ausführungs-verzeichnis des Clients.

• <add key="logonProperties.showPlan" value="True"/>

Sperrt bei „False“ die Pläne beim Logon

• <add key="logonProperties.showUnternehmen" value="True"/>

Sperrt bei „False“ die Unternhemen beim Logon

• <add key="logonProperties.showWaehrung" value="True"/>

Sperrt bei „False“ die Waehrung beim Logon

• <add key="logonProperties.showLanguages" value="True"/>

Sperrt bei „False“ die Sprachauswahl beim Logon

• <add key="layoutProperties.additionalHeightMeasureLine" value="10"/>

Zusätzl. Höhe der Measurezeile (Agg und Zeilenmaske (inkl. Copspy++)) Pixel, welche zusätzlich zur Zeilenweite der aktuellen Font hinzugefügt werden

• <add key="layoutProperties.additionalSpaceBeneathFilter" value="6"/>

Abstand Filterbereich (AggMaske und Zeilenmaske)

• <add key="layoutProperties.additionalHeightHorizDimensionline" value="18"/>

Zusätzliche Höhe der horizontalen Dimensionszeile – Pixel, welche zusätzlich zur Zeilenweite der aktuellen Font hinzugefügt werden

• <add key="layoutProperties.MeasureLineTextColor" value="5B5B9A"/>

Farbe für Text der Measurezeile

• <add key="layoutProperties.MeasureLineHighLightTextColor" value="ffffff"/>

Farbe für Markierung der Measurezeile und die gewählte Dimension

• <add key="layoutProperties.MeasureLineHighLightBackColor" value="9CB1D8"/>

Farbe für Markierung der Measurezeile und die gewählte Dimension

• <add key="layoutProperties.MeasureLineBackColor" value="DFE4F2"/>

Farbe für Hintergrund der Measurezeile

• <add key="layoutProperties.HighlightColorBack" value="C9D2EA"/>

Markierungsfarbe Hintergrund

• <add key="layoutProperties.HighlightColorFore" value="000000"/>

Markierungsfarbe Vordergrund

• <add key="layoutProperties.SwitchOffMoreLineMarkingInHorizDims" value="False"/>

NYI Abschalten der Markierung in der horizontalen Dimension

• <add key="layoutProperties.Filtercolor" value="C9D2EA"/>

Farbe der Filter

• <add key="layoutProperties.FilterMainColor" value="F0EEE1"/>

HauptFarbe der Filter

• <add key="layoutProperties.SpaceBewtweenFilter" value="4"/>

Farbe der Filter

• <add key="layoutProperties.PermitIsolationInAggMask" value="True"/>

Abschalten der Isolierfunktion mit Linksklick in Aggmaske

• <add key="layoutProperties.PermitHideInAggMask" value="True"/>

Abschalten der Hide-Funktion mit Rechtsklick in Aggmaske

• <add key="logonProperties.showWaitWindow" value="False"/>

Den "bitte Warten" Dialog beim Clientstart anzeigen

• <add key="CommandTimeOut" value="0"/>

TimeOut für Datenanforderung bei SerialObjects (MB/Excel) in Sekunden. 0 ist default und bedeutet kein TimeOut.

• <add key="MatrixBuilder.RefreshDataAfterFilterChangeSelectable" value="true"/>

<add key="MatrixBuilder.RefreshDataAfterFilterChangeSelection" value="true"/>

Berechtigungen

Bei einem erfolgreichen Logon zum CoPlanner Server wird eine XML-Datei im Client-Ver-zeichnis angelegt, welche die Einstellungen beinhaltet. Beim nächsten Logon werden diese Settings dann vorgeschlagen. Damit dies möglich ist, benötigt der Benutzer im Client-Ver-zeichnis Schreibrechte. Das Verzeichnis „pdf“ dient als Zwischenspeicher für das CoPlanner Reporting. In diesem wird der Bericht temporär gespeichert. Aus diesem Grund benötigt der Anwender, um das CoPlanner Reporting verwenden zu können in diesem Verzeichnis Schreibrechte.

Installation des Windows-Clients durch ClickOnce

Benötigte Dateien/Ordner

Voraussetzungen:

• Das .Net Framework 2.0 muss am Clientrechner installiert werden. Das bedeutet, dass der Rechner, auf dem der CoPlanner Client via

ClickOnce installiert werden soll, das .Net Framework benötigt!

• Für die Installation des .Net Framework sind lokale Administratorrechte erforderlich!!!

Ein Deployment Paket besteht aus den Dateien:

• Setup.exe
• copstart_Versionsnummer.application
• coplanner.htm
• Copstart.application

Folgende Verzeichnisse enthält ein Deployment Paket:

• coplanner_Versionsnummer
• Client

Bis auf das Verzeichnis Client sind alle Dateien bzw. Verzeichnisse Microsoft Standardver-zeichnisse. Das Client-Verzeichnis ist CoPlanner spezifisch. Dieses enthält die Kundenspe-zifischen Dateien, welche nach der Installation des Clients, beim Start gedownloadet werden.

Hinweis  Das Verzeichnis Client MUSS im Deployment Paket enthalten sein.

Folgende Dateien müssen im Verzeichnis Client vorhanden sein:

• Achtung - Version.txt darf am Server nicht mehr manuell gesetzt werden, sondern durch das Tool CreateVersionAndChecksum.exe, welches einfach im Dateisystem des Webordners doppelt geklickt werden muss.

• Version.txt Dieses enthält eine Versionsnummer, die bei jedem Start des Clients überprüft wird. Beim ersten Start des Clients ist diese Datei noch nicht vorhanden. Das bedeutet, beim ersten Start werden die Dateien immer gedownloadet. Wird da-nach eine Änderung vollzogen (ClientConfig.xml Portänderung), und diese soll auf alle Clients verteilt werden, so muss diese Nummer ERHÖHT werden. Dadurch werden die Dateien beim nächsten Client-Start automatisch updatet.

Die Dateien im Verzeichnis Client müssen dieselbe Ordnerstruktur aufweisen, wie im Win-dows-Client. Möchte man beispielsweise eine Kundenspezifische start.html Datei verteilen, so muss sich diese im Verzeichnis ../Client/html/“ befinden.

Probleme bei der Installation

Erscheint gleich nach dem Start des ClickOnce Setups eine Fehlermeldung mit folgendem Inhalt (Auszug bei Ansicht der Fehlerdetails),

[[Image:T_Fehlerdetails.jpg]

kann dies zwei bekannte Ursachen haben:

• Jener Benutzer, welcher die ClickOnce Installation durchführen möchte besitzt nicht das Recht, in jenem Verzeichnis, in dem das Client-Setup enthalten ist, die benötig¬ten Dateien zu lesen. Wird das Deployment durch einen http-Server bereitgestellt, ist darauf zu achten, dass bei der Aktivierung des anonymen Zugriffs der IIS-Benutzer (per default ISUER_[Servername]) das Leserecht auf den Verzeichnissen besitzt. Ist die integrierte NT-Autentifizierung aktiv und kein anonymer Zugriff erlaubt, muss der Benutzer, welcher die ClickOnce Installation startet/ausführt, entsprechende Leser-echte auf die Verzeichnisse besitzen.

• Es wurde zuvor schon eine ClickOnce-Installation durchgeführt, jedoch von einem ande¬ren Verzeichnis/Server. Obwohl die Vorgängerversion richtig durch Deinstalla¬tion über die Softwareübersicht des Systems erfolgte, bleiben Verzeichnisse im NT-Benutzerverzeichnis bestehen. Durch diese wird die Installation fehlerbedingt abge-brochen.

Dieses Problem kann wie folgt gelöst werden: Im Verzeichnis „C:\Dokumente und Einstellungen\[NT-Benutzername] \Lokale Ein-stellungen\Apps\2.0\“ befinden sich jene Dateien, die via ClickOnce installiert wurden. Um dieses Verzeichnis finden zu können, muss im Windows Explorer die Option „Versteckte Verzeichnisse anzeigen“ aktiviert werden („Extras“ [[Image:arrow.jpg] „Ordneroption“). In diesem Ordner sind Unterverzeichnisse vorhanden, welche wie bereits erwähnt die ClickOnce Programmkomponenten enthalten. Es müssen daher alle Unterordner des Ordners „C:\Dokumente und Einstellungen\[NT-Benutzername] \Lokale Einstellun-gen\Apps\2.0\“ gelöscht werden. Danach kann die ClickOnce-Installation vom neuen Deploy Server/Verzeichnis starten.

Problem mit copstart.exe.manifest

Beim Aufruf der Installation kann unter Umständen eine 404 – „File not found“ - Fehlermel-dung kommen.

[[Image:T_File_not_found.jpg]

Es ist folgender MIME-Typ zu definieren (Details siehe Einstellungen IIS):

Technik, MIME - Typ

Einstellungen IIS

Wird ein Deployment via HTTP bereitgestellt, so ist hierfür ein IIS (Internet Information Server) notwendig. Das Deploymentverzeichnis muss in Inetpub\wwwroot kopiert werden und als „Standard-website“ erstellt werden.

Technik, Einstellungen IIS

Einstellungen innerhalb der WebAnwendung

Folgende Einstellungen sind notwendig, um einem Client den Zugriff zu ermöglichen:

Anmerkung zum ScreenShot rechts unten: .config muss aus der Liste entfernt werden.

MIME Types im IIS

Falls beim Deployment im IIS nicht alle Dateien auf den Client Rechner kopiert werden, müssen für die entsprechenden Dateien MIME Types definiert werden. Für die Definition der MIME Types gehen Sie bitte wie folgt vor:

1. Öffnen der IIS Management Konsole

2. Rechtsklick auf den Computernamen und auf Eigenschaften gehen

3. auf MIME Types klicken

Technik, Eigenschaften von WAWISNEU1

4. auf Neu klicken

Technik, MIME - Typ

Definition: MIME Type „application/octet-stream“:

• .config
• .lic
• .dat
• .scc
• .rdl
• .rptproj
• .suo

Definition: MIME Type „application/x-ms-manifest“:

• .manifest

Nach dem die MIME Types eingetragen wurden, sollte ein IISReset durchgeführt werden. Dabei wird der Webservice neu gestartet. Für den Neustart muss in der Kommandozeile iisreset eingegeben werden. Im log des IIS finden sich auch oft entsprechende Fehlermeldungen. Bei einem 404 3 ist wiederum der MIME Type für die entsprechende Dateiendung einzutra-gen.

Zusätzliche Einstellungen IIS 7

Für ein erfolgreiches Deployment müssen die „Frontpage Server extensions“ auf dem ent-sprechenden Server installiert sein. Zusätzlich muss in der Datei: %windir%\System32\inetsrv\config\applicationHost.config fol-gende Einträge entsprechend angepasst werden:

• <section name="customMetadata" allowDefinition="AppHostOnly" overrideModeDefault="Allow" />
• <add fileExtension=".config" allowed="true" />
• <section name="directoryBrowse" overrideModeDefault="Allow" />

Im Basisverzeichnis des Click Once Deployments sollte eine „web.config“ Datei mit folgen-dem Inhalt abgelegt werden:

<?xml version="1.0" encoding="UTF-8"?>

<configuration>

   <system.webServer>
       <directoryBrowse enabled="true" />
       <staticContent>

<mimeMap fileExtension=".user" mimeType="application/x-ms-application" /> <mimeMap fileExtension=".exe.config" mimeType="application/x-ms-application" /> <mimeMap fileExtension=".suo" mimeType="application/x-ms-application" />

       </staticContent>

<security> <requestFiltering> <fileExtensions allowUnlisted="true" applyToWebDAV="true" /> </requestFiltering> </security>

       <defaultDocument>
           <files>
               <add value="coplanner.htm" />
           </files>
       </defaultDocument>
   </system.webServer>

</configuration>

Grundsätzlich können bei einem Click Once Deployment keine versteckten Dateien bzw. Dateien mit Umlauten im Dateinamen übertragen werden.