CustomerGate-instellingen in CustomerGate 365

De licentie bovenaan

Zolang de licentie aandacht vraagt, staat bovenaan CustomerGate-instellingen de regel Licentie: bij een lopende proefperiode, een naderende einddatum, een omgeving met een andere naam dan in de sleutel, of webservices die stilliggen. Kies de Licentiestatus om de pagina CustomerGate-licentie te openen. Met een geldige licentie staat die regel er niet. De actie Licentie opent dezelfde pagina.

Omgeving

Deze groep verschijnt alleen als er iets mis is. CustomerGate onthoudt in welke omgeving de instellingen in gebruik zijn genomen, en merkt het als het bedrijf daarna in een andere omgeving wordt gestart.

Omgevingsnaam

De Business Central-omgeving waarin deze instellingen het laatst in gebruik zijn genomen: bij de installatie, bij het aanmaken van een bedrijf of met Dit is de echte omgeving. Een gewone wijziging verandert dit veld niet, want anders zou één aangepaste instelling in een kopie de omgevingswacht al opheffen.

Deze omgeving

De omgeving waarin deze sessie draait, en of dat een productieomgeving of een sandbox is.

Omgevingswacht actief

Gaat aan zodra blijkt dat dit bedrijf een kopie in een sandbox is: er gaat geen e-mail meer uit en de mailtaak en de opruimtaak worden op Afwachten gezet. In een productieomgeving verschijnt alleen de waarschuwing; daar wordt met opzet niets uitgezet, want een live-omgeving stilleggen op basis van een vermoeden legt de website plat.

Dit is de echte omgeving legt de huidige omgeving vast als de echte en heft de blokkade op. Doe dat alleen als deze omgeving de live website bedient. Kies daarna ook Machtigingen herstellen: een kopie van een omgeving neemt de Entra-registraties en de webservices van de bronomgeving mee.

Nummering

Aanvraagnummers, Accountaanvraagnummers

De nummerreeksen voor webaanvragen en accountaanvragen. Na de installatie zijn dat WEBREQ (vanaf WEB000001) en WEBACCOUNT (vanaf ACC000001).

Privacy

Bewaartermijn (dagen)

Hoe lang persoonsgegevens bewaard blijven, gerekend vanaf de dag dat een aanvraag binnenkwam, niet vanaf de afhandeling. Standaard 365, minimaal 1. Houd deze termijn gelijk aan wat de privacyverklaring op uw website belooft.

Opruimen uitgeschakeld

Zorgt dat de opruimtaak niets wist, ook niet na de bewaartermijn. Een aparte schakelaar met een bevestigingsvraag en een rode waarschuwing, alleen bedoeld voor een korte test: zolang hij aanstaat, komt u de belofte in de privacyverklaring niet na.

Status opruimtaak

Of de taakwachtrijpost die persoonsgegevens opruimt, op Gereed staat. Staat hij op Afwachten, dan verloopt de bewaartermijn wel, maar wordt er niets gewist.

Wacht op opruiming

Hoeveel aanvragen hun bewaartermijn voorbij zijn en nog persoonsgegevens bevatten. Hier hoort nul te staan.

Laatste opruimronde, Opruimfouten laatste ronde, Laatste opruimfout

Wanneer de opruiming het laatst draaide, hoeveel stappen mislukten (die worden de volgende nacht opnieuw geprobeerd) en de eerste fout.

E-mail

E-mail voor meldingen

Het adres van de binnendienst voor meldingen van nieuwe aanvragen. Zonder adres gaat er geen melding uit.

Taal binnendienst

De taal van meldingen aan de binnendienst, en van e-mails aan een klant van wie de taal onbekend is.

Bevestigingsmail versturen, Meldingsmail versturen

Of aanvragers een bevestiging krijgen (in hun eigen taal, met het aanvraagnummer, sinds 1.0.44 het project, en de regels, zonder prijzen) en of de binnendienst een melding krijgt, waarin sinds 1.0.44 ook het project staat. Beide staan na de installatie aan.

Antwoordtermijn (werkdagen)

Binnen hoeveel werkdagen de bevestiging een antwoord belooft. Standaard 1. Belooft uw website ook een termijn, houd de twee dan gelijk.

Maximum mailpogingen

Hoe vaak de mailtaak een bericht opnieuw probeert voordat hij het opgeeft. Standaard 5.

Mailen vanaf

Aanvragen van vóór dit moment krijgen geen e-mail. Bij de installatie krijgt dit veld het tijdstip van installeren.

E-mailaccount

Of er een e-mailaccount is om mee te versturen, en of er een standaardaccount is. Zonder account mislukt elke e-mail van CustomerGate, ook die met aanmeldcodes.

Status mailtaak

Of de taakwachtrijpost die elke vijf minuten de e-mails verstuurt, op Gereed staat. Staat hij op Afwachten, dan gaat er niets uit.

Binnendienst

Reden van afwijzing verplicht

Of een aanvraag alleen kan worden afgewezen met een reden uit de lijst Redenen van afwijzing. Na de installatie staat dit uit: wie gedwongen wordt een reden te kiezen, kiest binnen een maand n.v.t.

Redenen van afwijzing

Hoeveel redenen er zijn ingericht en nog gekozen kunnen worden. Klik erop om de lijst te onderhouden.

Termijn dubbele aanvragen (uren)

Binnen hoeveel uur een tweede aanvraag met hetzelfde e-mailadres en dezelfde regels als dubbel telt. Binnen dezelfde termijn worden ook de aanvragen per afzender geteld. Standaard 24; nul zet beide uit. Een dubbele aanvraag wordt alleen gemarkeerd, nooit geweigerd.

Max. aanvragen per afzender

Hoeveel aanvragen van dezelfde IP-hash binnen die termijn nog normaal zijn. Boven dat aantal voegt de controle een signaal aan de score toe. Er wordt niets geblokkeerd: een druk bouwbedrijf achter één internetaansluiting is geen spam. Standaard 10.

Standaard klantensjabloon

Welk klantensjabloon Klant maken op een aanvraag voorstelt. Laat het leeg om elke keer uit de hele lijst te kiezen.

Orders via medewerker ingeschakeld

Of medewerkers orders kunnen insturen voor een klant die er zelf is, bijvoorbeeld iemand die de goederen in het magazijn komt ophalen. Zo'n aanvraag wordt een verkooporder in plaats van een offerte, mag elk artikel bevatten dat het bedrijf verkoopt en stuurt geen e-mail. Na de installatie staat dit uit: de tegels Orders via medewerker en het veld Medewerker zijn dan verborgen, en de website krijgt [VOA-StaffOrdersDisabled] als ze er toch een instuurt. Zet het alleen aan als uw medewerkers zo werken.

Demostand

Een demo-, oefen- of testbedrijf is bijna altijd een kopie van een echte omgeving, en op de klantenkaarten daarin staan echte e-mailadressen. Wie daar een aanvraag indient om te laten zien hoe het werkt, stuurt een bevestiging of een aanmeldcode naar een klant die niets heeft gevraagd.

Demostand

Leidt elk bericht van de app om: bevestigingen, meldingen aan de binnendienst, account-e-mails, de bevestiging van een akkoord en de aanmeldcode van het portaal. Ze gaan allemaal naar de demo-ontvanger, met [DEMO] voor het onderwerp en een eerste regel met het adres waar het bericht anders naartoe was gegaan.

Demo-ontvanger

Het adres waar alles naartoe gaat. Zonder dat adres wordt er helemaal niets verstuurd: dat is met opzet, want in plaats daarvan naar de klant sturen is precies wat deze schakelaar moet voorkomen. Elke poging komt dan als mislukt bericht op de aanvraag te staan, en de pagina meldt dat in het rood.

Demostand sinds

Wanneer de demostand is aangezet. Een demobedrijf dat al maanden mail omleidt, is meestal door iemand vergeten.

• Bij aanzetten vraagt de app om bevestiging, en bij uitzetten ook. Die tweede vraag is de belangrijkste: vanaf dat moment gaan de wachtende berichten naar echte adressen.
• De pagina en de tegels Webaanvragen op het rolcentrum tonen allebei een rode waarschuwing zolang de demostand aanstaat.
• De demostand verandert alleen iets aan de e-mail. Aanvragen, offertes, orders en akkoorden worden precies zo vastgelegd als anders; een demo die andere gegevens oplevert, bewijst niets.
• Een installatie of een update zet de demostand nooit aan of uit. Aan of uit is een keuze per bedrijf.

Klantenportaal

Portaaladres

Het adres waar klanten zich aanmelden, beginnend met https://. De e-mail over een goedgekeurde accountaanvraag verwijst ernaar; zolang het veld leeg is, meldt die e-mail dat het portaal binnenkort opengaat.

Portaalberichten ingeschakeld

De hoofdschakelaar voor de e-mails die het portaal automatisch stuurt over offertes, orders, verzendingen, facturen en aanvragen. Na een nieuwe installatie en na elke update staat hij uit. Staat hij uit, dan wordt er niets klaargezet en niets verstuurd, wat een portaalgebruiker ook heeft aangevinkt. Alleen aanzetten doet nog niets: elke portaalgebruiker zet daarna zelf in het portaal aan waarover hij e-mail wil krijgen.

Maximum aantal uitnodigingen per dag

Hoeveel collega's één portaalgebruiker met de rol Inkoper per dag mag uitnodigen. Een uitnodiging levert een accountaanvraag op die u zelf nog moet goedkeuren. Standaard 5; nul zet uitnodigen uit (er wordt dan niet teruggevallen op de standaardwaarde).

Portaaldocumenten uit rapporten

Of klanten in het portaal pdf's krijgen van hun offertes, orders, verzendingen, facturen en creditnota's, afgedrukt met uw Business Central-rapporten. Wordt alleen gebruikt waar het documentarchief van Steel 365 niet is geïnstalleerd. De instelling geeft het websiteaccount leesrechten op geboekte verkoopdocumenten via de tenant-machtigingenset VOA CG DOCUMENTS; zet haar uit als dat niet is toegestaan.

Maximum codepogingen

Hoeveel foute pogingen per aanmeldcode maximaal worden geteld, als spoor van misbruik. Het is geen blokkade: een code van tien tekens uit een set van tweeëndertig is in de praktijk niet te raden, en met een blokkade zou iedereen die het adres van een klant kent, die klant kunnen buitensluiten. Standaard 5.

Wachttijd aanmeldcode (sec.)

De minimale tijd tussen twee aanmeldcodes voor hetzelfde adres. Standaard 60. Nul heft de limiet op; gebruik dat alleen voor een test.

Sessieduur (min.)

Hoe lang een aanmelding geldig blijft als ze niet wordt gebruikt. Elke aanroep verlengt die termijn. Standaard 480.

Maximale sessieleeftijd (uren)

Wanneer een sessie uiterlijk eindigt, hoe actief ze ook wordt gebruikt. Standaard 168, dat is zeven dagen.

Webservice voaPortal

Of de webservice die het portaal aanroept, is gepubliceerd. Zo niet, dan mislukt elke aanmelding.

Basismachtigingen website

Of een account van de website ook D365 BASIC heeft. Dat mag niet: met die set kan het account klanten, contactpersonen, verkoopdocumenten en marges lezen.

Steel 365-module

Actief of Uit, afhankelijk van de vraag of iFacto Steel 365 in de omgeving is geïnstalleerd.

Documentarchief

Waar het portaal zijn documenten vandaan haalt. Aanwezig: iFacto DXSteel Doc Archive is geïnstalleerd en de pdf's komen uit het archief. Zonder archief staat er "Niet aanwezig - het portaal toont de pdf's uit de rapporten van Business Central" zolang Portaaldocumenten uit rapporten aanstaat (de standaardwaarde), en in geel "Niet aanwezig - het portaal toont geen documenten" als die schakelaar uitstaat.

Webcatalogus

Welke artikelen uw website mag zien, wordt hier bepaald en niet op de website. Eén keuze, één stand van zaken en één taak; de rest van de beslissing ligt bij de artikelen, hun categorieën en de publicatieregels. Zie Webcatalogus.

Alleen gemerkte artikelen publiceren

Uit betekent: elk artikel staat in de catalogus, behalve wat is uitgesloten. Aan betekent: een artikel staat er alleen in als het artikel zelf, zijn artikelcategorie of een publicatieregel dat zegt. Voor een nieuwe website is Aan de veiligere keuze. Het vinkje verandert de catalogus van de hele website en berekent meteen alles opnieuw.

Catalogusbeslissing

Of CustomerGate in dit bedrijf heeft berekend welke artikelen in de catalogus horen, en wanneer voor het laatst. Zolang hier staat dat dat nooit is gebeurd, weigeren de catalogusservices gegevens te leveren: een ongefilterde catalogus zou precies de artikelen publiceren die u hebt uitgesloten. Kies in dat geval Webcatalogus herberekenen.

Artikelen op de website

Hoeveel artikelen in de catalogus staan en hoeveel er bewust buiten blijven. Controleer dit vóór de livegang en klik door om per artikel te zien welke stap de doorslag gaf.

Maximale fotogrootte (MB)

De grootste artikelfoto die de catalogusservice aan de website doorgeeft. Een grotere foto staat wel in de lijst, met zijn grootte, maar zonder inhoud: de synchronisatie slaat hem over en meldt hem, in plaats van vast te lopen. Er wordt hier niets verkleind. Standaard 10.

Status catalogustaak

Of de taakwachtrijpost die de catalogus elke nacht herberekent, op Gereed staat. Hij is een vangnet en niet de motor: de catalogus wordt bijgewerkt zodra een artikel, een artikelcategorie of een regel verandert. Staat hij op Afwachten, dan wordt een gemiste wijziging pas hersteld als iemand de catalogus herberekent.

Bijlagen

Of aanvragers bestanden mogen meesturen, en waaraan die moeten voldoen. Zie Webaanvragen voor wat er met een bestand gebeurt.

Bijlagen ingeschakeld

Of de website bestanden bij een aanvraag mag uploaden. Staat dit uit, dan weigert de service elk bestand.

Maximale grootte bijlage (KB)

De grootste toegestane bijlage. De limiet wordt gecontroleerd op de lengte van de base64-tekst vóór het decoderen, en ook op de werkelijke bytes.

Toegestane soorten bijlagen

De bestandsextensies die zijn toegestaan, bijvoorbeeld pdf, dwg, dxf, step en de gangbare afbeeldingsformaten.

Maximum aantal bijlagen per aanvraag

Hoeveel bestanden er maximaal bij één aanvraag mogen horen.

Bijlagen kopiëren naar verkoopdocument

Of de bestanden bij het omzetten als documentbijlage meegaan naar de offerte of order. Daardoor kunnen meer mensen het bestand zien, en dat is een keuze van de klant.

Boven deze instellingen staat een weigerlijst in de code (exe, dll, js, vbs, ps1, bat, cmd, scr, msi, jar, sh, html, htm en svg) waar geen enkele instelling iets aan kan veranderen; de pagina waarschuwt een beheerder die dat probeert. Die lijst geldt voor elk deel van de bestandsnaam tussen de punten.

Sinds 1.0.44 hoeft de website deze instellingen niet te raden: voaPing geeft de waarden die in dit bedrijf gelden, met de standaardwaarden voor 0 ingevuld en met de weigerlijst, zodat het uploadformulier op de website precies toont wat Business Central accepteert. Een wijziging hier bereikt het formulier op de website dus de volgende keer dat de website ze leest, meestal als die opstart.

Machtigingen

Client-id website

De toepassings-id (client) van de Microsoft Entra-toepassing die de website gebruikt voor aanvragen en het klantenportaal.

Client-id synchronisatie

De toepassings-id (client) van de toepassing die de catalogus leest. Laat het leeg als de catalogus niet wordt gesynchroniseerd.

Tenant-machtigingensets

Of de tenant-machtigingensets van CustomerGate bestaan met precies de rechten die de app voorschrijft. Regels voor apps die niet in de omgeving zijn geïnstalleerd, worden overgeslagen en apart geteld.

Filter op het documentarchief

Alleen met het documentarchief van Steel 365: of het beveiligingsfilter het websiteaccount beperkt tot de toegestane archiefrubrieken.

Toewijzingen

Of beide toepassingen hun machtigingensets hebben. Voor de website moet Client-id website zijn ingevuld.

Webhooks

Webhooks werken in de andere richting: Business Central roept zelf een adres van uw website aan zodra er iets is gebeurd. Ze doen niets zolang niemand een abonnement heeft aangemaakt op Webhookabonnementen. Zie Webhooks.

Uitgaande HTTP-aanroepen

Of deze omgeving de app een adres buiten Business Central laat aanroepen. Zonder die toestemming blijven webhooks in de wachtrij staan en gaat er niets de deur uit. U zet het aan via Extensiebeheer, CustomerGate 365, Configureren, HttpClient-aanvragen toestaan.

Webhookbezorgtaak

Of de taakwachtrijpost die de webhooks bezorgt, draait. Net als de andere drie wordt hij met de status Afwachten aangemaakt; zolang hij die status heeft, worden gebeurtenissen wel klaargezet maar niet verstuurd.

Webhookmislukkingen voor uitschakelen

Na hoeveel mislukte pogingen op rij een abonnement zichzelf uitzet. Standaard 20. Een abonnement dat zichzelf heeft uitgezet, gaat nooit vanzelf weer aan: iemand moet het eindpunt nakijken en het abonnement met Aanzetten weer inschakelen.

Bewaartermijn webhooklogboek (dagen)

Hoeveel dagen bezorgde en gestrande bezorgingen op de lijst blijven staan. Er staan geen persoonsgegevens in, dus dit is onderhoud en geen bewaartermijn. Standaard 30.

Noodrem

Aanvragen weigeren

Laat de app tijdelijk nieuwe offerte- en accountaanvragen weigeren; de website krijgt dan een nette foutmelding. Het klantenportaal blijft werken.

De vier taakwachtrijposten

CustomerGate installeert vier taakwachtrijposten, alle vier met de status Afwachten. Het uploaden van een app hoort geen e-mail te versturen, geen gegevens te wissen, de catalogus van een website niet te veranderen en geen adres buiten Business Central aan te roepen. Bestaande posten voor deze codeunits worden nooit overschreven.

Beide taken aanzetten zet alleen de eerste twee aan. De knop weigert zolang Opruimen uitgeschakeld aanstaat of zolang er geen e-mailaccount is waarmee kan worden verstuurd.

Acties

Beide taken aanzetten

Zet de mailtaak en de opruimtaak op Gereed. Weigert zolang Opruimen uitgeschakeld aanstaat of zolang er geen e-mailaccount is waarmee kan worden verstuurd. Doe dit bij de livegang, zodra het e-mailaccount, het adres voor meldingen en de bewaartermijn kloppen. De catalogustaak en de webhookbezorgtaak zet u apart aan.

Machtigingen herstellen

Maakt de tenant-machtigingensets aan of corrigeert ze, stelt het archieffilter in en registreert beide toepassingen met hun machtigingensets. Hiervoor is SUPER nodig. Voer het uit na het invullen van een client-id, na het kopiëren van een omgeving, na het wijzigen van de archiefrubrieken, of als een regel onder Machtigingen niet in orde is. Business Central past gewijzigde rechten na een paar minuten toe.

Diagnose

Opent de pagina CustomerGate-diagnose: omgeving, versies, modules, de status van de taakwachtrijposten en van elke webservice, de aantallen per status, de voorvertoning van het opruimen en de verbindingstest. Met een rapport zonder persoonsgegevens dat u in een e-mail aan support kunt plakken. Zie Diagnose.

Ontbrekende machtigingen

Toont per object wat CustomerGate 365 in de tenant-machtigingensets verwacht naast wat er werkelijk is toegekend, en dan alleen de verschillen. Een afwijkende regel betekent meestal dat de set door een oudere versie van de app is geschreven.

Verbinding testen

Controleert per account waarmee de website zich aanmeldt, of de gebruiker bestaat en is ingeschakeld, of hij alle machtigingensets heeft, of de tenant-sets de versie hebben die deze app schrijft, of de webservices zijn gepubliceerd en of de inrichting compleet is. Het is alleen een controle; er wordt niets hersteld zonder dat eerst te vragen.

Opruimen vooraf bekijken

Toont wat de opruimtaak nu zou aanpakken: hoeveel offerteaanvragen, accountaanvragen, akkoorden, portaalgebruikers, aanmeldcodes en sessies hun bewaartermijn voorbij zijn, de oudste datum daarvan, en hoeveel er niet helemaal gewist kunnen worden omdat de tekst op een geboekt document staat. Er verandert niets.

Dit is de echte omgeving

Legt de huidige omgeving vast als de echte en heft de blokkade op uitgaande e-mail op, met een bevestigingsvraag die uitlegt wat dat betekent en een tweede vraag over de mailtaak en de opruimtaak die de omgevingswacht op Afwachten heeft gezet.

Instellingen exporteren, Instellingen importeren

Zetten de instellingen van dit bedrijf in een bestand en lezen ze weer in, bijvoorbeeld om een tweede bedrijf op dezelfde manier in te richten.

Webcatalogus herberekenen

Berekent in één keer opnieuw welke artikelen, varianten en artikelcategorieën op de website horen. Kan op elk moment veilig worden uitgevoerd: het verandert niets aan wat al klopt.

Webpublicatieregels, Artikelen op de website

Openen de regels waarmee u de catalogus stuurt, en het overzicht per artikel met de reden van de beslissing. Zie Webcatalogus.

Webhookabonnementen

Opent de abonnementen: welk adres bij welke gebeurtenis wordt aangeroepen, met het geheim waarmee de berichten worden ondertekend.

Redenen van afwijzing

Opent de lijst met redenen waarmee de binnendienst een aanvraag afwijst, en het bericht dat bij zo'n reden naar de aanvrager kan gaan.

Openstaande e-mails nu versturen

Voert de mailronde meteen uit, in plaats van pas bij de volgende keer dat de taakwachtrij loopt.

Persoonsgegevens nu opruimen

Voert de opruiming meteen uit, na een bevestiging.

Mailtaak, Opruimtaak, Catalogustaak, Webhookbezorgtaak

Openen de vier taakwachtrijposten.

E-mailaccounts

Opent de e-mailaccounts van Business Central, waar u ook aan elk CustomerGate-scenario een account kunt toewijzen.

Archiefrubrieken

Opent de archiefrubrieken. Alleen met het documentarchief van Steel 365.

Webaanvragen, Accountaanvragen, Portaalgebruikers

Openen de lijsten.