Démarrage rapide avec l'interface de programmation

  Rubriques connexes

Propriétés

Méthodes

Evénements

Constantes prédéfinies

Correspondance des propriétés

ResultCodeConstants


Propriétés

ReportName

ReportName

ReportsServer

OutputDestination

OutputName

DatabaseUser

DatabasePassword

DatabaseName

ReportMode

UserDefinedParameters

CommandFile

OnRunSuccess

OnRunFailure

ShowParameterForm

PageSize

Orientation

NumberOfCopies

OutputDriver

CurrencyString

ThousandsCharacter

DecimalCharacter

ArrayBufferKBSize

VirtualMemoryKBSize

LongColumnBufferKBSize

SetTransactionReadOnly

AutomaticCommit

NonBlockingSQL

DebuggingChecks

ProfileLogFile

ErrorLogFile

TraceLogFile

TraceMode

TraceLogAll

TraceLogPerformance

TraceLogReportsObjects

TraceLogPLSQLObjects

TraceLogSQLTrace

TraceLogTimeStamp

TraceLogErrors

CallMode

CallTimeout

CallFrequency

JobTolerance

JobName

JobSchedule

SystemUser

SystemPassword

JobNotifyOnSuccess

JobNotifyOnFailure

Distribute

Destination


Méthodes

GetCommandLine

GetReportStateCode

GetReportStateCodeString

GetReportStateString

RunReport

RunReportSimple

SetDefaults

Terminate Report

GetOutputName


Evénements

AfterRunReport

BeforeRunReport

RunReportProgress


Constantes prédéfinies

OutputDestinationConstants

ReportModeConstants

CallModeConstants

OrientationConstants

OnRunConstants

TraceModeConstants

ResultCodeConstants


Correspondance des propriétés avec les arguments de ligne de commande

Propriété de contrôle ActiveX	Argument de ligne de commande Serveur d'états/Reports Runtime
ArrayBufferKBSize	ARRAYSIZE
AutomaticCommit	AUTOCOMMIT
CallFrequency	n/a
CallMode	n/a
CallTimeout	n/a
CommandFile	CMDFILE
CurrencyString	CURRENCY
DatabaseUser	USERID
DatabasePassword	USERID
DatabaseName	USERID
DebuggingChecks	RUNDEBUG
DecimalCharacter	DECIMAL
Destination	DESTINATION
Répartir	DISTRIBUTE
DocumentName	REPORT
ErrorLogFile	ERRFILE
JobTolerance	TOLERANCE  (serveur seulement)
JobName	JOBNAME  (serveur seulement)
JobSchedule	SCHEDULE (serveur seulement)
JobNotifyOnSuccess	NOTIFYSUCCESS (serveur seulement)
JobNotifyOnFailure	NOTIFYFAILURE (serveur seulement)
LongColumnBufferKBSize	LONGCHUNK
NonBlockingSQL	NONBLOCKSQL
NumberOfCopies	COPIES
OnRunFailure	ONRUNFAILURE
OnRunSuccess	ONRUNSUCCESS
Orientation	ORIENTATION
OutputDestination	DESTYPE
OutputDriver	DESFORMAT
OutputName	DESNAME
PageSize	PAGESIZE
ProfileLogFile	PROFILE
ReportMode	MODE
ReportName	REPORT
ReportsServer	SERVER
SetTransactionReadOnly	READONLY
ShowParameterForm	PARAMFORM
SystemUser	AUTHID
SystemPassword	AUTHID
ThousandsCharacter	THOUSANDS
TraceLogFile	TRACEFILE
TraceMode	TRACEMODE
TraceLogAll	TRACEOPTS=TRACE_ALL
TraceLogErrors	TRACEOPTS=TRACE_ERR
TraceLogPerformance	TRACEOPTS=TRACE_PRF
TraceLogPLSQLObjects	TRACEOPTS=TRACE_PLS
TraceLogReportsObjects	TRACEOPTS=TRACE_APP
TraceLogSQLTrace	TRACEOPTS=TRACE_SQL
TraceLogTimeStamp	TRACEOPTS=TRACE_TMS
UserDefinedParameters	paramètres d'état définis par l'utilisateur
VirtualMemoryKBSize	BUFFERS


Correspondance des arguments de ligne de commande avec les propriétés

Argument de ligne de commande Serveur d'états/Reports Runtime	Propriété de contrôle ActiveX
n/a	CallFrequency, CallMode, CallTimeout
ARRAYSIZE	ArrayBufferKBSize
AUTHID	SystemPassword, SystemUser
AUTOCOMMIT	AutomaticCommit
BUFFERS	VirtualMemoryKBSize
CMDFILE	CommandFile
COPIES	NumberOfCopies
CURRENCY	CurrencyString
DECIMAL	DecimalCharacter
DESTYPE	OutputDestination
DESFORMAT	OutputDriver
DESNAME	OutputName
DESTINATION	Destination
DISTRIBUTE	Répartir
ERRFILE	ErrorLogFile
JOBNAME  (serveur seulement)	JobName
LONGCHUNK	LongColumnBufferKBSize
MODE	ReportMode
NONBLOCKSQL	NonBlockingSQL
NOTIFYSUCCESS	JobNotifyOnSuccess
NOTIFYFAILURE	JobNotifyOnFailure
ONRUNFAILURE	OnRunFailure
ONRUNSUCCESS	OnRunSuccess
ORIENTATION	Orientation
PAGESIZE	PageSize
PARAMFORM	ShowParameterForm
PROFILE	ProfileLogFile
READONLY	SetTransactionReadOnly
REPORT	DocumentName, ReportName, _ReportName
RUNDEBUG	DebuggingChecks
SCHEDULE (serveur seulement)	JobSchedule
TOLERANCE  (serveur seulement)	JobTolerance
SERVER	ReportsServer
THOUSANDS	ThousandsCharacter
TRACEFILE	TraceLogFile
TRACEMODE	TraceMode
TRACEOPTS=TRACE_ALL	TraceLogAll
TRACEOPTS=TRACE_ERR	TraceLogErrors
TRACEOPTS=TRACE_PRF	TraceLogPerformance
TRACEOPTS=TRACE_PLS	TraceLogPLSQLObjects
TRACEOPTS=TRACE_APP	TraceLogReportsObjects
TRACEOPTS=TRACE_SQL	TraceLogSQLTrace
TRACEOPTS=TRACE_TMS	TraceLogTimeStamp
USERID	DatabaseUser
paramètres d'état définis par l'utilisateur	UserDefinedParameters
USERID	DatabasePassword, DatabaseName


Correspondance des propriétés

Correspondance des propriétés avec les arguments de ligne de commande

Correspondance des arguments de ligne de commande avec les propriétés


Page Général


Page Source de données


Page Options de sortie


Page Options de paramètre


Page Options d'exécution


Page Options de débogage


Page Options de planification


Page Options de serveur


Page Options de notification


Page Authentification système


vh


ReportName

La propriété ReportName (ou DocumentName) est le nom de l'état à exécuter. Vous pouvez indiquer tout fichier d'exécution valide (c'est-à-dire un fichier dont le suffixe est .rdf ou .rep). Si vous n'entrez pas de suffixe de fichier, Report Builder recherche d'abord un fichier avec le suffixe .rep, puis avec le suffixe .rdf et enfin sans suffixe.

dispid(1) pour ReportName, dispid(2) pour DocumentName
Type : BSTR
Correspond au paramètre de ligne de commande REPORT.


ReportsServer

La propriété ReportsServer est l'adresse TNS de Reports Server.

dispid(3)
Type : BSTR
Correspond au paramètre de ligne de commande SERVER.


OutputDestination

La propriété OutputDestination est le type de périphérique de destination qui recevra la sortie d'état. Voir OutputDestinationConstants.

dispid(4)
Type : court
Correspond au paramètre de ligne de commande DESTYPE.


OutputName

La propriété OutputName est le fichier, l'imprimante ou l'adresse de messagerie auxquels la sortie d'état sera acheminée. Vous pouvez indiquer plusieurs noms utilisateur en les mettant entre parenthèses et en séparant chacun d'eux par une virgule (par exemple, (<nom>, <nom>, . . .<nom>)).

dispid(5)
Type : BSTR
Correspond au paramètre de ligne de commande DESNAME.


DatabaseUser

La propriété DatabaseUser est votre nom utilisateur et votre mot de passe ORACLE, avec une adresse Net80 facultative (pas le compte SYSTEM).

dispid(6)
Type : BSTR
Correspond au paramètre de ligne de commande USERID.


DatabasePassword

La propriété DatabasePassword est le mot de passe ORACLE pour l'utilisateur de base de données indiqué dans la propriété DatabaseUser.

dispid(7)
Type : BSTR
Correspond au paramètre de ligne de commande USERID.


DatabaseName

La propriété DatabaseName est l'adresse Net80 de la base de données dans laquelle s'exécutera l'état.

dispid(8)
Type : BSTR
Correspond au paramètre de ligne de commande USERID.


ReportMode

La propriété ReportMode permet d'indiquer si l'état doit être exécuté en mode caractère ou en mode bitmap. Vous pouvez ainsi exécuter un état en mode caractère depuis Report Builder en mode bitmap ou vice-versa. Par exemple, si vous souhaitez envoyer un état à une imprimante Postscript depuis un terminal (par exemple, un terminal vt220), vous pouvez appeler RWRUN60 en mode caractère et exécuter l'état avec MODE=BITMAP. Voir ReportModeConstants.

dispid(9)
Type : court
Correspond au paramètre de ligne de commande MODE.


UserDefinedParameters

La propriété UserDefinedParameters est une liste des paramètres utilisateur pour l'état dans le format de ligne de commande (par exemple, monparam1=yes monparam2=10).

dispid(10)
Type : BSTR
Représente la chaîne des paramètres de ligne de commande définis par l'utilisateur.


CommandFile

La propriété CommandFile est un fichier contenant des arguments pour la commande d'exécution. Cette option vous permet d'exécuter un état sans devoir indiquer un grand nombre d'arguments pour chaque exécution.

dispid(11)
Type : BSTR
Correspond au paramètre de ligne de commande CMDFILE.


OnRunSuccess

La propriété OnRunSuccess permet d'indiquer si vous souhaitez que soit effectuée une opération de validation (COMMIT) ou d'annulation (ROLLBACK) à la fin de l'exécution de l'état. Voir OnRunConstants.

dispid(12)
Type : court
Correspond au paramètre de ligne de commande ONRUNSUCCESS.


OnRunFailure

La propriété OnRunFailure permet d'indiquer si vous souhaitez que soit effectuée une opération de validation (COMMIT) ou d'annulation (ROLLBACK) si une erreur se produit et que l'état ne soit pas exécuté. Voir OnRunConstants.

dispid(13)
Type : court
Correspond au paramètre de ligne de commande ONRUNFAILURE.


ShowParameterForm

La propriété ShowParameterForm permet d'afficher la grille de paramètres d'exécution lorsque vous exécutez un état.

dispid(14)
Type : booléen
Correspond au paramètre de ligne de commande PARAMFORM.


PageSize

La propriété PageSize property est la taille de la page physique (c'est-à-dire, la taille de la page imprimée) définie par la largeur et la hauteur de page. Notez que la page doit être suffisamment grande pour contenir l'état. Par exemple, si la taille d'un encadrement dans un état s'avère supérieur à celle de la page, l'état ne sera pas exécuté.

dispid(15)
Type : BSTR
Correspond au paramètre de ligne de commande PAGESIZE.


Orientation

La propriété Orientation permet de définir la direction d'impression des pages d'un état. Voir OrientationConstants.

dispid(16)
Type : court
Correspond au paramètre de ligne de commande ORIENTATION.


NumberofCopies

La propriété NumberofCopies est le nombre de copies de l'état à imprimer.

dispid(17)
Type : long
Correspond au paramètre de ligne de commande COPIES.


OutputDriver

La propriété OutputDriver permet d'indiquer le pilote d'imprimante (pour les environnements en mode bitmap), les caractéristiques d'imprimante (pour les environnements en mode caractère), PDF (Portable Display Format) ou HTML.

dispid(18)
Type : BSTR
Correspond au paramètre de ligne de commande DESFORMAT.


CurrencyString

La propriété CurrencyString est le symbole monétaire à utiliser dans les formats numériques.

dispid(19)
Type : BSTR
Correspond au paramètre de ligne de commande CURRENCY.


ThousandsCharacter

La propriété ThousandsCharacter est le séparateur des milliers à utiliser dans les formats numériques.

dispid(20)
Type : BSTR
Correspond au paramètre de ligne de commande THOUSANDS.


DecimalCharacter

La propriété DecimalCharacter est la décimale à utiliser dans les formats numériques.

dispid(21)
Type : BSTR
Correspond au paramètre de ligne de commande DECIMAL.


ArrayBufferKBSize

La propriété ArrayBufferKBSize est la taille du tableau en kilo-octets pour le traitement de tableaux ORACLE. En général, plus la taille du tableau est grande, plus l'état s'exécute rapidement.

dispid(22)
Type : long
Correspond au paramètre de ligne de commande ARRAYSIZE.


VirtualMemoryKBSize

La propriété VirtualMemoryKBSize est la taille du cache de mémoire virtuelle en kilo-octets. Vous devez définir ce paramètre afin d'avoir suffisamment d'espace pour exécuter vos états. Gardez-vous toutefois de faire appel à trop de ressources de votre système.

dispid(23)
Type : long
Correspond au paramètre de ligne de commande BUFFERS.


LongColumnBufferKBSize

La propriété LongColumnBufferKBSize est la taille (en kilo-octets) des incréments dans lesquels Report Builder extrait une valeur de colonne LONG. Lorsque vous extrayez une valeur LONG, vous pouvez souhaiter l'extraire par incréments plutôt que tout à la fois, à cause de restrictions de taille de mémoire. LONGCHUNK ne s'applique qu'à ORACLE7.

dispid(24)
Type : long
Correspond au paramètre de ligne de commande LONGCHUNK.


SetTransactionReadOnly

La propriété SetTransactionReadOnly exige une cohérence de lecture entre les interrogations multiples d'un état. Lorsque vous accédez à des données depuis ORACLE, la cohérence de lecture est effectuée par une instruction SET TRANSACTION READ ONLY (pour plus d'informations sur cette instruction, reportez-vous aux guides Oracle7 Server SQL Language Reference et Oracle8 Server SQL Reference).

dispid(25)
Type : booléen
Correspond au paramètre de ligne de commande READONLY.


AutomaticCommit

La propriété AutoCommit permet d'indiquer si les modifications de base de données (par exemple, CREATE) doivent être automatiquement validées dans la base de données. Notez que certaines bases de données autres que ORACLE (par exemple, SQL Server) exigent que la présente propriété soit définie à YES (AUTOCOMMIT=YES).

dispid(26)
Type : booléen
Correspond au paramètre de ligne de commande AUTOCOMMIT.


NonBlockingSQL

La propriété NonBlockingSQL permet d'autoriser d'autres programmes à s'exécuter pendant que Report Builder extrait des données de la base de données.

dispid(27)
Type : booléen
Correspond au paramètre de ligne de commande NONBLOCKSQL.


DebuggingChecks

La propriété DebuggingChecks permet d'effectuer à l'exécution un contrôle supplémentaire des erreurs logiques dans l'état.

dispid(28)
Type : booléen
Correspond au paramètre de ligne de commande RUNDEBUG.


ProfileLogFile

La propriété ProfileLogFile est le nom d'un fichier dans lequel vous souhaitez stocker des statistiques de performance sur l'exécution de l'état. Si vous indiquez un nom de fichier, Report Builder établit des statistiques sur le temps écoulé et le temps UCT utilisé pour exécuter l'état.

dispid(29)
Type : BSTR
Correspond au paramètre de ligne de commande PROFILE.


ErrorLogFile

La ErrorLogFile property is the name of a file in which you want Report Builder to store all error messages that are issued during the execution of your report.

dispid(30)
Type : BSTR
Correspond au paramètre de ligne de commande ERRFILE.


TraceLogFile

La propriété TraceLogFile est le nom du fichier dans lequel Report Builder consigne les informations de trace.

dispid(31)
Type : BSTR
Correspond au paramètre de ligne de commande TRACEFILE.


TraceMode

La propriété TraceMode permet d'indiquer si Report Builder doit ajouter les informations de trace dans le fichier ou supprimer le fichier en entier. Voir TraceModeConstants.

dispid(32)
Type : court
Correspond au paramètre de ligne de commande TRACEMODE.


TraceLogAll

La propriété TraceLogAll permet d'indiquer que toutes les informations de trace doivent être consignées dans le fichier de trace. Cette propriété annule toutes les autres propriétés de trace.

dispid(33)
Type : booléen
Correspond au paramètre de ligne de commande TRACEOPTS=TRACE_ALL.


TraceLogPerformance

La propriété TraceLogPerformance permet d'indiquer que les statistiques de performance doivent être consignées dans le fichier de trace.

dispid(34)
Type : booléen
Correspond au paramètre de ligne de commande TRACEOPTS=TRACE_PRF.


TraceLogReportsObjects

La propriété TraceLogReportsObjects permet d'indiquer que les informations de trace sur tous les objets état doivent être consignées dans le fichier de trace.

dispid(35)
Type : booléen
Correspond au paramètre de ligne de commande TRACEOPTS=TRACE_APP.


TraceLogPLSQLObjects

La propriété TraceLogPLSQLObjects permet d'indiquer que les informations de trace sur tous les objets PL/SQL doivent être consignées dans le fichier de trace.

dispid(36)
Type : booléen
Correspond au paramètre de ligne de commande TRACEOPTS=TRACE_PLS.


TraceLogSQLTrace

La propriété TraceLogSQLTrace permet d'indiquer que les informations de trace sur tous les SQL doivent être consignées dans le fichier de trace.

dispid(37)
Type : booléen
Correspond au paramètre de ligne de commande TRACEOPTS=TRACE_SQL.


TraceLogTimeStamp

La propriété TraceLogTimeStamp permet d'indiquer qu'un horodatage doit figurer pour chaque entrée du fichier de trace.

dispid(38)
Type : booléen
Correspond au paramètre de ligne de commande TRACEOPTS=TRACE_TMS.


TraceLogErrors

La propriété TraceLogErrors permet d'indiquer que les messages d'erreur et les avertissements doivent être consignés dans le fichier de trace.

dispid(39)
Type : booléen
Correspond au paramètre de ligne de commande TRACEOPTS=TRACE_ERR.


CallMode

La propriété CallMode permet d'indiquer si l'état doit être exécuté via Reports Server ou Reports Background Engine. Si vous choisissez Reports Server, vous devez également indiquer si l'appel doit être synchrone ou asynchrone. Voir CallModeConstants.

dispid(40)
Type : court.


CallTimeout

La propriété CallTimeout est le délai d'attente d'une réponse du serveur.

dispid(41)
Type : long.


CallFrequency

La propriété CallFrequency est la fréquence à laquelle Reports Server doit être appelé pour l'état du travail.

dispid(42)
Type : long


JobTolerance

La propriété JobTolerance permet d'indiquer une tolérance de temps pour les travaux dupliqués. Si le même état a été lancé avec les mêmes paramètres à l'intérieur de la tolérance indiquée, la demande en cours est reconnu comme travail dupliqué, et la sortie de mémoire cache est réutilisée plutôt que l'état ne soit exécuté à nouveau.

dispid(43)
Type : long
Correspond au paramètre de ligne de commande TOLERANCE.


JobName

La propriété JobName est le nom du travail tel qu'il figurera dans Reports Queue Manager.

dispid(44)
Type : BSTR
Correspond au paramètre de ligne de commande JOBNAME.


JobSchedule

La propriété JobSchedule est une commande de planification indiquant quand et combien de fois l'état doit être exécuté. Cette propriété fait appel à la syntaxe de commande de planification AT. Par exemple, hourly_from_09:00am_December_25,_1999.

dispid(45)
Type : BSTR
Correspond au paramètre de ligne de commande SCHEDULE.


SystemUser

La propriété SystemUser correspond au nom utilisateur et au mot de passe WebDB qui vous permettent d'exécuter des états sur le serveur Reports Server restreint.

dispid(55)
Type : BSTR
Correspond au paramètre de ligne de commande AUTHID.


SystemPassword

La propriété SystemPassword correspond au mot de passe de l'utilisateur indiqué dans la propriété SystemUser.

dispid(56)
Type : BSTR
Correspond au paramètre de ligne de commande AUTHID.


JobNotifyOnSuccess

  Rubriques connexes

La propriété NotifyOnSuccess envoie un message de notification aux adresses électroniques indiquées lorsqu'un travail est exécuté correctement. Le programme exécutable du serveur lit un modèle de contenu de notification précisé dans le fichier de configuration du serveur.

Le paramètre SUCCNOTEFILE doit être défini dans ce fichier de configuration pour que le serveur puisse envoyer le message de notification. Pour plus d'informations, contactez l'administrateur de votre système. Remarque

Le message de notification précise le nom du travail, le serveur d'états, ainsi que l'heure à laquelle le travail a pris fin.

Dispid(57)
Type : BSTR
Correspond au paramètre de ligne de commande NOTIFYSUCCESS.


Si le serveur ne trouve pas le fichier modèle ou si le fichier de configuration du serveur ne comprend pas les paramètres SUCCNOTEFILE ou FAILNOTEFILE, le serveur consigne une erreur dans un fichier journal uniquement si le paramètre LOGOPTIONest indiqué. Contactez l'administrateur de votre système pour obtenir plus d'informations.


JobNotifyOnFailure

  Rubriques connexes

La propriété NotifyOnFailure envoie un message de notification aux adresses électroniques indiquées lorsqu'un travail n'est pas exécuté. Le programme exécutable du serveur lit un modèle de contenu de notification précisé dans le fichier de configuration du serveur.

Le paramètre FAILNOTEFILE doit être défini dans ce fichier de configuration pour que le serveur puisse envoyer le message de notification. Contactez l'administrateur de votre système pour obtenir plus d'informations. Remarque

Le message de notification précise le nom du travail, le nom du serveur, l'heure à laquelle le travail a été interrompu et la raison de cet arrêt.

dispid(58)
Type : BSTR
Correspond au paramètre de ligne de commande NOTIFYFAILURE.


Répartir

La propriété Distribute active ou désactive la diffusion de la sortie d'état vers plusieurs destinations, comme l'indique la liste de diffusion définie dans la boîte de dialogue de diffusion ou dans un fichier DST.

dispid(59)
Type : BOOLEAN
Correspond au paramètre de ligne de commande DISTRIBUTE.


Destination

La propriété Destination permet d'indiquer le nom du fichier DST qui définit la diffusion de la session actuelle de l'état.

dispid(60)
Type : BSTR
Correspond au paramètre de ligne de commande DESTINATION.


GetCommandLine

La méthode GetCommandLine construit une ligne de commande sur la base des valeurs en cours des propriétés de contrôle. Elle renvoie ensuite cette ligne de commande sous forme de chaîne.

dispid(49),
Prototype: BSTR GetCommandLine();


GetReportStateCode

La méthode GetReportStateCode extrait le statut en cours (résultat ou code de progression) d'un état donné (ReportHandle). Les codes renvoyés sont les mêmes que ceux transmis dans les événements de contrôle. Voir ResultCodeConstants.

dispid(50),
Prototype: long GetReportStateCode([in] long ReportHandle);


GetReportStateCodeString

La méthode GetReportStateCodeString extrait une chaîne lisible par l'utilisateur pour le résultat ou le code de progression indiqué. Voir ResultCodeConstants.

dispid(51)
Prototype: BSTR GetReportStateCodeString([in] long Code);


GetReportStateString

La méthode GetReportStateString extrait une chaîne de résultat ou de progression lisible par l'utilisateur pour le statut en cours d'un état donné (ReportHandle).

dispid(52)
Prototype: BSTR GetReportStateString([in] long ReportHandle);


RunReport

La méthode RunReport exécute un état avec le serveur d'états ou Reports Background Engine en utilisant les valeurs en cours des propriétés de contrôle. Elle renvoie ReportHandle et un code de résultat ou de progression pour la soumission de l'état (et non le résultat de l'exécution de l'état). Notez que cet appel est toujours aynchrone et qu'il n'attend jamais la fin de l'exécution d'un état. Si vous désirez un fonctionnement synchrone, vous devez utiliser d'autres codes de progression transmis via les événements de contrôle ou renvoyés par la méthode GetReportStateCode afin de l'organiser par programmation. Pour plus d'informations sur les codes de progression et de résultat, reportez-vous à ResultCodeConstants.

dispid(46)
Prototype: long RunReport([in, out] long ReportHandle);


RunReportSimple

La méthode RunReportSimple englobe la méthode RunReport. Elle exécute un état avec le serveur d'états ou Reports Background Engine sans générer d'événements de contrôle (CallFrequency=0; CallTimeout=0; CallMode=Local/Async). Aucun ReportHandle n'est transmis.

dispid(47)
Prototype: long RunReportSimple();


SetDefaults

La méthode SetDefaults impose les valeurs par défaut de toutes les propriétés de contrôle. Cette méthode n'affecte pas les valeurs de propriétés des états qui sont déjà en cours d'exécution.

dispid(48)
Prototype: void SetDafaults();


TerminateReport

La méthode TerminateReport met fin à l'exécution de l'état indiqué (ReportHandle). Elle renvoie des codes de résultats identiques à ceux transmis dans les événements de contrôle. Voir ResultCodeConstants.

dispid(53)
Prototype: long TerminateReport([in] long ReportHandle);


GetOutputName

La méthode GetOutputName obtient le nom de fichier d'un état lorsqu'il a été envoyé dans la mémoire cache du serveur d'états, orODToServerCache. Notez que pour extraire des fichiers de la mémoire cache du serveur d'états, vous devez partager le système de fichiers où se trouve cette mémoire cache.

dispid(54)
Prototype: BSTR GetOutputName([in] long ReportHandle);


BeforeRunReport

L'événement BeforeRunReport se déclenche juste avant que le contrôle soumette un état pour exécution.

dispid(2)
Prototype: void AfterRunReport([in] long ReportHandle, [in] long ResultCode);


AfterRunReport

L'événement AfterRunReport se déclenche juste après que le contrôle a fini d'exécuter l'état. Il indique le résultat de l'exécution de l'état. Voir ResultCodeConstants.

dispid(1)
Prototype: void BeforeRunReport([in] long ReportHandle);


RunReportProgress

L'événement RunReportProgress se déclenche pendant que le contrôle est dans le processus d'exécution de l'état. Il indique la progression de l'état selon la fréquence demandée. Voir ResultCodeConstants.

dispid(3)
Prototype: void RunReportProgress([in] long ReportHandle, [in] long ProgressCode);


OutputDestinationConstants

OutputDestinationConstants désigne les constantes utilisées pour les valeurs de la propriété OutputDestination.

Constante	Description
orODInReport = 0	Utilise la valeur indiquée dans le fichier de l'état.
orODToLocalFile = 1	Envoie l'état vers un fichier local.
orODToFile = 2	Envoie l'état vers un fichier .
orODToPrinter = 3	Envoie l'état vers une imprimante.
orODToMail = 4	Envoie l'état vers une messagerie électronique.
orODToScreen = 5	Envoie l'état à l'écran.
orODToPreview = 6	Envoie l'état à l'Aperçu (en utilisant les polices d'imprimante).
orODToServerCache = 7	Envoie l'état dans la mémoire cache du serveur d'états.
Notes d'utilisation

•	Si vous utilisez le serveur d'états et que vous indiquez orODToLocalFile = 1, le fichier en sortie sera transféré au système de fichiers local. Si vous indiquez orODToFile = 2, le fichier en sortie sera envoyé du côté du serveur d'états.

•	orODToScreen = 5 et orODToPreview = 6 sont les seules valeurs valides pour Reports Background Engine (rwrbe60.exe)


ReportModeConstants

ReportModeConstants désigne les constantes utilisées pour les valeurs de la propriété ReportMode.

Constante	Description
orRMInReport = 0	Utilise la valeur indiquée dans le fichier de l'état.
orRMBitmapMode = 1	Exécute l'état en mode bitmap.
orRMCharacterMode = 2	Exécute l'état en mode caractère.


CallModeConstants

CallModeConstants désigne les constantes utilisées pour les valeurs de la propriété CallMode.

Constante	Description
orCMCallLocal = 0	Soumet l'état à Reports Background Engine en appelant l'exécutable rwisv60.exe, qui à son tour appelle rwrbe60.exe. Lorsque la variable d'environnement OROCX_USE_RUNTIME est définie, c'est l'exécutable rwrun60.exe qui est appelé.
orCMCallSync = 1	Appelle le serveur d'états en mode communication synchrone, ce qui engendre un trafic moindre sur le réseau car l'appel RPC n'est utilisé qu'une seule fois pour la soumission du travail.
orCMCallAsync = 2	Appelle le serveur d'états en mode communication asynchrone. Cette option présente l'avantage de pouvoir donner le statut précis de l'état pendant son exécution (place dans la file d'attente, messages d'erreur et avertissements importants, etc.).


OrientationConstants

OrientationConstants désigne les constantes utilisées pour les valeurs de la propriété Orientation.

Constante	Description
orOInReport = 0	Utilise la valeur indiquée dans le fichier de l'état.
orOInPrinter = 1	Utilise l'orientation actuellement sélectionnée pour l'imprimante.
orOPortrait = 2	Utilise l'orientation portrait.
orOLandscape = 3	Utilise l'orientation paysage.


OnRunConstants

OnRunConstants désigne les constantes utilisées pour les valeurs des propriétés OnRunSuccess et OnRunFailure.

Constante	Description
orORInReport = 0	Utilise la valeur indiquée dans le fichier de l'état.
orORCommit = 1	Effectue une opération COMMIT lorsque l'état est terminé.
orORRollback = 2	Effectue une opération ROLLBACK lorsque l'état est terminé.
orORNoAction = 3	N'effectue aucune opération lorsque l'état est terminé.


TraceModeConstants

TraceModeConstants désigne les constantes utilisées pour les valeurs de la propriété TraceMode.

Constante	Description
orTMInReport = 0	Utilise la valeur indiquée dans le fichier de l'état.
orTMAppend = 1	Ajoute les informations nouvelles à la fin du fichier journal de trace existant.
orTMReplace = 2	Remplace le fichier journal de trace existant par les nouvelles informations.


ResultCodeConstants

ResultCodeConstants désigne les constantes utilisées comme codes d'erreur, de progression et de résultat dans les événements et méthodes de contrôle.

Constante	Description
orResNoError = 0	Code de réussite générale.
OrResFailed = 1	Erreur dans le contrôle ActiveX Reports.
OrResNoComm = 10	Erreur : impossible d'initialiser la connexion avec le serveur d'états. Vérifiez que le réseau est configuré correctement et que le serveur d'états est actif.
OrResNoMemory = 11	Erreur : mémoire insuffisante.
OrResNoResources = 31	Erreur : impossible d'exécuter l'état. Le système est à court de ressources et la création de l'objet thread ou synchronisation de thread est impossible.
OrResParInvalid = 32	Erreur : impossible d'exécuter l'état.  Les valeurs d'une ou plusieurs propriétés ne sont pas valides. Vérifiez la valeur des propriétés de contrôle et essayez à nouveau.
orResParMissing = 33	Erreur : impossible d'exécuter l'état.  Les valeurs d'une ou plusieurs propriétés obligatoires (ReportName, DatabaseUser et ReportsServer, sauf en cas d 'exécution locale) n'ont pas été indiquées. Indiquez les valeurs nécessaires et essayez à nouveau.
orResLocalExeNotFound = 34	Erreur : impossible d'exécuter l'état.  Vous avez choisi d'exécuter l'état à l'aide de l'exécutable de Reports Background Engine. Il est introuvable ou n'a pas été installé correctement.
orResTimeout = 35	La valeur indiquée pour CallTimeout a été atteinte avant l'exécution complète de l'état. L'état a été interrompu par le délai de temporisation.
orResTooManyConnections = 36	Erreur : impossible d'exécuter l'état. Il existe trop de connexions actives sur le serveur d'états. Essayez à nouveau ultérieurement.
orResListenerNone = 37	Erreur : impossible d'exécuter l'état.  Le serveur d'états ne répond pas. Vérifiez qu'il est installé correctement et actif.
orResListenerBusy = 38	Erreur : impossible d'exécuter l'état.  Le serveur d'états est occupé et refuse la connexion. Essayez à nouveau ultérieurement.
orResListenerBad = 39	Erreur : impossible d'exécuter l'état.  Connexion impossible au serveur d'états. Le nom TNS de réseau du serveur d'états n'est pas valide ou est inconnu. Vérifiez la configuration de votre réseau.
orResBadCommandLine = 40	Erreur : impossible d'exécuter l'état.  Le serveur d'états rejette la ligne de commande transmise. Vérifiez les valeurs des propriétés de contrôle.
orResBadSchedule = 41	Erreur : impossible d'exécuter l'état.  Le serveur d'états rejette les paramètres de planification transmis. Vérifiez les valeurs des propriétés de contrôle.
orResServerShutdown = 42	Erreur : impossible d'exécuter l'état. Arrêt du serveur d'états. Essayez à nouveau ultérieurement.
orResServerError = 43	Erreur : impossible d'exécuter l'état.  Une erreur s'est produite lors de la mise de l'état dans la file d'attente du serveur d'états. Le serveur est peut-être à court de ressources. Essayez à nouveau ultérieurement.
orResExecutableBad = 44	Erreur : impossible d'exécuter l'état.  L'exécutable est corrompu ou n'est pas dans un format binaire correct.
orResNoSuchJob = 45	Le travail n'existe pas ou est déjà terminé.
orResJobEnqueued = 46	Etat en cours d'exécution : le travail a été mis en file d'attente par le serveur d'états et son exécution est planifiée.
orResJobRunning = 47	Etat en cours d'exécution : le travail est exécuté par le moteur du serveur d'états.
orResJobParForm = 48	Etat en cours d'exécution : le moteur du serveur d'états affiche la grille de paramètres de l'état et attend une entrée de l'utilisateur.
orResJobPreviewer = 49	Etat en cours d'exécution : le moteur du serveur d'états affiche l'aperçu de l'état et attend une entrée de l'utilisateur.
orResJobFinished = 50	L'état a été exécuté avec succès.
orResJobTerminated = 51	L'état est terminé. Une ou plusieurs erreurs se sont produites pendant son exécution.
orResJobCrashed = 52	Erreur fatale du serveur d'états : le moteur du serveur d'états s'est planté en tentant d'exécuter l'état.
orResJobCancelled = 53	L'exécution de l'état est terminée. Le travail a été annulé à la demande de l'utilisateur ou de l'administrateur.
orResSecurityProblems = 54	Erreur : impossible d'effectuer l'opération demandée pour des raisons de sécurité. Vérifiez vos droits, votre id utilisateur et votre mot de passe.
orResCallServerInProgress = 55	Communication avec le serveur d'états. L'état est en cours d'exécution.
orResCallServerSubmitted = 56	En attente de la permission de communiquer avec le serveur d'états.
orResCallServerInit = 57	Préparation de la demande d'exécution de l'état pour la soumettre au serveur d'états.
orResExecutingLocal = 58	Exécution de l'état à l'aide de Reports Background Engine sur un ordinateur local.
orResJobOpeningReport = 59	Etat en cours d'exécution. Le moteur du serveur d'états ouvre et lit le fichier de définition de l'état.
orResOutputDestinationInvalid = 60	Erreur : impossible d'exécuter l'état. La propriété OutputDestination a pour valeur ToScreen ou ToPreview. Une destination interactive n'est autorisée que pour une exécution locale. Modifiez la valeur et essayez à nouveau.
orResLocalFileNotFound = 61	Erreur : impossible d'exécuter l'état. Une des propriétés a pour valeur le nom d'un fichier impossible à ouvrir. Rectifiez le nom de fichier et essayez à nouveau.
orResLocalFileBad = 62	Erreur : impossible d'exécuter l'état. Une des propriétés a pour valeur le nom d'un fichier impossible à créer. Rectifiez le nom de fichier et essayez à nouveau.
orResOutputTransfer = 63	L'état a été exécuté avec succès. Etat en cours de transfert entre le serveur à distance et un fichier local.
orResNoOutputTransfer = 64	L'état s'est terminé avec une erreur : l'état n'est pas disponible et ne peut pas être transféré vers le système de fichiers local. La cause peut en être une erreur dans l'exécution de l'état ou une erreur d'entrée-sortie de fichier.
OrResLocalOutputNameBad = 65	L'état a été exécuté avec succès, mais il ne peut pas être transféré vers un système de fichiers local. Le nom du fichier local est erroné ou il ne peut pas être créé ou ouvert.
orResServerIOFailed  = 66	Erreur : le serveur d'états a détecté une erreur d'entrée-sortie de fichier.
orResClientIOFailed = 67	Erreur : erreur d'entrée-sortie de fichier sur l'ordinateur local. Vérifiez le système de fichiers local.
orResBadJobTolerance  = 68	Erreur : impossible d'interpréter la tolérance de temps. Vérifiez la valeur de la propriété JobTolerance.
orResBadReportName  = 69	Le nom de l'état n'a pas été indiqué. Vérifiez la valeur de la propriété ReportName.
orResBadDatabaseUser = 70	La connexion de base de données n'a pas été indiquée. Vérifiez la valeur des propriétés DatabaseUser, DatabasePassword et DatabaseName.
orResListenerNLS = 71	Connexion impossible au serveur d'états. Le serveur d'états portant le nom TNS indiqué utilise un jeu de caractères différent du vôtre et la conversion est impossible.


Messages et erreurs

•	Les propriétés de contrôle ne génèrent pas d'exceptions, et il est possible de les obtenir ou de les définir à tout moment. Les valeurs non valides ne sont pas prises en compte.

•	Les méthodes d'information (telles que GetCommandLine, SetDefaults, GetReportStateCode, GetReportStateCodeString et GetReportStateString) ne génèrent pas non plus d'exceptions.

•	Si la soumission d'un état pour exécution échoue pour une raison quelconque, il se produit une exception OLE Automation. Si la soumission aboutit avec succès, le contrôle renvoie un identificateur d'état permettant de suivre la progression de cet état (par exemple, dans l'événement RunEventProgess).

•	L'état est considéré en cours d'exécution à partir du moment où l'identificateur d'état a été renvoyé jusqu'au moment où l'événement AfterRunReport est déclenché.

•	Le contrôle utilise un seul code de statut pendant toute l'exécution de l'état. Celui-ci est renvoyé par les méthodes RunReport, TerminateReport et GetReportStateCode. Il est transmis aux événements AfterRunReport et RunReportProgress.

•	Le code de statut ne représente aucune information propre à l'état (par exemple, numéro d'ordre de l'état dans la file d'attente ou messages d'erreur et d'avertissement du serveur).

•	Le script du conteneur du contrôle peut fonctionner avec des valeurs de code ou établir une correspondance entre des codes de statut et des chaînes en appelant GetReportStateCodeString ou GetReportStateCode.

•	Tout statut propre à un état ne peut être renvoyé que pendant l'exécution de cet état. Pour les conteneurs sans prise en charge d'événements, le statut de l'état peut être interrogé en boucle. L'identificateur de l'état reste valide pendant un certain temps après la fin de son exécution et un identificateur en attente ne peut provoquer ces erreurs.


Affiche une boîte de dialogue de fichiers dans laquelle vous pouvez choisir l'état à exécuter.


Nom de l'état que vous voulez exécuter. Entrez un nom ou cliquez sur le bouton de navigation pour en choisir un.


Type du périphérique de destination vers lequel vous voulez envoyer l'état (Screen, File, Printer, Preview, Mail, Server cache, Distribution file).


Affiche une boîte de dialogue de fichiers dans laquelle vous pouvez choisir un fichier pour la sortie de l'état, une imprimante pour les impressions ou un fichier de destination pour la diffusion.


Nom du fichier, de l'imprimante, du destinataire de messagerie ou du fichier de destination auquel vous voulez envoyer l'état. Entrez un nom ou cliquez sur le bouton de navigation pour en choisir un.


Nom du serveur d'états sur lequel vous voulez exécuter l'état. Entrez un nom de serveur d'états valide.


Nom utilisateur de la base de données. Entrez votre nom utilisateur de base de données et, le cas échéant, votre mot de passe et le nom de la base de données (sous la forme utilisateur/mot_de_passe@base_de_données).


Mot de passe de l'utilisateur de base de données indiqué. Entrez le mot de passe correct (les caractères entrés apparaissent sous forme d'astérisques).


Nom de la base de données à laquelle vous voulez vous connecter. Entrez le nom d'une base de données valide.


Signifie que le mode d'exécution de l'état sera issu de la définition d'état.


Signifie que l'état doit être exécuté en mode bitmap.


Signifie que l'état doit être exécuté en mode caractère.


Signifie que l'orientation de l'état (paysage ou portrait) sera issue de la définition d'état.


Signifie que l'orientation de l'état (paysage ou portrait) sera l'orientation actuellement sélectionnée pour l'imprimante.


Signifie que l'orientation de l'état sera de type portrait.


Signifie que l'orientation de l'état sera de type paysage.


Dimensions de l'état. Entrez une largeur et une hauteur valides (sous la forme largeur x hauteur) ou sélectionnez-les dans la liste de valeurs.


Format de sortie de l'état.


Nombre d'exemplaires de l'état que vous voulez produire en sortie. Entrez un nombre entier supérieur à zéro.


Indique si la grille de paramètres d'exécution doit être affichée avant l'exécution de l'état. Activez ou désactivez la case à cocher en fonction de votre choix. La grille de paramètres d'exécution est une boîte de dialogue qui vous permet de modifier les valeurs des paramètres de l'état avant son exécution.


Chaîne qui précise les valeurs des paramètres utilisateur de l'état. Entrez une chaîne sous la forme paramètre1=valeur paramètre2=valeur . . . ou sélectionnez une chaîne dans la liste de valeurs.


Bouton de navigation qui affiche une boîte de dialogue de fichiers dans laquelle vous pouvez choisir un fichier de commandes.


Nom d'un fichier de commandes qui précise les paramètres de l'état. Entrez un nom de fichier ou cliquez sur le bouton de navigation pour en choisir un.


Indique si vous souhaitez la cohérence en lecture sur plusieurs interrogations d'un état. Activez ou désactivez la case à cocher en fonction de votre choix. Lors de l'accès aux données, la cohérence en lecture est assurée via une instruction SET TRANSACTION READ ONLY.


Indique si les modifications de base de données (par exemple, CREATE) doivent être automatiquement enregistrées dans la base de données. Activez ou désactivez la case à cocher en fonction de votre choix. Notez que certaines bases de données non Oracle (par exemple, SQL Server) requièrent que les modifications de base de données soient automatiquement enregistrées.


Indique si les autres programmes sont autorisés à s'exécuter pendant que Report Builder extrait des données de la base de données. Activez ou désactivez la case à cocher en fonction de votre choix.


Indique si vous voulez qu'une opération COMMIT ou ROLLBACK soit effectuée à la fin de l'exécution de l'état. Activez ou désactivez la case à cocher en fonction de votre choix.


Indique si vous voulez qu'une opération COMMIT ou ROLLBACK soit effectuée si une erreur survient et que l'exécution de l'état échoue. Activez ou désactivez la case à cocher en fonction de votre choix.


Chaîne à utiliser pour le symbole monétaire dans les formats numériques. Entrez un symbole monétaire valide.


Chaîne à utiliser pour le séparateur des milliers dans les formats numériques. Entrez un séparateur des milliers valide.


Chaîne à utiliser pour le séparateur décimal dans les formats numériques. Entrez un séparateur décimal valide.


Indique en kilo-octets la taille de tableau utilisée par le traitement des tableaux Oracle. Entrez un nombre valide. Généralement, plus la taille de tableau est importante, plus rapide est l'exécution de l'état.


Indique en kilo-octets la taille de la mémoire cache virtuelle. Entrez un nombre valide.


Bouton de navigation qui affiche une boîte de dialogue de fichiers dans laquelle vous pouvez sélectionner un fichier d'erreurs.


Nom du fichier dans lequel seront enregistrés tous les messages d'erreur survenus pendant l'exécution de votre état. Entrez un nom de fichier ou cliquez sur le bouton de navigation pour en choisir un.


Bouton de navigation qui affiche une boîte de dialogue de fichiers dans laquelle vous pouvez sélectionner un fichier journal.


Nom du fichier dans lequel seront enregistrées les statistiques de performances relatives à l'exécution de l'état. Entrez un nom de fichier ou cliquez sur le bouton de navigation pour en choisir un.


Bouton de navigation qui affiche une boîte de dialogue de fichiers dans laquelle vous pouvez sélectionner un fichier trace.


Nom du fichier dans lequel seront enregistrées les informations de trace. Entrez un nom de fichier ou cliquez sur le bouton de navigation pour en choisir un.


Indique si les informations de trace doivent être ajoutées à la fin du fichier ou remplacer celui-ci. Faites votre choix dans la liste.


Indique si les messages d'erreur et avertissements doivent être journalisés dans le fichier trace. Activez ou désactivez la case à cocher en fonction de votre choix.


Indique si les statistiques de performances doivent être journalisées dans le fichier trace. Activez ou désactivez la case à cocher en fonction de votre choix.


Indique si les informations concernant tous les objets d'état  doivent être journalisées dans le fichier trace. Activez ou désactivez la case à cocher en fonction de votre choix.


Indique si les informations concernant tous les objets PL/SQL  doivent être journalisées dans le fichier trace. Activez ou désactivez la case à cocher en fonction de votre choix.


Indique si les informations concernant tous les objets SQL  doivent être journalisées dans le fichier trace. Activez ou désactivez la case à cocher en fonction de votre choix.


Indique si toutes les entrées du fichier trace doivent être horodatées. Activez ou désactivez la case à cocher en fonction de votre choix.


Signifie que voulez exécuter l'état immédiatement.


Signifie que vous voulez indiquer une date et une heure de début pour l'exécution de l'état.


Indique l'heure à laquelle vous voulez que l’état soit exécuté. Entrez une heure ou utilisez les boutons de défilement pour en choisir une.


Indique l'heure à laquelle vous voulez que l’état soit exécuté. Entrez une heure ou utilisez les boutons de défilement pour en choisir une.


Indique la date à laquelle vous voulez que l’état soit exécuté. Entrez une date ou utilisez les boutons de défilement pour en choisir une.


Indique la date à laquelle vous voulez que l’état soit exécuté. Entrez une date ou utilisez les boutons de défilement pour en choisir une.


Signifie que l'état sera exécuté une fois.


Signifie que l’état sera être exécuté à intervalles réguliers.


Nombre d'unités entre les exécutions planifiées de l'état (par exemple, si l'unité est l'heure et que vous indiquez deux, l'état sera exécuté toutes les deux heures). Utilisez les boutons de défilement pour choisir un nombre.


Nombre d'unités entre les exécutions planifiées de l'état (par exemple, si l'unité est l'heure et que vous indiquez deux, l'état sera exécuté toutes les deux heures). Utilisez les boutons de défilement pour choisir un nombre.


Unité utilisée pour fixer l'intervalle entre les exécution de l'état (par exemple, les heures).


Signifie que le travail sera exécuté tous les mois, le même jour (par exemple, le premier lundi de chaque mois).


Occurrence du jour indiqué correspondant au jour d'exécution du travail (par exemple, le premier). Utilisez les boutons de défilement pour choisir une valeur.


Jour d'exécution du travail. Utilisez les boutons de défilement pour choisir un jour.


Signifie que le travail sera être exécuté le dernier jour de chaque mois à la date indiquée ou avant cette date (par exemple, le dernier jour ouvrable de chaque mois ou avant le 15).


Indique le dernier jour où le travail sera être exécuté (par exemple, un lundi ou un jour ouvrable). Utilisez les boutons de défilement pour choisir un jour.


Indique la date à laquelle ou avant laquelle le travail sera être exécuté (le 15, par exemple). Entrez une date ou utilisez les boutons de défilement pour en choisir une.


Date à laquelle ou avant laquelle le travail sera exécuté (par exemple, le 15). Entrez une date ou utilisez les boutons de défilement pour choisir une date.


Signifie que le serveur essaie de réexécuter un travail interrompu à intervalles réguliers.


Indique le nombre de tentatives opérées par le serveur pour relancer un travail après son interruption. Entrez un nombre ou utilisez les boutons de défilement pour en choisir un.


Indique le nombre de tentatives opérées par le serveur pour relancer un travail après son interruption. Entrez un nombre ou utilisez les boutons de défilement pour en choisir un.


Intervalle de temps entre les tentatives d'exécution planifiées pendant lequel le serveur essaie de relancer un travail (par exemple, 1 heure). Entrez un nombre ou utilisez les boutons de défilement pour en choisir un.


Intervalle de temps entre les tentatives d'exécution planifiées pendant lequel le serveur essaie de relancer un travail (par exemple, 1 heure). Entrez un nombre ou utilisez les boutons de défilement pour en choisir un.


Unité de temps entre les tentatives d'exécution planifiées sur la base de laquelle le serveur essaie de relancer un travail (par exemple, l'heure). Utilisez les boutons de défilement pour choisir l'unité de temps.


Signifie que vous voulez utiliser Reports Background Engine sur le client pour exécuter cet état.


Signifie que vous voulez effectuer un appel synchrone au serveur d'états pour exécuter l'état. L'appel ne sera pas renvoyé avant l'exécution complète de l'état.


Signifie que vous voulez effectuer un appel asynchrone au serveur d'états pour exécuter l'état. Le client ne contactera le serveur d'états que lorsqu'il aura besoin d'informations (par exemple, pour soumettre une demande d'exécution d'un état ou pour obtenir des informations de progression).


Fréquence selon laquelle le serveur d'états sera interrogé quant à la progression de l'état. Utilisez les boutons de défilement pour choisir une fréquence en secondes.


Fréquence selon laquelle le serveur d'états sera interrogé quant à la progression de l'état. Utilisez les boutons de défilement pour choisir une fréquence en secondes.


Temps d'attente d'une réponse du serveur avant la coupure de la communication.


Nom associé à l'état dans la file d'attente. Entrez une chaîne valide.


Adresse électronique à laquelle un message de notification est envoyé lorsqu'un travail est correctement exécuté. Entrez des adresses valides.


Adresse électronique à laquelle un message de notification est envoyé lorsque l'exécution d'un travail échoue. Entrez des adresses valides.


Nom utilisateur WebDB qui authentifie l'utilisateur sur le serveur Reports Server restreint. Entrez le nom utilisateur, et éventuellement le mot de passe (format : nom utilisateur/mot de passe).


Mot de passe correspondant au nom de l'utilisateur de base de données WebDB indiqué. Entrez le mot de passe correct (les caractères entrés apparaissent sous forme d'astérisques).


A propos du contrôle ActiveX Reports

Le contrôle ActiveX Reports est un contrôle OLE personnalisé qui révèle le serveur d'états et Reports Background Engine via la technologie normalisée ActiveX OLE. Le contrôle ActiveX Reports vous permet d'exécuter des états à partir de tout conteneur ActiveX. Comme avec tout autre contrôle ActiveX, un conteneur peut obtenir ou définir les propriétés du contrôle et invoquer ses méthodes à tout moment. Notez que le contrôle ActiveX Reports n'est que l'un des différents clients du serveur d'états.

  Architecture ActiveX Reports

Lorsque la méthode RunReport est invoquée pour soumettre un état à exécution, le contrôle effectue les opérations suivantes :

1	Il crée un instantané des propriétés et lance une connexion de communication avec le serveur d'états ou avec Reports Background Engine.

2	Il soumet un état à exécution en créant une ligne de commande à partir des propriétés et en l'envoyant au serveur d'états ou à Reports Background Engine. Notez que seule une validation minimale des paramètres est effectuée.

3	Si la soumission de l'état ne soulève aucun problème, la méthode RunReport est renvoyée avec succès.

Le contrôle ActiveX assure le suivi de l'exécution d'un état dès son début. La façon dont est assuré ce suivi dépend du mode de communication choisi pour l'exécution de l'état. Dans tous les cas, le contrôle génère les événements de contrôle BeforeRunReport et AfterRunReport. Si vous demandez des mises à jour à intervalles réguliers sur la progression de l'état (au moyen de la propriété Call Frequency), l'événement RunReportProgress est également généré selon la fréquence demandée.


A propos du serveur d'états

Le serveur d'états vous permet d'exécuter vos états sur un ordinateur à distance. Le serveur d'états enregistre les demandes d'exécution d'états émanant des clients. Ces demandes sont ajoutées à une file d'attente et envoyées pour exécution dès que l'un des processus d'exécution du serveur d'états se libère. Il est possible d'interroger le serveur d'états sur le statut des demandes. Une commande de planification peut accompagner les demandes d'états non interactives ; elle précise alors que l'état doit être exécuté à un moment donné et selon une fréquence indiquée.


Configuration requise

Le contrôle ActiveX Reports est une application Win32 qui tire parti du multithreading. Comme pour tout autre contrôle ActiveX, il s'agit d'une bibliothèque DLL. Elle utilise à son tour d'autres bibliothèques DLL qui lui sont indispensables pour fonctionner normalement. Le contrôle AcitveX Reports recourt à une liaison statique avec les DLL dépendantes, ce qui signifie qu'il ne peut être chargé correctement que si toutes les DLL dépendantes sont accessibles par le système.

Afin d'obtenir de meilleurs résultats, utilisez Oracle Installer pour installer tous les composants nécessaires.

DLL dépendantes du contrôle ActiveX Reports

•	Bibliothèques système de Windows ;

•	Bibliothèques Microsoft MFC 4.1 (MFC40.DLL) et Microsoft C++ 4.1 Runtime (MSVCRT40.DLL) ;

•	Oracle CORE (CORE40.DLL) ;

•	Oracle National Language Support Runtime (NLSRTL33.DLL) ;

•	Oracle Reports Server Utilities and Communication (ZRC60.DLL) et toutes les DLL sur lesquelles repose cette bibliothèque ;

•	Oracle RPC, NL80.DLL, NS80.DLL, NT80.DLL et toutes les bibliothèques dépendantes.

Les bibliothèques Oracle Component nécessitent que la variable de base de registres HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\ORACLE_HOME indique le répertoire BIN où se trouvent les bibliothèques.

La bibliothèque Oracle NLS nécessite que les variables de base de registres ci-après soient définies et que les ressources de NLS Runtime Library soient installées aux endroits indiqués par ORA_NLS33 et NLSRTL33 :

•	HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\ORA_NLS33

•	HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\NLSRTL33

•	HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\NLS_LANG

Les ressources Oracle RPC doivent être installées dans ORACLE_HOME\NETWORK. Tous les noms de serveurs d'états doivent être indiqués dans le fichier de configuration ORACLE_HOME\NETWORK\ADMIN\TNSNAMES.ORA.

Le contrôle ActiveX Reports est compatible NLS. Les ressources en anglais (américain) sont liées au contrôle mais également fournies sous forme de DLL externe (RWXUS60.DLL). Si la variable locale  NLS n'est pas définie, le contrôle utilise les ressources et la bibliothèque de type OLE en anglais liées en interne.

Lors de son enregistrement, le contrôle ActiveX Reports recherche dans ORACLE_HOME\BIN et REPORT60 les DLL de ressources externes (R3WXxxx60.DLL, où xxx est l'abréviation standard de la variable locale NLS de Windows) et tente de les enregistrer comme bibliothèques de type OLE localisées.


Conseils pour de meilleures performances

  Rubriques connexes

•	Utilisez toujours le serveur d'états, sauf si vous avez spécifiquement besoin d'une sortie interactive de type Preview ou Screen (auquel cas vous devez recourir à Reports Background Engine).

•	Généralement, le mode de communication asynchrone (défini à l'aide de la propriété Call Mode) constitue le meilleur choix. Il garantit que plusieurs états n'attendent pas la fin de l'exécution d'un autre état. Cependant, chaque événement de progression (RunReportProgress) dans ce mode génère du trafic sur le réseau. Fixez la fréquence des indications de progression d'état en conséquence (via la propriété Call Frequency).

•	Le mode de communication synchrone donne de meilleurs résultats dans les cas suivants :

•	Vous ne prévoyez pas d'exécuter simultanément plusieurs états avec votre application ou vous mettez en oeuvre un modèle d'exécution synchrone dans votre interface utilisateur.

•	Le temps estimé d'exécution de l'état est court (c'est-à-dire que les états que vous exécutez sont relativement simples et que votre serveur d'états n'est pas lourdement chargé).

•	La précision des indications intermédiaires d'exécution des états n'a pas d'importance ou n'est pas utilisée du tout.

•	Utilisez les événements de contrôle plutôt qu'une interrogation de la méthode GetReportStateCode pour assurer le suivi du statut de l'exécution.

•	N'effectuez aucun traitement long pendant les événements de contrôle.


A propos des modes de communication

Le contrôle ActiveX Reports prend en charge trois modes de communication avec le serveur d'états (définis via la propriété Call Mode) :

Asynchrone

Synchrone

Local, c'est-à-dire que le contrôle ActiveX Reports ne peut utiliser que le programme Reports Background Engine installé sur l'ordinateur local.


Communication asynchrone

En mode de communication asynchrone, le contrôle ActiveX Reports émet un appel vers le serveur d'états lorsqu'il a besoin de quelque chose (par exemple, besoin de soumettre un état ou d'obtenir une mise à jour de la progression). L'appel est immédiatement renvoyé avec les informations demandées. Si vous utilisez le mode asynchrone, tenez compte des points suivants :

•	Le contrôle ActiveX Reports crée un thread de communication pour chaque soumission d'état réussie. Ce thread interroge le serveur d'états sur la progression de l'exécution, selon la fréquence indiquée (définie via Call Frequency) et génère les événements de contrôle appropriés. Entre ces événements de contrôle, le thread est inactif.

•	Les appels au serveur d'états sont des appels RPC, qui ne génèrent aucun trafic réseau, c'est pourquoi la fréquence de l'état est mesurée en secondes et non en incréments plus faibles.


Communication synchrone

En mode de communication synchrone, le contrôle AcitveX Reports émet un seul appel vers le serveur d'états, qui n'est pas renvoyé avant la fin de l'exécution de l'état. Si vous utilisez le mode de communication synchrone, tenez compte des points suivants :

•	Dans une application Windows sous interface graphique et donc asynchrone, il n'est généralement pas souhaitable d'empêcher toute réponse de l'interface utilisateur (par exemple aucun rafraîchissement ou aucune indication de progression). Il est important que le contrôle ActiveX préserve un fonctionnement asynchrone, même si le mode de communication sous-jacent est synchrone. Vous pouvez émuler un fonctionnement synchrone en maintenant un statut (par exemple, à l'aide d'un indicateur booléen ou d'une variable d'énumération). Ainsi, une application pourrait désactiver un bouton Exécuter état jusqu'à exécution de la soumission de l'état en cours.

•	La progression réelle de l'exécution d'un état est inconnue du client car un seul appel est émis vers le serveur d'états. Le résultat n'est renvoyé qu'après l'exécution de l'état. Si le contrôle ActiveX Reports requiert une indication de progression de l'exécution, celle-ci doit être émulée.

•	Un seul thread du processus peut communiquer avec le serveur d'états à un moment donné (car un seul contexte de communication peut être créé par processus). Si le contrôle crée un appel synchrone, toutes les autres demandes de communication devront attendre la fin de cet appel synchrone (c'est-à-dire la fin de l'exécution de l'état). Le temps nécessaire à l'exécution d'un état dépend du serveur d'états et ne peut être garanti.

•	Le contrôle ActiveX Reports crée deux threads par soumission d'état (appelant et observateur) en mode synchrone. L'appelant appelle le serveur d'états et n'est pas renvoyé avant la fin de l'exécution de l'état. L'observateur analyse l'état de l'appelant et génère des événements de progression, le cas échéant, selon la fréquence indiquée. Ces événements de progression ne reflètent pas la progression réelle de l'exécution de l'état. La progression générée est d'ordre générique (par exemple, l'état est en cours d'exécution) et sans détails (tels que mise en forme de la page 1 ou ouverture de la définition d'état). Entre les événements de contrôle, le thread observateur est inactif.


Communication locale

En mode local, le contrôle ActiveX Reports ne communique pas du tout avec le serveur d'états, mais recourt à Reports Background Engine. Tout se passe sur l'ordinateur local, c'est pourquoi les performances peuvent s'avérer moins bonnes qu'avec le serveur d'états. Si vous utilisez le mode local, tenez compte des points suivants :

Les destinations interactives pour la sortie de l'état (c'est-à-dire Preview et Screen) sont activées.

La propriété ReportsServer n'est pas prise en compte.

Le contrôle ActiveX Reports crée un thread observateur en mode local. Celui-ci déclenche une application (rwisv60.exe) qui appelle le processus Reports Background Engine (rwrbe60.exe). L'exécution de l'état est considérée comme terminée dès la fin de rwisv60.exe. Jusqu'à ce moment, le thread observateur génère des événements de progression selon la fréquence indiquée.


Statut d'exécution de l'état

Il est possible d'obtenir le statut de l'exécution d'un état à tout moment entre les événements BeforeRunReport et AfterRunReport. Vous pouvez obtenir cette information à l'aide de l'événement RunReportProgress ou en invoquant des méthodes de contrôle (telles que GetReportStateCode) pour demander le statut de l'exécution de l'état. L'utilisation d'événements est préférable. Une fois l'exécution de l'état terminée (c'est-à-dire après la génération de l'événement AfterReportRun), le contrôle garde les informations le concernant pendant quelques secondes ; elles sont ensuite détruites et ne sont plus accessibles.


Restrictions du serveur d'états

Tous les noms de fichier, noms d'imprimante et adresses de messagerie doivent être valides au niveau du serveur d'états. Si OutputDestination indique un fichier, il doit s'agir d'un fichier accessible à partir du système de fichiers local (par exemple, sur un lecteur du réseau) afin qu'il puisse être récupéré. OutputDestination peut également désigner un fichier local. Dans ce cas, le nom de destination doit être un nom de fichier local valide. Lorsque l'état a été exécuté avec succès, le contrôle ActiveX Reports transfère le fichier de l'état en sortie (ainsi que tous les fichiers dépendants) vers le fichier local indiqué.


Propriétés obligatoires

  Rubriques connexes

Pour pouvoir exécuter un état avec le contrôle ActiveX, vous devez indiquer au moins les propriétés suivantes :

ReportName	nom de l'état à exécuter

DatabaseUser	chaîne de connexion à la base de données

CallMode	mode de communication

ReportsServer	nom du serveur d'états


Un programme autonome ou complémentaire, tel que Adobe Acrobat Reader, qui vous permette d'afficher vos fichiers PDF.


UNICODE

rwsxu60.ocx est le générateur UNICODE de Reports Queue Manager ; il doit être exécuté lorsque vous êtes dans un environnement sur deux octets. Notez que ce générateur fonctionne également dans un environnement sur un octet., mais c'est dans l'environnement sur deux octets qu'il est réellement nécessaire.

Notes d'utilisation

Soyez cohérent lorsque vous utilisez les générateurs UNICODE de Reports Queue Manager et le contrôle Reports ActiveX. Par exemple, si vous utilisez le générateur UNICODE du contrôle Reports ActiveX (rwqmu60.ocx), vous devez également utiliser le générateur UNICODE de Reports Queue Manager. Sinon, vous devez vous assurez que la variable d'environnement USER_NLS_LANG est indiquée. Si vous utilisez la configuration US par défaut, ces restrictions ne s'appliquent pas.

Les générateurs UNICODE fonctionnent sur Windows NT 4.0, pas sur Windows 95.


Un navigateur compatible HTML 3.0 (par exemple, Netscape 2.2 ou une version ultérieure).


Serveur d'états

Le serveur d'états vous permet d'exécuter vos états sur un ordinateur à distance. Le serveur d'états enregistre les demandes d'exécution d'états émanant des clients. Ces demandes sont ajoutées à une file d'attente et envoyées pour exécution dès que l'un des processus d'exécution du serveur d'états se libère. Il est possible d'interroger le serveur d'états sur le statut des demandes. Une commande de planification peut accompagner les demandes d'états non interactives ; elle précise alors que l'état doit être exécuté à un moment donné et selon une fréquence indiquée.


Reports Background Engine

Reports Background Engine est un serveur simplifié qui gère une file d'attente et Reports Runtime sur l'ordinateur local (aucune connexion réseau n'est donc nécessaire) pour prendre en charge les demandes d'exécution d'états. Lorsque vous utilisez Reports Background Engine, les destinations interactives de sortie des états (Preview et Screen) sont activées. (Dans les versions précédentes, Reports Background Engine s'appelait Serveur d'états.)


Fichier de consignation des travaux du serveur

Le fichier de consignation des travaux du serveur enregistre par défaut des informations telles que l'heure de démarrage et d'arrêt du serveur et du moteur. Pour consigner dans ce journal l'heure à laquelle un travail d'état est terminé (ou l'heure à laquelle son exécution échoue), demandez à l'administrateur de votre système d'ajouter le paramètre LOGOPTION au fichier de configuration du serveur.