Werking van de Office Connector, en het oplossen van fouten. De Office Connector zorgt ervoor dat de Microsoft Office-‐omgeving gebruikt kan worden als ontwerp-‐ en genereeromgeving voor documenten waarbij de benodigde gegevens centraal zijn opgeslagen. Op dit moment wordt deze gebruikt voor het ontwerpen en genereren van prijskaarten met voertuiggegevens beschikbaar in Doorlinken Voorraad. De Office Connector bestaat uit de volgende componenten:
Webserver
Client computer
ocStart.exe
Internet Explorer Microsoft Word ActiveX component
OfficeConnect.dll
De werking van de module kan goed worden uitgelegd door uit te leggen hoe het proces verloopt bij het genereren van een prijskaart. -‐
-‐
Website bezoek. De klant bezoekt een website die de sjabloonmodule aanbiedt. Op de website is een ‘ActiveX’ component genaamd OfficeConnect.cab opgenomen. ActiveX componenten werken alleen in Microsoft Internet Explorer. Daar het component 32-‐bits is, dient ook Internet Explorer 32-‐bits te zijn. Op 64-‐bits Windows machines wordt in de regel een 32-‐bits versie van Internet Explorer gebruikt. Activatie ActiveX component. Het ActiveX component dient geïnstalleerd te zijn in Internet Explorer om het te kunnen uitvoeren. Internet Explorer controleert of de aangeboden versie nieuwer is dan de geïnstalleerde versie, en voert waar nodig een update uit. Op het moment dat het ActiveX component nog niet is geïnstalleerd of moet worden geupdate, vraagt Internet Explorer toestemming om deze te installeren. Dit ziet er als volgt uit:
Op het moment dat u op de gele bovenbalk klikt kunt u het component installeren door op
‘Install ActiveX Control…’ of ‘Install This Add-‐on for All Users on This Computer’ te klikken:
-‐
-‐
-‐
-‐
Installatie Office Connector. Internet Explorer voert nu het installatiescript van het ActiveX Component uit. Het script bestaat uit de volgende acties: o Controleren en eventueel installeren van Microsoft compenten vereist voor het kunnen gebruiken van de module o Kopieren van ocStart.exe naar de Windows directory. o Kopieren van OfficeConnect.dll naar de Windows directory. o Registreren van de OfficeConnect.dll met behulp van regsrv32 o De bestandsassociaties voor de extensies .ocdocument en .ocsjabloon registreren en toekennen aan ocStart.exe o OfficeConnect.dll als COM component registreren in de Microsoft Office omgeving. Genereren van een sjabloon. Als de installatie geslaagd is toont de website een overzicht met beschikbare documentsjablonen (prijskaarten). Op het moment dat de klant op genereer prijskaart klikt, genereert de webserver een bestand met de extensie .ocdocument in een nieuw venster. Als de installatie correct is uitgevoerd opent Windows nu ocStart.exe en geeft hieraan het .ocdocument bestand mee. ocStart.exe. De hoofdtaak van ocStart.exe is het opzoeken en starten van Microsoft Word en het beschikbaar maken van het .ocdocument bestand aan Microsoft Word. Het opzoeken van Microsoft Word gebeurt door in de registry het CLSID op te zoeken van Word.Application (HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Word.Application\CLSID) en vervolgens de applicatie executable op te zoeken in HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{Gevonden CLSID}\LocalServer32. Hierna wordt het .ocdocument gekopieerd naar %TEMP%\ocDoc.tmp. Als laatste wordt de gevonden Microsoft Word executable gestart. In Microsoft Word. Op het moment dat Microsoft Word (32-‐bits) wordt gestart, wordt ook het COM object OfficeConnect.dll geladen. Bij het laden hiervan wordt gecontroleerd of er een prijskaart.tmp bestaat in de directory %TEMP%. Indien deze aanwezig is, maakt de module van dit bestand een nieuw Microsoft Word document en voegt hier met behulp van de standaard ‘Mail Merge’ functionaliteit in Microsoft Word de data in. Vervolgens wordt het gegenereerde document geopend, en worden de diverse bestanden opgeruimd.
Indien het prijskaartensysteem niet werkt ligt dit meestal aan één van de volgende dingen: -‐
Het scherm ‘De prijskaartmodule is nog niet geladen’ blijft verschijnen. Dit wijst erop dat Internet Explorer niet toestaat dat de prijskaartmodule wordt geïnstalleerd of wordt geladen, of dat deze niet goed is geïnstalleerd. Mogelijke zaken om te controleren: o Is het ActiveX component geregistreerd en niet uitgeschakeld? o Is de Office Connector geïnstalleerd? o Heeft de gebruiker beheerdersrechten bij de installatie van de module?
-‐
-‐
-‐
-‐
Microsoft Word wordt bij het aanklikken van een prijskaart niet gestart. Dit betekent over het algemeen dat de installatie van Microsoft Word niet wordt herkend of dat een Microsoft Office applicatie al geopend was maar bijvoorbeeld is vastgelopen. U kunt dit controleren door alle Microsoft Office applicaties (Outlook, Excel e.d.) te sluiten en te controleren in het taakbeheer of deze echt niet meer draaien op bijvoorbeeld de achtergrond. Hierna klikt u een prijskaart aan op de website. Deze wordt gedownload. Als Microsoft Word nu niet start, opent u Microsoft Word handmatig. Op het moment dat deze de prijskaart nu wel genereert is de herkenning van de Microsoft Word installatie mislukt. Oplossing: Verwijder alle versies van Microsoft Office van de computer, en installeer het pakket opnieuw. Indien dit nog niet helpt is de Windows registry zodanig vervuild dat u de computer opnieuw dient te installeren. Op het moment dat bij het handmatig starten van Microsoft Word de prijskaart niet wordt geladen, is waarschijnlijk de installatie van de Office Connector niet geslaagd. Verwijder deze volledig en installeer opnieuw (zie verderop). Microsoft Word wordt wel gestart maar de prijskaart wordt niet gegenereerd. Dit betekent over het algemeen dat het COM object in Microsoft Word is uitgeschakeld, of de installatie is mislukt. Controleer of het COM object is uitgeschakeld en heractiveer deze. Op het moment dat deze al geactiveerd was, verwijder de Office Connector volledig en installeer deze opnieuw (zie verderop). Microsoft Word wordt gestart maar er worden veel pagina’s met letters gegenereerd. Dit betekent dat er is gerommeld met de bestandsextensies. Zorg ervoor dat de extensies .ocdocument en .ocsjabloon worden geopend met ocStart.exe. Er gaat iets anders mis of de geboden oplossingen helpen niet. Natuurlijk kan niet alles worden ondervangen in dit document. Veel voorkomende oorzaken van problemen die hier niet genoemd zijn zijn: o Een anti-‐virus-‐ of firewallprogramma voorkomt het correct werken van de sjabloonmodule o Er zijn andere ActiveX componenten actief die niet goed functioneren of de werking verstoren (malware) o De gebruiker heeft niet voldoende rechten of had dit niet tijdens installatie van de sjabloonmodule o De computer is dusdanig vervuild dat het functioneren van de module wordt verhinderd o Er wordt gebruik gemaakt van een (nog) niet door de sjabloonmodule ondersteunde versie van Microsoft Office o Tijdens de installatie is niet overal toestemming voor gegeven
Acties: Controleren of het ActiveX component is geregistreerd en niet is uitgeschakeld (De uitleg wordt zo algemeen mogelijk gegeven, helaas kunnen de details per versie van Windows en Internet Explorer verschillen)
Open de Internetopties in Internet Explorer. Ga naar het tabblad Programma’s en klik op ‘Add-‐ons’ beheren. Kies nu de optie ‘Alle add-‐ons’. Zoek in de lijst naar Hexon BV OfficeConnect.plugin. Op het moment dat deze niet bestaat is de prijskaartmodule niet geinstalleerd. Op het moment dat de status ‘uitgeschakeld’,’geblokkeerd’ of ‘niet beschikbaar’ is dan dient u deze weer in te schakelen of de prijskaartenmodule te verwijderen en opnieuw te installeren Controleren of de Office Connector is geinstalleerd Ga in de windows verkenner naar de directory waar windows is geinstalleerd (meestal C:\Windows of C:\WINNT). Verzeker u ervan dat verborgen bestanden en systeembestanden worden weergegeven. Bestaan de bestanden OfficeConnect.dll en ocStart.exe? Zo niet, dan is de prijskaart niet (correct) geïnstalleerd. Controleren of het COM object is uitgeschakeld Office 2007 en later: Open Microsoft Word. Ga naar ‘Word opties’. U vindt deze door op de office knop te klikken en dan onderaan het menu. Ga in de opties naar Add-‐ins. Kies in de dropdown ‘Beheren’ COM Add –ins. Controleer hier of de Office Connector aanwezig is en bij Actieve of inactieve Applicatie Add-‐ins staat. Zo niet, dan is deze uitgeschakeld. Schakel deze opnieuw in of verwijder de prijskaartmodule en start opnieuw. Office 2003. Open Microsoft Word. Ga in het menu naar Help, Info. Klik rechtsonderaan op ‘Uitgeschakelde items’. Controleer of de Office Connector hiertussen staat en heractiveer deze eventueel. Indien niet het geval is, dan is deze uitgeschakeld. Schakel deze opnieuw in of verwijder de Office Connector en start opnieuw. Office 2003 en eerder: Open Microsoft Word. Ga in het menu naar Extra, Aanpassen. Ga naar het tabblad ‘Opdrachten. Selecteer de categorie ‘Extra’. Sleep de knop ‘COM-‐invoegtoepassingen’ uit het scherm ‘aanpassen’ naar het Microsoft Word menu ‘Extra’ en voeg het ergens tussen de menuitems. Sluit het menu aanpassen. Ga nu in het menu Extra naar de net door u toegevoegde optie ‘COM-‐invoegtoepassingen’. Controleer of bij beschikbare invoegtoepassingen de Office Connector bestaat en niet is uitgeschakeld. Zo niet, voeg dan handmatig het bestand OfficeConnect.dll toe uit de Windows directory of verwijder de prijskaartenmodule en installeer deze opnieuw. De prijskaartenmodule verwijderen en opnieuw installeren (Internet explorer 8 en later): Opnieuw installeren van de prijskaartmodule in IE8: 1: in het menu Tools naar ‘Internet Options’. Klik hierna in het tabblad ‘Programs’ op ’Manage add-‐ ons’ Selecteer bij Show(linksonder) ‘all add-‐ons’:
Selecteer in de lijst de Office Connector plugin:
Klik op More information:
Hierna op remove. Herinstaleer de plugin: Start nu de browser opnieuw op en ga naar het genereren van een prijskaart terug. Op het moment dat het verwijderen op deze manier niet lukt volg instructies Internet explorer 7 en eerder: De Office Connector verwijderen en opnieuw installeren (Internet explorer 7 en eerder): Sluit alle Internet Explorer venster en alle Microsoft Office vesters. Ga dan naar de Windows directory (Meestal C:\WINDOWS) en verwijder de bestanden: OfficeConnect.dll en ocStart.exe: Start nu de browser opnieuw op en ga naar het genereren van een prijskaart terug.
