Dans cette section : |
Les valeurs de paramètres et les contrôles d'insertion peuvent être créés avec une liste de valeurs statiques ou dynamiques.
Remarque : les contrôles actifs ne peuvent être associés à des paramètres dans la mise en page. Ce type de contrôle peut seuement être associé à un rapport actif dans la mise en page.
Remarque : les contrôles TDM ne peuvent pas être associés à des paramètres dans la mise en page. Ce type de contrôle ne peut être associé qu'avec certains contrôles d'entrées dans la mise en page.
L'onglet Paramètres vous permet de créer et de modifier les valeurs de paramètre, les contrôles d'entrée et de personnaliser les conditions de paramètres. Vous pouvez aussi lier les paramètres à des contrôles et chaîner les contrôles les uns aux autres. L'onglet Paramètres comprend :
Vous pouvez sélectionner le contrôle d'objet d'entrée à visionner et éditer les propriétés et paramètres du contrôle.
Cliquez-droite n'importe àù dans l'onglet Paramètres pour ajouter un nouveau paramètre.
Remarque : si vous ajoutez un paramètre manuellement, cela peut créer un paramètre non lié.
Lorsque vous déplacez un paramètre sur l'onglet Paramètres, une valeur de propriété est renseignée automatiquement. Sur le Panneau Propriétés, en dessous des propriétés document, la propriété Onglet Paramètres : organisation automatique est automatiquement placée sur Non lorsque vous déplacez un paramètre. Ceci indique que le paramètre est maintenu lorsque vous le déplacez après avoir navigué ailleurs, et que vous revenez ensuite à l'onglet Paramètres.
Vous pouvez réorganiser l'ordre des paramètres et des contrôles sur l'onglet Paramètres, qui renseignera automatiquement la valeur de propriété Onglet Paramètres : organisation automatique sur Non. Ceci veut dire que si vous naviguez en dehors de l'onglet Paramètres, et que vous y revenez, les objets ont été maintenus dans la position à laquelle vous les avaient placés. De plus, ceci indique que l'option Rcorganisation automatique des objets, qui est sélectionnée dans l'onglet HTML de la fenêtre de dialogue Options App Studio par défaut, sera remplacée.
Vous pouvez changer la valeur de la propriété Onglet Paramètres : organisation automatique sur Oui, pour annuler tout déplacement que vous avez effectué précédemment, et pour vous assurer que les objets de cet onglet utilisent la fonctionnalité d'organisation automatique.
Pour hériter de la valeur de l'option Réorganisation automatique des objets, vous pouvez placer la valeur de la propriété Onglet Paramètres : organisation automatique sur <Not Set>.
La propriété Onglet Paramètres : organisation automatique est disponible dans le panneau Propriétés. Pour accéder à cette propriété, vous devez sélectionner DOCUMENT dans la liste en haut du panneau.
Lorsque vous sélectionnez un objet sur l'onglet Paramètres, les propriétés pour cet objet s'afficheront automatiquement sur le panneau propriétés. Lorsque vous sélectionnez un objet de paramètres dans la liste déroulante du panneau propriétés, l'objet est automatiquement sélectionné dans l'onglet paramètres.
Tous les paramètres sous l'onglet Paramètres sont analysés toutes les deux minutes pour s'assurer qu'aucun d'entre eux n'est un paramètre non résolu. Si des paramètres non résolus sont trouvés, le polygone les entourant est de couleur rouge. Si vous souhaitez vérifier des paramètres non résolus sur demande, cliquez-droite et sélectionnez Actualiser les paramètres non résolus.
Les contrôles d'entrée et les paramètres peuvent être liés et déliés de l'onglet Paramètres.
Vous pouvez lier un paramètre à un contrôle d'entrée, ou lier un contrôle d'entrée à un paramètre.
Le chaînage entraîne le peuplement de contrôles basés sur la valeur sélectionnée du contrôle précédent dans la chaîne. Vous pouvez chaîner des contrôles dynamiques et statiques, lier ou délier des parties de chaînes et créer des conditions pour les liens dans une chaîne. Les chaînes sont représentées par des lignes connectant des objets de contrôle dans l'onglet paramètres. En cliquant sur la flèche d'en-tête d'un lien de chaîne, la fenêtre de dialogue propriétés et Paramètres vous permet de modifier et de définir les propriétés et/ou les condtions de la châine.
Remarque : le chaînage n'est applicable que pour les contrôles et non pas pour les paramètres.
Un paramètre indépendant est utile lorsque vous passez une valeur de paramètre utilisée dans une autre page. Vous pouvez également lier un nouveau paramètre à un contrôle pour créer un paramètre entrant, ou lier un contrôle à un paramètre.
Les étapes suivantes décrivent comment ajouter un nouveau paramètre :
Entrez l'information de la valeur du paramètre. Les options disponibles sont les suivantes Sélection unique, Multisélection OR, et Multisélection AND.
Remarque : l'option Sélection unique est l'option par défaut lors de l'ajout d'un nouveau paramètre.
Si ce champ reste vide, il applique automatiquement le format Alphanumérique au champ de valeur.
La valeur, l'affichage et les colonnes sélectionnées apparaissent.
Répétez ces étapes jusqu'à ce que la liste contienne toutes les valeurs que vous souhaitez inclure.
Conseil : vous pouvez aussi utiliser les boutons Annuler et Rétablir situés sur la barre d'outils Standard. Notez que l'option annuler/rétablir traite les dialogues Propriétés et Paramêtres comme action.
Vous pouvez sélectionner parmi les options suivantes lorsque vous créez une liste statique de paramètres :
Lorsque les options sont ajoutées à la liste Valeur, il est possible de personnaliser le texte d'affichage, mais non pas de modifier la valeur.
Vous pouvez créer un paramètre statique non lié, un paramètre statique entrant (un paramètre lié à un contrôle), ou un contrôle lié à un paramètre statique.
La fenêtre de dialogue Paramètres apparaît lors de la création ou la modification d'une valeur statique dans l'onglet Paramètres.
Les options disponibles sont déterminées selon le type de valeur statique.
La fenêtre de dialogue Propriétés et paramètres comprend les options et champs suivants lorsque le paramètre Statique est sélectionné comme type de données :
Détermine si les valeurs sont obtenues d'une liste statique ou dynamique rapport actif, ou d'une TDM.
Statique. Utilise une liste de valeurs de paramètre statique que vous fournissez. Une liste de valeurs statiques peut également être attribuée dans Report Générateur de rapports.
est une liste de valeurs fournie pour une liste statique.
Valeur. La valeur à passer au paramètre sélectionné.
Afficher. Le texte qui représente la valeur de paramètre dans le contrôle de l'utilisateur affiché par l'utilisateur. Remarque : cliquez sur Ctrl + Maj pour ajouter une valeur au champ d'affichage.
Sélectionné. La valeur qui sert de valeur par défaut. Si le contrôle est à sélection multiple, vous pouvez sélectionner plusieurs valeurs.
Nouveau. Crée une nouvelle valeur.
Supprimer. Supprime une valeur de paramètre fournie de la liste.
Vers le haut. Déplace la valeur sélectionnée vers le haut de la liste.
Vers le bas. Déplace la valeur sélectionnée vers le bas de la liste.
Sélectionnez cette option pour envoyer la valeur d'affichage défaut des données actuelles, vers le paramètre.
L'option Envoyer la valeur d'affichage apparaît lors de la création d'un paramètre entrant statique (un paramètre lié à un contrôle), ou lors de la création d'un contrôle non lié (un contrôle non lié à un paramètre). Ce paramètre n'est pas disponible lorsque vous créez un paramètre statique non lié.
Sélectionnez cette option pour obtenir un contrôle remplit avec les noms de procédures, afin que lors de la sélection d'une valeur, cette procédure est exécutée. La colonne Valeur est le nom de la procédure même et ne peut pas être modifiée. La colonne Affichage est modifiable.
La fenêtre de dialogue Propriétés et paramètres apparaît lors de la création ou la modification d'une valeur statique dans l'onglet Paramètres.
Les options disponibles sont déterminées selon le type de valeur statique.
La fenêtre de dialogue Propriétés et paramètres comprend les options et les champs suivants lors de l'ajout d'un paramètre non lié avec l'option Sélection unique. L'option Sélection unique devient l'option par défaut lors de l'ajout d'un nouveau paramètre :
Le nom attribué par défaut au paramètre. Vous pouvez à titre d'option saisir un nouveau nom pour le paramètre.
Le champ Format définit le format du paramètre, tel que A20, ou D12.2.
Champ falcutatif. Si ce champ reste vide, il applique automatiquement le format Alphanumérique au champ de valeur.
Entrez la valeur sélectionnée à attribuer au paramètre.
est une liste de valeurs fournie pour une liste statique.
Valeur. La valeur à passer au paramètre sélectionné.
Afficher. Le texte qui représente la valeur de paramètre dans le contrôle de l'utilisateur affiché par l'utilisateur. Remarque : cliquez sur Ctrl + Maj pour ajouter une valeur au champ d'affichage.
Sélectionné. La valeur qui sert de valeur par défaut. Si le contrôle est à sélection multiple, vous pouvez sélectionner plusieurs valeurs.
Nouveau. Crée une nouvelle valeur.
Supprimer. Supprime une valeur de paramètre fournie de la liste.
Vers le haut. Déplace la valeur sélectionnée vers le haut de la liste.
Vers le bas. Déplace la valeur sélectionnée vers le bas de la liste.
Le panneau Paramètres apparaît lorsque vous sélectionnez ou éditez un paramètre de limite sur l'onglet Paramètres.
Remarque : la fenêtre de dialogue Propriétés et Paramètres pour un paramètre n'est disponible qu'en lecture seule et affiche les valeurs pour le contrôle lié.
Le panneau Paramètres contient les valeurs en lecture seule suivantes :
Affiche la valeur sélectionnée pour les données de paramètres statiques.
Affiche la valeur d'affichage de paramètres statiques.
Les étapes ci-dessous décrivent comment ajouter manuellement une nouvelle valeur statique.
Vous pouvez créer un paramètre statique non lié, un paramètre statique entrant (un paramètre lié à un contrôle), ou un contrôle lié à un paramètre statique.
L'option Sélection unique devient l'option par défaut lors de l'ajout d'un nouveau paramètre :
Si ce champ reste vide, il applique automatiquement le format Alphanumérique au champ de valeur.
La valeur, l'affichage et les colonnes sélectionnées apparaissent.
Répétez ces étapes jusqu'à ce que la liste contienne toutes les valeurs que vous souhaitez inclure.
Un paramètre statique non lié est nécessaire lorsque vous passez une valeur de paramètre utilisé dans une autre page. Vous pouvez également lier un nouveau paramètre à un contrôle pour créer un paramètre entrant, ou lier un contrôle à un paramètre.
La liaison d'un nouveau paramètre à un contrôle crée un paramètre entrant. Un paramètre entrant est un paramètre statique lié à un contrôle. La valeur de paramètre va remplir le contrôle.
Le panneau Paramètres apparaît pour le contrôle.
Fermez cette fenêtre de dialogue puisque vous remplissez le contrôle avec la valeur de paramètre qui a déjà été créée dans l'étape 1.
Créez un contrôle avec des valeurs statiques et liez le contrôle à un paramètre pour remplir le paramètre avec des valeurs de contrôle.
Le curseur se transforme en pointeur en croix.
Le panneau Paramètres apparaît pour le contrôle.
Statique est sélectionné par défaut.
Répétez ces étapes jusqu'à ce que la liste contienne toutes les valeurs que vous souhaitez inclure.
Les options sont Calendrier, Case à cocher, Liste déroulante, Masqué, Zone de liste, bouton Radio, Zone de texte, Zone de texte, Structure de contrôle à source unique, et structure de contrôle à source multiple.
Au lieu d'ajouter de nouvelles valeurs statiques, vous ouvez également importer des paramètres de valeur statique que vous avez créés dans l'editeur de variable. Les valeurs de paramètres peuvent être des valeurs de données pour limiter vos données ou des noms de champs pour sélectionner les champs de votre rapport. Les deux types de liste statique peuvent être créés dans ReportPainter. Cet exemple décrit comment fournir une valeur de champ à un rapport à traver l'outil Développeur HTML et ReportPainter
Pour cet exemple, utilisez le fichier maître CAR (car.mas) qui est fourni avec developer Studio.
Dans le canevas HTML, insérez un nouveau rapport.
Le curseur se transforme en pointeur en croix.
La fenêtre de dialogue Ouvrir le s'affiche.
Le canvas Rapport s'ouvre.
La fenêtre de dialogue Editeur de variables s'ouvre.
Les champs sont ajoutés à la liste statique Accepter.
La fenêtre de dialogue Editeur de variables s'ouvre.
Les champs sont ajoutés à la liste statique Accepter.
Les variables sont ajoutées au rapport.
Remarque : si le paramètre doit être utilisé comme champ BY dans un rapport, il doit être du type de variable à sélection unique.
Vous êtes renvoyés vers l'outil Développeur HTML et lorsque vous ajoutez un rapport avec paramètres, la fenêtre de dialogue Paramètres apparaît.
Le rapport et les paramètres associés sont ajoutés comme valeurs statiques. Vous pouvez changer l'ordre ou rallonger les contrôles du rapport.
Sélectionnez le champ statique des valeurs (par champ et mesures associées) et exécutez le rapport.
L'option Ajouter une valeur Ignorer envoie FOC_NONE au serveur au moment de l'exécution ; elle est conçue pour une utilisation avec des applications complexes. L'option ajouter ou ignorer la valeur est disponible pour les paramètres statiques Multisélection OR et Multisélection AND.
Une procédure de rapport comprenant des paramètres nécessite la sélection de valeurs au moment de son exécution pour créer sa sortie.
Vous pouvez contrôler les paramètres associés à chaque contrôle avec l'onglet Paramètres. Vous pouvez contrôler les propriétés d'un contrôle avec l'onglet Paramètres.
Le panneau Paramètres s'ouvre.
Remarque : lorsque vous envoyez _FOC_NULL à une procédure toute clause de la procédure qui utilise cette variable sera ignorée.
Cette option utilise JavaScript pour envoyer toutes les valeurs de la liste des paramètres vers le serveur au moment de l'exécution. L'option Ajouter toute valeur est disponble pour les paramètres statiques Multisélection OR et Multisélection AND.
L'option Ajouter toute valeur n'est pas disponible pour une double liste de contrôle.
Le panneau Paramètres s'ouvre.
Cette option par défaut charge la liste statique de valeurs prédéfinies dans la procédure. Le paramètre Utilisation des valeurs de l'option procédure est disponible pour les paramètres statiques Sélections multiples OR et Sélections multiples AND, et lorsque vous ajoutez les champs de valeurs statiques à partir du Développeur de rapports.
Le panneau Paramètres s'ouvre.
Les noms de champ de la procédure apparaissent dans le panneau Paramètres.
Cette option vous permet d'utiliser un fichier local externe pour fournir des valeurs de paramètre. L'option Valeurs d'importation est disponible à partir d'un fichier local externe pour les paramètres statiques Multisélection OR et Multisélection AND.
Le panneau Paramètres s'ouvre.
La fenêtre de dialogue Ouvrir le s'affiche.
Le fichier externe peut comporter une seule valeur par ligne, ou deux valeurs par ligne, délimitées par des virgules.
Par exemple, dans le fichier texte suivant, BOS est la valeur de retour et Boston est la valeur d'affichage.
Les valeurs importées sont chargées dans la zone Valeurs statiques de l'onglet Paramètres.
S'il n'existe qu'une seule valeur sur la ligne dans le fichier texte, la valeur remplit à la fois les valeurs de donnée et les valeurs d'affichage.
Les valeurs dynamiques sont disponibles par défaut lorsqu'un champ de données utilisé dans la procédure est associé au contrôle sélectionné. Une liste dynamique récupère les valeurs de la source de données spécifiée lorsque la requête est exécutée.
La fenêtre de dialogue Prpopriététs et paramètres apparaît lorsque vous créez ou éditez un paramètre dynamique dans l'onglet Paramètres.
La fenêtre de dialogue Propriétés et paramètres comprend les options et les champs suivants lorsque l'option Dynamique est sélectionnée comme type de données.
Détermine si les valeurs sont obtenues d'une liste statique ou dynamique rapport actif, ou d'une TDM.
Dynamique utilise une liste de valeurs récupérées d'une source de données sélectionnée lorsque la requête est exécutée. C'est le type de contrôle par défaut lorsque vous utilisez une clause WHERE dans un fichier maître pour créer un paramètre de variable amper au sein d'une procédure.
La source de données depuis laquelle les données sont récupérées.
La procédure existante à appeler.
Vous pouvez modifier la procédure externe directement dans la fenêtre de dialogue Propriétés et paramètres dans l'onglet PAramètres. Si vous modifiez la requête, vous pouvez enregistrer la procédure externe et annuler le rapport original.
Le champ de source de données depuis lequel les valeurs sont récupérées.
Le texte qui représente la valeur de paramètre dans le contrôle de l'utilisateur affiché par l'utilisateur.
Il doit exister une relation entre le champ de valeur et le champ d'affichage. Le champ d'affichage est un texte convivial correspondant à la valeur de champ.
Conseil : vous pouvez modifier le code source manuellement si vous connaissez bien la syntaxe WebFOCUS. Par exemple, vous pouvez faire un clic droit et choisir Sélectionner un champ dans la source de données pour l'ajouter au rapport. Vous pouvez aussi faire un clic droit et choisir Utiliser la requête par défaut.
Le source code d'une procédure incorporée comprend la ligne //TODO: Ajouter vos filtres ici pour remplacer les valeurs par défaut, en tant qu'espace réservé pour entrer vos filtres, ou vos clauses WHERE, pour la requête pour résoudre au moment de l'exécution. Si vous entrez des filtres, seuls les filtres dynamiques peuvent être spécifiés.
La ligne //TODO doit rester dans le code source dans le but de résoudre les filtres au moment de l'exécution. Un tel exemple est visible lorsque les filtres sont basés sur les chaînes contenant des conditions. Si vous souhaitez spécifier vos filtres, alors supprimez cette ligne.
Conseil : vous pouvez modifier le code source manuellement si vous connaissez bien la syntaxe WebFOCUS. Par exemple, vous pouvez faire un clic droit et choisir Sélectionner un champ dans la source de données pour l'ajouter au rapport. Après la modification de la procédure externe associée à un contrôle, faites un clic droit et choisissez Recharger la procédure externe pour recharger et afficher la nouvelle syntaxe dans la fenêtre de dialogue Propriétés et Paramètres. Vous pouvez aussi faire un clic droit et choisir Enregistrer procédure externe. L'enregistrement de la procédure externe annule les requêtes originales.
Applique au contrôle l'option pour sélectionner toutes les valeurs de source de données. Vous pouvez remplacer Tout par un autre texte dans la zone du texte située à droite de l'option.
Optimise la performance en remplissant une chaîne un contrôle à la fois au lieur de tous les contrôles lorsque à l'ouverture de la page. Lorque vous sélectionnez l'option "Aucune sélection", cela vous permet de remplir les contrôles le cas échéant.
Lorsque vous ajoutez des paramètres dynamiques à la page HTML, les contrôles d'entrée récupèrent les données via des procédures. Sélectionnez cette option pour mettre en cache l'heure d'exécution des données pour le contrôle de saisie sélectionné. Ce paramètre est vide par défaut.
Ce paramètre écrase l'option Mettre en cache par défaut à partir de l'onglet Page HTML, située dans la fenêtre de dialogue Options de Developer Studio.
Indique qu'un nombre spécifique de valeurs de champ sera récupéré de la source de données. La spécification du nombre de champs s'effectue à l'aide du menu situé à droite de l'option.
Cliquez sur Tri vous permet de définir l'ordre de tri pour les valeurs d'affichage dans les listes de contrôles dynamiques. Cette option est utile lorsque vous souhaitez trier chaque contrôle indépendamment des autres.
Par défaut, la requête récupère les valeurs d'affichage dynamiques dans le champ de tro BY dans la requête. Les résultats affichent les valeurs d'affichage dans le champ de valeur.
Lorsque vous activez l'option Tri, vous pouvez trier la valeur d'affichage via le champ Valeur ou le champ Affichage sélectionné dans la fenêtre de dialogue Propriétés et paramètres. Le champ par défaut est le champ Valeur.
Lorsque l'option Tri est activée, vous pouvez sélectionner l'ordre de tri Croissant ou décroissant. L'ordre de tri par défaut est l'ordre croissant.
Sélectionnez cette option pour envoyer la valeur d'affichage défaut des données actuelles, vers le paramètre.
Entrer les valeurs à sélectionner comme valeur par défaut à chaque fois que la procédure est exécutée.
Lorsque vous créez une liste de valeurs dynamiques pour un rapport, vous pouvez supprimer les valeurs doubles des contrôles d'entrée.
Le panneau Paramètres apparaît lorsque vous sélectionnez ou éditez un paramètre de limite sur l'onglet Paramètres.
Remarque : la fenêtre de dialogue Propriétés et Paramètres pour un paramètre n'est disponible qu'en lecture seule et affiche les valeurs pour le contrôle lié.
Le panneau Paramètres contient les valeurs en lecture seule suivantes :
Affiche le fichier maître sélectionné pour la source de données du paramètre.
Affiche le champ de la valeur pour les données de paramètre dynamiques.
Affiche le champ d'affichage de paramètre dynamique.
Affiche la commande OR ou AND, s'il existe un paramètre dynamique Multisélection OR ou Multisélection AND.
Affiche la valeur sélectionnée, s'il en existe une d'attribué à la variable.
Les étapes suivantes décrivent comment créer une liste dynamique de valeurs :
Il est possible que vous deviez créer un contrôle dynamique lié à un paramètre. La création d'un contrôle avec des valeurs dynamiques et la liaison du contrôle à un paramètre remplit le paramètre avec les valeurs de contrôle.
Le curseur se transforme en pointeur en croix.
Le panneau Paramètres s'ouvre.
Les options Valeur dynamique apparaissent.
La fenêtre de dialogue Ouvrir s'ouvre.
L'Inspecteur d'objet s'ouvre avec le nom de champ du fichier maître sélectionné.
Conseil : vous pouvez également utiliser les icônes de l'Inspecteur d'objet pour sélectionner un champ et fermer l'Inspecteur d'objet. L'icône verte correspond à OK, l'icône rouge à Annuler, double-cliquez une valeur pour la sélectionner et fermez la fenêtre de dialogue sans utiliser un bouton, et maintenez appuyée la touche ESC pour annuler la fenêtre de dialogue sans utiliser un bouton.
Le champ sélectionné est automatiquement ajouté au champ Affichage et le code source de la procédure incorporée apparaît.
La ligne //TODO doit rester dans le code source dans le but de résoudre les filtres au moment de l'exécution. Un tel exemple est visible lorsque les filtres sont basés sur les chaînes qui comprennent les conditions. Si vous souhaitez spécifier vos filtres, alors supprimez cette ligne.
La fenêtre de dialogue Ouvrir s'ouvre.
Les noms de paramètre de la procédure sont automatiquement ajoutés au champ Valeur et au champ Affichage et le cource code de la procédure externe apparaît.
Conseil : vous pouvez également utiliser les icônes de l'Inspecteur d'objet pour sélectionner un champ et fermer l'Inspecteur d'objet. L'icône verte correspond à OK, l'icône rouge à Annuler, double-cliquez une valeur pour la sélectionner et fermez la fenêtre de dialogue sans utiliser un bouton, et maintenez appuyée la touche ESC pour annuler la fenêtre de dialogue sans utiliser un bouton.
Seuls les noms de paramètres de la procédure externe pourront être sélectionnés.
Les options sont Calendrier, Case à cocher, Liste déroulante, Masqué, Zone de liste, bouton Radio, Zone de texte, Zone de texte, Structure de contrôle à source unique, et structure de contrôle à source multiple.
Vous pouvez créer de nouveaux paramètres dynamiques en ajoutant un filtre au composant de rapport ou de graphique dans la mise en page.
La fenêtre de dialogue Options de filtre s'ouvre.
La fenêtre de dialogue Nouveaux paramètres s'ouvre.
Dans cette fenêtre de dialogue vous pouvez sélectionner un type de contrôle pour le paramètre ou modifier les paramètres plus tard à partir de l'onglet Paramètres.
Si la fenêtre de dialogue Nouveaux paramètres ne s'affiche pas, assurez-vous que l'option Afficher les nouveaux paramètres est sélectionnée dans la page HTML. Pour accéder à l'onglet Page HTML, sélectionnez Options à partir du menu Window pour ouvrir la fenêtre de dialogue Options de Developer Studio. A partir de la fenêtre de dialogue Options de Developer Studio, sélectionnez l'onglet Page HTML.
Répétez cette procédure pour tous les autres paramètres dans le rapport.
Cette option est utile lorsque vous souhaitez trier chaque contrôle indépendamment des autres.
Remarque : si les options de tri ne sont pas sélectionnées, la requête récupère les valeurs d'affichage dynamiques dans le champ de tri BY dans la requête, et les résultats affichent des valeurs basées sur la valeur de champ. Les options de tri ne sont pas sélectionnées par défaut.
Le panneau Paramètres s'ouvre.
Vous pouvez sélectionner les options Tri par et Ordre de tri pour le contrôle.
Conseil : vous pouvez répétez ces étapes et sélectionnez les options de tri pour chaque contrôle dynamique sur la page HTML.
Lorsque vous créez une liste de valeurs dynamiques pour un rapport, vous pouvez supprimer les valeurs doubles des contrôles d'entrée. Cela est utile si vous utilisez votre propre procédure sans source de données structurée.
L'option Vérifier les valeurs doubles est désactivée par défaut.
Le panneau Paramètres s'ouvre pour le contrôle d'entrée.
L'option Vérifier les valeurs doubles est seulement disponible lorsque vous créez une liste de valeurs dynamiques pour un contrôle d'entrée.
Le contrôle d'entrée supprime les entrées de valeur double.
L'exemple suivant montre une zone de liste avec une liste de valeurs CITY. la première zone de liste montre une liste de valeur avec des entrées doubles. La seconde zone de liste montre la liste avec des valeurs doubles supprimées.
Vous pouvez permettre la récupération personnalisée des valeurs de paramètre dynamiques. En utilisant une procédure personnalisée, vous pouvez utiliser le langage FOCUS pour employer des fichiers HOLD temporaires, le filtrage, etc. Cela permet une meilleur intégration du Développeur HTML et différentes sources de données de taille importante ou propriétaires qui peuvent nécessiter des méthodes de récupération spéciales. Cette procédure doit répondre aux critères suivants :
Remarque : différentes options spécifiées dans la même procédure peuvent utiliser cette option et la méthode de source de données.
Pour les paramètres enchaînés, il existe deux options selon que la mise en cache est activée ou non :
Dans l'exemple suivant, la même valeur est utilisée pour la valeur de soumission et la valeur d'affichage.
TABLE FILE GGSALES PRINT DST.PRODUCT BY PRODUCT ON TABLE SET HOLDLIST PRINTONLY ON TABLE PCHOLD FORMAT XML END
La sortie XML est :
<?xml version="1.0" encoding="ISO-8859-1" ?>
- <fxf version="1.0" data="hold">
- <report records="4317" lines="10" columns="2" rows="10">
<target format="" version="" type="" destination="HOLD" />
- <column_desc>
<col colnum="c0" fieldname="PRODUCT" alias="E01" datatype="char"
width="16" focus_format="A16" description="Product name"
accept="" help_message="" title="Product" within="" property=""
reference="" valign="left" />
<col colnum="c1" fieldname="PRODUCT" alias="E02" datatype="char"
width="16" focus_format="A16" description="Product name"
accept="" help_message="" title="Product" within="" property=""
reference="" valign="left" />
</column_desc>
- <table>
- <tr linetype="data" linenum="1">
<td colnum="c0">Biscotti</td>
<td colnum="c1">Biscotti</td>
</tr>
- <tr linetype="data" linenum="2">
<td colnum="c0">Capuccino</td>
<td colnum="c1">Capuccino</td>
</tr>
- <tr linetype="data" linenum="3">
<td colnum="c0">Coffee Grinder</td>
<td colnum="c1">Coffee Grinder</td>
</tr>
- <tr linetype="data" linenum="4">
<td colnum="c0">Coffee Pot</td>
<td colnum="c1">Coffee Pot</td>
</tr>
Dans l'exemple suivant, deux valeurs de champ sont utilisées pour la valeur de soumission et la valeur d'affichage. En ce cas, PRODUCT (description de produit) est utilisé comme valeur d'affichage et PCD (code de produit) est utilisé comme valeur de soumission.
TABLE FILE GGSALES PRINT DST.PRODUCT BY PCD ON TABLE SET HOLDLIST PRINTONLY ON TABLE PCHOLD FORMAT XML END
La sortie XML est :
<?xml version="1.0" encoding="ISO-8859-1" ?>
- <fxf version="1.0" data="hold">
- <report records="4317" lines="10" columns="2" rows="10">
<target format="" version="" type="" destination="HOLD" />
- <column_desc>
<col colnum="c0" fieldname="PCD" alias="E01" datatype="char"
width="4" focus_format="A04"
description="Product Identification code (for sale)" accept=""
help_message="" title="Product ID" within=""
property="" reference="" valign="left" />
<col colnum="c1" fieldname="PRODUCT" alias="E02" datatype="char"
width="16" focus_format="A16"
description="Product name" accept="" help_message=""
title="Product" within="" property="" reference=""
valign="left" />
</column_desc>
- <table>
- <tr linetype="data" linenum="1">
<td colnum="c0">C141</td>
<td colnum="c1">Espresso</td>
</tr>
- <tr linetype="data" linenum="2">
<td colnum="c0">C142</td>
<td colnum="c1">Latte</td>
</tr>
- <tr linetype="data" linenum="3">
<td colnum="c0">C144</td>
<td colnum="c1">Capuccino</td>
</tr> Remarque : la procédure ne doit pas contenir cette syntaxe FOCUS exacte, mais le résultat doit contenir deux valeurs par ligne de données au format XML.
Les procédures suivantes contiennent trois paramètres (REGION, ST, CITY). Comme la mise en mémoire cache est désactivée, chaque paramètre doit être mappée dans sa propre procédure.
Procedure 1 (REGION)
TABLE FILE GGSALES PRINT DST.REGION BY REGION ON TABLE SET HOLDLIST PRINTONLY ON TABLE PCHOLD FORMAT XML END
Procédure 2 (ST)
TABLE FILE GGSALES PRINT DST.ST BY ST WHERE REGION EQ '®ION'; ON TABLE SET HOLDLIST PRINTONLY ON TABLE PCHOLD FORMAT XML END
procédure 3 (CITY)
TABLE FILE GGSALES PRINT DST.CITY BY CITY WHERE REGION EQ '®ION'; WHERE ST EQ '&ST'; ON TABLE SET HOLDLIST PRINTONLY ON TABLE PCHOLD FORMAT XML END
Dans l'exemple suivant, comme la mise en mémoire cache est activée, une seule procédure est utilisée pour charger les contrôles.
TABLE FILE GGSALES PRINT DST.REGION DST.ST DST.CITY BY REGION BY ST BY CITY ON TABLE SET HOLDLIST PRINTONLY ON TABLE PCHOLD FORMAT XML END
La sortie XML est :
- <table>
- <tr linetype="data" linenum="1">
<td colnum="c0">Midwest</td>
<td colnum="c1">IL</td>
<td colnum="c2">Chicago</td>
<td colnum="c3">Midwest</td>
<td colnum="c4">IL</td>
<td colnum="c5">Chicago</td>
</tr>
Lorsque le nom d'un paramètre dynamique correspond à un nom de champ dans une source de données, le Développeur HTML charge automatiquement le nom de champ pour le paramètre.
La source de données est chargée par défaut selon la première source de données spécifiée par une commande TABLE FILE ou GRAPH FILE. La source de données du champ ets remplie pour les champs Valeur et Affichage dans la fenêtre de dialogue Propriétés et paramètres de l'onglet Paramètres (lorsque le paramètre Dynamique est sélectionné en tant que Type de données). Ceci génère un rapport de mise en page prêt à être exécuté tant que les noms de paramètres correspondent aux noms de champ.
Lorsque le rapport suivant est appelé dans le Développeur HTML avec un contrôle de bouton de contact, la fenêtre de dialogue Propriétés et paramètres pour le paramètre PRODUCT dans l'onglet Paramètres est automatiquement rempli pour récupérer dynamiquement les valeurs du champ PRODUCT.
TABLE FILE GGSALES SUM UNITS BY PRODUCT WHERE ( PRODUCT EQ '&PRODUCT.Product:.' ); END
Lorsque vous créez une liste de valeurs statiques ou dynamiques, vous pouvez y ajouter la valeur Tout afin de faire apparaître la valeur d'affichage dans le rapport.
La fonctionnalité Tout permet aux développeurs d'ajouter automatiquement la valeur Tout à une liste de valeurs de paramètre. La valeur ALL sert à :
Lorsque vous utilisez des valeurs de contrôle d'un rapport dynamique ou actif, vous pouvez entrer les valeurs à sélectionnées comme valeur par défaut chaque fois que la procédure est exécutée.
Remarque : vous pouvez également entrer la valeur sélectionnée lorsque vous ajoutez un nouveau paramètre non lié dans l'onglet Paramètres.
Dans le Développeur HTML, vous pouvez envoyer la valeur d'affichage, au lieu des données actuelles, au paramètre. la valeur d'affichage peut également être utilisé pour les en-têtes et les pieds de page dans la sortie de rapport.
L'option Envoyer la valeur d'affichage apparaît lors de la création d'un paramètre entrant statique (un paramètre lié à un contrôle), ou lors de la création d'un contrôle non lié (un contrôle non lié à un paramètre). Ce paramètre n'est pas disponible lorsque vous créez un paramètre statique non lié.
Lorsque vous importez un rapport contenant des paramètres, la fenêtre de dialogue Nouveaux paramètres s'ouvre vous invitant à créer le type de contrôle.
Le rapport et le de contrôle sont ajoutés au Développeur HTML.
Le panneau Paramètres s'ouvre.
Remarque : les options disponibles dans la fenêtre de dialogue Propriétés et paramètres varient, selon le type de valeurs (statique pu dynamique) que vous créez.
Répétez l'étape jusqu'à ce que la liste contienne toutes les valeurs désirées.
Remarque : vous pouvez aussi actualiser les valeurs d'affichage en utilisant l'éditeur de variables dans le Développeur de rapports.
Le paramètre Envoyer la valeur d'affichage n'est applicable que si vous utilisez un source de données qui contient à la fois une valeur de données interne et un champ que la valeur de données mappe pour l'affichage.
La fenêtre de dialogue Ouvrir s'ouvre.
L'Inspecteur d'objet s'ouvre avec le nom de champ du fichier maître sélectionné.
Le champ sélectionné est automatiquement ajouté au champ Affichage et le code source de la procédure incorporée apparaît.
Le paramètre Envoyer la valeur d'affichage est sélectionné par défaut.
La fenêtre de dialogue Ouvrir s'ouvre.
Les noms de paramètre de la procédure sont automatiquement ajoutés au champ Valeur et au champ Affichage et le cource code de la procédure externe apparaît.
Remarque : seuls les noms de paramètres de la procédure externe pourront être sélectionnés.
Le paramètre Envoyer la valeur d'affichage est sélectionné par défaut.
Le rapport est affiché dans l'Assistant Report .
Remarque : si la procédure de rapport l'utilise, &Variable_TEXT sera toujours passé, que l'option Envoyer la valeur d'affichage est sélectionnée ou pas.
L'en-tête en tant que valeur d'affichage &STCD_TEXT, dans lequel Store Code (STCD) est le nom de la variable.
Remarque : cette action est différente de celle où vous ajoutez la valeur à partir de la source de données, auquel cas un clic sur le nom de variable a pour effet d'ajouter <STCD à l'en-tête du rapport.
Lorsque vous créez la variable Texte (&Variable_TEXT), vous n'êtes pas invité à définir un type de contrôle lorsque vous retournez au Développeur HTML, comme aucun type de contrôle n'est nécessaire.
La valeur d'affichage est affichée dans l'en-tête du rapport.
Remarque : le Développeur HTML passe &var_TEXT si la procédure de rapport l'utilise, que la case Envoyer la valeur d'affichage soit cochée ou pas.
L'option Valeurs comme noms de procédures vous permet de remplir un contrôle avec des noms de procédure. Lorsque ce nom de procédure est sélectionné, la procédure s'exécute.
Remarque : dans cette procédure, une zone de liste est utilisée, toutefois, les contrôles suivants peuvent également utiliser l'option Valeurs comme noms de procédures : liste double, liste déroulante, bouton radio, et case à cocher.
Remarque : si le panneau paramètres ne s'ouvre pas, sélectionnez Voir puis cliquez sur Paramètres.
Remarque : vous pouvez ajouter plusieurs noms de procédure au panneau paramètres en faisant une multi-sélection de procédures lorsque vous êtes dans la fenêtre de dialogue Ouvrir.
La fenêtre de dialogue Propriétés du lien hypertexte s'affiche.
Cette option coïncide avec l'option Valeurs comme noms de procédures disponible dans la fenêtre de dialogue Propriétés et paramètres. Cette option indiquera une procédure complète pour le lien hypertexte, plutôt qu'une valeur simple. Cette option n'est disponible que lorsqu'un contrôle sur la page HTML utilise l'option Valeurs comme noms de procédures.
La source peut varier si vous utilisez un contrôle différent. Par exemple, combobox1, customselect1, radio1, ou checkbox1.
Vous pouvez également sélectionner Nouvelle fenêtre comme cible si vous souhaitez que la procédure soit ouverte dans une nouvelle fenêtre.
Le rapport est exécuté.
Lorsque vous utilisez des valeurs de contrôle d'un rapport dynamique ou actif, vous pouvez entrer les valeurs à sélectionnées comme valeur par défaut chaque fois que la procédure est exécutée.
Si vous importez une procédure (.fex) qui contient une valeur d'invite dynamique alors la zone de saisie est fournie avec des valeurs récupérées de la source de données. Si la valeur sélectionnée est disponible pour la sortie de rapport, les valeurs sont sélectionnées par défaut. Si la valeur sélectionnée n'est pas disponible dans les rapports de résultats, alors les valeurs que vous entrées sont ignorées et la première valeur récupérée de la source de données est sélectionnée.
Le rapport et le de contrôle sont ajoutés au Développeur HTML.
Le panneau Paramètres s'ouvre.
Remarque : les options disponibles dans la fenêtre de dialogue Propriétés et paramètres varient, selon le type de valeurs (statique pu dynamique) que vous créez.
La fenêtre de dialogue Ouvrir s'ouvre.
L'Inspecteur d'objet s'ouvre avec le nom de champ du fichier maître sélectionné.
Le champ sélectionné est automatiquement ajouté au champ Affichage et le code source de la procédure incorporée apparaît.
Les valeurs segmentées sont sensibles à la casse.
Conseil : vous pouvez entrer les valeurs sélectionnées séparées d'un point virgule ou d'une virgule. De plus, les valeurs de données peuvent elles-même contenir des virgules ou points virgule. Si vous avez ces caractères incorporés, vous devez encadrer toutes les valeurs dans la zone de saisie entre des les guillemets doubles. Par exemple :
ENGLAND;ITALY
ENGLAND,ITALY
“ENGLAND”,”IT,ALY”
Bien qu'une valeur du dernier ensemble contient la virgule incorporée, les deux doivent être encadrées par des guillemets doubles.
La fenêtre de dialogue Ouvrir s'ouvre.
Les noms de paramètre de la procédure sont automatiquement ajoutés au champ Valeur et au champ Affichage et le cource code de la procédure externe apparaît.
Remarque : seuls les noms de paramètres de la procédure externe pourront être sélectionnés.
Les valeurs segmentées sont sensibles à la casse.
Conseil : vous pouvez entrer les valeurs sélectionnées séparées d'un point-virgule (;) ou d'une virgule (,). De plus, les valeurs de données peuvent elles-même contenir des virgules ou points virgule. Si vous avez ces caractères incorporés, vous devez encadrer toutes les valeurs dans la zone de saisie entre des les guillemets doubles. Par exemple :
ENGLAND;ITALY
ENGLAND,ITALY
“ENGLAND”,”IT,ALY”
Bien qu'une valeur du dernier ensemble contient la virgule incorporée, les deux doivent être encadrées par des guillemets doubles.
Lorsque un rapport actif est sélectionné, l'option Actualiser des rapports actifs est activée par défaut.
Les valeurs segmentées sont sensibles à la casse.
Conseil : vous pouvez entrer les valeurs sélectionnées séparées d'un point virgule ou d'une virgule. De plus, les valeurs de données peuvent elles-même contenir des virgules ou points virgule. Si vous avez ces caractères incorporés, vous devez encadrer toutes les valeurs dans la zone de saisie entre des les guillemets doubles. Par exemple :
ENGLAND;ITALY
ENGLAND,ITALY
“ENGLAND”,”IT,ALY”
Bien qu'une valeur du dernier ensemble contient la virgule incorporée, les deux doivent être encadrées par des guillemets doubles.
Les valeurs segmentées sont sensibles à la casse.
Conseil : vous pouvez entrer les valeurs sélectionnées séparées d'un point virgule ou d'une virgule. De plus, les valeurs de données peuvent elles-même contenir des virgules ou points virgule. Si vous avez ces caractères incorporés, vous devez encadrer toutes les valeurs dans la zone de saisie entre des les guillemets doubles. Par exemple :
ENGLAND;ITALY
ENGLAND,ITALY
“ENGLAND”,”IT,ALY”
Bien qu'une valeur du dernier ensemble contient la virgule incorporée, les deux doivent être encadrées par des guillemets doubles.
Bien que le paramètre soit à sélection unique, plusieurs valeurs sont spécifiées et sélectionnées.
La sortie de rapport apparaît.
La valeur sélectionnée, si elle est disponible dans les résultats de rapports, est automatiquement sélectionnée (soulignée) dans la liste de paramètres.
Si la valeur sélectionnée n'est pas disponible dans les résultats de rapports, alors la valeur que vous entrez est ingorée et la première valeur récupérée de la source des données est affichée.
| WebFOCUS |