• Article

Procédure : définir les propriétés d'une variable

Pour définir les propriétés d'une variable définie par l'utilisateur dans Integration Services, vous pouvez utiliser l'une des fonctionnalités suivantes :

  • La fenêtre Variables.

  • La fenêtre Propriétés. Cette fenêtre répertorie les propriétés destinées à la configuration des variables qui ne sont pas disponibles dans la fenêtre Variables : Description, EvaluateAsExpression, Expression, ReadOnlyet ValueType.

Notes

Integration Services fournit également un ensemble de variables système dont les propriétés ne peuvent pas être mises à jour.

Définition de propriétés à l'aide de la fenêtre Variables

Pour définir les propriétés d'une variable à l'aide de la fenêtre Variables

  1. Dans Business Intelligence Development Studio, ouvrez le projet Integration Services contenant le package souhaité.

  2. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le package pour l'ouvrir.

  3. Dans le menu SSIS, cliquez sur Variables.

    Vous pouvez éventuellement afficher la fenêtre Variables en mappant la commande View.Variables avec une combinaison de clés de votre choix dans la page Clavier de la boîte de dialogue Options.

  4. Dans le menu Variables, cliquez sur Afficher toutes les variables.

  5. Si vous le souhaitez, cliquez sur Choisir les colonnes variables, puis, dans la boîte de dialogue Choisir les colonnes variables, sélectionnez les options de colonne souhaitées.

  6. Sélectionnez la variable dans la liste, puis mettez à jour les valeurs dans les colonnes Type de données, Valeur, Espace de noms et Raise Change Event.

    Notes

    Les valeurs de la colonne Valeur doivent être compatibles avec le type de données spécifié dans la colonne Type de données.

  7. Pour enregistrer le package mis à jour, dans le menu Fichier, cliquez sur Enregistrer les éléments sélectionnés.

Définition de propriétés à l'aide de la fenêtre Propriétés

Lorsque vous utilisez la fenêtre Propriétés pour définir les propriétés d'une variable définie par l'utilisateur :

  • La valeur d'une variable peut être définie par la propriété Value ou Expression. Par défaut, la propriété EvaluateAsExpression a la valeur False et la valeur de la variable est définie par la propriété Value. Pour définir la valeur à l'aide d'une expression, vous devez commencer par donner la valeur True à EvaluateAsExpression, puis fournir une expression dans la propriété Expression. Le résultat de l'évaluation de l'expression est automatiquement affecté à la propriété Value.

  • La propriété ValueType contient le type de données de la valeur dans la propriété Value. Lorsque Value est défini au moyen d'une expression, ValueType est automatiquement mis à jour avec un type de données compatible avec le résultat de l'évaluation de l'expression. Par exemple, si Value contient 0, si ValueType contient Int32 et si vous affectez la valeur GETDATE() à Expression, Value contient la date et l'heure actuelles, et ValueType a la valeur DateTime.

  • La fenêtre Propriétés de la variable permet d'accéder à la boîte de dialogue Générateur d'expressions. Vous pouvez utiliser cet outil pour créer, valider et évaluer des expressions. Pour plus d'informations, consultez Générateur d'expressions et Informations de référence des expressions Integration Services.

Pour définir les propriétés d'une variable à l'aide de la fenêtre Propriétés

  1. Dans Business Intelligence Development Studio, ouvrez le projet Integration Services qui contient le package souhaité.

  2. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le package pour l'ouvrir.

  3. Dans le menu Affichage, cliquez sur Fenêtre Propriétés.

  4. Dans le Concepteur SSIS, cliquez sur l'onglet Explorateur de package, puis développez le nœud Package.

  5. Pour modifier les variables avec une portée de package, développez le nœud Variables. Sinon, développez les nœuds Gestionnaires d'événements ou Exécutables jusqu'à ce que vous trouviez le nœud Variables contenant la variable que vous voulez modifier.

  6. Cliquez sur la variable dont vous souhaitez modifier les propriétés.

  7. Dans la fenêtre Propriétés, mettez à jour les propriétés en lecture/écriture de la variable. Certaines propriétés sont en lecture/lecture uniquement pour les variables définies par l'utilisateur.

    Le tableau suivant répertorie les variables qui peuvent être mises à jour.

    Propriété en lecture/écriture

    Action de mise à jour

    Description

    Modifiez la description.

    EvaluateAsExpression

    Affectez la valeur True pour utiliser le résultat de l'évaluation d'une expression dans la propriété Value.

    Expression

    Cliquez sur (…) pour ouvrir la boîte de dialogue Générateur d'expressions et créer l'expression à l'aide de cet outil graphique, ou tapez une expression.

    Name

    Pour les variables définies par l'utilisateur, modifiez le nom de la variable.

    Namespace

    Pour les variables définies par l'utilisateur, modifiez l'espace de noms.

    RaiseChangedEvent

    Affectez la valeur True pour déclencher un événement lorsque la variable change de valeur.

    ReadOnly

    Pour les variables définies par l'utilisateur, affectez la valeur True pour que la variable soit en lecture/écriture.

    Value

    Pour les variables définies par l'utilisateur, spécifiez une valeur. La valeur doit être compatible avec le type de valeur dans la propriété ValueType.

    ValueType

    Pour les variables définies par l'utilisateur, spécifiez le type de données de la valeur de la variable.

    Important

    Les valeurs des propriétés Name et Namespace doivent commencer par une lettre de conformément à la convention Unicode Standard 2.0 ou un trait de soulignement (_). Les caractères suivants peuvent être des lettres ou des nombres conformément à la convention Unicode standard 2.0, ou le trait de soulignement (_).

  8. Pour enregistrer le package mis à jour, dans le menu Fichier, cliquez sur Enregistrer les éléments sélectionnés.