ModusOne. ModusOne Web Client Setup. Version: 5.2

ModusOne ModusOne Web Client Setup Version: 5.2

Written by: Product Documentation, R&D Date: February 2013

© 2012 Perceptive Software. All rights reserved ModusOne is een handelsmerk van Lexmark International Technology SA dat is gedeponeerd in de V.S. en andere landen. Perceptive Software is een zelfstandige businessunit van Lexmark International Technology SA. Alle andere merken en productnamen die worden genoemd in dit document, zijn handelsmerken of gedeponeerde handelsmerken van hun respectieve eigenaren. Geen enkel onderdeel van deze publicatie mag zonder voorafgaande schriftelijke toestemming van Perceptive Software worden gereproduceerd, opgeslagen in een systeem voor het ophalen van gegevens of verzonden in welke vorm of op welke manier dan ook, waaronder op elektronische of mechanische wijze, of door middel van fotokopieën, opname of andere bestaande of toekomstige media.

Inhoud Doelgroep .................................................................................................................................................. 1 Bijwerken ................................................................................................................................................... 1

Update van versie 5.1.0 naar versie 5.2.0 ............................................................................................. 1 Installeren .................................................................................................................................................. 7

Algemene informatie .............................................................................................................................. 7 ModusOne Web Client implementeren ................................................................................................. 8 Vereisten op server voor implementatie en bediening ...................................................................... 8 Vereisten voor ModusOne .............................................................................................................. 8 Systeemvereisten voor Windows Server / IIS en MIME-typen ...................................................... 8 ModusOne Web Client-bestanden uitpakken en voorbereiden ........................................................ 9 Vereiste bestanden ......................................................................................................................... 9 Inhoud van ModusOneWebClient.zip............................................................................................. 9 Voorbereidende stappen .............................................................................................................. 12 Een virtuele map maken in IIS .......................................................................................................... 13 De ModusOne-installatie wijzigen .................................................................................................... 14

ModusOne Web Client instellen op een clientcomputer ..................................................................... 20 Vereisten voor clientcomputer ......................................................................................................... 20 Eerste keer starten op een clientcomputer ...................................................................................... 20 Taalversie instellen ........................................................................................................................... 20 Verhoogde machtigingen ................................................................................................................. 21 ModusWebClientLauncher .............................................................................................................. 23

Particuliere/beveiligde modus in een webbrowser.............................................................................. 24 Bekende problemen ............................................................................................................................ 24

iii

Doelgroep Dit document is ontworpen voor systeembeheerders of gebruikers met een basiskennis van het systeem. Er wordt van uitgegaan dat u ervaring hebt met de hier gebruikte platforms met Windows-servers en clients en met het IIS-platform waarmee webtoepassingen worden gehost. Als u ModusOne Web Client wilt installeren en instellen, moet u kennis hebben van een ModusOneinstallatie en het concept achter ModusOne-configuratie.

Bijwerken Update van versie 5.1.0 naar versie 5.2.0 Op de webserver 1. Kopieer het nieuwe bestand ModusWebClient.xap naar de virtuele map van IIS. Zie ook: Een virtuele map maken in IIS 2. Vervang het bestaande bestand ModusWebClient.html door het nieuwe bestand uit de map ModusOneWebClient.zip. 3. Voeg de volgende vermelding toe aan het bestand ModusWebClient.xml: Een lokale installatie bijwerken - Out-of-Browser-modus Wanneer ModusOne Web Client wordt gestart op een clientcomputer, wordt automatisch gecontroleerd of er een nieuwere versie beschikbaar is in de virtuele map van IIS. Zo ja, dan wordt de nieuwere versie overgebracht naar de clientcomputer en wordt relevante informatie weergegeven. De nieuwere versie wordt vervolgens lokaal geïnstalleerd wanneer de volgende keer ModusOne Web Client wordt gestart. Versie 5.2.0 bevat een nieuw certificaat waarvoor u eerst elke bestaande Out-of-Browser-installatie moet verwijderen. Dit kunt u doen via het Configuratiescherm of vanuit het contextmenu van de bestaande toepassing nadat u het weergegeven foutbericht hebt bevestigd. De In-Browser-versie van ModusOne Web Client bijwerken Als u ModusOne Web Client gebruikt in een browser, hoeft u de client niet expliciet bij te werken nadat wijzigingen zijn aangebracht aan de webserver. In dit geval is de enige vereiste dat de vervaldatum van de bijbehorende webinhoud zodanig moet worden geconfigureerd in de HTTP-header-instelling IIS configureren, dat opslag in de cache niet langer is toegestaan.

1

ModusOne Web Client installeren

SSL-verbinding Vanaf versie 5.2.0 kan ModusOne Web Client ook worden uitgevoerd met een SSL-verbinding. Hiervoor is een SSL-certificaat vereist. Naast het bovenstaande zijn ook de volgende wijzigingen vereist: Bestand ClientAccessPolicy.xml Voeg de volgende twee rood gemarkeerde regels toe aan het bestand: <policy> <domain uri="*"/> <domain uri="http://*"/> <domain uri="https://*" /> Bestand modus_Core.exe.config 1. Voeg de volgende twee rood gemarkeerde regels toe aan het bestand: 2. Voeg de nieuwe bindingconfiguratie BasicBinding_SSL toe: •

Kopieer de bestaande bindingconfiguratie BasicBinding.

•

Wijzig de naam van de nieuwe bindingconfiguratie in BasicBinding_SSL.

•

Wijzig de beveiligingsmodus van None in Transport:
2


maxStringContentLength="2147483647" maxArrayLength="2147483647" /> <security mode="None" /> <security mode="Transport" /> 3. Voeg de nieuwe gedragsconfiguratie BasicBehaviour_SSL toe: •

Kopieer de bestaande gedragsconfiguratie BasicBehavior en wijzig de nieuwe configuratie in BasicBehaviour_SSL.

•

Wijzig het metagegevenskenmerk httpGetEnabled van de service in httpsGetEnabled. <serviceThrottling maxConcurrentCalls="1000000" maxConcurrentInstances="1000000" maxConcurrentSessions="1000000"/> <serviceDebug includeExceptionDetailInFaults ="true"/> <serviceMetadata httpGetEnabled="true"/> <serviceThrottling maxConcurrentCalls="1000000" maxConcurrentInstances="1000000" maxConcurrentSessions="1000000"/> <serviceDebug includeExceptionDetailInFaults ="true"/> <serviceMetadata httpsGetEnabled="true"/>

4. Wijzig de serviceconfiguratie ModusUserRepositoryServiceBasic zodat het gebruik van SSL wordt toegestaan: •

Kopieer de bestaande configuratie en markeer de regels als commentaar.

•

Wijzig behaviorConfiguration van BasicBehaviour_SSL in BasicBehaviour_SSL.

•

Wijzig in add baseAddress de vermelding http in https en 8010 in 8110.

•

Wijzig bindingConfiguration in BasicBinding_SSL. <service name="ModusUserRepositoryServiceBasic" behaviorConfiguration ="BasicBehaviour_SSL" > <endpoint address ="data" binding ="basicHttpBinding" bindingConfiguration ="BasicBinding_SSL" contract ="ModusSuite.Security.Types.IModusUserRepository"/> Bestand modus_MWS.exe.config 1. Voeg de nieuwe bindingconfiguratie BasicBinding_SSL toe: •

Kopieer de bestaande bindingconfiguratie BasicBinding.

•

Wijzig de naam van de nieuwe bindingconfiguratie in BasicBinding_SSL.

•

Wijzig de beveiligingsmodus van None in Transport. <security mode="None" />
4


maxArrayLength="2147483647" /> <security mode="Transport" /> 2. Voeg de nieuwe gedragsconfiguratie BasicBehaviour_SSL toe: •

Kopieer de bestaande gedragsconfiguratie BasicBehavior en wijzig de nieuwe configuratie in BasicBehaviour_SSL.

•

Wijzig het metagegevenskenmerk httpGetEnabled van de service in httpsGetEnabled. <serviceThrottling maxConcurrentCalls="1000000" maxConcurrentInstances="1000000" maxConcurrentSessions="1000000"/> <serviceDebug includeExceptionDetailInFaults ="true"/> <serviceMetadata httpGetEnabled="true"/> <serviceThrottling maxConcurrentCalls="1000000" maxConcurrentInstances="1000000" maxConcurrentSessions="1000000"/> <serviceDebug includeExceptionDetailInFaults ="true"/> <serviceMetadata httpsGetEnabled="true"/> 3. Wijzig de serviceconfiguratie MwsRepositoryServiceBasic zodat het gebruik van SSL is toegestaan:

•


•

Wijzig bindingConfiguration in BasicBehaviour_SSL.

•


•

Wijzig bindingConfiguration van BasicBinding in BasicBinding_SSL.

5


<service name="MWSRepositoryServiceBasic" behaviorConfiguration ="BasicBehaviour_SSL" > <endpoint address ="mwsrepository" binding ="basicHttpBinding" bindingConfiguration ="BasicBinding_SSL" contract ="IMWSRepositoryService"/> 4. Wijzig de serviceconfiguratie ModusSuite.MWS.MWSProcessServiceBasic zodat het gebruik van SSL wordt toegestaan: •


•

Wijzig bindingConfiguration in BasicBehaviour_SSL.

•


•

Wijzig bindingConfiguration van BasicBinding in BasicBinding_SSL. <service name="ModusSuite.MWS.MWSProcessServiceBasic" behaviorConfiguration ="BasicBehaviour_SSL" > <endpoint address ="mwsprocess" binding ="basicHttpBinding" bindingConfiguration ="BasicBinding_SSL" contract ="ModusSuite.MWS.Types.IMWSProcessServiceBasic"/>

6


Bestand ModusWebClient.xml Wijzig in de volgende appSettings de vermelding http in https, 8011 in 8111 en 8010 in 8110: Opmerking: Nadat u een SSL-verbinding hebt in- of uitgeschakeld, moet u de browsergeschiedenis wissen en de browser opnieuw starten.

Installeren Algemene informatie Silverlight-toepassing ModusOne Web Client is gebouwd als een Microsoft Silverlight-toepassing. Silverlight-toepassingen worden gedownload vanaf een webserver en kunnen worden uitgevoerd op een clientcomputer in de In-Browser-modus of in de Out-of-Browser-modus. Verhoogde machtigingen zijn vereist als u de volledige functionaliteit voor interactie met Microsoft Office wilt gebruiken. De client moet worden uitgevoerd als een zogenaamde vertrouwde toepassing. Na de officiële release van Silverlight 5 kan in ModusOne 5.2.0 en hoger ModusOne Web Client in de InBrowser-modus worden uitgevoerd als vertrouwde toepassing die de volledige functionaliteit voor interactie met Microsoft Office biedt. Installatie in twee stappen De installatie wordt uitgevoerd in twee stappen. Stap 1 Installatie via de webserver. Hiervoor moet u voorbereidingen op de server treffen. Stap 2

7


•

Installatie van de Silverlight-runtimeomgeving op de client

•

De uitvoering van ModusOne Web Client als vertrouwde toepassing voorbereiden Out-of-Browser-modus Lokale installatie van ModusOne Web Client In-Browser-modus met Silverlight 5 - Installatie van het certificaat ModusOneWebClient.cer op de client, dat is meegeleverd met de installatieset - Configureren hoe een vertrouwde toepassing wordt uitgevoerd in een browser - De client laden vanaf de laadpagina in een webbrowser

ModusOne Web Client implementeren Vereisten op server voor implementatie en bediening

Vereisten voor ModusOne •

Voor een installatie op de server is een minimale releasebasis van versie 5.2.0 vereist.

•

Installatiepakket voor ModusOne Web Client (ModusOneWebClient.zip)

•

ModusWebClientLauncher indien vereist (ModusWebClientLauncher.exe)

Systeemvereisten voor Windows Server / IIS en MIME-typen IIS Naast de vereisten van het serverbesturingssysteem voor het uitvoeren van ModusOne Server moet voor het hosten van ModusOne Web Client op een ModusOne-server ook de WWW-service van Internet Information Services (IIS) worden geïnstalleerd of geactiveerd. Activering van TCP-poorten Als er zich een firewall tussen de ModusOne-clients en de ModusOne-server bevindt, moeten de volgende poorten worden geactiveerd tijdens een standaardinstallatie: •

8000

•

8010

•

8011

•

8012

Als SSL wordt gebruikt om de communicatie tussen de ModusOne-clients en de ModusOne-server te beschermen, moeten de volgende poorten worden geactiveerd tijdens een standaardinstallatie: •

8000

•

8110

•

8111

•

8012

De webclient implementeren

8


Als u de webclient wilt implementeren, hoeft u normaal gesproken geen extra wijzigingen aan te brengen. Afhankelijk van de gebruikte Windows Server-versie en daarmee de actieve IIS-versie, moet u echter mogelijk bepaalde MIME-typen toevoegen om de implementatie van Silverlight-toepassingen te ondersteunen. Deze stap is alleen nodig als u een eerdere IIS-versie dan 7.0 hebt en Windows XP, Windows 2003 of Windows Vista RTM gebruikt Alle benodigde MIME-typen voor de ondersteuning van Silverlight worden standaard geïmplementeerd in Windows 2008 of Windows Vista SP1. Met betrekking tot de aanbevolen platforms voor ModusOne Server-installaties is dit alleen van toepassing op Windows Server 2003 IIS 6.0. Controleer of de volgende MIME-typen bestaan en voeg deze toe als ze ontbreken: •

.XAP

•

.XAML

application/xaml+xml

•

.XBAP

application/x-ms-xbap

application/x-silverlight-app

Als u Windows Server 2003 IIS 6.0 gebruikt, kunt u de instellingen wijzigen door IIS-beheer uit te voeren vanuit het eigenschappenvenster voor de lokale computer. Klik op de knop MIME-typen om het eigenschappenvenster te openen, waarin u de vereiste MIMEtypen kunt toevoegen. Raadpleeg het artikel Configuring IIS for Silverlight Applications (KBA-01067-8Q0ZNL) op de website voor een gedetailleerde beschrijving (en ook voor andere platforms). www.interactivewebs.com rechtstreekse koppeling: http://www.interactivewebs.com/DesktopModules/iCRMKnowledgeBase/ViewArticle.aspx?id=66

ModusOne Web Client-bestanden uitpakken en voorbereiden

Vereiste bestanden •

Zipbestand ModusOneWebClient.zip: bevat alle benodigde installatie- en configuratiebestanden.

•

Installatiepakket ModusOneSL5Setup.msi als alternatief voor handmatige configuratie: Voor een vereenvoudigde configuratie van ModusOne Web Client als vertrouwde toepassing in een browser met Silverlight 5.

•

ModusWebClientLauncher.exe Optionele tool om Modus Client te starten in de Out-of-Browser-modus.

Inhoud van ModusOneWebClient.zip Het zipbestand ModusOneWebClient.zip bevat twee mappen: •

ModusOne

•

ModusOneWebClient

9


•

SL5_Setup

Map ModusOne Bevat ModusOne-configuratiebestanden. Deze moeten worden gekopieerd naar de ModusOne-installatiemap (omgevingsvariabele %modusdir%) of vergeleken naar bestaande bestanden, zoals van toepassing. Bestand

Functie

modus_Core.exe.config

Configuratiebestand voor modus_core services Moet worden vergeleken met het bestaande bestand van de oorspronkelijke ModusOneinstallatie.

modus_MWS.exe.config

Configuratiebestand voor modus_mws services. Moet worden vergeleken met het bestaande bestand van de oorspronkelijke ModusOneinstallatie.

ClientAccessPolicy.xml

Configuratiebestand voor de nieuwe services tussen domeinen. Moet worden gekopieerd naar de ModusOneinstallatiemap indien nog niet beschikbaar.

Map ModusWebClient Webmap voor implementatie van webserver. Bestand

Functie

10


ModusWebClient.xml

Configuratiebestand met doeladressen voor ModusOne Web Client. De waarden voor de volgende configuratiesleutels moeten worden aangepast aan de vereisten van de klant

ModusWebClient.xap

•

mwsProcessServiceBasic

•

mwsRepositoryServiceBasic

•

MURServiceBasic en indien vereist

•

mwsProcessServiceRest

Het Silverlight-toepassingspakket van ModusOne Web Client. Dit bevat de gecomprimeerde assembly's en bronnen van de Silverlight-toepassing.

ModusWebClient.html

HTML-code om ModusOne Web Client te downloaden via een webbrowser.

\Help\de\

Bestanden van HTML-Help – Duitse versie

\Help\en

Bestanden van HTML-Help – Engelse versie

Directory SL5_setup Bestanden voor handmatige configuratie van de Silverlight 5-client op een clientcomputer. Bestand

Functie

ModusOneWebClient.cer meegeleverd met de installatieset

Digitaal certificaat voor ModusOne Web Client. Benodigd om authenticiteit van fabrikant te controleren.

Silverlight_AppTrust_x32.reg

Registerinstellingen voor 32-bits systemen

11


Silverlight_AppTrust_x64.reg

Registerinstellingen voor 64-bits systemen

Voorbereidende stappen Voer de volgende stappen uit om uw systeem voor te bereiden op de implementatie van ModusOne Web Client. 1. De Microsoft Silverlight-toepassing implementeren Implementeer de Microsoft Silverlight-toepassing door het bestand ModusWebClient.xap en het configuratiebestand ModusWebClient.xml te configureren naar een bestaande webmap en het XAPbestand aan te roepen vanaf een webpagina, zoals wordt gedemonstreerd op de ingesloten testpagina (ModusWebClient.html). Als u niet beschikt over een webmap of -pagina waarin u de code voor de XAP-aanroep kunt kopiëren, kunt u ook de bovenstaande testpagina gebruiken voor een testimplementatie. Voer hiervoor de onderstaande stappen uit. 2. Een map maken en bestanden kopiëren Maak een map in het bestandssysteem van ModusOne of de webserver, bijvoorbeeld %modusdir%\ModusWebClient, en kopieer de volgende bestanden naar de map: •

ModusWebClient.xap

•

ModusWebClient.xml

•

ModusWebClient.html

•

Help\* (volledige mapstructuur)

Zorg ervoor dat u alle submappen voor het Help-systeem van ModusOne Web Client opneemt wanneer u de map Help kopieert. Zoals hierboven is beschreven, is de doelmap dezelfde map waarnaar het XAP-bestand is gekopieerd. In dit geval '%modusdir%\ModusWebClient' Alleen wanneer de Help-bestanden zich in een submap ten opzichte van het XAP-bestand bevinden in de indeling Help/{LANGUAGE-ISOCODE}, worden de bestanden gegarandeerd gevonden in ModusOne Web Client. 3. Het configuratiebestand ModusWebClient.xml wijzigen Open het configuratiebestand ModusWebClient.xml in een editor die compatibel is met UTF-8. Wijzig de waarden voor serveradressen in de configuratiesleutels •

mwsProcessServiceBasic

•

mwsRepositoryServiceBasic en

•

MURServiceBasic

12


in de waarden van ModusOne Server (de standaardinstelling is localhost), dus naar het IP-adres of de DNS-naam van ModusOne Server. Afhankelijk van de configuratie van de nieuwe component mws-process REST services, die is opgenomen in ModusOne versie 5.1.0 en hoger (zie De ModusOne-installatie wijzigen), moet u ook de configuratiesleutel mwsProcessServiceRest als volgt instellen als de nieuwe service moet worden uitgevoerd op een andere server/poort dan de normale service mws-process BASIC. ... ... Als deze sleutel niet bestaat of leeg is, wordt standaard de parameter van mws Basic Service gebruikt. Voor het gebruik van een SSL-verbinding is een SSL-certificaat vereist. Verwijder de markering als commentaar voor de volgende sectie in de standaardinstallatie (hieronder rood gemarkeerd) en markeer de voorgaande sectie als commentaar zodat beide secties er als volgt uitzien: 4. UTF-8-codering Houd u goed aan de vereisten voor UTF-8-codering wanneer u alle XML-configuratiebestanden opslaat!

Een virtuele map maken in IIS Als de genoemde map in de vorige sectie een nieuwe map is en nog niet is gedefinieerd als component van een webtoepassing, moet u de map als virtuele map in IIS definiëren voordat een webtoegang hiertoe toegang heeft. URL

13


Als u de naam ModusWebClient voor de virtuele map kiest, wordt deze onderdeel van de toepassingsURL. Deze wordt later gebruikt om ModusOne Web Client te openen. http://[ModusOne-servernaam]\ModusWebClient U moet de tijdelijke aanduiding [ModusOne-servernaam] vervangen door de respectieve hostnaam van uw server. Standaarddocumenten in de webmap Als u toegang wilt garanderen en een fout als HTTP 403 - Deze webpagina kan niet worden weergegeven wilt voorkomen, moet de HTML-pagina vanaf waar de Silverlight-client wordt gedownload, zich bevinden in de lijst met standaarddocumenten van de webmap. Als u het testdocument ModusWebClient.html gebruikt dat mee wordt geïnstalleerd, moet u de naam ModusWebClient.html toevoegen aan de lijst met standaarddocumenten of de bestandsnaam wijzigen in Default.htm of index.html, want deze namen worden meestal gedefinieerd en standaard toegevoegd. Toegang U hoeft geen andere toegangsrechten dan Lezen toe te voegen voor het gedefinieerde document. U kunt de verificatieprocedure instellen op Anonieme verificatie omdat verificatie en aanmelding bij ModusOne Server worden uitgevoerd via de webclient zelf. Configuratie Met behulp van het externe configuratiebestand ModusWebClient.xml worden de configuratieinstellingen van de webclient altijd geladen voordat het aanmeldingsvenster wordt weergegeven. Zodoende kunt u de configuratie zelfs wijzigen terwijl de webclient nog wordt uitgevoerd. De wijzigingen worden van kracht nadat u zich opnieuw hebt aangemeld. In zowel IIS als de browser worden de configuratie en XAP opgeslagen in de cache. Als u zeker wilt weten dat wijzigingen in de toepassing (zoals hierboven is beschreven) direct van kracht worden, moet u de instellingen voor de vervaldatum van webinhoud dienovereenkomstig configureren. Dit kunt u in IIS doen door in het eigenschappenvenster de eigenschap http Headers voor de betreffende bestanden in te stellen. Nadat u de switch Verlopen van inhoud inschakelen of Webinhoud laten verlopen hebt ingeschakeld, kunt u de vervaldatum van de geselecteerde inhoud definiëren zodat het laden van bijgewerkte inhoud wordt afgedwongen in de browser. Als u de instelling Direct verlopen definieert, worden wijzigingen meteen van kracht.

De ModusOne-installatie wijzigen Werk de ModusOne-installatie bij naar versie 5.2.0 als u dit nog niet hebt gedaan. Vanaf versie 5.1.0 bevat ModusOne nieuwe componenten waarmee ModusOne Web Client wordt ondersteund: CrossDomainService, REST-Services en CORS-Support (Cross Originate Resource Sharing). ModusOne Web Client werkt pas goed nadat deze nieuwe componenten zijn geconfigureerd. Voer de volgende stappen uit:

14


1. Bestanden kopiëren Kopieer eerst het bestand ClientAccessPolicy.xml naar de ModusOne-installatiemap (%modusdir%). 2. Configuratiebestanden wijzigen 1. Wijzig de configuratiebestanden modus_Core.exe.config en modus_mws.exe.config van uw bestaande ModusOne-installatie. De sjabloonversie van deze bestanden in het ModusOne Web Client-installatiepakket (ModusOneWebClient.zip) kan worden gebruikt als referentie voor de wijzigingen die u moet aanbrengen in uw ModusOne-configuratiebestanden. 2. Voeg deze sjablonen met uw bestaande ModusOne-configuratiebestanden samen tot één bestand. U kunt hiervoor tools zoals WinMerge of BeyondCompare gebruiken. 3. Het bestand modus_Core.exe.config controleren Controleer in het bestand modus_Core.exe.config of de volgende inhoud bestaat en correct is als u een bestaande ModusOne-installatie hebt bijgewerkt naar versie 5.2.0. (Inhoud kan mogelijk ontbreken of als commentaar zijn gemarkeerd.) Let met name erop dat de service crossdomain in de secties configSections en runtimeservices is ingeschakeld voor het geval de code is gemarkeerd als opmerking. De code regel ziet er als volgt uit: … <section name="crossDomainServices" type="ModusSuite.Runtime.CrossDomainServiceConfiguration, ModusSuite.Runtime.CrossDomainService" /> … … <service name="crossdomain" assembly="ModusSuite.Runtime.CrossDomainService" type="ModusSuite.Runtime.CrossDomainRuntimeService"/> …

Configuratie voor gebruik van een SSL-verbinding: Voer de volgende stappen uit als u een SSL-verbinding wilt gebruiken (hiervoor is een SSL-certificaat vereist): Stap 1: Verwijder de markering als commentaar voor de volgende regels in de standaardinstallatie (rood gemarkeerd) zodat de sectie er als volgt uitziet:

15


Stap 2: Verwijder de markering als commentaar voor de volgende sectie in de standaardinstallatie (hieronder rood gemarkeerd) en markeer de voorgaande sectie als commentaar zodat beide secties er als volgt uitzien: <service name="ModusUserRepositoryServiceBasic" behaviorConfiguration ="BasicBehaviour_SSL" > <endpoint address ="data" binding ="basicHttpBinding" bindingConfiguration ="BasicBinding_SSL" contract ="ModusSuite.Security.Types.IModusUserRepository"/> 4. Het bestand modus_Mws.exe.config controleren Controleer in het bestand modus_Mws.exe.config of de volgende inhoud bestaat en correct is. (N.B. Inhoud kan ontbreken of als commentaar zijn gemarkeerd.) Configuratie van MWS REST-service en CORS-ondersteuning <modusruntime>

16


… <service name="mwsrest" assembly="ModusSuite.Runtime.MWSRuntimeService" type="ModusSuite.Runtime.MWSRuntimeServiceRest"/> … … <system.serviceModel> <services> … <service name="ModusSuite.MWS.MWSProcessServiceRest" behaviorConfiguration ="RestBehavior" > <endpoint address ="mwsprocess" binding ="webHttpBinding" contract ="ModusSuite.MWS.Types.IMWSProcessServiceBasic" bindingConfiguration="" behaviorConfiguration = "WebBehavior" /> … … <serviceBehaviors> … <serviceMetadata httpGetEnabled="true"/> <endpointBehaviors> <webHttp/>

17


<extensions> <service name="MWSRepositoryServiceBasic" behaviorConfiguration ="BasicBehaviour_SSL" > <endpoint address ="mwsrepository" binding ="basicHttpBinding" bindingConfiguration ="BasicBinding_SSL"

18


contract ="IMWSRepositoryService"/> <service name="ModusSuite.MWS.MWSProcessServiceBasic" behaviorConfiguration ="BasicBehaviour_SSL" > <endpoint address ="mwsprocess" binding ="basicHttpBinding" bindingConfiguration ="BasicBinding_SSL" contract ="ModusSuite.MWS.Types.IMWSProcessServiceBasic"/> 5. Serveradressen vervangen Klik op de configuratiebestanden modus_Core.exe.config en modus_mws.exe.config en vervang de serveradressen door de hostnaam van de ModusOne-server: •

appsettings

•

services

•

crossDomainServices

Gebruik de sjabloonversie van deze bestanden in het ModusOne Web Client-installatiepakket als referentie voor het vervangen van de namen. De respectieve secties zijn gemarkeerd met de tijdelijke aanduiding [ModusOne-servernaam]. 6. Services opnieuw starten Stop de ModusOne-services en start deze opnieuw zodat de nieuwe configuratie van kracht wordt. In ModusOne Server kunnen nu verzoeken van de ModusOne Silverlight-client worden geaccepteerd.

19


ModusOne Web Client instellen op een clientcomputer Vereisten voor clientcomputer Microsoft Silverlight 5-runtimeomgeving Als de Silverlight-invoegtoepassing ontbreekt wanneer u ModusOne Web Client voor het eerst start, wordt u gevraagd naar een downloadkoppeling voor de invoegtoepassing. De Silverlight 5-runtimeomgeving kan worden geïnstalleerd en geïmplementeerd op de clientcomputer ter voorbereiding van het eerste gebruik. Microsoft biedt alle benodigde resources. Ga naar http://www.silverlight.net/downloads om het benodigde installatiepakket te downloaden. Selecteer de downloadoptie Microsoft Silverlight 5 Runtime. .NET Framework 3.5SP1 Als u optioneel ModusWebClientLauncher wilt gebruiken, moet .NET Framework 3.5.5 SP1 zijn geïnstalleerd. Microsoft Word Als u de volledige functionaliteit van ModusOne Web Client wilt gebruiken, moet Microsoft Word 2007 of Microsoft Word 2010 zijn geïnstalleerd op de clientcomputer. Webbrowser De volgende browsers worden ondersteund: •

Internet Explorer 8 en 9

•

Firefox 10.0.9 ESR

Eerste keer starten op een clientcomputer Voer de volgende stappen uit om ModusOne Web Client te starten: 1.

Start een webbrowser (Internet Explorer of Firefox).

2.

Open de vooraf geconfigureerde webpagina van ModusOne Web Client: http://[ModusOneServerName]\ModusWebClient

3.

Voer in het aanmeldingsvenster uw gebruikersnaam en wachtwoord in.

Taalversie instellen In ModusOne Web Client wordt normaal gesproken de taalversie geselecteerd overeenkomstig de taal van het besturingssysteem waarmee de webclient wordt gestart. Het installatiepakket bevat de volledige mapstructuren voor de Duitse, Engelse, Franse en Nederlandse taalversie. U kunt de taalversie ook instellen in het HTML-document over laadpagina's.

20


Voeg de volgende parameters voor de culture-instellingen van de gebruikersinterface van de client toe aan de overige parameters in het HTML-document: <param name="culture" value="{LANGUAGE-ISOCODE}" /> <param name="uiculture" value="{LANGUAGE-ISOCODE}" />

De tijdelijke aanduiding {LANGUAGE-ISOCODE} moet worden vervangen door een van de volgende taalcodes: •

de-de voor Duits

•

en-GB voor Engels (GB)

•

en-US voor Engels (US)

•

fr-fr voor Frans

•

nl-nl voor Nederlands

•

it-it voor Italiaans

•

es-es voor Spaans

•

pt-br voor Portugees

Hiermee wordt de bijbehorende taalversie uitgevoerd. De webclient uitvoeren in de browser Als u ModusOne Web Client wilt uitvoeren in een browser, moeten deze instellingen worden geconfigureerd in het document ModusWebClient.html in de corresponderende webmap. De webclient uitvoeren in de Out-of-Browser-modus Zie ModusWebClientLauncher - Taalversie instellen.

Verhoogde machtigingen Verhoogde machtigingen zijn vereist als u de volledige functionaliteit voor interactie met Microsoft Office wilt gebruiken. De client moet worden uitgevoerd als vertrouwde toepassing. Dit is mogelijk in de Out-of-Browser- en In-Browser-modus. Verhoogde machtigingen in ModusOne Web Client in de Out-of-Browser-modus De Silverlight-client kan alleen in de Out-of-Browser-modus worden uitgevoerd wanneer de client lokaal is geïnstalleerd op de clientcomputer. Voer de volgende stappen uit: 1.

Start een webbrowser.

2.

Open de vooraf geconfigureerde webpagina van ModusOne Web Client (http://[ModusOneservernaam]\ModusWebClient).

3.

Houd de cursor boven de gebruikersinterface van de client.

21


4.

Open het contextmenu met de rechtermuisknop en selecteer de optie ModusOne Web Client installeren op deze computer.

5.

Bevestig het volgende pop-upvenster door op OK te klikken. ModusOne Web Client wordt nu lokaal op deze computer geïnstalleerd. Er is een menu-item met de naam ModusOne Web Client gemaakt in het menu Start.

6.

Gebruik dit menu-item om ModusOne Web Client in de Out-of-Browser -modus te starten. Als u dubbelklikt op documenten die in ModusOne Web Client zijn gegenereerd met de status Gemaakt, worden deze geopend in Word.

Verhoogde machtigingen in ModusOne Web Client in de In-Browser-modus In Silverlight 5 kunnen verhoogde machtigingen rechtstreeks in een browser worden gebruikt. Installatie Voer het installatiepakket ModusOneSL5Setup.msi uit. Met het MSI-pakket wordt het vereiste certificaat geïnstalleerd en worden alle benodigde registervermeldingen toegevoegd. De gebruiker hoeft niets in te voeren en het pakket kan in zowel 32-bits als 64-bits Windowsomgevingen worden uitgevoerd. Alternatief - handmatige configuratie Als u problemen met de MSI hebt, is handmatige configuratie mogelijk via de bronnen in het zippakket. Als u een vertrouwde toepassing wilt uitvoeren in een browser, moet u eerst het certificaat ModusOneWebClient.cer installeren, dat is meegeleverd met de installatieset in het zipbestand. Vervolgens kunt u het register zo configureren dat een vertrouwde toepassing in een browser wordt uitgevoerd. Voer hiervoor de volgende stappen uit: 1.

Dubbelklik op het bestand ModusOneWebClient.cer.

2.

Klik in het volgende dialoogvenster op Certificaat installeren. De wizard voor het importeren van certificaten wordt gestart.

3.

Klik op de knop Doorgaan.

4.

Selecteer in het volgende dialoogvenster de optie Alle certificaten opstaan in het volgende archief.

5.

Klik naast het veld Certificaatarchief op Bladeren.

6.

Selecteer het certificaatarchief Vertrouwde uitgever. In sommige gevallen moet u het certificaat mogelijk opslaan in het certificaatarchief Vertrouwde basiscertificeringsinstanties. Zie voor meer informatie http://msdn.microsoft.com/en-us/library/gg192793%28v=VS.96%29.aspx en http://technet.microsoft.com/en-us/library/cc730989%28WS.10%29.aspx en http://www.microsoft.com/GetSilverlight/resources/documentation/grouppolicysettings.aspx

7.

Bevestig de volgende drie dialoogvensters met Doorgaan, Voltooien en OK om de installatie van het certificaat te voltooien.

22


8.

Importeer een van de twee meegeleverde registerimportbestanden:

•

Silverlight_AppTrust_x32.reg voor 32-bits systemen

•

Silverlight_AppTrust_x64.reg voor 64-bits systemen Als u de registerbestanden importeert, worden de volgende instellingen toegevoegd aan het register: In HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Silverlight (32-bits) of HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Silverlight (64-bits) worden het register DWORD (32-bits) - AllowElevatedTrustAppsInBrowser en de waarde gewijzigd in 0x00000001 (1), waarbij (1-> ingeschakeld, 0-> uitgeschakeld). Zo nodig kunnen aanvullende optionele sleutels worden geconfigureerd: AllowLaunchOfElevatedTrustApps: starten van toepassingen met verhoogd vertrouwen in/uitschakelen. AllowInstallOfElevatedTrustApps: installatie van toepassingen met verhoogd vertrouwen in/uitschakelen. Deze instellingen kunnen ook worden geïmplementeerd via centrale softwaredistributie of centraal configuratiebeheer, bijvoorbeeld via een groepsbeleid dat door een centrale administrator is ingesteld. Opmerking voor Internet Explorer Controleer of Internet Explorer wordt uitgevoerd in de beveiligde modus als u nog altijd niet over de vereiste verhoogde machtigingen beschikt nadat u alle bovenstaande stappen hebt uitgevoerd. Zo ja, schakel de beveiligde modus dan uit of voer Internet Explorer als administrator uit.

ModusWebClientLauncher ModusWebClientLauncher kan optioneel worden gebruikt om de webclient in de Out-of-Browsermodus te starten. Hiermee kunt u specifieke opstartparameters doorgeven naar ModusOne Web Client. Installatie Het bestand ModusWebClientLauncher.exe is opgenomen in het installatiepakket (ModusOneWebClient.zip). Kopieer het bestand naar een lokale map waartoe de gebruiker ook toegang heeft. Starten Syntaxis ModusWebClientLauncher.exe -URL:"URL" | -APPID:"AppId" [-INFO] {ClientParameter} U hebt de URL of APPID nodig om ModusOne Web Client te starten via ModusWebClientLauncher. U kunt de APPID weergeven met de parameter -INFO:

23


ModusWebClientLauncher.exe -INFO Hiermee geeft u informatie weer over alle geïnstalleerde Silverlight-toepassingen. ModusWebClientLauncher Version 1.0.0.0 ModusOne Client - Copyright © 2012 Lexmark International Technology S.A. Information about installed Silverlight applications: Name : ModusOne Web Client AppID: 467687297.megatron Title: ModusOne Web Client Description: A ModusOne Web Client on your desktop; at home, in the office or on the road. OriginalSourceUri: http://megatron/moduswebclient/ModusWebClient.xap LaunchPath: C:\Documents and Settings\tester\Local Settings\Appdata\Microsoft\Silverlight\OutOfBrowser\467687297.megatron\index. html Gebruikersdocumentatie U kunt meer informatie over het starten van ModusWebClientLauncher vinden in de gebruikersdocumentatie van ModusOne Web Client. Taalversie instellen Voer de volgende stappen uit als u ModusOne Web Client wilt uitvoeren in een andere taal dan de taal van het besturingssysteem zelf: 1.

Geef LaunchPath weer door ModusWebClientLauncher te starten met de parameter -INFO, zoals hierboven wordt beschreven in de sectie Starten. In het bovenstaande voorbeeld is dat de map LaunchPath: C:\Documents en Settings\tester\Local Settings\Appdata\Microsoft\Silverlight\OutOfBrowser\467687297.megatron\

2.

Open het bestand index.html in deze map. Gebruik hiervoor een editor waarin UTF-16 wordt ondersteund, zoals Notepad++.

3.

Voeg de parameters voor de culture-instellingen toe na de overige parameters, zoals wordt beschreven in de sectie Taalversie instellen.

Particuliere/beveiligde modus in een webbrowser Het gebruik van de particuliere modus wordt niet aanbevolen omdat een aantal functies van ModusOne Web Client niet beschikbaar is in de particuliere modus.

Bekende problemen ModusOne Web Client wordt niet gestart in Firefox wanneer de parameter 'initparams' een lege waarde bevat. Als de parameter initparms leeg wordt gelaten in het startdocument (ModusWebClient.html), wordt de gebruiker gevraagd om Silverlight te installeren.

24


Als de gebruiker de instructie volgt, wordt het bericht weergegeven dat Silverlight al is geïnstalleerd, maar de toepassing wordt niet geladen. Dit probleem is doorgegeven aan Microsoft (fout-ID: 716568). ModusOne Web Client versie 5.1 wordt niet bijgewerkt in Out-of-Browser-modus. Nadat ModusOne Web Client in de Out-of-Browser-modus is aangeroepen, wordt de gebruiker gevraagd om een nieuwe Silverlight-versie te installeren en vervolgens de Out-of-Browser-toepassing opnieuw te starten. Nadat de update is geïnstalleerd en de client opnieuw is gestart, wordt het bovenstaande bericht opnieuw weergegeven. De toepassing is niet bijgewerkt. Het probleem is opgelost in Silverlight 5 build 5.1.10411.0. ModusOne Web Client kan niet worden gesloten in Firefox via het menu-item Client sluiten. Het probleem is doorgegeven aan Mozilla. Voer de volgende stappen uit om het probleem op te lossen: 1.

Start Firefox. Alleen Firefox versie 10.0.9 of eerder wordt ondersteund.

2.

Voer about:config in de adresbalk van de browser in.

3.

Bevestig het waarschuwingsvenster door op de knop Ik zal voorzichtig zijn, dat beloof ik! te klikken. Er wordt nu een tabel met configuratie-elementen weergegeven.

4.

Stel de sleutel dom.allow_scripts_to_close_windows in op true.

25

Index A

P

Algemene informatie .......................................... 7

Particuliere modus ........................................... 24

B

Problemen........................................................ 24

Beveiligde modus............................................. 24

S

C

Systeemvereisten .............................................. 8

Clientcomputer................................................. 20

T

D

Taalversie instellen........................................... 20

Doelgroep........................................................... 1

V

E

Vereiste bestanden ............................................ 9

Een virtuele map maken in IIS ......................... 13

Vereisten voor clientcomputer ......................... 20

Eerste keer starten ........................................... 20

Vereisten voor ModusOne ................................. 8

I

Verhoogde machtigingen................................. 21

IIS ................................................................. 8, 13

Virtuele map ..................................................... 13

M

Voorbereidende stappen ................................. 12

MIME-typen ....................................................... 8

W

ModusOne-installatie ....................................... 14

Webbrowser..................................................... 24

ModusWebClientLauncher .............................. 23

Windows Server ................................................. 8

ModusOne. ModusOne Web Client Setup. Version: 5.2

Recommend Documents