Amélioration d'une sortie d'erreur à l'aide du composant Script

Par défaut, les deux colonnes supplémentaires d'une sortie d'erreur Integration Services, ErrorCode et ErrorColumn, contiennent uniquement des codes numériques identifiant un numéro d'erreur et l'ID de la colonne dans laquelle l'erreur est survenue. L'usage de ces valeurs numériques peut être limité sans la description d'erreur correspondante.

Cette rubrique décrit comment ajouter une colonne de description d'erreur à des données de sortie d'erreur existantes dans le flux de données en utilisant le composant Script. L'exemple ajoute la description d'erreur qui correspond à un code d'erreur Integration Services prédéfini spécifique à l'aide de la méthode GetErrorDescription de l'interface IDTSComponentMetaData100, disponible via la propriété ComponentMetaData du composant Script.

[!REMARQUE]

Si vous souhaitez créer un composant que vous pouvez réutiliser plus facilement dans plusieurs tâches de flux de données et plusieurs packages, utilisez le code présenté dans cet exemple de composant Script comme point de départ pour un composant de flux de données personnalisé. Pour plus d'informations, consultez Développement d'un composant de flux de données personnalisé.

Exemple

L'exemple indiqué ici utilise un composant Script configuré en tant que transformation pour ajouter une colonne de description d'erreur à des données de sortie d'erreur existantes dans le flux de données.

Pour plus d'informations sur la manière de configurer le composant Script pour l'utiliser en tant que transformation dans le flux de données, consultez Création d'une transformation synchrone à l'aide du composant Script et Création d'une transformation asynchrone à l'aide du composant Script.

Pour configurer cet exemple de composant Script

1. Avant de créer le composant Script, configurez un composant en amont dans le flux de données pour rediriger des lignes vers sa sortie d'erreur lorsqu'une erreur ou troncation se produit. À des fins de test, vous pouvez configurer un composant de manière à garantir que des erreurs se produiront, par exemple en configurant une transformation de recherche entre deux tables où la recherche échouera.

2. Ajoutez un nouveau composant Script à l'aire du concepteur de flux de données et configurez-le en tant que transformation.

3. Connectez la sortie d'erreur du composant en amont au nouveau composant Script.

4. Ouvrez l'Éditeur de transformation de script, puis dans la page Script, pour la propriété ScriptLanguage, sélectionnez le langage de script.

5. Cliquez sur Modifier le script pour ouvrir l'environnement de développement intégré Microsoft Visual Studio Tools for Applications (VSTA) et ajouter l'exemple de code indiqué ci-dessous.

6. Fermez VSTA.

7. Dans l'Éditeur de transformation de script, dans la page Colonnes d'entrée, sélectionnez la colonne ErrorCode.

8. Dans la page Entrées et sorties, ajoutez une nouvelle colonne de sortie de type String nommée ErrorDescription. Augmentez la longueur par défaut de la nouvelle colonne à 255 pour prendre en charge les longs messages.

9. Fermez l'Éditeur de transformation de script.

10. Attachez la sortie du composant Script à une destination appropriée. Les destinations de fichiers plats sont les plus faciles à configurer à des fins de test ad hoc.

11. Exécutez le package.

Public Class ScriptMain
    Inherits UserComponent
    Public Overrides Sub Input0_ProcessInputRow(ByVal Row As Input0Buffer)

  Row.ErrorDescription = _
    Me.ComponentMetaData.GetErrorDescription(Row.ErrorCode)

    End Sub
End Class

public class ScriptMain:
    UserComponent
{
    public override void Input0_ProcessInputRow(Input0Buffer Row)
    {

  Row.ErrorDescription = this.ComponentMetaData.GetErrorDescription(Row.ErrorCode);

    }
}

Voir aussi

Tâches

Gestion des erreurs dans les données

Concepts

Utilisation de sorties d'erreur dans un composant de flux de données

Création d'une transformation synchrone à l'aide du composant Script