Migration d'applications de XMLRAD 7 vers XMLRAD 8

Jean-Philippe BEMPEL

Traduit par Jean-Philippe BEMPEL de l'article de Kurt Crawford sur xmlrad.com. ♪

- Titre : Migration d'applications de XMLRAD 7 vers XMLRAD 8

- Auteur : Jean-Philippe BEMPEL

- Parution : 1 septembre 2004

- Mise à jour : 4 avril 2013

- Licence : Les sources présentées sur cette page sont libres de droits et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une œuvre intellectuelle protégée par les droits d'auteur. Copyright ® 2013 Jean-Philippe BEMPEL. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Installation XMLRAD8

- II. Au niveau du Projet

- III. Enregistrer le projet XMLRAD7 existant dans XMLRAD8

- IV. Pour les programmeurs Delphi

- V. Améliorations mineures

I - Installation XMLRAD8

Avant l'installation de XMLRAD8, vous devez désinstaller complètement XMLRAD7 en vérifiant que plus aucun fichier n'est présent dans le répertoire e-delos. Supprimez aussi vos cookies pour qu'ils n'interfèrent pas avec la nouvelle version de XMLRAD.
Pour une installation détaillée, lisez l'article XMLRAD : premier pas.

1. Vérifiez que votre application utilise le nouveau portail XMLRAD 8 situé dans C:\Program Files\e-delos\SharedPortal.
Vérifiez dans InitParams.xml que le paramètre XMLC_Portal contient la valeur SharedPortal.

2. Copiez tous les fichiers du Repository (C:\Program Files\e-delos\XMLRAD\Repository\Common\XML) dans votre répertoire XML principal.
Vérifiez que vous n'avez pas modifié les fichiers suivants : xslc.xsl, Common.xsl, Treeview.xsl, OutlookBar.xsl et Adm\FormError.xsl.

3. Si dans votre application, vous n'avez pas recompilé la DLL en utilisant Delphi, vous avez besoin de copier la nouvelle DLL du Repository (C:\Program Files\e-delos\XMLRAD\Repository\Common\Bin\IIS\XMLServer.dll par exemple) et renommez-la comme la DLL situé dans votre répertoire de projet.
Si dans votre application, vous avez recompilé votre DLL en utilisant Delphi, vous avez besoin de reconstruire votre DLL avec le nouveau framework. Pour faire cela, ouvrez votre projet dans Delphi et faites Projet | Tout construire.

4. Vous devez effacer vos cookies de vos anciennes applications pour avoir un affichage correct.

II - Au niveau du Projet

1. Vérifiez les fichiers de configuration InitParams et GlobalParams et comparez chacun d'eux avec ceux de la demo Pubs par exemple ou bien d'une nouvelle application.
Vous pouvez aussi vérifiez chaque paramètre en utilisant l'appendice 14 : InitParams and GlobalParams description, pour retirer les paramètres dépréciés.

2. Vous devez copier le fichier de configuration Profiles.xml à partir de C:\Program Files\e-delos\XMLRAD\Repository\Common\Config si vous voulez la nouvelle fonctionnalité des profils.

3. Conformez-vous à la nouvelle architecture des projets.
Vous devez déplacer tous les fichiers dans un sous répertoire Bin, tous les fichiers sources (fichiers .pas et .dfm) dans un répertoire Bin\Source.
Vérifiez que les alias IIS reflètent ces changements.
Vous pouvez laisser le fichier de projet (.dpr en Delphi) dans le répertoire Bin.
Vous pouvez renommer tous les fichiers de configuration en retirant le nom du projet et en mettant à jour tous les fichiers en conséquence.

III - Enregistrer le projet XMLRAD7 existant dans XMLRAD8

Mettre à jour un projet existant n'est pas nécessaire, vous pouvez toujours l'enregistrer en utilisant XMLRAD8 et continuer à travailler dessus comme d'habitude.

- Cliquez sur le lien « Register Project » à partir de la page d'accueil XMLRAD.

- Tapez le nom de votre projet, XMLRAD complètera automatiquement tous les champs nécessaires.

- Vérifiez chaque champ, en particulier les valeurs « Path » et « XML File ». Le mieux est d'utiliser l'explorateur Windows pour atteindre votre répertoire de projet et de copier/coller à partir de la barre d'adresse. Par exemple « C:\Program Files\Projects\MyTraining\ », c'est le chemin où est situé le fichier de configuration principal MyTrainig.xml et la DLL MyTrainig.dll.

- Vérifiez le chemin d'invocation avec attention. XMLRAD utilise l'alias ProjectsBin par défaut. Mettez à jour le chemin en fonction de votre configuration. Par exemple http://localhost/ProjectsBin/MyTraining/MyTraining.dll/

Si le chemin ou le fichier XML sont incorrects, XMLRAD affichera une erreur, car il ne trouvera pas le fichier de configuration principal.

Si le chemin d'invocation est incorrect, XMLRAD échouera pour invoquer l'application et générer les documents XML exemple. XSLStudio ne fonctionnera pas correctement.

IV - Pour les programmeurs Delphi

- L'objet TXMLContext a été renommé en TXMLHashMap. Si des données membres font référence à l'objet TXMLContext, elles doivent être changées en IXMLContext.

- Toutes données membres référencées en TXMLHashMap, doivent être déclarées en IXMLContext.

- L'interface IXMLCollectionEvents doit être changée par un composant XMLCollectionEvents sur un XMLModule. Les méthodes BeforeDispatch et AfterDispatch doivent être déplacées dans les gestionnaires d'événements BeforeDispatch et AfterDispatch du composant XMLCollectionEvents.

- Les valeurs Protected et Private de la propriété XMLComponent.Scope ne font plus référence à XMLC_SupervisorEmail et XMLC_SupervisorPassword mais à la portée interne pour la distribution http. Pour sécuriser un XMLComponent spécifique, vous devez utiliser les fonctions de sécurité à partir de XMLRAD.
Pour protéger l'accès aux actions de superviseur ou d'administrateur, vous avez besoin d'attacher des groupes à vos XMLServices à partir de l'interface XMLRAD.

- La méthode XMLRequest.CheckSupervisor est dépréciée et les développeurs ne doivent plus appeler cette méthode. À la place, utilisez le modèle intégré de sécurité.

V - Améliorations mineures

Si vous avez un serveur RTC spécifique ou un serveur MSN sur votre intranet, et que vous préférez l'utiliser à la place du switchboard MSN de Palo Alto messenger.hotmail.com vous pouvez surcharger les paramètres IM_Host et IM_Port dans le fichier InitParams.xml.