Assistant de configuration guidée

L'assistant Time Track Central Guided Setup connecte un nouvel environnement Business Central au backend de Time Track Central et l'alimente avec un peu de configuration d'exemple, afin d'avoir immédiatement de quoi travailler au lieu de partir d'un environnement vide.

Démarrer l'assistant

Business Central l'enregistre en tant qu'entrée de configuration assistée sous le groupe Connect, intitulée Time Track Central — « Connect to the Time Track Central frontend and import sample data. » Il apparaît normalement de lui-même la première fois que vous ouvrez l'extension.

Vous pouvez également le démarrer manuellement à tout moment :

• Recherchez (Tell Me, la loupe) Assisted Setup, ouvrez cette page, et sélectionnez Time Track Central sous Connect.
• Ou recherchez directement Time Track Central Guided Setup — le nom propre de la fenêtre de l'assistant.

Vous avez besoin d'une licence Time Track Central valide pour l'exécuter — un locataire sans licence est bloqué même pour l'enregistrement de l'assistant. Voir Licensing.

Parcours de l'assistant

L'assistant est un enchaînement linéaire d'étapes : Back est disponible à chaque étape sauf la première, Next à chaque étape sauf la dernière.

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. » Un lien Learn about this wizard in the help pages ouvre ce site de documentation. Choisissez Next pour commencer — rien à remplir pour l'instant.

2. General Information — un résumé en lecture seule de ce que vous êtes sur le point de connecter : Tenant ID (l'ID de locataire Entra de cette installation), Environment Name (par ex. Production ou le nom d'un bac à sable), et 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. » Il n'y a rien à modifier ici — si le locataire, l'environnement ou la société affichés sont incorrects, la seule solution est de fermer l'assistant et de le relancer depuis le bon environnement ou la bonne société Business Central.

3. Microsoft Entra Application (facultatif) — un seul champ, Entra Application (Client) ID. « Create an app registration in your Microsoft Entra tenant and enter its Application (client) ID below. » Cet ID identifie une inscription d'application unique que vous créez vous-même dans Microsoft Entra ID — dans le même locataire que celui où Business Central est enregistré — qui remplit un double rôle : elle sert à la fois pour la connexion de service à service entre l'API Business Central et le backend web de Time Track Central, et pour authentifier les utilisateurs Entra de votre organisation dans l'application web elle-même. Ce n'est pas quelque chose que Time Track Central vous fournit automatiquement. Un utilisateur sans l'ensemble d'autorisations Super qui saisit un ID ici reçoit une erreur lui demandant de faire exécuter cette étape par un administrateur — c'est un comportement attendu, pas un bug, car terminer cette étape accorde des ensembles d'autorisations à une application de service à service. Laisser le champ vide permet simplement de la sauter pour l'instant ; vous pourrez la compléter plus tard en relançant l'assistant, ou depuis l'action équivalente sur Time Track Central Setup.

   • Lorsque vous choisissez Next, l'assistant ajoute l'application à la page Microsoft Entra Applications de Business Central et lui attribue trois ensembles d'autorisations : D365 BASIC, PBOT ENTRA (la connexion Time Track Central de base), et PBOE ENTRA (gestion des notes de frais — attribué uniquement si l'extension Expense est installée). Si l'application figure déjà sur cette page, l'assistant la laisse ainsi que ses ensembles d'autorisations inchangés.
   • Cela ne suffit pas à terminer la tâche à lui seul. Ensuite, un administrateur Microsoft Entra doit encore ouvrir l'application sur la page Microsoft Entra Applications et choisir Grant Consent. Seul un administrateur Entra peut le faire. Si cette étape est ignorée, la connexion reste défectueuse même si cette étape de l'assistant a signalé une réussite.
   • Le certificat dont cette inscription d'application a besoin, et l'URI de redirection dont son côté connexion a besoin, sont tous deux configurés plus tard, dans l'étape Azure Entra de l'assistant du portail.

4. Portal Access — trois champs modifiables, préremplis pour gagner du temps : Name et Email (à partir du compte de l'utilisateur connecté), et Company Name (le nom d'affichage de la société — modifiez-le si le nom technique de la société Business Central n'est pas celui qui doit apparaître sur le portail). « This information is used by Time Track Central to give you access to the customer portal and follow up on your registration. » Vérifiez ces informations avant de continuer, en particulier l'adresse e-mail — c'est celle à laquelle l'e-mail de suivi de la dernière étape sera envoyé.

5. Basic setup — une case à cocher, Import Basic Setup, cochée par défaut. « 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. » Cela permet de l'exécuter en toute sécurité même sur une société partiellement configurée — les types de projets, règles d'heures supplémentaires ou codes de paie existants ne sont jamais écrasés, seules les tables encore vides sont remplies. Décochez la case pour ignorer entièrement les données d'exemple.

6. Final — « We have imported some sample data, however the Time Track Central website is not operational yet! » suivi de « 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. » Deux boutons apparaissent ici à la place de Next :

   • Close — ferme l'assistant.
   • Continue with setup — ferme l'assistant et ouvre directement Time Track Central Setup, pour les administrateurs qui préfèrent continuer la configuration plutôt que d'attendre l'e-mail du portail.

Terminer l'assistant n'équivaut pas à être opérationnel : l'e-mail du portail — comptez quelques minutes pour sa réception — est une étape suivante obligatoire pour terminer la configuration côté site web.

Configuration sur le portail

L'assistant Business Central ne vous mène qu'à mi-chemin — le reste de la connexion se termine dans votre navigateur, sur le portail Time Track Central lui-même, une fois l'e-mail « installation is ready » reçu.

Connexion

1. Ouvrez l'e-mail et suivez le lien de connexion.
2. Saisissez votre adresse e-mail. Le portail vous envoie par e-mail un code de connexion unique à 6 chiffres (valable 5 minutes) au lieu d'utiliser un mot de passe — saisissez-le pour vous connecter.
3. La connexion vous amène directement dans l'assistant de configuration propre au portail, pour la même société et le même environnement que ceux depuis lesquels vous venez de vous enregistrer sur Business Central.

Si l'adresse e-mail n'est pas déjà liée à une société Time Track Central existante sur le portail, vous pourriez arriver sur un écran Approval pending au lieu de l'assistant — un membre existant de cette société doit d'abord approuver votre accès, depuis sa propre page Company join requests. Vous recevrez un e-mail dans tous les cas une fois cette décision prise, et l'assistant de configuration devient disponible dès que vous êtes approuvé.

Parcours de l'assistant du portail

Cet assistant est également un enchaînement d'étapes, mais contrairement à celui de Business Central, chaque Next exécute réellement l'action de l'étape — réservation d'un sous-domaine, test d'une connexion, déclenchement d'un déploiement réel — et ne vous laissera pas continuer tant qu'elle n'aura pas réussi.

1. Welcome — nomme la société que vous configurez. Si votre licence inclut Work Reports (niveau Business ou Enterprise), une note confirme que son application d'approbation sera déployée en parallèle de votre instance principale.
2. Subdomain — choisissez où votre application web Time Track Central résidera (lettres minuscules, chiffres et traits d'union, au moins 3 caractères — utilisé comme {subdomain}.timetrackcentral.app) ; la disponibilité est vérifiée pendant la saisie. Si votre licence inclut l'application d'approbation Work Reports, vous choisirez également un second sous-domaine, distinct, pour celle-ci.
3. Azure Entra — renseignez le Client ID, l'Instance, le Tenant ID, l'Audience et les chemins de rappel pour l'inscription d'application que vous avez créée précédemment — la même que celle utilisée à la fois pour la connexion Business Central et la connexion à l'application web. Instance, Audience et Callback path reviennent aux valeurs standard de Time Track Central si laissés vides, et Tenant ID revient à l'ID de locataire de votre société. Générez un certificat, téléchargez-le, puis importez-le dans la liste des certificats de cette inscription d'application dans Entra. Enregistrez ensuite un URI de redirection correspondant sur la même inscription d'application — votre sous-domaine plus le chemin de rappel, par ex. https://{subdomain}.timetrackcentral.app/signin-oidc (valeur par défaut) — sinon la connexion à l'application web échouera. Utilisez Test connection pour confirmer avant de continuer ; cela nécessite que le certificat ait été généré au préalable.
4. Business Central — confirmez l'URL de base et la société BC pour la connexion (toutes deux préremplies à partir de ce que vous avez déjà saisi dans Business Central). Utilisez Test connection, qui dépend également du certificat généré à l'étape précédente — vous ne pouvez pas continuer tant qu'il n'a pas réussi.
5. Deploy — choisissez Next pour déployer. Cela peut prendre une minute ou deux, avec un indicateur de statut pour chaque instance en cours de création (votre instance principale, et l'instance de l'application d'approbation Work Reports si votre licence en inclut une).
6. Finalize — choisissez Complete pour terminer et accéder à votre nouveau tableau de bord Time Track Central.

L'extension Expense dispose de son propre assistant de configuration guidée distinct, couvrant les catégories de dépenses, les types de paiement et les véhicules de kilométrage — voir Expenses: Guided Setup.