Tâche 3 : Ajout de redirection de flux d'erreurs
Comme nous l'avons démontré au cours de la tâche précédente, la transformation Lookup Currency Key ne peut pas générer de correspondance lorsqu'elle tente de traiter le fichier plat exemple endommagé qui a généré une erreur. Du fait que la transformation utilise les paramètres par défaut pour l'affichage en sortie des erreurs, toute erreur qui survient entraîne un échec de la transformation. Si la transformation échoue, le reste du package échoue également.
Pour éviter tout échec de la transformation, vous pouvez configurer le composant afin qu'il réachemine la ligne qui a échoué vers un autre chemin de traitement à l'aide de la sortie d'erreur. L'utilisation d'un chemin de traitement des erreurs distinct vous permet d'accomplir un certain nombre de choses. Par exemple, vous pouvez essayer de nettoyer les données puis de retraiter la ligne qui a échoué. Ou vous pouvez enregistrer la ligne qui a échoué avec d'autres informations d'erreur, pour la vérifier et la retraiter ultérieurement.
Au cours de cette tâche, vous allez configurer la transformation Lookup Currency Key afin qu'elle réachemine toutes les lignes échouant lors de la sortie d'erreur. Dans la branche d'erreur du flux de données, ces lignes sont enregistrées dans un fichier.
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.
Pour améliorer l'utilité de la sortie d'erreur, vous allez utiliser un composant Script pour accéder à l'API Integration Services et obtenir une description de l'erreur avant que le package n'enregistre les lignes ayant échoué dans le fichier.
Pour configurer une sortie d'erreur
Dans la Boîte à outils, développez Transformations du flux de données, puis faites glisser l'option Composant Script dans la zone de conception de l'onglet Flux de données. Placez le composant Script à droite de la transformation Lookup Currency Key.
Dans la boîte de dialogue Sélectionner le type de composant de script, cliquez sur Transformation, puis sur OK.
Cliquez sur la transformation Lookup Currency Key et faites glisser la flèche rouge vers la transformation Script que vous venez d'ajouter pour connecter les deux composants.
La flèche rouge représente la sortie d'erreur de la transformation Lookup Currency Key. En utilisant la flèche rouge pour connecter la transformation avec le composant Script, vous pouvez rediriger toutes les erreurs de traitement vers le composant Script, lequel traite ensuite les erreurs et les transmet au composant de destination.
Dans la colonne Erreur de la boîte de dialogue Configurer la sortie d'erreur, sélectionnez Réacheminer la ligne, puis cliquez sur OK.
Sur l'aire de conception Flux de données, cliquez sur Composant Script dans le ComposantScript que vous venez d'ajouter, puis remplacez le nom par Get Error Description.
Double-cliquez sur la transformation Get Error Description.
Dans la boîte de dialogue Éditeur de transformation de script, dans la page Colonnes d'entrée, sélectionnez la colonne ErrorCode.
Dans la page Entrées et sorties, développez Sortie 0, cliquez sur Colonnes de sortie, puis sur Ajouter une colonne.
Dans la propriété Name, tapez ErrorDescription et attribuez la valeur string [DT_WSTR] à la propriété DataType.
Dans la page Script, vérifiez que la propriété LocaleID est définie à Anglais (États-Unis).
Cliquez sur Modifier le script pour ouvrir Microsoft Visual Studio Tools for Applications (VSTA). Dans la méthode Input0_ProcessInputRow, tapez ou collez le code suivant.
[Visual Basic]
Row.ErrorDescription = Me.ComponentMetaData.GetErrorDescription(Row.ErrorCode)[Visual C#]
Row.ErrorDescription = this.ComponentMetaData.GetErrorDescription(Row.ErrorCode);La sous-routine terminée doit se présenter comme le code ci-dessous.
[Visual Basic]
Public Overrides Sub Input0_ProcessInputRow(ByVal Row As Input0Buffer) Row.ErrorDescription = Me.ComponentMetaData.GetErrorDescription(Row.ErrorCode) End Sub[Visual C#]
public override void Input0_ProcessInputRow(Input0Buffer Row) { Row.ErrorDescription = this.ComponentMetaData.GetErrorDescription(Row.ErrorCode); }Générez le script pour enregistrer vos modifications, puis fermez VSTA.
Cliquez sur OK pour fermer la boîte de dialogue Éditeur de transformation de script.