Syntaxe des instructions d'Up ! 5GL Mixer

Up ! 5GL Mixer permet de combiner un ou de plusieurs composants en Up ! 5GL avec des ressources. Soit :

La ressource est maître et les composants sont esclaves.
La ressource est alors créée dynamiquement ou est animée.
A titre de comparaison, cela est similaire à :
- La production d'une page Hyper Text Markup Language (HTML) pour un navigateur Internet par un programme en Php.
- L'encapsulation de code en JavaScript dans une page Hyper Text Markup Language (HTML).
Le composant est maître et les ressources sont esclaves.
Le programme crée dynamiquement une ressource en évitant de coder certaines parties statiques de celle-ci par appel direct à des Application Program Interfaces (API).
A titre de comparaison, cela est similaire à :
- La production d'un document Pcl ou Postscript par un programme de Papyrus.
- L'appel à un fond de page Advanced Function Presentation (AFP) téléchargé dans l'imprimante.

Pour mémoire, nous vous rappellons que :

Les standards HyperText Markup Language (HTML) ou eXtended Markup Language (XML) version 1.0 ou 1.1 sont des applications particulières du standard Standard Generalized Markup Language (SGML).
Les flux conformes à ces standards comportent uniquement des données balisées. Ils correspondent à ce que Java Server Pages ou Php génèrent usuellement.
Ces standards sont gérés par le module Up ! Standard Generalized Markup Language d'Up ! Application System.
Le standard eXtended Markup Language (XML) version 2.0 est une refonte du standard Standard Generalized Markup Language (SGML).
Les flux conformes à ce standard utilisent notamment Xml Schema, Xml Path et Xml Query. Ils comportent des données balisées, un dictionnaire ainsi que du code sous forme de scripts Xml non balisés organisés en modules.
Ce standard est géré par le module Up ! eXtended Markup Language d'Up ! Application System.

Un fichier mixé a pour extension upx. Par exemple, un document de nom mondocument aura pour nom de fichier mondocument.upx.

Le fichier de code mixé doit être au moins accessible en lecture.

Syntaxe de la définition d'un mixage de programmes et de ressources

Syntaxe des éléments communs

Modules importés

ModulesImportes :

ImporterModule

ListeDeModulesImportes

ListeDeModulesImportes :

ModuleImporte

ListeDeModulesImportes

ModuleImporte

ModuleImporte :

NomDuModule

(

NomDeLInterface

ImporterDefinitions

LicenceDemandee

);

ImporterDefinitions :

, ImporterDefinitions

LicenceDemandee :

, LicenceExpresse

, LicenceStandard

, LicenceEntreprise

Accès aux définitions

TypeDAcces :

Public SuiteTypeDAcces :

Protege SuiteTypeDAcces :

Prive SuiteTypeDAcces :

SuiteTypeDAcces :

Lecture Public

Lecture Protege

D'une ressource en Up ! 5GL vers un programme en Up ! 5GL

Dans ce cas de figure la ressource est maître et les composants sont esclaves.

Un seul composant peut être encapsulé dans la ressource. Cependant, celui-ci peut faire appel à des modules externes.

Definitions globales du programme

Il est possible d'importer des modules, de déclarer des constantes, des énumérés, des types, des procédures, des fonctions, etc. qui vont être utilisés par le ou les composants animant dynamiquement la ressource en Up ! 5GL.

MixerDefinitionsProgramme :

DefinitionsProgramme

SignatureDuProgramme

ModulesImportes

DeclarationsGlobales

ListeDeProceduresOuDeFonctions

Fin DefinitionsProgramme

Expression

La valeur d'une propriété d'un objet d'une ressource peut être calculée dynamiquement au moyen d'une epression en Up ! 5GL. Cette expression peut faire appel aux déclarations globales du programme préalablement définies.

MixerExpression :

Expression (

Expression

)

Instructions

Le contenu d'une ressource peut être produit dynamiquement au moyens d'instructions en Up ! 5GL. Ces instructions peuvent faire appel aux déclarations globales du programme préalablement définies.

MixerInstructions :

Instructions

ListeDInstructions

Fin Instructions

Fonctions de rappels

Les composants ou les déclarations globales peuvent nécessiter une initialisation ou une terminaison particulière.

MixerRappels :

Rappels

ListeDeMethodesDeRappel

Fin Rappels

D'une ressource en Standard Generalized Markup Language (SGML) ou eXtended Markup Language (XML) vers un programme en Up ! 5GL

Dans ce cas de figure la ressource est maître et les composants sont esclaves.

Une seule ressource par type peut être encapsulée dans le programme. Cependant, celles-ci peut faire appel à des ressources externes.

Definitions globales du programme

MixerDefinitionsProgramme :

<?UpsMxr:DefinitionsProgramme

SignatureDuProgramme

ModulesImportes

DeclarationsGlobales

ListeDeProceduresOuDeFonctions

?>

Expression

MixerExpression :

<?UpsMxr:Expression

Expression

Instructions

MixerInstructions :

<?UpsMxr:Instructions

ListeDInstructions

?>

Fonctions de rappels

Les composants ou les déclarations globales peuvent nécessiter une initialisation ou une terminaison particulière.

MixerRappels :

<?UpsMxr:Rappels

ListeDeMethodesDeRappel

?>

D'un programme en Up ! 5GL vers une ressource en Up ! 5GL, Sgml ou Xml

Dans ce cas de figure le composant est maître et les ressources sont esclaves.

Definitions globales des ressources

Il est possible d'importer des modules, de déclarer des couleurs, des pinceaux, des brosses, des styles, des cellules, des paragraphes, des pages, etc. qui vont être utilisés par programme en Up ! 5GL.

MixerDefinitionsRessources :

DefinitionsAnnuaire

SignatureDeLAnnuaire

ModulesImportes

DeclarationsAnnuaires

Fin DefinitionsAnnuaire

DefinitionsAnnuaireElectronique

SignatureDeLAnnuaireElectronique

ModulesImportes

DeclarationsAnnuairesElectroniques

Fin DefinitionsAnnuaireElectronique

DefinitionsDocument

SignatureDuDocument

ModulesImportes

ListeDeProprietesDocument

DeclarationsDocuments

Fin DefinitionsDocument

DefinitionsEchange

SignatureDeLEchange

ModulesImportes

DeclarationsEchanges

Fin DefinitionsEchange

DefinitionsImage

SignatureDeLImage

ModulesImportes

DeclarationsImages

Fin DefinitionsImage

DefinitionsSecurite

SignatureDuProfilDeSecurite

ModulesImportes

DeclarationsSecurite

Fin DefinitionsSecurite

DefinitionsStyle

SignatureDeLaFeuilleDeStyles

ModulesImportes

DeclarationsStyles

Fin DefinitionsStyle

DefinitionsSgml

DefinitionsSgml

Fin DefinitionsSgml

DefinitionsXml

DefinitionsXml

Fin DefinitionsXml

Contenu de la ressource

MixerContenu :

Annuaire

NomDeLAnnuaire

InstructionsAnnuaire

Fin Annuaire

AnnuaireElectronique

NomDeLAnnuaireElectronique

InstructionsAnnuaireElectronique

Fin AnnuaireElectronique

Document

NomDuDocument

InstructionsDocument

Fin Document

Echange

NomDeLEchange

InstructionsEchange

Fin Echange

Image

NomDeLImage

InstructionsImage

Fin Image

Securite

NomDuProfilDeSecurite

InstructionsSecurite

Fin Securite

Style

NomDeLaFeuilleDeStyles

InstructionsStyle

Fin Style

Sgml

ContenuEnSgml

Fin Sgml

Xml

ContenuEnXml

Fin Xml

Référence des mots-clés utilisables dans un mixage de programmes et de ressources

Annuaire AnnuaireElectronique
DefinitionsAnnuaire DefinitionsAnnuaireElectronique DefinitionsDocument DefinitionsEchange DefinitionsImage DefinitionsProgramme DefinitionsSecurite DefinitionsSgml DefinitionsStyle DefinitionsXml Document
Echange Expression
Image
ImporterDefinitions Instructions ImporterModule
Lecture LicenceEntreprise LicenceExpresse LicenceStandard
Prive Protege Public
Rappels
Securite Sgml Style
Xml

Exemple de mixage de programmes et de ressources

Production d'un document en Up ! Document

Document maître et composant esclave


Source Document "Exemple d'emploi d'Up ! 5GL Mixer et Up ! Document" Version 4.0.0;



DefinitionsProgramme

/******************/

Source Composant "Exemple d'emploi d'Up ! 5GL Mixer et Up ! Document" Version 4.0.0;



ImporterModule

/************/

   UpsQry(<UpsQry.upi>);

   UpsOra(<UpsOra.upi>);



ConnexionSql

/**********/

   MaConnexionSql(Oracle, "scott/tiger");

RequeteSql

/********/

   MaRequeteSql ConnexionSql MaConnexionSql
	
      ResultatSql(NomEmploye : Nul Ou Caractere TailleMaxSql 20, DateEmbauche : Nul Ou Date, Salaire : Nul Ou Reel)

      TailleTableauResultatSql 5

      ParametreSql(NumeroDepartement : Entier)
 
      SqlStatique
				
         SELECT ename:=${NomEmploye}, hiredate:=${DateEmbauche}, sal:=${Salaire}
 
         FROM emp
 
         WHERE deptno=${NumeroDepartement}; 
		
	

Fin DefinitionsProgramme



Debut

Section

 
   PageA4;

   OrientationPortrait;

   MargeHaute 3;

   MargeBasse 3;

   MargeGauche 5;

   MargeDroite 5;

	

   EnteteDePage

   Hauteur 2;

   Espace 2;

   Fin EnteteDePage

	

   PiedDePage

   Hauteur 2;

   Espace 2;

   Fin PiedDePage

	

   Debut

   Page
	
      EnteteDePage

      /**********/

      Debut

      Paragraphe
		
         Hauteur 2;

         Espace 1;

         CadreBas CadreSimple;
      
		Debut
		
         Texte "Titre du document"; 
      
		Fin Paragraphe

      Fin EnteteDePage

		

      Corps

      /***/

      Debut
		
         Tableau

         Debut
			
            Ligne
				
               Cadre CadreDouble;
            
				Debut
				
               Cellule
					
                  Largeur 25;

                  AlignementHorizontalContenu Centre;
               
					Debut
					
                  Texte "Nom de l'employé"+Gras; 
               
					Fin Cellule

               Cellule
					
                  Largeur 25;

                  AlignementHorizontalContenu Centre;
               
					Debut
					
                  Texte "Date d'embauche"+Gras; 
               
					Fin Cellule

               Cellule
					
                  Largeur 12;

                  AlignementHorizontalContenu Centre;
               
					Debut
					
                  Texte "Salaire"+Gras; 
               
					Fin Cellule
				
            Fin Ligne

				

            Instructions
				
               RequeteSql MaRequeteSql
					
                  ResultatSql(NomEmploye : Nul Ou Caractere TailleMaxSql 20, DateEmbauche : Nul Ou Date, NumeroEmploye : Nul Ou Entier, Salaire : Nul Ou Reel)

                  ParametreSql(10);

                  Document
						
                     Ligne
							
                        CadreGauche CadreSimple;

                        CadreDroit CadreSimple;
                     
							Debut
							
                        Cellule
								
                           Largeur 25;
                        
								Debut
								
                           Texte Expression(NomEmploye.Majuscule()); 
                        
								Fin Cellule

                        Cellule
								
                           Largeur 25;
                        
								Debut
								
                           Texte Expression(Caractere(DateEmbauche, "%jj/%mm/%aaaa")); 
                        
								Fin Cellule

                        Cellule
								
                           Largeur 12;

                           AlignementHorizontalContenu Droite;
                        
								Debut
								
                           Texte Expression(Caractere(Salaire, "&&&.&&#,##")); 
                        
								Fin Cellule
                     
							Fin Ligne
						
                  Fin Document
               
					Fin RequeteSql
				
            Fin Instructions
			
         Fin Tableau
		
      Fin Corps

		

      PiedDePage

      /********/

      Debut
		
         Paragraphe
			
            Hauteur 2;

            Espace 1;

            CadreHaut CadreSimple;
         
			Debut
			
            Texte "Page 1"; 
         
			Fin Paragraphe
      
		Fin PiedDePage
 
      Fin Page
		
   Fin Section
	
Fin Document

Document esclave et composant maître


Source Document "Exemple d'emploi d'Up ! 5GL Mixer et Up ! Document" Version 4.0.0;



ImporterModule

/************/

   UpsQry(<UpsQry.upi>);

   UpsOra(<UpsOra.upi>);



ConnexionSql

/**********/

   MaConnexionSql(Oracle, "scott/tiger");

RequeteSql

/********/

   MaRequeteSql ConnexionSql MaConnexionSql
	
      ResultatSql(NomEmploye : Nul Ou Caractere TailleMaxSql 20, DateEmbauche : Nul Ou Date, Salaire : Nul Ou Reel)

      TailleTableauResultatSql 5

      ParametreSql(NumeroDepartement : Entier)
 
      SqlStatique
				
         SELECT ename:=${NomEmploye}, hiredate:=${DateEmbauche}, sal:=${Salaire}
 
         FROM emp
 
         WHERE deptno=${NumeroDepartement}; 
		
	



DefinitionsDocument

/*****************/

Source Document "Exemple d'emploi d'Up ! 5GL Mixer et Up ! Document" Version 4.0.0;

Fin DefinitionsDocument



Principal

/*******/

Debut

Document

Section

 
   PageA4;

   OrientationPortrait;

   MargeHaute 3;

   MargeBasse 3;

   MargeGauche 5;

   MargeDroite 5;

	

   EnteteDePage

   Hauteur 2;

   Espace 2;

   Fin EnteteDePage

	

   PiedDePage

   Hauteur 2;

   Espace 2;

   Fin PiedDePage

	

   Debut

   Page
	
      EnteteDePage

      /**********/

      Debut

      Paragraphe
		
         Hauteur 2;

         Espace 1;

         CadreBas CadreSimple;
      
		Debut
		
         Texte "Titre du document"; 
      
		Fin Paragraphe

      Fin EnteteDePage

		

      Corps

      /***/

      Debut
		
         Tableau

         Debut
			
            Ligne
				
               Cadre CadreDouble;
            
				Debut
				
               Cellule
					
                  Largeur 25;

                  AlignementHorizontalContenu Centre;
               
					Debut
					
                  Texte "Nom de l'employé"+Gras; 
               
					Fin Cellule

               Cellule
					
                  Largeur 25;

                  AlignementHorizontalContenu Centre;
               
					Debut
					
                  Texte "Date d'embauche"+Gras; 
               
					Fin Cellule

               Cellule
					
                  Largeur 12;

                  AlignementHorizontalContenu Centre;
               
					Debut
					
                  Texte "Salaire"+Gras; 
               
					Fin Cellule
				
            Fin Ligne

				

            Instructions
				
               RequeteSql MaRequeteSql
					
                  ResultatSql(NomEmploye : Nul Ou Caractere TailleMaxSql 20, DateEmbauche : Nul Ou Date, NumeroEmploye : Nul Ou Entier, Salaire : Nul Ou Reel)

                  ParametreSql(10);

                  Document
						
                     Ligne
							
                        CadreGauche CadreSimple;

                        CadreDroit CadreSimple;
                     
							Debut
							
                        Cellule
								
                           Largeur 25;
                        
								Debut
								
                           Texte Expression(NomEmploye.Majuscule()); 
                        
								Fin Cellule

                        Cellule
								
                           Largeur 25;
                        
								Debut
								
                           Texte Expression(Caractere(DateEmbauche, "%jj/%mm/%aaaa")); 
                        
								Fin Cellule

                        Cellule
								
                           Largeur 12;

                           AlignementHorizontalContenu Droite;
                        
								Debut
								
                           Texte Expression(Caractere(Salaire, "&&&.&&#,##")); 
                        
								Fin Cellule
                     
							Fin Ligne
						
                  Fin Document
               
					Fin RequeteSql
				
            Fin Instructions
			
         Fin Tableau
		
      Fin Corps

		

      PiedDePage

      /********/

      Debut
		
         Paragraphe
			
            Hauteur 2;

            Espace 1;

            CadreHaut CadreSimple;
         
			Debut
			
            Texte "Page 1"; 
         
			Fin Paragraphe
      
		Fin PiedDePage
 
      Fin Page
		
   Fin Section
	
Fin Document

Fin Principal

Production d'un document en Standard Generalized Markup Language (SGML)

Document maître et composant esclave


<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<!-- ------------------------------------------------------------------- -->

<!-- Fichier    : exemple2.upx                                           -->

<!-- Objet      : Exemple d'emploi d'Up ! Mixer et Up ! Sgml pour du Html. -->

<!--                                                                     -->

<!--  Module      : Up ! Application System.                             -->

<!--  Auteur-Date : DUVAL Jean-Pierre - Novembre 2006.                   -->

<!-- ------------------------------------------------------------------- -->

<!--                           Observations                              -->

<!--                                                                     -->

<!--                                                                     -->

<!-- ------------------------------------------------------------------- -->

<HTML>

<HEAD><TITLE>Liste des employés</TITLE></HEAD>



<?UpsMxr:DefinitionsProgramme

Source Composant "Exemple d'emploi d'Up ! Xml et Up ! Sgml pour du Html" Version 4.0.0;



ImporterModule

/************/

   UpsQry(<UpsQry.upi>, ImporterDefinitions);

   UpsOra(<UpsOra.upi>, ImporterDefinitions);



ConnexionSql

/**********/

   MaConnexionSql(Oracle, "scott/tiger");



RequeteSql

/********/

   MaRequeteSql ConnexionSql MaConnexionSql
	
      ResultatSql(NomEmploye : Nul Ou Caractere TailleMaxSql 20, DateEmbauche : Nul Ou Date, Salaire : Nul Ou Reel)

      TailleTableauResultatSql 5

      ParametreSql(NumeroDepartement : Entier)
 
      SqlStatique
				
         SELECT ename:=${NomEmploye}, hiredate:=${DateEmbauche}, sal:=${Salaire}
 
         FROM emp
 
         WHERE deptno=${NumeroDepartement}; 
		
	

?>



<BODY>



<H1>Liste des employés</H1>

Département <?UpsMxr:Expression Caractere(Entier) ?><BR>

==============<BR>

<TABLE>

<TR><TD><B>Nom</B></TD><TD><B>Date embauche</B></TD><TD><B>Numero</B></TD><TD><B>Salaire</B></TD></TR>


<?UpsMxr:Instructions
 
RequeteSql MaRequeteSql

	ResultatSql(NomEmploye : Nul Ou Caractere TailleMaxSql 20, DateEmbauche : Nul Ou Date, NumeroEmploye : Nul Ou Entier, Salaire : Nul Ou Reel)

	ParametreSql(NumeroDepartement);


Debut

   Sgml
	
      <TR>
		
         <TD><?UpsMxr:Expression NomEmploye ?></TD>

         <TD><?UpsMxr:Expression DateEmbauche ?></TD>

         <TD><?UpsMxr:Expression Caractere(NumeroEmploye, "####") ?></TD>

         <TD><?UpsMxr:Expression Caractere(Salaire, "&&&.&&&#,##") ?></TD>
      
		</TR>
   
	Fin Sgml

Fin RequeteSql

?>
 
</TABLE>

<P>


</BODY>

</HTML>

Document esclave et composant maître


Source Document "Exemple d'emploi d'Up ! 5GL Mixer et Up ! Document" Version 4.0.0;



ImporterModule

/************/

   UpsQry(<UpsQry.upi>, ImporterDefinitions);

   UpsOra(<UpsOra.upi>, ImporterDefinitions);



ConnexionSql

/**********/

   MaConnexionSql(Oracle, "scott/tiger");



RequeteSql

/********/

   MaRequeteSql ConnexionSql MaConnexionSql
	
      ResultatSql(NomEmploye : Nul Ou Caractere TailleMaxSql 20, DateEmbauche : Nul Ou Date, Salaire : Nul Ou Reel)

      TailleTableauResultatSql 5

      ParametreSql(NumeroDepartement : Entier)
 
      SqlStatique
				
         SELECT ename:=${NomEmploye}, hiredate:=${DateEmbauche}, sal:=${Salaire}
 
         FROM emp
 
         WHERE deptno=${NumeroDepartement}; 
		
	



DefinitionsSgml

/*************/

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<!-- ------------------------------------------------------------------- -->

<!-- Fichier    : exemple2.upx                                           -->

<!-- Objet      : Exemple d'emploi d'Up ! Mixer et Up ! Sgml pour du Html. -->

<!--                                                                     -->

<!--  Module      : Up ! Application System.                             -->

<!--  Auteur-Date : DUVAL Jean-Pierre - Novembre 2006.                   -->

<!-- ------------------------------------------------------------------- -->

<!--                           Observations                              -->

<!--                                                                     -->

<!--                                                                     -->

<!-- ------------------------------------------------------------------- -->

Fin DefinitionsSgml



Principal

/*******/

Debut

Sgml

<HTML>

<HEAD><TITLE>Liste des employés</TITLE></HEAD>



<BODY>



<H1>Liste des employés</H1>

Département <?UpsMxr:Expression Caractere(Entier) ?><BR>

==============<BR>

<TABLE>

<TR><TD><B>Nom</B></TD><TD><B>Date embauche</B><TD><B>Numero</B></TD><TD><B>Salaire</B></TD></TR>


<?UpsMxr:Instructions
 
RequeteSql MaRequeteSql

	ResultatSql(NomEmploye : Nul Ou Caractere TailleMaxSql 20, DateEmbauche : Nul Ou Date, NumeroEmploye : Nul Ou Entier, Salaire : Nul Ou Reel)

	ParametreSql(NumeroDepartement);


Debut

   Sgml
	
      <TR>
		
         <TD><?UpsMxr:Expression NomEmploye ?></TD>

         <TD><?UpsMxr:Expression DateEmbauche ?></TD>

         <TD><?UpsMxr:Expression Caractere(NumeroEmploye, "####") ?></TD>

         <TD><?UpsMxr:Expression Caractere(Salaire, "&&&.&&&#,##") ?></TD>
      
		</TR>
   
	Fin Sgml

Fin RequeteSql

?>
 
</TABLE>

<P>


</BODY>

</HTML>

Fin Sgml

Fin Principal