Hébergé par le portail Dynamics 365

Avant de commercer à héberger le Site Web d'événements personnalisé, effectuez les actions mentionnées dans la rubrique Conditions préalables. Le Site Web d'événements personnalisé est fourni en tant qu'application web hébergée sur le portail Dynamics 365 lorsque vous installez la solution Gestion d'événement.

La partie frontale de l'application est associée à deux fichiers de ressources qui sont stockés en tant que fichiers web sur le portail Dynamics 365, et le point d'entrée principal de l'application sur une seule page est stocké en tant que modèle web sur le portail Dynamics 365.

Bien que la définition de la partie frontale soit hébergée sur le portail de Dynamics 365, vous pouvez néanmoins la personnaliser entièrement. La partie dorsale de l'application Web n'est pas personnalisable, car les points de terminaison de l'REST API sont hébergés sur le portail de Dynamics 365 sous forme de pages Web, et parce que le code contenant la logique métier derrière celui-ci réside dans les plug-ins de Gestion d'événement qui ne sont pas personnalisables.

Hébergé sur le portail

Configuration de projet supplémentaire

Configuration de l'environnement

  1. Dupliquez le fichier de configuration environment.d365.ts situé dans le dossier \src\environments et nommez-le environment.ts.

  2. Ouvrez le fichier de configuration environment.ts dans l'environnement de développement de votre choix.

  3. Modifiez la variable apiEndpoint pour qu'elle pointe vers la valeur Liaisons du site Web.

    Liaison du site Web

    Notes

    Vous devez ajouter une barre oblique à la fin de l'URL.

  4. Assurez-vous que la variable useRestStack est définie sur false.

Développement local

Contournement CSRF

Vous devez ignorer le jeton anti-CSRF de développement local. Pour ce faire, accédez à Dynamics 365 > Portails > Modèles Web, ouvrez le modèle Web PortalAPI et basculez l'indicateur bypassTokenVerification sur true. Redémarrez les portails pour vous assurer que les paramètres sont appliqués.

Notes

Le modèle web PortalAPI est ajouté par défaut lorsque vous installez les données de Gestion d'événement.

Servir une page localement

Pour servir l'application en local, vous devez suivre les étapes ci-dessous :

  1. Ouvrez l'invite de commandes ou PowerShell.

  2. Exécutez la commande pour vous assurer que toutes les dépendances sont installées.

    npm install
    
  3. Exécutez la commande pour générer le fichier style.css

    ng build --prod --output-hashing none
    
  4. Exécutez la commande pour démarrer le serveur local de développement et voir les modifications immédiatement.

    ng serve
    

    Notes

    Vous trouverez plus d'informations sur le service local d'une application Angular ici Servir une application Angular localement

Déploiement

Vous devez remplacer les fichiers hébergés sous des portails. Cela peut être effectué à l'aide du script fourni, ou manuellement si un échec se produit pendant le processus automatique.

Notes

Vous n'avez pas besoin de modifier tous les fichiers, généralement les fichiers main.js et styles.css sont suffisants, mais il est toujours bon d'utiliser un outil de contrôle source pour effectuer le suivi des modifications.

Pour déployer l'application Angular personnalisée, exécutez le script PowerShell DeployToDynamics365Instance.ps1 situé sous le dossier Scripts. Le script construit l'application Angular, prépare les fichiers de sortie pour qu'ils conviennent à l'hébergement sous l'instance du portail Dynamics 365. Il prend les fichiers de localisation du dossier Localization et les prépare à l'hébergement. Il vous propose aussi de vous connecter à l'instance Dynamics 365 que vous souhaitez utiliser pour héberger votre application. Une fois que vous êtes connecté, il envoie les fichiers vers l'instance. Effacez le cache de votre navigateur (redémarrez IIS si vous utilisez l'instance Portails locale pour le développement) pour afficher les modifications.

Pour remplacer manuellement les fichiers dans Dynamics 365, procédez comme suit :

  1. Ouvrez votre instance Dynamics 365.
  2. Accédez à Dynamics 365 for Portals et cliquez sur Fichiers Web.
  3. Ouvrez le fichier Web styles.css.
  4. Cliquez sur l'onglet Notes et supprimez la pièce jointe existante.
  5. Téléchargez votre fichier styles.css situé dans le dossier dist/ClientApp comme pièce jointe.
  6. À présent, ouvrez main.es et cliquez sur l'onglet Notes et supprimez la pièce jointe existante.
  7. Convertissez le fichier Main.js en main.es situé dans le dossier dist/ClientApp.
  8. Chargez votre fichier main.es en tant que pièce jointe.
  9. Redémarrez le site Web du portail et rouvrez votre navigateur.

Configuration du partage de ressources cross-origin (CORS)

Si vous souhaitez servir le site Web d'événements personnalisé à partir d'un domaine personnalisé, vous devez configurer CORS pour autoriser ce domaine personnalisé. Pour ce faire,

  1. Accédez à Dynamics 365 > Dynamics 365 for Portals > Paramètres du site et cliquez sur Nouveau pour créer un enregistrement Paramètres du site.

  2. Insérer HTTP/Access-Control-Allow-Origin dans le champ Nom.

  3. Sélectionnez votre site Web.

  4. Ajoutez l'origine personnalisée devant être autorisée. Par exemple, si le site Web d'événements personnalisé est hébergé sur le domaine personnalisé https://contoso.com/, la valeur du champ doit être définie sur https://contoso.com/.

  5. Cliquez sur Enregistrer.

  6. Redémarrez les portails pour vous assurer que les paramètres sont appliqués.

    Nouveau paramètre de site pour autoriser « https://contoso.com/ » en tant que domaine personnalisé

    Notes

    Vous trouverez davantage d'informations sur CORS ici CORS Access-Control-Allow-Origin

Remplacer manuellement l'exemple de site Web

Si vous souhaitez remplacer l'exemple de site Web qui corresponde à la version de la gestion des événements que vous avez pour l'instant, consultez Remplacer manuellement l'exemple de site Web

Voir aussi

Localisation
Concevoir et héberger un portail d'événements personnalisé