Installatieprocedure beheerder Profit Communication Center (PCC)
Dit onderdeel beschrijft de beheerdersinstallatie van het PCC. Je hebt het PCC nodig voor de integratie van Profit met Microsoft Office.
Zie ook de aparte beschrijving voor gebruikers die zelf het PCC installeren en/of koppelen aan een Profit-omgeving.
Beschrijving
Acties van de beheerder
De beheerder legt de autorisatie vast voor elke omgeving die in combinatie met het PCC gebruikt wordt. Ook deblokkeert de beheerder de app connector 'Profit Communication Center'.
Deblokkeer de app connector 'Temporary Office Access', deze is nodig voor het werken met analyses.
Acties van gebruikers
Je moet bepalen of je het Profit Communication Center beschikbaar stelt op een terminal server of per werkstation:
- Werkstation
Een gebruiker installeert het PCC op zijn werkstation. Vervolgens downloadt hij de instellingen en voert hij deze uit, hierdoor koppelt hij de omgeving.
Het is ook mogelijk dat een beheerder het PCC op het werkstation installeert, bijvoorbeeld via een 'silent install'. De gebruiker heeft dan het PCC, maar hij moet nog een omgeving koppelen. Hij downloadt de instellingen en voert deze uit, hierdoor koppelt hij de omgeving.
- Terminal server
De beheerder installeert het Profit Communication Center op de terminal server. Standaard zal het Profit Communication Center dan voor elke gebruiker beschikbaar zijn.
De gebruiker heeft dan het PCC, maar hij moet nog een omgeving koppelen. Hij downloadt de instellingen en voert deze uit, hierdoor koppelt hij de omgeving.
Systeemeisen
Je hebt het Profit Communication Center (PCC) nodig voor de verbinding tussen Profit en Microsoft Office. Elke gebruiker die het PCC wil gebruiken, moet deze applicatie installeren op zijn werkstation.
Besturingsystemen:
- Ondersteunde Windows-systemen:
- Windows Server 2022
- Windows Server 2019
- Windows Server 2016
- Windows Server 2012
- Windows Server 2012 R2
- Windows 11
- Windows 10
Het PCC is een Windows-applicatie, andere systemen zoals Apple Mac, Chromebooks en Linux worden niet ondersteund.
- Microsoft .NET
Als je het PCC installeert, dan moet minimaal Microsoft .NET 4.8 geïnstalleerd zijn. Als dit niet zo is, zal de installatiewizard dit onderdeel downloaden en installeren.
- Proxy-server
Bij het gebruik van een proxy-server kan het nodig zijn de firewall open te zetten voor de communicatie van/met het Profit Communication Center.
Meer informatie
Bij het gebruik van een proxy-server kan het nodig zijn de firewall open te zetten voor de communicatie van/met het Profit Communication Center. Deze uitzonderingen gelden voor HTTPS over poort 443.
Aandachtspunten:
- Na het doorvoeren van deze wijzigingen moeten gebruikers hun instellingen opnieuw downloaden op hun lokale computer en de instellingen uitvoeren.
- Controleer de lijst met URL's en IP-adressen. Controleer of je firewall deze doorlaat. De nieuwe URL's worden ook weggeschreven in de gebruikersinstellingen van het PCC.
Instellingen in Profit vastleggen:
- Ga naar: Small Business / Inrichting / Instellingen administratie.
- Ga naar het tabblad: PCC-instellingen.
- Selecteer een instelling bij Proxy type.
- Anonieme proxy
Aanmelden zonder account en wachtwoord.
- Proxy met gebruikersnaam/wachtwoord authenticatie
Vul de account en het wachtwoord in voor het aanmelden bij de proxy-server.
- Proxy met Windows-authenticatie
Aanmelden op basis van Windows-authenticatie bij de proxy-server.
- Proxy-instellingen van je computer gebruiken
- Vul het adres van de proxy in en eventueel de aanmeldgegevens.
- Klik op: OK.
- Windows Defender
Bij het gebruik van Windows Defender kan het nodig zijn binnen de policy van Windows Defender de rule ''Block Office communication application from creating child processes" uit te schakelen zodat het Profit Communication Center correct geladen kan worden in Microsoft Office.
Zie ook Customize attack surface reduction rules (Microsoft)
Het PCC is een externe applicatie die op het werkstation van een gebruiker geïnstalleerd wordt. Er is technische informatie beschikbaar voor beheerders die meer willen weten over het PCC als applicatie en de processen die door deze applicatie worden uitgevoerd.
Raadpleeg de technische informatie
De PCC bestaat uit de volgende 'addins' waarmee dossieritems kunnen worden vastgelegd in Profit:
- Microsoft Outlook
- Twee Microsoft Word-addins, één voor het insturen van dossieritems en één voor het bewerken van documenten.
- Microsoft Powerpoint
- Twee Microsoft Excel addin's, één voor het insturen van dossieritems en één voor het ontwerpen van analyses.
- File explorer (menu dat verschijnt als je met de rechtermuisknop op een bestand klikt)
Het PCC zorgt voor een verbinding van Profit met de client-pc, waar notificaties naar verstuurd kunnen worden. Zoals het signaal om een webpagina te openen als je de help opent vanuit in Profit. Of het openen van Word als je een document wil bewerken.
Het PCC kan ook een nieuw Update-bestand downloaden. Hierbij vindt een controle plaats op basis van een hash.
Zowel de DLL's als de addin's en de setup zijn gesigned door code signing van AFAS.
Rechten gebruiker op lokale systeem:
De gebruiker van het PCC moet op zijn systeem toegang hebben tot de volgende mappen:
- %appdata%\AFAS Software\OSCsettings
- %temp%
- %userprofile%\Downloads
Soms worden de settings niet goed opgeslagen in het Windows profiel, waardoor de gebruiker het PCC elke dag opnieuw moet koppelen. In dit geval dient de systeembeheerder onderstaande locatie mee te nemen bij het opslaan/openen van het Windows profiel:
C:\Users\[Gebruiker]\AppData\Roaming\Afas Software\OSCSettings
Microsoft Office:
- Elke gebruiker moet op zijn werkstation beschikken over een door AFAS ondersteunde versie van Microsoft Excel.
- Als je de Office-integraties van het PCC wilt gebruiken, dan moet je Visual Studio 2010 Tools for Office Runtime (versie 10.0.60724) van Microsoft installeren. De setup van het PCC controleert automatisch of Visual Studio 2010 Tools for Office Runtime geïnstalleerd is. Als dit niet het geval is, wordt VSTO automatisch geïnstalleerd.
App connector
Het Profit Communication Center is een externe applicatie. Het verkeer met Profit loopt via een app connector. Elke PCC-gebruiker krijgt een token die in de app connector wordt opgeslagen.
De beheerder deblokkeert deze app connector (per omgeving). Als de app connector toch geblokkeerd is, dan verschijnt de melding 'App-connector is geblokkeerd' bij bijvoorbeeld het downloaden van de Setup. Je deblokkeert de app connector om de melding te verhelpen.
App connector deblokkeren per omgeving:
- Open de omgeving die je wilt gebruiken in combinatie met het Profit Communication Center.
- Ga naar: Small Business / Beheer / App connector.
- Open de eigenschappen van de app connector Profit Communication Center.
- Deblokkeer de app connector.
- Klik op: OK.
- Deblokkeer op dezelfde manier de app connector AFAS Temporary Office Access.
- Hiermee geef je gebruikers toegang tot het bewerken van Office-bestanden vanuit Profit. Een Office-bestand (Word/Excel) kan opgeslagen worden als bijlage bij een dossieritem. Als je deze app connector deblokkeert, kunnen gebruikers een dossieritem openen en de bijlage bewerken. De bijlage kan daarna weer in Profit worden opgeslagen, bij het dossieritem.Hiermee geef je gebruikers toegang tot het bewerken van analyses.
- Hiermee geef je gebruikers toegang tot het bewerken van documentlay-outs.
- Gebruik je het PCC in combinatie met Gmail of Outlook onder Office 365 Cloud, zie dan de extra stappen bij Gmail of Outlook onder Office 365 Cloud.
Geldigheidsduur van tokens:
Je kunt per app connector in de eigenschappen een geldigheidsduur voor tokens instellen:
- Als je geen geldigheidsduur invult, dan is er geen geldigheidsduur van toepassing.
- Als je wel een geldigheidsduur invult, dan moet elke gebruiker van het Profit Communication Center Connector na het verlopen van de geldigheidsduur opnieuw inloggen. Deze functionaliteit is specifiek gericht op klanten die een eigen oplossing gebruiken voor single sign on.
Tokens beheren:
Een beheerder kan een token verwijderen uit een omgeving (in de eigenschappen van de app connector). Dit kan nodig zijn als een gebruiker bijvoorbeeld meldt dat hij zijn laptop kwijtgeraakt is. Door de token te verwijderen, kan het Profit Communication Center niet meer vanaf de kwijtgeraakte laptop gebruikt worden. Als de gebruiker een nieuwe laptop krijgt, kan hij het Profit Communication Center opnieuw downloaden en installeren. Bij het vastleggen van de instellingen ontstaat automatisch een nieuwe token.
Als een gebruiker een nieuw werkstation krijgt, hoef je de oude token niet te verwijderen. De gebruiker installeert het Profit Communication Center op zijn nieuwe werkstation en legt zijn instellingen vast. Hierdoor krijgt hij een nieuwe token en de oude token vervalt.
Terminal Server / Silent install
AFAS biedt geen ondersteuning/support op onderstaande oplossingen.
Profit Communication Center installeren op Terminal Server
De installatie op een terminal server wordt niet ondersteund door AFAS, we vermelden het onderstaande ter informatie.
Een beheerder kan het Profit Communication Center (PCC) installeren op een terminal server, zodat alle gebruikers het PCC via de terminal server kunnen gebruiken. Gebruikers hoeven het PCC niet te installeren. Wel moet elke elke gebruiker inloggen op de terminal server en zijn persoonlijke instellingen downloaden en uitvoeren.
Update installeren:
Bij een nieuwe Profit Update moet je het PCC opnieuw installeren. Het is niet nodig om de oude PCC (van de vorige Update) eerst te deïnstalleren.
De beheerder installeert het PCC op de terminal server. De gebruikersinstellingen van de oude installatie worden automatisch overgenomen, de gebruikers hoeven de omgeving(en) niet opnieuw te koppelen.
Let op:
De beheerder hoeft de inrichting van Profit niet aan te passen.
Nadat je omgevingen geconverteerd zijn naar de volgende Update, installeert elke gebruiker het PCC.
- Log in op de terminal server.
- Als er een nieuwe installatie gevonden is, kun je deze automatisch bijwerken. Als het automatisch bijwerken is uitgeschakeld is of om een andere reden niet werkt, gebruik je de volgende stappen:
- Ga naar: Small Business / Uitvoer / Communication Center / Installatie opslaan.
- Voer het installatiebestand PccSetup uit (voor alle gebruikers).
- Zorg ervoor, dat het PCC automatisch wordt opgestart als een gebruiker inlogt op de terminal server.
Nieuwe installatie voor beheerder en gebruikers:
Gebruik deze procedure als je het PCC nog niet geïnstalleerd hebt op de terminal server.
De beheerder installeert het PCC. Elke gebruiker moet zijn eigen instellingen downloaden en installeren.
Installatie op terminal server door beheerder:
- Log in op de terminal server.
- Ga naar: Small Business / Uitvoer / Communication Center / Installatie opslaan.
- Voer het installatiebestand PccSetup uit (voor alle gebruikers).
- Zorg ervoor, dat het PCC automatisch wordt opgestart als een gebruiker inlogt op de terminal server.
Installatie per gebruiker:
- De gebruiker logt in op de terminal server.
- Open de omgeving die je in combinatie met het PCC wilt gebruiken.
- Ga naar: Small Business / Uitvoer / Communication Center / Instellingen opslaan.
- Sla het bestand op.
- Voer het instellingenbestand Settings.poci uit.
Snelkoppeling maken per gebruiker:
Als een gebruiker inlogt op de terminal server, zal het Profit Communication Center automatisch worden gestart. Als dit niet gewenst is, maak je een snelkoppeling per gebruiker.
- Log in op de terminal server als beheerder.
- Open de map:
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup
- Verwijder de snelkoppeling naar het Profit Communication Center. Hierdoor wordt het Profit Communication Center niet meer automatisch geladen per gebruiker.
- Voor elke gebruiker waarbij het Profit Communication Center wel automatisch moet worden gestart, neem je een snelkoppeling op in de volgende map:
C:\Users\[gebruikersnaam]\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup
Deze snelkoppeling moet verwijzen naar het volgende bestand:
C:\Program Files (x86)\AFAS Software\Profit Communication Center\Profit communication center.exe
Silent install Profit Communication Center via exe-bestand
Bij een silent install kan een systeembeheerder het Profit Communication Center via het netwerk installeren op meerdere systemen. Je gebruikt deze methode bijvoorbeeld om de PCC centraal uit te rollen op werkstations van gebruikers.
Installatiebestand
Je kunt het installatiebestand downloaden via Profit Windows.
Opdrachtregel / command prompt
Plaats het installatiebestand op een netwerkshare die voor alle systemen waarop je de installatie wilt uitvoeren, toegankelijk is. Het installatiebestand is geschikt voor installatie op 64-bits of 32-bits systemen.
Je start de installatie via een opdrachtregel. Hierbij maak je gebruik van de onderstaande opdrachtregelopties.
Voorbeeld van een opdrachtregel:
\\netwerk\share\PccSetup.exe /s /v/qn
Met deze opties voer je een 'silent install uit'. Hierbij wordt alleen het uitpakken van het exe-bestand getoond, er is geen actie van de gebruiker nodig.
Optie
|
Uitleg
|
/s
|
Verbergen van het initiële opstartscherm
|
/v
|
Parameters voor de installatie. Je kunt /qn gebruiken om de wizard en de voortgang te verbergen.
|
Na de installatie
Na de installatie downloadt elke gebruiker zelf zijn instellingen en voert deze uit op zijn werkstation.
PCC uitrollen via MSI-bestand
Het is ook mogelijk om de PCC met een MSI-installatiebestand te installeren.
Aandachtspunten:
- Bij installatie via een MSI-bestand wordt niet gecontroleerd op de aanwezigheid van de juiste versie van vereiste software, zoals .NET Framework en Visual Studio 2010 Tools for Office Runtime. Zorg dat aan de systeemeisen van de PCC voldaan is.
- Deze installatiemethode wordt (onder andere daarom) niet door AFAS ondersteund. Zijn er problemen met de PCC, de-installeer dan eventueel de aanwezige PCC-installatie en installeer de PCC via de normale methode Bedankt, om te controleren of het probleem dan ook speelt.
Hoe verkrijg je een MSI-bestand:
- Download het normale installatiebestand via Profit of InSite.
- Start de installatiewizard en wacht tot je (na de taalkeuze) de eerste keer voor Volgende of Next kan kiezen.
- Ga naar de Temp-map van je gebruiker (%temp%).
- In de Temp-map staat een nieuwe map met een naam zoals {23384BF6-6488-48C1-9346-DCFB65CC36AF}
- In die map staat het MSI-installatiebestand Profit Communication Center.msi.
Uitschakelen van het automatisch bijwerken van het PCC
Een gebruiker kan het PCC automatisch laten bijwerken, als er een nieuwe Update beschikbaar is. Het PCC zal in verschillende situaties controleren of er een nieuwe versie beschikbaar is. De gebruiker kan zelf bepalen wanneer hij het PCC bijwerkt.
De beheerder kan het automatisch bijwerken uitschakelen, bijvoorbeeld omdat applicaties altijd centraal worden uitgerold.
Dit kan via twee methoden, namelijk via een systeemvariabele of via Windows Registry.
Methode 1: Systeemvariabele toevoegen:
Hiervoor moet op de pc van de gebruiker de volgende Windows-omgevingsvariabele worden ingesteld:
- Open het Control Panel.
- Selecteer 'Advanced system settings'.
- Ga naar het tabblad: 'Advanced'
- Klik op: 'Environment Variables'.
- Klik op: 'New' (onder 'System variables').
- Vult de volgende gegevens in:
Variable name: AFASDISABLEPCCUPDATE
Variable value: 1
Methode 2: Via Windows Registry:
De systeemvariabele kan ook via het Windows Registry worden ingesteld. Dit kan handig zijn wanneer het geautomatiseerd en/of op veel installaties ingesteld moet worden.
- Open Windows Registry.
- Ga naar: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session manager\Environment.
- Maak zelf een nieuwe String Value (Tekenreekswaarde) aan.
- Stel deze als volgt in.
Zie ook:
Meldingen raadplegen via het logboek
Wanneer het PCC niet werkt, ontstaat er in veel gevallen een foutmelding. Elke foutmelding wordt weggeschreven in het logboek van het Profit Communication Center op de PC van de gebruiker. Met de informatie uit het logboek krijg je een beter beeld van het probleem. Hiermee kun je het probleem vaak oplossen, eventueel met hulp van je systeembeheerder.
Logboek openen:
Voer deze stappen uit op de PC van de gebruiker waarop het probleem zich voordoet.
- Start Windows Verkenner.
- Open de map %appdata%\Afas Software\OSCSettings.
- Open het logbestand Pcc.log.
Zie ook
