Begeleide installatiewizard

De wizard Time Track Central Guided Setup verbindt een nieuwe Business Central-omgeving met de Time Track Central-backend en voorziet deze van wat voorbeeldconfiguratie, zodat er direct iets is om mee te werken in plaats van te starten vanaf een lege omgeving.

De wizard starten

Business Central registreert dit als een Assisted Setup-item onder de groep Connect, met de titel Time Track Central — "Connect to the Time Track Central frontend and import sample data." Deze verschijnt normaal gesproken vanzelf de eerste keer dat u de extensie opent.

U kunt de wizard ook op elk moment handmatig starten:

• Zoek (Tell Me, het vergrootglas) naar Assisted Setup, open die pagina en selecteer Time Track Central onder Connect.
• Of zoek direct naar Time Track Central Guided Setup — de eigen naam van het wizardvenster.

U hebt een geldige Time Track Central-licentie nodig om deze uit te voeren — een tenant zonder licentie kan de wizard zelfs niet registreren. Zie Licensing.

De wizard doorlopen

De wizard is een lineaire stappenreeks: Back is beschikbaar op elke stap behalve de eerste, Next op elke stap behalve de laatste.

1. Welcome — "Before you can start using Time Track Central, we need some more information about this installation and setup the connection between the backend and your Business Central installation. This wizard will guide you through that process." Een link Learn about this wizard in the help pages opent deze documentatiesite. Kies Next om te beginnen — er hoeft nog niets ingevuld te worden.

2. General Information — een alleen-lezen overzicht van wat u gaat verbinden: Tenant ID (de Entra-tenant-ID van deze installatie), Environment Name (bijv. Production of een sandboxnaam), en Company Name. "If the information above is correct, you can continue to the next step. If not, close this wizard and restart it from the correct environment or company." Hier valt niets te bewerken — als de weergegeven tenant, omgeving of onderneming onjuist is, is het sluiten en opnieuw openen van de wizard vanuit de juiste Business Central-omgeving of -onderneming de enige oplossing.

3. Microsoft Entra Application (optioneel) — één veld, Entra Application (Client) ID. "Create an app registration in your Microsoft Entra tenant and enter its Application (client) ID below." Deze ID identificeert één enkele app-registratie die u zelf aanmaakt in Microsoft Entra ID — in dezelfde tenant waarin Business Central geregistreerd is — die een dubbele functie vervult: hij wordt zowel gebruikt voor de service-to-service-verbinding tussen de Business Central-API en de Time Track Central-webbackend, als voor het aanmelden van de Entra-gebruikers van uw organisatie bij de webapp zelf. Het is niet iets dat Time Track Central u automatisch verstrekt. Een gebruiker zonder de machtigingsset Super die hier een ID invoert, krijgt een foutmelding met het verzoek dit door een beheerder te laten uitvoeren — dit is verwacht gedrag, geen bug, aangezien het voltooien van deze stap machtigingssets toekent aan een service-to-service-applicatie. Als u het veld leeg laat, wordt deze stap voorlopig overgeslagen; u kunt het later alsnog invullen door de wizard opnieuw uit te voeren, of via de bijbehorende actie op Time Track Central Setup.

   • Wanneer u Next kiest, voegt de wizard de app toe aan de pagina Microsoft Entra Applications van Business Central en kent deze drie machtigingssets toe: D365 BASIC, PBOT ENTRA (de kernverbinding van Time Track Central) en PBOE ENTRA (kostenbeheer — alleen toegekend als de Expense extension is geïnstalleerd). Als de app al op die pagina staat, laat de wizard de app en de bijbehorende machtigingssets ongewijzigd.
   • Hiermee is de taak nog niet volledig afgerond. Daarna moet een Microsoft Entra-beheerder nog steeds de app openen op de pagina Microsoft Entra Applications en Grant Consent kiezen. Alleen een Entra-beheerder kan dit doen. Als dit wordt overgeslagen, blijft de verbinding verbroken, ook al meldde deze stap van de wizard succes.
   • Het certificaat dat deze app-registratie nodig heeft, en de redirect-URI die de aanmeldkant ervan nodig heeft, worden beide later ingesteld, in de Azure Entra-stap van de portalwizard.

4. Portal Access — drie bewerkbare velden, vooraf ingevuld om typewerk te besparen: Name en Email (van het account van de aangemelde gebruiker), en Company Name (de weergavenaam van de onderneming — wijzig dit als de technische Business Central-ondernemingsnaam niet is wat er op het portaal moet verschijnen). "This information is used by Time Track Central to give you access to the customer portal and follow up on your registration." Controleer deze gegevens voordat u verdergaat, vooral het e-mailadres — hier wordt de vervolgmail van de laatste stap naartoe gestuurd.

5. Basic setup — één selectievakje, Import Basic Setup, standaard aangevinkt. "Load a basic setup to get started quickly. The dataset contains some project types, a generic overtime setup and some payroll codes." "Data is only imported in empty tables. If a table is not empty (already contains a configuration), the table will be skipped." Hierdoor is het veilig om dit ook uit te voeren bij een gedeeltelijk geconfigureerde onderneming — bestaande projecttypes, overwerkregels of loonberekeningscodes worden nooit overschreven, alleen de nog lege tabellen worden gevuld. Vink het vakje uit om voorbeeldgegevens volledig over te slaan.

6. Final — "We have imported some sample data, however the Time Track Central website is not operational yet!" gevolgd door "Within a couple of minutes you will receive an email with a link to the Time Track Central portal, where we will guide you through setting up a subdomain and creating the service-to-service connection between Business Central and the website backend." Hier verschijnen twee knoppen in plaats van Next:

   • Close — sluit de wizard.
   • Continue with setup — sluit de wizard en opent direct Time Track Central Setup, voor beheerders die liever doorgaan met configureren dan te wachten op de portal-e-mail.

Het voltooien van de wizard is niet hetzelfde als live gaan: de portal-e-mail — reken op enkele minuten voordat deze aankomt — is een verplichte volgende stap om de installatie aan de websitekant af te ronden.

Instellen op het portaal

De Business Central-wizard brengt u slechts halverwege — de rest van de verbinding wordt voltooid in uw browser, op het Time Track Central-portaal zelf, zodra de e-mail "installation is ready" binnenkomt.

Aanmelden

1. Open de e-mail en volg de aanmeldlink.
2. Voer uw e-mailadres in. Het portaal stuurt u per e-mail een eenmalige, 6-cijferige aanmeldcode (5 minuten geldig) in plaats van een wachtwoord te gebruiken — voer deze in om aan te melden.
3. Na het aanmelden komt u direct in de eigen setupwizard van het portaal terecht, voor dezelfde onderneming en omgeving als waarmee u zich zojuist vanuit Business Central hebt geregistreerd.

Als het e-mailadres nog niet gekoppeld is aan een bestaande Time Track Central-onderneming op het portaal, komt u mogelijk terecht op een scherm Approval pending in plaats van de wizard — een bestaand lid van die onderneming moet uw toegang eerst goedkeuren, vanaf diens eigen pagina Company join requests. In beide gevallen ontvangt u een e-mail zodra die beslissing is genomen, en de setupwizard wordt beschikbaar zodra u bent goedgekeurd.

De portalwizard doorlopen

Ook deze wizard is een stapsgewijze flow, maar in tegenstelling tot die van Business Central voert elke Next daadwerkelijk de actie van die stap uit — het reserveren van een subdomein, het testen van een verbinding, het activeren van een echte implementatie — en laat u pas verder gaan als dit slaagt.

1. Welcome — noemt de onderneming die u instelt. Als uw licentie Work Reports omvat (Business- of Enterprise-tier), bevestigt een melding dat de goedkeuringsapp samen met uw hoofdinstantie zal worden geïmplementeerd.
2. Subdomain — kies waar uw Time Track Central-webapp zich bevindt (kleine letters, cijfers en koppeltekens, minstens 3 tekens — gebruikt als {subdomain}.timetrackcentral.app); de beschikbaarheid wordt gecontroleerd terwijl u typt. Als uw licentie de goedkeuringsapp van Work Reports omvat, kiest u ook een tweede, apart subdomein hiervoor.
3. Azure Entra — vul de Client ID, Instance, Tenant ID, Audience en callbackpaden in voor de app-registratie die u eerder hebt aangemaakt — dezelfde die zowel voor de Business Central-verbinding als voor het aanmelden bij de webapp wordt gebruikt. Instance, Audience en Callback path vallen terug op de standaardwaarden van Time Track Central als ze leeg gelaten worden, en Tenant ID valt terug op de tenant-ID van uw onderneming. Genereer een certificaat, download het en upload het naar de lijst Certificates van die app-registratie in Entra. Registreer vervolgens een bijpassende redirect-URI op dezelfde app-registratie — uw subdomein plus het callbackpad, bijv. https://{subdomain}.timetrackcentral.app/signin-oidc (de standaardwaarde) — anders zal het aanmelden bij de webapp mislukken. Gebruik Test connection om dit te bevestigen voordat u verdergaat; hiervoor moet het certificaat eerst gegenereerd zijn.
4. Business Central — bevestig de Base URL en de BC-onderneming voor de verbinding (beide vooraf ingevuld op basis van wat u al in Business Central hebt ingevoerd). Gebruik Test connection, die ook afhankelijk is van het certificaat dat in de vorige stap is gegenereerd — u kunt pas verdergaan als deze slaagt.
5. Deploy — kies Next om te implementeren. Dit kan één à twee minuten duren, met een statusindicator voor elke instantie die wordt aangemaakt (uw hoofdinstantie, en de instantie van de Work Reports-goedkeuringsapp als uw licentie er een omvat).
6. Finalize — kies Complete om af te ronden en naar uw nieuwe Time Track Central-dashboard te gaan.

De Expense extension heeft een eigen, aparte guided setup wizard voor kostencategorieën, betaaltypes en kilometervoertuigen — zie Expenses: Guided Setup.