Guide de l'utilisateur de TIBCO Spotfire® Business Author et Consumer

Configuration des fonctions de données

Lorsque vous exécutez une fonction de données, vous devez définir comment les paramètres d'entrée et de sortie de cette définition de fonction de données doivent être traités dans votre analyse. Il est nécessaire de spécifier un mappage de tous les paramètres requis pour Spotfire afin d'utiliser cette fonction de données dans une analyse. Cette rubrique contient des détails sur les différentes configurations qui peuvent être disponibles lors de l'exécution ou de la modification d'une fonction de données dans le client Web.

Avant de commencer

Les fonctions de données ont été créées à l'aide du client Spotfire installé et enregistrées dans la bibliothèque.
Remarque : Toutes les entrées requises et toutes les sorties (à l'exception de celles que vous excluez explicitement dans la vue récapitulative) doivent être configurées pour exécuter la fonction de données. Les entrées facultatives peuvent ne pas être configurées.

Procédure

  1. Suivez les étapes 1, 2 et 3 de la section Exécution de fonctions de données dans Spotfire Web Clients.
  2. Si la fonction de données est conçue pour utiliser des paramètres d'entrée afin de déterminer la base du calcul, vous devez configurer vos entrées.
    Par exemple, il peut s'agir d'une valeur, d'une colonne ou d'une table de données que vous sélectionnez dans votre analyse. Certaines fonctions de données ne nécessitent pas d'entrée et, dans certains cas, des entrées facultatives peuvent affiner le résultat du calcul. L'auteur de la fonction de données est la personne qui détermine ce que vous devez fournir, en spécifiant le type d'entrée et ce qui est requis.
    Conseil : S'il existe de nombreuses entrées dans la fonction de données sélectionnée et que seules certaines d'entre elles sont requises, vous pouvez cliquer sur Toujours afficher les entrées requises en premier pour déplacer les entrées facultatives à la fin de la liste et les masquer.

    Entrées :

    Vous ne pourrez pas choisir parmi tous les types d'entrée décrits ci-dessous lors de la spécification de l'entrée d'un paramètre sélectionné ; vous ne verrez que les options applicables à la fonction de données actuelle et à votre analyse.

    • Table de données - Vous permet de sélectionner une table de données dans la liste déroulante.

      (Le sélecteur de table de données est souvent une première étape avant de sélectionner une ou plusieurs colonnes, mais il peut également s'agir d'un type d'entrée distinct. Dans ce cas, le type d'entrée répertorie uniquement les tables de données dans lesquelles les colonnes de tous les types de données sont autorisées en tant qu'entrées de la fonction de données. Si vous ne trouvez pas la table de données souhaitée dans la liste, vous pouvez utiliser l'option Colonnes pour sélectionner toutes les colonnes de types de données autorisés à partir d'une table de données spécifique.)

    • Colonne - Vous permet de sélectionner une seule colonne dans la table de données spécifiée à l'aide de la liste déroulante.
    • Colonnes - Sélectionnez une ou plusieurs colonnes dans la boîte de dialogue Sélectionner des colonnes.
    • Expression de recherche - Vous permet de sélectionner un certain nombre de colonnes en fonction d'une expression de recherche (appuyez sur Entrée pour effectuer la recherche). Cette option est utile si vous souhaitez sélectionner plusieurs colonnes qui commencent par les mêmes lettres, par exemple.
    • Expression personnalisée - Vous permet de spécifier votre propre expression dans la boîte de dialogue Éditer l'expression.
    • Valeur - Vous permet de saisir une valeur d'entrée. La valeur est généralement accompagnée d'un sélecteur de type de données, dans lequel vous pouvez modifier le type de données pour la valeur saisie.
    • Aucun - Aucun gestionnaire d'entrée n'a été sélectionné ou aucune valeur par défaut n'existe. Vous pouvez utiliser cette option pour les paramètres d'entrée facultatifs. Si le paramètre d'entrée est requis, vous devez spécifier une entrée afin de poursuivre.

    L'option Limiter par vous permet de limiter les calculs basés sur des valeurs de colonne ou sur des tables de données aux lignes correspondant à une combinaison spécifiée de filtrages et de marquages uniquement. Si plusieurs options sont sélectionnées, seules les données des lignes correspondant à l'intersection des filtres et des marqueurs seront prises en compte dans les calculs. Pour que les calculs tiennent compte de toutes les lignes, n'ajoutez aucune limite.

    Conseil : Lorsqu'une instance de fonction de données a été ajoutée à une analyse et que les sorties sont des colonnes ou des lignes utilisées dans une visualisation, vous pouvez affiner vos valeurs d'entrée directement à partir de la visualisation et essayer rapidement différentes valeurs d'entrée. Vous pouvez également modifier les paramètres d'entrée et de sortie à partir de la vue Fonctions de données dans le Canevas de données.
  3. Déterminez si vous souhaitez Actualiser la fonction automatiquement.
    Cochez cette case pour automatiquement mettre à jour les résultats de la fonction de données à chaque fois que les paramètres d'entrée sont modifiés. Si la case n'est pas cochée, une actualisation manuelle sera nécessaire à chaque fois que vous souhaiterez qu'une mise à jour prenne effet. L'actualisation peut être effectuée à partir de la boîte de dialogue Propriétés de la fonction de données dans le client installé, ou un auteur Spotfire Analyst peut ajouter un contrôle d'action pour effectuer l'actualisation à partir d'une zone de texte.
    Une fonction de données configurée pour un chargement automatique basculera sur une mise à jour manuelle si des dépendances cycliques sont détectées dans l'analyse.
  4. Cliquez sur OK lorsque vous en avez terminé avec les entrées.
  5. La configuration des sorties détermine ce qu'il faut faire du résultat du calcul. Par exemple, vous pouvez obtenir une nouvelle table de données, de nouvelles colonnes ou lignes, ou une valeur de propriété de document qui peut être utilisée pour définir une ligne dans une visualisation, ou similaire. Les types de sortie disponibles dépendent de ce que produit la fonction de données sélectionnée (Valeur, Colonne ou Table) et de ce que vous avez actuellement dans votre analyse. Par exemple, si vous n'avez pas de table de données dans votre analyse lors de l'exécution de la fonction de données, la seule option dont vous disposez est d'ajouter une nouvelle table de données. Une fois que vous avez une table de données, plus d'options peuvent devenir disponibles.

    Sorties :

    • Ajouter en tant que nouvelle table de données - Vous permet de créer une table de données.
    • Ajouter en tant que lignes à la table de données spécifiée. Pour plus d'informations, reportez-vous à la rubrique Ajout de lignes à une table de données.
    • Ajouter en tant que colonnes à la table de données spécifiée, à l'aide d'une opération de jointure. Pour plus d'informations, reportez-vous à la rubrique Ajout de colonnes à une table de données.
    • Ajouter en tant que colonnes calculées à la table de données sélectionnée (finale).

      Si vous avez choisi de limiter l'entrée aux lignes marquées ou filtrées uniquement, l'option Mapper le résultat aux lignes limitées pour vous permet de spécifier comment les valeurs résultantes doivent être ajoutées à la table de données. Si cette case est décochée, les résultats seront ajoutés aux premières lignes de la table de données spécifiée. Mais si vous avez choisi de calculer les résultats pour les valeurs filtrées uniquement, vous préférerez probablement ajouter les résultats aux lignes qui ont été filtrées lorsque le calcul a été effectué. Sélectionnez le paramètre d'entrée à comparer dans la liste déroulante.

    • Remplacer la table de données – Vous permet de remplacer une table de données ajoutée précédemment en la sélectionnant dans la liste déroulante.
    • Ajouter en tant que valeur de propriété de document dans l'analyse. Vous pouvez définir une nouvelle propriété ou mettre à jour une propriété existante. Notez que si vous définissez une nouvelle propriété, elle ne sera créée que lorsque la fonction de données aura été correctement exécutée.
    • Ajouter en tant que valeur de propriété de table de données - Vous permet de sélectionner une table de données et de créer ou mettre à jour une propriété de table de données.
    • Ajouter en tant que valeur de propriété de colonne - Vous permet de sélectionner une table de données ou une colonne dans cette table, et de créer ou mettre à jour une propriété de colonne.
  6. Cliquez sur OK lorsque vous avez terminé.