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.

Let op:

Bij een nieuwe Profit-versie kan het nodig zijn dat elke gebruiker het PCC bijwerkt naar de laatste versie. Je leest hier meer over in de releasenotes of de "Nieuw in Profit X" pagina's op de AFAS Klantportal.

Keuze tussen PCC of de AFAS invoegtoepassing

Het PCC kent verschillende toepassingen. Een van de toepassingen is het opslaan van e-mailberichten als dossieritem in Profit. Specifiek hiervoor moet je een keuze maken tussen de volgende oplossingen:

  • AFAS Add-in (invoegtoepassing) voor Outlook.

    Je gebruikt deze in web-gebaseerde Outlook-varianten die door AFAS ondersteund worden en in de nieuwe versie van Outlook die geinstalleerd is op een desktop.

    Door deze oplossing is het niet nodig een oude desktop-versie van Outlook in combinatie met het PCC te blijven gebruiken. Je kunt overstappen op een web-gebaseerde Outlook-variant of de nieuwe desktop-versie en de AFAS Add-in in gebruik nemen.

    Zie verder: E-mail in Office 365 inrichten en vastleggen als dossieritem

  • PCC voor de "oude" op een desktop geïnstalleerde Outlook

    Zie verder de informatie op deze helppagina.

Inhoud

  • Beschrijving
  • Systeemeisen
  • Versies van het pcc
  • App connector
  • InSite hoofdsite controleren
  • Terminal Server / Silent install
  • Meldingen raadplegen via het logboek
  • Zie ook

Beschrijving

Acties van de beheerder en van de gebruikers:

  • Profit

    Als beheerder richt je in Profit elke omgeving in die je in combinatie met het PCC wilt gebruiken.

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:

    AFAS volgt het officiële ondersteuningsbeleid van Microsoft voor Windows en Windows Server. Dit betekent dat AFAS wordt ondersteund op alle Windows- en Windows Server-versies die door Microsoft actief worden ondersteund. Zodra Microsoft de reguliere ondersteuning voor een besturingssysteem beëindigt, vervalt ook de ondersteuning door AFAS.

    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:

    1. Ga naar: Algemeen / Omgeving / Beheer / Eigenschappen.
    2. Ga naar het tabblad: PCC-instellingen.
    3. 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
    4. Vul het adres van de proxy in en eventueel de aanmeldgegevens.
    5. Klik op: Opslaan en sluiten.
  • 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 Office voor het bewerken van analyses, documenten (via de Documentgenerator) en van bijlagen (Word/Excel) bij dossieritems. Voor het raadplegen van een analyse is het PCC niet nodig.

Let op:

De onderstaande informatie over VSTO geldt TOT het PCC van Profit 6 (de versie van het PCC is 6.xx). Vanaf Profit 6 is een aparte installatie van VSTO niet meer nodig.

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.

Als VSTO niet geïnstalleerd is, dan kan bij de installatie van het PCC de volgende melding verschijnen: "Er is een fout opgetreden tijdens de installatie. Downloaden van file:///C:/Program Files (x86)/AFAS Software/Profit Communication Center//Afas.Profit.Office.DocGen.vsto is mislukt." Kijk dan of je VSTO handmatig kunt installeren.

Let op:

Het PCC werkt niet in Outlook, als het veld De nieuwste versie van Outlook uitproberen is aangevinkt.

Het PCC werkt niet in Outlook, als gebruik gemaakt wordt van een gedeelde mailbox.

Versies van het pcc

Profit 8

Er is een nieuwe versie van het PCC voor Profit 8. Je kunt het PCC downloaden via Profit of InSite, of via de Klantportal. Als je zelf installaties/wijzigingen op je pc mag uitvoeren, kun je het PCC zelf bijwerken. Het PCC van Profit 8 kan ook in Profit 7 gebruikt worden.

Het PCC voor Profit 6 en 7 kan ook voor Profit 8 gebruikt worden.

Profit 7

Bij Profit 7 is een nieuwe versie van het PCC voor Profit 7 uitgebracht.

Het PCC voor Profit 6 kan ook nog voor Profit 7 gebruikt worden. Ten opzichte van Profit 6 heeft het PCC van Profit 7 één wijziging: Als je een nieuw e-mailbericht verstuurt, dan zal het PCC proberen de contactpersoon in Profit te vinden op basis van het e-mailadres van de geadresseerde. De herkenning van het e-mailadres in Profit is verbeterd.

De nieuwe versie van het PCC is niet verplicht. Het PCC van Profit 1 kan nog gebruikt worden in combinatie met Profit 7.

PCC versie controleren

Om te controleren welke versie van het PCC je gebruikt, klik je met je rechtermuisknop op het PCC-pictogram en kies je voor Instellingen. Links onderin vind je de versie (zie afbeelding).

Veelgestelde vragen PCC

Moet de omgeving opnieuw gekoppeld worden aan het PCC na het updaten?

Nee het is niet nodig de omgevingen opnieuw te koppelen na het updaten van het PCC. Deze instellingen staan in het Windows gebruikersprofiel opgeslagen.

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:

  1. Open de omgeving die je wilt gebruiken in combinatie met het Profit Communication Center.
  2. Ga naar: Algemeen / Beheer / App connector.
  3. Open de eigenschappen van de app connector Profit Communication Center.
  4. Deblokkeer de app connector.
  5. Klik op: Opslaan en sluiten.
  6. 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 voor 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.

InSite hoofdsite controleren

Gebruikers kunnen de Setup van het PCC en de instellingen downloaden vanuit InSite of Profit. Als gebruikers deze bestanden downloaden vanuit Profit en je hebt een InSite-site, dan moet je de InSite-hoofdsite vastleggen.

Let op:

Als de omgeving geen InSite-site heeft, mag de InSite-hoofdsite niet zijn vastgelegd.

  1. Open de omgeving die je in combinatie met het PCC wilt gebruiken.
  2. Ga naar: Algemeen / Omgeving / Beheer / Eigenschappen.
  3. Ga naar het tabblad: Algemeen.
  4. Selecteer de site bij InSite hoofdsite.

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.

Wacht je tot je omgevingen geconverteerd zijn naar de volgende Update. Daarna installeert elke gebruiker het PCC (zie de methode hieronder).

  1. Log in op de terminal server.
  2. 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:
    1. Ga naar: Algemeen / Gebruiker / Communication Center / Installatie opslaan.
    2. Voer het installatiebestand PccSetup uit (voor alle gebruikers).
    3. 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:

  1. Log in op de terminal server.
  2. Ga naar: Algemeen / Gebruiker / Communication Center / Installatie opslaan.
  3. Voer het installatiebestand PccSetup uit (voor alle gebruikers).
  4. Zorg ervoor, dat het PCC automatisch wordt opgestart als een gebruiker inlogt op de terminal server.

Installatie per gebruiker:

  1. De gebruiker logt in op de terminal server.
  2. Open de omgeving die je in combinatie met het PCC wilt gebruiken.
  3. Ga naar: Algemeen / Gebruiker / Communication Center / Instellingen opslaan.
  4. Sla het bestand op.
  5. 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.

  1. Log in op de terminal server als beheerder.
  2. Open de map:

    C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup

  3. Verwijder de snelkoppeling naar het Profit Communication Center. Hierdoor wordt het Profit Communication Center niet meer automatisch geladen per gebruiker.
  4. 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 of via InSite.

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.
  • 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.

Er zijn twee methoden om een MSI-bestand te krijgen.

Methode 1:

  1. Download het normale installatiebestand via Profit of InSite.
  2. Start de installatiewizard en ga verder tot je bij Welkom bij de InstallShield Wizard voor Profit Communication Center komt.
  3. Ga naar de Temp-map van je gebruiker (%temp%).
  4. In de Temp-map staat een nieuwe map met een naam zoals {23384BF6-6488-48C1-9346-DCFB65CC36AF}
  5. In die map staat het MSI-installatiebestand Profit Communication Center.msi.

Methode 2:

Open een opdrachtprompt en voer de volgende command line uit.

C:\Temp\PccSetup.exe /s /x /b"C:\temp\extract" /v"/qn"

Het voorbeeld gaat ervan uit dat je PccSetup.exe in de map C:\Temp hebt gezet en dat je de command line vanuit deze map uitvoert. Pas de naam van PccSetup.exe eventueel aan naar de juiste naam.

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:

  1. Open het Control Panel.
  2. Selecteer 'Advanced system settings'.
  3. Ga naar het tabblad: 'Advanced'
  4. Klik op: 'Environment Variables'.
  5. Klik op: 'New' (onder 'System variables').
  6. 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.

  1. Open Windows Registry.
  2. Ga naar: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session manager\Environment.
  3. Maak zelf een nieuwe String Value (Tekenreekswaarde) aan.
  4. Stel deze als volgt in.

Zie ook:

  • Azure AutoPilot gebruiken om silent install van PCC te pushen als auto-uitrol (PDF)
  • Werken met thin client, VDI, Citrix of Terminal server / RDS

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.

  1. Start Windows Verkenner.
  2. Open de map %appdata%\Afas Software\OSCSettings.
  3. Open het logbestand Pcc.log.

Zie ook

  • Alle mogelijkheden van het PCC (overzicht)
  • Installatieprocedure meerdere omgevingen
  • Analyses, documenten, weergave-export en bijlagen direct openen
  • Beveiligingsinstellingen in Microsoft Excel vastleggen voor analyses
  • PCC deïnstalleren