 |
Delphi ASP.NET Portal Starter Kit SetupCompatible Microsoft SQL Serveur et FireBird |
|
|
 Installation |
|
Base de données
alternative
|
|
FAQs
|
Pré-requis pour
l'installation de Delphi ASP.NET Portal Starter Kit
| Minimum requis pour tester le produit | Développement |
|
- Windows 2000, XP ou 2003 avec Microsoft .NET
1.1 minimum - Serveur Web : IIS ou Cassini - Base de Données : Microsoft SQL Serveur ou MSDE 2000 (gratuit) ou FireBird 1.5 (gratuit) et Firebird .NET Data Provider - Simulateur de périphérique mobile OpenWave 7.0 |
- Borland Delphi 8 .NET ou Borland Delphi 2005 |
|
Associé à SQL Serveur / MSDE 2000 l'interface web d'administration Web
Data Administrator est pratique. |
|
Installation
L'installation de l'application n'est pas automatique en raison de
la variété des composants (iis, cassini) et des différentes configurations (local,
serveur). Néanmoins l'installation est trés simple. Voici les étapes à suivre
:
Le compte avec lequel vous êtes connecté lors de l'installation du produit doit posséder
les droits d'administrateur.
|
Etape 1. Arborescence des fichiers |
Créer l'arborescence de l'application en décompressant le fichier zip dans le répertoire de votre choix. |
|
Etape 2. Arborescence Web |
Créer un répertoire virtuel pointant sur le sous-répertoire "DPSKWeb" du répertoire choisi à l'étape 1. |
|
Etape 3. Config Web |
Reporter ce nom de répertoire virtuel dans le fichier "Web.Config" (situé à la racine du répertoire virtuel) dans la section <add key="configFile" value="/<répertoire virtuel>/PortalCfg.xml"/> |
|
Etape 4. Base de données (au choix) |
SQL Serveur ou MSDE : créer la base via les scripts SQL disponibles dans le sous-répertoire "SetupDB". Ces scripts doivent-être éxécutés dans l'ordre dans lequel ils sont numérotés. Un seul des scripts "2-Portal_GrantPermissions_For<XXX>" en fonction du serveur local ou distant). Insérer le jeu de test dans la base de données : via le script SQL "3-Portal_LoadData.sql". |
|
FireBird : le fichier "Portal.fbk" correspond au backup de la base complète. |
|
|
Etape 5. Paramêtres de connection à la base |
Tester la connexion à la base de données en naviguant sur le site web (http://<choix2>).
Le paramêtre "ConnectionString" dans le fichier "Web.Config" configure l'accés ADO.NET à la base. Cette chaine doît correspondre au serveur SQL cible de votre installation. |
Base de données
alternative
Dans le ZIP contenant les sources du projet, la base de données
SQL Serveur n'est pas présente. Afin de mettre en oeuvre le projet avec ce
serveur, vous trouverez dans le projet initial les scripts de création de
la base SQL Serveur. Ce projet est en téléchargement à l'adresse suivante : http://www.asp.net/StarterKits/DownloadPortal.aspx.
L'accés à la base est effectué via ADO.NET. Il est ainsi possible de remplacer le serveur de base de données (SQL Serveur) par un autre serveur accessible via un autre provider ADO. Ce remplacement impose des répercutions mineures dans le code (remplacement de System.Data.SqlClient.SqlConnection par la nouvelle implémentation).
La chaine de connexion au serveur devra être modifiée. Le type de base utilisée est fixé dans le projet Delphi via une directive "DEFINE". "DEFINE SQLSERVEUR" permet d'obtenir une connection à SQL serveur sinon c'est FireBird qui est utilisé.
FAQs
1- Compte d'administrateur par défaut
Par défaut un seul compte utilisateur est référencé dans la base : l'utilisateur
"guest" avec comme mot de passe "guest". Une fois connecté, il est alors possible
de changer ce mot de passe dans le module d'administration.
2- Problèmes d'accés au site web
Conformément à l'étape 2 de l'installation l'adresse d'accés est http://<repertoirevirtuel>.
Il est nécessaire d'associer à ce site les paramêtres contenus dans le fichier "Portal.xml"
(étape 3).
La redirection sur la page correcte en fonction du périphérique est automatique
([Desktop/Mobile]Default.aspx). Afin de tester dans un environnement PC (Desktop)
la partie mobile il est nécessaire de contourner cette redirection automatique en
accédant directement à la page MobileDefault.aspx. Ceci permet par exemple via Microsoft
Internet Explorer d'invoquer les adapters html pour mobiles.
3- Problèmes d'accés à la base de données
Le paramêtre ConnectionString est
lié au type d'installation (local, distant) de la base. "server=pc;Trusted_Connection=true;database=Portal;"
est la chaine de connection fournit par Microsoft pour se connecter à SQL Serveur.
Ce paramêtre indique une authentification Windows intégrée.
Dans la version Delphi la chaine de connection "server=pc;database=Portal;uid=PortalUser;pwd=PortalUser;"
indique l'utilisation du serveur de base de données distant "pc" avec comme utilisateur
"PortalUser" (créé lors de la mise en place de la base distante "2-Portal_GrantPermissions_ForRemote.sql").
Voici un exemple de chaine de connection à FireBird est :
"Database=C:\\ibase\\Portal.GDB;User=SYSDBA;Password=masterkey;Dialect=3;Server=localhost"
Ces trois exemples de ConnectionString sont disponibles en commentaire
de la section "ConnectionString" du fichier "Web.Config".
Pour la version fonctionnant avec FireBird, l'assemblage "FirebirdSql.Data.Firebird.dll"
correspondant à Firebird
.NET Data Provider doit-être placé dans le répertoire "\bin".
4- Tester l'accés des périphériques mobiles avec OpenWave 7 Simulator.
Le fichier Web.Config comporte la section <system.web><sessionState
mode="inProc" cookieless="true" timeout="10">. Cette section indique au framework
de ne pas gérer la session via les cookies. Ce paramêtrage est nécessaire pour tester
l'accés des périphériques mobiles avec le simulateur OpenWave.
De plus il est nécessaire de reconfigurer la sécurité par défaut du site web.
L'authentification intégrée Windows n'étant pas supportée par OpenWave, il est nécessaire
de supprimer cette option au profit d'une authentification de base. A la connexion,
aprés cette modification, OpenWave proposera de saisir le compte et le môt de passe.
5- Compatibilité de configuration entre Delphi ASP.NET Portal Starter Kit et Microsoft Portal Starter Kit
Les configurations sont compatibles. Seuls les modules spécifiques aux
mobiles recencés dans la configuration de Delphi Starter Kit sont préfixés d'un "m".
Ainsi le module pour mobile "MobilesModules/Text.Ascx" dans la configuration de l'exemple
Microsoft doit-être remplacé par "MobilesModules/mText.Ascx" afin de correspondre
au module nouvellement implémenté en Delphi.
Dans la version utilisant FireBird quelques champs de la base de données
sont préfixés d'un "a" pour résoudre les conflits avec les mots clés (role, password...).
6- Quelles sont les différences entre le produit de Z. Gajic et celui de ChapsAndChips ?
Le produit Delphi ASP.NET Portal Starter Kit développé par ChapsAndChips est la stricte traduction du projet C# en Delphi. Volontairement dans la version 1.0 aucune amélioration n'est implémentée. La seule différence avec le produit initial est l'utilisation de FireBird ou Microsoft SQL Serveur. Par contre le produit de Z. Gajic implémente des corrections et évolutions. D'autres Starter Kits sont disponibles.
7- Evolution du produit
Les principales évolutions prévues sont :
- la mise en place des outils de sécurisation d'ASP.NET
- l'implémentation du rôle de modérateur dans la gestion de contenu
- l'implémentation nouveaux modules : moteur de recherche, aggrégation de services
via les Web Services...
- l'enrichissement de l'interface graphique : skin, onglets et cartographie...
8- Hébergement ASP.NET & Delphi ASP.NET Portal Starter Kit
Le portail Microsoft dédié à ASP.NET offre une liste d'hébergeur supportant ASP.NET. Il est à prévoir l'hébergement de la base de données dans les exigences.
9- Services & Delphi ASP.NET Portal Starter Kit
L'objectif principal de cette formation est de vous permettre de démarrer rapidement avec Delphi .NET en utilisant comme support le produit Delphi Portal Starter Kit. Le programme des formations est disponible sur simple demande. Ce programme est adaptable aux besoins spécifiques.
10- Assistance & Contact
Le contact pour l'assistance concernant le produit "Delphi ASP.NET Portal
Starter Kit" est pascal@chapsandchips.com.
© Pascal Chapuis - ChapsAndChips 2005