Configuration du connecteur

Vous devez au préalable définir les propriétés de configuration standard et les propriétés spécifiques au connecteur pour pouvoir l'exécuter. Pour définir les propriétés de configuration d'un connecteur, utilisez l'outil Connector Configurator :

Pour plus d'informations sur Connector Configurator, voir Annexe B, Connector Configurator.

Propriétés de configuration standard

Les propriétés de configuration standard fournissent des informations destinées aux connecteurs. Pour plus d'informations sur ces propriétés, voir Annexe A, Propriétés de configuration standard pour les connecteurs.

Important:
Etant donné que le connecteur pour JDBC prend en charge les courtiers d'intégration InterChange Server et WebSphere MQ Integrator Broker, les propriétés de configuration des deux courtiers correspondent au connecteur.

Par ailleurs, voir le Tableau 5 pour connaître les informations de configuration spécifiques à IBM WebSphere Business Integration Adapter for JDBC. Les informations contenues dans ce tableau complètent les informations figurant dans l'annexe.

Tableau 5. Informations sur les propriétés spécifiques à ce connecteur
Propriété Remarques
CharacterEncoding Ce connecteur n'utilise pas la propriété CharacterEncoding
Locale Etant donné que ce connecteur est internationalisé, vous pouvez modifier la valeur de la propriété Locale.
Remarque :
Si vous utilisez WebSphere MQ Integrator Broker comme courtier, vous devez utiliser le même environnement local pour l'adaptateur, le courtier et les applications.

Notez que vous devez indiquer une valeur pour la propriété de configuration ApplicationName afin d'exécuter le connecteur.

Propriétés spécifiques au connecteur

Les propriétés de configuration spécifiques au connecteur fournissent des informations requises par le connecteur au moment de l'exécution. Les propriétés spécifiques au connecteur permettent également de modifier les informations statiques ou logiques dans le connecteur sans devoir les recoder et les reconstituer.

Le Tableau 6 contient les propriétés de configuration spécifiques au connecteur. Pour obtenir une explication des propriétés, voir les sections suivantes.

Tableau 6. Propriétés de configuration spécifiques au connecteur
Nom Valeurs possibles Valeur par défaut Obligatoire
ApplicationPassword Mot de passe pour le compte utilisateur du connecteur
Oui*
 
ApplicationUserName Nom du compte utilisateur du connecteur
Oui*
 
ArchiveProcessed true ou false
true
 
Non
 
ArchiveTableName Nom de la table de la file d'attente d'archivage
xworlds_archive_events
 
Oui si la valeur affectée à Archive Processed est true
AutoCommit true ou false
false
 
Non
 
CheckforEventTableInInit true ou false
true
 
Non
 
ChildUpdatePhyDelete true ou false
false
 
Non
 
CloseDBConnection true ou false
false
 
Non
 
ConnectorID ID unique du connecteur
null
 
Non
 
DatabaseURL Nom du serveur de base de données

 
Oui
 
DateFormat Chaîne de modèle de date
MM/jj/aaaaa
 HH:mm:ss
 
Non
 
DriverConnectionProperties Propriétés de connexion du pilote JDBC supplémentaires
Non
 
DriverSupportForLong true ou false
true
 
Non
 
EventKeyDel Caractères de délimitation pour la colonne de la clé de l'objet de la table d'événements
point-virgule (;)
 
Non
 
EventOrderBy
aucune, ColumnName,
 ColumnName, ...]
 

 
Non
 
EventQueryType Fixed ou Dynamic
Fixed
 
Non
 
EventTableName Nom de la table de la file d'attente des événements
xworlds_events
 
Oui, si l'interrogation est requise ; null (comme chaîne) si l'interrogation n'est pas requise
JDBCDriverClass nom de classe du pilote

 
Oui
 
MaximumDatabaseConnections Nombre de connexions simultanées à une base de données
5
 
Oui
 
PingQuery
SELECT 1 FROM <tablename>
 

 
Non
 
PollQuantity Les valeurs sont comprises entre 1 et 500
1
 
Non
 
PreserveUIDSeq true ou false
true
 
Non
 
QueryTimeOut Valeur d'entier en secondes

 
Non
 
RDBMS.initsession Instruction SQL qui initialise toutes les sessions de base de données

 
Non
 
RDBMSVendor Oracle, Others

 
Oui
 
ReplaceAllStr true ou false
false
 
Non
 
ReplaceStrList Ensemble composé d'un seul caractère, d'un caractère de délimitation et de la chaîne de substitution du caractère. Comprend également plusieurs ensembles séparés par des caractères de fin. Q,DSQRemarque : Dans l'outil de configuration du connecteur, ces caractères représentent un guillemet simple, suivi d'une virgule et de deux guillemets simples.
Non
 
RetryCountAndInterval Nombre, intervalle en secondes 3,20
Non
 
ReturnDummyBOForSP true ou false
false
 
Non
 
SchemaName Schéma dans lequel les événements résident

 
Non
 
SelectiveCommitForPoll true ou false
false
 
Non
 
SPBeforePollCall Nom de la procédure stockée à exécuter pour chaque appel d'interrogation

 
Non
 
StrDelimiter Délimiteurs de caractères et de fin utilisés dans la propriété ReplaceStrList
,:
 
Non
 
TimingStats 0, 1, 2
0
 
Non
 
UniqueIDTableName Nom de la table utilisée pour créer les ID
xworlds_uid
 
Non
 
UseDefaults true ou false
false
 
Oui
 
UseDefaultsForCreatingChildBOs true ou false
false
 
Non
 
UseDefaultsWhenPolling true ou false
true
 
Non
 

*Les propriétés ApplicationPassword et ApplicationUserName ne sont pas obligatoires si vous utilisez une authentification sécurisée.

ApplicationPassword

Mot de passe défini pour le compte utilisateur du connecteur.

Il n'existe pas de valeur par défaut.

ApplicationUserName

Nom du compte utilisateur du connecteur.

Il n'existe pas de valeur par défaut.

ArchiveProcessed

Indique si le connecteur archive des événements pour lesquels il n'existe pas d'inscription en cours.

Affectez à cette propriété la valeur true pour que les événements soient insérés dans la table d'archivage avant d'être supprimés de la table d'événements.

Affectez à cette propriété la valeur false pour que le connecteur ne procède pas à l'archivage. Dans ce cas, il ne vérifie pas la valeur de la propriété ArchiveTableName. Si la propriété ArchiveProcessed a la valeur false, le connecteur procède comme suit :

Si cette propriété a la valeur false et que le nombre d'interrogations est faible, le connecteur semble interroger la table d'événements mais est simplement en train de prélever de manière répétée les mêmes événements.

Si cette propriété ne contient pas de valeur, le connecteur présume que la valeur est true. Si la propriété ArchiveTableName ne contient pas de valeur, le connecteur présume que le nom de la table d'archivage est xworlds_archive_events.

La valeur par défaut est true.

ArchiveTableName

Nom de la table de la file d'attente d'archivage.

Si la propriété ArchiveProcessed a la valeur false, il n'est pas nécessaire de définir une valeur pour cette propriété.

Le nom par défaut est xworlds_archive_events.

AutoCommit

Cette propriété permet de configurer le paramètre AutoCommit. Lorsque ce paramètre a la valeur true, toutes les transactions sont automatiquement validées. Certaines bases de données (comme Sybase) requièrent que le paramètre AutoCommit ait la valeur true. Si la valeur affectée est false, les procédures stockées sur Sybase échouent.

Si la connexion à la base de données est interrompue, le connecteur tentera de rétablir la connexion afin de redémarrer le traitement complet tant que le paramètre AutoCommit a la valeur false. Si la nouvelle connexion est incorrecte ou que le paramètre AutoCommit a la valeur true, le connecteur renvoie le message d'erreur APPRESPONSETIMEOUT, qui entraîne la fermeture du connecteur.

La valeur par défaut est false.

CheckforEventTableInInit

Si vous affectez la valeur false à cette propriété, le connecteur ne peut pas vérifier l'existence des tables d'événements et d'archivage pendant son initialisation. Il est recommandé de toujours affecter la valeur true sauf si le pilote JDBC que vous utilisez ne prend pas en charge la classe JDBC DatabaseMetaData.

Lorsque la propriété a la valeur false, même si le connecteur ne vérifie pas l'existence des tables EventTable et ArchiveTable, les tables d'événements et d'archivage doivent toujours exister car le connecteur les utilise pendant le processus d'initialisation. Pour empêcher le connecteur d'utiliser les tables d'événements et d'archivage pendant l'initialisation, affectez à la propriété EventTableName la valeur null.

La valeur par défaut est true.

ChildUpdatePhyDelete

Pendant une opération de mise à jour, cette propriété indique comment le connecteur traite les données représentées par un objet métier enfant qui est absent de l'objet métier entrant mais qui existe dans la base de données.

Affectez à cette propriété la valeur true pour que le connecteur supprime physiquement les données de la base de données.

Affectez à cette propriété la valeur false pour que le connecteur supprime de manière logique les données de la base de données en affectant à la colonne d'état la valeur appropriée. Les informations spécifiques à l'application extraient le nom de la colonne d'état et la valeur associée du paramètre StatusColumnValue (SCN) indiqué dans ses informations spécifiques à l'application au niveau de l'objet métier. Pour plus d'informations, voir Informations spécifiques à l'application au niveau de l'objet métier.

La valeur par défaut est false.

CloseDBConnection

Cette propriété permet de configurer la fermeture de la connexion à la base de données. Lorsque la valeur affectée est true, pour chaque requête d'appel de service et d'interrogation, la connexion à la base de données est arrêtée. La valeur true affecte les performances, et de ce fait n'est pas recommandée.

La valeur par défaut est false.

ConnectorID

ID unique du connecteur. Cet ID permet d'extraire les événements d'une instance spécifique du connecteur.

La valeur par défaut est null.

DatabaseURL

Nom du serveur de la base de données à laquelle le connecteur doit se connecter.

Si vous utilisez le pilote SQLServer personnalisé pour WebSphere Business Integration, l'adresse URL recommandée est :

jdbc:ibm-crossworlds:sqlserver://MachineName:PortNumber;
 DatabaseName=DBname
 
Important

Si AutoCommit a la valeur false, vous devez définir un autre paramètre, SelectMethod : jdbc:ibm-crossworlds:sqlserver://MachineName:PortNumber;DatabaseName=DBname; SelectMethod=cursor

Par défaut, SelectMethod a la valeur direct. Pour plus d'informations, voir "AutoCommit".

Vous devez indiquer une valeur pour cette propriété pour que le connecteur puisse fonctionner correctement.

DateFormat

Indique le format de date que le connecteur s'attend à recevoir et à renvoyer. Cette propriété prend en charge tous les formats basés sur la syntaxe indiquée dans le Tableau 7.

Le Tableau 7 définit la syntaxe de la propriété DateFormat à l'aide d'une chaîne de modèle de date. Dans ce modèle, toutes les lettres ASCII sont réservées comme étant des lettres modèle.

Tableau 7. Syntaxe de DateFormat
Symbole Signification Présentation Exemple
G
 
ère
(Text)
 
ap J.-C.
 
y
 
année
(Number)
 
1996
 
M
 
mois de l'année
(Text & Number)
 
Juillet & 07
 
d
 
jour du mois
(Number)
 
10
 
h
 
heure am/pm (1-12)
(Number)
 
12
 
H
 
heure du jour (0-23)
(Number)
 
0
 
m
 
minute
(Number)
 
30
 
s
 
seconde
(Number)
 
55
 
S
 
milliseconde
(Number)
 
978
 
E
 
jour de la semaine
(Text)
 
mardi
 
D
 
jour de l'année
(Number)
 
189
 
F
 
jour de la semaine dans le mois
(Number)
 
2
 (2ème mercredi
 de juillet)
 
w
 
semaine de l'année
(Number)
 
27
 
W
 
semaine dans le mois
(Number)
 
2
 
a
 
indicateur am/pm
(Text)
 
PM
 
k
 
heure du jour (1-24)
(Number)
 
24
 
K
 
heure am/pm (0-11)
(Number)
 
0
 
z
 
fuseau horaire
(Text)
 
Heure
 standard
 du Pacifique
 
caractère d'échappement (Delimiter)

 
''
 
guillemet simple (Literal)
'
 


Tableau 8. Exemples avec l'environnement local américain
Modèle de format Résultat
"yyyy.MM.dd G 'à' hh:mm:ss z"
 
1996.07.10 ap J.-C. à 15:08:56 PDT
"EEE, MMM d, ''yy"
 
Mer, Juillet 10, '96
"h:mm a"
 
12:08 PM
"hh 'o''clock' a, zzzz"
 
12 heures PM, Heure du Pacifique
"K:mm a, z"
 
0:00 PM, PST
"yyyy.MMMMM.dd GGG hh:mm aaa"
 
1996.juillet.10 ap J.-C. 12:08 PM

DriverConnectionProperties

Outre le nom d'utilisateur et le mot de passe, un pilote JDBC peut nécessiter des propriétés ou des informations supplémentaires. La propriété du connecteur DriverConnectionProperties prendra les propriétés supplémentaires que requiert un pilote JDBC, sous la forme de paires nom-valeur. Les propriétés doivent être indiquées comme suit :

property1=value1[;property2=value2...]
 

Les propriétés doivent être indiquées sous la forme de paires nom-valeur, séparées par des points-virgules. La propriété est séparée de sa valeur par un signe égal (sans espace).

Par exemple, imaginons que le pilote JDBC requiert des informations sur la licence et le numéro de port. Le nom de propriété attendu pour les informations sur la licence est MyLicense et la valeur correspondante est ab23jk5. Le nom de propriété attendu pour le numéro de port est PortNumber et la valeur correspondante est 1200. La propriété DriverConnectionProperties doit avoir la valeur MyLicense=ab23jk5;PortNumber=1200.

DriverSupportForLong

Cette propriété indique comment les paramètres de type entier sont traités pour PreparedStatements. Lorsque cette propriété a la valeur "true", la valeur setLong est utilisée pour définir le paramètre de type entier. Lorsqu'elle a la valeur "false", la propriété setInt est utilisée pour définir le paramètre.

La valeur par défaut est true.

EventKeyDel

Cette propriété indique le délimiteur utilisé lorsque la colonne object_key de la table d'événements contient plusieurs valeurs d'attribut.

Il existe deux manières d'extraire l'objet métier qui a été créé, mis à jour ou supprimé dans l'application de déclenchement.

Remarque :
L'ordre dans lequel les valeurs clés sont définies doit suivre le même ordre que les attributs de clé dans un objet métier.
Important:
Si vous utilisez des données d'attributs Date, évitez d'utiliser un signe deux-points (:), car celui-ci peut-être inclus dans les données d'attributs.

La valeur par défaut est un point-virgule (;), qui est basé sur les clés et non pas sur des paires nom_valeur.

EventOrderBy

Cette propriété indique si l'ordre des événements est activé ou désactivé, ou indique un ordre de traitement des événements différent de l'ordre par défaut.

Par défaut, à chaque interrogation, le connecteur extrait uniquement le nombre d'événements indiqué dans sa propriété PollQuantity, et organise le traitement des événements par les valeurs contenues dans les colonnes event_time et event_priority de la table d'événements.

Si vous ne souhaitez pas que le connecteur trie les événements, affectez à cette propriété la valeur none.

Si vous ne souhaitez pas que le connecteur ordonne les différentes colonnes dans la table d'événements, indiquez le nom de ces colonnes. Séparez les noms de colonnes par une virgule (,). Si vous indiquez une valeur pour cette propriété, vous remplacez le comportement par défaut.

Il n'existe pas de valeur par défaut pour cette propriété.

EventQueryType

La propriété EventQueryType est utilisée pour indiquer si le connecteur doit créer dynamiquement une requête en vue d'extraire les événements de la table d'événements ou utiliser sa requête intégrée. Pour la requête créée de manière dynamique, le connecteur mappe sa structure d'événements aux colonnes dans la table d'événements. L'ordre des données dans les colonnes de la table est très important. Voir "Schéma des tables d'événements et d'archivage" pour connaître l'ordre approprié.

Si la valeur affectée à la propriété EventQueryType est Fixed (comme chaîne), la requête par défaut est exécutée. Si la valeur affectée est Dynamic (comme chaîne), une nouvelle requête est créée en utilisant les noms de colonne de la table indiquée dans la propriété EventTableName.

Les noms de colonne de la table d'événements peuvent changer, cependant l'ordre et le type de données des colonnes doivent être conservés tel que spécifiés dans la section relative à la création d'une table d'événements. La propriété EventOrderBy sera ajoutée à la requête par défaut ou à la requête créée de manière dynamique.

Si la propriété EventQueryType n'est pas ajoutée ou qu'elle ne contient pas de valeur, elle a par défaut la valeur Fixed.

La valeur par défaut est Fixed (comme chaîne).

EventTableName

Nom de la table de la file d'attente des événements, utilisée par le système d'interrogation du connecteur.

Le nom par défaut est xworlds_archive_events.

Affectez à cette propriété la valeur null (comme chaîne) lorsque l'interrogation est désactivée pour le connecteur. De cette manière, le connecteur ne recherche pas l'existence des tables d'événements et d'archivage.

Pour une table d'événements définie par l'utilisateur, vérifiez que event_id correspond à l'un des types JDBC suivants : INTEGER , BIGINT, NUMERIC, VARCHAR.

JDBCDriverClass

Indique le nom de classe d'un pilote. Pour utiliser un pilote JDBC spécifique, indiquez le nom de classe du pilote dans cette propriété de configuration. Par exemple, pour indiquer le pilote Thin Oracle, affectez à cette propriété le nom de classe : oracle.jdbc.driver.OracleDriver.

Pour plus d'informations, voir Activation de la prise en charge de plusieurs pilotes et UseDefaultsForCreatingChildBOs.

Aucune valeur par défaut n'est indiquée.

MaximumDatabaseConnections

Indique le nombre maximal de connexions simultanées autorisées à la base de données. Au moment de l'exécution, le nombre de connexions ouvertes à une base de données équivaut à la somme de cette valeur plus 1.

Si la propriété PreserveUIDSeq a la valeur "false", au moment de l'exécution, le nombre de connexions ouvertes à une base de données équivaut à la somme de cette valeur plus 2.

La valeur par défaut est 5.

PingQuery

Indique l'instruction SQL ou la procédure stockée que le connecteur exécute pour vérifier la connectivité à la base de données.

Voici un exemple d'instruction SQL utilisée comme requête ping :

SELECT 1 FROM <tablename>
 

Voici un exemple d'appel de procédure stockée (sampleSP) utilisée comme requête ping avec une base de données Oracle :

call sampleSP( )
 

Notez que les appels de procédure stockée ne peuvent pas comporter de paramètres de sortie. Si un paramètre d'entrée est requis par la base de données, la valeur d'entrée doit être indiquée dans la requête ping. Par exemple :

Call checkproc(2)
 

Il n'existe pas de valeur par défaut. Pour plus d'informations, voir Gestion des connexions interrompues à une base de données et Interruption de la connexion à l'application.

PollQuantity

Nombre de lignes présentes dans une table de la base de données que le connecteur extrait par intervalle d'interrogation. Les valeurs autorisées sont comprises entre 1 et 500.

La valeur par défaut est 1.

PreserveUIDSeq

Indique si l'ID unique entrant sera conservé ou non dans la table d'identificateurs uniques.

Si cette propriété a la valeur true, l'ID unique n'est pas validé tant que l'objet métier n'est pas correctement traité dans l'application cible. Tous les autres processus qui tentent d'accéder à la table d'identificateurs uniques doivent attendre la validation de la transaction.

Si la valeur affectée à la propriété est false, l'ID unique est validé lorsque l'objet métier le demande. Les traitements de l'objet métier et de l'ID unique disposent chacun d'un bloc de transactions (interne au connecteur). Cela est possible uniquement si la transaction associée à la table d'identificateurs uniques possède sa propre connexion.

Remarque :
Si cette propriété n'est pas ajoutée à la configuration du connecteur, le comportement par défaut reviendrait à ajouter une propriété et à lui affecter la valeur true. Par ailleurs, si la propriété AutoCommit a la valeur true, le connecteur procède comme si PreserveUIDSeq avait la valeur false.

Si la propriété PreserveUIDSeq a la valeur "false", au moment de l'exécution, le nombre de connexions ouvertes à une base de données équivaut à la somme de cette valeur plus 2.

La valeur par défaut est true.

QueryTimeOut

La valeur de cette propriété correspond à un nombre entier exprimé en secondes qui définit la propriété QueryTimeOut pour toutes les extractions par le nombre indiqué. Si aucune valeur n'est indiquée, cela signifie qu'aucun délai d'expiration n'est défini pour la requête. Si la requête prend plus de temps que le nombre de secondes indiqué, la base de données génère une exception SQL qui est enregistrée. Le message associé est consigné dans le fichier journal.

Aucune valeur par défaut n'est fournie.

RDBMS.initsession

Instruction SQL qui initialise toutes les sessions de base de données. Le connecteur émet une requête et l'exécute au démarrage. Il ne doit pas exister de valeur de retour pour cette requête. Le nom de la propriété est obligatoire, mais pas la valeur.

Il n'existe pas de valeur par défaut.

RDBMSVendor

Indique quel SGBDR est utilisé par le connecteur pour un traitement spécifique. Affectez à cette propriété la valeur Oracle pour la base de données Oracle.

Si vous utilisez une base de données autre que celle par défaut, vérifiez que le pilote chargé est approprié. Si cette propriété a la valeur Others, le connecteur détermine quelle base de données utiliser en localisant le pilote.

Il est indispensable d'indiquer une valeur pour que le connecteur fonctionne correctement.

Aucune valeur par défaut n'est fournie.

ReplaceAllStr

Indique si le connecteur remplace toutes les instances de chaque caractère identifié dans la propriété ReplaceStrList par la chaîne de substitution indiquée dans cette propriété. Le connecteur analyse la propriété ReplaceAllStr uniquement si le paramètre ESC=[true|false] de chaque propriété AppSpecificInfo d'attribut ne contient pas de valeur. En d'autres termes, si le paramètre ESC a été indiqué, sa valeur a priorité sur la valeur définie pour la propriété ReplaceAllStr. Pour que le connecteur utilise la valeur de la propriété ReplaceAllStr, vérifiez que le paramètre ESC n'a pas été indiqué.

La valeur par défaut de la propriété ReplaceAllStr est false.

Remarque :
Le paramètre ESC et les propriétés ReplaceAllStr et ReplaceStrList assurent la prise en charge de la fonction du caractère d'échappement dans la base de données (par exemple, guillemets simples d'échappement). Dans la mesure où cette même fonction est également disponible dans les instructions préparées fournies par le pilote JDBC, ces propriétés seront déconseillées dans les éditions ultérieures du connecteur. Le connecteur prend actuellement en charge l'utilisation des instructions préparées du pilote JDBC.

ReplaceStrList

Indique un ou plusieurs ensembles de substitution, chacun d'eux constitué d'un caractère à remplacer, d'un caractère de délimitation et d'une chaîne de substitution. Le connecteur effectue cette substitution sur une valeur d'attribut uniquement si une valeur est indiquée pour le paramètre ESC=[true|false] de la propriété AppSpecificInfo de l'attribut ou pour la propriété ReplaceAllStr du connecteur.

Remarque :
Le paramètre ESC et les propriétés ReplaceAllStr et ReplaceStrList assurent la prise en charge de la fonction du caractère d'échappement dans la base de données (par exemple, guillemets simples d'échappement). Dans la mesure où cette même fonction est également disponible dans les instructions préparées fournies par le pilote JDBC, ces propriétés seront déconseillées dans les éditions ultérieures du connecteur. Le connecteur prend actuellement en charge l'utilisation des instructions préparées du pilote JDBC.

La syntaxe de cet attribut est la suivante :

single_char1,substitution_str1[:single_char2,substitution_str2[:...]]
 

où :

single_char
Caractère à remplacer.

substitution_str
Chaîne de substitution que le connecteur utilise pour remplacer le caractère.

,
Caractère de délimitation qui sépare le caractère à remplacer de la chaîne qui le remplace. Par défaut, le caractère de délimitation est une virgule (,). Vous pouvez configurer ce délimiteur en définissant le premier délimiteur dans la propriété StrDelimiter.

:
Délimiteur de fin qui sépare les ensembles de substitution (chacun d'eux est constitué du caractère à remplacer, d'un caractère de délimitation et d'une chaîne de substitution). Par défaut, le délimiteur de fin est un signe deux-points (:). Vous pouvez configurer ce délimiteur en définissant le second délimiteur dans la propriété StrDelimiter.

Par exemple, imaginons que vous vouliez remplacer un signe pourcentage (%) par deux signes pourcentage (%%), et un caret (^) par une barre oblique inverse et un caret (\^). Par défaut, la propriété StrDelimiter indique une virgule (,) comme délimiteur de caractères et un signe deux-points (:) comme délimiteur de fin. Si vous conservez ces délimiteurs par défaut, utilisez la chaîne suivante comme valeur de ReplaceStrList :

%,%%:^,\^
 

Remarque :
Une restriction de l'outil de configuration du connecteur empêche d'entrer des guillemets simples. Par conséquent, vous devez représenter un guillemet simple par le caractère Q et deux guillemets simples par les caractères DSQ. Dans l'exemple précédent, si vous voulez également remplacer un guillemet simple (') par deux guillemets simples (''), utilisez la notation suivante : Q,DSQ:%,%%:^,\^

RetryCountAndInterval

Indique le nombre de tentatives ainsi que l'intervalle en secondes que le connecteur doit utiliser lorsqu'il ne peut pas verrouiller des données pendant une mise à jour.

Pour effectuer une mise à jour, le connecteur verrouille les lignes relatives à la mise à jour et tente d'extraire les données courantes. Si le connecteur ne parvient pas à verrouiller les lignes, il tente à nouveau de verrouiller les données d'après le nombre et l'intervalle indiqués dans cette propriété de configuration. Le délai du connecteur expire s'il ne peut pas verrouiller les données conformément aux valeurs indiquées.

Indiquez la valeur sous cette forme : nombre, intervalle en secondes. Par exemple, une valeur de 3,20 indique trois tentatives dans un intervalle de 20 secondes.

La valeur par défaut est 3,20.

ReturnDummyBOForSP

Cette propriété est utilisée pour renvoyer des paramètres de sortie même lorsque le jeu de résultats est vide.

Dans le cas de la propriété RetrieveSP, un jeu de résultats est renvoyé. Si le jeu de résultats est vide, aucun objet métier n'est créé, et les paramètres de sortie renvoyés par l'appel de procédure ne peuvent pas être récupérés. Toutefois, si la propriété ReturnDummyBOForSP a la valeur true, un objet métier fictif comprenant des valeurs issues des paramètres d'entrée/sortie indiqués dans les attributs correspondants sera renvoyé.

La valeur par défaut est "false".

SchemaName

Cette propriété limite la recherche pour les tables d'événements et d'archivage dans ce schéma spécifique. Si cette propriété n'est pas ajoutée ou qu'elle est vide, le connecteur recherchera tous les schémas auxquels l'utilisateur a accès. La propriété SchemaName est également utilisée lors de la création de requêtes d'accès aux tables d'événements et d'archivage.

La base de données Oracle assure la prise en charge des noms de schéma. Pour plus d'informations, voir la documentation du pilote JDBC.

Aucune valeur par défaut n'est indiquée.

SelectiveCommitForPoll

Indique lorsque des validations de base de données auront lieu. Si la propriété a la valeur true, une seule validation aura lieu, après le traitement d'un événement. Si la valeur affectée est false, le comportement standard est utilisé : les validations de la base de données se produiront à chaque étape du traitement des événements.

La valeur par défaut est "false".

SPBeforePollCall

Cette propriété nomme la procédure stockée qui est exécutée pour chaque appel d'interrogation. Si la propriété SPBeforePollCall a une valeur (le nom d'une procédure stockée), à chaque début d'appel d'interrogation, le connecteur appelle la procédure stockée, en lui transmettant les valeurs des propriétés du connecteur ConnectorID et PollQuantity. La procédure mettra à jour le nombre de lignes dans la propriété PollQuantity, en affectant à la colonne d'ID connecteur la valeur ConnectorID où status=0 et connector-id correspond à null. Cela permet d'équilibrer la charge dans le connecteur.

Remarque :
Dans le cas où un appel d'interrogation échoue prématurément (la base de données est inactive ou la connexion est interrompue), l'ID connecteur reste défini. Du fait de cet échec, des enregistrements peuvent être ignorés pendant l'interrogation. Il est par conséquent recommandé de réaffecter régulièrement à l'ID connecteur la valeur null pour tous les enregistrements contenus dans la table d'événements avec l'état 0.

StrDelimiter

Cette propriété indique les délimiteurs de caractères ou de fin à utiliser dans la propriété ReplaceStrList.

Vous pouvez indiquer votre propre valeur pour l'un des délimiteurs. Dans le cas contraire, n'indiquez pas d'espace ou d'autres caractères entre eux.

La valeur par défaut est une virgule suivie immédiatement d'un signe deux-points (,:).

TimingStats

Cette propriété vous permet de prévoir chaque instruction du connecteur afin d'identifier les problèmes éventuels. Les paramètres disponibles sont les suivants :

0
Aucune statistique sur les délais

1
Heure affichée à l'entrée et à la sortie de l'opération d'instruction pour un objet métier hiérarchique entier.

2
Heure affichée à l'entrée et à la sortie de l'opération d'instruction pour chaque objet métier dans un objet métier hiérarchique.

Les messages de délai sont des messages de fichier journal plutôt que des messages trace. Ils peuvent être activés ou désactivés, indépendamment des niveaux de trace.

La valeur par défaut est 0.

UniqueIDTableName

Indique la table qui contient la dernière valeur utilisée pour créer un ID unique. Par défaut, la table contient une colonne (id). Vous pouvez personnaliser la table afin d'ajouter une colonne pour chaque attribut qui requiert la création d'un UID.

La valeur par défaut est xworlds_uid.

UseDefaults

Si la propriété UseDefaults a la valeur true ou n'est pas définie, le connecteur vérifie si une valeur correcte ou une valeur par défaut est indiquée pour chaque attribut d'objet métier nécessaire. Si une valeur est indiquée, l'opération de création aboutit. Dans le cas contraire, l'opération échoue.

Si la propriété UseDefaults a la valeur false, le connecteur vérifie si une valeur correcte est indiquée pour chaque attribut d'objet métier nécessaire. L'opération de création échoue si la valeur indiquée n'est pas correcte.

La valeur par défaut est false.

UseDefaultsForCreatingChildBOs

Si la propriété UseDefaultsForCreatingChildBOs a la valeur true ou n'est pas définie, le connecteur vérifie si une valeur correcte ou une valeur par défaut est indiquée pour chaque attribut d'objet métier nécessaire. Si une valeur est indiquée, l'opération de création aboutit. Dans le cas contraire, l'opération échoue.

Si la propriété UseDefaultsForCreatingChildBOs a la valeur false, le connecteur vérifie si une valeur correcte est indiquée pour chaque attribut d'objet métier nécessaire. L'opération de création échoue si la valeur indiquée n'est pas correcte.

La valeur par défaut est "false".

UseDefaultsWhenPolling

Si la propriété UseDefaultsWhenPolling a la valeur true, les valeurs par défaut seront définies dans l'objet métier avant qu'il ne soit extrait de la base de données et transféré sur le serveur.

Si la propriété UseDefaultsWhenPolling a la valeur false, les valeurs par défaut ne seront pas définies dans l'objet métier avant qu'il ne soit extrait de la base de données et transféré sur le serveur.

La valeur par défaut est true.

Remarque :
Cette propriété de configuration spécifique au connecteur remplace la propriété UseDefaultsForRetrieve.

Copyright IBM Corp. 1997, 2004