Utiliser une source de données externe pour les données des abonnés (abonnements pilotés par les données)Use an External Data Source for Subscriber Data (Data-Driven Subscription)

Dans un abonnement piloté par les données, les données d'abonnement dynamiques sont fournies par une requête ou une commande qui récupère les données à partir d'une source de données externe.In a data-driven subscription, dynamic subscription data is provided by a query or command that retrieves data from an external data source. Il est possible de récupérer les données d'abonnement à partir de n'importe quelle source de données gérée qui répond aux impératifs du traitement des abonnements pilotés par les données.Subscription data can be retrieved from any supported data source that meets the requirements for data-driven subscription processing. La syntaxe de la requête ou de la commande doit être valide pour l'extension de traitement de données installée avec votre serveur de rapports.The query or command syntax must be valid for a data processing extension installed with your report server.

Impératifs liés au traitement des donnéesData Processing Requirements

Reporting ServicesReporting Services utilise les extensions pour le traitement des données afin de récupérer les données d’abonnement. uses data processing extensions to retrieve subscription data. Les types de sources de données recommandés sont les suivants :Recommended data source types include the following:

  • SQL ServerSQL Server bases de données relationnelles relational databases

  • Bases de données OracleOracle databases

  • Analysis ServicesAnalysis Services sources de données d’exploration de données et multidimensionnelles multidimensional and data mining data sources

  • Sources de données XMLXML data sources

    Lorsque vous utilisez l'extension de traitement des données XML pour les données des abonnés, veillez à augmenter les valeurs des paramètres de délai d'attente des requêtes dans l'abonnement.When using the XML data processing extension for subscriber data, be sure to increase the query timeout settings in the subscription. L'extension de traitement des données XML utilise des millisecondes (et non des secondes) pour les valeurs de délai d'attente des requêtes.The XML data processing extension uses milliseconds rather than seconds for query timeout values. Si vous n'augmentez pas la valeur du délai d'attente, il est possible que l'abonnement échoue en raison d'une durée de traitement insuffisante.If you do not increase the timeout value, the subscription might fail due to insufficient processing time.

    Évitez d’utiliser l’option Informations d’identification non requises quand vous configurez la connexion à la source de données de l’abonné.Avoid using the Credentials are not required option when configuring the connection to the subscriber data source. Il est recommandé d'opter pour des informations d'identification stockées lorsque vous utilisez l'extension de traitement des données XML pour récupérer les données d'abonnement lors de l'exécution.Stored credentials are recommended when using the XML data processing extension to retrieve subscription data at run time.

    Vous serez peut-être en mesure d'utiliser d'autres types de données pris en charge, mais il n'est pas certain qu'ils fonctionnent tous.You might be able to use other supported data source types, but not all of them are guaranteed to work. Par exemple, les types de sources de données suivants ne peuvent pas être utilisés pour les données des abonnés :For example, the following data source types cannot be used for subscriber data:

  • Bases de données SAP Netweaver BISAP Netweaver BI databases

  • Modèles de rapportreport models

    Si vous disposez d’une extension de traitement des données personnalisées que vous souhaitez utiliser dans les abonnements pilotés par les données, il doit implémenter la IDbCommand et IDataReader interfaces.If you have a custom data processing extension that you want to use in data-driven subscriptions, it must implement the IDbCommand and the IDataReader interfaces. L'extension de traitement des données doit prendre en charge une exécution de requête schéma exclusivement.The data processing extension must support a schema-only query execution. Cette requête permet de récupérer les métadonnées des colonnes lors de la conception, afin que les utilisateurs puissent mapper les colonnes aux options de remise et aux paramètres de rapport dans la définition d'abonnement.This query is used to retrieve column metadata at design-time so that users can map columns to delivery options and report parameters in the subscription definition. L'exécution de requêtes schéma exclusivement intervient très tôt dans le processus, lorsque l'utilisateur définit l'abonnement.Schema-only query execution occurs at an early stage when the user is defining the subscription.

Impératifs liés aux requêtesQuery Requirements

Lorsque vous créez une requête qui récupère les données d'abonnement, gardez à l'esprit les points suivants :When creating query that retrieves subscription data, keep the following points in mind:

  • Vous ne pouvez créer qu'une seule requête pour l'abonnement.You can only create one query for the subscription.

  • La requête doit retourner toutes les valeurs que vous voulez utiliser pour les options de remise et pour la spécification des paramètres de rapport.The query must return all of the values that you want to use for delivery options and for specifying report parameters.

  • Le serveur de rapports créera une remise de rapport pour chaque ligne du jeu de résultats.The report server will create a report delivery for every row in the result set. Si le premier jeu de résultats est composé de trois cents lignes, le serveur de rapports tentera de remettre trois cents rapports.If the result set consists of three hundred rows, the report server will attempt to deliver three hundred reports.

Définition des options de remise à l'aide de données de variable d'une base de données d'abonnésSetting Delivery Options Using Variable Data from a Subscriber Database

Vous pouvez utiliser les données de la base de données d'abonnés pour personnaliser les options de remise de chaque destinataire.You can use data in the subscriber database to customize delivery options for each recipient. Le type d'extension de remise que vous utilisez détermine les options disponibles.The kind of delivery extension you are using determines which options are available. Si vous utilisez l'extension de remise par messagerie électronique du serveur de rapports, la requête doit contenir une adresse de messagerie pour chaque abonné.If you are using the report server e-mail delivery extension, the query should contain an e-mail alias for each subscriber. Si vous utilisez une extension de remise par partage de fichiers, les données d'abonnés doivent inclure des valeurs pouvant être utilisées pour créer des fichiers de rapports spécifiques aux abonnés ou pour fournir une destination pour la remise.If you are using file share delivery, the subscriber data should include values that can be used to create subscriber-specific report files or to provide a destination for the delivery. Pour plus d’informations, consultez Remise par courrier électronique dans Reporting Services.For more information, see E-Mail Delivery in Reporting Services.

Transmission de valeurs de paramètres de la base de données d'abonnés au rapportPassing Parameter Values from the Subscriber Database to the Report

Si vous créez un abonnement piloté par les données pour un rapport paramétrable, vous pouvez utiliser des valeurs de paramètres de variable pour personnaliser la production de chaque rapport.If you are creating a data-driven subscription for a parameterized report, you can use variable parameter values to customize the output of each report. Par exemple, une base de données d'abonnés peut contenir des numéros d'identification d'employés, des dates d'embauche, des titres de fonction et des adresses de lieux de travail dont vous pouvez vous servir pour filtrer les données du rapport.For example, the subscriber database might contain employee identification numbers, hire dates, job titles, and office location information that can be used to filter report data. Si le rapport accepte des paramètres basés sur ces données de colonnes, vous pouvez mapper le paramètre à la colonne appropriée.If the report accepts parameters that are based on these or other available column data, you can map the parameter to the appropriate column.

Lors du mappage de champs d'abonné à des paramètres de rapport, vérifiez que les types de données et les longueurs de colonnes sont compatibles.When mapping subscriber fields to report parameters, make sure that the data types and column lengths are compatible. En cas de non-correspondance du type de données, une erreur se produit lors du traitement des abonnements.If there is a data type mismatch, an error will occur during subscription processing. Pour en savoir plus sur l’utilisation des données dans un rapport paramétrable, consultez Créer un abonnement piloté par les données (didacticiel SSRS).To learn more about using subscriber data in a parameterized report, see Create a Data-Driven Subscription (SSRS Tutorial).

Modification de la source de données des abonnésModifying the Subscriber Data Source

Les modifications suivantes apportées à la source de données peuvent empêcher l'exécution de l'abonnement :The following modifications to the subscriber data source can prevent the subscription from running:

  • suppression des colonnes référencées dans l'abonnement ;Removing columns that are referenced in the subscription.

  • modification de la structure de la table de la source de données ;Modifying the table structure of the data source.

  • modification du type de données et de diverses propriétés de colonne.Changing data type and other column properties.

    Si vous procédez à des modifications de ce type, vous devez mettre à jour l'abonnement.If you make any of these changes, you must update the subscription.

Voir aussiSee Also

Créer, modifier ou supprimer des abonnements pilotés par les données Create, Modify, and Delete Data-Driven Subscriptions
Data-Driven Subscriptions Data-Driven Subscriptions
Abonnements et remise (Reporting Services) Subscriptions and Delivery (Reporting Services)