ProLoc:Module Web
| Module Web |
ATTENTION! CE DOCUMENT N'EST PLUS EN VIGUEUR. CE DOCUMENT N'EST PAS APPLICABLE À LA VERSION 8 DE PROLOC.
Infrastructure
Avant de mettre en place vos modules web, il est important de bien comprendre l’infrastructure que vous désirez utiliser. Logilys vous fournit (inclus dans la BD ProLoc) des procédures SQL de consultation de certaines données pouvant être appelée à partir de pages web. Logilys fournit également des exemples (prototypes) fonctionnels de pages web (asp, aspx) utilisant ses procédures. Logilys n’assure pas la personnalisation et la mise en place des pages web dans votre infrastructure ; ceci doit être effectué par votre équipe (ou consultant) web.
Pour mettre en place le module web, il faut créer un lien entre votre serveur SQL (hébergeant les données de ProLoc) et votre serveur web. Il faut considérer l’emplacement physique de ces 2 serveurs pour des raisons de sécurité et de performance.
Dans le cas où votre serveur SQL et votre serveur Web sont à l’intérieur de la même infrastructure (réseau interne, intranet), les données SQL circuleront à l’interne et le résultat seulement sera affiché à l’externe (via le serveur web). C’est la solution la plus sécuritaire et la plus performante, car vous n’avez pas à ouvrir le port SQL (généralement 1433) afin qu’il soit accessible à l’externe.
Figure 1 : Serveur SQL et serveur Web à l'intérieur de la même infrastructure
Dans le cas où votre serveur SQL et votre serveur Web sont distants (ex : votre serveur SQL est dans vos locaux et votre serveur SQL chez un fournisseur de service), vous pouvez créer un lien sécurisé VPN entre votre serveur SQL et votre serveur Web afin que seulement une connexion sécurisée puisse accéder au port SQL (il est très dangereux d’ouvrir le port SQL afin qu’il soit accessible sur internet, à moins qu’il le soit à l’intérieur d’un canal sécurisé VPN). Cette solution est sécuritaire, mais vraiment moins performante, car beaucoup de trafic SQL circulera sur internet.
Figure 2 : Serveur SQL et serveur Web distant
Afin d’éviter ce problème de performance, nous suggérons l’établissement d’un mini-serveur web à l’interne qui n’hébergera que les pages Web pour ProLoc. Votre serveur web corporatif pourra être modifié pour y inclure un lien vers votre serveur web ProLoc.
Figure 3 : Établissement d'un mini-serveur web ProLoc
Définition des packages
A. Consultation des réservations
B. Consultation des disponibilités
C. Grille web
Définitions des fichiers
| Fichiers | Définition |
|---|---|
| Default.aspx Default.aspx.vb |
Écran d'accueil (Packages A,B et C) |
| Web.config | Fichier de configurations générales |
| Reservations.aspx Reservations.aspx.vb |
Sources pour l'écran de configuration des réservations (Package A) |
| Grille_Reservations.aspx Grille_Reservations.aspx.vb |
Sources pour l'écran de la grille de réservations (Package A) |
| Disponibilites.aspx Disponibilites.aspx.vb |
Sources pour l'écran de configuration des disponibilités (Package B) |
| Grille_Disponibilites.aspx Grille_Disponibilites.aspx.vb |
Sources pour l'affichage de la grille de disponibilités (Package B) |
| ProLocWeb.aspx ProLocWeb.aspx.vb |
Sources pour l'écran de configuration de la grille Web (Package C) |
| Grille_ProLocWeb.aspx Grille_ProLocWeb.aspx.vb |
Sources pour l'affichage de la grille Web (Package C) |
| App_Code\Functions.vb | Sources pour les fonctions globales (Package A,B et C) |
| App_Code\Dictionnaire.vb | Dictionnaire des en-têtes de colonnes (Package A et B) |
| App_LocalResources\.* | Dictionnaire de l'affichage de tous les écrans de configuration (Package A, B et C) |
| medias\.* | Toutes les images utilisées |
| res\css\Style.css | CSS de toutes les pages sauf les grilles. |
| res\css\Grille.css | CSS des grilles de réservations et de disponibilités (Package A et B) |
| res\javascript\datetimepicker_css.js | Sources pour le calendrier (Package A, B, C) |
| res\javascript\Dictionnaire_En.js res\javascript\Dictionnaire_Fr.js |
Dictionnaires des messages et du calendrier. |
| res\javascript\Functions.js | Sources pour l'affichage des grille en «pop-up» et des validations. |
Fichier de configuration «Web.config»
<appSettings>
<add key="C_Utilisateur" value="NomDeLaBD_Web"></add>
<add key="C_MotDePasse" value="NomDeLaBD_Web"></add>
<add key="C_BaseDeDonnee" value="NomDeLaBD"></add>
<add key="C_Serveur" value="InstanceSQL"></add>
<add key="C_NomClient" value="VotreNomOrganisme"></add>
<add key="C_IdLangueFr" value="0"></add>
<add key="C_IdLangueEn" value="1"></add>
</appSettings>
| Paramètres | Explications |
|---|---|
|
C_Utilisateur |
Nom de la BD* suivi de « _Web » (ex : ProLocLogilys_Web) |
|
C_MotDePasse |
Nom de la BD* suivi de « _Web » (ex : ProLocLogilys_Web) |
|
C_BaseDeDonnee |
Nom de la BD |
|
C_Serveur |
Instance du serveur SQL (ex : ServeurProLoc, ServeurSQL\InstanceProLoc)<o:p></o:p> Si vous éprouvez des problèmes, spécifier directement l’adresse IP et l’intance (s’il y a lieu) plutôt que le nom du serveur (ex : 192.168.0.1 ou 192.168.0.1\InstanceProLoc).<o:p></o:p> |
|
C_NomClient |
Sera affiché en haut à droite dans l'entête de chaque page. |
| C_NomClientURL | Vous pouvez entrer une URL qui s'ouvrira lorsque l'utilisateur cliquera sur le nom du client affiché en haut à droite (Vous devez spécifier le http://) |
|
C_IdLangueFr |
Par défaut = 0 |
|
C_IdLangueEn |
Par défaut = 1 |
Configuration de votre IIS (Internet Information Service)
Ces informations ne sont données qu’à titre d’exemple pour la configuration de votre serveur web (IIS). Le prototype à été développé et testé sous le framework 2.0 (ASP.NET).
- Vous devrez peut-être définir de la sécurité en lecture et en écriture à certains utilisateurs (ex : ASPNET, IUSR_NomduPoste ou "Network Service")
- Vous devez créer l’application nécessaire. Vous devez éditer les propriétés de votre dossier web afin de créer l’application.
- Vous devez également vous assurer que la configuration ASP.NET est conforme (version, chemin virtuel, emplacement du fichier de configuration).
- Vous devrez autoriser le "ASP.NET" dans les "Web Service Extensions" (accessible à partir de votre gestionnaire IIS).
- Certaines versions du IIS n'ont pas le "Web Service Extensions", il sera peut être nécessaire d'effectuer les actions suivantes si vous n'arrivez pas à afficher les pages .aspx.
- Aller à l'invite de commande avec des privilèges d'administrateur.
- Rendez-vous au répertoire d'installation du IIS, exemple : "CD\Windows\Microsoft.NET\Framework\v2.0.50727"
- Tapez "aspnet_regiis.exe -i -enable"
Annexes techniques (Non nécessaire si vous utilisez le module tel quel)
Consultation des réservations
Afin d’afficher les données sur une page web, 4 vues SQL (View) sont mises à votre disposition afin que vous puissiez les utiliser dans vos sources.
Définition des views :
- ViewWeb_Tpl (Permet d’afficher la liste des types de plateaux accessibles sur le web)
| Colonnes | Explications |
|---|---|
| Id (int) | Id du type de plateau |
| Type (varchar(100)) | Description du type de plateau |
- ViewWeb_Pla (Permet d’afficher la liste des plateaux accessibles sur le web)
| Colonnes | Explications |
|---|---|
| Id (int) | Id. du plateau |
| Plateau (varchar(100)) | Description du plateau |
| TplUID (int) | Id. du type de plateau |
- ViewWeb_Res (Permet d’afficher la liste des réservations)
| Colonnes | Explications |
|---|---|
| DateAffiche (varchar 10) | Date de la réservation au format « aaaa/mm/jj » |
| Début (varchar 5) | Heure de début au format « hh:mm » |
| Fin (varchar 5) | Heure de fin au format « hh:mm » |
| Activité (varchar 100) | Activité |
| Identification (varchar 255) | Identification |
| Plateau (varchar 100) | Description du plateau |
| Id (int) | Id du plateau |
| TotDate (int) | Affiche le total des réservations pour cette date pour ce plateau |
| TotDateAll (int) | Affiche le total des réservations pour cette date Peut-être utile pour faire du « rowspan » |
| Date (smalldatetime) | Date de la réservation en format date |
| Client (varchar 201) | Nom du client |
| TplUID (int) | Id du type de plateau |
Consultation des disponibilités
- ViewWeb_Tpl (Permet d’afficher la liste des types de plateaux accessibles sur le web)
Voir la définition des colonnes dans la section «Consultation des réservations»
- ViewWeb_Pla (Permet d’afficher la liste des plateaux accessibles sur le web)
Voir la définition des colonnes dans la section «Consultation des réservations»
- View_RapDis (Permet d'afficher la liste des disponibilités)
| Colonnes | Explications |
|---|---|
| ColIdentifiant (varchar 50) | Identifiant unique pour la session en cours |
| ColDate (smalldatetime) | Date de la disponibilité |
| ColDebut (smalldatetime) | Date / heure du début de la disponibilité |
| ColFin (smalldatetime) | Date / heure de la fin de la disponibilité |
| PlaUID (int) | Id du plateau |
| PlaCode (varchar 25) | Code du plateau |
| PlaDesc (varchar 100) | Description du plateau |
| DureeDispo (int) | Durée de la disponibilité (en minutes) |
| TotHeure (int) | Durée de la disponibilité (les heures seulement) |
| TotMinute (int) | Durée de la disponibilité (les minutes seulement) |
Définition de la procédure stockée :
sp_RapDis_Execute (Il faut appeler cette procédure avant d’afficher View_RapDis afin de générer les données)
| Paramètres | Explications |
|---|---|
| @Eidentifiant (varchar 50) | Identifiant unique pour la session en cours |
| @EleTpl (int) | Id du type de plateau (si on veut tous les plateaux du type) Ce paramètre n’a aucun effet si vous spécifiez un plateau différent de 0 dans @ElePla 0 = tous les types de plateaux |
| @ElePla (int) | Id du plateau (si on veut un plateau en particulier) 0 = tous les plateaux si @EleTpl = 0 sinon tous les plateaux du type spécifié par @EleTpl |
| @EdateDu (varchar 10) | Date de départ au format aaaa-mm-jj |
| @EdateAu (varchar 10) | Date de fin au format aaaa-mm-jj |
| @EheureDeb (varchar 5) | Heure de départ au format hh:mm |
| @EheureFin (varchar 5) | Heure de fin au format hh:mm |
| @ElaDuree (int) | Le nombre de minutes minimales désirées |
| @Lundi, @Mardi, @Mercredi, @Jeudi, @Vendredi, @Samedi, @Dimanche (tinyint) | 0 = Ne pas inclure, 1 = inclure Pour sélectionner tous les jours, mettre tous les paramètres de jours à 1 |
Exemples de requêtes SQL :
EXEC sp_RapDis_Execute @EIdentifiant = 'NomOrdi',
@EleTpl = 0,
@ElePla = 1,
@EDateDu = '2005-01-01',
@EDateAU = '2005-01-03',
@EHeureDeb = '08:00',
@EHeureFin = '12:00',
@ElaDuree = 60,
@Lundi = 1, @Mardi = 1, @Mercredi = 1,
@Jeudi = 1, @Vendredi = 1, @Samedi = 1,
@Dimanche = 1
/* Ensuite on peut faire un Select avec notre identifiant afin d'avoir le résultat */
Select * From View_RapDis Where ColIdentifiant = 'NomOrdi' Order by PlaUID, ColDebut
/* Ex 2: Disponibilité pour les plateaux de type GLACE (GLACE1 et GLACE2), du 1er au 2 janvier, de 13h00 à 17h00, pour 60 min */
EXEC sp_RapDis_Execute @EIdentifiant = 'NomOrdi',
@EleTpl = 1,
@ElePla = 0,
@EDateDu = '2005-01-01',
@EDateAU = '2005-01-02',
@EHeureDeb = '13:00',
@EHeureFin = '17:00',
@ElaDuree = 60,
@Lundi = 1, @Mardi = 1, @Mercredi = 1,
@Jeudi = 1, @Vendredi = 1, @Samedi = 1,
@Dimanche = 1
/* Ensuite on peut faire un Select avec notre identifiant afin d'avoir le résultat */
Select * From View_RapDis Where ColIdentifiant = 'NomOrdi' Order by PlaUID, ColDebut
Grille web
Afin d’afficher la grille sur une page web, 2 procédures stockées (stored procedure) sont mises à votre disposition afin que vous puissiez les utiliser dans vos sources VB.net ou autre.
Définition des procédures stockées :
- sp_WebListeGrilles_2 (Retourne la liste des grilles web)
Aucun paramètre. Cette procédure ne requiert aucun paramètre en entrée
Elle retourne un ensemble de données (ResultSet) du format suivant :
| Colonnes | Explications |
|---|---|
| IdGrille (int) | Id de la grille |
| NomGrille (varchar 50) | Description de la grille |
- sp_WebProduireGrille_2 (Retourne la recette pour générer la grille)
| Paramètres | Explications |
|---|---|
| @EIdentifiant (varchar 50) | Identifiant unique pour la session en cours |
| @IdGrille (int) | Id de la grille |
| @DateDemande (varchar 50) | Date demandée |
| @WebLngUID | 0 = Français, 1 = Anglais |
La procédure retourne 3 ensembles de données (resultset).
Le premier ensemble de données (1 enregistrement) contient la configuration générale de la grille (GrilleWebConfig) :
| Colonnes | Explications |
|---|---|
| GwIdUnique (varchar 50) | Identifiant unique pour la session en cours |
| GwcTitre (varchar 200) | Description de la grille |
| GwcHauteurLignes (tinyint) | Hauteur des lignes d’affichages (en pixels) |
| GwcLargeurHeure (tinyint) | Largeur d’une heure |
| GwcDivHeure (tinyint) | Division d’heures (0=15 min, 1=30 min, 2=60 min) |
| GwcHeureDebut (tinyint) | Heure de début pour l’affichage |
| GwcHeureFin (tinyint) | Heure de fin pour l’affichage |
| GwcGrandFormat (tinyint) | Affichage grand format (0=inactif, 1=actif) |
| * GwcPoliceNom (varchar 50) | Nom de la police de caractère |
| * GwcPoliceTaille (tinyint) | Taille de la police |
| * GwcPoliceStyle (tinyint) | Style (en binaire : 1=Bold, 2=Italique, 4=Souligné, 8=Barré) |
| * GwcPoliceCouleur (int) | Couleur de la police (RGB) |
| GwcCoulFondEtiquettes (int) | Couleur de fond de la section étiquettes (RGB) |
| GwcLargEtiquettes (int) | Largeur de la section étiquettes (en pixels) |
| GwcCoulFondDonnees (int) | Couleur de fond de la section réservations (RGB) |
* Affecte la police utlisée dans la section étiquettes.
Le deuxième ensemble de données contient la liste des étiquettes plateaux ou jours (GrilleWebEtiquettes) :
| Colonnes | Explications |
|---|---|
| GwIdUnique (varchar 50) | Identifiant unique pour la session en cours |
| GweIdLigne (int) | Numéro de la ligne |
| GweLibelle (varchar 200) | Libellé des plateaux ou des jours (peut contenir des retours de chariots) |
| GweTplUID (int) | Id du type de plateau |
| GweTplDesc (varchar 100) | Description du type de plateau |
| GwePlaUID (int) | Id du plateau |
| GwePlaDesc (varchar 100) | Description du plateau |
| GweDate (smalldatetime) | Date correspondant à la ligne actuelle |
Le troisième ensemble de données contient la liste des réservations (GrilleWebDonnees) :
| Colonnes | Explications |
|---|---|
| GwIdUnique (varchar 50) | Identifiant unique pour la session en cours |
| GwdIdLigne (int) | Numéro de la ligne |
| GwdTypeBloc (tinyint) | Type de bloc (0=réservations, 1=conflits, 2=inter-plateaux, 3=conflits inter-pla.) |
| GwdHeureDebut (varchar 5) | Heure de début au format hh:mm |
| GwdHeureFin (varchar 5) | Heure de fin au format hh:mm |
| GwdPosRelGauche (int) | Position gauche (à partir de la section étiquettes) (en pixels) |
| GwdPosRelHaut (int) | Position haut (à partir de la bande des heures) (en pixels) |
| GwdLongueur (int) | Longueur du bloc (en pixels) |
| GwdHauteur (int) | Hauteur du bloc (en pixels) |
| GwdTexte (text) | Texte du bloc |
| GwdPoliceNom (varchar 50) | Nom de la police de caractère |
| GwdPoliceTaille (tinyint) | Taille de la police |
| GwdPoliceStyle (tinyint) | Style (en binaire : 1=Bold, 2=Italique, 4=Souligné, 8=Barré) |
| GwdPoliceCouleur (int) | Couleur de la police (RGB) |
| GwdCoulFond (int) | Couleur de fond du bloc (RGB) |
| GwdTexteBulle (text) | Texte de l’info bulle |
| GwdTagDebut (tinyint) | Marque de dépassement à gauche (0=inactive, 1=active) |
| GwdTagFin (tinyint) | Marque de dépassement à droite (0=inactive, 1=active) |
| GwdResUID (int) | Id du contrat de réservations |
| GwdDetUID (int) | Id de la réservation |
Exemples de requêtes SQL :
exec sp_WebProduireGrille_2 @EIdentifiant = 'NomOrdi', @IdGrille = 1, @DateDemande = '2005/02/01', @WebLngUID = 0
GrilleWebConfig :
GrilleWebEtiquettes :
GrilleWebDonnees :
Nom du document : ProLoc:Module Web
Version : 7
