Delphi ASP.NET Portal Starter Kit Setup 

Compatible Microsoft SQL Serveur et FireBird

 Pré-requis pour l'installation de Delphi ASP.NET Portal Starter Kit 

 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.
Associé à FireBird 1.5 l'utilisation de IBExpert offre une interface trés ergonomique.
Dans le cadre d'une étude comparative C#/Delphi, l'éditeur gratuit Microsoft ASP.NET WebMatrix est conseillé.
Un outils permettant de désassembler directement en langage "Delphi" peut aussi être utile.

 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
2- Problèmes d'accés au site web
3- Problèmes d'accés à la base de données
4- Tester l'accés des périphériques mobiles avec OpenWave 7 Simulator.
5- Compatibilité de configuration entre Delphi ASP.NET Portal Starter Kit et Microsoft Portal Starter Kit
6- Quelles sont les différences entre le produit de Z. Gajic et celui de ChapsAndChips ?
7- Evolution du produit
8- Hébergement ASP.NET & Delphi ASP.NET Portal Starter Kit
9- Services & Delphi ASP.NET Portal Starter Kit
10- Assistance & Contact

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