Panneau Vue Procédure

Dans cette section :

Le panneau Vue Fichier contient les commandes de personnalisation du panneau, la barre d'outils Vue Fichier, et la structure vue fichiers. Ce panneau affiche tous les fichiers de la procédure. Vous pouvez ajouter les éléments suivants à une procédure : Rapport, Définir, Fonction Définir, Graphique, Configurer, Jointure, Utilisation, Allocation, Dimensions OLAP, Correspondre, ou Gestionnaire de dialogue.

Si un composant de la procédure est ouvert, une flèche verte apparaît à côté de l'icône du composant.

Lorsqu'une nouvelle procédure est créée, le composant commentaire s'ouvre automatiquement. Dans une procédure précédemment créée qui a été réouverte, le dernier composant de rapport ou de graphique s'ouvre automatiquement.

Le Panneau Vue Procédure est disponible lorsque vous créez que vous ouvrez une procédure ou un rapport. Le panneau Vue Procédure est présenté dans l'image suivante.

Panneau Vue Procédure

Pour plus d'informations sur l'utilisation du panneau Vue Procédure, consultezUtilisation des options de personnalisation du panneau.


Haut de page

x
Panneau Vue Procédure

La barre d'outils Vue Fichier contient le bouton Information Fichier.

Information Fichier

Affiche l'information sur le fichier sélectionné, tel que la position d'un élément, le type de fichiers, le nombre de lignes, et le code fichier.


Haut de page

x
Panneau Vue Procédure

L'arborescence Vue Fichier affiche les composants et les dossiers associés à une procédure.

Ouvrir le noeud dossier

Affiche un certain nombre d'options en fonction du ou des composants sélectionnés dans la procédure.

Arborescence contenu procédure

Affiche les composants de la procédure.


Haut de page

x
Composants d'une procédure

Dans cette section :

 

Une procédure est un fichier .fex, qui définit le mode de récupération et l'affichage des données. Les procédures demandent les données de la source de données à l'aide d'un fichier Maître afin de comprendre la logique d'organisation des données. Lorsque vous exécutez une procédure, elle exécute une série de commandes qui traitent vos données et les transforment en sortie lisible.

Les procédures peuvent consister en la liste de composants suivante :

Vous pouvez ajouter ces composants à des procédures nouvelles ou existantes ; ils sont responsables de l'ordre dans lequel vous les ajoutez. Pour plus d'informations, consultez Ordre des composants dans le panneau Vue Procédure. Les rubriques suivantes décrivent l'impact de ces composants sur une procédure.



x
Rapport

Vous pouvez ajouter un rapport à une procédure. En mode Rapport, vous ajoutez des données à la zone de travail Rapport, et apportez un style à ces données en créant une représentation graphique de la page du rapport. Ceci vous permet de visualiser la façon dont le rapport s'affiche au moment de l'exécution.



x
Définir

Vous pouvez utiliser l'option Définir pour créer un champ virtuel comme composant dans une procédure.

Remarque : pour activer les objets lors de la création de Define, cliquez sur le bouton Nouveau.

Un champ virtuel est évalué lors de chaque récupération qui passe les critères de sélection des champs réels. Définissez le champ virtuel en affectant un format et en tapant une expression, ou en le composant avec les champs et fonctions de calcul. Le résultat de l'expression est traité comme un champ réel stocké dans la source de données.



x
Définir Fonction

Vous avez la possibilité de créer vos propres fonctions en utilisant l'assistant Définir Fonction. L'Assistant Définir Fonction vous assiste dans la création d'une fonction utilisateur. Les fonctions créées peuvent être récupérées plus tard via la fenêtre de dialogue Arguments fonction en utilisant le bouton Récupérer les fonctions utilisateur. En cliquant sur le bouton Récupérer les fonctions utilisateur, les fonctions que vous avez créées seront disponibles pour utilisation.



x
Graphique

Vous pouvez ajouter un graphique à une procédure. En mode Graphique, vous pouvez facilement transformer pratiquement tous types de données en graphiques personnalisés fonctionnels. Vous pouvez créer une varité de graphiques, comme par exemple des graphiques à barres, graphiques à lignes, graphiques de dispersion ou en secteurs pour aider les utilisateurs à analyser les données de façons différentes. Vous pouvez inclure des critères de sélection différents en définissant des paramètres pour vos données. Vous pouvez également appliquer des fonctionnalités de zoom en profondeur et de style conditionnel pour surligner des données spécifiques dans un graphique.

La zone de travail Graphiques contient un ruban de fonctions et d'options qui vous permettent d'ajouter et de styler les données de votre graphique. Les onglets contextuels s'ouvrent dans la zone de travail Graphique plutôt que dans le ruban Application Studio.



x
Configurer

Vous pouvez ajouter le composant Définir à une procédure pour sélectionner des paramètres et personnaliser les procédures. Le composant Définir contrôle la façon dont les rapports et graphiques s'affichent sur l'écran ou l'imprimante, le contenu des rapports et graphiques, les caractéristiques de récupération de données ayant un impact sur la performance, et les réponses du système aux requêtes de l'utilisateur. Il vous aide aussi dans la définition des métadonnées et la manipulation des informations, comme par exemple les dates.



x
Jointure

Si un rapport requiert des données provenant de deux ou plusieurs sources de données associées, il est possible de joindre ces fichiers de façon temporaire pour en générer des rapports comme s'il ne s'agissait que d'un seul fichier. Les fichiers joints restent physiquement séparés, mais sont traités comme une arborescence de source de données virtuelle.

Le composant Jointure fournit une méthode graphique pour créer et manipuler tous les types de jointure. Pour créer une jointure, vous devez spécifier un fichier hôte, puis un fichier de référence croisée. Les fichiers hôtes et fichiers de référence croisée sont des fichiers maîtres.

La jointure est créée en tant que composant indépendant de tout autre composant ou de toute autre procédure. Il vous incombe de mettre l'objet de jointure dans la position correcte, c'est-à-dire, avant un DEFINE, un rapport ou un graphique, et de l'exécuter. A moins d'être explicitement effacée, la jointure demeure active jusqu'à la fin de la session.



x
Utiliser

Lorsque vous accédez à une source de données FOCUS, WebFOCUS recherche un fichier Maître avec le nom de fichier spécifié, puis recherche une source de données avec le même nom. A l'aide du composant Utiliser, vous pouvez spécifier le nom et l'emplacement d'une source de données FOCUS.

Vous pouvez appliquer le composant Utiliser à une procédure dans Application Studio lorsque la convention de nommage par défaut n'est pas utilisée, la source de données est introuvable dans le chemin de recherche standard, ou une option supplémentaire et explicite est souhaitée.

Lorsque vous identifiez une source de données FOCUS avec le composant Utiliser, un répertoire Utiliser est créé ; il s'agit d'une liste de définitions de sources de données. Lorsqu'un répertoire Utiliser est en vigueur, WebFOCUS situe une source de données à l'aide des informations dans le répertoire à défaut de le rechercher avec le nom et le chemin de recherche par défaut. Un répertoire Utiliser vous permet d'accéder à plus de 1 022 sources de données et ne s'applique qu'aux sources de données FOCUS.



x
Affectation

Pour un fichier géré par le système d'exploitation, comme par exemple ISAM ou un fichier de données délimité par des virgules, le nom physique du fichier est le nom comme il apparaît pour le système d'exploitation. Un nom logique (ou ddname) est le nom de raccourci qui pointe vers le nom de fichier physique. Les noms logiques simplifient les codes en permettant l'utilisation de noms brefs à défaut de noms de fichier physiques longs.

Avec l'assistant d'allocations vous pouvez créer une commande FILEDEF et génère des chemins de fichier indépendants de la plate-forme pour toutes celles portables, en créant la syntaxe FILEDEF avec des noms d'applications.

Informations connexes :



x
Exécuter

Le composant Exécuter permet à une procédure d'exécuter ou d'appeler une autre procédure. La procédure appelée se comporte comme une procédure distincte, dans son propre contexte. L'Assistant Exécution permet d'afficher et de sélectionner les procédures disponibles et de fournir des valeurs pour les paramètres dans la procédure appelée, ainsi que de tester la procédure appelée.

Une fois cette procédure spécifiée, Exécuter affiche les paramètres et vous invite à saisir les valeurs appropriées. Vous pouvez fournir des valeurs pour tous ou certains des paramètres dans la procédure. Si vous fournissez des valeurs pour seulement certains des paramètres, vous devez utiliser une autre méthode pour fournir les valeurs des autres paramètres. Par exemple, les valeurs sont passées d'une autre partie de l'application. Après avoir fourni les valeurs de paramètre, vous pouvez tester la procédure appelée.

Exécuter est disponible dans toutes les zones de développement du produit.

Informations connexes :



x
HTMLFORM

Crée un composant de procédure que vous pouvez utiliser pour ajouter du code HTML à une procédure active. Les formulaires HTML sont utilisés pour afficher du contenu HTML. Vous pouvez choisir de faire référence à formulaire HTML, ou de l'incorporer dans votre procédure.

Remarque : les pages HTML créées dans le canevas HTML ne sont pas disposées à être utilisées avec un -HTMLFORM utilisant des références d'exécution. Le canevas HTML ne peut pas évaluer -HTMLFORM lorsque des références exécution sur des noms de fichiers et des objets sont utilisés.

Informations connexes :



x
Dimensions OLAP

Le composant Dimensions OLAP vous permet de créer une hiérarchie OLAP temporaire et les dimensions à partir desquelles créer les rapports, sans modifier le fichier Maître. Créez plutôt une hiérarchie locale, où les informations sont stockées dans la procédure active. Après la création de la hiérarchie locale, vous pouvez construire un rapport.



x
Correspondance

En utilisant le l'Assistant de correspondance, vous pouvez fusionner deux sources de données ou plus, et spécifier quels enregistrements à fusionner et à trier. L'assistant crée une nouvelle source de données, (un fichier HOLD), qui fusionne les champs avec les enregistrements sélectionnés. Vous pouvez créer un rapport à partir de la nouvelle source de données et l'utiliser comme vous le faites avec n'importe quel autre fichier HOLD. Le processus de fusion n'altère pas les sources de données originales.

Vous pouvez sélectionner les enregistrements à fusionner en une nouvelle source de données en spécifiant des critères de tri dans l'assistant MATCH. Vous spécifiez un ensemble de champs de tri, à l'aide de la phrase BY, pour la première source de données, et un deuxième ensemble de champs de tri pour la deuxième source de données. L'assistant MATCH compare alors tous les champs de tri communs aux deux sources de données, puis elle fusionne tous les enregistrements de la première source de données dont les valeurs de tri correspondent à celles de la deuxième source de données avec le nouveau fichier HOLD. Vous pouvez spécifier jusqu'à 32 ensembles de tri, ce qui comprend le nombre de critères de tri communs.

En plus de fusionner des enregistrements de source de données qui partagent des valeurs, vous pouvez fusionner des enregistrements selon d'autres rapports. Par exemple, vous pouvez fusionner tous les enregistrements dans chaque source de données dont les valeurs de tri ne correspondent pas à celles dans l'autre source de données. Un autre type de fusion permet de combiner tous les enregistrements de la première source de données avec tout enregistrement correspondant de la deuxième source de données.

Vous pouvez fusionner jusqu'à 16 jeux de données par requête de MATCH. Par exemple, vous pouvez fusionner différentes sources de données, ou bien des données de la même source de données.

Remarque : cette limite de 16 jeux de données s'applique à la requête la plus complexe. Plus la requête est simple plus elle est susceptible de fusionner de nombreuses sources de données.



x
Gestionnaire de dialogue

Le gestionnaire de dialogue est la partie du langage WebFOCUS qui contrôle l'exécution des composants de votre application. Vous pouvez améliorer la flexibilité de votre application en gérant dynamiquement le flux ou le contrôle dans les procédures en utilisant les commandes du gestionnaire de dialogue et les variables dont les valeurs sont fournies au moment de l'exécution.

Vous pouvez sélectionner cinq types différents de composant du Gestionnaire de dialogue pour les ajouter à votre procédure.

Informations connexes :



x
Ordre des composants dans le panneau Vue Procédure

Les composant peuvent être ajoutés au panneau Vue Procédure dans n'importe quel ordre. Après avoir ajouté un composant, il est possible que vous ayez à changer son ordre.

L'ordre des composants dans le panneau Vue Procédure peut être significatif. Par exemple, supposons que vous avez un composant rapport et un composant define, dans une situation où ce dernier est un champ utilisé dans le rapport. Dans un tel cas, le composant define doit obligatoirement apparaître avant le composant rapport (au-dessus de celui-ci) dans le panneau Vue procédure. Sinon, le système va afficher un message si vous essayez d'exécuter le rapport.

Pour déplacer un composant, cliquez sur celui-ci et déplacez-le au-dessus d'un autre composant jusqu'à ce que le composant cible soit mis en surbrillance. Pendant que le composant est déplacé, le pointeur affiche une image boîte. Relâchez le bouton la souris, et le composant déplacé apparaîtra à la suite du composant mis en surbrillance.

Pour copier un composant, appuyez sur la touche Ctrl, cliquez sur le composant et déplacer le vers le haut ou vers le bas. Pendant que le composant est copié, le pointeur affiche un signe plus (+). Relâchez le bouton la souris, la touche Ctrl, et le composant copié apparaîtra à la suite du composant mis en surbrillance.

Remarque : vous pouvez déplacer ou copier un composant dans le panneau Vue Procédure, même si ce composant est ouvert dans son canevas respectif.


Haut de page

x
Comment créer des Procédures et des Composants de Procédure

Comment :

Cette section décrit comment créer des Procédures et des Composants de Procédure.



x
Comment : Créer une nouvelle procédure
  1. Pour créer une nouvelle procédure, effectuez l'une des opérations suivantes :
    • Cliquez sur le bouton Nouveau sur la barre d'outils Accès rapide. Dans la fenêtre de dialogue Nouveau, sélectionnez Procédures, puis cliquez sur OK.
    • Sélectionnez Nouveau dans le menu Application. Dans la fenêtre de dialogue Nouveau, sélectionnez Procédures, puis cliquez sur OK.
    • Dans le panneau Arbre d'environnements, faites un clic droit sur un dossier d'applications, pointez vers Nouveau, puis cliquez sur Procédure.
  2. Le panneau Vue Procédure s'ouvre.

    Remarque : le bouton Nouveau n'est disponible qu'après avoir sélectionné un chemin valide. Il n'est pas nécessaire d'entrer un nom pour créer une procédure. Vous pouvez entrer un nom après la création de la procédure.

    Vous pouvez ajouter des composants à votre procédure dans le panneau Vue du fichier. Faites un clic droit sur le dossier de la procédure, ou le composant que vous souhaitez ajouter, pointez vers Nouveau, puis cliquez sur le nom du composant. Vous disposez des options suivantes :

    • Rapport
    • Moteur SQL
    • Rapport SQL
    • Définir
    • Définir Fonction
    • Graphique
    • Graphique SQL
    • Configurer
    • Jointure
    • Utiliser
    • Affectation
    • Exécuter
    • HTMLFORM
    • Inclure
    • Dimensions OLAP
    • Correspondance
    • Gestionnaire de dialogue
    • Autre


x
Comment : Créer un rapport comme composant d'une procédure
  1. Créez une nouvelle procédure, ou ouvrez une procédure existante.
  2. Dans le panneau Vue du fichier, faites un clic droit sur le dossier d'une procédure ou le composant que vous souhaitez créer selon le rapport, pointez vers Nouveau, puis cliquez sur Rapport.

    Si le développement se fait dans la zone Serveurs de données ou dans le référentiel, une fenêtre de dialogue Liste de tables WebFOCUS s'ouvre. Si le développement se fait dans la zone Projets, la fenêtre de dialogue Ouvrir s'ouvre.

  3. Sélectionnez un fichier Maître à partir de la liste et cliquez sur OK.

    La zone de travail Rapport et le panneau Vue du fichier s'ouvrent.

  4. Faites un clic double sur le champs dans l'inspecteur d'objet pour les ajouter au rapport.
  5. Mettez en forme votre rapport à l'aide des options sous l'onglet Rapport, Format, Données, et Mise en page.

    Conseil : l'onglet Champ s'affiche après la sélection d'une colonne de données sur la zone de travail Rapport.

  6. Pour enregistrer votre rapport, cliquez sur le bouton Enregistrer sur la barre d'outils Accès rapide , ou sélectionnez Enregistrer ou Enregistrer sous à partir du menu Application.
  7. Pour exécuter votre rapport, cliquez sur le bouton Exécuter sur la barre d'outils Accès rapide, ou sélectionnez Exécuter à partir du menu Application.


x
Comment : créer une instruction de moteur
  1. Dans le panneau Vue procédure, faites un clic droit sur le dossier de la procédure ou le composant que vous souhaitez créer d'après le moteur, pointez vers Nouveau, puis cliquez sur Moteur SQL.

    Le canevas Moteur s'ouvre.

  2. Sélectionnez un moteur dans la liste déroulante Moteur ou saisissez manuellement un nom de moteur.
  3. Sélectionnez une connexion existante depuis la liste Connexion, ou entrez une instruction paramètre dans le champ Paramètres SET.
  4. Cliquez sur le bouton Tester pour vérifier l'instruction de moteur.


x
Comment : Définir un champ virtuel
  1. Ouvrez une procédure existante, ou créez-en une nouvelle.
  2. Dans le panneau Vue du fichier, faites un clic droit sur le dossier de la procédure ou le composant que vous souhaitez créer d'après le champ virtuel, pointez vers Nouveau, puis cliquez sur Définir.

    Remarque : lorsque vous cliquez sur Nouveau, vous activez les objets à utiliser pour la création d'un Define.

    La boîte de dialogue Ouvrir le fichier s'affiche.

  3. Sélectionnez un fichier Maître à partir de la liste et cliquez sur OK.

    La zone de travail Définir s'ouvre.

  4. Dans la zone de saisie Champ, entrez le nom du champ virtuel.
  5. Cliquez sur le bouton Format.

    La fenêtre de dialogue Format s'ouvre.

  6. Sélectionnez les options de format que vous souhaitez appliquer au champ virtuel, puis cliquez sur OK.
  7. Construisez une expression dans la zone Expressions. Vous pouvez faire un clic double sur les champs de la liste Champs pour les ajouter à l'expression. Utilisez les bouton du calculateur sous la fenêtre d'expressions pour fournir les numéros et opérateurs de l'expression.
  8. Cliquez sur le bouton Vérifier pour valider le code généré.

    La fenêtre de dialogue Vérifier s'ouvre, affiche le code du composant et soit un message d'erreur, soit un texte indiquant qu'il n'y a pas d'erreur.

  9. Cliquez sur OK puis fermez la zone de travail Définir.

    Vous pouvez définir plusieurs champs virtuels pour une procédure. Après avoir défini un champ virtuel, vous pouvez créer un rapport qui utilise le champ virtuel. Faites un clic droit sur le composant DEFINE, pointez vers Nouveau, puis cliquez sur Rapport.



x
Comment : Créer une fonction définie par utilisateur

Pour créer une fonction définie par utilisateur :

  1. Faites un clic droit sur un composant de procédure dans le panneau Vue Procédure, pointez sur Nouveau, et cliquez sur Définir Fonction.

    La partie Nom de l'assistant Définir Fonction est affichée.

  2. Entrez un nom et une description pour la fonction et cliquez sur Suivant.

    La section Paramètres de l'assistant Définir Fonction est affichée.

  3. Cliquez sur Ajouter un nouveau bouton élément pour ajouter de nouveaux paramètres à la fonction.

    Vous pouvez renommer les paramètres en double cliquant sur la colonne nom. Pour chaque paramètre, si vous cliquez sur le bouton à points de suspension dans la colonne Format, la fenêtre de dialogue Format va s'ouvrir, vous permettant d'éditer le format pour ce paramètres. Si vous double cliquez dans la colonne Description pour chaque paramètre, vous pourrez éditer la description de ce paramètre.

  4. Cliquez sur Suivant.

    La section Champs définis de l'assistant Définir Fonction est affichée. Un champ défini (ayant le même nom que votre fonction) est déjà renseigné.

    Remarque : une fonction est comprise d'expressions qui renvoient une valeur à l'appelant de la fonction.

  5. Cliquez sur le bouton Ajouter Nouvel élément si vous souhaitez ajouter plus de champs définis.

    Vous pouvez renommer les champs en double cliquant sur la colonne nom. Pour chaque champ, si vous cliquez sur le bouton à points de suspension dans la colonne Format, la fenêtre de dialogue Format va s'ouvrir, vous permettant d'éditer le format pour ce champ. Si vous cliquez sur le bouton à points de suspension dans la colonne Expression, vous allez ouvrir une fenêtre de dialogue dans laquelle vous pouvez éditer ce que la fonction est chargée de faire.

    Remarque : le dernier champ défini doit obligatoirement avoir le même nom que la fonction. C'est pourquoi un champ défini est déjà entré et a le même nom que la fonction. S'il existe plusieurs expressions, le champ défini ayant le même nom que la fonction doit obligatoirement être placé à la dernière position. Si aucun champ défini n'a le même nom que la fonction, ou si ce champ défini n'est pas à la dernière position, vous ne pourrez pas passer à la fenêtre suivante.

  6. Cliquez sur Suivant.

    La fenêtre Compléter de l'Assistant Définir Fonction s'affiche. La fonction est affichée avant terminaison, accompagnée de ses paramètres et de sa logique.

  7. Cliquez sur Terminer pour finir l'installation.

    L'assistant Définir Fonction s'ouvre dans une nouvelle fenêtre.

    S'il n'y a plus de fonction à créer, cliquez sur OK pour fermer l'assistant avec toutes les fonctions créées.

  8. Si vous souhaitez créer plus de fonctions, cliquez sur Nouveau pour ramener l'assistant Définir Fonction, afin de créer une autre fonction.

    Ces étapes peuvent être répétées autant que nécessaire, vous permettant de créer plusieurs fonctions dans le la procédure, sans avoir à quitter ni à répéter certaines étapes.

    Le fait de sélectionner une fonction et de cliquer sur Editer va ouvrir l'assistant Définir Fonction. Ici, vous pouvez modifier n'importe quelle partie de la fonction qui a déjà été créée en vous déplaçant vers chacune des fenêtres.

    Le fait de sélectionner une fonction et de cliquer sur Supprimer va supprimer la fonction.



x
Comment : Créer une Bibliothèque de Fonctions définies

Pour créer une fonction définie par utilisateur :

  1. Faites un clic droit sur un dossier projet dans le panneau Environnements, pointez sur Nouveau, et cliquez sur Définir Bibliothèque de Fonctions.

    La partie Nom de l'assistant Définir Fonction est affichée.

  2. Entrez un nom et une description pour la fonction et cliquez sur Suivant.

    La section Paramètres de l'assistant Définir Fonction est affichée.

  3. Cliquez sur Ajouter un nouveau bouton élément pour ajouter de nouveaux paramètres à la fonction.

    Vous pouvez renommer les paramètres en double cliquant sur la colonne nom. Pour chaque paramètre, si vous cliquez sur le bouton à points de suspension dans la colonne Format, la fenêtre de dialogue Format va s'ouvrir, vous permettant d'éditer le format pour ce paramètres. Si vous double cliquez dans la colonne Description pour chaque paramètre, vous pourrez éditer la description de ce paramètre.

  4. Cliquez sur Suivant.

    La section Champs définis de l'assistant Définir Fonction est affichée. Un champ défini (ayant le même nom que votre fonction) est déjà renseigné.

    Remarque : une fonction est comprise d'expressions qui renvoient une valeur à l'appelant de la fonction.

  5. Cliquez sur le bouton Ajouter Nouvel élément si vous souhaitez ajouter plus de champs définis.

    Vous pouvez renommer les champs en double cliquant sur la colonne nom. Pour chaque champ, si vous cliquez sur le bouton à points de suspension dans la colonne Format, la fenêtre de dialogue Format va s'ouvrir, vous permettant d'éditer le format pour ce champ. Si vous cliquez sur le bouton à points de suspension dans la colonne Expression, vous allez ouvrir une fenêtre de dialogue dans laquelle vous pouvez éditer ce que la fonction est chargée de faire.

    Remarque : le dernier champ défini doit obligatoirement avoir le même nom que la fonction. C'est pourquoi un champ défini est déjà entré et a le même nom que la fonction. S'il existe plusieurs expressions, le champ défini ayant le même nom que la fonction doit obligatoirement être placé à la dernière position. Si aucun champ défini n'a le même nom que la fonction, ou si ce champ défini n'est pas à la dernière position, vous ne pourrez pas passer à la fenêtre suivante.

  6. Cliquez sur Suivant.

    La fenêtre Compléter de l'Assistant Définir Fonction s'affiche. La fonction est affichée avant terminaison, accompagnée de ses paramètres et de sa logique.

  7. Cliquez sur Terminer pour finir l'installation.

    L'assistant Définir Fonction s'ouvre dans une nouvelle fenêtre.

    S'il n'y a plus de fonction à créer, cliquez sur OK pour fermer l'assistant avec toutes les fonctions créées.

  8. Si vous souhaitez créer plus de fonctions, cliquez sur Nouveau pour ramener l'assistant Définir Fonction, afin de créer une autre fonction.

    Ces étapes peuvent être répétées autant que nécessaire, vous permettant de créer plusieurs fonctions dans le la procédure, sans avoir à quitter ni à répéter certaines étapes.

    Le fait de sélectionner une fonction et de cliquer sur Editer va ouvrir l'assistant Définir Fonction. Ici, vous pouvez modifier n'importe quelle partie de la fonction qui a déjà été créée en vous déplaçant vers chacune des fenêtres.

    Le fait de sélectionner une fonction et de cliquer sur Supprimer va supprimer la fonction.



x
Comment : Créer un graphique comme composant d'une procédure
  1. Créez une nouvelle procédure, ou ouvrez une procédure existante.
  2. Dans le panneau Vue du fichier, faites un clic droit sur le dossier de procédures ou le composant que vous souhaitez créer d'après le graphique, pointez vers Nouveau, puis cliquez sur Graphique.

    Si le développement se fait dans la zone Serveurs de données ou dans le référentiel, une fenêtre de dialogue Liste de tables WebFOCUS s'ouvre. Si le développement se fait dans la zone Projets, la fenêtre de dialogue Ouvrir s'ouvre.

  3. Sélectionnez un fichier Maître à partir de la liste et cliquez sur OK.

    La zone de travail Graphique s'ouvre.

  4. Faites un clic double sur les champs dans le panneau Données pour les ajouter au graphique.

    Vous pouvez utiliser les fonctions et options sur le ruban situé dans la zone de travail Graphique pour mettre en forme le graphique.

  5. Pour enregistrer votre rapport, cliquez sur le bouton Enregistrer sur la barre d'outils Accès rapide Application Studio, ou sélectionnez Enregistrer ou Enregistrer sous à partir du menu Application.
  6. Pour exécuter votre rapport, cliquez sur le bouton exécuter sur la barre à outils Accès rapide, ou sélectionnez exécuter à partir du menu Application.


x
Comment : Définir les paramètres d'une procédure
  1. Ouvrez une procédure existante, ou créez-en une nouvelle.
  2. Dans le panneau Vue du fichier, faites un clic droit sur le dossier Procédure ou le composant que vous souhaitez créer d'après l'option Définir, pointez vers Nouveau, puis cliquez sur Définir.

    La zone de travail Configurer s'ouvre.

  3. A partir de la liste Paramètres disponibles, faites un double clic sur un paramètre.

    Le paramètre sélectionné est ajouté à la liste Paramètres utilisés. Les valeurs disponibles pour ce paramètre s'affichent dans la liste Valeur actuelle.

    Remarque : vous pouvez également sélectionner un paramètre et cliquer sur le bouton Ajouter pour l'ajouter à la liste Paramètres utilisés.

  4. Sélectionnez une valeur dans la liste Valeur actuelle.
  5. Cliquez sur le bouton Vérifier pour valider le code généré.

    La fenêtre de dialogue Vérifier s'ouvre, affiche le code du composant et soit un message d'erreur, soit un texte indiquant qu'il n'y a pas d'erreur.

  6. Cliquez sur OK, et fermez la zone de travail Configurer.

    Ce paramètre est désormais activé et affectera le fonctionnement de la procédure.



x
Comment : Joindre des sources de données
  1. Ouvrez une procédure existante, ou créez-en une nouvelle.
  2. Dans le panneau Vue du fichier, faites un clic droit sur le dossier de la procédure ou le composant que vous souhaitez créer d'après la Jointure, pointez vers Nouveau, puis cliquez sur Jointure.
  3. Sélectionnez un fichier Maître (fichier hôte) puis cliquez sur OK.

    La zone de travail Jointure s'ouvre et affiche les champs dans le fichier Maître.

  4. Sur l'onglet Jointure, dans le groupe Jointure, cliquez sur Ajouter.

    Vous pouvez également faire un clic droit sur la zone de travail de la jointure, puis sélectionner Ajouter un fichier.

  5. Sélectionnez un fichier Maître (fichier de référence croisée) puis cliquez sur OK.

    Le nouveau fichier Maître est ajouté à la zone de travail. Les champs en commun des deux fichiers sont joints par une ligne de connexion de jointure.

  6. Cliquez sur Enregistrer.
  7. Cliquez sur Exécuter.

    Une fenêtre de dialogue s'ouvre et affiche le code du composant, et soit un message d'erreur, soit du texte indiquant qu'aucune erreur n'existe.

  8. Cliquez sur OK, puis fermez la zone de texte Jointure.

    Vous pouvez ajouter un autre composant à la procédure en faisant un clic droit sur le composant Jointure, en pointant sur Nouveau, puis en cliquant sur le composant. Lorsque vous êtes invité à sélectionner un fichier Maître, sélectionnez le fichier hôte utilisé lors de la création du composant Jointure. Cela vous permet alors d'utiliser les sources de données jointes.



x
Comment : Identifier une Source de données avec la fonction Utiliser
  1. Ouvrez une procédure existante, ou créez-en une nouvelle.
  2. Dans le panneau Vue du fichier, faites un clic droit sur le dossier de la procédure ou le composant que vous souhaitez créer d'après Utiliser, pointez vers Nouveau, puis cliquez sur Utiliser.

    La zone de travail Utiliser s'ouvre.

  3. Dans la zone de travail Utiliser, effectuez l'une des étapes suivantes :
    • Entrez le nom d'une source de données FOCUS dans le champ Nom de fichier de la base de données.
    • Cliquez sur Parcourir pour rechercher les pilotes et répertoires pour le fichier que vous souhaitez ajouter.
    • Entrez le nom UNC (Convention d'affectation des noms) du fichier dans le champ Nom de fichier de la base de données. Par exemple :

      \\Server1\Disk1\employee.foc

      L'UNC (convention d'affectation des noms) vous permet d'entrer le nom du serveur sans en entrer le chemin explicite. Toutefois, afin de bénéficier du format UNC, vous devez dans un premier temps vous connecter au serveur. Pour plus de détails sur la connexion à un serveur ou sur les correspondances entre lecteurs réseau, contactez votre administrateur réseau.

      Entrez le nom du fichier Maître à associer à la source de données dans le champ Fichier Maître.

  4. Si la source de données n'est pas située localement, entrez le nom du serveur où réside le fichier, dans le champ Serveur de la base de données.
  5. Cliquez sur Ajouter.
  6. Répétez les étapes 3 à 6 pour les sources de données supplémentaires que vous souhaitez identifier.
  7. Sélectionnez une action USE :
    • Supprimer / Remplacer la liste actuelle de bases de données USE, efface toutes les saisies ou remplace la source de données USE avec celles de la zone de liste.
    • Ajouter à la liste de la base de données actuelle, ajoute les sources de données au répertoire actuel USE.
    • Remplacer les fichiers spécifiés seuls dans le liste, modifie les affectations d'une ou plusieurs sources de données dans le répertoire actuel USE.
  8. Cliquez sur le bouton Vérifier pour valider le code généré.

    La fenêtre de dialogue Vérifier s'ouvre, affiche le code du composant et soit un message d'erreur, soit un texte indiquant qu'il n'y a pas d'erreur.

  9. Cliquez sur OK, puis fermez la zone de travail Utiliser.


x
Comment : Définir un nom logique avec l'Assistant d'allocations
  1. Ouvrez une procédure existante, ou créez-en une nouvelle.
  2. Dans le panneau Vue du fichier, faites un clic droit sur le dossier de la procédure ou le composant que vous souhaitez créer d'après l'Allocation, pointez vers Nouveau, puis cliquez sur Allocation.

    L'assistant d'allocations s'ouvre dans une nouvelle zone de travail.

  3. Cliquez sur Suivant puis spécifiez le nom logique pour l'allocation.

    Ce nom peut compter de un à huit caractères. Si vous désignez une source de données, le nom doit être semblable à celui du fichier Maître.

  4. Cliquez sur Suivant puis sélectionnez le périphérique pour le nom logique.
    • Disque associe le nom logique à un fichier. Ceci est l'option par défaut.
    • Imprimante associe le nom logique à une imprimante.
    • Http associe le nom logique à une URL, en affectant le fichier Maître au résultat de l'exécution de l'URL.
    • Terminal indique que le clavier et le moniteur sont la source d'entrée et de la destination de sortie du fichier.
    • Effacer annulle l'allocation attribuée au nom de fichier.
  5. Cliquez sur Suivant pour sélectionner des options supplémentaires.

    Remarque : les options varient en fonction du périphérique sélectionné. Les étapes ci-dessous décrivent la façon dont l'Assistant Allocation poursuit avec le périphérique sélectionné.

    Conseil : vous pouvez à tout moment cliquer sur le bouton Retour pour revenir en arrière et changer de périphérique, ou tout autre paramètre de périphérique.

  6. Lors de la sélection de l'option Disque en tant que périphérique :
    1. Sélectionnez le dossier d'applications contenant le fichier physique.

      Remarque : les dossiers d'applications du Serveur de rapports sont affichés par défaut et dépendent de la zone depuis laquelle l'Assistant d'allocations est appelé. Projets, Serveur de données, et Référentiel sont des exemples de dossiers d'application du serveur de rapports. Vous pouvez spécifier un fichier dans un répertoire autre que le Chemin d'accès à l'application du Serveur d'applications à l'aide de l'option Avancé depuis l'allocation une fois terminée.

    2. Cliquez sur Suivant puis saisissez le nouveau nom de fichier.

      ou

      Cliquez sur le bouton Naviguer pour afficher la fenêtre de dialogue Ouvrir puis effectuez votre sélection depuis la liste de fichiers existants.

      Remarque : le type de fichiers par défaut est Fichiers de données (*.dat). Vous pouvez également sélectionner Fichiers temporaires (*.ftm), et Tous les fichiers (*.*), comme type de fichier.

    3. Cliquez sur Suivant pour spécifier davantage d'options pour le périphérique Disque.

      Ces options sont :

      • Ajoutez des enregistrements à la fin du fichier (sans cette option, celui-ci sera écrasé).
      • Les enregistrements à longueur fixe indiquent que vous attribuez un nom logique à un fichier avec une longueur d'enregistrement fixe.
      • La taille de l'enregistrement spécifie la longueur d'enregistrement du fichier, lorsque l'option Enregistrements à longueur fixe est utilisée.
    4. Cliquez sur Suivant pour consulter le résumé des paramètres d'allocation sélectionnés pour le périphérique Disque.
  7. Lors de la sélection de l'option Imprimante en tant que périphérique :
    1. Sélectionnez le dossier d'applications contenant le fichier physique.

      Remarque : les dossiers d'applications du Serveur de rapports sont affichés par défaut et dépendent de la zone depuis laquelle l'Assistant d'allocations est appelé. Projets, Serveur de données, et Référentiel sont des exemples de dossiers d'application du serveur de rapports. Vous pouvez spécifier un fichier dans un répertoire autre que le Chemin d'accès à l'application du Serveur d'applications à l'aide de l'option Avancé depuis l'allocation une fois terminée.

    2. Cliquez sur Suivant puis saisissez le nouveau nom de fichier.

      ou

      Cliquez sur le bouton Naviguer pour afficher la fenêtre de dialogue Ouvrir puis effectuez votre sélection depuis la liste de fichiers existants.

      Remarque : le type de fichiers par défaut est Fichiers de données (*.dat). Vous pouvez également sélectionner Fichiers temporaires (*.ftm), et Tous les fichiers (*.*), comme type de fichier.

    3. Cliquez sur Suivant pour entrer le nom de l'imprimante.
    4. Cliquez sur Suivant pour consulter le résumé des paramètres d'allocation sélectionnés pour le périphérique Imprimante.

      Remarque : la syntaxe suivante s'applique à l'instruction FILEDEF lors de l'utilisation de le périphérique Imprimante :

      FILEDEF OFFLINE PRINTER BASEAPP/TEMPOFFLINE.FTM (PRINTER \\ibiprint\28C1
  8. Lors de la sélection de l'option Http en tant que périphérique :
    1. Entrez le chemin complet de l'URL.
    2. Cliquez sur Suivant pour consulter le résumé des paramètres d'allocation sélectionnés pour le périphérique Http.
  9. Lors de la sélection de l'option Terminal en tant que périphérique :
    1. Cliquez sur Suivant pour spécifier davantage d'options pour le périphérique Terminal.
      • Vous pouvez choisir d'envoyer l'entrée du clavier vers WebFOCUS telles qu'elles sont saisies (en minuscules ou casses mixtes). La valeur par défaut est de casse mixte. Sélectionnez cette option pour spécifier la casse en lettres minuscules.
    2. Cliquez sur Suivant pour consulter le résumé des paramètres d'allocation sélectionnés pour le périphérique Terminal.
  10. Lors de la sélection de l'option Effacer en tant que périphérique :
    1. Cliquez sur Suivant pour consulter le résumé des paramètres d'allocation supprimés.
  11. Cliquez sur Terminé pour fermer l'Assistant d'allocations et créer la commande FILEDEF.

    Le nom du fichier complété apparaît pour Affectation en dessous.

  12. Vous pouvez falcutativement cliquer sur Vérifier pour valider la commande FILEDEF.

    Une fenêtre de dialogue s'ouvre et affiche le code du composant et la confirmation qu'aucune erreur n'existe.

  13. Pour modifier l'allocation sélectionnée, faites un double clic ou un clic droit sur Modifier, afin d'ouvrir l'Assistant d'allocation à nouveau.
  14. Cliquez sur Avancé pour ouvrir la fenêtre de dialogue Allocations avancées.

    En utilisant la fenêtre de dialogue Allocation avancée, vous pouvez entrer la commande FILEDEF sans avoir recours à l'Assistant d'allocation.

  15. Cliquez sur OK pour fermer l'Assistant d'allocations une fois complété.

    Le composant Allocation est ajouté à la procédure. Vous pouvez double-cliquer sur le composant pour consulter à nouveau les options complétées de l'Assistant d'allocation.



x
Comment : Appel d'une procédure à partir d'une autre procédure

Dans l'exemple suivant, vous allez créer de procédure, une procédure de rapport et une procédure Exécuter. La première procédure, nommée salesrep, contiendra un rapport commercial avec des invites à la saisie de paramètres. La seconde procédure, SVALUES, contient les valeurs des paramètres dans SALESREP et exécute celle-ci. La création de ces procédures a pour résultat un rapport de ventes avec des valeurs de paramètres définies.

  1. Créez un rapport appelé salesrep, avec deux champs paramètres multi-sélection, par exemple état et région avec deux champs de somme, quantités vendues et revenu. Pour plus d'informations sur la création de paramètres, consultez Utilisation des Paramètres.
  2. Créez une procédure, appelée svalues. Depuis la Vue procédure, faites un clic droit sur Commentaires, pointez sur Nouveau puis sur Exécuter, comme le montre l'image suivante.

    Panneau Vue Procédure

  3. Ouvrez la fenêtre de dialogue Ouvrir fichier qui s'affiche, sélectionnez la procédure à appeler, par exemple, salesrep.

    La fenêtre de dialogue Résoudre paramètres de procédure s'ouvre, comme le montre l'image suivante.

  4. Sélectionnez des valeurs pour les paramètres Nom état et Région, par exemple, Connecticut et Florida pour Nom état et NorthEast et SouthEast pour Région.
  5. Cliquez sur OK.

    Le code dans le canevas Exécuter affiche le code Exécuter, avec les valeurs de paramètre, comme le montre l'image suivante.

    Code Exécuter

  6. Exécutez la procédure svalues.

    Le rapport de ventes s'affiche, comme le montre l'image suivante.



x
Comment : Créer une hiérarchie OLAP
  1. Ouvrez une procédure existante, ou créez-en une nouvelle.
  2. Dans le panneau Vue du fichier, faites un clic droit sur le dossier de la procédure ou le composant que vous souhaitez créer d'après la Hiérarchie OLAP, pointez vers Nouveau, puis cliquez sur Dimensions OLAP.

    La boîte de dialogue Ouvrir le fichier s'affiche.

  3. Sélectionnez un fichier Maître pour créer la hiérarchie OLAP.
  4. Cliquez sur Ouvrir.

    La zone de travail Dimensions OLAP s'ouvre.

  5. Déposez les champs du volet de gauche vers le volet de droite, sous Dimensions, pour créer votre Hiérarchie.

    Vous pouvez renommer les champs listés directement sous le nœud Dimensions avec un clic droit sur le champ et en sélectionnant Renommer. Pour supprimer un champ indésirable, faites un clic droit sur le nom de champ puis sélectionnez Supprimer.



x
Comment : Fusion de sources de données avec l'Assistant de correspondance (MATCH)
  1. Ouvrez une procédure existante, ou créez-en une nouvelle.
  2. Dans le panneau Vue du fichier, faites un clic droit sur le dossier de la procédure ou le composant que vous souhaitez créer d'après le MATCH, pointez vers Nouveau, puis cliquez sur MATCH.

    La boîte de dialogue Ouvrir le fichier s'affiche.

  3. Sélectionnez un fichier Maître à utiliser en premier dans l'expression logique MATCH.
  4. Cliquez sur OK.

    L'assistant MATCH s'ouvre dans une nouvelle zone de travail. Comme tous les Assistants, il propose une série d'étapes vous permettant de naviguer facilement dans le processus. Vous pouvez également utiliser la zone Aperçu MATCH pour naviguer dans l'assistant de correspondance.

  5. Sélectionnez les champs à utiliser pour créer la requête de MATCH dans la liste de champs disponibles.

    Vous pouvez ajouter un alias MATCH (indiquant le mode d'affichage du champ dans la liste de champs du fichier HOLD) et un opérateur préfixe pour chaque champ.

    Remarque : cliquez sur le bouton Supprimer pour supprimer des champs de cette liste. . Si vous ajoutez plus d'un champ, vous avez aussi la possibilité d'utiliser les boutons Monter et Descendre pour modifier l'ordre des champs.

  6. Vous pouvez sélectionner les commandes PRINT, SUM, ou LIST dans la liste déroulante.
  7. Pour ajouter un champ en tant que champ BY, cliquez sur son nom dans la liste de champs disponibles, puis cliquez sur le bouton Ajouter le champ dans la zone de liste de champs BY.

    Remarque : il faut inclure au moins un champ BY.

  8. Cliquez sur l'onglet WHERE/IF pour créer une expression WHERE ou une condition IF. Ceci a pour effet de limiter les enregistrements fusionnés.
  9. Cliquez sur le bouton Ajouter une expression WHERE ou Ajouter une condition IF pour ouvrir le Générateur d'expressions. Utilisez le Générateur d'expressions pour créer une condition IF/WHERE.
  10. Cliquez sur Suivant.

    Etape 3 de l'Assistant de correspondance s'affiche.

  11. Cliquez sur le bouton Naviguer pour sélectionner la source de données que vous souhaitez fusionner avec la source de données originales.

    La fenêtre de dialogue Ouvrir s'affiche.

  12. Sélectionnez un fichier Maître et cliquez sur Ouvrir.

    Etape 4 de l'Assistant de correspondance s'affiche.

  13. Ajoutez les champs pour la deuxième source de données, y compris un critère WHERE/IF, comme dans Etape 5.
  14. Cliquez sur Suivant.

    Etape 5 de l'Assistant de correspondance s'affiche.

  15. Tapez un nom pour le fichier HOLD et sélectionnez le type de phrase MATCH souhaité.
  16. Cliquez sur Terminer.

    La fenêtre Résumé de l'Assistant de correspondance s'affiche, vous permettant de consulter la requête MATCH finale.



x
Référence : Utilisation de la syntaxe -HTMLFORM

-HTMLFORM envoie la sortie de votre de rapport vers un fichier HTML que vous créez pour une page web, puis affiche cette page dans le navigateur. La sortie peut aussi s'enregistrer comme un fichier HTML qui peut s'afficher plus tard.

La syntaxe est :

-HTMLFORM filename [SAVE AS htmlpage]

ou

-HTMLFORM BEGIN
.
.
.
-HTMLFORM END

où :

filename

Il s'agit du fichier HTML qui contient les espaces réservés pour le rapport ou les rapports que WebFOCUS créé avec la commande :

ON TABLE HOLD HTMTABLE AS report
SAVE

Indique que la page HTML, créée quand le fichier HTML filename et le(s) rapports générés par WebFOCUS sont combinés, doit être enregistrée.

AS htmlpage

Est le nom de fichier pour la page HTML qui est créée quand le fichier HTML filename quand le(s) rapports générées par WebFOCUS sont combinés. Ce fichier est enregistré de façon à être affiche plus tard.

-HTMLFORM BEGIN

Indique le début d'un formulaire HTML en ligne dans une procédure.

-HTMLFORM END

Indique la fin d'un formulaire HTML en ligne dans une procédure.


WebFOCUS