TalendOpenStudio Components RG 42a FR

Talend Open Studio Composants
4.X
Guide de rfrence
Intentionally Blank
ii
Composants Talend Open Studio
Version 4.2_a
Convient pour lutilisation de Talend Open Studio v4.2.x. Annule et remplace toute version antrieure du Guide de rfrence.
Copyleft
Cette documentation est mise disposition selon les termes du Contrat Public Creative Commons (CPCC). Pour plus dinformations concernant votre utilisation de cette documentation en accord avec le Contrat CPCC, consultez : http://creativecommons.org/licenses/by-nc-sa/2.0/
iii
iv
Talend Open Studio Composants Guide de rfrence ..................... i
Prface ....................................................................xxvii Objectif .............................................................xxvii Public vis .........................................................xxvii Conventions typographiques .............................xxvii Historique des versions ........................................xxviii Remarques et Support .........................................xxviii
Composants Business .................................. 1

tAlfrescoOutput ........................................................... 2 Proprits du tAlfrescoOutput ................................. 2 Procdure dinstallation ....................................... 4 Dmatrialisation, tAlfrescoOutput et Gestion de Contenu ......................................................................... 7 Scnario : Crer des documents sur un serveur Alfresco .................................................................................. 8 tBonitaDeploy ............................................................ 14 Proprits du tBonitaDeploy ................................. 14 Scnario associ .................................................... 15 tBonitaInstantiateProcess ......................................... 16 tBonitaInstantiateProcess Properties ..................... 16 Scnario : Excuter un processus Bonita via un Job Talend .......................................................................... 17 tCentricCRMInput ................................................... 22 Proprits du tCentricCRMInput ........................... 22 Scnario associ .................................................... 22 tCentricCRMOutput ................................................ 23 Proprits du tCentricCRMOutput ....................... 23 Scnario associ ................................................... 23 tHL7Input .................................................................. 24 Proprits du tHL7Input ........................................ 24 Scnario : Retrouver des informations concernant les patients et les vnements partir dun fichier HL7 .. 25 tHL7Output ............................................................... 29 Proprits du tHL7Output ..................................... 29 Scnario associ .................................................... 29 tMarketoInput ........................................................... 30 Proprits du tMarketoInput .................................. 30 Scnario associ .................................................... 32 tMarketoOutput ........................................................ 33 Proprits du tMarketoOutput ............................... 33 Scnario : Insrer et rcuprer des donnes dune base de donnes Marketo via un systme externe ............... 35 tMicrosoftCRMInput ................................................ 40 Proprits du tMicrosoftCRMInput ...................... 40
Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques .................41 tMicrosoftCRMOutput .............................................48 Proprits du tMicrosoftCRMOutput ...................48 Scnario associ ....................................................49 tMSAXInput ...............................................................50 Proprits du tMSAXInput ...................................50 Scnario associ .....................................................50 tMSAXOutput ............................................................51 Proprits du tMSAXOutput .................................51 Scnario : Insrer des donnes dans une table dfinie sur le serveur Microsoft AX .......................................52 Scnario 2 : Effacer des donnes dune table prcise sur le serveur MicrosoftAX. ........................................55 tOpenbravoERPInput ...............................................58 Proprits du tOpenbravoERPInput ......................58 Scnario associ ....................................................59 tOpenbravoERPOutput ............................................60 Proprits du tOpenbravoERPOutput ...................60 Scnario associ ....................................................60 tSageX3Input .............................................................61 Proprits du tSageX3Input ...................................61 Scnario : Utiliser les cls des requtes pour extraire des donnes dun systme Sage X3 donn ..................62 tSageX3Output ...........................................................66 Proprits du tSageX3Output ................................66 Scnario : Utiliser un service Web Sage X3 pour insrer des donnes dans un systme Sage X3 donn ....67 tSalesforceBulkExec ..................................................71 Proprits du tSalesforceBulkExec ........................71 Scnario associ .....................................................72 tSalesforceConnection ...............................................73 Proprits du tSalesforceConnection .....................73 Scnario associ .....................................................73 tSalesforceGetDeleted ...............................................74 Proprits du tSalesforceGetDeleted .....................74 Scnario : Rcuprer les donnes supprimes du serveur Salesforce ........................................................75 tSalesforceGetServerTimestamp ..............................78 Proprits du tSalesforceGetServerTimestamp .....78 Scnario associ .....................................................79 tSalesforceGetUpdated ..............................................80 Proprits du tSalesforceGetUpdated ....................80 Scnario associ .....................................................81 tSalesforceInput .........................................................82 Proprits du tSalesforceInput ...............................82 Scnario : Utiliser des requtes pour extraire des donnes dune base de donnes Salesforce .......................84 tSalesforceOutput ......................................................89 Proprits du tSalesforceOutput ............................89 Scnario : Supprimer des donnes de lobjet Account 91 v
tSalesforceOutputBulk ............................................. 93 Proprits du tSalesforceOutputBulk .................... 93 Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com ........................................... 93 tSalesforceOutputBulkExec ..................................... 99 Proprits du tSalesforceOutputBulkExec ............ 99 Scnario : Insrer des donnes de masse dans votre Salesforce.com .......................................................... 100 tSAPCommit ............................................................ 104 Proprits du tSAPCommit ................................. 104 Scnario associ .................................................. 104 tSAPConnection ...................................................... 105 Proprits du tSAPConnection ............................ 105 Scnario associ .................................................. 105 tSAPInput ................................................................ 106 Proprits du tSAPInput ...................................... 106 Scnario 1 : Rcuprer les mtadonnes dun systme SAP ........................................................................... 108 Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE ........................ 114 tSAPOutput ............................................................. 120 Proprits du tSAPOutput ................................... 120 Scnarios associs ............................................... 121 tSAPRollback .......................................................... 122 Proprits du tSAPRollback ................................ 122 Scnario associ .................................................. 122 tSugarCRMInput .................................................... 123 Proprits du tSugarCRMInput .......................... 123 Scnario: Extraire les donnes dun compte partir de SugarCRM ................................................................ 123 tSugarCRMOutput ................................................. 126 Proprits du tSugarCRMOutput ....................... 126 Scnario associ ................................................. 126 tVtigerCRMInput ................................................... 127 Proprits du tVtigerCRMInput ......................... 127 Scnario associ ................................................. 128 tVtigerCRMOutput ................................................ 129 Proprits du tVtigerCRMOutput ...................... 129 Scnario associ .................................................. 130
Composants Business Intelligence ......... 131

tBarChart ................................................................. 132 Proprits du tBarChart ....................................... 132 Scnario : Crer un diagramme en barres partir de donnes dentre ....................................................... 133 tDB2SCD .................................................................. 139 Proprits du tDB2SCD ...................................... 139 Scnario associ .................................................. 140 tDB2SCDELT .......................................................... 141 Proprits du tDB2SCDELT ............................... 141 Scnario associ .................................................. 143 tGreenplumSCD ...................................................... 144 vi
Proprits du tGreenplumSCD ............................144 Scnario associ ...................................................145 tInformixSCD ...........................................................146 Proprits du tInformixSCD ................................146 Scnario associ ...................................................147 tIngresSCD ...............................................................148 Proprits du tIngresSCD ....................................148 Scnario associ ...................................................149 tLineChart ................................................................150 Proprits du tLineChart ......................................150 Scnario : Crer un graphique en lignes afin de faciliter lanalyse des tendances .......................................151 tMondrianInput .......................................................158 Proprits du tMondrianInput ..............................158 Scnario : Tables en jointure croise ...................159 tMSSqlSCD ..............................................................162 Proprits du tMSSqlSCD ...................................162 Scnario associ ...................................................163 tMysqlSCD ...............................................................164 Proprits du tMysqlSCD ....................................164 Mthodologie de gestion du SCD .....................165 Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 ..........................168 tMysqlSCDELT .......................................................177 Proprits du tMysqlSCDELT .............................177 Scnario associ ...................................................179 tOracleSCD ..............................................................180 Proprits du tOracleSCD ....................................180 Scnario associ ...................................................182 tOracleSCDELT ......................................................183 Proprits du tOracleSCDELT ............................183 Scnario associ ...................................................185 tPaloCheckElements ................................................186 Proprits du tPaloCheckElements ......................186 Scnario associ ...................................................188 tPaloConnection .......................................................189 Proprits du tPaloConnection .............................189 Scnario associ ...................................................189 tPaloCube .................................................................190 Proprits du tPaloCube .......................................190 Scnario : Crer un cube dans une base de donnes existante .....................................................................192 tPaloCubeList ...........................................................194 Proprits du tPaloCubeList ................................194 Dcouvrir le schma de sortie en lecture seule du tPaloCubeList ...................................................................195 Scnario : Rcuprer des informations dtailles dun cube dune base de donnes dtermine ....................196 tPaloDatabase ...........................................................198 Proprits du tPaloDatabase ................................198 Scnario : Crer une base de donnes ..................199 tPaloDatabaseList ....................................................201 Proprits du tPaloDatabaseList ..........................201
Dcouvrir le schma de sortie en lecture seule du tPaloDatabaseList ............................................................ 202 Scnario : Rcuprer des informations dtailles concernant les bases de donnes dun serveur Palo donn ... 203 tPaloDimension ........................................................ 205 Proprits du tPaloDimension ............................. 205 Scnario : Crer une dimension avec des lments ... 209 tPaloDimensionList ................................................. 214 Proprits du tPaloDimensionList ....................... 214 Dcouvrir le schma de sortie en lecture seule du tPaloDimensionList ......................................................... 216 Scnario: Rcuprer des informations dtailles concernant les dimensions dune base de donnes dtermine 216 tPaloInputMulti ....................................................... 218 Proprits du tPaloInputMulti ............................. 218 Scnario : Rcuprer des lments de dimensions dans un cube donn ................................................... 220 tPaloOutput ............................................................. 224 Proprits du tPaloOutput ................................... 224 Scnario associ .................................................. 225 tPaloOutputMulti .................................................... 226 Proprits du tPaloOutputMulti ........................... 226 Scnario 1 : Ecrire des donnes dans un cube donn 228 Scnario 2 : Refuser un flux de donnes dentre lorsque les lments crire nexistent pas dans un cube donn ......................................................................... 231 tPaloRule .................................................................. 235 Proprits du tPaloRule ....................................... 235 Scnario : Crer une rgle dans un cube donn ... 236 tPaloRuleList ........................................................... 239 Proprits du tPaloRuleList ................................. 239 Dcouvrir le schma de sortie en lecture seule du tPaloRuleList ................................................................... 240 Scnario : Rcuprer des informations dtailles concernant des rgles dun cube donn .......................... 241 tParAccelSCD .......................................................... 243 Proprits du tParAccelSCD ............................... 243 Scnario associ .................................................. 244 tPostgresPlusSCD .................................................... 245 Proprits du tPostgresPlusSCD ......................... 245 Scnario associ .................................................. 246 tPostgresPlusSCDELT ............................................ 247 Proprits du tPostgresPlusSCDELT .................. 247 Scnario associ .................................................. 249 tPostgresqlSCD ........................................................ 250 Proprits du tPostgresqlSCD ............................. 250 Scnario associ .................................................. 251 tPostgresqlSCDELT ................................................ 252 Proprits du tPostgresqlSCDELT ...................... 252
Scnario associ ...................................................254 tSPSSInput ...............................................................255 Proprits du tSPSSInput ....................................255 Scnario : Afficher le contenu dun fichier SPSS ..... 255 tSPSSOutput ............................................................259 Proprits du tSPSSOutput .................................259 Scnario : Ecrire des donnes dans un fichier .sav .... 259 tSPSSProperties .......................................................262 Proprits du tSPSSProperties ............................262 Scnario associ ...................................................262 tSPSSStructure ........................................................263 Proprits du tSPSSStructure ..............................263 Scnario associ ...................................................263 tSybaseSCD ..............................................................265 Proprits du tSybaseSCD ...................................265 Scnario associ ...................................................266 tSybaseSCDELT ......................................................267 Proprits du tSybaseSCDELT ...........................267 Scnario associ ..................................................269
Composants Custom Code .......................271

tGroovy .....................................................................272 Proprits du tGroovy ..........................................272 Scnarios associs ................................................272 tGroovyFile ...............................................................273 Proprits du tGroovyFile ....................................273 Scnario : Appeler du code Groovy contenu dans un fichier .........................................................................273 tJava ..........................................................................275 Proprits du tJava ...............................................275 Scnario : Imprimer le contenu dune variable ....275 tJavaFlex ...................................................................279 Proprits du tJavaFlex ........................................279 Scnario 1 : Gnrer un flux de donnes .............280 Scnario 2 : Traiter des lignes de donnes avec le tJavaFlex ....................................................................282 tJavaRow ..................................................................286 Proprits du tJavaRow ........................................286 Scnario associ ..................................................286 tLibraryLoad ...........................................................287 Proprits du tLibraryLoad ..................................287 Scnario : Vrifier le format dune adresse e-mail .... 287 tSetGlobalVar ..........................................................290 Proprits du tSetGlobalVar ................................290 Scnario : Afficher le contenu dune variable globale 290
Composants Data Quality .......................293

vii
tAddCRCRow .......................................................... 294 Proprits du tAddCRCRow ............................... 294 Scnario : Ajouter une cl de substitution un fichier 294 tChangeFileEncoding ............................................. 297 tExtractRegexFields ............................................... 298 tFuzzyMatch ............................................................ 299 Proprits du tFuzzyMatch .................................. 299 Scnario 1 : Distance de Levenshtein de 0 pour les prnoms ..................................................................... 300 Scnario 2 : Distance de Levenshtein de 1 ou 2 pour les prnoms ............................................................... 302 Scnario 3 : Distance mtaphonique pour les prnoms 303 tIntervalMatch ........................................................ 305 Scnario : Identifier le pays partir de lIP (Perl et Java) .............................................................................. 306 tParseAddress .......................................................... 310 Proprits du tParseAddress ................................ 310 Scnario associ .................................................. 311 tParseName .............................................................. 312 Proprits du tParseName ................................... 312 Scnario associ .................................................. 313 tReplaceList ............................................................. 314 Proprits du tReplaceList ................................... 314 Scnario : Remplacement partir dun fichier de rfrence .................................................................... 315 tSchemaComplianceCheck ..................................... 319 Proprits du tSchemaComplianceCheck ........... 319 Scnario : Valider les dates en fonction dun schma (java) ......................................................................... 321 tUniqRow ................................................................. 325 Proprits du tUniqRow ...................................... 325 Scnario : Ddoublonner des donnes ................. 326
Composants Databases ........................... 329

tAccessBulkExec ...................................................... 330 Proprits du tAccessBulkExec ........................... 330 Scnarios associs ............................................... 332 tAccessCommit ........................................................ 333 Proprits du tAccessCommit ............................. 333 Scnario associ .................................................. 333 tAccessConnection .................................................. 334 Proprits du tAccessConnection ........................ 334 Scnario: Insrer des donnes dans des tables parent/enfant ................................................................... 335 tAccessInput ............................................................ 339 Proprits du tAccessInput .................................. 339 Scnarios associs ............................................... 341 tAccessOutput .......................................................... 342 Proprits du tAccessOutput ............................... 342 Scnarios associs ............................................... 346 viii
tAccessOutputBulk ..................................................347 Proprits du tAccessOutputBulk ........................347 Scnarios associs ................................................348 tAccessOutputBulkExec ..........................................349 Proprits du tAccessOutputBulkExec ................349 Scnarios associs ................................................351 tAccessRollback .......................................................352 Proprits du tAccessRollback ...........................352 Scnario associ ...................................................352 tAccessRow ...............................................................353 Proprits du tAccessRow ...................................353 Scnarios associs ................................................355 tAS400Close .............................................................356 Proprits du tAS400Close ..................................356 Scnario associ ...................................................356 tAS400Commit .........................................................357 Proprits du tAS400Commit ..............................357 Scnario associ ...................................................357 tAS400Connection ...................................................358 Proprits du tAS400Connection .........................358 Scnario associ ...................................................359 tAS400Input .............................................................360 Proprits du tAS400Input ...................................360 Scnarios associs ................................................362 tAS400LastInsertId .................................................363 Proprits du tAS400LastInsertId ........................363 Scnario associ ...................................................363 tAS400Output ..........................................................364 Proprits du tAS400Output ................................364 Scnarios associs ................................................368 tAS400Rollback .......................................................369 Proprits du tAS400Rollback ............................369 Scnario associ ...................................................369 tAS400Row ...............................................................370 Proprits du tAS400Row ....................................370 Scnarios associs ................................................372 tCreateTable .............................................................373 Proprits du tCreateTable ...................................373 Scnario : Crer une nouvelle table dans une base de donnes MySQL ........................................................376 DB2BulkExec ...........................................................378 Proprits du tDB2BulkExec ..............................378 Scnario associ ...................................................380 tDB2Close .................................................................381 Proprits du tDB2Close ......................................381 Scnario associ ...................................................381 tDB2Commit ............................................................382 Proprits du tDB2Commit ..................................382 Scnario associ ...................................................382 tDB2Connection .......................................................383 Proprits du tDB2Connection ...........................383 Scnarios associs ...............................................384 tDB2Input .................................................................385
Proprits du tDB2Input ...................................... 385 Scnarios associs ............................................... 387 tDB2Output ............................................................. 388 Proprits du tDB2Output ................................... 388 Scnarios associs ............................................... 391 tDB2Rollback .......................................................... 392 Proprits du tDB2Rollback ............................... 392 Scnario associ .................................................. 392 tDB2Row .................................................................. 393 Proprits du tDB2Row ....................................... 393 Scnarios associs ............................................... 395 tDB2SCD .................................................................. 396 tDB2SCDELT .......................................................... 397 tDB2SP ..................................................................... 398 Proprits du tDB2SP .......................................... 398 Scnario associ .................................................. 399 tDBInput ................................................................. 400 Proprits du tDBInput ........................................ 400 Scnario 1 : Afficher les donnes slectionnes partir dune table ....................................................... 401 Scnario 2 : Utiliser la variable StoreSQLQuery 403 tDBOutput ............................................................... 405 Proprits du tDBOutput ..................................... 405 Scnario : Afficher la base de donnes en sortie 407 tDBSQLRow ............................................................ 410 Proprits du tDBSQLRow ................................. 410 Scnario : Rinitialiser lauto-incrmentation dune base de donnes ......................................................... 411 tEXAInput ............................................................... 414 Proprits du tEXAInput ..................................... 414 Scnarios associs ............................................... 415 tEXAOutput ............................................................ 416 Proprits du tEXAOutput .................................. 416 Scnarios associs ............................................... 418 tEXARow ................................................................. 419 Proprits du tEXARow ...................................... 419 Scnarios associs ............................................... 420 tEXistConnection .................................................... 421 Proprits du tEXistConnection .......................... 421 Scnario associ ................................................. 421 tEXistDelete ............................................................. 423 Proprits du tEXistDelete .................................. 423 Scnario associ .................................................. 424 tEXistGet .................................................................. 425 Proprits du tEXistGet ....................................... 425 Scnario : Rcuprer des ressources partir dun serveur distant de base de donnes eXist .................. 426 tEXistList ................................................................. 429 Proprits du tEXistList ...................................... 429 Scnario associ ................................................. 430 tEXistPut .................................................................. 431 Proprits du tEXistPut ....................................... 431 Scnario associ .................................................. 432
tEXistXQuery ...........................................................433 Proprits du tEXistXQuery ................................433 Scnario associ ...................................................434 tEXistXUpdate .........................................................435 Proprits du tEXistXUpdate ...............................435 Scnario associ ...................................................436 tFirebirdClose ..........................................................437 Proprits du tFirebirdClose ................................437 Scnario associ ...................................................437 tFirebirdCommit .....................................................438 Proprits du tFirebirdCommit ............................438 Scnario associ ...................................................438 tFirebirdConnection ................................................439 Proprits du tFirebirdConnection ......................439 Scnario associ ..................................................440 tFirebirdInput ..........................................................441 Proprits du tFirebirdInput .................................441 Scnarios associs ................................................442 tFirebirdOutput .......................................................443 Proprits du tFirebirdOutput ..............................443 Scnarios associs ................................................445 tFirebirdRollback ....................................................447 Proprits du tFirebirdRollback ..........................447 Scnario associ ...................................................447 tFirebirdRow ............................................................448 Proprits du tFirebirdRow ..................................448 Scnarios associs ................................................450 tGreenplumBulkExec ..............................................451 Proprits du tGreenplumBulkExec ....................451 Scnarios associs ................................................453 tGreenplumClose .....................................................454 Proprits du tGreenplumClose ...........................454 Scnario associ ...................................................454 tGreenplumCommit ................................................455 Proprits du tGreenplumCommit .......................455 Scnario associ ...................................................455 tGreenplumConnection ...........................................456 Proprits du tGreenplumConnection .................456 Scnarios associs ...............................................457 tGreenplumInput .....................................................458 Proprits du tGreenplumInput ............................458 Scnarios associs ................................................459 tGreenplumOutput ..................................................460 Proprits du tGreenplumOutput .........................460 Scnarios associs ................................................463 tGreenplumOutputBulk ..........................................464 Proprits du tGreenplumOutputBulk .................464 Scnarios associs ................................................465 tGreenplumOutputBulkExec .................................466 Proprits du tGreenplumOutputBulkExec .........466 Scnarios associs ................................................467 tGreenplumRollback ...............................................469 Proprits du tGreenplumRollback .....................469 ix
Scnario associ .................................................. 469 tGreenplumRow ...................................................... 470 Proprits du tGreenplumRow ............................ 470 Scnarios associs ............................................... 472 tGreenplumSCD ...................................................... 473 tHiveClose ................................................................ 474 Proprits du tHiveClose ..................................... 474 Scnario associ .................................................. 474 tHiveConnection ...................................................... 475 Proprits du tHiveConnection .......................... 475 Scnarios associs .............................................. 476 tHiveRow .................................................................. 477 Proprits du tHiveRow ...................................... 477 Scnarios associs ............................................... 478 tHSQLDbInput ........................................................ 480 Proprits du tHSQLDbInput .............................. 480 Scnarios associs ............................................... 482 tHSQLDbOutput ..................................................... 483 Proprits du tHSQLDbOutput ........................... 483 Scnarios associs ............................................... 487 tHSQLDbRow ......................................................... 488 Proprits du tHSQLDbRow ............................... 488 Scnarios associs ............................................... 490 tInformixBulkExec .................................................. 491 Proprits du tInformixBulkExec ....................... 491 Scnario associ .................................................. 494 tInformixClose ......................................................... 495 Proprits du tInformixClose .............................. 495 Scnario associ .................................................. 495 tInformixCommit .................................................... 496 Proprits du tInformixCommit .......................... 496 Scnario associ .................................................. 496 tInformixConnection .............................................. 497 Proprits du tInformixConnection .................... 497 Scnarios associs .............................................. 498 tInformixInput ........................................................ 499 Proprits du tInformixInput ............................... 499 Scnarios associs ............................................... 500 tInformixOutput ...................................................... 501 Proprits du tInformixOutput ............................ 501 Scnarios associs ............................................... 504 tInformixOutputBulk ............................................. 505 Proprits du tInformixOutputBulk ..................... 505 Scnarios associs ............................................... 506 tInformixOutputBulkExec ..................................... 507 Proprits du tInformixOutputBulkExec ............. 507 Scnarios associs ............................................... 510 tInformixRollback ................................................... 511 Proprits du tInformixRollback ........................ 511 Scnario associ .................................................. 511 tInformixRow .......................................................... 512 Proprits du tInformixRow ................................ 512 Scnarios associs ............................................... 514 x
tInformixSCD ...........................................................515 tInformixSP ..............................................................516 Proprits du tInformixSP ....................................516 Scnarios associs ................................................518 tIngresClose ..............................................................519 Proprits du tIngresClose ...................................519 Scnario associ ...................................................519 tIngresCommit .........................................................520 Proprits du tIngresCommit ..............................520 Scnario associ ..................................................520 tIngresConnection ...................................................521 Proprits du tIngresConnection .........................521 Scnario associ ..................................................521 tIngresInput .............................................................522 Proprits du tIngresInput ....................................522 Scnarios associs ................................................523 tIngresOutput ...........................................................524 Proprits du tIngresOutput .................................524 Scnarios associs ................................................526 tIngresRollback ........................................................527 Proprits du tIngresRollback .............................527 Scnario associ ...................................................527 tIngresRow ...............................................................528 Proprits du tIngresRow .....................................528 Scnarios associs ................................................529 tIngresSCD ...............................................................530 tInterbaseClose ........................................................531 Proprits du tInterbaseClose ..............................531 Scnario associ ...................................................531 tInterbaseCommit ....................................................532 Proprits du tInterbaseCommit .........................532 Scnario associ ..................................................532 tInterbaseConnection ..............................................533 Proprits du tInterbaseConnection ....................533 Scnarios associs ...............................................533 tInterbaseInput ........................................................534 Proprits du tInterbaseInput ...............................534 Scnarios associs ................................................535 tInterbaseOutput .....................................................536 Proprits du tInterbaseOutput ............................536 Scnarios associs ................................................538 tInterbaseRollback ..................................................539 Proprits du tInterbaseRollback ........................539 Scnario associ ...................................................539 tInterbaseRow ..........................................................540 Proprits du tInterbaseRow ................................540 Scnarios associs ................................................542 tJavaDBInput ...........................................................543 Proprits du tJavaDBInput .................................543 Scnarios associs ................................................544 tJavaDBOutput ........................................................545 Proprits du tJavaDBOutput ..............................545 Scnarios asoocis ...............................................547
tJavaDBRow ............................................................ 548 Proprits du tJavaDBRow ................................. 548 Scnarios associs ............................................... 549 tJDBCColumnList .................................................. 550 Proprits du tJDBCColumnList ......................... 550 Scnario associ .................................................. 550 tJDBCClose .............................................................. 551 Proprits du tJDBCClose ................................... 551 Scnario associ .................................................. 551 tJDBCCommit ......................................................... 552 Proprits du tJDBCCommit ............................... 552 Scnario associ .................................................. 552 tJDBCConnection ................................................... 553 Proprits du tJDBCConnection ......................... 553 Scnario associ .................................................. 554 tJDBCInput ............................................................. 555 Proprits du tJDBCInput ................................... 555 Scnarios associs ............................................... 557 tJDBCOutput .......................................................... 558 Proprits du tJDBCOutput ................................. 558 Scnarios associs ............................................... 561 tJDBCRollback ........................................................ 562 Proprits du tJDBCRollback ............................. 562 Scnario associ .................................................. 562 tJDBCRow ............................................................... 563 Proprits du tJDBCRow .................................... 563 Scnarios associs ............................................... 565 tJDBCSP .................................................................. 566 Proprits du tJDBCSP ....................................... 566 Scnarios associs ............................................... 567 tJDBCTableList ...................................................... 568 Proprits du tJDBCTableList ............................. 568 Scnario associ .................................................. 568 tLDAPAttributesInput ........................................... 569 Proprits du tLDAPAttributesInput ................... 569 Scnario associ .................................................. 571 tLDAPInput ............................................................. 572 Proprits du tLDAPInput ................................... 572 Scnario : Afficher le contenu filtr dun annuaire LDAP ........................................................................ 574 tLDAPOutput .......................................................... 576 Proprits du tLDAPOutput ................................ 576 Scnario : Editer des donnes dans un annuaire LDAP 578 tLDAPRenameEntry .............................................. 581 Proprits du tLDAPRenameEntry ..................... 581 Scnarios associs .............................................. 582 tMaxDBInput .......................................................... 583 Proprits du tMaxDBInput ................................ 583 Scnarios associs ............................................... 584 tMaxDBOutput ........................................................ 585 Proprits du tMaxDBOutput .............................. 585 Scnarios associs ............................................... 587
tMaxDBRow .............................................................588 Proprits du tMaxDBRow ..................................588 Scnarios associs ................................................589 tMSSqlBulkExec ......................................................590 Proprits du tMSSqlBulkExec ...........................590 Scnarios associs ................................................592 tMSSqlClose .............................................................593 Proprits du tMSSqlClose ..................................593 Scnario associ ...................................................593 tMSSqlColumnList ..................................................594 Proprits du tMSSqlColumnList ........................594 Scnario associ ...................................................594 tMSSqlCommit ........................................................595 Proprits du tMSSqlCommit ..............................595 Scnario associ ...................................................595 tMSSqlConnection ...................................................596 Proprits du tMSSqlConnection .........................596 Scnario associ ...................................................597 tMSSqlInput .............................................................598 Proprits du tMSSqlInput ...................................598 Scnarios associs ................................................600 tMSSqlLastInsertId .................................................601 Proprits du tMSSqlLastInsertId ........................601 Scnario associ ...................................................601 tMSSqlOutput ..........................................................602 Proprits du tMSSqlOutput ................................602 Scnarios associs ................................................606 tMSSqlOutputBulk ..................................................607 Proprits du tMSSqlOutputBulk ........................607 Scnarios associs ................................................608 tMSSqlOutputBulkExec .........................................609 Proprits du tMSSqlOutputBulkExec ................609 Scnarios associs ................................................611 tMSSqlRollback .......................................................612 Proprits du tMSSqlRollback .............................612 Scnario associ ...................................................612 tMSSqlRow ...............................................................613 Proprits du tMSSqlRow ....................................613 Scnarios associs ................................................615 tMSSqlSCD ..............................................................616 tMSSqlSP ..................................................................617 Proprits du tMSSqlSP .......................................617 Scnarios associs ................................................619 tMSSqlTableList ......................................................620 Proprits du tMSSqlTableList ............................620 Scnario associ ..................................................620 tMysqlBulkExec .......................................................621 Proprits du tMysqlBulkExec ............................621 Scnarios associs ................................................623 tMysqlClose ..............................................................624 Proprits du tMysqlClose ...................................624 Scnario associ ...................................................624 tMysqlColumnList ...................................................625 xi
Proprits du tMysqlColumnList ........................ 625 Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table ................................. 625 tMysqlCommit ......................................................... 629 Proprits du tMysqlCommit .............................. 629 Scnario associ .................................................. 629 tMysqlConnection ................................................... 630 Proprits du tMysqlConnection ......................... 630 Scnario : Insrer des donnes dans des tables mre/fille ................................................................... 630 tMysqlInput ............................................................. 635 Proprits du tMysqlInput ................................... 635 Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie .... 637 tMysqlLastInsertId ................................................. 642 Proprits du tMysqlLastInsertId ........................ 642 Scnario : Rcuprer les ID des dernires entres ajoutes ...................................................................... 642 tMysqlOutput .......................................................... 647 Proprits du tMysqlOutput ................................ 647 Scnario 1 : Ajouter une colonne et modifier les donnes ............................................................................ 651 Scnario 2 : Effectuer des mises jour dans une base de donnes ................................................................. 656 Scnario 3 : Rcuprer les donnes errones laide dun lien Reject ......................................................... 659 tMysqlOutputBulk ................................................. 665 Proprits du tMysqlOutputBulk ......................... 665 Scnario : Insrer des donnes transformes dans une base MySQL ............................................................. 666 tMysqlOutputBulkExec .......................................... 670 Proprits du tMysqlOutputBulkExec ................. 670 Scnario : Insrer des donnes dans une base MySQL 672 tMysqlRollback ....................................................... 674 Proprits du tMysqlRollback ............................. 674 Scnario : Annuler linsertion de donnes dans des tables mre/fille ............................................................ 674 tMysqlRow ............................................................... 676 Proprits du tMysqlRow .................................... 676 Scnario 1 : Supprimer et re-gnrer un index de table MySQL ...................................................................... 678 Scnario 2 : Utiliser linstance PreparedStatement pour faire une requte sur des donnes ..................... 679 tMysqlSCD ............................................................... 686 tMysqlSCDELT ....................................................... 687 tMysqlSP .................................................................. 688 Proprits du tMysqlSP ....................................... 688 Scnario : Trouver le libell State laide dune procdure stocke ...................................................... 689 tMysqlTableList ...................................................... 693 Proprits du tMysqlTableList ............................ 693 Scnario : Effectuer une opration ditration sur des xii
tables et en effacer le contenu grce un modle SQL dfini par lutilisateur (SQL Template) ....................693 Scnario associ ...................................................697 tNetezzaBulkExec ....................................................698 Proprits du tNetezzaBulkExec .........................698 Scnarios associs ...............................................700 tNetezzaClose ...........................................................701 Proprits du tNetezzaClose ................................701 Scnario associ ...................................................701 tNetezzaCommit .......................................................702 Proprits du tNetezzaCommit ...........................702 Scnario associ ..................................................702 tNetezzaConnection .................................................703 Proprits du tNetezzaConnection ......................703 Scnario associ ..................................................704 tNetezzaInput ...........................................................705 Proprits du tNetezzaInput .................................705 Scnarios associs ................................................707 tNetezzaNzLoad .......................................................708 Proprits du tNetezzaNzLoad ............................708 Charger des colonnes de type DATE, TIME et TIMESTAMP ............................................................714 Scnario associ ...................................................714 tNetezzaOutput ........................................................715 Proprits du tNetezzaOutput ..............................715 Scnarios associs ................................................718 tNetezzaRollback .....................................................719 Proprits du tNetezzaRollback ..........................719 Scnario associ ..................................................719 tNetezzaRow .............................................................720 Proprits du tNetezzaRow .................................720 Scnario associ ..................................................722 tOracleBulkExec ......................................................723 Proprits du tOracleBulkExec ............................723 Scnario : Supprimer et insrer des donnes dans une base Oracle ................................................................726 tOracleClose .............................................................730 Proprits du tOracleClose ..................................730 Scnario associ ...................................................730 tOracleCommit ........................................................731 Proprits du tOracleCommit ..............................731 Scnario associ ...................................................731 tOracleConnection ...................................................732 Proprits du tOracleConnection .........................732 Scnario associ ...................................................733 tOracleInput .............................................................734 Proprits du tOracleInput ...................................734 Scnarios associs ................................................736 tOracleOutput ..........................................................737 Proprits du tOracleOutput ................................737 Scnarios associs ................................................741 tOracleOutputBulk ..................................................742 Proprits du tOracleOutputBulk .........................742
Scnarios associs ............................................... 743 tOracleOutputBulkExec ......................................... 744 Proprits du tOracleOutputBulkExec ................ 744 Scnarios associs ............................................... 747 tOracleRollback ...................................................... 748 Proprits du tOracleRollback ............................. 748 Scnario associ .................................................. 748 tOracleRow .............................................................. 749 Proprits du tOracleRow ................................... 749 Scnario associ .................................................. 751 tOracleSCD .............................................................. 752 tOracleSCDELT ...................................................... 753 tOracleSP ................................................................. 754 Proprits du tOracleSP ....................................... 754 Scnario : Vrifier le format de numros laide dune procdure stocke ............................................ 756 tOracleTableList ..................................................... 761 Proprits du tOracleTableList ............................ 761 Scnario associ .................................................. 761 tParAccelBulkExec ................................................. 762 Proprits du tParAccelBulkExec ....................... 762 Scnarios associs ............................................... 764 tParAccelClose ........................................................ 765 Proprits du tParAccelClose .............................. 765 Scnario associ .................................................. 765 tParAccelCommit .................................................... 766 Proprits du tParAccelCommit .......................... 766 Scnario associ .................................................. 766 tParAccelConnection .............................................. 767 Proprits du tParAccelConnection ..................... 767 Scnario associ .................................................. 768 tParAccelInput ........................................................ 769 Proprits du tParAccelInput ............................... 769 Scnarios associs ............................................... 771 tParAccelOutput ..................................................... 772 Proprits du tParAccelOutput ............................ 772 Scnarios associs ............................................... 775 tParAccelOutputBulk ............................................. 776 Proprits du tParAccelOutputBulk .................... 776 Scnarios associs ............................................... 777 tParAccelOutputBulkExec ..................................... 778 Proprits du tParAccelOutputBulkExec ............ 778 Scnarios associs ............................................... 779 tParAccelRollback .................................................. 781 Proprits du tParAccelRollback ........................ 781 Scnario associ ................................................. 781 tParAccelRow .......................................................... 782 Proprits du tParAccelRow ............................... 782 Scnarios associs ............................................... 784 tParAccelSCD .......................................................... 785 tParseRecordSet ...................................................... 786 Proprits du tParseRecordSet ............................ 786 Scnario associ .................................................. 786
tPostgresPlusBulkExec ............................................787 Proprits du tPostgresPlusBulkExec .................787 Scnario associ ...................................................789 tPostgresPlusClose ...................................................790 Proprits du tPostgresPlusClose .........................790 Scnario associ ...................................................790 tPostgresPlusCommit ..............................................791 Proprits du tPostgresPlusCommit .....................791 Scnario associ ...................................................791 tPostgresPlusConnection .........................................792 Proprits du tPostgresPlusConnection ...............792 Scnario associ ...................................................793 tPostgresPlusInput ...................................................794 Proprits du tPostgresPlusInput .........................794 Scnarios associs ................................................796 tPostgresPlusOutput ................................................797 Proprits du tPostgresPlusOutput .......................797 Scnarios associs ................................................801 tPostgresPlusOutputBulk .......................................802 Proprits du tPostgresPlusOutputBulk ...............802 Scnarios associs ................................................803 tPostgresPlusOutputBulkExec ...............................804 Proprits du tPostgresplusOutputBulkExec .......804 Scnarios associs ................................................805 tPostgresPlusRollback .............................................806 Proprits du tPostgresPlusRollback ..................806 Scnario associ ..................................................806 tPostgresPlusRow ....................................................807 Proprits du tPostgresPlusRow ..........................807 Scnarios associs ................................................809 tPostgresPlusSCD ....................................................810 tPostgresPlusSCDELT ............................................811 tPostgresqlBulkExec ................................................812 Proprits du tPostgresqlBulkExec ......................812 Scnarios associs ................................................814 tPostgresqlClose .......................................................815 Proprits du tPostgresqlClose ............................815 Scnario associ ...................................................815 tPostgresqlCommit ..................................................816 Proprits du tPostgresqlCommit ........................816 Scnario associ ...................................................816 tPostgresqlConnection .............................................817 Proprits du tPostgresqlConnection ...................817 Scnario associ ...................................................818 tPostgresqlInput .......................................................819 Proprits du tPostgresqlInput .............................819 Scnarios associs ................................................821 tPostgresqlOutput ....................................................822 Proprits du tPostgresqlOutput ..........................822 Scnarios associs ................................................825 tPostgresqlOutputBulk ..........................................826 Proprits du tPostgresqlOutputBulk ...................826 Scnarios associs ................................................827 xiii
tPostgresqlOutputBulkExec ................................... 828 Proprits du tPostgresqlOutputBulkExec .......... 828 Scnarios associs ............................................... 830 tPostgresqlRollback ................................................ 831 Proprits du tPostgresqlRollback ....................... 831 Scnario associ .................................................. 831 tPostgresqlRow ........................................................ 832 Proprits du tPostgresqlRow ............................. 832 Scnarios associs ............................................... 834 tPostgresqlSCD ........................................................ 835 tPostgresqlSCDELT ................................................ 836 tSASInput ................................................................ 837 Proprits du tSASInput ...................................... 837 Scnarios associs ............................................... 838 tSASOutput .............................................................. 839 Proprits du tSASOutput ................................... 839 Scnarios associs ............................................... 841 tSQLiteClose ............................................................ 842 Proprits du tSQLiteClose ................................. 842 Scnario associ .................................................. 842 tSQLiteCommit ....................................................... 843 Proprits du tSQLiteCommit ............................. 843 Scnario associ .................................................. 843 tSQLiteConnection .................................................. 844 Proprits du tSQLiteConnection ........................ 844 Scnarios associs .............................................. 845 tSQLiteInput ............................................................ 846 Proprits du tSQLiteInput .................................. 846 Scnario : Filtrer des donnes SQlite .................. 847 tSQLiteOutput ......................................................... 850 Proprits du tSQLiteOutput ............................... 850 Scnario associ .................................................. 853 tSQLiteRollback ...................................................... 854 Proprits du tSQLiteRollback ........................... 854 Scnario associ .................................................. 854 tSQLiteRow ............................................................. 855 Proprits du tSQLiteRow ................................... 855 Scnario : Mettre jour des lignes SQLite .......... 857 tSybaseBulkExec ..................................................... 859 Proprits du tSybaseBulkExec ........................... 859 Scnarios associs ............................................... 861 tSybaseClose ............................................................ 862 Proprits du tSybaseClose ................................. 862 Scnario associ .................................................. 862 tSybaseCommit ........................................................ 863 Proprits du tSybaseCommit ............................ 863 Scnario associ ................................................. 863 tSybaseConnection .................................................. 864 Proprits du tSybaseConnection ....................... 864 Scnarios associs .............................................. 864 tSybaseInput ............................................................ 865 Proprits du tSybaseInput .................................. 865 Scnario associ .................................................. 867 xiv
tSybaseIQBulkExec .................................................868 Proprits du tSybaseIQBulkExec ......................868 Scnario associ ...................................................870 tSybaseIQOutputBulkExec .....................................871 Proprits du tSybaseIQOutputBulkExec ...........871 Scnarios associs ...............................................873 tSybaseOutput ..........................................................874 tSybaseOutput Properties .....................................874 Scnario associ ...................................................877 tSybaseOutputBulk .................................................879 Proprits du tSybaseOutputBulk ........................879 Scnario associ ...................................................880 tSybaseOutputBulkExec .........................................881 Proprits du tSybaseOutputBulkExec ................881 Scnarios associs ................................................883 tSybaseRollback .......................................................884 Proprits du tSybaseRollback ...........................884 Scnario associ ..................................................884 tSybaseRow ..............................................................885 Proprits du tSybaseRow ...................................885 Scnario associ ...................................................887 tSybaseSCD ..............................................................888 tSybaseSCDELT ......................................................889 tSybaseSP .................................................................890 Proprits du tSybaseSP ......................................890 Scnario associ ...................................................892 tTeradataClose .........................................................893 Proprits du tTeradataClose ...............................893 Scnario associ ...................................................893 tTeradataCommit ....................................................894 Proprits du tTeradataCommit ...........................894 Scnario associ ...................................................894 tTeradataConnection ...............................................895 Proprits du tTeradataConnection ......................895 Scnario associ ...................................................896 tTeradataFastExport ...............................................897 Proprits du tTeradataFastExport .......................897 Scnario associ ...................................................898 tTeradataFastLoad ..................................................899 Proprits du tTeradataFastLoad .........................899 Scnario associ ...................................................900 tTeradataFastLoadUtility .......................................901 Proprits du tTeradataFastLoadUtility ...............901 Scnario associ ...................................................902 tTeradataInput .........................................................903 Proprits du tTeradataInput ................................903 Scnario associ ...................................................905 tTeradataMultiLoad ................................................906 Proprits du tTeradataMultiLoad .......................906 Scnario associ ...................................................908 tTeradataOutput ......................................................909 Proprits du tTeradataOutput .............................909 Scnario associ ...................................................913
tTeradataRollback .................................................. 914 Proprits du tTeradataRollback ........................ 914 Scnario associ ................................................. 914 tTeradataRow .......................................................... 915 Proprits du tTeradataRow ................................ 915 Scnario associ .................................................. 917 tTeradataTPump ..................................................... 918 Proprits du tTeradataTPump ............................ 918 Scnario : Insrer des donnes dans une table dune base de donnes Teradata .......................................... 920 tVectorWiseCommit ............................................... 924 Proprits du tVectorWiseCommit ..................... 924 Scnario associ .................................................. 924 tVectorWiseConnection .......................................... 925 Proprits du tVectorWiseConnection ................ 925 Scnario associ .................................................. 926 tVectorWiseInput .................................................... 927 Proprits du tVectorWiseInput .......................... 927 Scnario associ .................................................. 929 tVectorWiseOutput ................................................. 930 Proprits du tVectorWiseOutput ....................... 930 Scnario associ .................................................. 933 tVectorWiseRollback .............................................. 935 Proprits du tVectorWiseRollback ................... 935 Scnario associ ................................................. 935 tVectorWiseRow ...................................................... 936 Proprits du tVectorWiseRow ........................... 936 Scnario associ .................................................. 938 tVerticaBulkExec .................................................... 939 Proprits du tVerticaBulkExec .......................... 939 Scnarios associs .............................................. 941 tVerticaClose ........................................................... 942 Proprits du tVerticaClose ................................. 942 Scnario associ .................................................. 942 tVerticaCommit ....................................................... 943 Proprits du tVerticaCommit ............................. 943 Scnario associ .................................................. 943 tVerticaConnection ................................................. 944 Proprits du tVerticaConnection ....................... 944 Scnario associ .................................................. 945 tVerticaInput ........................................................... 946 Proprits du tVerticaInput ................................. 946 Scnarios associs .............................................. 948 tVerticaOutput ........................................................ 949 Proprits du tVerticaOutput ............................... 949 Scnarios associs .............................................. 953 tVerticaOutputBulk ................................................ 954 Proprits du tVerticaOutputBulk ....................... 954 Scnarios associs ............................................... 955 tVerticaOutputBulkExec ........................................ 956 Proprits du tVerticaOutputBulkExec ............... 956 Scnarios associs .............................................. 957 tVerticaRollback ..................................................... 958
Proprits du tVerticaRollback ...........................958 Scnario associ ..................................................958 tVerticaRow .............................................................959 Proprits du tVerticaRow ...................................959 Scnario associ ...................................................961
Composants ELT .....................................963

tELTJDBCInput ......................................................964 Proprits de tELTJDBCInput .............................964 Scnarios associs ................................................964 tELTJDBCMap .......................................................966 Proprits de tELTJDBCMap ..............................966 Scnarios associs ................................................967 tELTJDBCOutput ...................................................968 Proprits de tELTJDBCOutput ..........................968 Scnarios associs ................................................969 tELTMSSqlInput .....................................................970 Proprits de tELTMSSqlInput ............................970 Scnarios associs ................................................970 tELTMSSqlMap ......................................................972 Proprits de tELTMSSqlMap .............................972 Scnarios associs ................................................973 tELTMSSqlOutput ..................................................974 Proprits de tELTMSSqlOutput .........................974 Scnarios associs ................................................975 tELTMysqlInput ......................................................976 Proprits de tELTMysqlInput ............................976 Scnarios associs ................................................976 tELTMysqlMap .......................................................978 Proprits de tELTMysqlMap ..............................978 Connecter les composants ELT ........................980 Tables de jointure et de correspondance ..........980 Ajouter des clauses WHERE ............................980 Gnrer la requte SQL ....................................981 Scnario 1 : Agrger les colonnes dune table et appliquer un filtre ..........................................................981 Scnario 2 : ELT utilisant une table Alias ...........985 tELTMysqlOutput ...................................................990 Proprits de tELTMysqlOutput ..........................990 Scnarios associs ................................................991 tELTOracleInput .....................................................992 Proprits de tELTOracleInput ............................992 Scnario associ ...................................................993 tELTOracleMap ......................................................994 Proprits de tELTOracleMap .............................994 Connecter les composants ELT ........................996 Tables de jointure et de correspondance ..........996 Ajouter des clauses Where ...............................996 Gnrer la requte SQL ....................................996 Scnario : Mettre jour les lignes dune base Oracle 996 tELTOracleOutput ................................................1000 xv
Proprits de tELTOracleOutput ....................... 1000 Scnario : Utiliser la fonction MERGE dOracle pour mettre jour et insrer simultanment des donnes 1001 tELTPostgresqlInput ............................................ 1008 Proprits de tELTPostgresqlInput ................... 1008 Scnarios associs ............................................. 1008 tELTPostgresqlMap .............................................. 1010 Proprits de tELTPostgresqlMap ..................... 1010 Scnarios associs ............................................. 1011 tELTPostgresqlOutput ......................................... 1012 Proprits de tELTPostgresqlOutput ................. 1012 Scnarios associs ............................................. 1013 tELTSybaseInput .................................................. 1014 Proprits de tELTSybaseInput ......................... 1014 Scnarios associs ............................................. 1014 tELTSybaseMap .................................................... 1016 Proprits de tELTSybaseMap .......................... 1016 Scnarios associs ............................................. 1017 tELTSybaseOutput ............................................... 1018 Proprits de tELTSybaseOutput ...................... 1018 Scnarios associs ............................................. 1019 tELTTeradataInput .............................................. 1020 Proprits de tELTTeradataInput ...................... 1020 Scnarios associs ............................................. 1020 tELTTeradataMap ................................................ 1022 Proprits de tELTTeradataMap ....................... 1022 Connecter les composants ELT ...................... 1024 Tables de jointure et de correspondance ........ 1024 Ajouter des clauses Where ............................. 1024 Gnrer la requte SQL .................................. 1024 Scnarios associs ............................................. 1024 tELTTeradataOutput ........................................... 1025 Proprits de tELTTeradataOutput ................... 1025 Scnarios associs ............................................. 1026 tSQLTemplateAggregate ...................................... 1027 Proprits du tSQLTemplateAggregate ............ 1027 Scnario : Filtrer et agrger les colonnes dune table directement dans le SGBD ...................................... 1029 tSQLTemplateCommit ......................................... 1034 Proprits du tSQLTemplateCommit ................ 1034 Scnario associ ................................................ 1035 tSQLTemplateFilterColumns .............................. 1036 Proprits du tSQLTemplateFilterColumns ...... 1036 Scnario associ ................................................ 1037 tSQLTemplateFilterRows .................................... 1038 Proprits du tSQLTemplateFilterRows ........... 1038 Scnario associ ................................................ 1039 tSQLTemplateMerge ............................................ 1040 Proprits du tSQLTemplateMerge ................... 1040 Scnario : Effectuer des oprations de MERGE directement dans le SGBD ......................................... 1042 tSQLTemplateRollback ........................................ 1049 Proprits du tSQLTemplateRollback .............. 1049 xvi
Scnario associ .................................................1050
Composants ESB ...................................1051

tESBConsumer .......................................................1052 Proprits du tESBConsumer ............................1052 Scnario : Retourner une adresse e-mail valide 1054 tESBProviderFault ................................................1062 Proprits du tESBProviderFault ......................1062 Scnario : Retourner un message Fault ..............1062 Crer un Job fournisseur .................................1063 Crer un Job consommateur ...........................1067 Excuter le scnario ........................................1073 tESBProviderRequest ...........................................1074 Proprits du tESBProviderRequest ..................1074 Scnario : Un service reoit un message sans attendre de rponse ................................................................1074 Crer un Job fournisseur .................................1075 Crer un Job consommateur ...........................1079 Excuter le scnario ........................................1085 tESBProviderResponse .........................................1087 Proprits du tESBProviderResponse ................1087 Scnario : Retourner une rponse Hello world ...... 1087 Crer un Job fournisseur .................................1087 Crer un Job consommateur ...........................1092 Excuter le scnario ........................................1098
Composants File .....................................1101

tAdvancedFileOutputXML ...................................1102 tApacheLogInput ...................................................1103 Proprits du tApacheLogInput .........................1103 Scnario : Lire un fichier de log daccs Apache ..... 1104 tChangeFileEncoding ............................................1106 tChangeFileEncoding Properties .......................1106 Scnario: Transformer lencodage des caractres dun fichier .......................................................................1106 tCreateTemporaryFile .........................................1109 Proprits du tCreateTemporaryFile ..................1109 Scnario : Crer un fichier temporaire et y crire des donnes ....................................................................1110 tFileArchive ............................................................1114 Proprits du tFileArchive .................................1114 Scnario : Zipper des fichiers laide dun tFileArchive ............................................................................1115 tFileCompare .........................................................1117 Proprits du tFileCompare ...............................1117 Scnario : Comparer des fichiers dzipps ........1118 tFileCopy ................................................................1121 Proprits du tFileCopy .....................................1121
Scnario : Rcuprer un fichier de la corbeille . 1122 tFileDelete .............................................................. 1124 Proprits du tFileDelete ................................... 1124 Scnario : Supprimer des fichiers ...................... 1124 tFileExist ................................................................ 1127 Proprits du tFileExist ..................................... 1127 Scnario : Vrifier lexistence dun fichier et le crer sil nexiste pas ........................................................ 1128 tFileInputARFF ..................................................... 1132 Proprits du tFileInputARFF ........................... 1132 Scnario : Afficher le contenu dun fichier ARFF .... 1133 tFileInputDelimited ............................................... 1136 Proprits du tFileInputDelimited ..................... 1136 Scnario 1 : Afficher le contenu dun fichier dlimit 1138 Scnario 2 : Lire les donnes dun fichier distant en mode stream ............................................................ 1139 tFileInputEBCDIC ................................................ 1143 Proprits du tFileInputEBCDIC ...................... 1143 Scnario : Extraire les donnes dun fichier EBCDIC et alimenter une base de donnes ............................ 1143 tFileInputExcel ..................................................... 1149 Proprits du tFileInputExcel ........................... 1149 Scnario associ ................................................ 1151 tFileInputFullRow ................................................ 1152 Proprits du tFileInputFullRow ....................... 1152 Scnario : Lire des lignes compltes dans un fichier dlimit .................................................................... 1153 tFileInputJSON .................................................... 1155 Proprits du tFileInputJSON .......................... 1155 Scnario : Extraire les donnes des champs dun fichier au format JSON ................................................ 1156 tFileInputLDIF ..................................................... 1159 Proprits du tFileInputLDIF ............................ 1159 Scnario associ ................................................ 1160 tFileInputMail ....................................................... 1161 Proprits du tFileInputMail ............................. 1161 Scnario : Extraire des champs cls dun email 1162 tFileInputMSDelimited ........................................ 1164 Proprits du tFileInputMSDelimited ............... 1164 Lditeur de schmas Multi Schema Editor ... 1164 Scnario : Lecture dun fichier dlimit multi structure ......................................................... 1166 tFileInputMSPositional ....................................... 1172 Proprits du tFileInputMSPositional ............... 1172 Scnario associ ................................................ 1173 tFileInputMSXML ................................................ 1174 Proprits du tFileInputMSXML ...................... 1174 Scnario : Lecture dun fichier XML multi structur 1175 tFileInputPositional .............................................. 1178 Proprits du tFileInputPositional ..................... 1178
Scnario : Transformer un fichier positionnel en XML ........................................................................1180 tFileInputProperties ..............................................1183 Proprits du tFileInputProperties .....................1183 Scnario : Lire et mapper la cl et les valeurs de fichiers properties et alimenter un glossaire ..................1184 tFileInputRegex .....................................................1188 Proprits du tFileInputRegex ...........................1188 Scnario : Transformer en fichier Regex en Positional 1189 tFileInputXML .......................................................1192 tFileList ..................................................................1193 Proprits du tFileList ........................................1193 Scnario : Itration sur un rpertoire .................1195 tFileOutputARFF ..................................................1199 Proprits du tFileOutputARFF .........................1199 Scnario associ .................................................1200 tFileOutputDelimited ............................................1201 Proprits du tFileOutputDelimited ...................1201 Scnario : Ecrire des donnes dans un fichier dlimit 1202 tFileOutputEBCDIC .............................................1207 Proprits du tFileOutputEBCDIC ....................1207 Scnario : Crer un fichier EBCDIC partir de deux fichiers dlimits ......................................................1207 tFileOutputExcel ....................................................1210 Proprits du tFileOutputExcel ..........................1210 Scnario associ .................................................1211 tFileOutputJSON ..................................................1212 Propits du tFileOutputJSON ..........................1212 Scnario : Ecrire un fichier JSON structur .......1212 tFileOutputLDIF ...................................................1216 Proprits du tFileOutputLDIF ..........................1216 Scnario : Ecrire des donnes dans un fichier LDIF .. 1217 tFileOutputMSDelimited .....................................1220 Proprits du tFileOutputMSDelimited ............1220 Scnario associ .................................................1221 tFileOutputMSPositional .....................................1222 Proprits du tFileOutputMSPositional .............1222 Scnario associ .................................................1223 tFileOutputMSXML ..............................................1224 Proprits du tFileOutputMSXML ....................1224 Dfinir un arbre XML Multischma ...............1224 Mapping de donnes XML partir de sources multischma ...................................................................1227 Dfinir le statut du noeud ...............................1228 Scnario associ .................................................1229 tFileOutputPositional ............................................1230 Proprits du tFileOutputPositional ...................1230 Scnario associ : ..............................................1231 tFileOutputProperties ...........................................1232 Proprits du tFileOutputProperties ...................1232 xvii
Scnario associ ................................................ 1233 tFileOutputXML ................................................... 1234 tFileProperties ....................................................... 1235 Proprits du tFileProperties ............................. 1235 Scnario : Afficher les proprits dun fichier trait . 1236 tFileRowCount ...................................................... 1238 Proprits du tFileRowCount ............................ 1238 Scnario associ : .............................................. 1239 tFileTouch .............................................................. 1240 Proprits du tFileTouch ................................... 1240 Scnario associ : ............................................. 1240 tFileUnarchive ....................................................... 1241 Proprits du tFileUnarchive ............................. 1241 Scnario associ ................................................ 1242 tGPGDecrypt ......................................................... 1243 Proprits du tGPGDecrypt ............................... 1243 Scnario : Dcrypter un fichier crypt GnuPG et afficher son contenu ................................................... 1243 tPivotToColumnsDelimited .................................. 1247 Proprits du tPivotToColumnsDelimited ........ 1247 Scnario : Utiliser une colonne pivot pour agrger des donnes .................................................................... 1247
Composants Internet ............................. 1251

tFileFetch ............................................................... 1252 Proprits du tFileFetch ..................................... 1252 Scnario 1 : Rcuprer des donnes partir dun protocole HTTP ............................................................ 1254 Scnario 2 : Rutiliser un cookie stock pour rcuprerdes fichiers via un protocole HTTP ............ 1255 Scnario associ ................................................ 1258 tFileInputJSON ..................................................... 1259 tFTPConnection .................................................... 1260 Proprits du tFTPConnection .......................... 1260 Scnarios associs ............................................. 1261 tFTPDelete ............................................................. 1262 Proprits du tFTPDelete .................................. 1262 Scnarios associs ............................................. 1263 tFTPFileExist ......................................................... 1264 Proprits du tFTPFileExist .............................. 1264 Scnarios associs ............................................. 1265 tFTPFileList .......................................................... 1266 Proprits du tFTPFileList ............................... 1266 Scnario : Itration sur un rpertoire distant .... 1267 tFTPFileProperties ................................................ 1271 Proprits du tFTPFileProperties ...................... 1271 Scnario associ ................................................ 1272 tFTPGet .................................................................. 1273 Proprits du tFTPGet ....................................... 1273 Scnario associ ................................................ 1275 tFTPPut .................................................................. 1276 xviii
Proprits du tFTPPut ........................................1276 Scnario : Copier des fichiers sur un serveur FTP distant ...........................................................................1277 tFTPRename ..........................................................1280 Proprits du tFTPRename ................................1280 Scnario associ .................................................1281 tFTPTruncate .........................................................1282 Proprits du tFTPTruncate ...............................1282 Scnario associ .................................................1283 tHttpRequest ..........................................................1284 Proprits du tHttpRequest ................................1284 Scnario : Envoyer une requte HTTP au serveur et sauvegarder localement les rponses HTTP obtenues ..... 1285 tJMSInput ..............................................................1287 Proprits du tJMSInput ....................................1287 Scnario associ : ..............................................1288 tJMSOutput ...........................................................1289 Proprits du tJMSOutput ..................................1289 Scnario associ : ..............................................1290 tMicrosoftMQInput ...............................................1291 Proprits du tMicrosoftMQInput ......................1291 Scnario : Ecrire et rcuprer des messages dans une file dattente de message Microsoft .........................1292 tMicrosoftMQOutput ............................................1295 Proprits du tMicrosoftMQOutput ...................1295 Scnario associ .................................................1295 tMomCommit .........................................................1296 Proprits du tMomCommit ..............................1296 Scnario associ .................................................1296 tMomInput .............................................................1297 Proprits du tMomInput ...................................1297 Scnario : Communication asynchrone via un serveur MOM .......................................................................1298 tMomMessageIdList ..............................................1302 Proprits du tMomMessageIdList ...................1302 Scnario associ ................................................1302 tMomOutput ..........................................................1303 Proprits du tMomOutput ................................1303 Scnario associ .................................................1304 tMomRollback .......................................................1305 Proprits du tMomRollback ............................1305 Scnario associ .................................................1305 tPOP ........................................................................1306 Proprits du tPOP .............................................1306 Scnario : Rcuprer une slection de-mails partir dun compte de messagerie .....................................1307 tREST .....................................................................1310 Proprits du tREST ..........................................1310 Scnario : Crer et rcuprer des donnes en invoquant un service Web REST ....................................1311 tRSSInput ...............................................................1314 Proprits du tRSSInput ....................................1314
Scnario : Rcuprer les billets frquemment mis jour sur un blog ....................................................... 1314 tRSSOutput ............................................................ 1317 Proprits du tRSSOutput ................................ 1317 Scnario 1 : Crer un flux RSS et stocker les fichiers sur un serveur FTP ................................................ 1318 Scnario 2 : Crer un flux RSS contenant des mtadonnes .................................................................. 1322 Scnario 3 : Crer un fichier XML de flux ATOM ... 1325 tSCPClose .............................................................. 1329 Proprits du tSCPClose ................................... 1329 Scnario associ ................................................ 1329 tSCPConnection .................................................... 1330 Proprits du tSCPConnection .......................... 1330 Scnarios associs ............................................. 1330 tSCPDelete ............................................................. 1331 Proprits du tSCPDelete .................................. 1331 Scnario associ ................................................ 1331 tSCPFileExists ....................................................... 1332 Proprits du tSCPFileExists ............................. 1332 Scnario associ ................................................ 1332 tSCPFileList ........................................................... 1333 Proprits du tSCPFileList ................................ 1333 Scnario associ ................................................ 1333 tSCPGet .................................................................. 1334 Proprits du tSCPGet ....................................... 1334 Scnario : Rcuprer des fichiers dun serveur SCP distant ...................................................................... 1334 tSCPPut .................................................................. 1336 Proprits du tSCPPut ....................................... 1336 Scnario associ ................................................ 1336 tSCPRename .......................................................... 1337 Proprits du tSCPRename ............................... 1337 Scnario associ ................................................ 1337 tSCPTruncate ........................................................ 1338 Proprits du tSCPRename ............................... 1338 Scnario associ ................................................ 1338 tSendMail ............................................................... 1339 Proprits du tSendMail .................................... 1339 Scnario : Envoyer un e-mail lors dune erreur 1340 tSetKeystore ........................................................... 1344 Proprits du tSetKeystore ................................ 1344 Scnario : Extraire des informations client dun fichier WSDL priv ........................................................ 1345 tSocketInput .......................................................... 1350 Proprits du tSocketInput ................................ 1350 Scnario : Transfrer des donnes vers un port dcoute (Java) ........................................................ 1352 tSocketOutput ........................................................ 1355 Proprits du tSocketOutput .............................. 1355 Scnario associ ................................................ 1356 tSOAP ..................................................................... 1357
Proprits du tSOAP ..........................................1357 Scnario : Extraire des informations mto en utilisant un Service Web ...............................................1358 tWebServiceInput ..................................................1361 Proprits du tWebServiceInput ........................1361 Scnario 1 : Extraire des images laide dun Webservice ......................................................................1363 Scnario 2 : Lire des donnes publies dans un service Web, en utilisant les fonctions avances du tWebServiceInput (Java) ..................................................1364 tXMLRPCInput .....................................................1370 Proprits du tXMLRPCInput ...........................1370 Scnario : Chercher le nom dun Etat via une mthode XMLRPC .................................................................1370
Composants Logs & Errors ...................1373

tAssert .....................................................................1374 Proprits du tAssert ..........................................1374 1374 Scnario : Paramtrer une condition assertive pour lexcution dun Job ................................................1374 tAssertCatcher .......................................................1380 Proprits du tAssertCatcher ..............................1380 Scnario associ .................................................1381 tChronometerStart ................................................1382 Proprits du tChronometerStart ........................1382 Scnario associ .................................................1382 tChronometerStop .................................................1383 Proprits du tChronometerStop ........................1383 Scnario : Mesurer la dure de traitement dun sous-Job ou dune partie dun sous-Job ...................1383 tDie ..........................................................................1388 Proprits du tDie ..............................................1388 Scnarios associs ..............................................1388 tFlowMeter .............................................................1389 Proprits du tFlowMeter ..................................1389 Scnario associ .................................................1389 tFlowMeterCatcher ...............................................1390 Proprits du tFlowMeterCatcher ......................1390 Scnario : Mesurer le flux dun Job ...................1391 tLogCatcher ...........................................................1395 Proprits du tLogCatcher ................................1395 Scnario 1 : Avertissement & log lors de la cration dentres ...................................................................1395 Scnario 2 : Monitorer & arrter un Job ............1397 tLogRow ................................................................1399 Proprits du tLogRow ......................................1399 Scnarios associs ..............................................1399 tStatCatcher ...........................................................1400 Proprits du tStatCatcher ..................................1400 Scnario : Afficher les statistiques du Job .........1400 tWarn ......................................................................1403 xix
Proprits du tWarn ........................................... 1403 Scnarios associs ............................................. 1403
Composants Misc ................................... 1405

tAddLocationFromIP .......................................... 1406 Proprits du tAddLocationFromIP .................. 1406 Scnario : Identifier la localisation gographique dune adresse IP ...................................................... 1407 tBufferInput ........................................................... 1410 Proprits du tBufferInput ................................. 1410 Scnario : Rcuprer les donnes mises en tampon (Java) ....................................................................... 1410 tBufferOutput ........................................................ 1413 Proprits du tBufferOutput .............................. 1413 Scnario 1 : Mettre des donnes en tampon (Java) ... 1413 Scnario 2 : Mettre les donnes de sortie en mmoire tampon du serveur dapplication Web .................... 1416 Scnario 3 : Appeler un Job contenant des variables de contexte partir de votre navigateur Web ......... 1420 Scnario 4 : Appeler un Job export en tant que service Web dans un autre Job ..................................... 1421 tContextDump ....................................................... 1424 Proprits du tContextDump ............................. 1424 Scnario associ ............................................... 1424 tContextLoad ......................................................... 1425 Proprits du tContextLoad ............................... 1425 Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL ................ 1426 tFixedFlowInput .................................................... 1429 Proprits du tFixedFlowInput .......................... 1429 Scnarios associs ............................................. 1429 tMemorizeRows .................................................... 1431 Proprits du tMemorizeRows ......................... 1431 Scnario : Compter le nombre doccurrences de diffrents ges ............................................................. 1432 tMsgBox ................................................................ 1438 Proprits du tMsgBox ...................................... 1438 Scnario : Test de type Hello world! .............. 1438 tRowGenerator ..................................................... 1440 Proprits du tRowGenerator ............................ 1440 Dfinition du schma ..................................... 1440 Dfinition dune fonction ............................... 1441 Scnario : Gnration alatoire de fichiers de test .... 1442
Scnario : Transformer un flux de donnes en liste ... 1447 tForeach ..................................................................1452 Proprits du tForeach ......................................1452 Scnario : Faire une boucle sur une liste et rcuprer les valeurs ................................................................1452 tInfiniteLoop ..........................................................1455 Proprits du tInfiniteLoop ................................1455 Scnario associ .................................................1455 tIterateToFlow .......................................................1456 Proprits du tIterateToFlow .............................1456 Scnario : Transformer une liste de fichiers en flux de donnes ....................................................................1457 tLoop .......................................................................1459 Proprits du tLoop ............................................1459 Scnario : Excuter un Job partir dune boucle ...... 1460 tPostjob ...................................................................1462 Proprits du tPostjob ........................................1462 Scnario associ .................................................1462 tPrejob ....................................................................1463 Proprits du tPrejob ..........................................1463 Scnario associ .................................................1463 tReplicate ................................................................1464 Proprits du tReplicate .....................................1464 Scnario associ .................................................1464 tRunJob ..................................................................1465 tUnite .......................................................................1466 Proprits du tUnite ...........................................1466 Scnario : Itration sur des fichiers et fusion de contenu ..........................................................................1467 tSleep .......................................................................1470 Proprits du tSleep ...........................................1470 Scnario associ .................................................1470 tWaitForFile ...........................................................1471 Proprits du tWaitForFile .................................1471 Scnario : Attendre la suppression dun fichier 1473 tWaitForSocket ......................................................1476 Proprits du tWaitForSocket ............................1476 Scnario associ ................................................1477 tWaitForSqlData ...................................................1478 Proprit du tWaitForSqlData ............................1478 Scnario : Attendre lajout de lignes dans une table . 1479
Composants Processing .........................1483

tAggregateRow .......................................................1484 Proprits du tAggregateRow ............................1484 Scnario : Agrger des valeurs et trier des donnes .. 1486 tAggregateSortedRow ...........................................1490 Proprits du tAggregateSortedRow ..................1490
Composants Orchestration ................... 1445

tFileList ................................................................. 1446 tFlowToIterate ....................................................... 1447 Proprits du tFlowToIterate ............................. 1447
xx
Scnario associ ................................................ 1491 tConvertType ......................................................... 1492 Proprits du tConvertType ............................... 1492 Scnario : Convertir des types de donnes Java 1493 tDenormalize .......................................................... 1497 Proprits du tDenormalize ............................... 1497 Scnario 1 : Dnormaliser une colonne ............. 1498 Scnario 2 : Dnormaliser plusieurs colonnes .. 1499 tDenormalizeSortedRow ...................................... 1502 Proprits du tDenormalizeSortedRow ............. 1502 Scnario : Regrouper des lignes tries .............. 1502 tEmptyToNull ........................................................ 1506 Proprits du tEmptyToNull ............................ 1506 Scnario : Remplacer des champs vides par des champs non-dfinis (NULL) .................................. 1506 tExternalSortRow ................................................. 1510 Proprits du tExternalSortRow ........................ 1510 Scnario associ ................................................ 1511 tExtractDelimitedFields ........................................ 1512 Proprits du tExtractDelimitedFields .............. 1512 Scnario : Extraire des champs partir dun fichier dlimit par des virgules ......................................... 1513 tExtractPositionalFields ....................................... 1517 Proprits du tExtractPositionalFields .............. 1517 Scnario associ ................................................ 1518 tExtractRegexFields .............................................. 1519 Proprits du tExtractRegexFields .................... 1519 Scnario : Extraire des noms, des domaines et domaines de premier niveau partir dadresses e-mail ...... 1520 tExtractXMLField ................................................ 1523 tFilterColumns ...................................................... 1524 Proprits du tFilterColumns ............................. 1524 Scnario associ ................................................ 1524 tFilterRow .............................................................. 1525 Proprits du tFilterRow ................................... 1525 Scnario : Filtrer une liste de noms et faire une recherche dans la liste ....................................................... 1526 tJoin ........................................................................ 1530 Proprits du tJoin ............................................. 1530 Scnario : Faire une correspondance exacte entre deux colonnes et crire les donnes rejetes ........... 1531 tMap ....................................................................... 1535 Proprits du tMap ............................................ 1535 Scnario 1 : Mapping simple de donnes avec filtre et jointure explicite .................................................... 1535 Scnario 2 : Mapping de donnes avec rejet Inner join 1540 Scnario 3 : Mapping de jointure en cascade .... 1545 Scnario 4 : Mapping avanc avec filtres, jointures explicites et rejet Inner join ..................................... 1545 Scnario 5 : Mapping avanc avec filtres et diffrents rejets ........................................................................ 1551
Scnario 6 : Mapping avanc avec rechargement de la base de rfrence chaque ligne .............................1556 Scnario 7 : Mapping avec des tables de sortie .1563 tNormalize ..............................................................1567 Proprits du tNormalize ...................................1567 Scnario : Normaliser des donnes ....................1567 tPerl .........................................................................1570 Proprits du tPerl ..............................................1570 Scnario : Afficher le nombre de lignes traites ....... 1570 tPivotToRows .........................................................1573 Proprits du tPivotToRows .............................1573 Scnario : Concatner une liste de colonnes partir dune table en utilisant les autres colonnes comme pivot 1574 tReplace ..................................................................1577 Proprits du tReplace .......................................1577 Scnario : Remplacement mutliple et filtrage de colonnes ........................................................................1578 tSampleRow ...........................................................1582 Proprits du tSampleRow .................................1582 Scnario : Filtrer des lignes et des groupes de lignes 1582 tSortRow .................................................................1585 Proprits du tSortRow ......................................1585 Scnario : Trier des donnes ..............................1586 tXMLMap ...............................................................1589 Proprits du tXMLMap ....................................1589 Scnario : Mapper et transformer des donnes de source XML .............................................................1589
Composants System ...............................1595

tRunJob ..................................................................1596 Proprits du tRunJob ........................................1596 Scnario : Excuter un Job fils ..........................1598 tSetEnv ....................................................................1603 Proprits du tSetEnv .........................................1603 Scnario : Modifier la variable Date lors de lexcution dun Job ...........................................................1603 tSSH ........................................................................1607 Proprits du tSSH .............................................1607 Scnario : Accder aux informations du systme distant via SSH ............................................................1609 tSystem ....................................................................1611 Proprits du tSystem ........................................1611 Scnario : Echo Hello World! .........................1613
Composants Talend MDM ....................1615

tMDMBulkLoad ....................................................1616 Proprits du tMDMBulkLoad ..........................1616 Amliorer les chargements de donnes MDM de xxi
masse ....................................................................... 1617 Scnario : Charger des enregistrements dans une entit mtier ................................................................ 1620 tMDMDelete .......................................................... 1625 Proprits du tMDMDelete ............................... 1625 Scnario : Supprimer des donnes matre dun hub MDM ....................................................................... 1626 tMDMInput ........................................................... 1631 Proprits du tMDMInput ................................. 1631 Scnario : Lire les donnes matre dun hub MDM .. 1632 tMDMOutput ........................................................ 1636 Proprits du tMDMOutput ............................... 1636 Scnario : Ecrire des donnes matre dans un hub MDM ....................................................................... 1639 tMDMReceive ........................................................ 1646 Proprits du tMDMReceive ............................. 1646 Scnario associ ............................................... 1647 tMDMRouteRecord .............................................. 1648 Proprits du tMDMRouteRecord ..................... 1648 Scnario : Router un enregistrement vers lEvent Manager .................................................................. 1649 Prrequis du scnario ..................................... 1649 Router un enregistrement afin de dclencher le processus correspondant ............................................... 1650 tMDMSP ................................................................ 1659 Proprits du tMDMSP .................................... 1659 Scnario : Excuter une procdure stocke dans le hub MDM ................................................................ 1660 tMDMViewSearch ................................................ 1666 Proprits du tMDMViewSearch ..................... 1666 Scnario : Rcuprer des enregistrements dun hub MDM hub via une vue existante ............................. 1668
Composants XML .................................. 1673

tAdvancedFileOutputXML .................................. 1674 Proprits du tAdvancedFileOutputXML ......... 1674
Dfinir un arbre XML ....................................1676 Mapping de donnes XML .............................1678 Dfinir le statut du noeud ...............................1678 Scnario : Crer un fichier XML laide dune boucle 1680 tDTDValidator .......................................................1685 Proprits du tDTDValidator .............................1685 Scnario : Valider un fichier XML ....................1685 tEDIFACTtoXML .................................................1688 Proprits du tEDIFACTtoXML .......................1688 Scnario : Passer dEDIFACT XML ..............1688 tExtractXMLField .................................................1691 Proprits du tExtractXMLField ........................1691 Scnario 1 : Extraire les donnes XML dun champ dune table de base de donnes ...............................1692 Scnario 2 : Extraire les donnes valides et les donnes errones partir dun champ XML dans fichier dlimit ...................................................................1695 tFileInputXML .......................................................1699 Proprits du tFileInputXML .............................1699 Scnario 1 : Extraire des adresses XML ...........1701 Scnario 2 : Extraire les donnes XML errones dans un flux de rejet .........................................................1703 tFileOutputXML ....................................................1707 Proprits de tFileOutputXML ..........................1707 Scnario : Utiliser un format de sortie XML .....1708 tWriteXMLField ....................................................1709 Proprits du tWriteXMLField ..........................1709 Scnario : Extraire la structure dun fichier XML et linsrer dans les champs dune base de donnes ....1710 tXSDValidator .......................................................1715 Proprits du tXSDValidator .............................1715 Scnario : Valider des flux de donnes par rapport un fichier XSD .........................................................1716 tXSLT .....................................................................1719 Proprits du tXSLT ..........................................1719 Scnario : Transformer un fichier XML en HTML laide dune feuille de style XSL .............................1719
xxii
xxiii
xxiv
xxv
xxvi
Prface
Objectif
Ce Guide de rfrence dtaille les principaux composants accessibles partir de chacun des diffrents groupes de la Palette de Talend Open Studio.
Le Guide de rfrence des composants de Talend Open Studio est la version franaise non exhaustive du Components Reference Guide anglais. Pour les composants non documents, rfrez-vous ce dernier. Veillez consulter rgulirement le site Internet de Talend pour tlcharger la dernire version du Guide de rfrence franais.
Les informations contenues dans ce document sappliquent aux versions 4.2.x de Talend Open Studio.
Public vis
Ce guide sadresse aux utilisateurs et aux administrateurs de Talend Open Studio.
Dans ce document, linterface prsente par le biais des captures dcran peut tre lgrement diffrente de la vtre.
Conventions typographiques
Ce guide utilise les conventions typographiques suivantes : texte en gras : boutons et champs dune fentre ou dune bote de dialogue, touches du clavier, menus et options des menus ; texte en [gras]: titre des fentres, assistants et botes de dialogue ; texte en courier : paramtres systme renseigns par lutilisateur ; texte en italique : nom des fichiers, schmas, colonnes, lignes ou variables dont il est question dans les exemples utiliss, ainsi que le nom des champs des vues Basic settings et Advanced settings dont il est fait mention dans le tableau des proprits de chaque composant.
Dans la section de proprits des composants, une icne composant est disponible en Java et/ou en Perl. Licne
ou
indique si le
introduit un paragraphe apportant une information supplmentaire sur un point
important. Elle introduit galement les commentaires relatifs un tableau ou une image. Licne introduit un message apportant une information relative aux modalits
dexcution, ou des recommandations particulires. Elle est galement utilise pour attirer lattention de lutilisateur sur certaines informations ou situations particulirement importantes.
xxvii
Historique des versions

Le tableau ci-dessous liste les modifications apportes au Guide de Rfrence de Talend Open Studio.
Version v4.1_a Date 05/10/2010 Historique Les mises jour du Guide de Rfrence Talend Open Studio comprennent : -De nouveaux composants dans les chapitres File, Databases, Business, Internet et MDM. -Les variables globales ont t ajoutes au chapitre Orchestration. -Des modifications ont t apportes aux proprits et aux scnarios de nombreux composants, afin de correspondre aux changements de linterface. Les mises jour du Guide de Rfrence Talend Open Studio comprennent : -De nouveaux composants dans les chapitres Business Intelligence, Databases, File, FileScale et Internet. -Les composants Palo ont t ajouts au chapitre Business Intelligence. -Les composants Microsoft ont t ajouts au chapitre Internet. -Des modifications ont t apportes aux proprits et aux scnarios de nombreux composants, afin de correspondre aux changements de linterface. Les mises jour du Guide de Rfrence Talend Open Studio comprennent : - Ajout de la famille de composants ESB. - Ajout de composants dans Data Quality, Processing, XML et MDM, comme tStandardizeRow, les composants EDIFACT... - Ajout des informations relatives aux schmas dynamiques dans les chapitres correspondants. - Modifications dans les paramtres et les scnarios de nombreux composants afin de correspondre aux changements de linterface.
v4.1_b
13/12/2010
v4.2_a
28/04/2011
Remarques et Support
Votre opinion nous intresse, nhsitez pas nous faire part de vos remarques, suggestions, requtes concernant la documentation ou le produit, et obtenez le support de notre quipe Talend, sur le Forum Talend (en anglais) disponible ladresse : http://talendforge.org/forum
xxviii
Composants Business
Ce composant passe en revue les principaux composants prsents dans le groupe Business de la Palette de Talend Open Studio. La famille Business regroupe les connecteurs couvrant des besoins scifiques, tels que la lecture et lcriture de base de donnes de type CRM ou ERP et la lecture et lcriture de systme SAP.
Composants Business
tAlfrescoOutput
tAlfrescoOutput
Proprits du tAlfrescoOutput
Famille du composant Business
Fonction
Le composant tAlfrescoOutput permet de crer des documents dmatrialiss sur un serveur Alfresco o ils sont indexs selon des modles significatifs. Ce composant permet de crer et de grer des documents sur un serveur Alfresco. URL Login et Password Base Saisissez lURL pour vous connecter lapplication Web Alfresco. Entrez les donnes didentification de lutilisateur au serveur Alfresco. Saisissez le chemin daccs de lemplacement o stocker le document, ou Cochez la case Map... puis choisissez, partir de la liste droulante Column, lemplacement darrive. Lorsque vous entrez le nom de lemplacement, assurez-vous de le protger par des doubles barres obliques inverses (\\). Document Mode Slectionnez, partir de la liste droulante, le mode que vous voulez utiliser pour crer votre document. Create only : permet de crer un document sil nexiste pas pralablement. Notez cependant quun message derreur apparatra si vous essayez de crer un document qui existe dj. Create or update : permet de crer un document qui nexiste pas encore ou de mettre jour un document existant. Slectionnez, partir de la liste droulante, le mode que vous voulez utiliser pour le dossier de destination sur le serveur Alfresco. Update only : permet de mettre jour un dossier de destination dj existant. Notez cependant quun message derreur apparatra si vous essayez de mettre jour un document qui nexiste pas. Create or update : permet de crer un dossier de destination sil nexiste pas au pralable, ou de mettre jour un dossier existant.
Objectif Basic settings
Container Mode
Composants Business
tAlfrescoOutput
Define Document Type
Cliquez sur les trois points [...] pour afficher lditeur tAlfrescoOutput. Cet diteur vous permet : - de slectionner le fichier dans lequel vous avez dfini les mtadonnes pour servir de cadre lors de lenregistrement du document sur Alfresco - de dfinir le type du document - de slectionner, partir de la liste droulante available aspects, lun des aspects du modle, puis de cliquer sur le bouton [+] pour ajouter cet aspect la liste de gauche. Affiche les paramtres renseigns dans lditeur tAlfrescoOutput, selon lesquels le document sera cr sur le serveur Alfresco. Notez que vous pouvez modifier nimporte lequel des schmas dentre de la zone Property Mapping. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour effectuer des changements sur le schma. Notez que le schma devient automatiquement local (Built-in) lorque vous effectuez des changements.
Property Mapping
Schema et Edit schema
Result Log File Name Permet de parcourir le fichier dans lequel vous voulez enregistrer les logs lis lexcution du Job. Advanced settings Configure Target Location Container Permet de configurer le type par dfaut des conteneurs. Cochez cette case pour afficher de nouveaux champs dans lesquels vous pouvez modifier le type du conteneur et utiliser les types que vous avez crs sur le modle pre/fils. Lorsque cette case est coche, loption permet de configurer manuellement les droits daccs aux conteneurs et aux documents. Cochez la case Inherit Permissions pour synchroniser les droits daccs entre les conteneurs et les documents. Cliquez sur le bouton [+] pour ajouter de nouvelles lignes la liste Permissions ; vous pourrez alors assigner des rles un utilisateur ou groupe dutilisateurs dans les colonnes User or group et User or group column. Slectionnez le type dencodage partir de la liste ou choisissez loption Custom pour le dfinir manuellement. Ce champ doit obligatoirement tre renseign.
Configure Permissions
Encoding
Composants Business
tAlfrescoOutput
Association Target Mapping
Permet de crer de nouveaux documents sur Alfresco qui contiennent des liens associs des documents dj existants sur ce serveur, pour faciliter le processus de navigation par exemple. Pour crer des associations : -Ouvrez lditeur tAlfresco. -Cliquez sur le bouton Add puis slectionnez un modle pour lequel vous avez dj dfini des aspects contenant des associations. -Cliquez sur la liste droulante, en haut de la fentre de lditeur, et slectionnez le type de document correpondant. -Cliquez sur OK pour fermer lditeur et afficher lassociation ainsi cre dans la liste Association Target Mapping.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation/Conditions pralables Ce composant est gnralement utilis en tant que composant de sortie et requiert un composant de dbut. Pour pouvoir utiliser le composant tAlfrescoOutput, il est ncessaire dinstaller certaines ressources utiles. Pour plus dinformations, consultez la sous-section Procdure dinstallation.
Procdure dinstallation
Pour pouvoir utiliser le composant tAlfrescoOutput dans Talend Open Studio, vous devez tout dabord installer le serveur Alfresco ainsi que quelques ressources utiles. Les sous-sections ci-aprs indiquent en dtail les conditions pralables ncessaires, ainsi que la procdure dinstallation. Conditions pralables Commencez par excuter les oprations suivantes : Tlchargez le fichier alfresco-community-tomcat-2.1.0.zip Dzippez-le dans un dossier dinstallation, par exemple : C:\Program Files\Java\jdk1.50_16 Installez JDK 1.5.0+ Effectuez une mise jour de la variable JAVA_HOME (JAVA_HOME= C:\alfresco) A partir du dossier dinstallation (C:\alfresco), lancez le serveur Alfresco en utilisant le script alf_start.bat
Assurez-vous que le serveur Alfresco est bien lanc avant dutiliser le composant tAlfrescoOutput.
Installation du module Talend Alfresco Notez que le fichier talendalfresco_20081014.zip est propos avec le composant tAlfrescoOutput dans Talend Open Studio.
Composants Business
tAlfrescoOutput
Pour installer le module Talend Alfresco : A partir du fichier talendalfresco_20081014.zip, dans le dossier talendalfresco_20081014\alfresco, recherchez les fichiers JAR suivants : stax-api-1.0.1.jar, wstx-lgpl-3.2.7.jar, talendalfresco-client_1.0.jar et talendalfresco-alfresco_1.0.jar, puis dplacez-les vers C:\alfredsco\tomcat\webapps\alfresco\WEB-INF\lib Ajoutez le filtre didentification des commandes au fichier web.xml situ au chemin daccs C:\alfredsco\tomcat\webapps\alfresco\WEB-INF son WEB-INF/, daprs le modle de lexemple situ dans le dossier talendalfresco_20081014/alfresco du fichier zipp talendalfresco_20081014.zip Les captures dcran ci-dessous montrent la partie ajouter (lignes en bleu) au fichier web.xml alfresco.
Composants Business
tAlfrescoOutput
Informations utiles pour une utilisation avance du composant Installer de nouveaux types pour Alfresco : A partir du fichier package_jeu_test.zip , dans le dossier package_jeu_test/fichiers_conf_alfresco2.1, recherchez les fichiers suivants : xml H76ModelCustom.xml (description du modle), web-client-config-custom.xml (interface Web du modle) et custom-model-context.xml (enregistrement du nouveau modle), puis collez-les dans le dossier suivant : C:/alfredsco/tomcat/shared/classes/alfresco/extension Dates : Les dates doivent correspondre au type Talend, java.util.Date Les colonnes qui ne comportent ni mapping, ni valeur par dfaut (celles du type Date par exemple) se voient attribuer une chane de caractres vide. Solution : effacez toutes les colonnes sans mapping ni valeur par dfaut. Notez cependant quune modification de type Alfresco les rtablira. Contenu : Ne confondez pas le chemin daccs au fichier dont vous voulez crer le contenu et celui de son emplacement cible sur Alfresco. Noubliez pas lURL ! Elle permet de cibler de nombreux protocoles, dont le transfert de fichiers et le HTTP. Prcdez les URLs renvoyant des fichiers du systme de fichiers en rseau de "file:", si vous utilisez Windows en local, ou de "file://", si vous utilisez soit Windows sur un rseau (qui accepte galement la mention "file: \ \"), soit Linux. Nutilisez jamais la double barre oblique inverse (\\) dans le chemin daccs cible (chappement automatique), moins que vous nentriez le chemin directement dans les proprits de base (Basic settings) du composant tAlfrescoOutput ou que vous neffectuiez une concatnation, dans lditeur tMap par exemple.
Composants Business
tAlfrescoOutput
Proprits multiples ou associations : Il est possible de nen crer quune seule par document en y mappant une valeur String, ou une ou plusieurs en y mappant une valeur List(objet). Il est possible de vider une proprit multiple en lui mappant une liste vide que vous pouvez crer, par exemple, en utilisant la commande new java.util.ArrayList()dans le composant tMap. En revanche, il est impossible de supprimer une association. Faire des List(object)avec le composant tAggregate : -dfinissez dans un fichier une table de relation n-n, contenant par exemple une ligne name (pouvant tre retrouve dans les imput rows) et une ligne category (pouvant tre dfinie avec son mapping dans un fichier tiers). -group by : input name, output name. -opration: output categoryList, fonction list(object), input category. ATTENTION il sagit dune list (object) et non dune simple list ! Rfrences (documents et dossiers) : Les rfrences sont cres par mapping dune ou plusieurs rfrences de noeud existantes (xpath ou namepath), en type String ou List(object). Une erreur dans lassociation ou la proprit de type rfrence nempche pas la cration du noeud qui la porte. Les proprits de type rfrence sont cres dans longlet des proprits standards (Basic Settings). Les associations sont cres dans longlet des proprits avances (Advanced Settings).
Dmatrialisation, tAlfrescoOutput et Gestion de Contenu

La dmatrialisation est le processus qui sert convertir les documents concrets au format numrique, permettant ainsi de passer dune utilisation de documentation physique des systmes de Gestion de Contenu lectroniques. Un systme de Gestion de Contenu permet de grer un large ventail de documents, allant des plus basiques aux certificats dactions par exemple. Les entreprises procdent la dmatrialisation de leur contenu par traitement des documents, qui peut tre ralis soit la main, soit de manire automatique grce une machine Compte tenu de la diversit des contenus dmatrialiser, les entreprises sont obliges dutiliser des technologies diverses. Scanner les documents papier, crer des interfaces pour capter les documents lectroniques dautres applications, convertir les documents images en documents textes lisibles et modifiables par une machine... Ceci nest quun exemple des technologies employes. De plus, les documents scanns ainsi que les fax numriques ne peuvent tre lus par des machines. Diffrentes technologies de reconnaissance des caractres sont utilises pour les convertir en donnes utilisables. La Reconnaissance de Caractres Manuscrits (RCM) et la Reconnaissance Optique de Marques (ROM) en sont deux exemples.
Composants Business
tAlfrescoOutput
Les mtadonnes de support, qui permettent didentifier le contenu de manire efficace grce des requtes spcifiques, sont au moins aussi importantes que le contenu capt lors de la dmatrialisation, en diffrents formats et partir de nombreuses sources. Ds lors, comment agrger et indexer dans un systme de Gestion de Contenu le contenu dun document en mme temps que ses mtadonnes associes, pour quil puisse tre extrait et trait de manire significative ? Talend vous apporte la rponse par le biais de son composant tAlfrescoOutput. Le composant tAlfrescoOutput vous permet de stocker et de grer vos documents lectroniques, ainsi que les mtadonnes qui y sont associes, sur le serveur Alfresco, systme leader sur le march de la Gestion de Contenu. La figure ci-dessous illustre le rle de Talend la fois dans le processus de dmatrialisation et dans le systme Gestion de Contenu (Alfresco).
Scnario : Crer des documents sur un serveur Alfresco

Ce scnario Java dcrit un Job deux composants permettant de crer deux fichiers de documents et leurs mtadonnes associes sur un serveur Alfresco, le systme de Gestion de Contenu en Java. A partir de la Palette, cliquez-dposez les composants tFileInputDelimited et tAlfrescoOutput sur lditeur graphique. Reliez ces deux composant laide dun lien Row Main.
Composants Business
tAlfrescoOutput
Dans lditeur graphique, double-cliquez sur le tFileInputDelimited pour en afficher les paramtres de base (Basic settings). Renseignez le chemin daccs au fichier dans le champ File Name ainsi que toutes les autres proprits. Notez cependant que si vous avez dj stock vos schmas dentre en local dans le Repository, vous pouvez tout simplement rcuprer le fichier choisi partir du noeud Metadata et le dposer sur lditeur graphique. Les paramtres du fichier dlimit safficheront alors automatiquement dans les champs concerns de longlet Basic settings du composant concern. Pour plus dinformations sur les mtadonnes, consultez la section Configurer un schma File Delimited du Guide Utilisateur de Talend Open Studio.
Dans ce scnario, le fichier dlimit prsente les mtadonnes et le chemin daccs de deux documents que vous allez crer sur le serveur Alfresco. Le schma dentre des documents de dcompose en quatre colonnes : file_name, destination_folder name, source_path, et author.
Le schma dentre du fichier dlimit sera donc comme suit :
Composants Business
tAlfrescoOutput
Dans lditeur graphique, double-cliquez sur le composant tAlfrescoOutput pour en afficher les paramtres de base (Basic settings).
Dans la partie Alfresco Server, saisissez lURL du serveur Alfresco ainsi que les donnes didentification de lutilisateur dans les champs correspondants. Dans la partie TargetLocation, vous pouvez soit saisir le nom de lemplacement du serveur o vous voulez stocker le document, soit cocher la case Map... puis choisir lemplacement cible partir de la liste droulante Column, soit destination_folder_name dans ce scnario.
10 Composants Talend Open Studio
Composants Business
tAlfrescoOutput
Lorsque vous renseignez le nom de lemplacement, assurez vous de bien utiliser le caractre dchappement double barre oblique inverse (\\).
Dans la liste droulante Document Mode, slectionnez le mode que vous voulez utiliser pour la cration de vos documents. Dans la liste droulante Container Mode, slectionnez le mode que vous voulez utiliser pour le dossier de destination sur Alfresco. Cliquez sur le bouton [...] de loption Define Document Type pour ouvrir lditeur tAlfrescoOutput.
11
Composants Business
tAlfrescoOutput
Cliquez sur le bouton Add pour parcourir et slectionner le fichier xml qui comprend les mtadonnes selon lesquelles vous voulez sauvegarder les documents sur Alfresco. Tous les aspects disponibles du modle slectionn saffichent dans la liste Available Aspects.
Vous pouvez parcourir le dossier modle en local ou en rseau. Une fois dfinis les aspects appliquer au document que vous allez crer sur Alfresco, vous naurez plus besoin de ce dossier.
Si ncessaire, slectionnez le ou les aspect(s) ajouter aux mtadonnes crire sur le serveur Alfresco, partir de la liste droulante Available Aspects. Dans ce scnario, lobjectif est de faire en sorte que le nom de lauteur fasse partie des mtadonnes enregistres sur Alfresco. Cliquez sur la liste droulante, situe en haut de la fentre de lditeur, pour slectionner le type donner aux documents crs sur Alfresco. Dans cet exemple, il sagit de Content. Tous les aspects dfinis, utiliss pour slectionner les mtadonnes crire sur Alfresco, saffichent dans la liste Property Mapping de longlet Basic Settings du composant tAlfrescoOutput. Dans ce scnario, il sagit de trois aspects, deux aspects de base pour le type Content (content et name) ainsi quun aspect aditionnel (author). Cliquez sur Sync columns pour propager automatiquement toutes les colonnes du fichier dlimit. Si ncessaire, cliquez sur Edit schema pour avoir un aperu de la structure des donnes du tAlfrescoOutput en sortie.
Cliquez sur le bouton [...] situ ct du champ Result Log File Name puis parcourez le fichier o vous voulez sauvegarder les logs aprs excution du Job. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
12
Composants Business
tAlfrescoOutput
Les deux documents sont crs sur Alfresco grce aux mtadonnes des schmas dentre.
13
Composants Business
tBonitaDeploy
tBonitaDeploy
Proprits du tBonitaDeploy
Famille de composant Business/Bonita
Fonction
Le tBonitaDeploy configure un moteur Bonita Runtime et dploie un processus spcifique Bonita (un fichier .bar export de la solution Bonita solution) vers ce moteur. Ce composant dploie un processus spcifique Bonita vers Bonita Runtime. Bonita Runtime Environment File Bonita Runtime Jass File Bonita Runtime logging file Business Archive Parcourez votre rpertoire, ou saisissez le chemin daccs au fichier denvironnement Bonita Runtime. Parcourez votre rpertoire, ou saisissez le chemin daccs au fichier jass Bonita Runtime. Parcourez votre rpertoire, ou saisissez le chemin daccs au fichier de log Bonita Runtime. Parcourez votre rpertoire, ou saisissez le chemin daccs au fichier .bar Bonita de traitement que vous souhaitez utiliser. Saisissez votre identifiant de connexion Bonita. Saisissez votre mot de passe de connexion Bonita. Cette case nest pas coche par dfaut, pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur.
User name Password Die on error
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement du Job au niveau du Job ainsi quau niveau de chaque composant. Ce composant est gnralement utilis en standalone. Liens de sortie (dun composant un autre) : Trigger : Run if, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError. Liens dentre (dun composant un autre) : Trigger : Run if, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Utilisation Connections
Global Variables
Process Definition UUID : Indique le numro dID du processus dploy. Disponible en tant que variable Flow. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
14
Composants Business
tBonitaDeploy
Limitation
Le fichier denvironnement Bonita Runtime, le fichier jaas Bonita Runtime et le fichier de log Bonita Runtime doivent tre stocks sur le serveur dexcution du Job, laide de ce composant.
Scnario associ
Aucun scnario nest disponible pour ce composant.
15
Composants Business
tBonitaInstantiateProcess
tBonitaInstantiateProcess Properties
Famille de composant Business/Bonita
Fonction Objectif Basic settings
Le composant tBonitaInstantiateProcess instancie un processus existant dans un moteur Bonita Runtime puis lance lexcution. Ce composant commence linstance dun processus spcifique dploy dans le moteur Bonita Runtime. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn. Parcourez votre rpertoire, ou saisissez le chemin daccs au fichier denvironnement Bonita Runtime. Parcourez votre rpertoire, ou saisissez le chemin daccs au fichier jass Bonita Runtime. Parcourez votre rpertoire, ou saisissez le chemin daccs au fichier de log Bonita Runtime. Cette case nest pas coche par dfaut, pour activer les champs process name (nom du processsus)et process version (version du processus), afin que vous puissiez saisir les informations correspondantes du processus spcifique que vous souhaitez instancier. Ces informations seront utimlises pour gnrer automatiquement lID du processus. Une fois la case coche, le champ Process definition ID est activ, et vous pouvez saisir lID requis du processus. LID du processus est cr lorsque ce processus est dploy dans le moteur Bonita Runtime. Saisissez lidentifiant utilis pour instancier ce processus.. Saisissez le mot de passe utilis pour instancier ce processus. Cette case nest pas coche par dfaut, pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur.
Bonita Runtime Environment File Bonita Runtime Jass File Bonita Runtime logging file Use Process ID
User name Password Die on error
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement du Job au niveau du Job ainsi quau niveau de chaque composant.
16
Composants Business
Ce composant est gnralement utilis en standalone ou en tant que composant de sortie. Liens de sortie (dun composant un autre) : Trigger : Run if, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError. Liens dentre (dun composant un autre) : Row : Main. Trigger : Run if, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Global Variables
Process Definition UUID : Indique le numro dID du processus dploy. Disponible en tant que variable Flow. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Scnario : Excuter un processus Bonita via un Job Talend

Ce scnario dcrit un Job dployant un processus Bonita dans le moteur Bonita Runtime et excutant ce processus, dans lequel une requte sur le personnel est traite. Ce Job utilise trois composants.
Un tBonitaDeploy : ce composant dploie un processus Bonita dans le moteur Bonita Runtime. Un tFixedFlowInput : ce composant gnre le schma utilis comme paramtre dexcution du processus dploy.
17
Composants Business
Un tBonitaInstantiateProcess : ce composant excute le processus dploy.

Lorsque vous gnrez un schma laide dun tFixedFlowInput, les noms de colonnes du schma doivent tre identiques ceux des paramtres Bonita utiliss pour excuter le mme processus dans Bonita.
Avant de commencer reproduire ce schma, prparez votre fichier Bonita .bar, cest--dire le processus export du systme Bonita et qui sera dploy dans le moteur Bonita Runtime. Dans ce scnario, ce fichier est TEST--4.0.bar. Ce processus peut tre vrifi via linterface Bonita.
Pour reproduire ce scnario, procdez comme suit : Dposez les composants tBonitaDeploy, tFixedFlowInput et tBonitaInstantiateProcess de la Palette dans lespace de modlisation graphique. Cliquez-droit sur le composant tBonitaDeploy pour ouvrir son menu contextuel. Slectionnez Trigger > On Subjob Ok pour relier le tBonitaDeploy au tFixedFlowInput. Cliquez-droit sur le tFixedFlowInput pour ouvrir son menu contextuel et slectionnez Row > Main pour relier ce composant au tBonitaInstantiateProcess, laide dun lien Main. Double-cliquez sur le tBonitaDeploy afin douvrir sa vue Basic settings.
18
Composants Business
Dans la zone Bonita Runtime Configuration, parcourez votre rpertoire de fichiers de variables Bonita Runtime. Dans le champ Bonita Runtime Environment file, parcourez votre rpertoire jusquau fichier bonita-environnement.xml. Dans le champ Bonita Runtime Jaas File, parcourez votre rpertoire jusquau fichier jaas-standard.cfg. Dans le champ Bonita Runtime Logging File, parcourez votre rpertoire jusquau fichier logging.properties. Dans le champ Business Archive, parcourez votre rpertoire jusquau fichier Bonita .bar, qui est le processus export de votre systme Bonita et sera dploy dans le moteur Bonita Runtime. Dans les champs Username et Password, saisissez vos informations de connexion Bonita. Double-cliquez sur le composant tFixedFlowInput afin douvrir sa vue Basic settings.
Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir lditeur du schma.
Dans lditeur du schma, cliquez sur le bouton [+] pour ajouter une ligne.
19
Composants Business
Cliquez sur la nouvelle ligne et saisissez son nom : name. Cliquez sur OK. Dans la zone Mode de la vue Basic settings, slectionnez loption Use inline table. Sous le tableau, cliquez sur le bouton [+] afin dajouter une ligne. Dans le tableau, cliquez sur la ligne ajoute et saisissez entre guillemets le nom de la personne de votre personnel : ychen, dont la requte sera traite par le processus dploy. Double-cliquez sur le tBonitaInstantiateProcess afin douvrir sa vue Basic settings.
Dans la vue Basic settings, cliquez sur le bouton Sync columns afin de rcuprer le schma du composant prcdent. Dans la zone Bonita Runtime Configuration, parcourez votre rpertoire de fichiers de variables Bonita Runtime. Dans le champ Bonita Runtime Environment file, parcourez votre rpertoire jusquau fichier bonita-environnement.xml. Dans le champ Bonita Runtime Jaas File, parcourez votre rpertoire jusquau fichier jaas-standard.cfg. Dans le champ Bonita Runtime Logging File, parcourez votre rpertoire jusquau fichier logging.properties. Cochez la case Use Process ID pour activer le champ Process Definition Id. Dans le champ Process Definition Id, cliquez entre les guillemets et appuyez sur Ctrl+Espace afin douvrir la liste dautocompltion contenant les variables globales disponibles pour ce Job. Double-cliquez sur la variable que vous souhaitez utiliser pour lajouter entre les guillemets. Dans ce scnario, double-cliquez sur tBonitaDeploy_1_ProcessDefinitionUUID, qui rcupre lID de dfinition du processus dploy par le composant tBonitaDeploy.
Si le processus a t dploy et que le tBonitaDeploy nest pas utilis, dcochez la case Use Process ID afin dactiver les champs Process name et Process version et remplir les informations correspondantes. Le tBonitaInstantiateProcess concatne le nom et la version du processus que vous avez saisis lors de la construction de lID du processus.
20
Composants Business
Dans les champs Username et Password, saisissez respectivement votre identifiant et votre mot de passe de connexion Bonita. Appuyez sur F6 pour excuter le Job.
Le processus est dploy dans le moteur Bonita Runtime et une instance est cre pour les requtes concernant le personnel.
21
Composants Business
tCentricCRMInput
tCentricCRMInput
Proprits du tCentricCRMInput
Famille du composant Business/CentricCR M Le composant tCentricCRMInput se connecte un module de la base de donnes CentricCRM via le service Web adquat. Le tCentricCRMInput permet dextraire les donnes dune base de donnes Centric CRM laide dune requte. CentricCRM URL Module Server UserID et Password Schema et Edit Schema Saisissez lURL du service Web permettant de se connecter la base de donnes CentricCRM. Slectionnez le module adquat dans la liste. Saisissez ladresse IP du serveur de base de donnes. Saisissez les informations dauthentification de lutilisateur au service Web. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn. Saisissez la requte permettant de slectionner les donnes extraire.
Query condition Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement du Job au niveau du Job ainsi quau niveau de chaque composant. Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est ncessaire. n/a
Utilisation Limitation
Scnario associ
22
Composants Business
tCentricCRMOutput
tCentricCRMOutput
Proprits du tCentricCRMOutput
Famille du composant Business/CentricCR M Le composant tCentricCRMOutput crit dans un module de la base de donnes CentricCRM via le service Web adquat. Le tCentricCRMOutput permet dcrire des donnes dans une base de donnes CentricCRM. CentricCRM URL Module Server UserID et Password Action Saisissez lURL du service Web permettant de se connecter la base de donnes CentricCRM. Slectionnez le module adquat dans la liste. Saisissez ladresse IP du serveur de base de donnes. Saisissez les informations dauthentification de lutilisateur au service Web. Vous pouvez effectuer lune des oprations suivantes sur les donnes du module CentricCRM : Insert : insrer les donnes. Update : mettre les donnes jour. Delete : supprimer les donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn.
Schema et Edit Schema
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de traitement du Job au niveau du Job ainsi quau niveau de chaque composant. Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a
Scnario associ
23
Composants Business
tHL7Input
tHL7Input
Proprits du tHL7Input
Famille de composant Business
Fonction Objectif
Lit un fichier de structure HL7 et extrait des donnes ligne par ligne. Ce composant lit un fichier HL7 structur ou un flux de donnes ligne par ligne pour le scinder en champs et envoie les champs tels que dfinis dans le schma au composant suivant du Job via une connexion Row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant connexion de base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Multi Schemas Editor Lditeur [Multi Schema Editor] vous permet de construire et de configurer le flux de donnes dans un fichier dlimit multi-structure, pour associer un schma par sortie. Segment Lists Connection : Les colonnes sont automatiquement rcupres partir du fichier dentre. Le nom de la colonne est le nom du segment. Column Mapping :. Dans ce tableau, le mapping est rcupr de celui que vous avez dfini dans lditeur. Cochez cette case si vous ne souhaitez pas valider les messgaes HL7. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Slectionnez le type dencodage partir de la liste ou choisissez loption Custom pour le dfinir manuellement. Ce champ doit obligatoirement tre renseign.
Basic settings
Not Validate HL7 Message Advanced settings Advanced separator (for numbers)
Encoding
24
Composants Business
tHL7Input
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Gnralement utilis en tant que composant dentre. Un composant de sortie est requis. n/a
Scnario : Retrouver des informations concernant les patients et les vnements partir dun fichier HL7
Ce scnario dcrit un Job de quatre composants, dont le but est de retrouver des informations concernant des patients et des vnements partir dun fichier HL7.
A partir de la Palette, glissez-dposez un composant tHL7Input, et trois tLogRow dans lespace de modlisation graphique. Double-cliquez sur le composant tHL7Input afin douvrir son diteur.
25
Composants Business
tHL7Input
Dans le champ File path, cliquez sur [Browse...], parcourez votre rpertoire, et slectionnez votre fichier HL7. Dans la zone File Setting, saisissez le caractre de dbut de votre segment (Start character), et le caractre de fin de votre segment (End character). Dans la zone Schema View, dans la liste Segment(As Schema), slectionnez MSH. Glissez-dposez les segments MSH-3(1)[HD] et MSH-7(1)[TS] de la zone Message View dans la zone Schema View.
Dans la zone Schema View, dans la liste Segment(As Schema), slectionnez EVN. Glissez dposez les segments EVN-1(1)-1-1[ID] et EVN-2(1)-1-1[ST] de la zone Message View dans la zone Schema View.
26
Composants Business
tHL7Input
Dans la zone Schema View, dans la liste Segment(As Schema), slectionnez PID. Glissez-dposez les segments suivants de la zone Message View dans la zone Schema View : PID-1(1)-1-1[SI], PID-5(1)-1-1[ST], PID-5(1)-2-1[ST], PID-5(1)-3-1[ST], PID-5(1)-4-1[ST], PID-5(1)-5-1[ST], PID-5(1)-7-1[ID].
Sil est disponible, utilisez le bouton Auto map! situ en bas gauche de la fentre, il permet deffectuer lopration de mapping automatiquement.
Cliquez sur Ok afin de fermer lditeur. Reliez le tHL7Input aux trois tLogRow, en utilisant respectivement les liens MSH, EVN et PID. Sauvegardez votre Job, et appuyez sur F6 pour lexcuter.
27
Composants Business
tHL7Input
La console affiche les trois tables des tLogRow, qui retournent diffrents types dinformations. La premire montre len-tte du message et sa date. La seconde retourne les informations concernant le patient. La troisime affiche lID de lvnement ainsi que sa date.
28
Composants Business
tHL7Output
tHL7Output
Proprits du tHL7Output
Ecrit un fichier de structure HL7 et insre des donnes ligne par ligne. Ce composant crit un fichier HL7 structur selon la norme HL7. Property type Peut tre Built-In ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Schema(s) Schema : Dfinissez le noeud o stocker les donnes de la ligne parente. Parent row : Flux de donnes source. Parcourez le rpertoire o stocker les fichiers gnrs. Ouvre linterface ddie pour vous aider mettre en place le mapping HL7. Slectionnez dans la liste votre version de HL7. Cette case est coche par dfaut. Cette option permet de crer le dossier contenant le fichier de sortie sil nexiste pas dj. Slectionnez le type dencodage partir de la liste ou choisissez loption Custom pour le dfinir manuellement. Ce champ doit obligatoirement tre renseign.
File Name/Output Stream Configure HL7 Tree HL7 version Advanced settings Create directory only if not exists Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Gnralement utilis en tant que composant de sortie. Un composant dentre est requis. n/a
Scnario associ
Pour un scnario utilisant un autre composant HL7, consultez Scnario : Retrouver des informations concernant les patients et les vnements partir dun fichier HL7, page 25.
29
Composants Business
tMarketoInput
tMarketoInput
Proprits du tMarketoInput
Le composant tMarketoIntput rcupre des donnes partir dun serveur Web Marketo. Ce composant vous permet de rcuprer des donnes partir dune base de donnes Marketo sur un serveur Web. Endpoint address Secret key URL du service Web Marketo appel par lAPI ou les APIs SOAP. Saisissez le code dauthentification crypt fourni par Marketo. Pour obtenir cette information, veuillez contacter le support Marketo via support@marketo.com . Client Access ID Saisissez lidentifiant utilisateur permettant daccder au service Web Marketo. Pour obtenir cette information, veuillez contacter le support Marketo via support@marketo.com . Operation Les options de cette liste vous permettent de synchroniser les donnes des prospects entre Marketo et un systme externe. getLead : Cette option rcupre les informations des prospects et de leur activit dans la base de donnes Marketo. getMultipleLeads : Cette opration rcupre les enregistrements des prospects dans des lots. getLeadActivities : Cette opration rcupre lhistorique des enregistrements dactivit pour un prospect unique identifi par la cl fournie. getLeadChanges : Cette opration vrifie les changements des donnes de prospects dans la base de donnes Marketo. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Built-in : Proprits utilises ponctuellement.
30
Composants Business
tMarketoInput
Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Columns Mapping Vous pouvez configurer les conditions de mapping en modifiant le schma dans Edit Schema. Par dfaut, les noms des colonnes des champs contenus dans Column sont les mmes que ceux du schma. Puisque certains noms de colonnes de la base de donnes Marketo contiennent des blancs non accepts par le schma du composant, vous devez spcifier les champs de colonnes correspondants dans le champ Columns in Marketo. Si les noms de colonnes dfinis dans le schma sont les mmes que ceux de la base de donnes Marketo, comme par exemple "Email", alors il nest pas ncessaire de configurer les conditions de mapping. LeadKey type LeadKey value Set Include Types Types de donnes de LeadKey supports par la base de donnes Marketo. Valeur de LeadKey. Cochez cette case pour inclure les types de contenu de lactivit des prospects (LeadActivity) rcuprer. Cliquez sur le bouton [+] sous la zone Include Types pour ajouter des types en les slectionnant dans la liste. Cette case est disponible uniquement si vous avez slectionn getLeadActivity ou getLeadChanges dans la liste Operation. Set Exclude Types Cochez cette case pour exclure les types de contenu de lactivit des prospects (LeadActivity) rcuprer. Cliquez sur le bouton [+] sous la zone Exclude Types pour ajouter des types en les slectionnant dans la liste. Cette case est disponible uniquement si vous avez slectionn getLeadActivity ou getLeadChanges dans la liste Operation. Last Updated At Saisissez la date de la dernire mise jour afin de ne rcuprer que les donnes datant de la priode spcifie. Le format de date est YYYY-MM-DD HH:MM:SS. Ce champ est disponible uniquement si vous avez slectionn getMultipleLeads dans la liste Operation. Batch Size Limite maximale du nombre des donnes de prospects rcuprer par lot. Ce champ est disponible uniquement si vous avez slectionn lopration syncMultipleLeads. Composants Talend Open Studio 31
Composants Business
tMarketoInput
Timeout (milliseconds)
Saisissez en millisecondes le dlai avant suspension de la requte sur le service Web Marketo. Le Job sarrte lorsque lerreur Timeout exception survient.
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Au besoin, vous pouvez rcuprer les lignes en erreur via un lien Row > Reject.
Advanced settings Utilisation Limitation
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis en tant que composant de dentre. Un composant de sortie est ncessaire. n/a
Scnario associ
Pour un scnario associ, consultez le Scnario : Insrer et rcuprer des donnes dune base de donnes Marketo via un systme externe, page 35.
32
Composants Business
tMarketoOutput
tMarketoOutput
Proprits du tMarketoOutput
Le composant tMarketoOutput envoie des donnes vers un serveur Web Marketo. Ce composant vous permet dcrire des donnes dans une base de donnes Marketo sur un serveur Web. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Endpoint address Secret key URL du service Web Marketo appel par lAPI ou les APIs SOAP. Saisissez le code dauthentification crypt fourni par Marketo. Pour obtenir cette information, veuillez contacter le support Marketo via support@marketo.com . Client Access ID Saisissez lidentifiant utilisateur permettant daccder au service Web Marketo. Pour obtenir cette information, veuillez contacter le support Marketo via support@marketo.com . Operation Les options de cette liste vous permettent de synchroniser les donnes des prospects entre Marketo et un systme externe. syncLead : Cette option sollicite une opration dinsertion ou de mise jour pour un enregistrement de prospect. syncMultipleLeads : Cette option sollicite une opration dinsertion ou de mise jour pour plusieurs enregistrements de prospects regroups par lots.
33
Composants Business
tMarketoOutput
Columns Mapping
Vous pouvez configurer les conditions de mapping en modifiant le schma dans Edit Schema. Par dfaut, les noms des colonnes des champs contenus dans Column sont les mmes que ceux du schma. Puisque certains noms de colonnes de la base de donnes Marketo contiennent des blancs non accepts par le schma du composant, vous devez spcifier les champs de colonnes correspondants dans le champ Columns in Marketo. Si les noms de colonnes dfinis dans le schma sont les mmes que ceux de la base de donnes Marketo, comme par exemple "Email", alors il nest pas ncessaire de configurer les conditions de mapping.
De-duplicate lead record on email address
Cochez cette case afin de ddoublonner et de mettre jour les enregistrements des prospects en utilisant ladresse e-mail. Dcochez cette case si vous souhaitez crer un autre enregistrement de prospect contenant la mme adresse e-mail. Cette case est disponible uniquement si vous avez slectionn syncMultipleLeads dans la liste Operation.
Batch Size
Limite maximale du nombre denregistrements par lot synchroniser avec les donnes de prospects. Ce champ est disponible uniquement si vous avez slectionn syncMultipleLeads dans la liste Operation.
Timeout (milliseconds)
Saisissez en millisecondes le dlai avant suspension de la requte sur le service Web Marketo. Le Job sarrte lorsque lerreur Timeout exception survient.
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Au besoin, vous pouvez rcuprer les lignes en erreur via un lien Row > Reject.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis en tant que composant de sortie. Un composant dentre est ncessaire. n/a
34
Composants Business
tMarketoOutput
Scnario : Insrer et rcuprer des donnes dune base de donnes Marketo via un systme externe
Le scnario suivant dcrit un Job cinq composants qui a pour but dinsrer des enregistrements de prospects dans une base de donnes Marketo et dcrire ces enregistrements dans un fichier local. Au terme de ce processus, le nombre dappels dAPI est affich dans la console de la vue Run.
A partir de la Palette, dposez les composants tMarketoOutput, tMarketoInput, tFileInputDelimited, tFileOutputDelimited et tJava dans lespace de modlisation graphique. Connectez le composant tFileInputDelimited au tMarketoOutput laide dun lien Row > Main. Connectez le composant tMarketoInput au tFileOutputDelimited laide dun lien Row > Main. Connectez le composant tFileInputDelimited au tMarketoInput laide dun lien Trigger > OnSubjectOk. Connectez le composant tMarketoInput au tJava laide dun lien Trigger > OnSubjectOk. Double-cliquez sur le composant tFileInputDelimited pour afficher longlet Basic settings de sa vue Component et dfinir ses proprits.
35
Composants Business
tMarketoOutput
Cliquez sur le bouton [...] ct du champ File name/Stream et slectionnez un fichier local pour linsertion de donnes. Pour ce scnario, il sagit de D:/SendData.csv. Cliquez sur le bouton [...] ct du champ Edit schema pour configurer le schma manuellement.
Cliquez sur le bouton [+] pour ajouter quatre colonnes : Id, Email, ForeignSysPersonId et ForeignSysType. Configurez le Type de Id Integer et laissez les autres colonnes telles quelles sont. Cliquez ensuite sur OK pour enregistrer les paramtres. Dans le champ Header, saisissez 1 et laissez les autres paramtres tels quils sont. Double-cliquez sur le composant tMarketoOutput pour afficher longlet Basic settings de sa vue Component et dfinir ses proprits.
36
Composants Business
tMarketoOutput
Cliquez sur le bouton Sync columns pour rcuprer le schma dfini dans le composant tFileInputDelimited. Renseignez le champ Endpoint address avec ladresse URL du serveur Web Marketo. Pour ce scnario, saisissez https://na-c.marketo.com/soap/demo/demo1. Notez que lURL utilise dans ce scnario est essentiellement destine la dmonstration. Renseignez le champ Secret key avec le code dauthentification crypt fourni par Marketo. Pour ce scnario, saisissez 1234567894DEMOONLY987654321. Renseignez le champ Client Access ID avec lidentifiant utilisateur. Pour ce scnario, saisissez mktodemo1_1234567894DEMOONLY987654321. A partir de la liste Operation, slectionnez syncMultipleLeads. Saisissez le dlai (en millisecondes) avant suspension de la requte dans le champ Timeout (milliseconds). Pour ce scnario, utilisez la valeur par dfaut : 600000. Double-cliquez sur le composant tMarketoInput afin dafficher longlet Basic settings de sa vue Component et dfinir ses proprits.
37
Composants Business
tMarketoOutput
Dans la liste Operation, slectionnez getLead. Dans le tableau Columns Mapping, saisissez test@talend.com dans la colonne Columns in Marketo correspondant la colonne Email. Notez que les donnes utilises dans ce scnario sont essentiellement destines la dmonstration. Dans la liste LeadKey type, slectionnez EMAIL et saisissez test@talend.com dans le champ LeadKey value. Laissez les autres paramtres tels quils sont dans le composant tMarketoOutput. Double-cliquez sur le composant tFileOutputDelimited pour afficher longlet Basic settings de sa vue Component et dfinir ses proprits.
Cliquez sur le bouton [...] ct du champ File name pour synchroniser les donnes dans un fichier local. Dans ce scnario, le chemin daccs au fichier est D:/ReceiveData.csv. Cliquez sur le bouton Sync columns et laissez les autres paramtres tels quils sont. Double-cliquez sur le composant tJava pour ajouter du code dans longlet Basic settings de sa vue Component.
Composants Business
tMarketoOutput
Dans le champ Code, saisissez le code suivant afin de compter le nombre dappels dAPI effectus pendant les oprations sur les donnes : System.out.println(("The Number of API calls for inserting data to Marketo DB is:")); System.out.println((Integer)globalMap.get("tMarketoOutput_1_ NB_CALL")); System.out.println(("The Number of API calls for data synchronization from Marketo DB is:")); System.out.println((Integer)globalMap.get("tMarketoInput_1_N B_CALL")); Sauvegardez votre Job et appuyez sur F6 pour lexcuter.
Les enregistrements des prospects insrs dans la base de donnes Marketo sont crits dans le fichier D:/ReceiveData.csv.
Le nombre total dappels dAPIs durant les oprations sur les donnes est affich dans la console de la vue Run.
39
Composants Business
tMicrosoftCRMInput
tMicrosoftCRMInput
Proprits du tMicrosoftCRMInput
Le composant tMicrosoftCRMInput se connecte une entit de la base de donnes MicrosoftCRM via le service Web adquat. Ce composant permet dextraire les donnes dune base MicrosoftCRM selon certaines conditions dfinies dans des colonnes spcifiques. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Microsoft Webservice URL Organizename Saisissez lURL du service Web permettant de se connecter la base de donnes Microsoft CRM. Renseignez le nom de lutilisateur ou de lorganisme, dfini par un administrateur, qui veut accder la base de donnes MicrosoftCRM. Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez le nom de domaine du serveur sur lequel est hberge la base MicrosoftCRM. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nombre de secondes dcoute du port avant sa fermeture. Slectionnez lentit adquate partir de la liste droulante. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Si vous effectuez des modifications, le schma passera automatiquement en built-in. Pour ce composant, le schma correspond lentit slectionne. Si vous souhaitez combiner le filtrage simple et le mode avanc, slectionnez loprateur permettant de combiner les deux modes.
Username et Password Domain Host Port Time out (seconds) Entity Schema et Edit Schema
Logical operators used to combine conditions
40
Composants Business
tMicrosoftCRMInput
Conditions
Les conditions sont excutes les unes aprs les autres pour chaque ligne. Input column : Cliquez dans la cellule et slectionnez la colonne du schma dentre laquelle attribuer la condition. Operator : Cliquez dans la cellule et slectionnez loprateur pour relier la valeur la colonne du schma. Value : Saisissez la valeur filtre entre guillemets, si ncessaire. Cliquez sur le bouton [+] pour ajouter autant de conditions que vous le souhaitez.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est ncessaire. n/a
Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques
Le scnario suivant dcrit un Job quatre composants qui a pour but lcriture des donnes dun fichier dlimit en entre dans une entit personnalise dune base de donnes MicrosoftCRM . Le Job permet ensuite dextraire des lignes spcifiques jusque dans un fichier de sortie, en utilisant les conditions dfinies sur certaines colonnes dentre.
Si vous voulez crire dans une Entit Personnalise dune base de donnes MicrosoftCRM, assurez-vous de nommer les colonnes conformment aux rgles de syntaxe Microsoft, savoir name_columnname en minuscules.
A partir de la Palette, dposez les composants suivants dans lditeur graphique : tFileInputdelimited, tFileOutputDelimited, tMicrosoftCRMInput, et tMicrosoftCRMOutput.
41
Composants Business
tMicrosoftCRMInput
Connectez le composant tFileInputDelimited au tMicrosoftCRMOutput laide dun lien de type Row Main. Connectez le composant tMicrosoftCRMIntput au tFileOutputDelimited laide dun lien de type Row Main. Connectez le composant tFileInputDelimited au tMicrosoftCRMInput laide dun lien de type OnSubjobOk. Double-cliquez sur le composant tFileInputDelimited pour afficher la vue Basic settings et configurer ses paramtres de base.
Slectionnez le mode Repository partir de la liste droulante Property Type si vous avez stock les paramtres du fichier dentre sous le noeud Metadata de larborescence Repository. Dans le cas contraire, slectionnez le mode Built-In et remplissez manuellement les champs correspondants. Dans cet exemple, les proprits sont dfinies en mode Built-In. Cliquez sur le bouton [...] ct du champ File Name/Input Stream et parcourez vos dossiers jusquau fichier dlimit contenant les donnes dentre. Dans cet exemple, le fichier dentre comprend les colonnes suivantes : new_id, new_status, new_firstname, new_email, new_city, new_initial et new_zipcode.
Dans le champ Row separator, dfinissez le sparateur de lignes permettant didentifier les fins de ligne. De mme, pour Field separator, dfinissez le sparateur de champs permettant de dlimiter les diffrents champs pour chaque ligne. Dfinissez, si ncessaire, le nombre de lignes den-tte (Header) et de pied-de-page (Footer) ignorer, ainsi que le nombre maximum de lignes (Limit) que vous souhaitez traiter. Dans cet exemple, aucun de ces trois champs ne sont dfinis. Cliquez sur Edit schema pour ouvrir une bote de dialogue dans laquelle vous pouvez dfinir le schma dentre que vous voulez crire dans la base de donnes MicrosoftCRM.
42
Composants Business
tMicrosoftCRMInput
Cliquez sur OK pour fermer la bote de dialogue. Double-cliquez sur le composant tMicrosoftCRMOutput pour afficher la vue Basic settings et configurer ses paramtres de base.
Dans le champ Microsoft Web Service URL, saisissez lURL du serveur Web Microsoft. Renseignez ensuite le nom (Username) ainsi que le mot de passe (Password) correspondants. Dans le champ OrganizeName, saisissez lidentifiant qui porte les droits daccs la base de donnes MicrosoftCRM.
43
Composants Business
tMicrosoftCRMInput
Dans le champ Domain, renseignez le nom de domaine du serveur sur lequel la base de donnes MicrosoftCRM est hberge. Saisissez ensuite ladresse IP (Host) et le numro de port dcoute (Port) du serveur. A partir de la liste droulante Action, slectionnez lopration que vous voulez effectuer. Dans cet exemple, le but est dinsrer (Insert) des donnes dans une entit personnalise sur la base MicrosoftCRM. Dans le champ Time out, dfinissez la limite de temps (en secondes) aprs laquelle le Job sarrte automatiquement. Dans la liste Entity, slectionnez lune des options proposes. Dans cet exemple, cest loption CustomEntity qui est slectionne.
Lorsque loption CustomEntity est slectionne, le champ Custom Entity Name apparat, dans lequel vous devez saisir le nom de lentit personnalise.
Le Schema est alors dfini de manire automatique, en fonction de lentit slectionne. Cliquez si ncessaire sur le bouton Edit schema pour afficher une bote de dialogue partir de laquelle vous pouvez modifier ce schma et retirer les colonnes dont vous navez pas besoin en sortie. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent.
Double-cliquez sur le composant tMicrosoftCRMInput pour afficher la vue Basic settings et configurer ses paramtres de base.
44
Composants Business
tMicrosoftCRMInput
Slectionnez le mode Repository partir de la liste droulante Property Type si vous avez stock les paramtres du fichier dentre sous le noeud Metadata de larborescence Repository. Dans le cas contraire, slectionnez le mode Built-In et remplissez manuellement les champs correspondants. Dans cet exemple, les proprits sont dfinies en mode Built-In. Dans le champ Microsoft Web Service URL, saisissez lURL du serveur Web Microsoft. Renseignez ensuite le nom (Username) ainsi que le mot de passe (Password) correspondants. Dans le champ OrganizeName, saisissez lidentifiant qui porte les droits daccs la base de donnes MicrosoftCRM. Dans le champ Domain, renseignez le nom de domaine du serveur sur lequel la base de donnes MicrosoftCRM est hberge. Saisissez ensuite ladresse IP (Host) et le numro de port dcoute (Port) du serveur. Dans le champ Time out, dfinissez la limite de temps (en secondes) aprs laquelle le Job sarrte automatiquement. Dans la liste Entity, slectionnez lune des options proposes. Dans cet exemple, cest loption CustomEntity qui est slectionne.
Composants Talend Open Studio 45
Composants Business
tMicrosoftCRMInput
Le Schema est alors dfini de manire automatique, en fonction de lentit slectionne, mais vous pouvez le modifier si ncessaire. Dans cet exemple, pour accder lentit personnalise, il faut dfinir le schma manuellement. Copiez le schma sept colonnes partir du composant tMicrosoftCRMOutput et collez-le dans la bote de dialogue du tMicrosoftCRMInput.
Cliquez sur le bouton OK pour fermer la bote de dialogue. Un message pop-up vous proposera de propager les modifications : cliquez sur le bouton Yes. Dans la vue Basic settings, slectionnez loprateur logique And ou Or utiliser pour combiner les conditions dfinies dans les colonnes dentre. Dans cet exemple, pour dfinir deux conditions sur deux colonnes dentre diffrentes, il faut utiliser loprateur logique And. Dans la zone Condition, cliquez sur le bouton [...] pour ajouter autant de lignes que ncessaire, puis cliquez dans chaque ligne et slectionnez, partir de la liste droulante Input column, la colonne sur laquelle appliquer la condition. Dans cet exemple, les deux colonnes new-city et new_id portent des conditions. Le but est dextraire toutes les lignes concernant les clients dont la ville correspond New York et dont lidentifiant est suprieur 2. Cliquez dans chaque ligne et slectionnez, partir de la liste droulante Operator, loprateur utiliser pour relier la colonne dentre avec sa valeur associe. Dans cet exemple, loprateur Equal est slectionn pour la colonne new_city et Greater Than pour new_id. Cliquez dans chaque ligne et dfinissez, dans la colonne Value, la valeur des colonnes dentre : New York pour la colonne new_city et 2 pour new_id dans cet exemple. Il est possible dutiliser une valeur fixe aussi bien quune valeur de contexte dans ce champ. Double-cliquez sur le composant tFileOutputdelimited pour afficher la vue Basic settings et configurer ses paramtres de base.
46
Composants Business
tMicrosoftCRMInput
Slectionnez le mode Built-In partir de la liste droulante Property Type puis cliquez sur le bouton [...] ct du champ pour parcourir vos dossiers jusquau fichier de sortie. Dfinissez les sparateurs de lignes (Row separator) et de champs (Field separator). Cochez la case Append pour ajouter des lignes la fin des entres de la base de donnes. Cochez la case Include Header si le fichier de sortie comprend un en-tte. Cliquez sur le bouton Sync columns pour rcuprer le schma partir du composant prcdent. Enregistrez votre Job puis cliquez sur F6 pour lexcuter.
Seuls les clients habitant la ville de New York, et dont lidentifiant est suprieur 2, apparaissent dans la liste du fichier de sortie stock en local.
47
Composants Business
tMicrosoftCRMOutput
tMicrosoftCRMOutput
Proprits du tMicrosoftCRMOutput
Le composant tMicrosoftOutput crit dans un objet de la base de donnes MicrosoftCRM via le service Web adquat. Ce composant permet dcrire des donnes dans une base de donnes MicrosoftCRM. Microsoft Webservice URL Organizename Username et Password Domain Host Port Action Saisissez lURL du service Web permettant de se connecter la base de donnes MicrosoftCRM. Renseignez le nom de lorganisme qui veut accder la base de donnes MicrosoftCRM. Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez le nom de domaine du serveur qui installe MicrosoftCRM. Adresse IP du serveur de base de donnes MicrosoftCRM. Numro du port dcoute du serveur de la base de donnes MicrosoftCRM. Vous pouvez effectuer lune des oprations suivantes sur les donnes MicrosoftCRM : Insert : insrer les donnes. Update : mettre les donnes jour. Delete : supprimer les donnes. Nombre de secondes dcoute du port avant sa fermeture. Slectionnez lentit adquate partir de la liste droulante. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent.
Time out (seconds) Entity Schema et Edit Schema
Advanced settings Usage Limitation
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a
48
Composants Business
tMicrosoftCRMOutput
Scnario associ
Pour un scnario associ, consultez le Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques, page 41.
49
Composants Business
tMSAXInput
tMSAXInput
Proprits du tMSAXInput
Famille de composant Business/ Microsoft AX Le composant tMSAXInput se connecte au serveur MicrosoftAX. Ce composant permet de lire les donnes dun serveur MicrosoftAX et d'effectuer des requtes sur ces donnes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Domain Username et Password Schema et Edit Schema Adresse IP du serveur. Saisissez le nom de domaine sur lequel est hberg le serveur MicrosoftAX. Saisissez les informations dauthentification de lutilisateur. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. iSi vous effectuez des modifications, le schma passera automatiquement en built-in. Nom de la table lire. Saisissez votre requte SQL en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.
Table Name Query
Scnario associ
50
Composants Business
tMSAXOutput
tMSAXOutput
Proprits du tMSAXOutput
Famille de composant Business/ Microsoft AX Le composant tMSAXOutput se connecte au serveur MicrosoftAX. Ce composant permet dcrire les donnes dun serveur MicrosoftAX. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Domain Username et Password Table Name Action on data Adresse IP du serveur. Saisissez le nom de domaine sur lequel est hberg le serveur MicrosoftAX. Saisissez les informations dauthentification de lutilisateur. Nom de la table crire. Vous pouvez effectuer nimporte quelle opration sur les donnes dun serveur MicrosoftAX. Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une cl de recherche sur laquelle baser les oprations Update et Delete. Il est possible de dfinir les colonnes qui agiront comme cl de recherche partir du schma, pour une utilisation de base, ou partir des options avances (Advanced settings) pour une utilisation optimise de ces oprations. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. iSi vous effectuez des modifications, le schma passera automatiquement en built-in.
51
Composants Business
tMSAXOutput
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Cette option vous permet dutiliser des expressions locales afin deffectuer des actions sur les colonnes. Par exemple, vous pouvez modifier les valeurs dans la table slectionne : Quand vous mettez jour ou que vous effacez des donnes dans une colonne, cette option vous fournit dautres possibilits concernant les clauses WHERE en utilisant diffrents oprateurs de la colonne Operator. Name : nom de la colonne du schma devant tre modifie ou insre comme nouvelle colonne. Operator : slectionnez dans la liste loprateur que vous souhaitez utiliser avec la clause WHERE. Cette colonne nest pas disponible quand vous utilisez Insert comme action sur les donnes. Data type : type de donnes. Local expression : type dexpression locale qui sera excut afin de modifier ou insrer la colonne de donnes correspondante, par exemple row1.[row name]. Ou bien appuyez sur Ctrl + espace et slectionnez une variable de contexte dans la liste. Position : slectionnez dans la liste Before, After ou Replace, suivant laction que vous voulez excuter dans la colonne de rfrence. Reference column : type, dans une colonne de rfrence, que le composant peut utiliser pour insrer/remplacer la nouvelle colonne ou la colonne modifie.
Additional columns
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis en tant que composant de sortie. Un composant de dbut est ncessaire. n/a
Scnario : Insrer des donnes dans une table dfinie sur le serveur Microsoft AX
Avant de pouvoir utiliser ce composant, vrifiez que vous avez install et lanc le serveur Microsoft AX correctement.
52
Composants Business
tMSAXOutput
Ce scnario Java dcrit un Job deux composants qui utilise le composant tMSAXOutput afin dinsrer une ligne dans une table dfinie stocke sur un serveur Microsoft AX et modifie ensuite les valeurs dans lune des colonnes insre.
Glissez le composant tFixedFlowInput ainsi que le tMSAXOutput de la Palette dans lespace de modlisation. Connectez les composants laide dun lien Row de type Main. Double-cliquez sur le tFixedFlowInput afin dafficher la vue Component et de dfinir ses proprits.
Slectionnez le mode Built-In dans le champ Schema Type et cliquez sur le bouton [...] du champ Edit schema afin dafficher une bote de dialogue qui vous permettra de dfinir le schma dentre. Cliquez sur le bouton Plus vert pour ajouter des colonnes dans le schma dentre, trois dans cet exemple, name, city et street (nom, ville et rue). Cliquez sur OK pour fermer la bote de dialogue. Une nouvelle bote de dialogue souvre et vous demande si vous voulez propager les modifications, cliquez sur Yes (Oui). Les colonnes du schma saffichent automatiquement dans le tableau Values. Cliquez sur la colonne Value et saisissez une valeur pour chaque colonne dentre. Double-cliquez sur le tMSAXOutput pour ouvrir la vue Component et dfinir ses proprits.
53
Composants Business
tMSAXOutput
Slectionnez le mode Built-In dans le champ Property Type. Dans le champ Host, saisissez ladresse IP du serveur MicrosoftAX Dans le champ Domain, saisissez le nom du domaine qui hberge le serveur MicrosoftAX. Entrez votre nom dutilisateur et votre mot de passe de connexion au serveur dans les champs correspondants. Dans le champ Table Name, saisissez le nom de la table dans la quelle vous souhaitez crire des donnes. Dans la liste Action on data, slectionnez laction que vous dsirez excuter, Delete dans cet exemple. Cliquez sur Sync columns pour retrouver le schma du composant prcdent. Dans cet exemple, le but est de retrouver les trois colonnes dentre : name, city et street (nom, ville et rue). Si ncessaire, cliquez sur le bouton [...] du champ Edit schema afin douvrir une bote de dialogue qui vous permettra de vrifier le schma retourn. Dans le tableau Additional columns, cliquez sur le bouton [+] afin dajouter une ligne dans laquelle vous pouvez utiliser une expression locale pour modifier les donnes que vous voulez crire dans une colonne spcifique. Cliquez sur la colonne Local expression et appuyez sur Ctrl + espace sur votre clavier pour ouvrir la liste des variables de contexte et slectionnez : StringHandling.UPCASE(row2.city)+-+row2.street. Cette expression crira le nom de la ville avec la premire lettre en majuscule, suivi du nom de la rue, pour former ladresse du Bryant park. La colonne address de cet exemple contiendra donc la chane de caractres suivante : New York-Midtown Manhattan.
54
Composants Business
tMSAXOutput
Sauvegardez votre Job et appuyez sur F6 pour lexcuter. Le tMSAXOutput insre dans la table ADDRESS du serveur MicrosoftAX une ligne contenant les trois colonnes dentre name, city et street, en plus de la nouvelle colonne address qui contient la fois le nom de la ville et le nom de la rue.
Scnario 2 : Effacer des donnes dune table prcise sur le serveur MicrosoftAX.
Avant de pouvoir utiliser ce composant, vrifiez que vous avez install et lanc correctement le serveur MicrosoftAX.
Ce scnario Java dcrit un Job deux composants qui utilise le tMSAXOutput dans le but deffacer toutes les lignes dune table dfinie qui ne correspondent pas aux donnes contenues dans la colonne cl sur un serveur MicrosoftAX. Dans cet exemple, le schma dentre que vous utilisez est une colonne address (adresse) qui contient les donnes suivantes : New York-Midtown Manhattan. Vous allez effacer du serveur MicrosoftAX toutes les adresses qui ne sont pas identiques celle-ci.
Glissez les composants tFixedFlowInput et tMSAXOutput de la Palette dans lespace de modlisation. Connectez les deux composants laide dun lien Row de type Main. Double-cliquez sur le tFixedFlowInput pour afficher sa vue Component et dfinir ses proprits.
Slectionnez le mode Built-In dans le champ Schema Type et cliquez sur le bouton [...] du champ Edit schema pour ouvrir une bote de dialogue o vous pourrez dfinir le schma. Cliquez sur le bouton [+] et ajoutez les colonnes dentre du schma, address dans cet exemple.
55
Composants Business
tMSAXOutput
Cliquez sur OK pour fermer la bote de dialogue. Les colonnes du schma saffichent automatiquement dans la list Values. Cliquez sur la colonne Value et saisissez une valeur pour la colonne dentre. Double-cliquez sur le tMSAXOutput pour ouvrir sa vue Component et dfinir ses proprits.
Slectionnez le mode Built-In dans le champ Property Type. Dans le champ Host, saisissez ladresse IP du serveur MicrosoftAX. Dans le champ Domain, entrez le nom du domaine qui hberge le serveur MicrosoftAX. Saisissez votre nom dutilisateur et votre mot de passe de connexion au serveur dans les champs correspondants. Dans le champ Table Name, saisissez le nom de la table dans laquelle vous voulez crire des donnes. Dans la liste Action on data, slectionnez laction que vos souhaitez excuter, Delete dans cet exemple. Cliquez sur Sync columns pour retourner le schma du composant prcdent. Dans cet exemple, lobjectif est de rcuprer la colonne dentre zipcode (code postal). Cliquez sur le bouton [...] du champ Edit Schema pour ouvrir la bote de dialogue dans laquelle vous pouvez vrifier le schma rcupr.
56
Composants Business
tMSAXOutput
Dans le schma de sortie, cochez la case Key (cl) ct du nom de la colonne.

Quand vous slectionnez une option diffrente de Insert, vous devez toujours dfinir la Reference column (colonne de rfrence) comme colonne cl.
Cliquez sur OK pour valider les changements et fermer la bote de dialogue. Dans le tableau Additional columns, cliquez sur le bouton [+] pour ajouter une ligne et dfinir les paramtres que le composant utilisera comme base pour lopration deffacement. Saisissez un nom (name), un oprateur (operator), un type de donnes (data type), une expression locale (local expression), une position (position) et une colonne de rfrence (reference column) dans les colonnes correspondantes la ligne que vous venez dajouter. Dans cet exemple, lobjectif est deffacer de la table ADDRESS du serveur MicrosoftAX toutes les lignes dans lesquelles la colonne Address nest pas identique ladresse dans la colonne cl address : New York-Midtown Manhattan.
Quand vous slectionnez une action autre que Insert ,dans le champ Action on data vous devez toujours slectionner Replace dans la colonne Position.
Sauvegardez votre Job et appuyez sur F6 pour lexcuter. Le tMSAXOutput supprime de la table ADDRESS du serveur MicrosoftAX toutes les lignes pour lesquelles les donnes de la colonne address ne sont pas identiques celles de la colonne cl.
57
Composants Business
tOpenbravoERPInput
tOpenbravoERPInput
Proprits du tOpenbravoERPInput
Le composant tOpenbravoERPInput se connecte une entit de la base de donnes OpenbravoERP via le service Web adquat. Ce composant permet dextraire les donnes dune base OpenBravoERP selon certaines conditions dfinies dans des colonnes spcifiques. Openbravo REST WebService URL Username et Password Entity Schema et Edit Schema Saisissez lURL du service Web permettant de se connecter la base de donnes OpenbravoERP. Saisissez les informations dauthentification de lutilisateur au service Web. Slectionnez lentit adquate partir de la liste droulante. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Si vous effectuez des modifications, le schma passera automatiquement en built-in. Pour ce composant, le schma correspond lentit slectionne. Saisissez votre clause WHERE. Cochez cette case afin de slectionner comment ordonner les rsultats (les lments de la liste droulante dpendent de lentit slectionne). Sort : Dans cette liste, vous pouvez choisir de trier vos rsultats de manire ascendante (Ascending) ou descendante (Descending). Saisissez le numro de la ligne que vous souhaitez rcuprer en premier. Saisissez le nombre maximal de rsultats que vous souhaitez rcuprer. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux.
WHERE Clause Order by
First result Max result Advanced settings Advanced separator (for numbers)
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est ncessaire. n/a
58
Composants Business
tOpenbravoERPInput
Scnario associ
59
Composants Business
tOpenbravoERPOutput
tOpenbravoERPOutput
Proprits du tOpenbravoERPOutput
Le composant tOpenbravoERPOutput crit dans un objet de la base de donnes OpenbravoERP via le service Web adquat. Ce composant permet dcrire des donnes dans une base de donnes OpenbravoERP. Openbravo REST Webservice URL Username et Password Action on data Saisissez lURL du service Web permettant de se connecter la base de donnes OpenbravoERP. Saisissez les informations dauthentification de lutilisateur au service Web. Slectionnez dans la liste si vous souhaitez mettre jour ou crer des donnes (Update/Create), ou si vous prfrez en supprimer (Remove). Cochez cette case afin de slectionner votre fichier en parcourant votre rpertoire. Slectionnez lentit adquate partir de la liste droulante. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent.
Use existing data file Entity Schema et Edit Schema
Scnario associ
60
Composants Business
tSageX3Input
tSageX3Input
Proprits du tSageX3Input
Famille de composant Business/Sage X3
Le composant tSageX3Input tire profit du Service Web fourni par un serveur Web Sage X3 pour extraire des donnes du systme Sage X3 (serveur X3). Le composant tSageX3Input extrait des donnes dun systme Sage X3 donn. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Si vous effectuez des modifications, le schma passera automatiquement en built-in. Saisissez ladresse du Service Web fourni par le serveur Web Sage X3 donn. Saisissez les informations dauthentification pour le Service Web, dfinies lors de la configuration du Serveur Web Sage X3. Saisissez le nom du code langue X3 utilis pour le dmarrage du groupe de connexions. Saisissez le nom du pool de connexion distribuant les requtes reues aux connexions disponibles. Ce nom est donn depuis la console de configuration Sage X3. Saisissez la chane de caractres de configuration si vous souhaitez rcuprer les informations de dbogage ou de traces. Par exemple, la chane de caractres peut tre : RequestConfigDebug=adxwss.trace.o n=on; Si vous devez utiliser plusieurs chanes de caractres, sparez-les avec un &, par exemple, RequestConfigDebug=adxwss.trace.o n=on&adxwss.trace.size=16384; Un outil tiers est ncessaire pour rcuprer ce type dinformations.
Endpoint address Username et Password Language Pool alias
Request config
61
Composants Business
tSageX3Input
Publication name
Saisissez dans ce champ le nom de lobjet, de la liste ou du sous-programme publi(e) auquel/ laquelle vous souhaitez que votre Studio accde. Remplissez ce tableau pour mapper les lments variables de lobjet, le sous-programme ou la liste dfini(e)(s) dans le serveur Web Sage X3 donn. Les colonnes complter incluent : Column : les colonnes dfinies dans lditeur de schma de ce composant.Group ID : lidentifiant de chaque groupe dlments variables. Par exemple, un groupe dlments variables peut reprsenter lun des attributs dun objet.Field name : le nom de chaque lment variable. Cochez cette case pour paramtrer la (les) condition(s) de la requte. Les colonnes complter incluent : Key : le nom des lments variables utiliss comme cl de lextraction de donnes. Value : la valeur du champ cl donn utilis pour extraire les donnes correspondantes. Saisissez un chiffre ou un nombre indiquant le maximum de lignes de donnes extraire.
Mapping
Query condition
Limit Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant. Gnralement utilis comme composant de dbut. Un composant de sortie est ncessaire. n/a
Scnario : Utiliser les cls des requtes pour extraire des donnes dun systme Sage X3 donn
Ce scnario dcrit un Job deux composants utilis pour extraire une ligne ou des donnes dun systme Sage X3 donn. La mthode des objets est appele, les lments variables de cet objet sont des attributs. Les donnes utilises dans ce scnario proviennent de lexemple fourni par Sage X3.
Dposez un composant tSageX3Input et un tLogRow de la Palette dans lespace de modlisation graphique. Reliez le composant tSageX3Input au tLogRow laide dun lien Row > Main. Double-cliquez sur le tSageX3Input afin de configurer ses Basic Settings dans la vue Component.
62
Composants Business
tSageX3Input
Dans la liste Schema, slectionnez Built-In. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir lditeur du schma.
63
Composants Business
tSageX3Input
Dans cet diteur, cliquez douze fois sur le bouton [+] pour ajouter 12 lignes la table. Saisissez les noms que vous souhaitez utiliser pour chaque ligne. Dans cet exemple, ces lignes sont nommes daprs les noms de publication des attributs des objets dfinis dans le serveur Web Sage X3. Ces colonnes sont utilises pour mapper les champs des attributs correspondants dans le systme Sage X3. Dans la colonne Type, cliquez sur la ligne IMG pour afficher une liste droulante. Dans la liste droulante, slectionnez List, puisque lattribut apparat plusieurs fois dans Sage. Rptez lopration pour changer le type des lignes TIT2NBLIG, ITMLNK et ZITMLNK en List pour la mme raison. Cliquez sur OK pour valider les modifications et acceptez la propagation propose par la bote de dialogue qui souvre. Dans le champ Endpoint address, saisissez lURL du service Web fournie par le serveur Web Sage X3. Dans cet exemple, lURL est : http://10.42.20.168:28880/adxwsvc/services/CAdxWebServiceXmlCC Dans le champ User, saisissez le nom de lutilisateur de Sage X3. Dans cet exemple, lutilisateur est ERP. Dans le champ Language, saisissez le nom du code langue X3 utilis pour le dmarrage dun groupe de connexions, FRA dans cet exemple. Dans le champ Pool alias, saisissez le nom du pool de connexion utiliser. Dans cet exemple, le pool de connexion est appel TALEND. Dans le champ Publication name, saisissez le nom de publication de lobjet appeler. Dans ce scnario, le nom de publication est ITMDET. Dans les colonnes Group ID et Field name de la table Mapping, saisissez les valeurs correspondant lID du groupe dattributs et au nom de publication dfinis dans le serveur Web Sage X3. Dans cet exemple, les valeurs sont prsentes comme suit :
Composants Business
tSageX3Input
Dans la table Mapping, la colonne Column a t automatiquement renseigne avec les colonnes que vous avez cres dans lditeur du schma.
Cochez la case Query condition pour activer le tableau Conditions. Sous le tableau Conditions, cliquez sur le bouton [+] pour ajouter une ligne. Dans la colonne Key, saisissez le nom de publication associ lattribut de lobjet dont vous souhaitez extraire les donnes. Dans la colonne Value, saisissez la valeur de lattribut que vous avez slectionn comme cl de lextraction. Dans ce scnario, sa valeur est CONTS00059, une des rfrences produit. Slectionnez Built-In dans la liste Schema puis cliquez sur [...] ct du champ Edit schema afin douvrir lditeur du schma.
Appuyez sur F6 pour excuter le Job. Les rsultats sont affichs dans la vue Run :
65
Composants Business
tSageX3Output
tSageX3Output
Proprits du tSageX3Output
Famille de composant Business/Sage X3
Fonction
Le composant tSageX3Output se connecte au service Web fourni par un serveur Web Sage X3 donn et partir de l, insre, met jour ou supprime des donnes dans le systme Sage X3 (serveur X3). Ce composant crit des donnes dans un systme Sage X3 donn. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Si vous effectuez des modifications, le schma passera automatiquement en built-in. Saisissez ladresse du Service Web fourni par le serveur Web Sage X3 donn. Saisissez les informations dauthentification pour le Service Web, dfinies lors de la configuration du Serveur Web Sage X3. Saisissez le nom du code langue X3 utilis pour le dmarrage du groupe de connexions. Saisissez le nom du pool de connexion distribuant les requtes reues aux connexions disponibles. Ce nom est donn depuis la console de configuration Sage X3. Saisissez la chane de caractres de configuration si vous souhaitez rcuprer les informations de dbogage ou de traces. Par exemple, la chane de caractres peut tre : RequestConfigDebug=adxwss.trace.o n=on; Si vous devez utiliser plusieurs chanes de caractres, sparez-les avec un &, par exemple, RequestConfigDebug=adxwss.trace.o n=on&adxwss.trace.size=16384; Un outil tiers est ncessaire pour rcuprer ce type dinformations.
Endpoint address Username et Password Language Pool alias
Request config
66
Composants Business
tSageX3Output
Publication name
Saisissez dans ce champ le nom de lobjet, de la liste ou du sous-programme publi(e) auquel/ laquelle vous souhaitez que votre Studio accde. Vous pouvez effectuer lune des oprations suivantes sur les donnes dun systme Sage X3: Insert : insrer des donnes, Update : mettre jour des donnes, Delete : supprimer des donnes. Remplissez ce tableau pour mapper les lments variables de lobjet, le sous-programme ou la liste dfini(e)(s) dans le serveur Web Sage X3 donn au(x)quel(s)/ laquelle votre Studio accde. Seuls les lments sur lesquels vous souhaitez effectuer laction sont slectionns et saisis dans le but de raliser le mapping. Les colonnes complter incluent : Column : les colonnes dfinies dans lditeur du schma de ce composant. Key : llment variable utilis comme cl de linsertion, de la mise jour ou de la suppression de donnes. Cochez la case correspondante si la cl est un lment variable.Group ID : lidentifiant de chaque groupe dlments variables. Par exemple, un groupe dlments variables peut reprsenter lun des attributs dun objet.Field name : le nom du champ de chaque lment variable slectionn.
Action
Mapping
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant. Ce composant est gnralement utilis comme composant de sortie et requiert un composant dentre. n/a
Scnario : Utiliser un service Web Sage X3 pour insrer des donnes dans un systme Sage X3 donn
Ce scnario dcrit un Job deux composants, utilis pour gnrer une ligne de donnes et insrer ces donnes dans un systme Sage X3 donn. Vous pouvez trouver les donnes utilises dans ce scnario dans lexemple fourni par Sage X3. Le service Web Sage X3 est utilis pour accder un objet.
Dposez un composant tFixedFlowInput et un tSageX3Output de la Palette dans lespace de modlisation graphique.
67
Composants Business
tSageX3Output
Reliez le composant tFixedFlowInput au composant tSageX3Output laide dun lien Row > Main. Double-cliquez sur le tFixedFlowInput afin dafficher sa vue Component et dfinir ses proprits.
Cliquez sur le bouton [...] ct du champ Edit schema afin douvrir lditeur du schma.
Cliquez quatre fois sur le bouton [+] afin dajouter quatre lignes au schma. Cliquez sur OK pour valider les modifications, puis acceptez la propagation propose par la bote de dialogue qui souvre ensuite. Les quatre lignes apparaissent automatiquement dans la table Values de la vue Component. Dans le tableau Values de la zone Mode, saisissez les valeurs de chacune des quatre lignes de la colonne Value. Dans ce scnario, les valeurs (de haut en bas) sont : CONTS00059, Screen 24\" standard 16/10, Screen 24\" standard 28/10 et 2.
68
Composants Business
tSageX3Output
Les valeurs dans la colonne Value doivent tre mises entre guillemets.
Double-cliquez sur le composant tSageX3Output afin dafficher sa vue Component et dfinir ses proprits.
Dans le champ Endpoint address, saisissez lURL du service Web fourni par le serveur Web Sage X3. Dans cet exemple, lURL est : http://10.42.20.168:28880/adxwsvc/services/CAdxWebServiceXmlCC. Dans le champ User, saisissez le nom de lutilisateur de Sage X3. Dans cet exemple, lutilisateur est ERP. Dans le champ Language, saisissez le nom du code langue X3 utilis pour dmarrer un groupe de connexions. Dans cet exemple, le code est FRA. Dans le champ Pool alias, saisissez le nom du pool de connexion utiliser. Dans cet exemple, le pool de connexion est appel TALEND. Dans le champ Publication name, saisissez le nom de publication de lobjet appeler. Dans ce scnario, le nom de publication est ITMDET. Dans le champ Action, slectionnez insert dans la liste droulante. Dans la colonne Field name de la table Mapping, saisissez le nom des champs des attributs sur lesquels effectuer laction slectionne. Dans la colonne Group ID de la table Mapping, saisissez les valeurs correspondantes afin de regrouper les IDs des attributs slectionns. Ces IDs sont dfinis dans le serveur Web Sage X3.
69
Composants Business
tSageX3Output
Dans la table Mapping, la colonne Column a t automatiquement renseigne avec toutes les colonnes rcupres du schma du composant prcdent.
Appuyez sur F6 pour excuter le Job. Pour vrifier les donnes que vous avez insres dans ce scnario, vous pouvez utiliser le composant tSageX3Input pour lire les donnes concernes dans le serveur Sage X3. Pour plus dinformations concernant lutilisation du composant tSageX3Input pour lire des donnes, consultez le Scnario : Utiliser les cls des requtes pour extraire des donnes dun systme Sage X3 donn, page 62.
70
Composants Business
tSalesforceBulkExec
tSalesforceBulkExec
Les composants tSalesforceOutputBulk et tSalesforceBulkExec sont gnralement utiliss ensemble pour gnrer en sortie le fichier dfini et excuter ensuite les actions souhaites sur votre fichier, dans votre Salesforce.com. Cette excution en deux tapes est unifie dans le composant tSalesforceOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le changement des donnes dans la base de donnes.
Proprits du tSalesforceBulkExec
Fonction Objectif
Le composant tSalesforceBulkExec excute les actions dfinies sur les donnes de chargement de masse prpares. En tant que composant ddi, le tSalesforceBulkExec vous permet doptimiser les performances lors des excutions doprations dfinies dans votre Salesforce.com. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section tSalesforceConnection, page 73. Lorsquun Job contient le Job parent et le Job enfant, la liste Component list prsente uniquement les composants de connexion du mme niveau de Job. Si vous souhaitez utiliser une connexion existant dans un autre niveau de Job, vous pouvez utiliser longlet Dynamic settings, afin de partager la connexion en question. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct. Pour plus dinformation concernant longlet Dynamic settings, consultez le Guide Utilisateur de votre Studio. Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Salesforce Version Bulk file path Action Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez la version de Salesforce que vous utilisez. Rpertoire o sont stockes les donnes de masse que vous devez traiter. Vous pouvez effectuer les oprations suivantes sur les donnes de lobjet Salesforce : Insert : insrer des donnes. Update : mettre jour des donnes. Upsert : mettre jour et insrer des donnes.
Basic settings
71
Composants Business
tSalesforceBulkExec
Module
Slectionnez lobjet adquat dans la liste. Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Saisissez le nombre de lignes devant tre traites par lot de donnes. Saisissez le nombre doctets par lot de donnes devant tre traits. Cochez cette case si vous souhaitez utiliser un proxy. Une fois la case coche, vous devez saisir les paramtres de connexion dans les champs qui apparaissent, lhte, le port, le nom dutilisateur et le mot de passe du proxy que vous souhaitez utiliser.
Advanced settings
Rows to commit Bytes to commit Use Socks Proxy
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. Les donnes de masse traiter doivent tre au format .csv.
Scnario associ
Pour un scnario associ, consultez Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com, page 93.
72
Composants Business
tSalesforceConnection
tSalesforceConnection
Proprits du tSalesforceConnection
Le composant tSalesforceConnection ouvre une connexion vers un systme Salesforce afin deffectuer une transaction. Ce composant permet de vous connecter Salesforce. Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Timeout (milliseconds) For salesforce bulk component Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez le dlai avant suspension de la requte sur Salesforce.com. Cochez cette case si vous souhaitez utiliser des composants de traitement de donnes de masse de la famille Salesforce. Une fois la case coche, le champ Salesforce Version apparat dans lequel vous pouvez saisir la version de Salesforce que vous utilisez. Pour plus dinformations concernant ces composants de traitement de donnes de masse, consultez tSalesforceBulkExec, page 71, tSalesforceOutputBulk, page 93 et tSalesforceOutputBulkExec, page 99. Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance. Cochez cette case si vous souhaitez utiliser un proxy. Une fois la case coche, vous devez saisir les paramtres de connexion dans les champs qui apparaissent, lhte, le port, le nom dutilisateur et le mot de passe du proxy que vous souhaitez utiliser.
Use Soap Compression Use Socks Proxy
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec les composants Salesforce. n/a
Scnario associ
Pour plus dinformations relatives au fonctionnement du composant tSalesforceConnection, consultez tMysqlConnection page 630.
73
Composants Business
tSalesforceGetDeleted
Proprits du tSalesforceGetDeleted
Le composant tSalesforceGetDeleted rcupre les donnes supprimes dun objet Salesforce sur une priode donne. Ce composant rcupre les donnes supprimes de lobjet Salesforce spcifi sur une priode spcifie. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section Proprits du tSalesforceConnection, page 73. Lorsquun Job contient le Job parent et le Job enfant, la liste Component list prsente uniquement les composants de connexion du mme niveau de Job. Si vous souhaitez utiliser une connexion existant dans un autre niveau de Job, vous pouvez utiliser longlet Dynamic settings, afin de partager la connexion en question. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct. Pour plus dinformation concernant longlet Dynamic settings, consultez le Guide Utilisateur de votre Studio. Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Timeout (milliseconds) Module Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez le dlai avant suspension de la requte sur Salesforce.com. Slectionnez lobjet adquat dans la liste. Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent.
74
Composants Business
Start Date
Saisissez entre guillemet la date laquelle vous voulez commencer la recherche. Pour cela, utilisez le format de date suivant : yyy-MM-dd HH:mm:ss. Vous ne pouvez effectuer la recherche que sur les 30 derniers jours. Saisissez entre guillemet la date laquelle vous voulez terminer la recherche. Pour cela, utilisez le format de date suivant : yyy-MM-dd HH:mm:ss. Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance.
End Date
Advanced settings
Use Soap Compression
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. n/a
Scnario : Rcuprer les donnes supprimes du serveur Salesforce

Ce scnario dcrit un Job deux composants permettant de rcuprer les donnes supprimes du serveur Salesforce, dans les 5 derniers jours.
Cliquez et dposez les composants tSalesforceGetDeleted et tLogRow de la Palette dans le Job Designer. Reliez-les via un lien de type Row > Main. Double-cliquez sur le composant tSalesforceGetDeleted pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
75
Composants Business
Dans le champ Salesforce WebService URL, laissez lURL du service Web Salesforce par dfaut ou saisissez lURL laquelle vous souhaitez accder. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au service Web. Dans la liste Module, slectionnez lobjet auquel vous souhaitez accder. Dans ce scnario, lobjectif est daccder lobjet Account. Dans la liste Schema, slectionnez Repository puis cliquez sur le bouton [...] pour slectionner le schma du repository que vous souhaitez utiliser pour le composant. Si vous navez pas enregistr le schma dans les mtadonnes du repository, slectionnez Built-in dans la liste Schema et cliquez sur le bouton [...] cot du champ Edit schema et paramtrer le schma manuellement. Dans les champs Start Date et End Date, saisissez la date de dbut et de fin de recherche des donnes supprimes en utilisant le format de date suivant : yyyy-MM-dd HH:mm:ss. Vous ne pouvez effectuer la recherche que sur les 30 derniers jours. Dans ce scnario, lobjectif est de chercher les donnes supprimes dans les cinq derniers jours. Double-cliquez sur le composant tLogRow pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits : Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Dans la zone Mode, slectionnez loption Vertical pour faire apparatre le rsultat dans sous forme de tableau dans la console. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
76
Composants Business
La console affiche les donnes supprimes rcupres par le composant tSalesforceGetDeleted sous forme de tableau.
77
Composants Business
tSalesforceGetServerTimestamp
Proprits du tSalesforceGetServerTimestamp
Le composant tSalesforceGetServerTimestamp rcupre la date actuelle du serveur Salesforce. Ce composant rcupre la date actuelle sous forme de timestamp du serveur Salesforce. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section Proprits du tSalesforceConnection, page 73. Lorsquun Job contient le Job parent et le Job enfant, la liste Component list prsente uniquement les composants de connexion du mme niveau de Job. Si vous souhaitez utiliser une connexion existant dans un autre niveau de Job, vous pouvez utiliser longlet Dynamic settings, afin de partager la connexion en question. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct. Pour plus dinformation concernant longlet Dynamic settings, consultez le Guide Utilisateur de votre Studio. Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Timeout (milliseconds) Schema et Edit Schema Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez le dlai avant suspension de la requte sur Salesforce.com. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Cochez cette case si vous souhaitez utiliser un proxy. Une fois la case coche, vous devez saisir les paramtres de connexion dans les champs qui apparaissent, lhte, le port, le nom dutilisateur et le mot de passe du proxy que vous souhaitez utiliser.
Advanced settings
Use Socks Proxy
78
Composants Business
Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance.
Scnario associ
79
Composants Business
tSalesforceGetUpdated
Proprits du tSalesforceGetUpdated
Le composant tSalesforceGetUpdated rcupre les donnes mises jour dun objet Salesforce sur une priode donne. Ce composant rcupre les donnes mises jour de lobjet Salesforce spcifi sur une priode spcifie. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section Proprits du tSalesforceConnection, page 73. Lorsquun Job contient le Job parent et le Job enfant, la liste Component list prsente uniquement les composants de connexion du mme niveau de Job. Si vous souhaitez utiliser une connexion existant dans un autre niveau de Job, vous pouvez utiliser longlet Dynamic settings, afin de partager la connexion en question. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct. Pour plus dinformation concernant longlet Dynamic settings, consultez le Guide Utilisateur de votre Studio. Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Timeout (milliseconds) Module Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez le dlai avant suspension de la requte sur Salesforce.com. Slectionnez lobjet adquat dans la liste. Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent.
80
Composants Business
Start Date
Saisissez entre guillemet la date laquelle vous voulez commencer la recherche. Pour cela, utilisez le modle de date suivant : yyy-MM-dd HH:mm:ss. Vous ne pouvez effectuer la recherche que sur les 30 derniers jours. Saisissez entre guillemets la date laquelle vous voulez terminer la recherche. Pour cela, utilisez le modle de date suivant : yyy-MM-dd HH:mm:ss. Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance.
End Date
Advanced settings
Scnario associ
81
Composants Business
tSalesforceInput
tSalesforceInput
Proprits du tSalesforceInput
Le composant tSalesforceInput se connecte un objet de la base de donnes Salesforce via le service Web adquat. Ce composant permet dextraire les donnes dune base de donnes Salesforce laide dune requte. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant connexion de base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section Proprits du tSalesforceConnection, page 73. Lorsquun Job contient le Job parent et le Job enfant, la liste Component list prsente uniquement les composants de connexion du mme niveau de Job. Si vous souhaitez utiliser une connexion existant dans un autre niveau de Job, vous pouvez utiliser longlet Dynamic settings, afin de partager la connexion en question. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct. Pour plus dinformation concernant longlet Dynamic settings, consultez le Guide Utilisateur de votre Studio. Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Saisissez les informations dauthentification de lutilisateur au service Web.
82
Composants Business
tSalesforceInput
Timeout (milliseconds) Module
Saisissez le dlai avant suspension de la requte sur Salesforce.com. Slectionnez lobjet adquat dans la liste. Use Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn. Pour retrouver une colonne dun module li, il est ncessaire de dfinir la colonne, dune manire prcise, dans la vue Edit Schema, sinon la requte relationnelle ne fonctionnera pas. La syntaxe correcte est :NameofCurrentModule_NameofLin kedModule_NameofColumnofInteres t.
Query condition
Saisissez la requte permettant de slectionner les donnes extraire. Exemple : account_name= Talend Cochez cette case pour saisir manuellement la requte Salesforce que vous souhaitez effectuer dans le champ Query. Cochez cette case pour interroger tous les enregistrements, y compris les enregistrements supprims. Nombre denregistrements dans chaque lot rcupr. Cochez cette case si vous souhaitez utiliser un proxy. Une fois la case coche, vous devez saisir les paramtres de connexion dans les champs qui apparaissent, lhte, le port, le nom dutilisateur et le mot de passe du proxy que vous souhaitez utiliser. Caractre, chane ou expression rgulire utilis pour normaliser les donnes collectes laide de requtes effectues sur les relations hirarchiques entre les diffrents objets Salesforce. Caractre, chane ou expression rgulire utilis pour sparer le nom de lobjet parent du nom de lobjet fils lorsque vous effectuez une requte sur les relations hirarchiques entre les diffrents objets Salesforce.
Manual input of SOQL query Query all records (include deleted records) Advanced settings Batch Size Use Socks Proxy
Normalize delimited (for child relationship) Column name delimiter (for child relationship)
83
Composants Business
tSalesforceInput
Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance, notamment lors des oprations de batch.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est ncessaire. n/a
Scnario : Utiliser des requtes pour extraire des donnes dune base de donnes Salesforce
Ce scnario dcrit un Job comprenant quatre composants, utiliss pour extraire des ensembles spcifiques de donnes dobjets parents et enfants dans une base de donnes Salesforce. Dposez deux composants tSalesforceInput et deux tLogRow dans lespace de modlisation graphique.
Reliez chaque composant tSalesforceInput un tLogRow, laide de liens Row > Main. Reliez le tSalesforceInput_1 au tSalesforceInput_2 en utilisant un lien OnSubjobOk. Double-cliquez sur le tSalesforceInput_1 afin de dfinir ses Basic Settings dans la vue Component.
84
Composants Business
tSalesforceInput
Dans la liste Property Type, slectionnez Built-In. Dans le champ Salesforce WebService URL, saisissez lURL de la base de donnes laquelle vous souhaitez vous connecter. Renseignez vos informations dauthentification dans les champs correspondants, Username pour lidentifiant et Password pour le mot de passe. Saisissez la limite de temps que vous souhaitez appliquer la requte, dans le champ Timeout (milliseconds). Slectionnez le Module (objet Salesforce) que vous souhaitez interroger. Cochez la case Manual input of SOQL Query afin de saisir votre requte dans le champ Query. Saisissez votre requte, ou votre requte relationnelle, en respectant la syntaxe SOQL requise. Dans cet exemple, les colonnes IsWon et FiscalYear dans la requte sont situes dans le module Opportunity spcifi. La colonne Name est dans un module li, appel Account. Pour retourner une colonne dun module li, la syntaxe correcte est de saisir le nom du module li, suivi par le caractre point (.), puis par le nom de la colonne approprie. Ici, la requte requise est donc : SELECT IsWon, FiscalYear, Account.Name FROM Opportunity.
Pour retrouver une colonne dun modle li, il est ncessaire de dfinir la colonne dune manire prcise dans la vue Edit Schema. La syntaxe correcte est :NameofCurrentModule_NameofLinkedModule_NameofColumnofInterest. Dans notre exemple, la colonne doit se nommer : Opportunity_Account_Name. Si cette syntaxe nest pas respecte, les donnes de la table lie ne seront pas retournes.
Slectionnez Built-In dans la liste Schema puis cliquez sur le bouton [...] ct du champ Edit schema, afin douvrir lditeur du schma.
85
Composants Business
tSalesforceInput
Modifiez le schma comme ncessaire, en utilisant les boutons [+] et [x]. Ajoutez une nouvelle colonne pour les champs extraits de la colonne Name du module Account. Appelez cette colonne Opportunity_Account_Name. Cliquez sur OK afin de sauvegarder les modifications et fermer lditeur du schma. Double-cliquez sur le tSalesforceInput_2 afin de dfinir ses Basic settings dans la vue Component.
Dans la liste Property Type, slectionnez Built-In. Dans le champ Salesforce WebService URL, saisissez lURL de la base de donnes laquelle vous souhaitez vous connecter. Saisissez vos informations dauthentification dans les champs Username pour lidentifiant et Password pour le mot de passe. Saisissez la limite de temps que vous souhaitez appliquer sur la requte, dans le champ Timeout (milliseconds).
86
Composants Business
tSalesforceInput
Slectionnez le Module (objet Salesforce) que vous souhaitez interroger. Cochez la case Manual input of SOQL Query pour saisir votre requte dans le champ Query. Saisissez votre requte ou votre requte relationnelle, en respectant la syntaxe SOQL requise. Dans cet exemple, lobjectif est dextraire les champs Id et CaseNumber du module Case, ainsi que les champs Name du module Account. La requte est donc : SELECT Id, CaseNumber, Account.Name FROM Case. Slectionnez Built-In dans la liste Schema et cliquez sur le bouton [...] ct du champ Edit schema, afin douvrir lditeur du schma.
Modifiez le schma comme ncessaire, en utilisant les boutons [+] et [x]. Ajouter une nouvelle colonne pour les champs extraits de la colonne Name du module Account. Nommez cette colonne Case_Account_Name. Cliquez sur OK pour sauvegarder les modifications et fermer lditeur du schma. Cliquez sur chaque composant tLogRow afin de dfinir leurs Basic settings comme ncessaire. Dans cet exemple, vous navez pas besoin de modifier les paramtres des tLogRow. Appuyez sur F6 pour excuter le Job. Les rsultats sont affichs dans la console de la vue Run :
87
Composants Business
tSalesforceInput
88
Composants Business
tSalesforceOutput
tSalesforceOutput
Proprits du tSalesforceOutput
Le composant tSalesforceOutput crit dans un objet de la base de donnes Salesforce via le service Web adquat. Ce composant permet dcrire des donnes dans une base de donnes Salesforce. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant connexion de base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section Proprits du tSalesforceConnection, page 73. Lorsquun Job contient le Job parent et le Job enfant, la liste Component list prsente uniquement les composants de connexion du mme niveau de Job. Si vous souhaitez utiliser une connexion existant dans un autre niveau de Job, vous pouvez utiliser longlet Dynamic settings, afin de partager la connexion en question. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct. Pour plus dinformation concernant longlet Dynamic settings, consultez le Guide Utilisateur de votre Studio. Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Saisissez les informations dauthentification de lutilisateur au service Web.
89
Composants Business
tSalesforceOutput
Timeout (milliseconds) Action
Saisissez le dlai avant suspension de la requte sur Salesforce.com. Vous pouvez effectuer lune des oprations suivantes sur les donnes de lobjet Salesforce : Insert : insrer les donnes. Update : mettre les donnes jour. Delete : supprimer les donnes. Upsert : mettre jour et insrer les donnes. Slectionnez lobjet adquat dans la liste. Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Cette case est coche par dfaut. Elle permet de transfrer les donnes de sortie en lot. Dans le champ Rows to commit, spcifiez le nombre de lignes par lot. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject. Renseignez ce champ si vous souhaitez crer un fichier contenant les logs derreur. Pour cela, cliquez sur le bouton [...] cot de ce champ pour dfinir le chemin daccs et le nom du fichier Cochez cette case si vous souhaitez utiliser un proxy. Une fois la case coche, vous devez saisir les paramtres de connexion dans les champs qui apparaissent, lhte, le port, le nom dutilisateur et le mot de passe du proxy que vous souhaitez utiliser. Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance.
Module
Advanced settings
Extended Output
Die on error
Error logging file
Use Socks Proxy
90
Composants Business
tSalesforceOutput
Retrieve inserted ID
Cochez cette case afin de permettre Salesforce.com de retourner lID Salesforce produit pour une nouvelle ligne devant tre insre. La colonne ID est ajoute au schma des donnes traites dans Salesforce.com. Cette option est disponible uniquement si vous avez slectionn laction Insert, mais non en mode batch, cest--dire sans loption Extended Output.
Scnario : Supprimer des donnes de lobjet Account

Ce scnario dcrit un Job deux composants permettant de supprimer une entre de lobjet Account.
Cliquez et dposez les composants tSalesforceInput et tSalesforceOutput de la Palette dans le Job Designer. Reliez-les via un lien de type Row > Main. Double-cliquez sur le composant tSalesforceInput pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
91
Composants Business
tSalesforceOutput
Dans la liste Property Type, slectionnez Repository si vous avez stock la connexion au serveur Salesforce dans les mtadonnes du Repository. Les autres champs seront renseigns automatiquement. Si vous navez pas stock la connexion dans les mtadonnes, slectionnez Built-in dans la liste et renseignez les champs manuellement. Dans le champ Salesforce WebService URL, laissez lURL du service Web Salesforce par dfaut ou saisissez lURL laquelle vous souhaitez accder. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au service Web. Dans la liste Module, slectionnez lobjet auquel vous souhaitez accder. Dans ce scnario, lobjectif est daccder lobjet Account. Dans la liste Schema, slectionnez Repository puis cliquez sur le bouton [...] pour slectionner le schma du repository que vous souhaitez utiliser pour le composant. Si vous navez pas enregistr le schma dans les mtadonnes du repository, slectionnez Built-in dans la liste Schema et cliquez sur le bouton [...] cot du champ Edit schema et paramtrer le schma manuellement. Dans le champ Query Condition, saisissez la requte que vous souhaitez appliquer. Pour ce scnario, lobjectif est de rcuprer le ou les clients dont le nom est sForce., ainsi, saisissez la requte : name=sForce. Pour une requte plus avance, cochez la case Manual input of SOQL query et saisissez-la manuellement. Double-cliquez sur le composant tSalesforceOutput pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
Dans le champ Salesforce WebService URL, laissez lURL du service Web Salesforce par dfaut ou saisissez lURL laquelle vous souhaitez accder. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au service Web. Dans la liste Action, slectionnez laction que vous souhaitez effectuer. Ici, slectionnez Delete pour supprimer le compte sForce slectionn dans le composant prcdent. Dans la liste Module, slectionnez lobjet auquel vous souhaitez accder. Dans ce scnario, lobjectif est daccder lobjet Account. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Enregistrez le Job et appuyez sur F6 pour lexcuter. Consultez le contenu de lobjet Account et vrifiez que le compte sForce a t supprim du serveur.
Composants Business
tSalesforceOutputBulk
Les composants tSalesforceOutputBulk et tSalesforceBulkExec sont gnralement utiliss ensemble pour gnrer en sortie le fichier dfini et excuter ensuite les actions souhaites sur votre fichier, dans votre Salesforce.com. Cette excution en deux tapes est unifie dans le composant tSalesforceOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le changement des donnes dans la base de donnes.
Proprits du tSalesforceOutputBulk
Le composant tSalesforceOutputBulk gnre des fichiers dans un format appropri au traitement de masse. Ce composant prpare le fichier devant tre trait par le tSalesForceBulkExec afin dexcuter des actions sur Salesforce.com. File Name Append Schema et Edit Schema Parcourez le rpertoire o stocker les fichiers gnrs. Cochez cette case afin dcrire la suite des donnes existantes. Sinon, les donnes seront crases. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent.
Advanced settings Utilisation
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est utilis avec le tSalesforceBulkExec. Ils permettent doptimiser les performances dalimentation ou de modification des informations sur Salesforce.com. n/a
Limitation
Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com

Ce scnario dcrit un Job six composants qui transforme des donnes .csv appropries un traitement de masse, les charge dans Salesforce.com et affiche ensuite les rsultats de lexcution du Job dans la console.
93
Composants Business
Ce Job est ralis en deux tapes : prparer les donnes en les transformant, puis traiter les donnes transformes. Avant de commencer ce scnario, vous devez prparer le fichier original comprenant les donnes devant tre traites par le Job. Dans cet exemple dutilisation, le fichier est sforcebulk.txt, il contient des informations relatives aux clients. Afin de crer et excuter ce Job, procdez comme suit : Glissez-dposez de la Palette dans lespace de modlisation graphique les composants tFileInputDelimited, tMap, tSalesforceOutputBulk, tSalesforceBulkExec et deux tLogRow. Utilisez un lien Row > Main afin de connecter le tFileInputDelimited au tMap, et le lien Row > out1 du tMap au tSalesforceOutputBulk. Utilisez un lien Row > Main et un lien Row > Reject pour connecter le tSalesforceBulkExec aux deux tLogRow respectivement. Utilisez un lien Trigger > OnSubjobOk afin de connecter le composant tFileInputDelimited au tSalesforceBulkExec. Double-cliquez sur le tFileInputDelimited afin dafficher sa vue Component et dfinir ses proprits.
94
Composants Business
Dans la liste Property Type, slectionnez Repository si vous avez dj stock votre connexion Salesforce sous le noeud Metadata dans la vue Repository. Les proprits sont automatiquement remplies. Si vous navez pas dfini le serveur de connexion localement dans le Repository, renseignez les informations manuellement, aprs avoir slectionn Built-in dans la liste Property Type. Pour plus dinformations propos des mtadonnes, consultez le chapitre Gestion des mtadonnes. A ct du champ File name/Stream, cliquez sur le bouton afin de parcourir votre rpertoire jusqu votre fichier, dans cet exemple sforcebulk.txt. Dans la liste Schema, slectionnez Repository, puis cliquez sur le bouton [...] afin douvrir la bote de dialogue dans laquelle vous pourrez slectionner le schma du Repository utiliser pour ce composant. Si vous navez pas dfini localement votre fichier dans les mtadonnes, slectionnez Built-in dans la liste Schema, puis cliquez sur le bouton [...] ct du champ Edit schema, afin douvrir une bote de dialogue dans laquelle vous pourrez dfinir le schma manuellement. Dans ce scnario, le schma se compose de quatre colonnes : Name, ParentId, Phone et Fax.
Selon votre fichier dentre, paramtrez les autres champs, comme Row Separator, Field Separator... Double-cliquez sur le composant tMap afin douvrir son diteur et dfinir la transformation. Glissez-dposez toutes les colonnes de la table dentre dans la table de sortie.
95
Composants Business
Ajoutez .toUpperCase() la fin de la colonne Name. Cliquez sur OK afin de valider la transformation. Double-cliquez sur le tSalesforceOutputBulk afin dafficher sa vue Component et dfinir ses proprits.
Dans le champ File Name, parcourez votre rpertoire jusqu lemplacement o vous souhaitez stocker les donnes .csv gnres pour un traitement de masse. Cliquez sur le bouton Sync columns afin dimporter le schma du composant prcdent. Double-cliquez sur le tSalesforceBulkExect afin dafficher sa vue Component et dfinir ses proprits.
Utilisez lURL par dfaut du service Web Salesforce, ou saisissez lURL laquelle vous souhaitez accder. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au service Web.
96
Composants Business
Dans le champ Bulk file path, parcourez votre rpertoire jusqu lemplacement o est stock le fichier .csv gnr par le tSalesforceOutputBulk. Dans la liste Action, slectionnez laction que vous voulez effectuer sur les donnes de masse. Dans cet exemple, slectionnez insert. Dans la liste Module, slectionnez llment auquel vous souhaitez accder, Account dans cet exemple. Dans la liste Schema, slectionnez Repository et cliquez sur le bouton [...] afin douvrir une bote de dialogue dans laquelle vous pourrez slectionner le schma du Repository utiliser pour ce composant. Si vous navez pas dfini votre schma localement dans les mtadonnes, slectionnez Built-in dans la liste Schema, puis cliquez sur le bouton [...] ct du champ Edit schema, afin douvrir une bote de dialogue dans laquelle vous pourrez dfinir votre schma manuellement. Dans cet exemple, dfinissez-le comme le schma prcdent. Double-cliquez sur le tLogRow_1 afin dafficher sa vue Component et dfinir ses proprits.
Cliquez sur le bouton Sync columns afin de rcuprer le schma du composant prcdent. Slectionnez le mode Table afin dafficher les rsultats dexcution dans un tableau. Rptez lopration avec le tLogRow_2. Sauvegardez votre Job, et appuyez sur F6 pour lexcuter. Dans la console de la vue Run, vous pouvez vrifier les rsultats dexcution.
97
Composants Business
Dans le tableau du tLogRow_1, vous pouvez lire les donnes insres dans votre Salesforce.com. Dans le tableau du tLogRow_2, vous pouvez lire les donnes rejetes cause dune incompatibilit avec les lments Account auxquels vous avez accd. Tous les noms de clients sont crits en majuscules.
98
Composants Business
tSalesforceOutputBulkExec
Les composants tSalesforceOutputBulk et tSalesforceBulkExec sont gnralement utiliss ensemble pour gnrer en sortie le fichier dfini et excuter ensuite les actions souhaites sur votre fichier, dans votre Salesforce.com. Cette excution en deux tapes est unifie dans le composant tSalesforceOutputBulkExec. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le changement des donnes dans la base de donnes.
Proprits du tSalesforceOutputBulkExec
Fonction Objectif
Le composant tSalesforceOutputBulkExec excute les actions dfinies sur les donnes .csv pour Salesforce.com. En tant que composant ddi, le tSalesforceOutpuBulkExec permet doptimiser les performances lors des oprations dfinies sur les donnes, dans votre Salesforce.com. Use an existing connection Cochez cette case pour utiliser une connexion tablie partir du tSalesforceConnection. Une fois coche, la liste Component List apparat, et vous permet de slectionner le composant tSalesforceConnection devant tre utilis. Pour plus dinformations, consultez la section Proprits du tSalesforceConnection, page 73. Lorsquun Job contient le Job parent et le Job enfant, la liste Component list prsente uniquement les composants de connexion du mme niveau de Job. Si vous souhaitez utiliser une connexion existant dans un autre niveau de Job, vous pouvez utiliser longlet Dynamic settings, afin de partager la connexion en question. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct. Pour plus dinformation concernant longlet Dynamic settings, consultez le Guide Utilisateur de votre Studio. Salesforce Webservice Saisissez lURL du service Web permettant de se URL connecter la base de donnes Salesforce. Username et Password Salesforce Version Bulk file path Action Saisissez les informations dauthentification de lutilisateur au service Web. Saisissez la version de Salesforce que vous utilisez. Chemin daccs au rpertoire o sont stockes les donnes de masse traiter. Vous pouvez effectuer lune des oprations suivantes sur les donnes de lobjet Salesforce : Insert : insrer les donnes. Update : mettre les donnes jour. Upsert : mettre jour et insrer les donnes.
Basic settings
99
Composants Business
Module
Slectionnez lobjet adquat dans la liste. Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Saisissez le nombre de lignes devant tre traites par lot de donnes. Saisissez le nombre doctets par lot de donnes devant tre traits. Cochez cette case si vous souhaitez utiliser un proxy. Dans ce cas, vous devez renseigner les paramtres du proxy dans les champs qui apparaissent, une fois la case coche.
Advanced settings
Rows to commit Bytes to commit Use Socks Proxy
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est utilis comme composant de sortie. Il ncessite un composant dentre. Les donnes de masse traiter dans Salesforce.com doivent tre au format .csv
Scnario : Insrer des donnes de masse dans votre Salesforce.com

Ce scnario dcrit un Job quatre composants qui charge des donnes en masse dans Salesforce.com, excute les actions dfinies, et affiche les rsultats dexcution du Job dans la console.
100
Composants Business
Avant de raliser ce Job, vous devez prparer votre fichier dentre, contenant les donnes devant tre traites par le Job. De cet exemple, le fichier sforcebulk.txt, contient des informations relatives aux clients. Afin de crer et excuter le Job, procdez comme suit : Glissez-dposez de la Palette dans lespace de modlisation graphique un composant tFileInputDelimited, un tSalesforceOutputBulkExec, et deux tLogRow. Utilisez un lien Row > Main pour connecter le tFileInputDelimited au tSalesforceOutputBulkExec. Utilisez un lien Row > Main et un lien Row > Reject afin de connecter le tSalesforceOutputBulkExec aux deux tLogRow respectifs. Double-cliquez sur le tFileInputDelimited afin dafficher sa vue Component et dfinir ses proprits.
Dans la liste Property Type, slectionnez Repository si vous avez dj stock votre connexion au serveur Salesforce dans le noeud Metadata de la vue Repository. Les proprits sont automatiquement renseignes. Si vous navez pas dfini la connexion au serveur localement dans le Repository, remplissezl es champs manuellement, aprs avoir slectionn Built-in dans la liste Property Type. Pour plus dinformations concernant les mtadonnes, consultez le chapitre Gestion des mtadonnes. A ct du champ File name/Stream, cliquez sur le bouton fichier dentre, par exemple sforcebulk.txt. afin de slectionner votre
Dans la liste Schema, slectionnez Repository, puis cliquez sur le bouton [...] pour ouvrir une bote de dialogue dans laquelle vous pourrez slectionner le schma utiliser pour ce composant. Si vous navez pas dfini votre schma localement dans les mtadonnes, slectionnez Built-in dans la liste Schema, puis cliquez sur le bouton [...] ct du champ Edit schema, afin douvrir une bote de dialogue o vous pourrez dfinir le schma manuellement. dans ce scnario, le schma se compose de quatre colonnes : Name, ParentId, Phone et Fax.
101
Composants Business
Configurez les autres proprits selon votre fichier dentre, comme Row Separator, Field Separator... Double-cliquez sur le composant tSalesforceOutputBulkExec afin dafficher sa vue Component et dfinir ses proprits.
Dans le champ Salesforce WebService URL, utilisez lURL par dfaut du service Web Salesforce, ou saisissez lURL laquelle vous souhaitez accder. Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au service Web. Dans le champ Bulk file path, parcourez votre rpertoire jusqu lemplacement o vous stockez les donnes .csv devant tre traites.
Le fichier de masse traiter doit tre au format .csv.
Dans la liste Action, slectionnez laction effectuer sur les donnes de masse, insert dans cet exemple. Dans la liste Module, slectionnez llement auquel vous souhaitez accder, Account dans cet exemple. Dans la liste Schema, slectionnez Repository, puis cliquez sur le bouton [...] afin douvrir une bote de dialogue dans laquelle vous pourrez slectionner le schma du Repository utiliser pour ce composant. Si vous navez pas dfini votre schma localement dans les mtadonnes, slectionnez Built-in dans la liste Schema, puis cliquez sur le bouton [...] ct du champ Edit schema afin douvrir une bote de dialogue o vous pourrez dfinir manuellement le schma. Dans cet exemple, dfinissez le schma comme prcdemment. Double-cliquez sur le tLogRow_1 afin dafficher sa vue Component et dfinir ses proprits.
102
Composants Business
Cliquez sur le bouton Sync columns afin de rcuprer le schma du composant prcdent. Slectionnez le mode Table afin dafficher les rsultats dexcution dans un tableau. Rptez lopration pour le tLogRow_2. Sauvegardez votre Job et appuyez sur F6 afin de lexcuter. Dans la console de la vue Run, vous pouvez vrifier les rsultats dexcution.
Dans le tableau du tLogRow_1, vous pouvez lire les donnes insres dans Salesforce.com. Dans le tableau du tLogRow_2, vous pouvez lire les donnes rejetes cause dune incompatibilit avec les lments Account auxquels vous avez accd. Si vous souhaitez transformer les donnes dentre avant de les charger, vous devez utiliser un tSalesforceOutputBulk et un tSalesforceBulkExec pour raliser le Job complet. Pour plus dinformations propos de lutilisation de ces deux composants, consultez Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com, page 93.
103
Composants Business
tSAPCommit
tSAPCommit
Proprits du tSAPCommit
Ce composant est troitement li aux composants tSAPConnection et tSAPRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Business/SAP
Fonction Objectif
Valide les donnes traites dans un Job, via un serveur connect. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. SAPConnection Component list Release Connection Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tSAPConnection dans la liste. Cette case est slectionne par dfaut. Elle vous permet de fermer une connexion une base de donnes, une fois le commit effectu; Dcochez cette case afin de continuer utiliser la connexion slectionne, une fois que le composan a excut sa tche. Si vous utilisez un lien Row > Main pour relier le tSAPCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Release connection, ou votre connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants SAP et notamment avec les composants tSAPConnection et tSAPRollback.. n/a
Scnario associ
Ce composant est troitement li aux composants tSAPConnection et tSAPRollback. Ils sont gnralement utiliss ensemble lors de transactions, avec un tSAPConnection permettant douvrir une connexion pour la transaction en cours. Pour un scnario associ au tSAPCommit, consultez tMysqlConnection page 630.
104
Composants Business
tSAPConnection
tSAPConnection
Proprits du tSAPConnection
Le composant tSAPConnection ouvre une connexion vers un systme SAP afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers un systme SAP. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Connection configuration Client type : Saisissez votre code de connexion SAP habituel. Userid : Saisissez lidentifiant de connexion utilisateur. Password : Saisissez le mot de passe. Language : Spcifiez la langue. Host name : Saisissez ladresse IP du systme SAP. System number : Saisissez le numro du systme.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec les composants SAP. n/a
Scnario associ
Pour un scnario associ, consultez les Scnario 1 : Rcuprer les mtadonnes dun systme SAP, page 108.
105
Composants Business
tSAPInput
tSAPInput
Proprits du tSAPInput
Le composant tSAPInput se connecte un systme SAP via ladresse IP du systme. Il permet dextraire des donnes dun systme SAP nimporte quel niveau en faisant appel des fonctions RFC ou BAPI. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant connexion de base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient le Job parent et le Job enfant, la liste Component list prsente uniquement les composants de connexion du mme niveau de Job. Si vous souhaitez utiliser une connexion existant dans un autre niveau de Job, vous pouvez utiliser longlet Dynamic settings, afin de partager la connexion en question. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct. Pour plus dinformation concernant longlet Dynamic settings, consultez le Guide Utilisateur de votre Studio. Connection configuration Client : Saisissez votre code de connexion SAP habituel. Userid : Saisissez lidentifiant de connexion utilisateur. Password : Saisissez le mot de passe. Language : Spcifiez la langue. Host name : Saisissez ladresse IP du systme SAP. System number : Saisissez le numro du systme.
106
Composants Business
tSAPInput
FunName Initialize input
Saisissez le nom de la fonction que vous souhaitez utiliser pour rcuprer les donnes. Configurez les paramtres dentre. Parameter Value : Saisissez entre guillemets les valeurs correspondant au paramtre dfini dans la colonne Parameter Name. Type : Slectionnez le type dentre rcuprer. Table Name (Structure Name) : Saisissez entre guillemets le nom de la table. Parameter Name : Saisissez entre guillemets le nom du champ correspondant la table dfinie dans la colonne Table Name. Lorsque plusieurs valeurs de paramtres utilisent le mme nom de paramtre, vous devez saisir ces valeurs dans une seule ligne et les sparer par des virgules.
Outputs
Configurez les paramtres des schmas transmettre en sortie. Schema : Saisissez le nom du schma transmettre en sortie. Type (for iterate) : Slectionnez le type de sortie que vous souhaitez obtenir. Table Name (Structure Name) : Saisissez entre guillemets le nom de la table. Mapping : Saisissez entre guillemets le nom des champs dont vous souhaitez rcuprer les donnes. Vous pouvez dfinir autant de liens de sortie Main pour crire des donnes que de schmas ajouts au tableau Outputs. Ainsi, les donnes peuvent tre groupes dans diffrents fichiers.
Connections
Liens de sortie (dun composant un autre) : Row : Main, Iterate. Trigger : RunIf, OnComponentOk; OnComponentError, OnSubjobOk, OnSubjobError. Liens dentre (dun composant un autre) : Row : Iterate Trigger : Runif, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Advanced settings
Release Connection
Dcochez cette case afin de continuer utiliser la connexion slectionne, une fois que le composant a excut sa tche.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
107
Composants Business
tSAPInput
Ce composant est gnralement utilis en tant que composant de dbut et requiert un composant de sortie. n/a
Scnario 1 : Rcuprer les mtadonnes dun systme SAP

Les composants SAP (tSAPInput et tSAPOutput) ainsi que lassistant SAP sont bass sur des bibliothques valides et fournies par SAP (JCO) permettant lutilisateur dappeler les fonctions RFC ou BAPI et de rcuprer les donnes du systme SAP au niveau des tables, RFC ou BAPI.
Ce scnario utilise lassistant SAP guidant lutilisateur travers les diffrentes tapes de cration de connexions SAP et des fonctions RFC et BAPI. Lassistant SAP est uniquement disponible pour les utilisateurs Talend Integration Suite. Si vous tes utilisateur de Talend Open Studio ou Talend On Demand, vous devez configurer les proprits du composant tSAPInput manuellement.
Ce scnario Java utilise un assistant SAP pour crer une connexion au systme SAP, appelle une fonction BAPI pour rcuprer les informations dune entreprise stockes dans le systme SAP et les affiche dans Talend Open Studio. Les figures ci-dessous affichent les paramtres du systme SAP permettant daccder aux informations sur lentreprise que vous souhaitez lire dans Talend Open Studio laide du composant tSAPInput.
108
Composants Business
tSAPInput
Crez une connexion au systme SAP laide de lassistant SAP. Dans ce scnario, la connexion SAP est appele sap. Appelez la fonction BAPI appele BAPI_COMPANY_GETDETAIL laide de lassistant SAP pour accder au document html BAPI stock dans le systme SAP et consultez les informations sur lentreprise. Dans le champ Name filter, saisissez BAPI* et cliquez sur le bouton Search pour afficher toutes les fonctions BAPI disponibles. Slectionnez BAPI_COMPANY_GETDETAIL pour afficher le schma dcrivant les informations de lentreprise. La vue droite de lassistant affiche les mtadonnes de la fonction BAPI_COMPANY_GETDETAIL et vous permet de configurer les paramtres ncessaires. La vue Document affiche le document HTML SAP de la fonction BAPI_COMPANY_GETDETAIL.
109
Composants Business
tSAPInput
La vue Parameter fournit les informations sur les paramtres dentre et de sortie ncessaire la fonction BAPI_COMPANY_GETDETAIL pour retourner les valeurs. Dans la vue Parameter, cliquez sur longlet Input pour lister le ou les paramtre(s) dentre. Dans ce scnario, il ny a quun seul paramtre dentre requis par la fonction BAPI_COMPANY_GETDETAIL. Ce paramtre sappelle COMPANYID.
Dans la vue Parameter, cliquez sur longlet Output pour lister les paramtres de sortie retourns par la fonction BAPI_COMPANY_GETDETAIL. Dans ce scnario, il y a deux paramtres de sortie : COMPANY_DETAIL et RETURN.
Chacun des paramtres de structure est compos de nombreux paramtres single.
110
Composants Business
tSAPInput
La vue Test it permet dajouter ou de supprimer des paramtres dentre en fonction de la fonction appele. Dans ce scnario, lobjectif est de rcuprer les mtadonnes du paramtre structure appel COMPANY_DETAIL qui est compos de 14 paramtres single.
Dans la colonne Value de la ligne COMPANYID du premier tableau, saisissez 000001 afin de retourner les donnes correspondant lentreprise dont lidentifiant est 000001. Dans la liste Output type en bas de lassistant, slectionnez output.table. Cliquez sur Launch en bas de la vue pour afficher la valeur de chaque paramtre single retourn par la fonction BAPI_COMPANY_GETDETAIL. Cliquez sur Finish pour fermer lassistant et crer la connexion. La connexion sap et la fonction BAPI_COMPANY_GETDETAIL apparaissent sous le noeud SAP Connections du Repository. Pour rcuprer les diffrents schmas de la fonction BAPI_COMPANY_GETDETAIL : Cliquez-droit sur BAPI_COMPANY_GETDETAIL dans le Repository. Slectionnez Retrieve schema dans le menu. Dans lassistant qui souvre, slectionnez les schmas que vous souhaitez rcuprer. Ici, slectionnez les deux schmas : COMPANY_DETAIL et RETURN. Cliquez sur Next pour afficher ces diffrents schmas. Cliquez sur Finish. Les deux schmas apparaissent sous la fonction BAPI_COMPANY_GETDETAIL dans le Repository.
Composants Business
tSAPInput
Dans ce scnario, lobjectif est de rcuprer les donnes correspondant lentreprise dont lidentifiant est 000001 pour les afficher dans Talend Open Studio : Dans le Repository, slectionnez la connexion SAP que vous venez de crer et glissez-la dans lespace de modlisation, slectionnez tSAPConnection dans la liste de composants et cliquez sur OK. Le composant tSAPConnection portant le nom de votre connexion, sap, sera ajout votre Job et ouvrira une connexion SAP. Double-cliquez sur le tSAPConnection pour afficher la vue Component :
Si vous avez utiliser les mtadonnes pour crer le composant, le mode Repository est slectionn dans la liste Property Type et les champs suivants sont automatiquement renseigns. Si vous nutilisez pas les mtadonnes, slectionnez le mode Built-In et renseignez les champs suivants manuellement. Dans le Repository, slectionnez le schma BAPI_COMPANY_GETDETAIL dans le dossier sap, et glissez-le dans lespace de modlisation, slectionnez tSAPInput dans la liste de composants et cliquez sur OK. Cliquez et dposez les composants tFilterColumns et tLogRow dans lespace de modlisation. Connectez le tSAPConnection au tSAPInput via un lien Trigger > OnSubJobOk. Pour connecter le tSAPInput au tLogRow, cliquez-droit sur le tSAPInput, slectionnez Row puis row_COMPANY_DETAIL_1 dans le menu et cliquez sur le composant tLogRow.
112
Composants Business
tSAPInput
Dans lespace de modlisation, slectionnez le composant tSAPInput et cliquez sur la vue Component pour afficher ses proprits. Les proprits du composant tSAPInput apparaissent automatiquement puisque le schma est stock dans le dossier Metadata et que le composant est initialis par lassistant SAP.
Dans la vue Component, cochez la case Use an existing connection et slectionnez le composant tSAPConnection dans la liste Component list pour utiliser la connexion ouverte par le composant de connexion. Dans la zone Initialize input, vous pouvez voir les paramtres dentre ncessaires la fonction BAPI_COMPANY_GETDETAIL. Dans la zone Outputs, vous pouvez voir les diffrents schmas de la fonction BAPI_COMPANY_GETDETAIL, notamment le schma COMPANY_DETAIL que vous rcuprez en sortie. Dans lespace de modlisation, slectionnez le composant tLogRow et cliquez sur la vue Component pour paramtrer ses proprits. Pour plus dinformations, consultez tLogRow page 1399 Enregistrez le Job et appuyez sur F6 pour lexcuter.
113
Composants Business
tSAPInput
Le composant tSAPInput rcupre du systme SAP les mtadonnes du paramtre COMPANY_DETAIL de type structure et le composant tLogRow affiche les informations dans la console.
Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE

Les composants SAP (tSAPInput et tSAPOutput) ainsi que lassistant SAP sont bass sur des bibliothques valides et fournies par SAP (JCO) permettant lutilisateur dappeler les fonctions RFC ou BAPI et de rcuprer les donnes du systme SAP au niveau des tables, RFC ou BAPI.
Ce scnario utilise lassistant SAP guidant lutilisateur travers les diffrentes tapes de cration de connexions SAP et des fonctions RFC et BAPI. Lassistant SAP est uniquement disponible pour les utilisateurs Talend Integration Suite. Si vous tes utilisateur de Talend Open Studio ou Talend On Demand, vous devez configurer les proprits du composant tSAPInput manuellement.
Ce scnario Java utilise lassistant SAP pour crer une connexion au systme SAP et pour appeler une fonction RFC permettant de lire directement dans une table appele SFLIGHT partir du systme SAP. Puis, il affiche dans Talend Open Studio les diffrentes structures de la table SFLIGHT stocke dans le systme SAP. Crez une connexion au systme SAP laide de lassistant SAP. Dans ce scnario, la connexion SAP est appele sap. Appelez la fonction RFC appele RFC_READ_TABLE laide de lassistant SAP pour accder la table du systme SAP et pour visualiser sa structure. Dans le champ Name filter, saisissez RFC* et cliquez sur le bouton Search pour afficher toutes les fonctions RFC disponibles.
114
Composants Business
tSAPInput
Slectionnez RFC_READ_TABLE pour afficher les schmas de cette fonction. La vue droite de lassistant affiche les mtadonnes de la fonction RFC_READ_TABLE et permet de dfinir les paramtres ncessaires. Longlet Document affiche le document html SAP de la fonction RFC_READ_TABLE. Longlet Parameter fournit les informations sur les paramtres requis par la fonction RFC_READ_TABLE pour pouvoir retourner les valeurs des paramtres. Dans la vue Parameter, cliquez sur longlet Table pour obtenir une description de la structure des diffrentes tables de la fonction RFC_READ_TABLE.
115
Composants Business
tSAPInput
La vue Test it vous permet dajouter ou de supprimer des paramtres dentre en fonction de la fonction appele. Dans ce scnario, lobjectif est de rcuprer les diffrentes structures de la table SFLIGHT.
Dans la colonne Value de la ligne DELIMITER du premier tableau, saisissez ; comme sparateur de champ. Dans la colonne Value de la ligne QUERY_TABLE, saisissez SFLIGHT comme table requter. Dans la liste Output type en bas de lassistant, slectionnez output.table. Dans la liste Constructure|Table, slectionnez DATA.
116
Composants Business
tSAPInput
Cliquez sur Launch en bas de la vue pour afficher les valeurs de paramtres retournes par la fonction RFC_READ_TABLE. Dans ce scnario, le dlimiteur est ; et la table lire est SFLIGHT. Cliquez sur Finish pour fermer lassistant et crer la connexion. La connexion sap et la fonction RFC_READ_TABLE apparaissent sous le noeud SAP Connections du Repository. Pour rcuprer les diffrents schmas de la fonction RFC_READ_TABLE : Cliquez-droit sur RFC_READ_TABLE dans le Repository, et slectionnez Retrieve schema dans le menu. Dans lassistant qui souvre, slectionnez les schmas que vous souhaitez rcuprer. Ici, slectionnez les trois schmas : DATA, FIELDS et OPTIONS. Cliquez sur Next pour afficher ces diffrents schmas. Cliquez sur Finish. Les trois schmas apparaissent sous la fonction RFC_READ_TABLE dans le Repository.
Dans ce scnario, lobjectif est de rcuprer les donnes et le nom des colonnes de la table SFLIGHT pour les rcuprer et les afficher dans Talend Open Studio. Ainsi, intressez-vous uniquement au schma DATA et FIELDS : Dans le Repository, slectionnez la fonction RFC_READ_TABLE de la connexion sap et glissez-la dans lespace de modlisation, slectionnez tSAPInput dans la liste de composants et cliquez sur OK. Cliquez et dposez deux composants tLogRow dans lespace de modlisation. Pour connecter les composants entre eux : Cliquez-droit sur le tSAPInput, slectionnez Row puis row_DATA_1 dans le menu et cliquez sur le premier composant tLogRow. Cliquez-droit sur le tSAPInput, slectionnez Row puis row_FIELDS_1 dans le menu et cliquez sur le deuxime composant tLogRow.
117
Composants Business
tSAPInput
Dans lespace de modlisation, double-cliquez sur tSAPInput pour afficher ses proprits dans la vue Component.
Les proprits du composant tSAPInput apparaissent automatiquement puisque le schma est stock dans le dossier Metadata et que le composant est initialis par lassistant SAP. Dans la zone Initialize input, vous pouvez voir les paramtres dentre ncessaires pour la fonction RFC_READ_TABLE, savoir le sparateur de champ ; et le nom de la table SFLIGHT. Dans la zone Outputs, vous pouvez voir les diffrents schmas de la table SFLIGHT, notamment FIELDS et DATA qui sont chacun dirigs vers des flux de sortie diffrents.
118
Composants Business
tSAPInput
Dans lespace de modlisation, slectionnez les composants tLogRow et cliquez sur la vue Component pour paramtrer leurs proprits. Pour plus dinformations, consultez tLogRow page 1399 Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Le composant tSAPInput rcupre le nom des colonnes de la table SFLIGHT et les donnes correspondantes partir du systme SAP et les composants tLogRow les affichent sous forme de table dans la console.
119
Composants Business
tSAPOutput
tSAPOutput
Proprits du tSAPOutput
Le composant tSAPOutput crit dans un systme SAP. Il permet dcrire des donnes dans un systme SAP. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant connexion de base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient le Job parent et le Job enfant, la liste Component list prsente uniquement les composants de connexion du mme niveau de Job. Si vous souhaitez utiliser une connexion existant dans un autre niveau de Job, vous pouvez utiliser longlet Dynamic settings, afin de partager la connexion en question. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct. Pour plus dinformation concernant longlet Dynamic settings, consultez le Guide Utilisateur de votre Studio. Connection configuration Client type : Saisissez votre code de connexion SAP habituel. Userid : Saisissez lidentifiant de connexion utilisateur. Password : Saisissez le mot de passe. Language : Spcifiez la langue. Host name : Saisissez ladresse IP du systme SAP. System number : Saisissez le numro du systme.
120
Composants Business
tSAPOutput
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous effectuez des modifications, le schma passera automatiquement en built-in. Saisissez le nom de la fonction que vous souhaitez utiliser pour rcuprer les donnes. Configurez les paramtres afin de slectionner les donnes crire dans le systme SAP. Dcochez cette case afin de continuer utiliser la connexion slectionne, une fois que le composant a excut sa tche.
FunName Mapping Advanced settings Release Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est gnralement utilis en tant que composant de sortie et requiert un composant dentre. n/a
Scnarios associs
Pour des scnarios associs, consultez les Scnario 1 : Rcuprer les mtadonnes dun systme SAP, page 108 et Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE, page 114.
121
Composants Business
tSAPRollback
tSAPRollback
Proprits du tSAPRollback
Ce composant est troitement li aux composants tSAPCommit et tSAPConnection. Ils sont gnralement utiliss ensemble lors de transactions..
Component family Business/SAP
Function Purpose Basic settings
tSAPRollback annule la transaction dans le SAP connect. tSAPRollback vite le commit de transaction involontaire. SAPConnection Component list Release Connection Slectionnez le composant de connexion tSAPConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case afin de continuer utiliser la connexion slectionne, une fois que le composan a excut sa tche.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants SAP et notamment avec les composants tSAPConnection et tSAPCommit. n/a
Scnario associ
Pour un scnario associ au tSAPRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674 du composant tMysqlRollback.
122
Composants Business
tSugarCRMInput
tSugarCRMInput
Proprits du tSugarCRMInput
Le tSugarCRMInput se connecte un module de la base de donnes SugarCRM via le service Web adquat. Le tSugarCRMInput permet dextraire les donnes dune base de donnes SugarCRM laide dune requte. SugarCRM Webservice URL Username et Password Module Saisissez lURL du service Web permettant de se connecter la base de donnes SugarCRM. Saisissez les informations dauthentification de lutilisateur au service Web. Slectionnez le module adquat dans la liste. Pour utiliser des tables personnalises, slectionnez Use custom module dans la liste . Les champs Custom module package name et Custom module name qui saffichent sont automatiquement remplis avec les noms correspondants. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn. Saisissez la requte permettant de slectionner les donnes extraire. Exemple : account_name= Talend
Query condition
Scnario: Extraire les donnes dun compte partir de SugarCRM

Ce scnario dcrit un Job deux composants visant extraire les informations dun compte partir dune base de donnes SugarCRM vers un fichier de sortie Excel.
123
Composants Business
tSugarCRMInput
A partir de la Palette, cliquez-dposez un composant tSugarCRMInput et un composant tFileOutputExcel. Connectez les composants dentre et de sortie laide dun lien de type Row Main. Dans la vue Component du tSugarCRMInput, remplissez les informations de connexion dans les champs SugarCRM Web Service URL, Username et Password. Slectionnez ensuite le module adquat parmi ceux proposs dans la liste Module. Dans cet exemple, cest Accounts qui est slectionn.
Le champ Schema est automatiquement renseign en fonction du module slectionn, mais il est possible de le modifier et de supprimer les colonnes dont vous navez pas besoin en sortie. Dans le champ Query Condition, saisissez la requte que vous voulez utiliser pour extraire les donnes du CRM. Dans cet exemple : billing_address_city=Sunnyvale Slectionnez ensuite le composant tFileOutputExcel.
Renseignez le nom du fichier de destination dans le champ File Name ainsi que le nom de la feuille de calcul dans le champ Sheet puis cochez la case Include header pour considrer les enttes. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
124
Composants Business
tSugarCRMInput
Les donnes filtres sont inscrites en sortie dans la feuille de calcul du fichier Excel spcifi.
125
Composants Business
tSugarCRMOutput
tSugarCRMOutput
Proprits du tSugarCRMOutput
Le composant tSugarCRMOutput crit dans un module de la base de donnes SugarCRM via le service Web adquat. Le tSugarCRMOutput permet dcrire des donnes dans une base de donnes SugarCRM. SugarCRM WebService URL Username et Password Module Saisissez lURL du service Web permettant de se connecter la base de donnes SugarCRM. Saisissez les informations dauthentification de lutilisateur au service Web. Slectionnez le module adquat dans la liste. Pour utiliser des tables personnalises, slectionnez Use custom module dans la liste . Les champs Custom module package name et Custom module name qui saffichent sont automatiquement remplis avec les noms correspondants. Vous pouvez effectuer lune des oprations suivantes sur les donnes du module SugarCRM : Insert : insrer les donnes. Update : mettre les donnes jour. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn.
Action
Scnario associ
126
Composants Business
tVtigerCRMInput
tVtigerCRMInput
Proprits du tVtigerCRMInput
Famille du composant Business/tVtigerCR M Le tVtigerCRMInput se connecte un module de la base de donnes vTigerCRM via le service Web adquat. Le tVtigerCRMInput permet dextraire les donnes dune base de donnes tVtigerCRM.
Fonction Objectif Basic settings Vtiger Version Vtiger 5.0
Slectionnez la version du Vtiger Web Services que vous souhaitez utiliser. Server Address Port Vtiger Path Username et Password Version Module Method Saisissez ladresse IP du serveur tVtigerCRM. Saisissez le numro de port daccs au serveur. Saisissez le chemin daccs au serveur Saisissez les informations dauthentification de lutilisateur au service Web. Renseignez la version de tVtigerCRM que vous utilisez. Slectionnez le module adquat dans la liste. Slectionnez la mthode adquate dans la liste. Cette mthode permet de dterminer laction appliquer au module tVtigerCRM slectionn. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn. Saisissez lURL du serveur Web invoqu. Saisissez le nom dutilisateur afin de vous connecter au vTigerCRM.. Saisissez la cl daccs pour le nom dutilisateur. Vous pouvez effectuer lune des oprations suivantes sur les donnes du module SugarCRM : Insert : insrer les donnes. Update : mettre les donnes jour. Slectionnez le module adquat dans la liste.
Vtiger 5.1
Endpoint Username Access key Action
Module
127
Composants Business
tVtigerCRMInput
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn. Saisissez la requte permettant de slectionner les donnes extraire. Cochez cette case pour saisir manuellement la requte que vous souhaitez effectuer dans le champ Query.
Query condition Manual input of SQL query Advanced settings Utilisation Limitation
Scnario associ
128
Composants Business
tVtigerCRMOutput
tVtigerCRMOutput
Proprits du tVtigerCRMOutput
Famille du composant Business/vTigerCRM
Fonction Objectif Basic settings Vtiger Version Vtiger 5.0
Le composant tVtigerCRMOutput crit dans un module de la base de donnes vTigerCRM via le service Web adquat. Le tVtigerCRMOutput permet dcrire des donnes dans une base de donnes tVtigerCRM.
Slectionnez la version du Vtiger Web Services que vous souhaitez utiliser. Server Address Port Vtiger Path Username et Password Version Module Method Saisissez ladresse IP du serveur tVtigerCRM. Saisissez le numro de port daccs au serveur. Saisissez le chemin daccs au serveur. Saisissez les informations dauthentification de lutilisateur au service Web. Renseignez la version de tVtigerCRM que vous utilisez. Slectionnez le module adquat dans la liste. Slectionnez la mthode adquate dans la liste. Cette mthode permet de dterminer laction appliquer au module tVtigerCRM slectionn. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn. Saisissez lURL du serveur Web invoqu. Saisissez le nom dutilisateur afin de vous connecter au vTigerCRM.. Saisissez la cl daccs pour le nom dutilisateur. Vous pouvez effectuer lune des oprations suivantes sur les donnes du module SugarCRM : Insert : insrer les donnes. Update : mettre les donnes jour. Slectionnez le module adquat dans la liste.
Vtiger 5.1
Endpoint Username Access key Action
Module
129
Composants Business
tVtigerCRMOutput
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in.. Pour ce composant, le schma dpend du Module slectionn. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur.
Die on error
Scnario associ
130
Composants Business Intelligence

Ce chapitre passe en revue les principaux composants prsents dans le groupe Business Intelligence de la Palette de Talend Open Studio. La famille BI regroupe tous les connecteurs couvrant des besoins tels que la lecture et lcriture de bases de donnes multidimensionnelles ou OLAP, la gnration de rapports Jasper, le suivi des modifications de bases de donnes laide de tables Slow Changing Dimension, etc.

tBarChart
tBarChart
Proprits du tBarChart
Famille du composant Business Intelligence/Charts Le composant tBarChart lit des donnes partir dun flux dentre et transforme les donnes en diagramme en barres dans un fichier image au format PNG. Le composant tBarChart gnre un diagramme en barres partir des donnes dentre afin de faciliter lanalyse technique. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Le schma du tBarChart contient trois colonnes en lecture seule nommes respectivement series (type String), category (type String), et value (type Integer), selon un ordre prdtermin. Les donnes de toutes les autres colonnes seront simplement passes au composant suivant, sil y en a un, mais elles ne seront pas prsentes dans le diagramme en barres. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Sync columns Permet de synchroniser le schma du fichier dentre avec le schma du fichier de sortie. La fonction Sync ne saffiche que lorsquune connexion de type Row est connecte au composant de sortie.
Fonction
Generated image path Nom et chemin daccs du fichier image de sortie. Chart title Include legend Saisissez le titre du diagramme en barres gnrer. Cochez cette case si vous souhaitez inclure une lgende votre diagramme en barres, afin dafficher toutes les sries (series) dans des couleurs diffrentes. Cochez cette case afin de crer une image en trois dimensions. Par dfaut, cette case est coche et les barres reprsentant les sries (series) de chaque catgorie (category) sont empiles les unes sur les autres. Si cette case est dcoche, une image en deux dimensions est cre, et les barres saffichent les unes ct des autres le long de laxe category.
3Dimensions
132

tBarChart
Image width et Image height
Saisissez la largeur et la hauteur du fichier image, exprimes en pixels.
Category axis name et Saisissez le nom de laxe category et le nom de laxe Value axis name value. Foreground alpha Saisissez un entier entre 0 et 100 afin de dfinir la transparence de limage. Plus ce nombre est petit, plus votre image sera transparente. Choisissez lorientation quaura votre diagramme en barres: VERTICAL ou HORIZONTAL.
Plot orientation Advanced settings Utilisation
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est un composant de sortie. Par consquent, il requiert un composant dentre ainsi quune connexion de type Row Main.
Scnario : Crer un diagramme en barres partir de donnes dentre

Ce scnario dcrit un Job simple qui lit les donnes dun fichier CSV et les transforme en diagramme en barres. Le fichier dentre est prsent ci-dessous :
Le fichier dentre ayant une structure diffrente de celle requise pour lutilisation dun tBarChart, un tMap sera utilis dans ce scnario, afin de mettre en correspondance les donnes avec un fichier CSV trois colonnes, avant dutiliser le tBarChart pour gnrer un fichier reprsentant le diagramme en barres.
Le tMap est gnralement utilis afin dadapter le schma dentre conformment la structure du schma du composant tBarChart. Pour plus dinformations concernant le composant tMap, consultez Mapping de flux de donnes du Guide Utilisateur Talend Open Studio ainsi que le composant tMap, page 1535.
133

tBarChart
A partir de la Palette, dposez les composants suivants dans lespace de modlisation graphique : deux composants tFileInputDelimited, un tMap, trois composants tFileOutputDelimited et un tBarChart. Renommez les composants comme vous le souhaitez pour faciliter le travail de conception. Double-cliquez sur le premier composant tFileInputDelimited afin dafficher longlet Basic settings de sa vue Component.
Renseignez le chemin daccs au fichier traiter dans le champ File name. Spcifiez dans le champ Header le nombre de lignes den-tte. Dans ce scnario, il ny a quune seule ligne. Laissez les autres paramtres tels quils sont. Cliquez sur Edit schema pour dcrire la structure des donnes du fichier dentre. Dans ce scnario, le schma dentre est compos de quatre colonnes : City, Population, Area, et Density. Une fois les noms de colonnes et les types de donnes dfinis, cliquez sur OK pour fermer la bote de dialogue du schma.
134

tBarChart
Connectez le tFileInputDelimited au tMap laide dune connexion de type Row > Main. Double-cliquez sur le tMap pour ouvrir lditeur Map Editor.
135

tBarChart
Cliquez sur le bouton [+] en haut droite de lditeur afin dajouter trois tables de sortie : Population, Area et Density. Les noms de ces tables deviendront le nom des connexions reliant le tMap aux composants de sortie dans lespace de modlisation graphique. Utilisez lditeur Schema editor pour ajouter trois colonnes chacune des tables de sortie : series (type String), category (type String) et value (type Integer). Dans le champ Expression de chaque table de sortie, saisissez les noms des series, comme indiqu ci-dessus. Ces noms apparatront dans la lgende du diagramme en barres. Dposez la colonne City de la table dentre dans la colonne category de chaque table de sortie. Dposez la colonne Population de la table dentre dans la colonne value de la table Population. Dposez la colonne Area de la table dentre dans la colonne value de la table Area. Dposez la colonne Density de la table dentre dans la colonne value de la table Density. Cliquez sur OK pour sauvegarder les mappings et fermer lditeur. Cliquez-droit sur le composant tMap et slectionnez Row > Population pour le connecter au premier composant tFileOutputDelimited. De la mme manire, connectez le tMap aux autres composants tFileOutputDelimited, en utilisant respectivement Area et Density. Double-cliquez sur le premier composant tFileOutputDelimited pour afficher longlet Basic settings de sa vue Component.
Dans le champ File Name, dfinissez un fichier CSV dans lequel les flux de donnes mapps seront envoys. Dans cet exemple, nommez le fichier de sortie crer LargeCities_mapped.csv. Ce fichier sera utilis comme fichier dentre pour le composant tBarChart. Si le nom dun fichier existant est spcifi, assurez-vous que la case Append (crire la suite) est dcoche. Laissez les autres paramtres tels quils sont. Pour ce qui est des deux autres composants tFileOutputDelimited, utilisez le mme chemin daccs que celui dfini pour le premier composant tFileOutputDelimited et cochez la case Append.
Vrifiez que la case Append est coche afin que tous les flux de donnes mapps aillent dans le mme fichier, sans craser les donnes existantes.
Connectez le premier composant tFileInputDelimited au second composant tFileInputDelimited laide dune connexion de type Trigger > OnSubjobOK.

tBarChart
Connectez le second composant tFileInputDelimited au tBarChart laide dune connexion de type Row > Main. Double-cliquez sur le second composant tFileInputDelimited afin dafficher longlet Basic settings de sa vue Component.
Renseignez le champ File name avec le chemin daccs au fichier, ainsi que son nom, comme dfini dans chaque composant tFileOutputDelimited. Dans cet exemple, le fichier dentre est LargeCities_mapped.csv. Laissez les autres paramtres tels quils sont. Le schma dentre doit correspondre la structure requise par le composant tBarChart. La structure du schma est donc copie partir du schma tBarChart. Double-cliquez sur le composant tBarChart pour afficher longlet Basic settings de sa vue Component.
Dans le champ Generated image path, renseignez le chemin daccs du fichier image gnrer. Dans le champ Chart title, saisissez un titre pour le diagramme en barres. Renseignez un nom pour les axes category et series. Si ncessaire, dfinissez la taille (la largeur dans le champ Image Width, la hauteur dans le champ Image height) et le degr de transparence de limage (dans le champ Foreground alpha). Dans ce scnario, laissez les paramtres par dfaut. Cliquez sur Edit schema afin douvrir la bote de dialogue du schma.
137

tBarChart
Copiez toutes les colonnes du schma de sortie dans le schma dentre en cliquant sur la double-flche pointant vers la gauche. Cliquez sur OK pour fermer la bote de dialogue du schma. Sauvegardez votre Job et appuyez sur F6 pour lexcuter. Un diagramme en barres est gnr selon les critres dfinis.
138

tDB2SCD
tDB2SCD
Proprits du tDB2SCD
Famille du composant Databases/Business Intelligence/DB2 Le composant tDB2SCD reflte et traque les modifications dune table DB2 SCD ddie. Le tDB2SCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Adresse IP du serveur de base de donnes.
Fonction Objectif
Basic settings
Property type
139

tDB2SCD
Port Database Table schema Username et Password Table Schema et Edit schema
Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.
SCD Editor
Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 165. Cochez cette case pour amliorer les performances du systme. Cette case est dcoche par dfaut, ce qui vous permet de terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur.
Use memory saving Mode Die on error
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Debug mode Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.
Utilisation
Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type Row Main en entre.
Scnario associ
Pour un scnario associ, consultez le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168.
140

tDB2SCDELT
tDB2SCDELT
Proprits du tDB2SCDELT
Famille du composant Databases/Business Intelligence/DB2 Le composant tDB2SCDELT reflte et traque les modifications dune table DB2 SCD ddie. Le tDB2SCDELT adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table DB2 SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tDB2Connection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Source table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table contenant les donnes filtrer.
Fonction Objectif
Basic settings
141

tDB2SCDELT
Table
Nom de la table crire. Notez quune seule table peut tre crire la fois pour que lopration dinsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Action on table
Surrogate Key Creation
Slectionnez dans la liste une colonne utiliser comme cl de substitution. Slectionnez la mthode utiliser pour gnrer la cl de substitution. Pour plus dinformations concernant les mthodes de cration, consultez la section Cls SCD, page 166. Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes.
Source Keys
Use SCD Type 1 fields Utilisez le type 1 si vous navez pas besoin de traquer les modifications, pour des corrections typographiques par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications.
142

tDB2SCDELT
Use SCD Type 2 fields Utilisez le type 2 si vous avez besoin de traquer les modifications, pour garder une trace des mises jour effectues par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications. Start date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de dpart. Vous pouvez slectionner lune des colonnes dentre du schma comme date de dpart (Start Date) dans la table SCD. End Date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de fin pour le journal. Lorsque le journal est en mode actif, la colonne End Date a une valeur nulle ; pour viter cela, vous pouvez slectionner loption Fixed Year value et saisir une anne fictive. Log Active Status : Ajoute une colonne votre schma SCD pour renseigner les valeurs de statut true et false. Cette colonne permet de reprer facilement le journal actif. Log versions : Ajoute une colonne votre schma SCD pour renseigner le numro de version du journal. Advanced settings Debug mode Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie et une connexion de type Row Main.
Scnario associ
Pour un scnario associ, consultez les proprits du tDB2SCD, page 139, ainsi que le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168.
143

tGreenplumSCD
tGreenplumSCD
Proprits du tGreenplumSCD
Famille du composant Databases/Business Intelligence/Greenplu m Le composant tGreenplumSCD reflte et traque les modifications dune table Greenplum SCD ddie. Le tGreenplumSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez un tGreenplumConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes.
Fonction Objectif
Basic settings
144

tGreenplumSCD
Table Schema et Edit schema
Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.
SCD Editor
Advanced settings
Utilisation
Scnario associ
145

tInformixSCD
tInformixSCD
Proprits du tInformixSCD
Component family Databases/Business Intelligence/Informix Le composant tInformixSCD reflte et traque les modifications dune table Informix SCD ddie. Le tInformixSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes.
Fonction Objectif
Basic settings
146

tInformixSCD
Username et Password Instance
Informations dauthentification de lutilisateur de la base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.
SCD Editor
Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 165. Cochez cette case pour amliorer les performances du systme. Dcochez cette case lorsque la base de donnes est configure en mode NO_LOG. Cette case est dcoche par dfaut, ce qui vous permet de terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur.
Use memory saving Mode Use Transaction Die on error
Advanced settings
Usage
Scnario associ
Pour un scnario associ, consultez le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168 du composant tMysqlSCD.
147

tIngresSCD
tIngresSCD
Proprits du tIngresSCD
Component family Databases/Business Intelligence/Ingres Le composant tIngresSCD reflte et traque les modifications dune table Ingres SCD ddie. Le tIngresSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Server Port Database Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes.
Fonction Objectif
Basic settings
148

tIngresSCD
SCD Editor
Advanced settings
Usage
Scnario associ
Pour un scnario associ, consultez le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168 du composant tMysqlSCD.
149

tLineChart
tLineChart
Proprits du tLineChart
Famille du composant Business Intelligence/Charts Le composant tLineChart lit des donnes partir dun flux dentre et transforme les donnes en graphique en lignes dans un fichier image au format PNG. Le composant tLineChart gnre un graphique en lignes partir des donnes dentre afin de faciliter lanalyse technique. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Le schma du tLineChart contient trois colonnes en lecture seule nommes respectivement series (type String), category (type String), et value (type Integer), selon un ordre prdtermin. Les donnes de toutes les autres colonnes seront simplement passes au composant suivant, sil y en a un, mais elles ne seront pas prsentes dans le diagramme en barres. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Sync columns Permet de synchroniser le schma du fichier dentre avec le schma du fichier de sortie. La fonction Sync ne saffiche que lorsquune connexion de type Row est connecte au composant de sortie.
Fonction
Generated image path Nom et chemin daccs du fichier image de sortie. Chart title Saisissez le titre du graphique en lignes gnrer.
Domain axis label and Saisissez le nom de laxe domain (axe X) et le nom de Range axis label laxe range (axe Y). Plot orientation Include legend Choisissez lorientation quaura votre graphique en lignes : VERTICAL ou HORIZONTAL. Saisissez true dans ce champ si vous souhaitez inclure une lgende indiquant les lignes des sries dans des couleurs diffrentes ; sinon, saisissez false. Saisissez la largeur et la hauteur du fichier image, exprimes en pixels.
Image width et Image height
150

tLineChart
Moving average
Cochez cette case afin dafficher la moyenne mobile de chaque srie dans votre graphique en lignes. Lorsque cette case est coche, le champ Period apparat et vous pouvez dfinir la priode dans laquelle apparat la moyenne mobile. Dfinissez quelles sont les plus hautes et les plus basses valeurs qui seront affiches sur laxe range. Choisissez dans la liste la couleur de fond du graphique ainsi que la couleur de fond du plan du graphique (zone de lorientation).
Lower bound and Upper bound Chart background et Plot background Advanced settings Utilisation
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est un composant de sortie. Par consquent, il requiert un composant dentre ainsi quune connexion de type Row Main.
Scnario : Crer un graphique en lignes afin de faciliter lanalyse des tendances

Ce scnario dcrit un Job simple qui lit les donnes dun fichier CSV et les transforme en graphique en lignes afin de faciliter lanalyse des tendances. Le fichier dentre indique combien de temps (en minutes) par semaine une personne regarde diffrentes chanes de tlvision, sur une priode de dix semaines, comme prsent ci-dessous :
Le fichier dentre ayant une structure diffrente de celle requise pour lutilisation dun tLineChart, un tMap sera utilis dans ce scnario, afin de mettre en correspondance les donnes avec un fichier CSV ayant la structure requise, avant dutiliser le tLineChart pour gnrer un fichier reprsentant le graphique en lignes.
Le tMap est gnralement utilis afin dadapter le schma dentre, conformment la structure du schma du composant tLineChart. Pour plus dinformations concernant le composant tMap, consultez Mapping de flux de donnes du Guide Utilisateur Talend Open Studio ainsi que le composant tMap, page 1535.
151

tLineChart
A partir de la Palette, dposez les composants suivants dans lespace de modlisation graphique : deux composants tFileInputDelimited, un tMap, trois composants tFileOutputDelimited et un tLineChart. Renommez les composants comme vous le souhaitez afin quils dcrivent au mieux leur fonction. Double-cliquez sur le premier composant tFileInputDelimited afin dafficher longlet Basic settings de sa vue Component.
Renseignez le chemin daccs au fichier traiter dans le champ File name en parcourant votre rpertoire et en slectionnant le fichier dentre. Spcifiez dans le champ Header le nombre de lignes den-tte. Dans ce scnario, il ny a quune seule ligne. Laissez les autres paramtres tels quils sont. Cliquez sur Edit schema pour dcrire la structure des donnes du fichier dentre. Dans ce scnario, le schma dentre est compos de quatre colonnes : Week, Mins_TVA, Mins_TVB, et Mins_TVC. Une fois les noms de colonnes et les types de donnes dfinis, cliquez sur OK pour fermer la bote de dialogue du schma.
152

tLineChart
Connectez le tFileInputDelimited au tMap laide dune connexion de type Row > Main. Double-cliquez sur le tMap pour ouvrir lditeur Map Editor.
153

tLineChart
Cliquez sur le bouton [+] en haut droite de lditeur afin dajouter trois tables de sortie : TV_A, TV_B, et TV_C. Les noms de ces tables deviendront le nom des connexions reliant le tMap aux composants de sortie dans lespace de modlisation graphique. Utilisez lditeur Schema editor pour ajouter trois colonnes chacune des tables de sortie : series (type String), x (type Integer) et y (type Integer). Dans le champ Expression de chaque table de sortie, saisissez les noms des series, comme indiqu ci-dessus. Ces noms apparatront dans la lgende du graphique en lignes. Dposez la colonne Week de la table dentre dans la colonne x de chaque table de sortie. Dposez la colonne Mins_TVA de la table dentre dans la colonne y de la table TV_A. Dposez la colonne Mins_TVB de la table dentre dans la colonne y de la table TV_B. Dposez la colonne Mins_TVC de la table dentre dans la colonne value de la table TV_C. Cliquez sur OK pour sauvegarder les mappings et fermer lditeur. Cliquez-droit sur le composant tMap et slectionnez Row > TV_A pour le connecter au premier composant tFileOutputDelimited. De la mme manire, connectez le tMap aux autres composants tFileOutputDelimited, en utilisant respectivement Row > TV_B et Row > TV_C. Double-cliquez sur le premier composant tFileOutputDelimited pour afficher longlet Basic settings de sa vue Component.
Dans le champ File Name, dfinissez un fichier CSV dans lequel les flux de donnes mapps seront envoys. Dans cet exemple, nommez le fichier de sortie crer InputTV.csv. Ce fichier sera utilis comme fichier dentre pour le composant tLineChart. Si le nom dun fichier existant est spcifi, assurez-vous que la case Append (crire la suite) est dcoche. Laissez les autres paramtres tels quils sont. Pour ce qui est des deux autres composants tFileOutputDelimited, utilisez le mme chemin daccs que celui dfini pour le premier composant tFileOutputDelimited et cochez la case Append.
Vrifiez que la case Append est coche afin que tous les flux de donnes mapps aillent dans le mme fichier, sans craser les donnes existantes.
Connectez le premier composant tFileInputDelimited au second composant tFileInputDelimited laide dune connexion de type Trigger > OnSubjobOK.
154

tLineChart
Connectez le second composant tFileInputDelimited au tLineChart laide dune connexion de type Row > Main. Double-cliquez sur le second composant tFileInputDelimited afin dafficher longlet Basic settings de sa vue Component.
Renseignez le champ File name avec le chemin daccs au fichier, ainsi que son nom, le mme que celui dfini dans chaque composant tFileOutputDelimited. Dans cet exemple, le fichier dentre du tLineChart est InputTV.scv. Laissez les autres paramtres tels quils sont. Le schma dentre doit correspondre la structure requise par le composant tLineChart. La structure du schma est donc copie partir du schma du tLineChart. Double-cliquez sur le composant tLineChart pour afficher longlet Basic settings de sa vue Component.
Cliquez sur Edit schema afin douvrir la bote de dialogue du schma.
155

tLineChart
Copiez toutes les colonnes du schma de sortie dans le schma dentre en cliquant sur la double-flche pointant vers la gauche. Cliquez sur OK pour fermer la bote de dialogue du schma. Dans le champ Generated image path, dfinissez le chemin daccs du fichier image gnrer. Dans le champ Chart title, saisissez un titre pour le graphique en lignes. Dans ce scnario, son titre est Average Weekly Viewing (per person). Saisissez un nom pour les axes domain (X) et range (Y). Dans ce scnario, les noms des axes sont respectivement Week et Minutes. Dfinissez comme vous le souhaitez la taille de limage (dans les champs Image width pour la largeur et Image height pour la hauteur), la priode dans laquelle est calcule la moyenne mobile (dans le champ Period une fois la case Moving average coche), les limites infrieures et suprieures (respectivement dans les champs Lower bound et Upper bound), ainsi que la couleur de fond du graphique et du plan (respectivement dans les champs Chart background et Plot background). Sauvegardez votre Job et appuyez sur F6 pour lexcuter. Un graphique en lignes est gnr selon les critres dfinis. Il affiche une comparaison du temps de visionnage moyen et des volutions dans le temps correspondant aux diffrentes chanes de tlvision.
156

tLineChart
157

tMondrianInput
tMondrianInput
Proprits du tMondrianInput
Famille du composant Business Intelligence/OLAP Cube Le composant tMondrianInput lit des donnes partir de bases relationnelles et produit des groupes de donnes multidimensionnels reposant sur une requte MDX. Le tMondrianInput excute une expression multi-dimensionnelle (MDX) correspondant la structure du groupe de donnes et au schma dfini. Puis il passe les donnes multidimensionnelles obtenues au composant suivant laide dun lien de type Row Main. Mondrian Version DB type Property type Slectionnez la version de Mondrian que vous utilisez. Slectionnez le type de relation appropri pour relier les bases de donnes. Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Datasource Username et Password Schema et Edit Schema Chemin daccs et nom du fichier contenant les donnes. Informations dauthentification de lutilisateur de la base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Catalog MDX Query Chemin daccs au catalogue (structure de lentrept de donnes). Saisissez votre requte MDX en faisant attention ce que lordre des champs corresponde celui dfini dans le schma et dans la structure de lentrept de donnes.
Fonction
Objectif
Basic settings
158

tMondrianInput
Encoding
Slectionnez le type dencodage partir de la liste ou choisissez loption Custom pour le dfinir manuellement. Ce champ doit obligatoirement tre renseign.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant couvre toutes les possibilits des requtes MDX pour des groupes de donnes multidimensionnels.
Scnario : Tables en jointure croise

Le prsent Job permet dextraire des groupes de donnes multidimensionnels partir de tables de bases de donnes relationnelles stockes dans une base MySQL. Les donnes sont rcupres laide dune expression multidimensionnelle (requte MDX). Il est clair que vous devez connatre la structure de vos donnes, ou du moins disposer dune description de la structure (catalogue) comme rfrence du groupe de donnes rcuprer dans ces diffrentes dimensions.
A partir de la Palette, cliquez-dposez un composant tMondrianInput (famille Business Intelligence) ainsi quun composant de sortie tLogRow (famille Logs & Errors). Reliez le tMondrianInput au composant de sortie laide dun lien de type Row Main. Slectionnez le composant tMondrianInput puis cliquez sur la vue Component.
159

tMondrianInput
Dans le champ DB Type, slectionnez la base de donnes relationnelle utiliser avec Mondrian. Slectionnez lentre du Repository correspondante dans le champ Property type, dans le cas o vous stockez les dtails de connexion vos bases de donnes de manire centralise. Dans cet exemple, les proprits sont en mode Built-in. Remplissez les dtails de connexion votre base de donnes : Host, Port, Database, User Name et Password. Dans le champ Schema, slectionnez le schma correspondant partir du Repository dans le cas o il est stock de manire centralise. Dans cet exemple, le schma doit reste dfinir (mode Built-in).
La base de donnes relationnelle que lon veut interroger contient cinq colonnes : media, drink, unit_sales, store_cost et store_sales. La requte doit permettre de rcuprer le contenu de unit_sales, store_cost et de store_sales pour les diffrentes valeur de media / drink en utilisant une requte MDX comme dans lexemple ci-dessous :
160

tMondrianInput
A partir de longlet Basic settings du composant tMondrianInput, renseignez le chemin daccs au catalogue de lentrept de donnes dans le champ Catalog. Ce catalogue dcrit la structure de lentrept. Entrez ensuite la requte MDX de la manire suivante : "select {[Measures].[Unit Sales], [Measures].[Store Cost], [Measures].[Store Sales]} on columns, CrossJoin( { [Promotion Media].[All Media].[Radio], [Promotion Media].[All Media].[TV], [Promotion Media].[All Media].[Sunday Paper], [Promotion Media].[All Media].[Street Handout] }, [Product].[All Products].[Drink].children) on rows from Sales where ([Time].[1997])" Slectionnez enfin le type dencodage partir de la liste du champ Encoding Type. Slectionnez le composant tLogRow puis cochez loption Print header pour afficher le nom des colonnes sur la console. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
La console affiche le rsultat de unit_sales, store_cost et store_sales pour chaque type de Drink (Beverages, Dairy, Alcoholic beverages) crois avec chaque type de media (TV, Sunday Paper, Street handout) comme illustr ci-dessus.
161

tMSSqlSCD
tMSSqlSCD
Proprits du tMSSqlSCD
Famille de composant Databases/Business Intelligence/MSSQL Server Le composant tMSSqlSCD reflte et traque les modifications dune table SCD MSSQL ddie. Le tMSSqlSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Server Port Schema Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom du schma de la base de donnes. Nom de la base de donnes.
Fonction Objectif
Basic settings
162

tMSSqlSCD
Username et Password Table Schema et Edit schema
Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.
SCD Editor
Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations concernant les mthodes de cration, consultez la section Cls SCD, page 166. Cochez cette case pour amliorer les performances du systme. Cette case est dcoche par dfaut, ce qui vous permet de terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.
Advanced settings
Additional JDBC parameters
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Debug mode Utilisation Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.
Scnario associ
163

tMysqlSCD
tMysqlSCD
Proprits du tMysqlSCD
Famille de composant Databases/Business Intelligence/MySQL Le composant tMysqlSCD reflte et traque les modifications dune table SCD MySQL ddie. Le tMysqlSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. DB Version Host Port Database Slectionnez la version de Mysql que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.
Fonction Objectif
Basic settings
164

tMysqlSCD
Username et Password Table Action on table
Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist: :crer la table si ncessaire. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
SCD Editor
Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 165. Cochez cette case pour amliorer les performances du systme. Cette case est dcoche par dfaut, ce qui vous permet de terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.
Use memory saving mode Die on error
Advanced settings
Additional JDBC Parameters
Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type Row > Main en entre.
Mthodologie de gestion du SCD

Lors de dimensions volution lente ou Slowly Changing Dimensions (SCD), les donnes changent lentement. Lditeur SCD permet de construire de manire simple le flux de sortie des donnes SCD. Dans lditeur SCD, vous pouvez relier les colonnes, slectionner la cl de
165

tMysqlSCD
substitution (Surrogate key) et paramtrer les attributs des colonnes modifies en combinant les diffrents types de modifications SCD. La figure ci-dessous reprsente lditeur SCD.
Cls SCD Vous devez slectionner une ou plusieurs colonnes qui serviront de cls permettant dassurer lunicit des donnes entrantes. Vous devez aussi slectionner une colonne sur laquelle positionner une cl de substitution (surrogate key) dans la table SCD et la relier une des colonnes dentre de la table source. La valeur de la cl de substitution permet de relier les enregistrements de la table source aux enregistrements de la table SCD. Lditeur utilise ce mapping pour localiser lenregistrement dans la table SCD et pour dterminer si un enregistrement est nouveau ou sil a t modifi. La cl de substitution est gnralement la cl primaire de la table source, mais elle peut aussi correspondre une autre cl partir du moment o elle permet didentifier de faon unique un enregistrement et o ses valeurs ne changent pas.
166

tMysqlSCD
Source keys : Glissez une ou plusieurs colonnes du panneau Unused vers le panneau Source keys. Ces colonnes seront utilises en tant que cl(s) assurant lunicit des donnes entrantes. Surrogate keys : Paramtrez la colonne dans laquelle la cl de substitution gnre sera stocke. Une cl de substitution peut tre gnre en fonction de la mthode slectionne dans la liste Creation. Creation : Slectionnez une des mthodes suivantes permettant de gnrer la cl : Auto increment : la cl est auto-incrmente. Input field : la cl est fournie par un champ dentre. Lorsque cette mthode est slectionne, vous pouvez glisser le champ correspondant du panneau Unused vers le champ complement. Routine : partir du champ complement, vous pouvez appuyer sur Ctrl+ Espace afin dafficher la liste dauto-compltion et de slectionner la routine approprie. Table max +1 : la valeur maximum de la table SCD est incrmente pour crer une cl de substitution. DB Sequence : la squence de la base de donnes permet de gnrer une squence numrique qui est utilise pour autognrer un identifiant unique pour une colonne. A partir du champ complement, vous pouvez indiquer le nom de la squence de la base de donnes disponible (DB Sequence).
Loption DB Sequence est disponible uniquement depuis lditeur SCD du composant tOracleSCD.
Types de SCD Il existe quatre types de dimensions volution lente (Slowly Changing Dimensions) : du Type 0 au Type 3. Vous pouvez, dun simple glisser-dposer, appliquer nimporte quel type de SCD nimporte quelle colonne de la table source. Type 0 : ce type de SCD nest pas beaucoup utilis. Certaines donnes dimensionnelles peuvent tre crases et dautres peuvent rester inchanges au cours du temps. Ce type de SCD convient lorsque aucun effort na t mis en place pour grer les dimensions caractre volutif. Type 1 : aucun historique nest stock dans la base de donnes. Les nouvelles donnes crase les anciennes. Utilisez ce type si vous navez pas besoin de traquer les changements. Ce type de SCD convient lorsque vous corrigez certaines fautes, par exemple lorthographe des mots.
167

tMysqlSCD
Type2 : lintgralit de lhistorique est stocke dans la base de donnes. Ce type de SCD traque les donnes dhistorique en enregistrant un nouvel enregistrement dans la table de dimension avec une nouvelle cl chaque fois quun changement est effectu. Ce type de SCD convient lorsque lon traque les mises jour, par exemple. Le principe du SCD Type 2 rside dans le fait quun nouvel enregistrement est ajout la table SCD lorsquun changement est dtect dans les colonnes slectionnes. Notez que bien que plusieurs changements peuvent tre effectus au mme enregistrement sur plusieurs colonnes paramtres en Type 2, une seule ligne traquant ces changements est ajoute la table SCD. Le schma du SCD Type 2 devrait inclure des colonnes spcifiques au SCD contenant les informations de log standard, notamment : -start : ajoute une colonne au schma de la table SCD contenant la date de dbut dun enregistrement. Vous pouvez slectionner une des colonnes du schma dentre comme date de dpart pour la table SCD. -end : ajoute une colonne au schma de la table SCD contenant la date de fin dun enregistrement. Lorsque lenregistrement est en cours, la date de fin est de valeur NULL , sinon vous pouvez utiliser une anne fixe en slectionnant Fixed Year Value dans la liste et renseignez lanne fictive dans la cellule d cot pour viter davoir une valeur nulle dans le champ end. -version : ajoute une colonne au schma de la table SCD contenant le numro de version de lenregistrement. -active : ajoute une colonne au schma de la table SCD contenant les statuts true ou false. Cette colonne permet de reprer facilement les enregistrements actifs. Type 3 : seules les informations sur lancienne valeur dune dimension est crite dans la base de donnes. Ce type de SCD traque les changements en utilisant des colonnes spares. Ce type de SCD convient lorsque lon traque les valeurs prcdentes dune colonne qui change.
Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3
Ce scnario Java dcrit un Job traquant les modifications effectues dans quatre des colonnes du fichier dlimit source, crit ces modifications ainsi que lhistorique des modifications dans une table SCD et affiche les informations derreurs dans la console Run. Le fichier dlimit source contient diffrentes informations personnelles : des prnoms dans la colonne firstname, des noms dans la colonne lastname, des adresses dans la colonne address, des villes dans la colonne city, lentreprise de la personne dans la colonne company, son ge dans la colonne age et son statut marital dans la colonne status. Une colonne id permet dassurer lunicit des donnes.
168

tMysqlSCD
Les changements de statut marital doivent craser les anciens statuts enregistrs. Ce type de changement correspond un changement SCD Type 1. Un nouvel enregistrement dans la table dimensionnelle avec une cl diffrente sera insr chaque fois quune personne change dentreprise. Ce type de changement correspond un changement SCD Type 2. Vous allez rcuprer lancienne ville et lancienne adresse dune personne. Ce type de changement correspond un changement SCD Type 3. Pour raliser ce type de scnario, il est prfrable de le sparer en trois tapes principales : la dfinition du flux principal du Job, le paramtrage de lditeur SCD et la cration de la table de modification dans la base de donnes. Etape 1 : Dfinir le flux principal du Job Cliquez et dposez les composants suivants dans lditeur graphique : tMysqlConnection, tFileInputDelimited, tMysqlSCD, tMysqlCommit ainsi que deux composants tLogRow. Connectez les composants tFileInputDelimited, le premier tLogRow et le tMysqlSCD laide dun lien Row Main. Ce sous-Job correspond au flux principal du Job. Connectez le tMysqlConnection au tFileInputDelimited et le tMysqlSCD au tMysqlCommit laide de liens OnComponentOk. Connectez le tMysqlSCD au second tLogRow laide dun lien Row Reject. Les colonnes errorCode et errorMessage sont ajoutes au schma. Cette connexion collecte les informations derreurs.
169

tMysqlSCD
Dans lditeur graphique, double-cliquez sur le composant tMysqlConnection pour afficher ses proprits de base dans longlet Basic settings et renseigner manuellement les informations de connexion. Lorsque plusieurs composants Database sont utiliss, le composant tMysqlConnection devrait tre utilis pour viter de renseigner plusieurs fois les mmes informations de connexion la base de donnes.
Si vous avez dj stock les informations de connexion dans le Repository, glissez llment Metadata souhait dans lditeur graphique et les informations de connexion la base de donnes apparatront automatiquement dans les champs correspondants. Pour plus dinformations sur les mtadonnes, consultez Centraliser les mtadonnes du Guide Utilisateur de Talend Open Studio.
Dans ce scnario, lobjectif est de se connecter la table SCD dans laquelle toutes les modifications apportes au fichier dlimit seront traques.
Dans lditeur graphique, double-cliquez sur le composant tFileInputDelimited pour afficher la vue Basic settings.
170

tMysqlSCD
Cliquez sur le bouton [...] ct du champ File Name pour slectionner le chemin daccs au fichier dlimit dataset.csv source contenant les informations personnelles. Dans les champs Row et Field Separator, renseignez respectivement les sparateurs de lignes et de champs utiliss dans le fichier source.
Les champs File Name, Row separator et Field separators sont obligatoires.
Si ncessaire, renseignez les champs Header, Footer et Limit. Dans ce scnario, saisissez 1 dans le champ Header puisque le fichier source contient un en-tte. Laissez le champ Footer 0 puisque le fichier source ne contient pas de pied de page et ne renseignez pas le champ Limit dterminant le nombre de lignes devant tre traites. Cliquez sur Edit schema pour dcrire la structure des donnes du fichier dlimit source. Dans ce scnario, le schma source est compos de huit colonnes : id, firstname, lastname, address, city, company, age et status.
Dans longlet Basic settings du premier composant tLogRow, slectionnez le mode Table afin que le contenu du fichier source, ainsi que les attributs variants apparaissent dans les cellules du tableau dans la console avant dtre traites par composant SCD.
171

tMysqlSCD
Dans lditeur graphique, double-cliquez sur le composant tMysqlSCD pour paramtrer ses proprits.
Dans longlet Basic settings, cochez la case Use an existing connection pour rutiliser les informations de connexion dfinies dans les proprits du composant tMysqlConnection. Dans le champ Table, saisissez le nom de la table SCD dans laquelle les changements seront stocks. Si ncessaire, cliquez sur Sync columns pour rcuprer toutes les colonnes du fichier dlimit. Dans lditeur graphique, double-cliquez sur le composant tMysqlCommit pour paramtrer ses proprits. Dans la liste Component list, slectionnez la connexion adquate sil y a plusieurs composants de connexion dans le Job. Dans longlet Basic settings du second composant tLogRow, slectionnez le mode Table afin que le contenu du fichier source, ainsi que les attributs variants apparaissent dans les cellules dun tableau. Etape 2 : Paramtrer lditeur SCD Dans longlet Basic settings du composant tMysqlSCD, cliquez sur le bouton [...] cot du champ SCD Editor pour ouvrir lditeur SCD editor et construire le flux de donnes en sortie du SCD.
172

tMysqlSCD
Toutes les colonnes du fichier dlimit source, provenant du composant prcdent et nayant pas encore t utilises, apparaissent dans le panneau Unused de lditeur SCD. Tous les autres panneaux de lditeur sont vides. A partir de la liste Unused, glissez la colonne id vers le panneau Source keys pour tre utilise comme cl permettant dassurer lunicit des donnes entrantes. Dans le panneau Surrogate keys, donnez un nom la cl de substitution (surrogate key) dans le champ Name, SK1 pour ce scnario. Dans la liste Creation, slectionnez la mthode utiliser pour gnrer la cl de substitution, Auto-increment pour ce scnario. Dans la liste Unused, glissez les colonnes firstname et lastname vers le panneau Type 0, les changements effectus dans ces colonnes ne sont pas pertinents dans cet exemple. Glissez la colonne status vers le panneau Type 1. Lancienne valeur sera crase par la nouvelle. Glissez la colonne company vers le panneau Type 2. A chaque fois quune personne change dentreprise, un nouvel enregistrement sera insr dans la table dimensionnelle avec une nouvelle cl. Dans la zone Versioning : -Paramtrez les colonnes start et end de votre table SCD contenant respectivement les dates de dbut et de fin. La date de fin est nulle pour les enregistrements en cours jusqu ce quun changement soit dtect. A ce moment l, la date de fin est renseigne et un nouvel enregistrement est ajout sans date de fin. Dans ce scnario, slectionnez Fixed Year Value dans la colonne end et saisissez une anne fictive pour viter davoir une valeur nulle dans le champ de date de fin. -cochez le case version pour conserver le numro de version de lenregistrement. -cochez la case active pour ajouter la colonne Status contenant les statuts True ou False des enregistrements. True correspond lenregistrement en cours et False correspond lenregistrement modifi. Glissez les colonnes address et city vers le panneau Type 3 pour ne rcuprer que les informations sur les anciennes valeurs des adresses et des villes.
173

tMysqlSCD
Pour plus dinformations sur les types de SCD, consultez Mthodologie de gestion du SCD page 165.
Cliquez sur OK pour valider votre configuration et fermer lditeur SCD. Cliquez sur Edit schema pour afficher le flux de donnes en entre et en sortie. Le schma de sortie du SCD devrait inclure les colonnes spcifiques au SCD contenant les informations de log standard dfinies dans lditeur SCD editor.
174

tMysqlSCD
Si vous modifiez la dfinition du schma dentre, vous devez vrifier et reconfigurer si ncessaire la dfinition du flux de sortie dans lditeur SCD, afin de sassurer que la structure des donnes de sortie est correctement actualise.
Etape 3 : Crer la table SCD Double-cliquez sur le composant tMysqlSCD pour afficher sa vue Basic settings et slectionnez Create table if not exists partir de la liste Action on table pour viter davoir crer et dfinir manuellement la table SCD. Enregistrez votre Job et appuyez sur F6 pour lexcuter. La console Run affiche le contenu du fichier dlimit dentre et votre table SCD est cre dans votre base de donnes, contenant lensemble de donnes initial.
Janet divorce, dmnage Adelanto au 355 Golf Rd et travaille maintenant chez Greenwood.
175

tMysqlSCD
Adam sest mari, a dmnag Belmont au 2505 Alisson ct. et travaille chez Scoop. Martin travaille dsormais chez Phillips and Brothers. Mettez jour le fichier dlimit avec ces informations et appuyez sur F6 pour excuter le Job. La console affiche les changements apports aux informations personnelles et la table SCD affiche lhistorique des changements valides, ainsi que leur statut et leur numro de version. Le nom de lentreprise de Martin dpasse la longueur dfinie pour la colonne company dans le schma. Ce changement est donc dirig vers le flux de rejets, et non sauvegard dans la table SCD.
176

tMysqlSCDELT
tMysqlSCDELT
Proprits du tMysqlSCDELT
Famille du composant Databases/Business Intelligence/MySQL Le composant tMysqlSCDELT reflte et traque les modifications dune table MySQL SCD ddie. Le tMysqlSCDELT adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table MySQL SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version Use an existing connection Slectionnez la version de Mysql que vous utilisez. Cochez cette case lorsque vous utilisez le composant tMysqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Source table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table contenant les donnes filtrer.
Fonction Objectif
Basic settings
177

tMysqlSCDELT
Table
Action on table
Source Keys
Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes.
178

tMysqlSCDELT
Use SCD Type 2 fields Utilisez le type 2 si vous avez besoin de traquer les modifications, pour garder une trace des mises jour effectues par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications. Start date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de dpart. Vous pouvez slectionner lune des colonnes dentre du schma comme date de dpart (Start Date) dans la table SCD. End Date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de fin pour le journal. Lorsque le journal est en mode actif, la colonne End Date a une valeur nulle ; pour viter cela, vous pouvez slectionner loption Fixed Year value et saisir une anne fictive. Log Active Status : Ajoute une colonne votre schma SCD pour renseigner les valeurs de statut true et false. Cette colonne permet de reprer facilement le journal actif. Log versions : Ajoute une colonne votre schma SCD pour renseigner le numro de version du journal. Advanced settings Debug mode Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.
Scnario associ
Pour un scnario associ, consultez les proprits du tMysqlSCD, page 164, ainsi que le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168.
179

tOracleSCD
tOracleSCD
Proprits du tOracleSCD
Famille de composant Databases/Business Intelligence/Oracle Le composant tOracleSCD reflte et traque les modifications dune table SCD Oracle ddie. Le tOracleSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection type DB Version Host Port Liste droulante des pilotes disponibles. Slectionnez la version dOracle que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes.
Fonction Objectif
Basic settings
180

tOracleSCD
Database Schema Username et Password Table Action on table
Nom de la base de donnes. Nom du schma de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Create a table : crer une nouvelle table. Create table if not exists: :si ncessaire, crer une table qui nexiste pas encore. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.
SCD Editor
Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 165. Cochez cette case pour amliorer les performances du systme. Cette case est dcoche par dfaut, ce qui vous permet de terminer le traitement avec les lignes sans erreur, et dignorer les lignes en erreur. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.
Advanced settings
181

tOracleSCD
Scnario associ
182

tOracleSCDELT
tOracleSCDELT
Proprits du tOracleSCDELT
Famille du composant Databases/Business Intelligence/Oracle Le composant tOracleSCDELT reflte et traque les modifications dune table Oracle SCD ddie. Le tOracleSCDELT adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table Oracle SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tOracleConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection type DB Version Host Port Database Liste droulante des pilotes disponibles. Slectionnez la version dOracle que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.
Fonction Objectif
Basic settings
183

tOracleSCDELT
Username et Password Source table Table
Informations dauthentification de lutilisateur de base de donnes. Nom de la table contenant les donnes filtrer. Nom de la table crire. Notez quune seule table peut tre crire la fois pour que lopration dinsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Action on table
Source Keys
184

tOracleSCDELT
Use SCD Type 2 fields Utilisez le type 2 si vous avez besoin de traquer les modifications, pour garder une trace des mises jour effectues par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications. Start date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de dpart. Vous pouvez slectionner lune des colonnes dentre du schma comme date de dpart (Start Date) dans la table SCD. End Date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de fin pour le journal. Lorsque le journal est en mode actif, la colonne End Date a une valeur nulle ; pour viter cela, vous pouvez slectionner loption Fixed Year value et saisir une anne fictive. Log Active Status : Ajoute une colonne votre schma SCD pour renseigner les valeurs de statut true et false . Cette colonne permet de reprer facilement le journal actif. Log versions : Ajoute une colonne votre schma SCD pour renseigner le numro de version du journal. Advanced settings Additional JDBC parameters Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.
Debug mode
Scnario associ
Pour un scnario associ, consultez les proprits du tOracleSCD, page 180, ainsi que le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168.
185

tPaloCheckElements
tPaloCheckElements
Proprits du tPaloCheckElements
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloCheckElements vrifie lexistence dlments du flux de donnes dentre dans un cube donn. Ce composant peut tre utilis avec le tPaloOutputMulti. Il vrifie si les lments du flux dentre existent dans le cube donn, avant de les crire. Il peut galement dfinir une valeur par dfaut qui peut tre utilise si les lments nexistent pas. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection configuration Indisponible lors de lutilisation dune connexion existante Server Port Username et Password Database Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo. Saisissez le nom de la base de donnes dans laquelle crire les donnes. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.
Fonction Objectif
Basic settings
186

tPaloCheckElements
Cube On element error
Saisissez le nom du cube dans lequel les donnes doivent tre crites. Slectionnez laction effectuer lorsquun lment nexiste pas. - Reject row : La ligne correspondante sera rejete et place dans le flux de rejet. - Use default : La valeur par dfaut dfinie sera utilise. - Stop : le processus complet sera interrompu. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio. Un tableau vous permet de dfinir les lments vrifier. - Column : affiche la (les) colonne(s) du schma dentre. Cette colonne est automatiquement remplie une fois quun schma dentre est saisi ou cr. - Element type : slectionnez le type dlment de la colonne dentre. Seule une colonne peut tre dfinie en tant que Measure. - Default : saisissez la valeur par dfaut qui sera utilise si loption Use default a t slectionne dans le champ On element error .
Advanced settings Utilisation Connections
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant requiert un composant dentre. Liens de sortie (dun composant un autre) : Row : Main, Rejects Trigger : Run if, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Main, Rejects Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
Ce composant fonctionne uniquement avec des cubes Palo de type Normal.
187

tPaloCheckElements
Scnario associ
Pour un scnario associ, consultez le Scnario 2 : Refuser un flux de donnes dentre lorsque les lments crire nexistent pas dans un cube donn, page 231.
188

tPaloConnection
tPaloConnection
Proprits du tPaloConnection
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloConnection ouvre une connexion vers un serveur Palo et la laisse ouverte durant le temps de traitement. Chaque autre composant Palo du processus peut utiliser cette connexion. Ce composant permet le partage dune connexion un serveur Palo durant le processus complet. Host Name Server Port Username et Password Advanced settings Utilisation Connections Saisissez le nom de lhte ou ladresse IP du serveur hte. Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo.
Fonction
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est utilis avec les composants Palo afin de partager une connexion un serveur Palo. Liens de sortie (dun composant un autre) : Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Iterate Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Scnario associ
Pour un scnario associ, consultez le Scnario : Crer une dimension avec des lments, page 209.
189

tPaloCube
tPaloCube
Proprits du tPaloCube
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloCube cre, supprime ou vide des cubes Palo partir de dimensions existantes dans une base de donnes Palo. Ce composant effectue des oprations sur un cube Palo donn. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Username et Password Database Cube Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo. Saisissez le nom de la base de donnes dans laquelle lopration donne doit seffectuer. Saisissez le nom du cube dans lequel lopration donne doit seffectuer. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.
190

tPaloCube
Cube type
Slectionnez le type de cube dans la liste droulante pour le cube sur lequel lopration donne doit seffectuer : - Normal : Type de cube normal, type par dfaut. - Attribut : un cube Attribute sera cr avec la cration dun cube normal. - User Info : un cube User Info sera cr/modifi par ce composant. Slectionnez lopration que vous souhaitez effectuer sur le cube dfini : - Create cube : le cube nexiste pas et sera cr. - Create cube if not exists : cre un cube sil nexiste pas. - Delete cube if exists and create : supprime un cube sil existe et en cre un nouveau. - Delete cube : supprime le cube de la base de donnes. - Clear cube : supprime les donnes du cube. Ajoutez des lignes en cliquant sur le bouton [+] et dans chaque ligne, saisissez le nom dune dimension existant dans la base de donnes et devant tre utilise dans le cube. Lordre de cette liste dfinit galement lordre de cration des dimensions.
Action on cube
Dimension list
Advanced settings Utilisation Global Variables
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant peut tre utilis en standalone dans la cration dynamique de cubes, avec une liste dfinie de dimensions. Cubename : Indique le nom du cube trait. Disponible en tant que variable After. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 du Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Iterate Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
Le cube crant un processus ne cre pas les dimensions partir de rien. Les dimensions utilises dans le cube ont t cres prcdemment.
191

tPaloCube
Scnario : Crer un cube dans une base de donnes existante

Le Job de ce scnario cre un nouveau cube deux dimensions dans la base de donnes dmo Biker de Palo.
Pour reproduire ce scnario, procdez comme suit : Dposez un composant tPaloCube de la Palette dans lespace de modlisation graphique. Double-cliquez sur le composant tPaloCube afin douvrir sa vue Component.
Dans le champ Host name, saisissez le nom de lhte ou ladresse IP du serveur hte, localhost dans cet exemple. Dans le champ Server Port, saisissez le numro du port dcoute du serveur Palo. Dans ce scnario, le numro est 7777. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations dauthentification. Dans cet exemple, les deux sont admin.
192

tPaloCube
Dans le champ Database, saisissez le nom de la base de donnes dans laquelle vous souhaitez crer le cube, Biker dans cet exemple. Dans le champ Cube, saisissez le nom que vous souhaitez utiliser afin de crer le cube, bikerTalend, par exemple. Dans le champ Cube type, slectionnez le type Normal dans la liste droulante pour le cube crer, ce qui signifie que ce cube sera de type Normal, le type par dfaut. Dans le champ Action on cube, slectionnez laction effectuer. Dans ce scnario, slectionnez Create cube. Sous le tableau Dimensionlist, cliquez deux fois sur le bouton [+] afin dajouter deux lignes. Dans le tableau Dimensionlist, saisissez le nom de chaque nouvelle ligne afin de remplacer le nom par dfaut. Dans ce scnario, saisissez Months pour la premire ligne et Products pour la seconde. Ces deux dimensions existent dj dans la base de donnes Biker dans laquelle le nouveau cube sera cr. Appuyez sur F6 afin dexcuter le Job. Un nouveau cube a t cr dans la base de donnes Biker et les deux dimensions sont ajoutes dans ce cube.
193

tPaloCubeList
tPaloCubeList
Proprits du tPaloCubeList
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloCubeList rcupre les informations dune liste de cubes dans la base de donnes Palo dtermine. Ce composant liste le nom des cubes, leur types, le nombre de dimensions assignes, le nombre de cellules remplies dans la base de donnes dtermine. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection configuration Host Name Indisponible lors de lutilisation dune connexion existante. Server Port Username et Password Database Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo. Saisissez le nom de la base de donnes contenant les cubes dont vous souhaitez rcuprer les informations. Saisissez le nom de lhte ou ladresse IP du serveur hte.
194

tPaloCubeList
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant peut tre utilis en tant que composant de dbut. Il requiert un composant de sortie. Number of cubes : indique le nombre de cubes traits dans la base de donnes dtermine. Disponible en tant que variable After. Retourne un entier. Cube_ID : indique les IDs des cubes traits dans la base de donnes dtermine. Disponible en tant que variable Flow. Retourne un entier. Cubename : indique le nom des cubes traits dans la base de donnes dtermine. Disponible en tant que variable Flow. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 du Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Row : Main, Iterate. Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Iterate Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
Le schma de sortie est fixe et en lecture seule.
Dcouvrir le schma de sortie en lecture seule du tPaloCubeList

Le tableau ci-dessous prsente les informations relatives au schma en lecture seule du composant tPaloCubeList.
Colonne Cube_id Cube_name Cube_dimensions Cube_cells Cube_filled_cells Cube_status int string int long long int Type Description ID interne du cube. Nom du cube. Nombre de dimensions dans le cube. Nombrede cellules lintrieur du cube. Nombre de cellules remplies dans le cube. Statut du cube. Il peut tre : - 0 : non charg - 1 : charg - 2 : chang
195

tPaloCubeList
Colonne Cube_type int
Type
Description Type du cube. Il peut tre : - 0 : normal - 1 : system - 2 : attribute - 3 : user info - 4 . gpu type
Scnario : Rcuprer des informations dtailles dun cube dune base de donnes dtermine
Le Job dans ce scnario rcupre des informations dtailles concernant les cubes de la base de donnes dmo de Palo Biker.
Pour reproduire ce scnario, procdez comme suit : Dposez un composant tPaloCubeList et un tLogRow de la Palette dans lespace de modlisation graphique. Cliquez-droit sur le tPaloCubeList afin douvrir son menu contextuel. Dans ce menu, slectionnez Row > Main pour relier les deux composants. Double-cliquez sur le tPaloCube afin douvrir sa vue Component.
Dans le champ Host name, saisissez le nom de lhte ou ladresse IP du serveur hte, localhost dans cet exemple. Dans le champ Server Port, saisissez le numro du port dcoute du serveur Palo. Dans ce scnario, le numro est 7777.
196

tPaloCubeList
Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations dauthentification. Dans cet exemple, les deux sont admin. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle vous souhaitez crer le cube, Biker dans cet exemple. Appuyez sur F6 pour excuter le Job. Les informations du cube sont rcupres de la base de donnes Biker et sont affiches dans la console de la vue Run.
Pour plus dinformations concernant linterprtation des informations sur le cube, consultez Dcouvrir le schma de sortie en lecture seule du tPaloCubeList, page 195.
197

tPaloDatabase
tPaloDatabase
Proprits du tPaloDatabase
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloDatabase cre, supprime ou recre des bases de donnes sur un serveur Palo donn. Ce composant gre les bases de donnes dans un serveur Palo. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Username et Password Database Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo. Saisissez le nom de la base de donnes dans laquelle lopration doit seffectuer. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.
198

tPaloDatabase
Action on database
Slectionnez lopration que vous souhaitez effectuer sur le base de donnes: - Create database : la base de donnes nexiste pas et sera cre. - Create database if not exists : la base est cre lorsquelle nexiste pas. - Delete database if exists and create : la base de donnes est supprime si elle existe et une nouvelle base de donnes est cre. - Delete database : la base de donnes est supprime du serveur.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant peut tre utilis en standalone lors doprations de gestion de bases de donnes dans un serveur Palo. Databasename : Indique le nom de la base de donnes traite. Disponible en tant que variable After. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 du Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Iterate Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Scnario : Crer une base de donnes

Le Job de ce scnario cre une nouvelle base de donnes sur un serveur Palo donn.
Pour reproduire ce scnario, procdez comme suit :
199

tPaloDatabase
Dposez un composant tPaloDatabase de la Palette dans lespace de modlisation graphique. Double-cliquez sur le composant tPaloDatabase afin douvrir sa vue Component.
Dans le champ Host name, saisissez le nom de lhte ou ladresse IP du serveur hte, localhost dans cet exemple. Dans le champ Server Port, saisissez le numro du port dcoute du serveur Palo. Dans ce scnario, le numro est 7777. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations dauthentification. Dans cet exemple, les deux sont admin. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle vous souhaitez crer le cube, talenddatabase dans cet exemple. Dans le champ Action on database, slectionnez laction effectuer. Dans ce scnario, slectionnez Create database puisque la base de donnes crer nexiste pas. Appuyez sur F6 pour excuter votre Job. Une nouvelle base de donnes est cre sur le serveur Palo donn.
200

tPaloDatabaseList
tPaloDatabaseList
Proprits du tPaloDatabaseList
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloDatabaseList rcupre les informations dune liste de bases de donnes dans un serveur Palo donn. Ce composant liste les noms des bases de donnes, leur type, le nombre de cubes, le nombre de dimensions, le statut et lID des bases de donnes dun serveur Palo donn. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Username et Password Advanced settings Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.
Fonction Objectif
Basic settings
201

tPaloDatabaseList
Utilisation Global Variables
Ce composant peut tre utilis en tant que composant de dbut. Il ncessite un composant de sortie. Number of databases : Indique le nombre de bases de donnes traites. Disponible en tant que variable After. Retourne un entier. Database_id : Indique lID de la base de donnes traite. Disponible en tant que variable Flow. Retourne un long. Databasename : Indique le nom de la base de donnes traite. Disponible en tant que variable After. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 du Guide Utilisateur Talend Open Studio.
Connections
Limitation
Dcouvrir le schma de sortie en lecture seule du tPaloDatabaseList

Le tableau ci-dessous prsente les informations relatives au schma de sortie en lecture seule du composant tPaloDatabaseList.
Base de donnes Database_id Database_name Database_dimensions Database_cubes Database_status long string int int int Type Description ID interne de la base de donnes. Nom de la base de donnes. Nombre de dimensions dans la base de donnes. Nombre de cubes dans la base du donnes. Statut de la base de donnes . - 0 = non charge - 1 = charge - 2 = change Type de la base de donnes. - 0 = normal - 1 = system - 3 = user info
Database_types
int
202

tPaloDatabaseList
Scnario : Rcuprer des informations dtailles concernant les bases de donnes dun serveur Palo donn
Le Job de ce scnario rcupre des informations concernant toutes les bases de donnes dun serveur Palo donn.
Pour reproduire ce scnario, procdez comme suit : Dposez un composant tPaloDatabaseList et un tLogRow de la Palette dans lespace de modlisation graphique. Cliquez-droit sur le tPaloDatabaseList pour ouvrir le menu contextuel. Dans ce menu, slectionnez Row > Main pour relier les deux composants. Double-cliquez sur le tPaloDatabaseList pour ouvrir sa vue Component.
Dans le champ Host name, saisissez le nom de lhte ou ladresse IP du serveur hte, localhost dans cet exemple. Dans le champ Server Port, saisissez le numro du port dcoute du serveur Palo. Dans ce scnario, le numro est 7777. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations dauthentification. Dans cet exemple, les deux sont admin. Appuyez sur F6 pour excuter le Job. Les informations de toutes les bases de donnes du serveur Palo sont rcupres et affiches dans la console de la vue Run.
203

tPaloDatabaseList
Pour plus dinformations concernant le schma de sortie, consultez la section Dcouvrir le schma de sortie en lecture seule du tPaloDatabaseList, page 202.
204

tPaloDimension
tPaloDimension
Proprits du tPaloDimension
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloDimension cre, supprime ou recre des dimensions avec ou sans lments de dimension dans une base de donnes Palo. Ce composant gre les dimensions Palo, ainsi que les lments dans une base de donnes. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Username et Password Database Dimension Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo. Saisissez le nom de la base de donnes dans laquelle les dimensions sont gres. Saisissez le nom de la dimension sur laquelle lopration donne doit seffectuer. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.
205

tPaloDimension
Action on dimension
Slectionnez lopration que vous souhaitez effecteur sur la dimension : - None : aucune action nest effectue sur la dimension. - Create dimension : la dimension nexiste pas et sera cre. - Create dimension if not exists : cette dimension est cre quand elle nexiste pas. - Delete dimension if exists and create : cette dimension est supprime si elle existe et une nouvelle dimension est cre. - Delete dimension : la dimension est supprime de la base de donnes. Cochez cette case pour activer les champs de gestion des dimensions et crer des lments de dimension , et crer cette dimension. Slectionnez le type de dimension crer. Le type peut tre : - Normal - User info - System - Attribute
Create dimension elements Les champs ci-des- Dimension type sous sont disponibles uniquement Disponible quand la case Create diuniquement mension elements est colorsque lacche. tion effectuer sur la dimension est None. Commit size Schema et Edit Schema
Saisissez le nombre dlments qui seront crs avant de les sauvegarder dans la dimension. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.
Slectionnez ce bouton pour dplacer directement les lments entrants dans la dimension donne. Avec cette option, vous ne dfinissez auncune Cette option consolidation ou hirarchie. active les champs des paramtres correspondants devant tre renseigns. Input Column : slectionnez une colonne dans la liste droulante. Les colonnes de la liste droulante sont celles que vous avez dfinies dans le schma. Les valeurs de la colone slectionne seront prises en compte lors du traitement dlments de dimension.
Consolidation type None
206

tPaloDimension
Element type : Slectionnez le type dlments. Il peut tre : - Numeric - Text Creation mode : Slectionnez le mode de cration pour les lments traiter. Ce mode peut tre : - Add : ajoute simplement un lment la dimension. - Force add : force la cration de cet lment. Sil existe, llment sera recr. - Update : met jour llment sil existe. - Add or Update : si llment nexiste pas, il sera cr. Sil existe, il sera mis jour. Cette option est loption par dfaut. - Delete : supprime cet lment de la dimension. Slectionnez ce bouton pour crer des lments et les consolider dans la dimension donne. Cette consolidation structure les lments crs diffrents Cette option niveaux. active les champs des paramtres correspondants devant tre renseigns. Input Column: slectionnez une colonne dans la liste droulante. Les colonnes de la liste droulante sont celles que vous avez dfinies dans le schma. Les valeurs de la colone slectionne seront prises en compte lors du traitement dlments de dimension. Element type : Slectionnez le type dlments. Il peut tre : - Numeric - Text Creation mode : Slectionnez le mode de cration pour les lments crer. Ce mode peut tre : - Add : ajoute simplement un lment la dimension. - Force add : force la cration de cet lment. Sil existe, llment sera recr. - Update : met jour llment sil existe. - Add or Update : si llment nexiste pas, il sera cr. Sil existe, il sera mis jour. Cette option est loption par dfaut. Slectionnez ce bouton pour crer des lments et les structurer partir dune relation parent-enfant. Le flux dentre est responsable du regroupement de la Cette option consolidation. active les champs des paramtres correspondants devant tre renseigns. Elements type Slectionnez le type dlments. Il peut tre : - Numeric - Text 207 Consolidation type Self-referenced Consolidation type Normal

tPaloDimension
Creation mode
Slectionnez le mode de cration pour les lments crer. Ce mode peut tre : - Add : ajoute simplement un lment la dimension. - Force add : force la cration de cet lment. Sil existe, llment sera recr. - Update : met jour llment sil existe. - Add or Update : si llment nexiste pas, il sera cr. Sil existe, il sera mis jour. Cette option est loption par dfaut. Input Column : slectionnez une colonne dans la liste droulante. Les colonnes dans cette liste sont celles que vous avez dfinies dans le schma. Les valeurs de la colone slectionne seront prises en compte lors du traitement dlments de dimension. Hierarchy Element : slectionnez le type et la relation de cette colonne dentre pour la consolidation. - Parent : dfinissez la valeur dentre en tant qulment parent. - Child : lie la valeur dentre la valeur parent et construit la consolidation. - Factor : dfinissez le facteur de cette consolidation.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant peut tre utilis en standalone ou comme composant de fin dun processus. Dimensionname : Indique le nom de la dimension traite. Disponible en tant que variable After . Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 du Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Main, Iterate Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
La suppression dlments de dimension est possible uniquement avec le type de consolidation None. Seul le type de consolidation Self-Referenced permet le placement dun facteur dans cette consolidation.
208

tPaloDimension
Scnario : Crer une dimension avec des lments

Le Job de ce scnario cre une dimension de date avec une hirarchie dlments simple, compose de trois niveaux : Year, Month, Date (Anne, mois, date).
Pour reproduire ce scnario, procdez comme suit : Dposez un composant tPaloConnection, un tRowGenerator, un tMap, et un tPaloDimension de la Palette dans lespace de modlisation graphique. Cliquez-droit sur le tPaloConnection afin douvrir le menu contextuel. Dans le menu, slectionnez Trigger > On Subjob Ok pour le relier au tRowGenerator. Cliquez-droit sur le tRowGenerator afin douvrir le menu contextuel.
Le tRowGenerator est utilis pour gnrer des lignes au hasard afin de simplifier ce processus. Dans un cas rel dutilisation, vous pouvez utiliser un autre composant dentre afin de charger vos donnes.
Dans le menu, slectionnez Row > Main pour le relier au tMap. Cliquez-droit sur le tMap pour ouvrir le menu contextuel. Dans le menu, slectionnez Row > *New output* pour le relier au tPaloDimension. Nommez ce lien out1 dans la bote de dialogue qui souvre. Double-cliquez sur le composant tPaloCube afin douvrir sa vue Component.
209

tPaloDimension
Dans le champ Host name, saisissez le nom de lhte ou ladresse IP du serveur hte, localhost dans cet exemple. Dans le champ Server Port, saisissez le numro du port dcoute du serveur Palo. Dans ce scnario, le numro est 7777. Dans les champs Username (identifiant) et Password (mot de passe), saisissez les informations dauthentification. Dans cet exemple, les deux sont admin. Double-cliquez sur le tRowGenerator pour ouvrir son diteur.
Dans la partie suprieure de lditeur, cliquez sur le bouton [+] pour ajouter une colonne, et renommez-la random_date dans la colonne Column. Dans la ligne nouvellement ajoute, slectionnez Date pour la colonne Type, et getRandomDate dans la colonne Functions. Dans la vue Function parameters de la partie infrieure de lditeur, saisissez les nouvelles valeurs des dates minimum et maximum de la colonne Value. Dans cet exemple, le minimum est 2010-01-01, le maximum est 2010-12-31. Cliquez sur OK afin de valider vos modifications et fermer lditeur. Dans la bote de dialogue qui souvre, cliquez sur OK pour propager les modifications. Double-cliquez sur le tMap afin douvrir son diteur.
210

tPaloDimension
Dans la vue Schema editor de la partie infrieure de la fentre, sous la table out1, cliquez sur le bouton [+] afin dajouter trois lignes. Dans la colonne Column de la table out1 saisissez de nouveaux noms pour les trois lignes ajoutes, Year, Month et Date (anne, mois et date). Ces lignes sont ajoutes automatiquement la table out1 dans la partie infrieure du tMap editor. Dans la table out1 de la partie suprieure de lditeur, cliquez sur la colonne Expression de la ligne Year. Appuyez sur les touches Ctrl+Espace afin douvrir la liste dauto-compltion. Double-cliquez sur TalendDate.formatDate pour la slectionner. Lexpression pour obtenir la date saffiche dans la ligne Year. Lexpression est la suivante : TalendDate.formatDate("yyyy-MM-dd HH:mm:ss",myDate). Remplacez lexpression par dfaut par TalendDate.formatDate("yyyy",row1.random_date). Rptez lopration pour les lignes Month et Date pour ajouter lexpression par dfaut et remplacez-la respectivement par TalendDate.formatDate("MM",row1.random_date)et par TalendDate.formatDate("dd-MM-yyyy", row1.random_date). Cliquez sur OK afin de valider cette modification et acceptez la propagation des modifications en cliquant sur OK dans la bote de dialogue qui souvre. Dans lespace de modlisation graphique, double-cliquez sur le tPaloDimension afin douvrir sa vue Component.
211

tPaloDimension
Cochez la case Use an existing connection. Le tPaloConnection_1 saffiche automatiquement dans le champ Connection configuration. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle la nouvelle dimension est cre, talendDatabase dans cet exemple. Dans le champ Dimension, saisissez le nom que vous souhaitez utiliser pour la dimension crer, Date, par exemple. Dans le champ Action on dimension, slectionnez laction effectuer. Dans ce scnario, slectionnez Create dimension if not exist. Slectionnez la case Create dimension elements. Dans la zone Consolidation Type, slectionnez le bouton Normal. Sous le tableau de la hirarchie des lments, cliquez trois fois sur le bouton [+] pour ajouter trois lignes au tableau. .Dans la colonne Input column du tableau, slectionnez Year dans la liste droulante de la premire ligne, Month dans la deuxime et Date dans la troisime. Cela dtermine le niveau des lments des diffrentes colonnes du schma dentre. Appuyez sur F6 pour excuter le Job. Une nouvelle dimension a t cre dans la base de donnes Palo talendDatabase.
212

tPaloDimension
213

tPaloDimensionList
tPaloDimensionList
Proprits du tPaloDimensionList
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloDimensionList rcupre les informations dune liste de dimensions de la base de donnes Palo dtermine. Ce composant affiche le nom des dimensions, leur type, le nombre dlments de dimension, le maximum dindentation des dimensions, le maximum de profondeur des dimensions, le maximum des niveaux des dimensions, lID des dimensions dans un serveur Palo donn. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Username et Password Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.
Fonction Objectif
Basic settings
214

tPaloDimensionList
Database Retrieve cube dimensions Cube Disponible lorsque vous cochez la case Retrieve cube dimensions. Schema et Edit Schema
Saisissez le nom de la base de donnes dans laquelle se trouvent les dimensions qui vous intressent. Cochez cette case pour rcuprer les informations des dimensions dun cube existant. Saisissez le nom du cube duquel les informations concernant les dimensions sont rcupres.
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant peut tre utilis en standalone ou comme composant de dbut dun processus. Dimension name : Indique le nom de la dimension traite. Disponible en tant que variable Flow. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 du Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Row : Main, Iterate. Trigger : Run if, On Subjob Ok; On Subjob Error, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Iterate. Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
215

tPaloDimensionList
Dcouvrir le schma de sortie en lecture seule du tPaloDimensionList

Le tableau ci-dessous prsente les informations relatives au schma de sortie en lecture seule du composant tPaloDimensionList.
Dimension Dimension_id Dimension_name Dimension_attribute_cube Dimension_rights_cube Dimension_elements Dimension_max_level Dimension_max_indent Dimension_max_depth Dimension_type long string string string int int int int int Type Description ID interne de la dimension. Nom de la dimension. Nom du cube des attributs. Nom du cube des droits. Nombre dlments de dimension. Niveau maximal de la dimension. Indentation maximum de la dimension. Profondeur maximale de la dimension. Type de la dimension : - 0 = normal - 1 = system - 2 = attribute - 3 = user info
Scnario: Rcuprer des informations dtailles concernant les dimensions dune base de donnes dtermine
Le Job de ce scnario rcupre les informations de toutes les dimensions dune base de donnes dtermine.
Pour reproduire ce scnario, procdez comme suit : Dposez un composant tPaloDimensionList et un tLogRow de la Palette dans lespace de modlisation graphique. Cliquez-droit sur le tPaloDimensionList pour ouvrir le menu contextuel. Dans le menu, slectionnez Row > Main pour relier les deux composants. Double-cliquez sur le composant tPaloDimensionList pour ouvrir sa vue Component.
216

tPaloDimensionList
Dans le champ Host name, saisissez le nom de lhte ou ladresse ID du serveur hte, localhost dans cet exemple. Dans le champ Server Port, saisissez le numro du port dcoute du serveur Palo. Dans ce scnario, le numro est 7777. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations dauthentification. Dans cet exemple, les deux sont admin. Dans le champ Database, saisissez le nom de la base de donnes contenant les dimensions qui vous intressent, Biker dans cet exemple. Appuyez sur F6 pour excuter le Job. Les informations concernant les dimensions de la base de donnes Biker sont rcupres et affiches dans la console de la vue Run.
Pour plus dinformations concernant le schma de sortie, consultez la section Dcouvrir le schma de sortie en lecture seule du tPaloDimensionList, page 216.
217

tPaloInputMulti
tPaloInputMulti
Proprits du tPaloInputMulti
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloInputMulti rcupre des donnes (des lments et des valeurs) dun cube Palo. Ce composant rcupre les valeurs stockes ou calcules ainsi que les enregistrements lextrieur dun cube. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Username et Password Database Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo. Saisissez le nom de la base de donnes dans laquelle se trouvent les lments qui vous intressent. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.
218

tPaloInputMulti
Cube Cube type
Saisissez le nom du cube dans lequel les lments de dimension rcuprer sont stocks. Slectionnez le type de cube dans la liste droulante pour le cube sur lequel lopration donne doit seffectuer : - Normal : Type de cube normal, type par dfaut. - Attribut : un cube Attribute sera cr avec la cration dun cube normal. - System : Type de cube systme. - User Info : un cube User Info sera cr/modifi par ce composant. Saisissez le nombre de lignes de chaque lot rcuprer. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Les colonnes MEASURE et TEXT sont en lecture seule, mais vous pouvez ajouter dautres colonnes. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.
Commit size Schema et Edit Schema
Cube Query
Remplissez ce tableau pour prciser les donnes que vous souhaitez rcuprer. Column : les colonnes du schma sont ajoutes automatiquement cette colonne, une fois dfinies dans lditeur du schma. Les colonnes du schma sont utilises pour stocker les lments de dimensions rcuprs. Dimensions : saisissez le nom de chaque dimension du cube duquel vous souhaitez rcuprer les lments de dimensions. Lordre des dimensions dans cette colonne doit tre cohrent avec lordre dans le cube stockant ces dimensions. Elements : saisissez les lments de dimensions desquels rcuprer les donnes. Si plusieurs lments dune dimension sont requis, sparez-les avec une virgule.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant requiert un composant de sortie.
219

tPaloInputMulti
Connections
Liens de sortie (dun composant un autre) : Row : Main Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Iterate. Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
Selon larchitecture des systmes OLAP, une seule valeur (texte ou numrique) peut tre rcupre du cube. Les colonnes MEASURE et TEXT sont fixes et en lecture seule.
Scnario : Rcuprer des lments de dimensions dans un cube donn

Le Job de ce scnario rcupre plusieurs lments de dimensions du cube de dmo Palo Sales.
Pour reproduire ce scnario, procdez comme suit : Dposez un composant tPaloInputMulti et un tLogRow de la Palette dans lespace de modlisation graphique. Cliquez-droit sur le composant tPaloInputMulti afin douvrir son menu contextuel. Dans le menu, slectionnez Row > Main afin de relier le tPaloInputMulti au tLogRow. Double-cliquez sur le tPaloInputMulti afin douvrir sa vue Component.
220

tPaloInputMulti
Dans le champ Host name, saisissez le nom de lhte ou ladresse IP du serveur hte, localhost dans cet exemple. Dans le champ Server Port, saisissez le numro du port dcoute du serveur Palo. Dans ce scnario, le numro est 7777. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations dauthentification. Dans cet exemple, lidentifiant et le mot de passe sont admin. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle est stock le cube. Dans le champ Cube, saisissez le nom du cube dans lequel sont stockes les dimensions qui vous intressent Dans ce scnario, le cube est celui de dmo, Sales. Dans le champ Cube type, slectionnez le type du cube crer. Choisissez Normal, ce qui signifie que le cube sera de type Normal, le type par dfaut. A ct du champ Edit Schema, cliquez sur le bouton [...] pour ouvrir lditeur de schma.
221

tPaloInputMulti
Dans lditeur du schma, cliquez sur le bouton [+] pour ajouter les lignes ncessaires. Dans cet exemple, ajoutez les lignes correspondant toutes les dimensions stockes dans le cube Sales : Products, Regions, Months, Years, Datatypes, Measures. Saisissez les noms dans lordre donn de ce cube. Cliquez sur OK pour valider les modifications et acceptez la propagation du changement au composant suivant. Ces colonnes sont ajoutes automatiquement dans la colonne Column du tableau Cube Query dans la vue Component. Si lordre nest pas cohrent par rapport celui du cube Sales, dplacez les colonnes laide des flches montante et descendante. Dans la colonne Dimensions du tableau Cube Query, saisissez le nom de chaque dimension stocke dans le cube Sales selon lordre des lignes dans la colonne Column. Dans le cube Sales, le nom des dimensions est : Products, Regions, Months, Years, Datatypes, Measures. Dans la colonne Elements du tableau Cube Query, saisissez le nom des lments de dimensions que vous souhaitez rcuprer selon la dimension laquelle ils appartiennent. Dans cet exemple, les lments rcuprer sont All products, Germany, Austria, Jan, 2009, Actual, Turnover (Germany et Austria appartenant la mme dimension Regions, ils doivent tre saisis dans la mme ligne et spars par une virgule). Cliquez sur le tLogRow afin douvrir sa vue Component.
222

tPaloInputMulti
Dans la zone Mode, slectionnez loption Table (print values in cell of a table) pour afficher les rsultats de lexcution sous forme de tableau. Appuyez sur F6 pour excuter le Job. Les lments de dimensions et la valeur Measure correspondant saffichent dans la console de la vue Run.
223

tPaloOutput
tPaloOutput
Proprits du tPaloOutput
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloOutput crit une ligne de donnes (des lments ainsi que des valeurs) dans un cube Palo donn. Ce composant prend le flux dentre et lcrit dans un Cube Palo donn. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Username et Password Database Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo. Saisissez le nom de la base de donnes dans laquelle se trouve le cube qui vous intresse. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.
224

tPaloOutput
Cube Commit size Schema et Edit Schema
Saisissez le nom du cube dans lequel les donnes entrantes sont crites. Saisissez le nombre de lignes de chaque lot devant tre crit dans le cube. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.
Column as Measure Create element if not exist Save cube at process end Advanced settings Utilisation Global variable
Slectionnez la colonne du flux dentre contenant les valeurs Measure ou Text. Cochez cette case afin de crer llment traiter sil nexiste pas. Cochez cette case afin de sauvegarder le cube dans lequel vous avez crit les donnes la fin du processus.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant requiert un composant dentre. Number of lines : Indique le nombre de lignes traites. Disponible en tant que variable After. Retourne un entier. Liens de sortie (dun composant un autre) : Row : Iterate. Trigger : Run if. Liens dentre (dun composant un autre) : Row : Main, Reject. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Connections
Limitation
Ce composant ne peut crire quune seule ligne de donnes dans un cube.
Scnario associ
Pour un scnario associ, consultez le Scnario 1 : Ecrire des donnes dans un cube donn, page 228.
225

tPaloOutputMulti
tPaloOutputMulti
Proprits du tPaloOutputMulti
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloOutputMulti crit des donnes (des lments et des valeurs) dans un cube Palo. Ce composant prend la flux dentre et lcrit dans un cube Palo donn. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Username et Password Database Cube Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo. Saisissez le nom de la base de donnes dans laquelle se trouve le cube qui vous intresse. m dans lequel les donnes entrantes sont crites. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.
226

tPaloOutputMulti
Cube type
Slectionnez le type de cube dans la liste droulante pour le cube sur lequel lopration donne doit seffectuer : - Normal : Type de cube normal, type par dfaut. - Attribut : un cube Attribute sera cr avec la cration dun cube normal. - System : Type de cube systme. - User Info : un cube User Info sera cr/modifi par ce composant. Saisissez le nombre de lignes de chaque lot devant tre crit dans le cube. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.
Commit size Schema et Edit Schema
Measure value Splash mode
Slectionnez la colonne du flux dentre contenant les valeurs Measure ou Text. Slectionnez le mode splash utilis pour crire des donnes dans un lment consolid. Le mode peut tre : - Add :crit des valeurs dans les lments sous-jacents. - Default : utilise le mode splash par dfaut. - Set : dfinit simplement la valeur et effectue la distribution partir dautres valeurs. - Disable : napplique aucun splash. Pour plus dinformations concernant les modes splash Palo, consultez le Guide Utilisateur de Palo. Cochez cette case pour ajouter des nouvelles valeurs aux valeurs actuelles. Si vous ne cochez pas cette case, les nouvelles valeurs craseront les valeurs actuelles. Cochez cette case pour appeler le serveur de supervision. Cette case est dcoche par dfaut, ce qui vous permet de terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur.
Add values
Use eventprocessor Die on error
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant requiert un composant de dbut.
227

tPaloOutputMulti
Connections
Liens de sortie (dun composant un autre) : Row : Main Trigger : Run if, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Main, Reject Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
Les mesures numriques doivent tre de type Double ou String. Lorsque le type String est utilis, saisissez entre guillements la valeur devant tre traite.
Scnario 1 : Ecrire des donnes dans un cube donn

Le Job de ce scnario crit de nouvelles valeurs dans le cube Sales donn en dmo dans la base de donnes Demo installe avec Palo.
Pour reproduire ce scnario, procdez comme suit : Dposez un tFixedFlowInput et un tPaloOutputMulti de la Palette dans lespace de modlisation graphique. Cliquez-droit sur le composant tFixedFlowInput afin douvrir son menu contextuel. Dans ce menu, slectionnez Row > Main pour relier ce composant au tPaloOutputMulti. Double-cliquez sur le tFixedFlowInput pour ouvrir sa vue Component.
228

tPaloOutputMulti
Cliquez sur le bouton [...] pour ouvrir lditeur de schma.
Dans lditeur de schma, cliquez sept fois sur le bouton [+] afin dajouter sept lignes. Renommez-les respectivement Products, Regions, Months, Years, Datatypes, Measures et Values. Lordre de ces lignes doit tre cohrent avec celui des dimensions correspondantes dans le cube Sales et le type de la colonne Value, qui comprend la valeur de la mesure, est dfini comme double/Double. Cliquez sur OK afin de valider la modification et acceptez la propagation propose par la bote de dialogue qui souvre. Les libells des colonnes du schma saffichent automatiquement dans le tableau Value sous la case Use single table de la zone Mode. Dans le tableau Value, saisissez la valeur de chaque ligne dans la colonne Value. Ces valeurs sont : Desktop L, Germany, Jan, 2009, Actual, turnover, 1234.56.

tPaloOutputMulti
Double-cliquez sur le composant tPaloOutputMulti afin douvrir sa vue Component.
Dans le champ Server Port, saisissez le numro du port dcoute du serveur Palo. Dans ce scnario, le numro est 7777. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations dauthentification. Dans cet exemple, les deux sont admin. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle vous souhaitez crer le cube, Biker dans cet exemple. Dans le champ Cube, saisissez le nom que vous souhaitez utiliser pour le cube crer, bikerTalend, par exemple. Dans le champ Cube type, slectionnez le type Normal dans la liste droulante. Cela signifie que que le cube crer sera de type Normal, le type par dfaut. Dans le champ Measure Value, slectionnez Value. Appuyez sur F6 pour excuter le Job. Le flux dentre de donnes a t crit dans le cube Sales.
230

tPaloOutputMulti
Scnario 2 : Refuser un flux de donnes dentre lorsque les lments crire nexistent pas dans un cube donn
Le Job de ce scnario essaye dcrire des donnes dans le cube Sales mais puisque les lments concerns nexistent pas dans ce cube, le flux dentre est refus.
Pour reproduire ce scnario, procdez comme suit : Dposez les composants tFixedFlowInput, tPaloCheckElements, tPaloOutputMulti et tLogRow de la Palette dans lespace de modlisation graphique. Cliquez-droit sur le tFixedFlowInput afin douvrir son menu contextuel. Dans ce menu, slectionnez Row > Main afin de connecter ce composant au tPaloCheckElements. Double-cliquez sur le tFixedFlowInput afin douvrir sa vue Component.
231

tPaloOutputMulti
Cliquez sur le bouton [...] afin douvrir lditeur de schma.
Dans lditeur de schma, cliquez sept fois sur le bouton [+] afin dajouter sept lignes que vous allez nommer respectivement Products, Regions, Months, Years, Datatypes, Measures et Values. Lordre de ces lignes doit tre cohrent avec celui des dimensions correspondantes dans le cube Sales et le type de la colonne Value, qui comprend la valeur de la mesure et qui est dfini comme double/Double. Cliquez sur OK afin de valider la modification et acceptez la propagation propose par la bote de dialogue qui souvre. Les libells des colonnes du schma saffichent automatiquement dans le tableau Value sous la case Use single table de la zone Mode.
232

tPaloOutputMulti
Dans le tableau Value, saisissez la valeur de chaque ligne dans la colonne Value. Ces valeurs sont : Desktop L, Germany, Jan, 2009, Actual, turnover, 1234.56. Double-cliquez sur le composant tPaloCheckElements afin douvrir sa vue Component.
Dans le champ Host name, saisissez localhost. Dans le champ Server Port, saisissez le numro du port dcoute du serveur Palo. Dans ce scnario, le numro est 7777. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations dauthentification. Dans cet exemple, les deux sont admin. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle vous souhaitez crer le cube, Demo dans cet exemple. Dans le champ Cube, saisissez le nom du cube dans lequel vous souhaitez crire les donnes, Sales, par exemple. Dans le champ On Element Error, slectionnez Reject dans la liste droulante. Dans le tableau contenant les lments en bas de la vue Basic settings, cliquez sur la cellule au croisement de la ligne Value et de la colonne Element type. Slectionnez Measure dans la liste droulante. Double-cliquez sur le tPaloOutputMulti pour afficher sa vue Component.
233

tPaloOutputMulti
Dans le champ Server Port, saisissez le numro du port dcoute du serveur Palo. Dans ce scnario, le numro est 7777. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations dauthentification. Dans cet exemple, les deux sont admin. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle vous souhaitez crer le cube, Demo dans cet exemple. Dans le champ Cube, saisissez le nom du cube dans lequel vous souhaitez crire les donnes, Sales, par exemple. Dans le champ Cube type, slectionnez le type Normal dans la liste droulante. Cela signifie que que le cube crer sera de type Normal, le type par dfaut. Dans le champ Measure Value, slectionnez Value. Appuyez sur F6 pour excuter votre Job. Les donnes crire sont rejetes et affiches dans la console de la vue Run. Vous pouvez voir que le message derreur est Smart Products.
234

tPaloRule
tPaloRule
Proprits du tPaloRule
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloRule cre ou modifie des rgles dans un cube Palo donn. Ce composant vous permet de grer des rges dans un cube Palo donn. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Username et Password Database Cube Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo. Saisissez le nom de la base de donnes dans laquelle se trouvent les dimensions appliquant les rgles. Saisissez le nom du cube dans lequel les informations de dimensions doivent tre retrouves. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.
235

tPaloRule
Cube rules
Remplissez ce tableau afin deffectuer diffrentes actions sur les rgles spcifiques : - Definition : saisissez la rgle appliquer. - External Id : saisissez lID externe personnalis. - Comment : saisissez un commentaire pour cette rgle. - Activated : cochez cette case afin dactiver la rgle. - Action : slectionnez dans la liste droulante laction effectuer : - Create : crer cette rgle. - Delete : supprimer cette rgle. - Update : mettre jour cette rgle.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant peut tre utilis en standalone dans la cration dynamique de cubes, avec une liste dfinie de dimensions. Liens de sortie (dun composant un autre) : Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Iterate Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
La mise jour et la suppresion dune rgle ne sont disponibles uniquement lorsque la rgle a t cre avec un ID externe.
Scnario : Crer une rgle dans un cube donn

Le Job de ce scnario cre une rgle applique aux dimensions dun cube donn.
Pour reproduire ce scnario, procdez comme suit :
236

tPaloRule
Dposez un composant tPaloRule de la Palette dans lespace de modlisation graphique. Double-cliquez sur le composant tPaloRule afin douvrir sa vue Component.
Dans le champ Host name, saisissez le nom de lhte ou ladresse IP du serveur hte, localhost dans cet exemple. Dans le champ Server Port, saisissez le numro du port dcoute du serveur Palo. Dans ce scnario, le numro est 7777. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations dauthentification. Dans cet exemple, les deux sont admin. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle se trouvent les dimensions appliquant les rgles, Biker dans cet exemple. Dans le champ Cube, saisissez le nom du cube auquel appartiennent les dimensions appliquant les rgles, Orders dans cet exemple. Sous le tableau Cube rules, cliquez sur le bouton [+] afin dajouter une ligne. Dans le tableau Cube rules, saisissez ['2009'] = 123 dans la colonne Definition, OrderRule1 dans la colonne External Id et Palo Demo Rules dans la colonne Comment. Dans la colonne Activated, cochez la case. Dans la colonne Action, slectionnez Create dans la liste droulante. Appuyez sur F6 afin dexcuter le Job. La nouvelle rgle a t cre et la valeur de chaque lment de 2009 est 123.
237

tPaloRule
238

tPaloRuleList
tPaloRuleList
Proprits du tPaloRuleList
Famille de composant Business Intelligence/Cube OLAP/Palo Le composant tPaloRuleList rcupre les informations dune liste de rgles dune base de donnes Palo spcifie. Ce composant liste toutes les rgles, les formules, les commentaires, les statuts dactivation, les IDs externes dun cube donn. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Username et Password Database Saisissez le numro du port dcoute du serveur Palo. Informations dauthentification de lutilisateur de Palo. Saisissez le nom de la base de donnes dans laquelle se trouve le cube qui vous intresse. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.
239

tPaloRuleList
Cube Schema et Edit Schema
Saisissez le nom du cube dans lequel les informations de rgles doivent tre retrouves. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant peut tre utilis en standalone ou en tant que composant de dbut dun processus. Number of rules : indique le nombre de rgles traites. Disponible en tant que variable After. Retourne un entier. External ruleID : indique lID externe de la rgle traite. Disponible en tant que variable Flow. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 du Guide Utilisateur Talend Open Studio.
Connections
Limitation
Dcouvrir le schma de sortie en lecture seule du tPaloRuleList

Le tableau ci-dessous prsente les informations relatives au schma de sortie en lecture seule du composant tPaloRuleList.
Base de donnes rule_identifier rule_definition long string Type Description Identifiant interne de la rgle. Nom de la dimension.
240

tPaloRuleList
Base de donnes Dimension_attribute_cube
Type string
Description Formule de la rgle. Pour plus dinformations concernant cette rgle, consultez le Guide Utilisateur Palo. ID externe personnalis. Commentaire utilisateur de la rgle. Indique si la rgle a t active ou non.
rule_extern_id rule_comment rule_activated
string string boolean
Scnario : Rcuprer des informations dtailles concernant des rgles dun cube donn
Le Job de ce scnario rcupre les informations concernant les rgles appliques dans les dimensions dun cube donn.
Pour reproduire ce scnario, procdez comme suit : Dposez un composant tPaloRuleList et un tLogRow de la Palette dans lespace de modlisation graphique. Cliquez-droit sur le tPaloRuleList afin douvrir son menu contextuel. Dans ce menu, slectionnez Row > Main afin de lier les deux composants. Double-cliquez sur le tPaloRuleList pour ouvrir sa vue Component.
Dans le champ Host name, saisissez le nom de lhte ou ladresse IP du serveur hte, localhost dans cet exemple.
241

tPaloRuleList
Dans le champ Server Port, saisissez le numro du port dcoute du serveur Palo, 7777 dans cet exemple. Dans les champs Username (identifiant) et Password (mot de passe), saisissez vos informations dauthentification. Dans cet exemple, les deux sont admin. Dans le champ Database, saisissez le nom de la base de donnes dans laquelle se trouvent les dimensions appliquant les rgles qui vous intressent, Biker dans cet exemple. Dans le champ Cube, saisissez le nom du cube auquel les rgles qui vous intressent appartiennent. Appuyez sur F6 pour excuter le Job. Les informations de toutes les rgles du cube Orders sont rcupres et affiches dans la console de la vue Run.
Pour plus dinformations concernant le schma de sortie, consultez la section Dcouvrir le schma de sortie en lecture seule du tPaloRuleList, page 240.
242

tParAccelSCD
tParAccelSCD
Proprits du tParAccelSCD
Famille du composant Databases/Business Intelligence/ParAccel Le composant tParAccelSCD reflte et traque les modifications dune table ParAccel SCD ddie. Le tParAccelSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case si vous utilisez un tParAccelConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes.
Fonction Objectif
Basic settings
243

tParAccelSCD
Table Schema et Edit Schema
SCD Editor
Advanced settings
Utilisation
Scnario associ
244

tPostgresPlusSCD
tPostgresPlusSCD
Proprits du tPostgresPlusSCD
Famille de composant Databases/Business Intelligence/Postgresp lus Server Le composant tPostgresPlusSCD reflte et traque les modifications dune table SCD PostgresPlus ddie. Le tPostgresPlusSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes.
Fonction Objectif
Basic settings
245

tPostgresPlusSCD
Username et Password Table Schema et Edit Schema
SCD Editor
Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 165. Cochez cette case pour amliorer les performances du systme.
Use memory saving Mode Advanced settings
Utilisation
Scnario associ
246

tPostgresPlusSCDELT
tPostgresPlusSCDELT
Proprits du tPostgresPlusSCDELT
Famille du composant Databases/Business Intelligence/PostgresP lus Le composant tPostgresPlusSCDELT reflte et traque les modifications dune table PostgresPlus SCD ddie. Le tPostgresPlusSCDELT adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table PostgresPlus SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tPostgresPlusConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes.
Fonction Objectif
Basic settings
247

tPostgresPlusSCDELT
Source table Table
Nom de la table contenant les donnes filtrer. Nom de la table crire. Notez quune seule table peut tre crire la fois pour que lopration dinsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Action on table
Source Keys
248

tPostgresPlusSCDELT
Use SCD Type 2 fields Utilisez le type 2 si vous avez besoin de traquer les modifications, pour garder une trace des mises jour effectues par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications. Start date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de dpart. Vous pouvez slectionner lune des colonnes dentre du schma comme date de dpart (Start Date) dans la table SCD. End Date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de fin pour le journal. Lorsque le journal est en mode actif, la colonne End Date a une valeur nulle ; pour viter cela, vous pouvez slectionner loption Fixed Year value et saisir une anne fictive. Log Active Status : Ajoute une colonne votre schma SCD pour renseigner les valeurs de statut true et false . Cette colonne permet de reprer facilement le journal actif. Log versions : Ajoute une colonne votre schma SCD pour renseigner le numro de version du journal. Advanced settings Debug mode Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.
Scnario associ
249

tPostgresqlSCD
tPostgresqlSCD
Proprits du tPostgresqlSCD
Famille de composant Databases/Business Intelligence/Postgresq l Server Le composant tPostgresqlSCD reflte et traque les modifications dune table SCD Postgresql ddie. Le tPostgresqlSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Property type Use an existing connection Peut tre Built-in ou Repository. Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes.
Fonction Objectif
Basic settings
250

tPostgresqlSCD
Username et Password Table Schema et Edit Schema
SCD Editor
Advanced settings
Utilisation
Scnario associ
251

tPostgresqlSCDELT
tPostgresqlSCDELT
Proprits du tPostgresqlSCDELT
Famille du composant Databases/Business Intelligence/Postgresq l Le composant tPostgresqlSCDELT reflte et traque les modifications dune table Postgresql SCD ddie. Le tPostgresqlSCDELT adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table Postgresql SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tPostgresqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Source table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table contenant les donnes filtrer.
Fonction Objectif
Basic settings
252

tPostgresqlSCDELT
Table
Action on table
Source Keys
253

tPostgresqlSCDELT
Use SCD Type 2 fields Utilisez le type 2 si vous avez besoin de traquer les modifications, pour garder une trace des mises jour effectues par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications. Start date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de dpart. Vous pouvez slectionner lune des colonnes dentre du schma comme date de dpart (Start Date) dans la table SCD. End Date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de fin pour le journal. Lorsque le journal est en mode actif, la colonne End Date a une valeur nulle ; pour viter cela, vous pouvez slectionner loption Fixed Year value et saisir une anne fictive. Log Active Status : Ajoute une colonne votre schma SCD pour renseigner les valeurs de statut true et false . Cette colonne permet de reprer facilement le journal actif. Log versions : Ajoute une colonne votre schma SCD pour renseigner le numro de version du journal. Advanced settings Debug mode Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.
Scnario associ
254

tSPSSInput
tSPSSInput
Avant de pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous de de suivre les tapes suivantes : -Si vous avez dj install SPSS, ajoutez le chemin du rpertoire SPSS, qui se prsente comme suit : SET PATH=%PATH%;<DR>:\program\SPSS. -Si vous navez pas encore install SPSS, copiez le lib SPSS IO spssio32.dll partir du CD dinstallation et copiez-le dans votre rpertoire system32.
Proprits du tSPSSInput
Famille du composant Business Intelligence
Le composant tSPSSInput lit les donnes de fichiers SPSS (.sav). Le tSPSSInput envoie des donnes SPSS pour les crire, dans un autre fichier par exemple. Sync schema Schema et Edit Schema Cliquez sur ce bouton pour synchroniser le schma avec les colonnes du fichier SPSS dentre. Pour ce composant, le schma des mtadonnes est directement rcupr partir du fichier SPSS dentre, cest pourquoi il est en lecture seule. Vous pouvez cliquer sur Edit schema pour voir les mtadonnes qui ont t rcupres. Indiquez le nom ou le chemin daccs au fichier SPPS lire. Cochez cette case pour traduire les tiquettes (labels) des valeurs stockes. Si vous cochez cette case, vous devrez nouveau rcuprer les mtadonnes.
File name Translate labels
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est utilis comme composant de dbut. Il requiert un composant de sortie.
Scnario : Afficher le contenu dun fichier SPSS

Le scnario suivant cre un Job deux composants qui permet de lire chaque ligne dun fichier SPSS (.sav) et de les afficher en sortie dans la console de log de la vue Run. A partir de la Palette, dposez les composants tSPSSInput et tLogRow dans lespace graphique.
255

tSPSSInput
Cliquez-droit sur le composant tPSSInput et connectez-le au tLogRow laide dun lien de type Main Row. Double-cliquez sur le composant tSPSSInput pour afficher la vue Basic settings et configurer ses paramtres.
Cliquez sur le bouton [...] ct du champ Filename pour parcourir vos dossiers jusquau fichier SPSS que vous voulez lire. Cliquez sur le bouton [...] ct du champ Sync schema. Un message apparat lcran pour vous inviter rcuprer le schma du fichier SPSS slectionn.
Cliquez sur le bouton Yes pour fermer le message. Si ncessaire, cliquez sur le bouton [...] ct du champ Edit schema pour visualiser la structure de donnes prdfinie dans le fichier SPSS source.
256

tSPSSInput
Cliquez sur le bouton OK pour fermer la bote de dialogue. Sauvegardez votre Job, et appuyez sur F6 afin de lexcuter. Le fichier SPSS est lu ligne par ligne, et les champs extraits sont affichs dans la console.
Afin deffectuer des traductions sur les valeurs stockes, procdez comme suit : Dans la vue Basic settings, cochez la case Translate label si vous voulez traduire les tiquettes (labels) des valeurs stockes. Cliquez nouveau sur le bouton Sync Schema, afin de rcuprer le schma aprs traduction. Un message apparat, vous demandant si vous souhaitez rcuprer le schma du fichier SPSS dfini. Cliquez sur Yes (Oui) pour fermer le message et procder ltape suivante. Un second message souvre et vous demande si vous souhaitez propager les modifications. Cliquez sur Yes (Oui) afin de fermer le message et passer ltape suivante. Enregistrez le Job puis appuyez sur la touche F6 pour lexcuter. Le fichier SPSS est lu ligne par ligne et les champs extraits sont affichs sur la console de log de la vue Run, aprs traduction des valeurs stockes.
257

tSPSSInput
258

tSPSSOutput
tSPSSOutput
Proprits du tSPSSOutput
Le composant tSPSSOutput crit des donnes dans un fichier SPSS (.sav). Le tSPSSOutput crit ou ajoute des donnes un fichier SPSS. Il cre les fichiers SPSS directement ou crase ceux qui existent dj. Sync schema Schema et Edit Schema Cliquez sur ce bouton pour synchroniser le schma avec les colonnes du fichier SPSS dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Filename Write Type Nom ou chemin daccs du fichier SPSS crire. Slectionnez dans la liste le type daction effectuer : Write: crit simplement les nouvelles donnes. Append: crit les nouvelles donnes la suite de celles existantes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant ne peut tre utilis comme composant de dbut. Il ncessite un flux dentre.
Scnario : Ecrire des donnes dans un fichier .sav

Ce scnario dcrit un Job trs simple qui crit des donnes dentre dans un fichier .sav. Glissez-dposez de la Palette dans lespace de modlisation graphique un tRowGenerator et un tSPSSOutput.
259

tSPSSOutput
Cliquez-droit sur le tRowGenerator, et connectez-le au tSPSSOutput, laide dun lien Row Main.
Dans lespace de modlisation graphique, double-cliquez sur le tRowGenerator afin dafficher sa vue Basic settings et ouvrir son diteur. Vous pouvez dfinir votre schma.
Cliquez sur le bouton [+] afin dajouter les colonnes que vous voulez crire dans le fichier .sav. Dfinissez le schma, et configurez les paramtres des colonnes.
Vrifiez que vous avez dfini la longueur de vos colonnes. Dans le cas contraire, un message derreur saffichera lors de la contruction du Job.
Cliquez sur OK afin de valider votre schma et fermer lditeur. Double-cliquez sur le tSPSSOutput afin dafficher sa vue Component et dfinir ses proprits.
260

tSPSSOutput
Cliquez sur le bouton [...] ct du champ Filename, et parcourez votre rpertoire jusquau fichier SPSS .sav dans lequel vous souhaitez crire les donnes. Cliquez sur le bouton [...] ct du bouton Sync columns, afin de synchroniser les colonnes avec celles du composant prcdent. Dans cet exemple, le schma devant tre insr dans le fichier .sav est compos de deux colonnes : id et country. Si ncessaire, cliquez sur le bouton Edit schema pour voir/diter le schma dfini. Dans la liste Write Type, slectionnez Write (crire) ou Append (crire la suite), pour simplement crire les donnes dentre dans le fichier .sav, ou bien les crire la fin de ce mme fichier. Sauvegardez votre Job, et appuyez sur F6 pour lexcuter. Les donnes gnres par le tRowGenerator sont crites dans le fichier .sav dfini.
261

tSPSSProperties
tSPSSProperties
Pour pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous de de suivre les tapes suivantes : -Si vous avez dj install SPSS, ajoutez le chemin du rpertoire SPSS, qui se prsente comme suit : SET PATH=%PATH%;<DR>:\program\SPSS. -Si vous navez pas encore install SPSS, copiez le lib SPSS IO spssio32.dll partir du CD dinstallation et copiez-le dans votre rpertoire system32.
Proprits du tSPSSProperties
Le composant tSPSSProperties dcrit les proprits dun fichier SPSS (.sav) dfini. Le tSPSSProperties permet dobtenir des informations sur les proprits principales dun fichier SPSS dfini. Schema et Edit Schema Pour ce composant, le schma des mtadonnes est prdfini, cest pourquoi il est en lecture seule. Vous pouvez cliquer sur Edit schema pour voir les mtadonnes prdfinies. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Filename Nom ou chemin daccs au fichier SPSS traiter.
Scnario associ
Pour des scnarios associs, consultez : Scnario : Afficher le contenu dun fichier SPSS, page 255 Scnario : Ecrire des donnes dans un fichier .sav, page 259
262

tSPSSStructure
tSPSSStructure
Proprits du tSPSSStructure
Fonction Purpose
Le composant tSPSSStructure rcupre les informations sur les variables contenues dans le fichier SPSS (.sav). Le tSPSSStructure traite les variables contenues dans des fichiers SPSS. Vous pouvez utiliser ce composant avec le tFileList pour rcuprer les informations des fichiers *.sav existant et les utiliser pour analyser de manire plus approfondie ou pour vrifier vos rsultats. Schema et Edit Schema Pour ce composant, le schma des mtadonnes est prdfini, cest pourquoi il est en lecture seule. Il correspond la convention interne SPSS. Vous pouvez cliquer sur Edit schema pour voir les mtadonnes prdfinies. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Filename Nom ou chemin daccs au fichier SPSS traiter.
Basic settings
Scnario associ
Pour des scnarios associs, consultez : Scnario : Afficher le contenu dun fichier SPSS, page 255
263

tSPSSStructure
Scnario : Ecrire des donnes dans un fichier .sav, page 259
264

tSybaseSCD
tSybaseSCD
Proprits du tSybaseSCD
Famille du composant Databases/Business Intelligence/Sybase Le composant tSybaseSCD reflte et traque les modifications dune table SCD Sybase ddie. Le tSybaseSCD adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes.
Fonction Objectif
Basic settings
265

tSybaseSCD
Table Schema et Edit Schema
SCD Editor
Lditeur SCD Editor permet de constuire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section Mthodologie de gestion du SCD, page 165. Cochez cette case pour amliorer les performances du systme. Cette case est dcoche par dfaut, ce qui vous permet de terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.
Advanced settings
Scnario associ
266

tSybaseSCDELT
tSybaseSCDELT
Proprits du tSybaseSCDELT
Famille du composant Databases/Business Intelligence/Sybase Le composant tSybaseSCDELT reflte et traque les modifications dune table Sybase SCD ddie. Le tSybaselSCDELT adresse des besoins en transformation Slowly Changing Dimension, en lisant rgulirement une source de donnes et en rpertoriant les modifications dans une table Sybase SCD ddie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tSybaseConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Source table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table contenant les donnes filtrer.
Fonction Objectif
Basic settings
267

tSybaseSCDELT
Table
Nom de la table crire. Notez quune seule table peut tre crire la fois pour que lopration dinsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Action on table
Source Key
268

tSybaseSCDELT
Use SCD Type 2 fields Utilisez le type 2 si vous avez besoin de traquer les modifications, pour garder une trace des mises jour effectues par exemple. Slectionnez les colonnes du schma qui servira de rfrence pour les modifications. Start date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de dpart. Vous pouvez slectionner lune des colonnes dentre du schma comme date de dpart (Start Date) dans la table SCD. End Date : Ajoute une colonne votre schma SCD pour dterminer la valeur de la date de fin pour le journal. Lorsque le journal est en mode actif, la colonne End Date a une valeur nulle ; pour viter cela, vous pouvez slectionner loption Fixed Year value et saisir une anne fictive. Log Active Status : Ajoute une colonne votre schma SCD pour renseigner les valeurs de statut true et false. Cette colonne permet de reprer facilement le journal actif. Log versions : Ajoute une colonne votre schma SCD pour renseigner le numro de version du journal. Advanced settings Additional JDBC parameters Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.
Debug mode
Scnario associ
Pour un scnario associ, consultez le composant tMysqlSCD, page 164 et son Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168.
269

tSybaseSCDELT
270
Composants Custom Code

Ce chapitre passe en revue les principaux composants prsents dans la famille Custom Code de la Palette de Talend Open Studio. La famille Custom Code regroupe tous les composants rpondant un besoin spcifique de cration de code la vole.

tGroovy
tGroovy
Proprits du tGroovy
Famille de composant Custom Code
Le tGroovy permet de saisir du code personnalis afin de lintgrer dans le programme Talend. Ce code est excut une seule fois. Le tGroovy permet dtendre les fonctionnalits du Job Talend grce au langage Groovy, qui est une syntaxe simplifie du Java.. Groovy Script Variables Saisissez le code Groovy que vous souhaitez excuter. Ce tableau comprend deux colonnes : Name : nom de la variable appele dans le code. Value : valeur associe cette variable. Cochez cette case pour collecter les donnes de log au niveau du composant.
tStatCatcher Statistics
Ce composant peut tre utilis en standalone, ou en tant que sous-job un seul composant. Il est ncessaire de connatre le langage Groovy.
Scnarios associs
Pour un scnario utilisant du Code Groovy, consultez le Scnario : Appeler du code Groovy contenu dans un fichier, page 273. Pour un exemple dutilisation proche dans le mode de fonctionnement, consultez le Scnario : Imprimer le contenu dune variable, page 275 du composant tJava.
272

tGroovyFile
tGroovyFile
Proprits du tGroovyFile
Le tGroovyFile permet dappeler un script existant dvelopp en Groovy. Le tGroovyFile permet dtendre les fonctionnalits du Job Talend grce au langage Groovy, qui est une syntaxe simplifie du Java.. Groovy File Variables Nom et chemin daccs au fichier contenant votre code Groovy. Ce tableau comprend deux colonnes : Name : nom de la variable appele dans le code. Value : valeur associe cette variable. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant peut tre utilis en standalone, ou en tant que sous-job un seul composant. Il est ncessaire de connatre le langage Groovy.
Scnario : Appeler du code Groovy contenu dans un fichier

Ce scnario comprend un composant unique, le tGroovyFile, utilis en standalone. Le Job a pour but dappeler un fichier contenant du code Groovy, afin de retourner dans la Console les informations contenues dans ce fichier. Il se prsente comme suit :
Dans la Palette, ouvrez le dossier Custom_Code, puis glissez-dposez un composant tGroovyFile dans lespace de modlisation graphique. Double-cliquez sur le composant afin dafficher sa vue Component.
273

tGroovyFile
Dans le champ Groovy File, saisissez le chemin daccs au fichier contenant votre Code Groovy, ou parcourez votre rpertoire. Dans le tableau Variables, ajoutez une ligne, en appuyant sur le bouton [+]. Dans la colonne Name, saisissez age, puis, dans, la colonne Value, saisissez 50, comme dans la capture dcran.
Appuyez sur F6 pour sauvegarder et excuter votre Job. La Console affiche les informations contenues dans le fichier dentre, auxquelles sajoute le rsultat de la variable.
274

tJava
tJava
Proprits du tJava
Le tJava permet de saisir du code personnalis afin de lintgrer dans le programme Talend. Ce code est excut une seule fois. Le tJava permet dtendre les fonctionnalits du Job Talend grce au langage Java. Code Saisissez le code Java que vous souhaitez excuter. Pour plus dinformations concernant la syntaxe des fonctions Java spcifiques Talend, consultez laide en ligne de Talend Open Studio dans le menu Help Contents > Developer Guide > API Reference. Pour la rfrence Java complte, allez sur : http://java.sun.com/javaee/6/docs/api/ Saisissez le code Java permettant dimporter, si ncessaire, la librairie externe utilise dans le champ Main code de longlet Basic settings. Cochez cette case pour collecter les donnes de log au niveau du composant.
Advanced settings
Import
tStatCatcher Statistics Utilisation Limitation
Ce composant est gnralement utilis en tant que sous-job un seul composant. Il est ncessaire de connatre le langage Java.
Scnario : Imprimer le contenu dune variable

Le scnario suivant est une simple dmonstration de lapplication possible du composant tJava. Lobjectif de ce Job est dimprimer les lignes traites laide dune commande Java et des variables globales fournies dans Talend Open Studio.
275

tJava
Cliquez et dposez les composants dans lespace de modlisation : tFileInputDelimited, tFileOutputExcel, tJava. Connectez le composant tFileInputDelimited au tFileOutputExcel laide dune connexion de type Row Main. Le contenu du fichier .txt dlimit sera transmis un fichier de type XSL via cette connexion sans subir de transformation. Ensuite, connectez le composant tFileInputDelimited au composant tJava laide dun lien de type Then Run. Ce lien met en place un squenage ordonnant au tJava de se lancer la fin du processus principal. Dfinissez les paramtres du composant tFileInputDelimited dans longlet Basic settings de la vue Component. Le fichier dentre utilis en exemple est un simple fichier texte deux colonnes : Name (des noms de personnes) et leur Emails respectifs.
Pour cet exemple, le schma na pas t centralis dans le rfrentiel, vous devez donc configurer manuellement le schma de ces deux colonnes. Cliquez sur le bouton Edit Schema.
Une bote de dialogue vous demandant si vous souhaitez propager les modifications apportes apparat, cliquez sur OK pour accepter la propagation. Ainsi, le schma du composant tFileOutputExcel est automatiquement renseign partir du schma du composant prcdent. Vous naurez donc pas dfinir le schma de nouveau. Paramtrez le fichier de sortie afin quil reoive le contenu du fichier dentre sans modifications. Si le fichier nexiste pas dj, il sera cr.
276

tJava
Dans cet exemple, dans le champ Sheet name, indiquez le nom de la feuille Excel, ici Email et la case Header est coche pour indiquer que le fichier contient un en-tte. Puis slectionnez le composant tJava pour dfinir la commande Java excuter.
Dans la zone Code, saisissez la commande suivante : String var = "Nb of line processed: "; var = var + globalMap.get("tFileInputDelimited_1_NB_LINE"); System.out.println(var); Dans cet exemple prcis, utilisez la variable NB_Line. Pour accder la liste des variables globales, appuyez sur Ctrl + Espace de votre clavier et slectionnez la variable globale correspondante. Enregistrez le Job et appuyez sur F6 pour lexcuter.
277

tJava
Le contenu est donc transmis au fichier Excel spcifi et le nombre de lignes traites est affich dans la console Run.
278

tJavaFlex
tJavaFlex
Proprits du tJavaFlex
Fonction
Le tJavaFlex permet de saisir du code personnalis afin de lintgrer dans le programme Talend. Avec le tJavaFlex, vous pouvez saisir les trois diffrentes parties du code Java (start, main et end) constituant un composant qui permet dexcuter une opration souhaite et non disponible dans les actuels composants Talend. Le tJavaFlex permet dtendre les fonctionnalits du Job Talend grce au langage Java. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Data Auto Propagate Cochez cette case pour propager automatiquement les donnes au composant suivant. Lorsque vous cochez cette case, les donnes rcupres ne peuvent tre transformes a posteriori dans le champ Main code Saisissez le code Java qui va tre appel lors de la phase dinitialisation. Saisissez le code Java qui va tre appliqu pour chaque ligne du flux. Saisissez le code Java qui va tre appel lors de la phase de clture. Saisissez le code Java permettant dimporter, si ncessaire, la librairie externe utilise dans le champ Main code de longlet Basic settings. Cochez cette case pour collecter les donnes de log au niveau du composant.
Start code Main code End code Advanced settings Import
279

tJavaFlex
Ce composant peut tre utilis en tant que composant de dbut, de milieu et de fin de Job, ainsi quen tant que sous-job un seul composant. Il est ncessaire de connatre le langage Java.
Scnario 1 : Gnrer un flux de donnes

Ce scnario dcrit un Job deux composants dont le but est de gnrer un flux de trois lignes dcrivant les diffrentes civilit : mademoiselle (Miss), madame (Mrs) et monsieur (Mr), et de les afficher dans la console.
Cliquez-glissez un composant tJavaFlex de la famille Custom Code et un composant tLogRow de la famille Logs & Errors dans le Job Designer. Connectez-les via un lien Row Main. Double-cliquez sur le composant tJavaFlex pour paramtrer ses proprits.
Dans la liste Schema, slectionnez le mode Built-in et cliquez sur le bouton [...] cot du champ Edit schema pour dcrire manuellement la structure des donnes passer au composant suivant.
280

tJavaFlex
Cliquez sur le bouton [+] pour ajouter deux colonnes : key de type Integer et value de type String. Cliquez Ok pour valider les changements et fermer la bote de dialogue. Dans les proprits du tJavaFlex, cochez la case Data Auto Propagate pour propager automatiquement les donnes au composant suivant. Dans cet exemple, neffectuez pas de transformation sur les donnes rcupres. Dans le champ Start code, saisissez le code qui sera excut lors de la phase dinitialisation. Ici, le code indique linitialisation du composant tJavaFlex en affichant le message START et met en place la boucle et les variables utilises par la suite dans le code Java : System.out.println("## START\n#"); String [] valueArray = {"Miss", "Mrs", "Mr"}; for (int i=0;i<valueArray.length;i++) {
Dans le champ Main code, saisissez le code qui sera appliqu pour chaque ligne de donnes. Ici, lobjectif est de retourner chaque cl (key) avec sa valeur : row1.key = i; row1.value = valueArray[i];
Dans le champ Main code, row1 correspond au nom du lien qui sort du tJavaFlex. Si vous renommez ce lien, il faut penser modifier le code de ce champ.
281

tJavaFlex
Dans le champ End code, saisissez le code qui sera excut lors de la phase de clture. Ici, laccolade ferme la boucle et le code indique la fin de lexcution du tJavaFlex en affichant le message END : } System.out.println("#\n## END"); Assurez-vous que le schma a bien t propag au tLogRow. Enregistrez le Job et appuyez sur F6 pour lexcuter.
La console affiche les trois civilits, ainsi que leur cls correspondantes.
Scnario 2 : Traiter des lignes de donnes avec le tJavaFlex

Ce scnario dcrit un Job deux composants gnrant des donnes de manire alatoire, rcuprant et traitant ces donnes ligne par ligne avec du code Java via le tJavaFlex.
Cliquez-glissez un composant tRowGenerator de la famille Misc et un composant tJavaFlex de la famille Custom Code dans le Job Designer. Connectez-les via un lien Row Main. Double-cliquez sur le composant tRowGenerator pour ouvrir son diteur.
282

tJavaFlex
Dans lditeur, cliquez sur le bouton [+] pour ajouter quatre colonnes : number, txt, date et flag. Dfinissez le schma en paramtrant ces quatres colonnes conformment la capture dcran prcdente. Dans la colonne Functions, slectionnez la fonction [...] dans la liste de chaque colonne. Dans la colonne Parameters, saisissez 10 paramtres diffrents pour chaque colonne. Ces 10 paramtres correspondent aux donnes qui seront retournes de manire alatoire lors de lexcution du tRowGenerator. Cliquez sur OK. Double-cliquez sur le composant tJavaFlex pour paramtrer ses proprits.
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Dans le champ Start code, saisissez le code qui sera excut lors de la phase dinitialisation. Ici, le code indique linitialisation du composant tJavaFlex en affichant le message START et dfinit une variable qui sera utilise par la suite dans le code Java : System.out.println("## START\n#"); int i = 0;
283

tJavaFlex
Dans le champ Main code, saisissez le code qui sera appliqu pour chaque ligne de donnes. Ici, lobjectif est dindiquer le numro de la ligne en partant de 0, puis afficher le numro et le texte alatoire que vous mettez en majuscules et la date alatoire dfinis dans le tRowGenerator. Ensuite, crez une condition affichant si le status est true (vrai) ou false (faux) et incrmentez le numro de la ligne : System.out.print(" row" + i + ":"); System.out.print("# number:" + row1.number); System.out.print (" | txt:" + row1.txt.toUpperCase()); System.out.print(" | date:" + row1.date); if(row1.flag) System.out.println(" | flag: true"); else System.out.println(" | flag: false"); i++;
Dans le champ Main code, row1 correspond au nom du lien qui sort du tJavaFlex. Si vous renommez ce lien, il faut penser modifier le code de ce champ.
Dans le champ End code, saisissez le code qui sera excut lors de la phase de clture. Ici, le code indique la fin de lexcution du composant tJavaFlex en affichant le message END : System.out.println("#\n## END"); Enregistrez votre Job et appuyez sur F6 pour lexcuter.
284

tJavaFlex
La console affiche les donnes gnres alatoirement et modifies laide du code Java dans le tJavaFlex.
285

tJavaRow
tJavaRow
Proprits du tJavaRow
Fonction
Le tJavaRow permet de saisir du code personnalis afin de lintgrer dans le programme Talend. Avec le tJavaRow, vous pouvez saisir le code Java qui va tre appliqu pour chaque ligne du flux. Le tJavaRow permet dtendre les fonctionnalits du Job Talend grce au langage Java. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Code Saisissez le code Java qui va tre appliqu pour chaque ligne du flux. Saisissez le code Java permettant dimporter, si ncessaire, la librairie externe utilise dans le champ Main code de longlet Basic settings. Cochez cette case pour collecter les donnes de log au niveau du composant.
Advanced settings
Import
Ce composant est utilis en tant que composant de milieu de Job, et doit tre reli un composant de dbut et un composant de sortie. Il est ncessaire de connatre le langage Java.
Scnario associ
286

tLibraryLoad
tLibraryLoad
Proprits du tLibraryLoad
Le tLibraryLoad permet dimporter une librairie. Le tLibraryLoad permet de charger des librairies Java utilisables dans un Job. Library Slectionnez dans la liste la librairie importer, ou cliquez sur le bouton [...] afin de parcourir votre rpertoire et choisir la librairie que vous souhaitez importer. Lib Paths : Saisissez entre guillemets le chemin daccs votre librairie. Saisissez le code Java permettant dimporter, si ncessaire, la librairie externe utilise dans le champ Main code de longlet Basic settings. Cochez cette case pour collecter les donnes de log au niveau du composant.
Advanced settings
Dynamic Libs Import
Ce composant peut tre utilis en standalone, mais il est plus logique de lutiliser dans un Job. n/a
Scnario : Vrifier le format dune adresse e-mail

Ce scnario comprend deux composants, un tLibraryLoad et un tJava. Le but de ce scnario est de vrifier le format dune adresse e-mail et de retourner si elle est valide ou non.
Dans la Palette, ouvrez le dossier Custom_Code, puis glissez-dposez les composants tLibraryLoad et tJava dans lespace de modlisation graphique.

tLibraryLoad
Reliez le tLibraryLoad au tJava laide dun lien Trigger > OnSubjobOk. Double-cliquez sur le tLibraryLoad pour afficher sa vue Basic settings. Dans la liste Library, slectionnez jakarta-oro-2.0.8.jar. Dans le champ Import, de longlet Advanced settings, saisissez import org.apache.oro.text.regex.*;
Double-cliquez sur le composant tJava pour afficher sa vue Component. Dans longlet des Basic settings, saisissez votre code, comme dans la capture dcran. Ce code permet de vrifier si une chane de caractres correspond une adresse e-mail, en se basant sur lexpression rgulire suivante : "^[\\w_.-]+@[\\w_.-]+\\.[\\w]+$".
Appuyez sur F6 afin denregistrer et dexcuter votre Job.
288

tLibraryLoad
La Console affiche false, cest--dire que ladresse e-mail nest pas valide. En effet, son format nest pas correct.
289

tSetGlobalVar
tSetGlobalVar
Proprits du tSetGlobalVar
Le composant tSetGlobalVar vous permet de dfinir et de configurer les variables globales dans linterface graphique. Le composant tSetGlobalVar simplifie le processus de dfinition des variables globales. Variables Ce tableau contient deux colonnes. Key : Nom de la variable appeler dans le code. Value : la valeur assigne cette variable. Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.
Advanced settings
Ce composant est gnralement utilis comme un sous-job un composant. La connaissance du langage Java est ncessaire.
Scnario : Afficher le contenu dune variable globale

Ce scnario se compose dun Job simple affichant la valeur dune variable globale dfinie dans le composant tSetGlobalVar.
Dposez les composants suivants de la Palette dans lespace de modlisation graphique : tSetGlobalVar et tJava. Reliez le tSetGlobalVar au tJava laide dun lien Trigger > OnSubjobOk. Double-cliquez sur le composant tSetGlobalVar afin dafficher sa vue Basic settings.
290

tSetGlobalVar
Cliquez sur le bouton [+] pour ajouter une ligne dans la table Variables, puis renseignez les colonnes Key et Value en saisissant respectivement K1 et 20. Double-cliquez ensuite sur le composant tJava afin dafficher sa vue Basic settings.
Dans la zone Code, saisissez le code suivant : String foo = "bar"; String K1; String Result = "The value is:"; Result = Result + globalMap.get("K1"); System.out.println(Result); Dans ce scnario, utilisez la variable Result. Pour accder la liste des variables globales, appuyez sur les touches Ctrl + Espace de votre clavier et slectionnez les paramtres correspondants. Sauvegardez votre Job et appuyez sur F6 pour lexcuter.
Le contenu de la variable globale K1 saffiche dans la console.
291

tSetGlobalVar
292
Composants Data Quality

Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Data Quality de la Palette de Talend Open Studio. La famille Data Quality regroupe les composants vous permettant damliorer la qualit de vos donnes. Ces composants couvrent divers besoin dont la comparaison de colonnes afin den extraire des donnes spcifiques.

tAddCRCRow
tAddCRCRow
Proprits du tAddCRCRow
Famille de composant Data Quality
Ce composant calcule une cl de substitution base sur une ou plusieurs colonne(s) et lajoute au schma dfini. Fournir un ID unique afin damliorer la qualit des donnes traites. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Implication Cochez la case correspondant aux colonnes dfinir comme cl de substitution et vrifier l'intgrit de leurs donnes. Slectionnez la longueur CRC. Plus le CRC est long, moins il y aura de risque derreur. Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Advanced settings
CRC type tStatCatcher Statistics
Ce composant est une tape intermdiaire. Cela requiert un flux entrant et une sortie. n/a
Scnario : Ajouter une cl de substitution un fichier

Ce scnario dcrit un Job ajoutant une cl de substitution un schma de fichier dlimit.
Glissez les composants suivants dans lespace de modlisation: tFileInputDelimited, tAddCRCRow et tLogRow.
294

tAddCRCRow
Connectez-les en utilisant un lien de type Main row. Dans la vue Component du tFileInputDelimited, renseignez le champ File Name en saisissant le chemin daccs votre fichier, ainsi que toutes les proprits en rapport, au cas o elles ne soient pas stockes dans le Repository.
Crez le schma en cliquant sur le bouton Edit Schema, si le schma nest pas encore stock dans le Repository. En Java, vrifiez la colonne du type de donnes, et pour remplir le Date pattern, visitez http://java.sun.com/j2se/1.5.0/docs/api/index.html. Dans la vue Component du composant tAddCRCRow, slectionnez les cases de la colonne du flux entrant utiliser pour calculer le CRC.
Notez quune colonne CRC (en lecture seule) a t ajoute la fin du schma. Dans les Advanced settings, slectionnez CRC32 comme CRC Type pour avoir une cl de substitution plus longue.
Dans la vue Basic settings du tLogRow, slectionnez loption Table (print values in cells of a table) pour afficher les donnes de sortie sous forme de tableau dans la Console. Sauvegardez votre Job et appuyer sur F6 pour lexcuter.

tAddCRCRow
Une colonne CRC supplmentaire a t ajoute au schma, calcule daprs toutes les colonnes prcdemment slectionnes (dans ce cas toutes les colonnes du schma).
296

tChangeFileEncoding
tChangeFileEncoding
Le tChangeFileEncoding appartient deux familles : Data Quality et File. Pour plus dinformations concernant le composant tChangeFileEncoding, consultez tChangeFileEncoding, page 1106.
297

tExtractRegexFields
tExtractRegexFields
Le tExtractRegexFields appartient deux familles : Data Quality et Processing. Pour plus dinformations concernant le composant tExtractRegexFields, consultez tExtractRegexFields, page 1519.
298

tFuzzyMatch
tFuzzyMatch
Proprits du tFuzzyMatch
Fonction
Le composant tFuzzyMatch compare une colonne du flux principal avec une colonne du flux de rfrence et extrait les donnes du flux principal en affichant la distance. Le tFuzzyMatch permet dassurer la qualit des donnes de nimporte quelle source de donnes en la comparant avec une source de donnes de rfrence. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Deux colonnes en lecture seule sont ajoutes automatiquement au schma de sortie : Value et Match. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Matching type Slectionnez lalgorithme de correspondance appropri parmi les suivants : Levenshtein : Bas sur la thorie de la distance ddition. Il calcule le nombre dinsertion, de suppression ou de substitution ncessaire pour correspondre la rfrence. Metaphone : Bas sur la phontique. Tout dabord, il charge les sonorits de toutes les entres du flux de rfrence (Lookup) et les compare avec celles des entres du flux principal (Main). Double Metaphone : une nouvelle version de lalgorithme phontique Metaphone, qui produit des rsultats plus prcis que lalgorithme original. Il peut retourner la fois un code primaire et secondaire pour une chane de caractres. Pour viter toute ambigut que le Metaphone naurait pas pu dtecter, utilisez cette option.
Objectif
Basic settings
299

tFuzzyMatch
Min distance
(Levenshtein uniquement) Dfinissez le nombre minimum de modifications autorises pour correspondre la rfrence. Si vous dfinissez 0, seules les correspondances exactes sont extraites. (Levenshtein uniquement) Dfinissez le nombre maximum de modificiations pouvant correspondre la rfrence. Slectionnez la colonne du flux principal qui doit tre compare avec la colonne cl du flux de rfrence (Lookup). Cochez cette case pour obtenir la meilleure correspondance possible, si plusieurs correspondances sont disponibles. Si plusieurs correspondances sont disponibles, elles seront toutes affiches sauf si la case Unique match est coche. Dfinissez le dlimiteur entre chaque correspondance.
Max distance
Matching column
Unique matching
Matching item separator
Utilisation Limitation/Conditions requises
Ce composant nest pas un composant de dbut (fond vert) et il ncessite deux composants dentre et un composant de sortie. Utilisateurs Perl : Assurez-vous que le package correspondant est install sur votre ordinateur. Consultez la vue Module pour connatre les modules installer.
Scnario 1 : Distance de Levenshtein de 0 pour les prnoms

Ce scnario dcrit un Job constitu de quatre composants dont le but est de vrifier la distance ddition comprise entre les colonnes First Name (prnom) dun fichier dentre et de comparer les donnes avec celles du fichier de rfrence. Le rsultat de cette vrification de la distance de Levenshtein et le contenu du flux principal sont affichs dans une table.
Cliquez et dposez les composants suivants de la Palette dans lespace de modlisation : tFileInputDelimited (x2), tFuzzyMatch et tFileOutputDelimited. Paramtrez les proprits du composant tFileInputDelimited partir de longlet Basic settings. Parcourez votre rpertoire et slectionnez le fichier dentre analyser. Mais surtout dfinissez le schma utiliser par le flux vrifier. Dans le schma, dfinissez le Type de donnes en version Java, surtout si vous tes en mode Built-in.
300

tFuzzyMatch
Connectez ce composant dentre au tFuzzyMatch laide dune connexion de type Main Row. Dfinissez le deuxime composant tFileInputDelimited de la mme manire.
Assurez-vous que la colonne de rfrence a bien t dfinie comme colonne cl dans le schma du flux de rfrence (lookup).
Puis connectez le deuxime composant dentre au tFuzzyMatch laide dune connexion main row (qui apparat comme une connexion Lookup row dans lespace de modlisation). Dfinissez les proprits du tFuzzyMatch dans longlet Basic settings. Le Schma doit correspondre celui du flux dentre principal (Main) afin que le flux principal soit compar au flux de rfrence.
Notez que deux colonnes : Value et Matching sont ajoutes au schma de sortie. Elles correspondent des informations standard de correspondance et sont en lecture seule. Slectionnez la mthode utiliser pour la vrification des donnes entrantes. Dans ce scnario, la correspondance slectionner dans le champ Matching type est de type Levenshtein. Ensuite dfinissez la distance. Dans cette mthode, la distance est le nombre de caractres modifis (insertion, suppression ou substitution) pour que lentre principale corresponde exactement lentre de rfrence.
301

tFuzzyMatch
Dans ce scnario, lobjectif est de faire en sorte que la distance soit de 0 en minimum et en maximum dans les champs Min. distance et Max. distance. Ce qui signifie que seule une correspondance exacte sera redirige en flux de sortie. Dcochez la case Case sensitive pour ne pas prendre en compte la casse. Et dans le champ Matching column, slectionnez la colonne du flux principal qui doit tre vrifie. Dans cet exemple, le prnom (First name). Ne cochez pas la case Unique matching et ne modifiez pas le sparateur. Connectez le tFuzzyMatch un composant de sortie standard type tLogRow. Ne dfinissez aucun autre paramtre que le dlimiteur pour ce scnario. Enregistrez le Job et appuyez sur la touche F6 pour excuter le Job.
Comme la distance ddition dfinie est de 0 (min. et max.), la sortie correspond une jointure entre le flux principal et le flux de rfrence (lookup), ainsi seules les correspondances totales avec une valeur gale 0 sont affiches. Pour un exemple plus vident avec une distance minimum de 1 et une distance maximum de 2, consultez Scnario 2 : Distance de Levenshtein de 1 ou 2 pour les prnoms page 302.
Scnario 2 : Distance de Levenshtein de 1 ou 2 pour les prnoms

Ce scnario est bas sur le scnario 1 dcrit ci-dessus. Seuls les paramtres distance min. et max. du composant tFuzzyMatch sont modifis, ce qui modifiera la sortie affiche. Dans la vue Component du tFuzzyMatch, modifiez la distance min. de 0 1. Ceci exclut directement les correspondances exactes (qui ont une distance de 0). Maintenant mettez une distance max. de 2 puisque la distance max. ne peut tre infrieure la distance min. La sortie correspond toutes les donnes mises en correspondance contenant une diffrence de 2 caractres au plus.
302

tFuzzyMatch
Aucune autre modification de paramtres nest ncessaire. Assurez-vous que le sparateur de champs (Matching item separator) est bien dfini, vu que plusieurs entres de rfrence peuvent correspondre lentre du flux principal. Enregitrez votre nouveau Job et appuyez sur F6 pour lexcuter.
Etant donn que la distance ddition a t dfinie 2, certaines entres du flux principal correspondent plusieurs entres de rfrence (lookup). Vous pouvez utiliser une autre mthode, la Mtaphone, pour valuer la distance entre le flux principal et le flux de rfrence.
Scnario 3 : Distance mtaphonique pour les prnoms

Ce scnario est bas sur le scnario 1 dcrit plus haut.
Modifiez le champ Matching type avec loption Metaphone. Aucune distance minimum et aucune distance maximum ne sont dfinir puisque cette mthode est base sur les diffrences de phontique avec la rfrence.
303

tFuzzyMatch
Enregistrez le Job et appuyez sur F6. La valeur phontique est affiche avec les correspondances possibles.
304

tIntervalMatch
tIntervalMatch
Proprits du tIntervalMatch
Fonction
Le composant tIntervalMatch permet dtablir une jointure entre un flux principal et un flux de rfrence (en Java) ou un fichier de rfrence (en Perl). Il classe une valeur spcifie du flux principal dans la fourchette de valeurs correspondante dfinie dans le flux de rfrence et retourne les informations correspondantes. Il aide retourner une valeur laide dune jointure. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous effectuez des modifications, le schma passera automatiquement en Built-in. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Java only Search column Slectionnez la colonne du flux principal contenant les valeurs qui doivent tre mises en correspondance avec lintervalle de valeurs.
Column (LOOKUP) Slectionnez la colonne du flux lookup contenant les valeurs qui doivent tre retournes quand la jointure est ok. Lookup Column min/ bounds strictly (min) Lookup Column max/ bounds strictly (max) Advanced settings tStatCatcher Statistics Slectionnez la colonne contenant la valeur minimale de lintervalle. Cochez la case si la limite est stricte. Slectionnez la colonne contenant la valeur maximale de lintervalle. Cochez la case si la limite est stricte Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Ce composant manipule un flux de donnes, il requiert donc un Input et un Output, et ncessite la dfinition dune tape intermdiaire. n/a
Les proprits en Perl sont trop diffrentes de celles en Java, elles sont donc dcrites dans le tableau ci-dessous..

tIntervalMatch
PERL basic settings Basic settings Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous effectuez des modifications, le schma passera automatiquement en Built-in. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Perl only File Name Saisissez le nom du fichier contenant lintervalle de donnes. Cela fonctionne comme un flux lookup. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes. Position de la colonne min dans le fichier lookup: 0 pour la premire colonne, 1 pour la seconde colonne, etc. Vrifiez que les colonnes min et max de lintervalle soient adjacentes. Slectionnez la colonne du flux principal contenant les valeurs qui doivent tre mises en correspondance avec lintervalle de valeurs.
Field separator Row separator Lookup index Column
Search column
Usage Limitation
Ce composant manipule un flux de donnes, il requiert donc un Input et un Output, et ncessite la dfinition dune tape intermdiaire. . Pour le moment, la version Perl du tIntervalMatch naccepte pas un vrai flux lookup (mais seulement un fichier de rfrence dans les paramtres actuels du composant).
Scnario : Identifier le pays partir de lIP (Perl et Java)

Le scnario suivant dcrit un Job conu paralllement dans les deux langages, Perl et Java. Dans ce Job, un flux principal entrant transmet un schma deux colonnes: Documents et IP, contenant des donnes factices. Un second fichier est utilis comme flux lookup en Java, comme fichier de rfrence en Perl, et contient une liste classe dintervalles dIP ainsi que le pays qui leur correspond. Ce Job a pour but de retrouver les pays de chaque document partir de la valeur de leur IP, en dautres termes, de crer une jointure entre le flux principal et le flux de rfrence.
306

tIntervalMatch
En Perl, le Job requiert un tFileInputDelimited, un tIntervalMatch et un tLogRow.
En Java, le Job requiert un tFileInputDelimited supplmentaire, un tIntervalMatch et un tLogRow. Glissez le composant dans lespace de modlisation. Configurez les paramtres de base dans la vue Component du tFileInputDelimited.
Le schma se compose de deux colonnes, respectivement Document et IP. (En Java uniquement) Configurez la colonne Type en String pour la colonne Document et en Integer pour la colonne IP. (En Java uniquement) Configurez maintenant les proprits du deuxime tFileInputDelimited.
307

tIntervalMatch
(En Java uniquement) Noubliez pas de dfinir le Type des donnes. (En Java et en Perl) Propagez le schma du flux principal entrant au composant tIntervalMatch.
(En Java et en Perl) Notez que le schma Output du composant tIntervalMatch est en lecture seule et est compos du schma de lInput ainsi que dune colonne supplmentaire lookup qui redirigera en sortie les donnes lookup demandes. Configurez les autres proprits du composant tIntervalMatch. (En Perl uniquement) Le fichier lookup est dfini directement dans les proprits du tIntervalMatch.
(En Perl uniquement) Dans le champ File Name, renseignez le chemin daccs au fichier lookup. Renseignez le Row et le Field separator du fichier lookup. (En Perl uniquement) Dans le champ Lookup column index, paramtrez la limite infrieure de lintervalle des donnes. Cela correspond la position de la colonne contenant la valeur minimum de lintervalle (0 pour la premire colonne). (En Perl uniquement) Il ny a pas besoin de configurer les valeurs lookup retourner puisque toutes les valeurs du fichier lookup seront transmises en sortie.
308

tIntervalMatch
(En Java uniquement) Configurez les autres proprits du tIntervalMatch, notamment les colonnes min et max correspondant aux limites de lintervalle.
(En Java uniquement) Dans le champ Column Lookup, slectionnez la colonne dans laquelle les valeurs devront tre retournes. (En Java et en Perl) Dans le champ Search column, slectionnez la colonne du flux principal contenant les valeurs qui devront correspondre aux valeurs de lintervalle. (En Java et en Perl) Le composant tLogRow ne requiert pas de configuration particulire pour ce Job. Les Jobs en Perl et en Java crivent le mme rsultat avec des lgres diffrences dans la prsentation.
Le rsultat en Perl inclut lintervalle de valeurs alors que la sortie Java inclut seulement les valeurs demandes retournes (pays).
309

tParseAddress
tParseAddress
Proprits du tParseAddress
Ce composant analyse les adresses dans une colonne dfinie du schma et les dcoupe par types de champs. Dcouper les donnes en diffrentes colonnes pour trier les diffrentes parties afin damliorer la qualit des donnes traites. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Column to parse Country Slectionnez la colonne dont vous souhaitez analyser et dcomposer les donnes. Slectionnez le pays do proviennent les clients. Cochez cette case pour que le composant corrige la casse, cest--dire quil mette, au besoin, une majuscule en dbut de nom, et le reste en minuscules. Cochez cette case pour commencer par supprimer les caractres non alphanumriques avant d'essayer de dcomposer les adresses. Cochez cette case pour abrger automatiquement le nom des rgions ou provinces. Si le nom est dj sous sa forme abrg, il ne sera pas modifi. Cochez cette case pour nautoriser que les noms de rgions ou provinces abrgs. Le traitement des donnes sera plus rapide et vrifiera que ladresse correspond bien aux standards postaux. Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Advanced settings
Correct case
Auto clean
Abbreviate subcountry Allow only abbreviated subcountry tStatCatcher Statistics Utilisation Limitation
310

tParseAddress
Scnario associ
311

tParseName
tParseName
Proprits du tParseName
Fonction Objectif
Ce composant rcupre des noms sous diffrentes formes et en extrait chaque lment en fonction de son type. Analyser un fichier contenant des noms et en extraire les lments selon leur type, afin damliorer la qualit des donnes traites, en rejetant les lments errons. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Column to parse Slectionnez la colonne dont vous souhaitez extraire les diffrents lments. Cochez cette case pour ignorer les donnes contenant des noms joints. Cocher cette option permet un gain de rapidit. Dcochez-la pour que ces donnes soient retournes et dcoupes par type. Cochez cette case pour que les noms entrs en ordre invers soient traits. Le composant remet le nom dans lordre, et effectue lanalyse normale. Notez que si le nom peut tre analys, son ordre originel nest pas enregistr comme proprit. Cochez cette case afin de pouvoir utiliser tous les titres possibles. Si vous la dcochez, vous ne pourrez utiliser que les titres standards. Cochez cette case pour que le composant corrige la casse, cest--dire quil mette, au besoin, une majuscule en dbut de nom, et le reste en minuscules. Cochez cette case pour commencer par supprimer les caractres non alphanumriques avant d'essayer de dcomposer les adresses.
Basic settings
Advanced settings
Ignore joint names. Mr John Smith and Ms Mary Jones -> Mr John Smith Allow reversed. Smith, Mr AB -> Mr AB Smith
Extend titles
Correct case
Auto clean
312

tParseName
Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Scnario associ
313

tReplaceList
tReplaceList
Proprits du tReplaceList
Le tReplaceList effectue un rechercher/remplacer dans les colonnes dentre spcifies en fonction des donnes de rfrence (lookup). Ce composant permet de nettoyer tous les fichiers avant un traitement futur. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Deux colonnes en lecture seule, Value et Match sont automatiquement ajouts au schma de sortie. Le type de donnes dfini dans les schmas doit tre cohrent, cest--dire quun entier ne peut tre remplac que par un entier en utilisant un entier comme champ de rfrence. Une valeur dun type ne peut tre remplace par une valeur dun autre type. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Lookup search column Saisissez le numro de la colonne sur laquelle effectuer la recherche dans le schma de lookup. 0 : la premire colonne lue 1 : la deuxime colonne lue n : numro de la colonne dans le schma lu.
Afin de sassurer que les valeurs cherches sont uniques, assurez-vous que la colonne soit dfinie comme cl dans votre schma de lookup. Lookup replacement Saisissez le numro de la colonne dans laquelle column les valeurs de remplacement sont stockes. 0 : la premire colonne lue 1 : la deuxime colonne lue n : numro de la colonne dans le schma lu Column options Slectionnez les colonnes du flux principal dans lequel le remplacement est effectu.
314

tReplaceList
Advanced settings
Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Utilisation
Ce composant est un composant intermdiaire, il ncessite un composant dentre et un composant de sortie.
Scnario : Remplacement partir dun fichier de rfrence

Le Job suivant effectue un rechercher/remplacer sur une liste dEtats avec leur code correspondant. Les codes correspondant sont extraits dun fichier de rfrence plac en flux Lookup dans le Job. Le flux principal est dupliqu et les deux sorties sont affiches dans la console, pour constater ltat du flux principal avant et aprs remplacement.
Cliquez et dposez les composants suivants de la Palette : tMysqlInput, tFileInputDelimited, tReplicate, tReplaceList et tLogRow (x2). Notez que si vos schmas dentre sont dj centraliss sur le Repository, vous pouvez, dun simple cliquer-dposer, les faire passer du noeud correspondant du rpertoire Metadata du Repository vers lespace de modlisation. Cela permettra de rcuprer automatiquement les proprits des composants dentre. Pour plus dinformations, consultez Dposer des composants partir du rpertoire Metadata du Guide utilisateur de Talend Open Studio. Connectez les composants laide de liens Main Row via un clic-droit sur chaque composant. Notez que le lien de type main row provenant du flux de rfrence (tFileInputDelimited) se nomme lookup row. Slectionnez le composant tMysqlInput et dfinissez les paramtres du flux dentre.
315

tReplaceList
Le schma dentre est compos de deux colonnes : Names, States. La colonne States regroupe le nom des Etats des Etats-Unis qui seront remplacs par leur code respectif. Dans le champ Query, assurez-vous que la colonne State est incluse dans la dclaration Select. Dans cet exemple, toutes les colonnes sont slectionnes. Vrifiez les paramtres du composant tReplicate. Le schma est simplement divis en deux flux identiques, mais aucun changement na t effectu sur le schma. Puis double-cliquez sur le composant tFileInputDelimited, pour paramtrer le fichier de rfrence.
Le fichier comporte deux colonnes : Postal et State. Postal correspond au code postal de lEtat de la colonne State correspondante. Les champs sont dlimits par des point-virgules et les lignes par des retours chariot. Modifiez le schma du flux lookup.
316

tReplaceList
Assurez-vous que la colonne lookup sur laquelle est effectue la recherche (dans cet exemple : State) est dfinie comme cl, pour sassurer que les donnes cherches sont uniques. Slectionnez le composant tReplaceList et paramtrez lopration effectuer. Le schma est rcupr partir du composant prcdent dans le flux principal.
Dans le champ Lookup search index, renseignez la position de la colonne sur laquelle est effectue la recherche. Dans cet exemple, State est la deuxime colonne du fichier dentre lookup. Ainsi, saisissez 1 dans ce champ. Dans le champ Lookup replacement index, renseignez le numro de la colonne contenant les valeurs de remplacement, dans cet exemple : Postal pour le code postal de lEtat. Dans le tableau Column options, slectionnez la colonne States puisque dans cet exemple le nom des Etats doit tre remplac par leur code correspondant. Pour les deux composants tLogRow, cochez la case Print values in table cells pour que les sorties soient plus claires. Enregistrez le Job et excutez-le en appuyant sur F6.
317

tReplaceList
Le premier flux de sortie affiche la colonne States avec les noms des Etats puisquil provient du flux dentre principal. Le deuxime flux affiche la colonne States aprs que le nom des Etats aient t remplacs par leur codes postaux respectifs.
318

tSchemaComplianceCheck
Proprits du tSchemaComplianceCheck
Famille de composant Fonction Data Quality
Ce composant valide toutes les lignes dentre en fonction du schma de rfrence ou vrifie le type, la nullabilit, la longueur de la ligne en fonction des valeurs de rfrence. Cette validation peut tre applique lensemble des lignes ou une partie seulement. Le tSchemaComplianceCheck permet dassurer la qualit des donnes de nimporte quelle source de donnes en les comparant aux donnes de rfrence. Base Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Dfinissez la structure et la nature des donnes traiter. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur Talend Open Studio. Perl uniquemen t Date language/ Date format Pour la validation du format de date du type 25 Dec 2007, utilisez le champ Date Language et pour distinguer lordre daffichage du mois et du jour, utilisez le champ Date format. Cochez cette option si vous souhaitez effectuer la vrification sur toutes les colonnes du schma de base. En Perl, il sagit dune case -- lorsque celle-ci est coche, le tableau Columns to check est cach. Cochez cette option si vous souhaitez effectuer la vrification sur des colonnes en particulier. Lorsque cette option est coche, le tableau Checked Columns ainsi que la case Trim the excess content of column when length checking chosen and the length is greater than defined length apparaissent.
Check all columns from schema
Java uniquemen t
Custom defined
Checked Columns (en Dfinissez dans ce tableau quelles sont les vrifications Perl : Columns to check) effectuer, et sur quelles colonnes. Column :: Affiche les noms des colonnes.
319

Type : En Perl, cochez la case de la colonne dont vous souhaitez vrifier les donnes en fonction du schma de base dfini. Pour effectuer cette vrification sur toutes les colonnes, cochez la case den-tte du tableau. En Java, slectionnez les proprits que les donnes doivent avoir. Cette validation est obligatoire pour toutes les colonnes. Java uniquement Java uniquement Date pattern : Dfinissez le format de date souhait sur chaque colonne avec le type de donnes Date. Nullable : Cochez la case de la colonne que vous souhaitez dfinir comme colonne nullable, afin de permettre aux lignes ayant cette colonne vide de se diriger vers le flux de sortie sans tenir compte du schma de base dfini. Pour dfinir toutes les colonnes comme nullables, cochez la case den-tte du tableau. Undefined or empty : Cochez la case de la colonne dont vous souhaitez rejeter les lignes qui ont cette colonne vide alors quelle nest pas nullable dans le schma de base dfinir. Pour effectuer cette vrification sur toutes les colonnes, cochez la case den-tte du tableau. Max length : Cochez la case de la colonne dont vous souhaitez vrifier la longueur des donnes en fonction de la longueur dfinie dans le schma de base. Pour effectuer cette vrification sur toutes les colonnes, cochez la case den-tte du tableau. Java only Trim the excess content of column when length checking chosen and the length is greater than defined length Use another schema for compliance check Cochez cette case afin denlever la partie en trop (en fonction de la longueur dfinie) depuis le flux de sortie plutt que de rejeter la ligne quand loption de vrification de la longueur des donnes est coche. Dfinissez un schma de rfrence en donnant aux donnes les proprits quelles sont censes avoir. Ainsi, les donnes non conformes seront rejetes. Ces proprits peuvent correspondre au type de donnes, aux valeurs nulles, et/ou la longueur des donnes. Cochez cette case afin deffectuer une vrification rapide du format de date en utilisant la mthode TalendDate.isDate() de la routine systme TalendDate lorsque Date pattern (format de date) nest pas dfini. Pour plus dinformations concernant les routines, consultez Gestion des routines dans le Guide utilisateur Talend Open Studio. Cochez cette case afin de traiter tous les champs vides de chaque colonne comme des valeurs nulles, plutt que comme des chanes de caractres vides. Cette case est coche par dfaut. Lorsquelle est dcoche, le tableau Choose Column(s) saffiche pour vous permettre de slectionner les colonnes que vous souhaitez.. Cochez cette case pour collecter les donnes de log au niveau du composant.
Perl uniquement
Advanced settings
Use Fastest Date Check
Java uniquemen t
Treat all empty string as NULL
Java uniquemen t
320

Utilisation
Ce composant est un composant intermdiaire permettant dexclure les donnes non conformes du flux principal. Ce composant ne peut tre utilis comme composant de dbut puisquil requiert un flux dentre. Il ncessite aussi au moins un composant de sortie afin de regrouper les flux valids et ventuellement un deuxime pour les donnes rejetes via un lien Rejects. Pour plus dinformations, consultez Types de connexions du Guide utilisateur de Talend Open Studio.
Scnario : Valider les dates en fonction dun schma (java)

Ce scnario trs basique permet de vrifier le type, la nullabilit et la longueur des donnes du flux dentre en fonction du schma de rfrence dfini. Le flux dentre provient dun fichier csv simple contenant des donnes dont les proprits ont un mauvais type, un mauvais id, dont les donnes sont suprieures la longueur maximum, ou contenant des valeurs nulles dans les colonnes alors que celles-ci sont dfinies comme non nullables.
Lors de la validation, les donnes valides ainsi que les donnes rejetes sont affiches respectivement dans deux tableaux de la console.
A partir de la Palette, cliquez et dposez les composants suivants dans lespace de modlisation graphique : tFileInputDelimited, tSchemaComplianceCheck, ainsi que deux composants tLogRow. Cliquez-droit sur le tFileInputDelimited pour le connecter au composant tSchemaComplianceCheck via une connexion Row Main.
321

Cliquez-droit sur le composant tSchemaComplianceCheck et slectionnez Row > Main pour le connecter au premier composant tLogRow. Ce flux de sortie ne contiendra que les donnes valides. Cliquez-droit une deuxime fois sur le composant tSchemaComplianceCheck et cette fois slectionnez Row > Rejects pour le connecter au second composant tLogRow. Cette deuxime sortie regroupera toutes les donnes non conformes. Slectionnez le lien Rejects que vous venez de connecter, vous remarquerez que le schma transmis au second tLogRow contient deux nouvelles colonnes : ErrorCode et ErrorMessage. Ces deux colonnes sont en lecture seule et fournissent des informations sur les donnes rejetes, afin de faciliter le traitement et la correction des erreurs, si ncessaire. Double-cliquez sur le composant tFileInputDelimited afin dafficher sa vue Basic settings.
Renseignez le chemin daccs au fichier dentre dans le champ File Name. Spcifiez quelle est la ligne den-tte. Dans ce scnario, il sagit de la premire ligne. Laissez les autres paramtres tels quils sont. Cliquez sur Edit Schema pour dcrire la structure de donnes de ce fichier dentre. Dans ce scnario, le schma est compos de cinq colonnes : ID, Name, BirthDate, State, et City.
322

Laissez le champ Type aussi permissif que possible (particulirement en Java). Vous dfinirez le type de donnes rel dans la vue Component du composant tSchemaComplianceCheck. Renseignez le champ Length des colonnes Name, State et City : respectivement 7, 10 et 10. Puis double-cliquez sur le composant tSchemaComplianceCheck pour configurer les paramtres de validation.
Cochez loption Custom defined dans la zone Mode pour effectuer des validations personnalises. Dans cet exemple, le tableau Checked columns permet de configurer les paramtres de validations. Cependant, vous pouvez aussi cocher la case Check all columns from schema si vous souhaitez vrifier tous les paramtres de toutes les colonnes (type, valeurs nulles et longueur), en fonction du schma de base dfini, ou encore cocher loption Use another schema for compliance check et dfinir le schma de la structure des donnes souhait. Dans le tableau Checked Columns, dfinissez les vrifications effectuer. Pour ce scnario : - Slectionnez Int comme Type de donnes de la colonne ID. - Cochez la case Length afin que les longueurs des colonnes Name, State et City soient vrifies. - Slectionnez Date comme Type de donnes de la colonne BirthDate, et dd-MM-yyyy comme Date pattern. - Dcochez la case Nullable afin que les valeurs nulles de toutes les colonnes soient vrifies.
323

Pour rejeter les champs dont les donnes sont suprieures la longueur maximum dfinie, assurez-vous que la case Trim the excess content of column when length checking chosen and the length is greater than defined length est dcoche.
Dans la vue Advanced settings du composant tSchemaComplianceCheck, cochez la case Treat all empty string as NULL afin de rejeter toutes les lignes contenant des champs vides. Pour visualiser le rsultat du processus de validation sous forme de tableau dans la console Run, double-cliquez sur chaque composant tLogRow et cochez la case Table dans leur vue Basic settings. Enregistrez votre Job et appuyez sur F6 pour lexcuter. Deux tableaux saffichent dans la console, qui montrent respectivement les donnes valides et les donnes rejetes.
324

tUniqRow
tUniqRow
Proprits du tUniqRow
Le composant tUniqRow compare les entres et supprime les doublons du flux dentre. Ce composant assure une qualit de donnes des flux dentre et de sortie du Job. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous effectuez des modifications, le schma passera automatiquement en built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent dans le Job. Si vous souhaitez supprimer les doublons sur des colonnes en particulier, paramtrez-les dans le schma. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement ; Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Unique key Slectionnez dans cette zone une ou plusieurs colonnes sur lesquelles le ddoublonnage sera effectu. - Cochez la case Key attribute afin deffectuer le ddoublonnage sur toutes les colonnes. - Cochez la case Case sensitive afin de diffrencier les majuscules et les minuscules. Cochez cette case si vous souhaitez envoyer uniquement les premires entres en doublon des colonnes dfinies comme cl(s) vers le flux de sortie des doublons.
Advanced settings
Only once each duplicated key
325

tUniqRow
Use of disk (suitable Cochez cette case pour permettre la gnration de for processing large fichiers temporaires sur le disque dur lors du row set) traitement de donnes volumineuses. Cela permet dempcher lchec de lexcution dun Job d un dbordement de la mmoire. Quand cette case est coche, vous devez galement dfinir les lments suivants : - Buffer size in memory: Slectionnez le nombre de lignes mettre en mmoire tampon avant quun fichier temporaire ne soit gnr sur le disque dur. - Directory for temp files: Indiquez lendroit o les fichiers temporaires doivent tre enregistrs. Assurez-vous que le rpertoire indiqu pour vos fichiers temporaires existe, sans quoi lexcution du Job chouera. tStatCatcher Statistics Utilisation Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Ce composant est un composant intermdiaire puisquil sert traiter un flux de donnes. Ainsi, il ncessite un composant dentre et un composant de sortie. n/a
Limitation
Scnario : Ddoublonner des donnes

Ce scnario Java dcrit un Job cinq composants, dont le but est de trier des entres partir dune liste dentre comprenant des noms, de trouver des noms en doublons, et dafficher les noms uniques ainsi que les noms en doublon dans la console Run.
A partir de la Palette, cliquez et dposez les composants suivants dans lespace de modlisation graphique : un tFileInputDelimited, un tSortRow, un tUniqRow, ainsi que deux composants tLogRow, et nommez-les comme illustr ci-dessus. Connectez les composants tFileInputDelimited, tSortRow, et tUniqRow via une connexion de type Row > Main. Connectez ensuite le tUniqRow au premier tLogRow via une connexion Main > Uniques, puis connectez le composant tUniqRow au second tLogRow via une connexion de type Main > Duplicates.
326

tUniqRow
Double-cliquez sur le composant tFileInputDelimited afin dafficher longlet Basic settings de sa vue Component.
Slectionnez Built-In dans le champ Property Type. Cliquez sur le bouton [...] ct du champ File Name pour slectionner le fichier contenant les donnes dentre. Dfinissez len-tte (Header) et le pied de page (Footer) Dans ce scnario, la ligne den-tte est la premire ligne du fichier dentre. Cliquez sur Edit schema pour dfinir le schma de ce composant. Dans ce scnario, le fichier dentre comprend cinq colonnes : Id, FirstName, LastName, Age, et City. Click ensuite sur OK pour propager le schma et fermer lditeur de schma.
Afin de disposer les entres en fonction de lordre alphabtique des noms, ajoutez deux lignes au tableau Criteria en cliquant sur le bouton [+], slectionnez les colonnes FirstName et LastName sous Schema column, slectionnez le type de tri alphabtique (alpha), puis slectionnez lordre ascendant (asc). Double-cliquez sur le composant tUniqRow afin dafficher longlet Basic settings de sa vue Component.
327

tUniqRow
Dans la zone Unique key, slectionnez les colonnes sur lesquelles vous souhaitez effectuer le ddoublonnage. Dans ce scnario, les noms en doublon seront tris. Dans longlet Basic settings de la vue Component des deux composants tLogRow, cochez loption Table afin de visualiser le rsultat de lexcution du Job en mode tableau. Sauvegardez votre Job, puis appuyez sur F6 pour lexcuter. Dans la console Run, les noms uniques et les noms en doublon sont affichs dans des tableaux diffrents.
328
Composants Databases
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Databases de la Palette de Talend Open Studio. La famille Databases regroupe les connecteurs de bases de donnes les plus populaires. Ces connecteurs couvrent divers besoins : ouverture de connexion, lecture et criture de tables, commit de transactions, ainsi que des rollbacks pour le traitement des erreurs. Plus de 40 SGBDR sont supports.
tAccessBulkExec
tAccessBulkExec
Proprits du tAccessBulkExec
Les composants tAccessOutputBulk et tAccessBulkExec sont gnralement utiliss ensemble pour crire des donnes dans un fichier dlimit puis effectuer diffrentes actions sur le fichier dans une base de donnes Access, processus en deux tapes. Ces deux tapes sont regroupes dans le composant tAccessOutputBulkExec, dtaill dans une section spare. Lintrt dutiliser un processus en deux tapes rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Famille de composant Fonction Objectif Basic settings Databases/Access Le composant tAccessOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tAccessBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Access Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tAccessConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. DB Version Slectionnez la version dAccess que vous utilisez
330
tAccessBulkExec
Database Username and Password Action on table
Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create table : supprimer la table puis en crer une nouvelle. Create table : crer une table qui nexiste pas encore. Create table if not exists : crer la table si ncessaire. Clear table : supprimer le contenu de la table. Truncate table : supprimer le contenu de la table mais sans possibilit de Rollback. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit exister pour que lopration Insert soit authorise. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Vous pouvez effectuer, sur les donnes de la table dfinie, lopration que vous souhaitez : Insert : ajoute de nouvelles entres la table. Un schma est une description de ligne, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant (Repository). Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : How to set a built-in schema of Talend Open Studio User Guide. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio.
Table
Local filename
Action on data
Advanced settings
Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option nest pas disponible lorsque vous utilisez loption Use an existing connection dans les Basic settings. Cochez cette case pour inclure len-tte des colonnes dans le fichier.
Include header
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Usage Ce composant est gnralement utilis avec le composant tAccessOutputBulk. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donns Access.
331
tAccessBulkExec
Scnarios associs
Pour plus dinformations relatives au fonctionnement du composant tAccessBulkExec, consultez les scnarios suivants : tMysqlOutputBulk Scnario : Insrer des donnes transformes dans une base MySQL, page 666 tMysqlOutputBulkExec Scnario : Insrer des donnes dans une base MySQL, page 672
332
tAccessCommit
tAccessCommit
Proprits du tAccessCommit
Ce composant est troitement li aux composants tAccessConnection et tAccessRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Access
Fonction Objectif
Le composant tAccessCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tAccessConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tAccessCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Access et notamment avec les composants tAccesConnection et tAccessRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tAccessConnection et tAccessRollback. Ils sont gnralement utiliss avec un composant tAccessConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tAccessCommit, consultez Proprits du tMysqlConnection page 630
333
tAccessConnection
tAccessConnection
Proprits du tAccessConnection
Ce composant est troitement li aux composants tAccessCommit, tAccessInput et tAccessoutput. Ils sont gnralement utiliss avec un composant tAccessConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tAccessConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version Database Username et Password Use or register a shared DB Connection Slectionnez la version dAccess que vous utilisez (Access 2003 ou versions . Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant.. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est gnralement utilis avec des composants Access et notamment avec les composants tAccessCommit et tAccessRollback. n/a
334
tAccessConnection
Scnario: Insrer des donnes dans des tables parent/enfant

Le Job suivant est ddi des utilisateurs avancs de base de donnes qui souhaitent effectuer des insertions dans des tables multiples en utilisant une table parent Table1 pour gnrer deux tables enfant : Name et Birthday. Crez une base de donnes connecte Access 2007 que vous appellerez Database1. Une fois la base de donnes Access cre, crez une table appele Table1 avec les deux en-ttes de colonne suivants : Name et Birthday. Dans Talend Open Studio, le Job est constitu de douze composants, parmi lesquels des composants tAccessConnection, tAccessCommit, tAccessInput, tAccessOutput et tAccessClose.
A partir de la Palette, cliquez et dposez les composants suivants dans lespace de modlisation graphique : tFileList, tFileInputDelimited, tMap, tAccessOutput (x2), tAccessInput (x2), tAccessCommit, tAccessClose et tLogRow (x2). Connectez le composant tFileList au composant dentre tFileInputDelimited laide dune connexion de type Iterate. Ainsi, le nom du fichier traiter sera automatiquement renseign partir de la liste de fichiers du tFileList en utilisant une variable globale. Connectez le composant tFileInputDelimited au tMap et sparez le flux vers les deux composants de sortie tAccessOutput. Utilisez des connexions de type Row pour chacune de ces connexions reprsentant un flux de donnes principal. Dfinissez les proprits du composant tFileList, notamment le rpertoire dans lequel sont stocks les fichiers.
335
tAccessConnection
Ajoutez le composant tAccessConnection et connectez-le au composant de dpart de ce Job (dans cet exemple, le composant tFileList), laide dune connexion OnComponentOk afin de dfinir lordre dexcution. Dans la vue Component du composant tAccessConnection, dfinissez manuellement les informations de connexion ou rcuprez-les dans le Repository si vous les avez pralablement stockes dans le dossier DB connection du rpertoire Metadata. Pour plus dinformation concernant les Mtadonnes, consultez Centraliser les mtadonnes du Guide utilisateur Talend Open Studio . Dans longlet Basic settings du composant tFileInputDelimited, appuyez sur la touche Ctrl+Espace pour accder la liste des variables. Dfinissez le champ File Name avec la variable globale : tFileList_1.CURRENT_FILEPATH. Pour plus dinformation concernant lutilisation des variables, consultez Utiliser les variables dans un Job, page 146 du Guide Utilisateur Talend Open Studio .
Paramtrez les autres champs comme vous le souhaitez, dfinissez les sparateurs de lignes et de champs (Row et Field Separator) en fonction de la structure de votre document. Puis dfinissez manuellement le schma du fichier laide du bouton Edit schema ou slectionnez le schma dans le Repository. En version Java, assurez-vous que le type de donnes est correctement dfini, conformment la nature des donnes traites. Dans la zone Output du tMap, ajoutez deux tables de sortie, une que vous nommerez Name pour la table Name, et une deuxime que vous nommerez Birthday, pour la table Birthday. Pour plus dinformation concernant le composant tMap, consultez Prsentation du fonctionnement du tMap, page 252 du Guide utilisateur Talend Open Studio. Cliquez sur la colonne Name de la zone Input, et glissez-la dans la table Name. Cliquez sur la colonne Birthday de la zone Input, et glissez-la dans la table Birthday.
Puis slectionnez une connexion de sortie de type Row pour acheminer correctement le flux vers les composants Database de sortie correspondants.
336
tAccessConnection
Dans longlet Basic settings des deux composants tAccessOutput, cochez la case Use an existing connection pour rcuprer les informations du composant tAccessConnection. En version Perl, le champ Commit every napparat plus puisque vous utilisez le composant tAccessCommit au lieu de grer les commits de transaction globale. En version Java, ignorez ce champ puisque cette commande sera annule par le composant tAccessCommit.
Nommez votre table dans le champ Table en vous assurant que vous saisissez la bonne table. Dans cet exemple, la table est soit Name, soit Birthday. Ne dfinissez aucune action dans le champ Action on table puisque les tables ont dj t cres. Slectionnez Insert dans le champ Action on data pour les deux composants de sortie (tAccessOutput). Cliquez sur le bouton Sync columns pour rcuprer le schma dfini dans le tMap. Connectez ensuite le premier composant tAccessOutput au premier composant tAccessInput laide dune connexion OnComponentOk. Dans longlet Basic settings des deux composants tAccessInput, cochez la case Use an existing connection pour rcuprer le flux de donnes distribu. Puis dfinissez manuellement le schma du fichier laide du bouton Edit schema. Nommez ensuite votre table dans le champ Table Name. Le nom du tAccessInput_1 sera Name. Cliquez sur Guess Query. Connectez les deux composants tAccessInput au composant tLogRow laide dune connexion de type Row > Main. Dans longlet Basic settings des deux composants tLogRow, slectionnez Table dans le champ Mode. Ajoutez le composant tAccessConnection sous le composant tFileList et connectez-les laide dune connexion OnComponentOk afin darrter le Job avec les commits de transaction. A partir de longlet Basic settings du composant tAccessCommit, slectionnez dans la liste droulante Component list la connexion utiliser, tAccessConnection_1 dans ce scnario. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
337
tAccessConnection
La table parent Table1 est utilise la fois pour gnrer la table Name et la table Birthday.
338
tAccessInput
tAccessInput
Proprits du tAccessInput
Fonction Objectif
Le composant tAccessInput lit une base de donnes et en extrait des champs laide de requtes. Le tAccessInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
Basic settings
339
tAccessInput
Use an existing connection
Cochez cette case et slectionnez le composant tAccessConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
DB Version Database Username et Password Schema et Edit schema
Slectionnez la version dAccess que vous utilisez Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant (Repository). Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Query type et Query
Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes.
Advanced settings
340
tAccessInput
Trim all the String/Char columns Trim column Utilisation
Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL.
Scnarios associs
Pour un scnario associ, consultez les scnarios tDBInput et tMysqlInput : le Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. le Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. le Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie, page 637. Pour plus dinformations sur les contextes dynamiques dans le cadre dune utilisation de base de donnes, consultez le composant tContextLoad, page 1425.
341
tAccessOutput
tAccessOutput
Proprits du tAccessOutput
Le composant tAccessOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tAccessOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio .
342
tAccessOutput
Cochez cette case et slectionnez le composant tAccessConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
DB Version Database Username et Password Table Action on table
Slectionnez la version dAccess que vous utilisez Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table.
343
tAccessOutput
Action on data
Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete).
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant (Repository).
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Die on error Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
344
tAccessOutput
Advanced settings
Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tAccessOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Commit every
Additional Columns
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Use field options Enable debug mode Support null in SQL WHERE statement Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. Cochez cette case pour prendre en compte les valeurs Null dune table de base de donnes. Assurez-vous que la case Nullable est bien coche pour les colonnes du schma correspondantes.
Utilisation
Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Access. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
345
tAccessOutput
Scnarios associs
Pour un scnario associ, consultez : Le Scnario : Afficher la base de donnes en sortie, page 407 du tDBOutput. Le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du tMySQLOutput.
346
tAccessOutputBulk
tAccessOutputBulk
Proprits du tAccessOutputBulk
Les composants tAccessOutputBulk et tAccessBulkExec sont gnralement utiliss ensemble pour crire des donnes dans un fichier dlimit puis effectuer diffrentes actions sur le fichier dans une base de donnes Access, processus en deux tapes. Ces deux tapes sont regroupes dans le composant tAccessOutputBulkExec, dtaill dans une section spare. Lintrt dutiliser un processus en deux tapes rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Le composant tAccessOutputBulk crit un fichier dlimit. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Access. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio.
Create directory if not Cette case est coche par dfaut. Cette option permet exists de crer le dossier contenant le fichier de sortie sil nexiste pas dj. Append Schema et Edit schema Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant (Repository). Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Advanced settings Include header Cochez cette case pour inclure len-tte des colonnes dans le fichier.
347
tAccessOutputBulk
Encoding
Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec le composant tAccessBulkExec. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes Access.
Scnarios associs
Pour un scnario associ au tAccessOutputBulk, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec.
348
tAccessOutputBulkExec
Proprits du tAccessOutputBulkExec
Les composants tAccessOutputBulk et tAccessBulkExec sont gnralement utiliss ensemble afin dcrire des donnes dans un fichier dlimit, puis deffectuer diffrentes actions sur le fichier dans une base de donnes Access, processus en deux tapes. Ces deux tapes sont regroupes dans le tAccessOutputBulkExec.
Le tAccessOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tAccessOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Access. Property Type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tAccessConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. DB Version DB Name Slectionnez la version dAccess que vous utilisez Nom de la base de donnes.
349
Username et Password Action on table
Informations dauthentification de lutilisateur de base de donnes. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dinsert soit autorise. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Vous pouvez effectuer, sur les donnes de la table dfinie, lopration que vous souhaitez : Insert : ajoute de nouvelles entres la table. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Table
File Name
Action on data
Create directory if not exists Append Advanced settings Additional JDBC parameters
Cette case est coche par dfaut. Cette option permet de crer le dossier contenant le fichier de sortie sil nexiste pas dj. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Cochez cette case pour inclure len-tte des colonnes dans le fichier.
Include header
350
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est principalement utilis lorsquaucune transformation particulire nest requise sur les donnes charger dans la base de donnes. n/a
Scnarios associs
Pour un scnario associ au tAccessOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec.
351
tAccessRollback
tAccessRollback
Proprits du tAccessRollback
Ce composant est troitement li aux composants tAccessConnection et tAccessCommit. Ils sont gnralement utiliss ensemble lors de transactions.
Le tAccessRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tAccessConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Access, notamment avec le tAccessConnection et le tAccessCommit. n/a
Scnario associ
Pour un scnario associ au tAccessRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674 du composant tMysqlRollback.
352
tAccessRow
tAccessRow
Proprits du tAccessRow
Fonction
tAccessRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tAccessRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tAccessConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. DB Version Database Slectionnez la version dAccess que vous utilisez. Nom de la base de donnes.
Objectif
Basic settings
353
tAccessRow
Username et Password Schema et Edit Schema
Informations dauthentification de lutilisateur de base de donnes Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Table Name Query type
Nom de la table traiter. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.
Query
Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des paramtres reprsents par des ? dans linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction SQL. Parameter Type : Saisissez le type du paramtre. Parameter Value : Saisissez la valeur du paramtre. Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte. Elle permet un gain de performance.
Die on error
Advanced settings
Propagate QUERYs recordset Use PreparedStatement
354
tAccessRow
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL.
Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 411 du tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678 du tMySQLRow.
355
tAS400Close
tAS400Close
Proprits du tAS400Close
Famille de composant Databases/AS400
Le composant tAS400Close ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes AS400. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tAS400Connection dans la liste.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a
Scnario associ
Ce composant est troitement li aux composants tAS400Connection et tAS400Rollback. Il est gnralement utilis avec un composant tAS400Connection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tAS400Close, consultez tMysqlConnection page 630
356
tAS400Commit
tAS400Commit
Proprits du tAS400Commit
Ce composant est troitement li aux composants tAS400Connection et tAS400Rollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tAS400Commit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tAS400Connection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tAS400Commit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants AS400 et notamment avec les composants tAS400Connection et tAS400Rollback. n/a
Scnario associ
Ce composant est troitement li aux composants tAS400Connection et tAS400Rollback. Ils sont gnralement utiliss avec un composant tAS400Connection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tAS400Commit, consultez Proprits du tMysqlConnection page 630
357
tAS400Connection
tAS400Connection
Proprits du tAS400Connection
Ce composant est troitement li aux composants tAS400Commit et tAS400Rollback. Ils sont gnralement utiliss avec un composant tAS400Connection car il permet douvrir une connexion pour la transaction en cours.
Le composant tAS400Connection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version Host Database Table Schema Username et Password Use or register a shared DB Connection Slectionnez la version dAS400 que vous utilisez. Adresse IP du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant.. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.
Advanced settings
Auto commit
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est gnralement utilis avec des composants AS400 et notamment avec les composants tAS400Commit et tAS400Rollback. n/a
358
tAS400Connection
Scnario associ
Ce composant est troitement li aux composants tAS400Commit et tAS400Rollback. Ils sont gnralement utiliss avec un composant tAS400Connection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tAS400Connection, consultez tMysqlConnection page 630
359
tAS400Input
tAS400Input
Proprits du tAS400Input
Fonction Objectif
Le composant tAS400Input lit une base de donnes et en extrait des champs laide de requtes. Le tAS400SInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Use an existing connection Cochez cette case et slectionnez le composant tAS400SInput adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes.
Basic settings
360
tAS400Input
Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. DB Version Host Port Database Username et Password Schema et Edit Schema Slectionnez la version dAS400 que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Advanced settings
Trim all the String/Char columns Trim column
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL.
361
tAS400Input
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie, page 637. Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 du composant tContextLoad.
362
tAS400LastInsertId
tAS400LastInsertId
Proprits du tAS400LastInsertId
tAS400LastInsertId affiche les derniers ID ajouts une table partir dune connexion AS400 spcifie. tMysqlLastInsertId permet de rcuprer les cls primaires des entres dernirement ajoutes par un utilisateur une table AS400. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Component list Slectionnez le composant tAS400Connection dans la liste sil y a plus dune connexion dans votre Job.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est un composant intermdiaire. n/a
Scnario associ
Pour un scnario associ, consultez le Scnario : Rcuprer les ID des dernires entres ajoutes, page 642 du composant tMysqlLastInsertId.
363
tAS400Output
tAS400Output
Proprits du tAS400Output
Famille de composant Databases/DB2
Le composant tAS400Output crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tAS400Output excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . DB Version Slectionnez la version dAS400 que vous utilisez.
364
tAS400Output
Cochez cette case et slectionnez le composant tAS400SOutput adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio
Host Port Database Username et Password Table Action on table
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table.
365
tAS400Output
Action on data
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
366
tAS400Output
Advanced settings
Use commit control
Cochez cette case pour accder au champ Commit every et dfinir les oprations de commit. Commit every : nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de transaction (cependant pas de rollback) et surtout une meilleure performance des excutions.
Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tAS400Output peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
Use field options Enable debug mode
Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture dans la base de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes AS400. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
367
tAS400Output
Scnarios associs
Pour des scnarios associs, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du composant tDBOutput le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du composant tMySQLOutput. le Scnario 4 : Ecrire des colonnes dynamiques dun fichier source vers une base de donnes MySQL, page 864 du composant tMysqlOutput.
368
tAS400Rollback
tAS400Rollback
Proprits du tAS400Rollback
Ce composant est troitement li aux composants tAS400Commit et tAS400Connection. Ils sont gnralement utiliss ensemble lors de transactions.
Le tAS400Rollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tAS400Connection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants AS400, notamment avec le tAS400Connection et le tAS400Commit. n/a
Scnario associ
Pour un scnario associ au tAS400Rollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674 du composant tMySQLRollback.
369
tAS400Row
tAS400Row
Proprits du tAS400Row
Fonction
tAS400Row est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tAS400Row agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Use an existing connection Cochez cette case et slectionnez le composant tAS400Connection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version Host Port Slectionnez la version dAS400 que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur.
Objectif
Basic settings
370
tAS400Row
Database Username et Password Schema et Edit Schema
Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Query
Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column.
Die on error
Advanced settings
Propagate QUERYs recordset
371
tAS400Row
Use PreparedStatement
Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des paramtres reprsents par des ? dans linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction SQL. Parameter Type : Saisissez le type du paramtre. Parameter Value : Saisissez la valeur du paramtre. Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte. Elle permet un gain de performance.
Commit every
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log lors du traitement du Job, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL.
Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 411 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678 du composant tMySQLRow.
372
tCreateTable
tCreateTable
Proprits du tCreateTable
Ce composant se trouve la racine de la famille Databases de la Palette de Talend Open Studio. Le composant tCreateTable couvre des besoins indirectement lis lutilisation des bases de donnes de tout type.
Famille de composant Databases
Le tCreateTable cre, supprime ou supprime et recre une table spcifique. Ce composant spcifique Java permet de crer ou de supprimer nimporte quelle table dune base de donnes Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Database Type Slectionnez le type de SGBD dans la liste propose. Les proprits peuvent diffrer lgrement en fonction du type de base de donnes slectionn. Les champs additionnels sont dfinis dans ce tableau, la suite des proprits gnrales. Table Action Slectionnez laction effectuer sur la base de donnes : Create table : lorsque vous savez que la table nexiste pas dj. Create table when not exists : lorsque vous ne savez pas si la table existe dj. Drop and create table : lorsque vous savez que la table existe dj et que vous souhaitez la remplacer. Cochez cette case pour enregistrer la table cre de manire temporaire.
Mysql
Temporary Table
373
tCreateTable
MSSQLServer, MySQL, Oracle, PostgresPlus, Postgresql, Teradata
Cochez cette case si vous utilisez un composant de connexion, par exemple : tMysqlConnection ou tOracleConnection, etc. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Oracle Access
Connection Type Access File
Liste droulante des pilotes disponibles. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Slectionnez dans la liste un framework pour votre base de donnes Java. Slectionnez dans la liste le type de serveur correspondant aux paramtres de votre base de donnes. Cochez cette case pour autoriser, si besoin, le mode scuris.
Firebird
Firebird File
Interbase
Interbase File
SQLite
SQLite File
Java Db HSQLDb
Framework Type Running Mode
HSQLDb
Use TLS/SSL Sockets
374
tCreateTable
AS400/Oracle Teradata
DB Version Create
Slectionnez dans la liste droulante la version correspondant la base de donne slectionne. Slectionnez la table partir de la liste droulante. La table crer peut tre : -SET TABLE : table ne permettant pas de dupliquer les lignes -MULTI SET TABLE : table permettant de dupliquer les lignes. Adresse IP du serveur de base de donnes.
Tous les types de bases Host de donnes, excepts Access, JavaDb, SQLite et ODBC Tous les types de bases de donnes, excepts Access, Firebird, HSQLDb, SQLite et ODBC JavaDb Tous les types de bases de donnes, excepts Access, AS400, Firebird, Interbase, JavaDb, SQLite et ODBC HSQLDb Informix ODBC Database Name
Nom de la base de donnes.
DB Root Path Port
Parcourez vos fichiers jusqu la racine de votre base de donnes. Numro du port dcoute du serveur de base de donnes.
DB Alias DB Server ODBC Name UserName et Password Table name Schema et Edit Schema
Nom de la base de donnes. Nom du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Saisissez le nom de la nouvelle table entre guillemets. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log lors du traitement du Job, aussi bien au niveau du Job quau niveau de chaque composant.
375
tCreateTable
AS400/ MSSQL Server
Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes.
Utilisation
Ce composant offre la flexibilit des requtes de base de donnes et couvre toutes les possibilits des requtes SQL. Plus de scnarios sont disponibles pour chaque composant dentre de type base de donnes.
Scnario : Crer une nouvelle table dans une base de donnes MySQL
Le Job dcrit ci-dessous a t conu pour crer une nouvelle table dans une base de donnes, compose dun schma pris partir du schma dun fichier dlimit stock dans le Repository. Ce Job est compos dun seul composant.
Cliquez et dposez un composant tCreateTable de la famille Databases de la Palette. Dans la liste Database type de longlet Basic settings de la vue Component, slectionnez MySQL.
Dans la liste droulante Table Action, slectionnez Create table. Ne cochez la case Use Existing Connection uniquement si vous utilisez un composant avec une connexion ddie, consultez tMysqlConnection page 630 Vous nutiliserez pas cette option pour cet exemple. Dans la liste droulante Property type, slectionnez Repository, ainsi tous les champs de connexion la base de donnes sont renseigns automatiquement. Si vous navez pas configur de connexion aux bases de donnes dans le dossier Metadata du rpertoire DB connection, renseignez manuellement ces informations de connexion aprs avoir slectionn Built-in dans la liste droulante Property type. Dans le champ Table Name, saisissez le nom de la nouvelle table crer. Si vous souhaitez rcuprer le schma dune mtadonne (sans que celle-ci ne soit une connexion une base de donnes), slectionnez Repository puis la mtadonne souhaite.
376
tCreateTable
Dans tous les cas (Built-in ou Repository), cliquez sur Edit Schema pour vrifier le type de donnes dans la colonne DB Type.
Cliquez sur le bouton Reset DB Types si la colonne DB type est vide ou affiche des marques de diffrence (couleur orange). Cela permet de donner nimporte quel type de donnes, le type de donnes adquat. Cliquez sur OK. Enregistrez votre Job appuyez sur F6 pour lexcuter. La table cre est vide mais elle contient toutes les colonnes dfinies dans le Schma.
377
DB2BulkExec
DB2BulkExec
Proprits du tDB2BulkExec
Le composant tDB2BulkExec excute des oprations dInsert sur les donnes fournies. Le tDB2BulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes DB2. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tJDBCConnection adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Table Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma.
378
DB2BulkExec
Username et Password Table Action on table
Informations dauthentification sur lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Data file
Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une cl de recherche sur laquelle baser les oprations Update et Delete. Il est possible de dfinir les colonnes qui agiront comme cl de recherche partir du schma, pour une utilisation de base, ou partir des options avances (Advanced settings) pour une utilisation optimise de ces oprations.
Action on data
379
DB2BulkExec
Advanced settings
Field terminated by Date Format Time Format Timestamp Format
Caractre, chane ou expression rgulire sparant les champs. Utilisez ce champ pour dfinir lordre des mois et des jours. Utilisez ce champ pour dfinir lordre des heures, minutes et secondes. Utilisez ce champ pour dfinir lordre de la date et de lheure.
Remove Load Pending Quand la case est coche, dbloque la table en tat Pending, aprs un chargement massif. Load options Cliquez sur le bouton [+] afin dajouter des options de chargement des donnes. Parameter : dans la liste, slectionnez un paramtre de chargement. Value : saisissez une valeur pour le paramtre slectionn.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes DB2.
Scnario associ
Pour un scnario associ au composant tDB2BulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
380
tDB2Close
tDB2Close
Proprits du tDB2Close
Le composant tDB2Close ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes DB2. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tDB2Connection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tDB2Connection et tDB2Rollback. Il est gnralement utilis avec un composant tDB2Connection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tDB2Close, consultez tMysqlConnection page 630
381
tDB2Commit
tDB2Commit
Proprits du tDB2Commit
Ce composant est troitement li aux composants tDB2Connection et tDB2Rollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tDB2Commit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tDB2Connection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tDB2Commit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants DB2 et notamment tDB2Connection et tDB2Rollback. n/a
Scnario associ
Ce composant est troitement li aux composants tDB2Connection et tDB2Rollback. Ils sont gnralement utiliss avec un composant tDB2Connection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tDB2Commit, consultez tMysqlConnection page 630
382
tDB2Connection
tDB2Connection
Proprits du tDB2Connection
Ce composant est troitement li aux composants tDB2Commit et tDB2Rollback. Ils sont gnralement utiliss avec un composant tDB2Connection car il permet douvrir une connexion pour la transaction en cours.
Le composant tDB2Connection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Table Schema Username et Password Encoding Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.
Use or register a shared DB Connection
Advanced settings
Auto commit
383
tDB2Connection
Ce composant est gnralement utilis avec des composants DB2, notamment les composants tDB2Commit et tDB2Rollback. n/a
Scnarios associs
Pour un scnario associ au composant tDB2Connection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
384
tDB2Input
tDB2Input
Proprits du tDB2Input
Fonction Purpose
Le composant tDB2Input lit une base de donnes et en extrait des champs laide de requtes. Le tDB2Input excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
Basic settings
385
tDB2Input
Cochez cette case lorsque vous utilisez un composant tDB2Input.
Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Username et Password Schema et Edit Schema Adresse IP du serveur dannuaire DB2. Numro du port dcoute du serveur. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type et Query Nom de la table source dans laquelle capturer les changements apports aux donnes. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.
386
tDB2Input
Advanced settings
Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes DB2.
Scnarios associs
387
tDB2Output
tDB2Output
Proprits du tDB2Output
Le composant tDB2Output crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tDB2Output excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Use an existing connection Cochez cette case lorsque vous utilisez un composant tDB2Output. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Adresse IP du serveur de base de donnes.
388
tDB2Output
Port Database Username et Password Table Action on table
Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete).
Action on data
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository.
389
tDB2Output
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Die on error Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de transaction (cependant pas de rollback) et surtout une meilleure performance des excutions. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tDB2Output peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier. Use field options Convert columns and table names to uppercase Enable debug mode Support null in SQL WHERE statement Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour mettre le nom des colonnes et celui de la table en majuscules. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. Cochez cette case pour prendre en compte les valeurs Null dune table de base de donnes. Assurez-vous que la case Nullable est bien coche pour les colonnes du schma correspondantes.
Advanced settings
Commit every
Additional Columns
390
tDB2Output
Use Batch size
Cochez cette case afin dactiver le mode batch pour le traitement des donnes. Dans le champ Batch Size qui apparat, vous pouvez saisir le nombre de lignes par lot charger. Cette case est disponible uniquement si vous avez choisi loption Insert, Update, Single Insert Query ou Delete dans le champ Action on data.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes DB2. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ au composant tDB2Output, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du tMySQLOutput. le Scnario 4 : Ecrire des colonnes dynamiques dun fichier source vers une base de donnes MySQL, page 864.
391
tDB2Rollback
tDB2Rollback
Proprits du tDB2Rollback
Ce composant est troitement li aux composants tDB2Commit et tDB2Connection. Ils sont gnralement utiliss ensemble lors de transactions.
Le tDB2Rollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tDB2Connection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants DB2, notamment avec le tDB2Connection et le tDB2Commit. n/a
Scnario associ
Pour un scnario associ au tDB2Rollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674 du composant tMySQLRollback.
392
tDB2Row
tDB2Row
Proprits du tDB2Row
Fonction
tDB2Row est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tDB2Row agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Use an existing connection Cochez cette case et slectionnez le composant tDB2Connection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur.
Objectif
Basic settings
393
tDB2Row
Query
Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.
Die on error
Advanced settings
Propagate QUERYs recordset Commit every
394
tDB2Row
Scnarios associs
Pour un scnario associ au composant tDB2Row, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 411 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678 du composant tMySQLRow.
395
tDB2SCD
tDB2SCD
Le composant tDB2SCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tDB2SCD, page 139.
396
tDB2SCDELT
tDB2SCDELT
Le composant tDB2SCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tDB2SCDELT, page 141.
397
tDB2SP
tDB2SP
Proprits du tDB2SP
Le composant tDB2SP appelle une procdure stocke de base de donnes. Le tDB2SP permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. Use an existing connection Cochez cette case et slectionnez le composant tDB2Connection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier des proprits du composant. Les champs suivants sont alors pr-remplis. Host Port Database Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification sur lutilisateur de base de donnes.
398
tDB2SP
Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est rutilisable. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
SP Name Is Function / Return result in
Saisissez le nom exact de la Procdure Stocke (SP). Cochez cette case, si une seule valeur doit tre retourne. Slectionnez dans la liste la colonne du schma sur laquelle est base la valeur obtenir. Cliquez sur le bouton (+) et slectionnez dans le champ Schema Columns les diffrentes colonnes ncessaires la procdure. Notez que le schma de la SP peut contenir plus de colonnes quil ny a de paramtres utiliss dans la procdure. Slectionnez le Type de paramtre : IN : paramtre dentre (Input) OUT : paramtre de sortie (Output)/valeur retourne IN OUT : les paramtres dentre doivent tre retournes sous forme de valeur, mme aprs modifications via la procdure (fonction). RECORDSET : les paramtres dentre doivent tre retournes sous forme densemble de valeurs, au lieu dune valeur unique. Consultez le composant tParseRecordSet si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.
Parameters
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss. La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.
Scnario associ
Pour un scnario associ, consultez le Scnario : Trouver le libell State laide dune procdure stocke, page 689 du composant tMysqlSP. Consultez galement le composant tParseRecordSet, page 786 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.
tDBInput
tDBInput
Proprits du tDBInput
Famille de composant Databases/DB Generic Le composant tDBInput lit une base de donnes et en extrait des champs laide de requtes. Le tDBInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Prfrez toujours un composant Input spcifique au composant gnrique Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Connection type Database Username et Password Schema et Edit Schema Liste droulante des pilotes disponibles. Nom de la base de donnes Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Nom de la table traiter.
Fonction Objectif
Basic settings
400
tDBInput
Query type
Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.
Query
Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL grce une connexion gnrique ODBC.
Scnario 1 : Afficher les donnes slectionnes partir dune table

Le Job suivant, deux composants, lit les donnes dune base via une requte et affiche dans la console (vue Run) les donnes dlimites.
Cliquez et dposez les composants tDBInput et tLogRow dans lditeur graphique. Cliquez droit sur le tDBInput et, en gardant le bouton droit enfonc, glissez jusquau tLogRow pour crer une connexion de type Main Row. Slectionnez nouveau le tDBInput pour que la vue Component apparaisse puis renseignez les proprits du composant :
401
tDBInput
Dans ce scnario, le champ Property Type est en mode Built-In. Renseignez les informations de connexion la base de donnes dans les champs Database, Username et Password. Le champ Schema est en mode Built-In, ce qui implique que le schma ne sera utilisable que pour ce Job et sur ce poste. Cliquez sur le bouton Edit Schema et rpertoriez les codes des magasins dans une colonne et les ventes dans une autre. Renseignez le nom de la table dans le champ Table Name. Saisissez la requte excuter en veillant ce que l'ordre des colonnes correspondent celui fourni dans le schma. Dans cet exemple, comme toutes les colonnes du schma ont t slectionnes, il est possible dutiliser lastrisque. De la mme faon, cliquez sur le deuxime composant pour le dfinir. Indiquez quel est le sparateur de champs : il sagit ici dune barre verticale. Passez sur la vue Run et cliquez sur le bouton Run pour excuter le Job. La base de donnes est alors analyse. Les donnes recherches sont extraites et sont affiches directement sur la console (vue Run), o vous pouvez les voir.
402
tDBInput
Scnario 2 : Utiliser la variable StoreSQLQuery

La variable StoreSQLQuery peut tre utilise pour dboguer un scnario tDBInput qui ne sexcuterait pas correctement. Elle permet dalimenter la requte de votre composant tDBInput de manire dynamique. Partez du scnario 1 dcrit ci-dessus, auquel vous ajouterez un composant tJava. Reliez les composants tDBInput et tJava via une connexion Trigger de type OnComponentOk. Dans le cas prsent, faites en sorte que la commande du tDBInput sexcute avant la commande du tJava.
Configurez les composants tDBInput et tLogRow comme dans le scnario 1 dcrit plus haut. Passez la vue appele Context. Crez un nouveau paramtre que vous appellerez StoreSQLQuery et donnez-lui une valeur de 1 par dfaut. Cette valeur indique que StoreSQLQuery est valide (true) et pourra tre utilis par la variable globale QUERY. Cliquez sur le composant tJava et affichez la vue Component. Tapez la commande System.Out.println() pour afficher le contenu de la requte, puis, dans les parenthses, appuyez sur Ctrl+Espace pour accder la liste des variables, et slectionnez la variable globale QUERY.
tDBInput
Affichez la vue Run et excutez les Jobs. La requte associe au composant tDBInput saffiche dans la console (vue Run), la fin des rsultats du Job :
404
tDBOutput
tDBOutput
Proprits du tDBOutput
Fonction Objectif
Le composant tDBOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tDBOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Prfrez toujours un composant Output spcifique au composant gnrique. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Connection type Database Username et Password Table Liste des pilotes disponibles. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois.
Basic settings
405
tDBOutput
Action on data
Clear data in table
Cochez cette case pour que les donnes soient supprimes de la table slectionne avant toute action. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Die on error
406
tDBOutput
Advanced settings
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de transaction (cependant pas de rollback) et surtout une meilleure performance des excutions. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tDBOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnario : Afficher la base de donnes en sortie

Le Job suivant, form de trois composants, permet de crer une nouvelle table dans une base de donne dtermine et de lalimenter. Le composant tFileInputdelimited passe le flux entrant au composant tDBoutput. En outre, le composant tLogRow est utilis ici pour afficher les rsultats directement dans la console de la vue Run.
407
tDBOutput
Cliquez et dposez les trois composants ncessaires pour ce Job. Dfinissez les paramtres dentre pour le composant tFileInputDelimited, dans longlet Basic settings. Dans cet exemple, le fichier contient les identifiants des propritaires, les rfrences des marques, des couleurs et des immatriculations des voitures. Ces informations sont organises comme suit : un point-virgule comme sparateur de champ et un retour chariot comme sparateur de ligne. Le fichier dentre comprend une ligne den-tte prendre en compte dans le schma. Si ce fichier est dj dcrit dans vos mtadonnes, vous pouvez en rcuprer les proprits en slectionnant lentre correspondante dans le Repository.
Si votre schma est dj stock dans le Repository, slectionnez loption Repository dans le champ Schema puis choisissez les mtadonnes appropries partir de la liste. Si vous navez encore dfini aucun schma, renseignez la structure des donnes dans un schma que vous crerez en mode built-in. Pour ce cas de figure, rduisez lextraction 10 lignes. Dfinissez ensuite le composant tDBOutput pour configurer le flux de sortie. Slectionnez la base de donnes laquelle se connecter. Vous pouvez stocker lensemble des dtails de connexion aux bases de donnes via diffrentes variables de contexte. Pour plus dinformations sur la manire de crer et dutiliser les variables de contexte, consultez Dfinir les variables partir de la vue Contexts.
408
tDBOutput
Renseignez le nom de la table dans le champ Table, puis choisissez les oprations effectuer : Dans le champ Action on table, slectionnez loption Drop and create table partir de la liste, ce qui vous permettra dcraser la table, si elle existe, avec les nouvelles donnes choisies. Vous pouvez galement ajouter des lignes supplmentaires dans une table dj existante, mais notez que la gestion des doublons nest pas supporte nativement. Consultez la section Proprits du tUniqRow, page 325 pour plus dinformations. Dans le champ Action on data, slectionnez loption Insert. Le flux de donnes entrant sera alors ajout la table slectionne. Pour visualiser plus facilement le flux sortant, connectez le composant tDBOuput un composant tLogRow. Dfinissez le symbole barre verticale comme sparateur de champ. Appuyez sur F6 pour excuter le Job. Le traitement peut prendre un peu de temps avant que le tLogRow n'affiche le rsultat. Pour afficher le suivi du traitement, activez la fonction Statistics sur la console de la vue Run.
Sujet associ : Proprits du tMysqlOutput, page 647
409
tDBSQLRow
tDBSQLRow
Proprits du tDBSQLRow
Famille de composant Databases/DB Generic tDBSQLRow est le composant gnrique tout type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Pour une question de performances, prfrez toujours un composant de base de donnes spcifique au composant gnrique. Selon la nature de la requte et de la base de donnes, tDBSQLRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Datasource Nom de la source de donnes ODBC crer au pralable pour pouvoir se connecter la base de donnes Pour plus dinformations, consultez le prrequis de ce tableau. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type Nom de la table de base de donnes modifier. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder.
Fonction
Objectif
Basic settings
410
tDBSQLRow
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. Query Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des paramtres reprsents par des ? dans linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction SQL. Parameter Type : Saisissez le type du paramtre. Parameter Value : Saisissez la valeur du paramtre. Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte. Elle permet un gain de performance. Commit every Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL. Utilisez le composant DBRow correspondant au type de base de donnes dont vous vous servez. La plupart des bases de donnes ont leur propre composant DBRow spcifique. Prrequis ODBC (Open DataBase Connectivity) est un protocole standard permettant d'accder aux informations de serveurs de bases de donnes. Vous devez pralablement crer une source de donnes (datasource) ODBC et la relier votre base de donnes pour en lire les informations. Pour crer une source ODBC sous Windows, par exemple, allez Panneau de configuration > Outils dadministration > Sources de donnes (OBCD) puis renseignez les proprits de la source partir de lassistant.
Scnario : Rinitialiser lauto-incrmentation dune base de donnes

Le Job suivant, un seul composant, permet de rinitialiser lauto-incrmentation de la base de donnes (valeur initiale = 1). Il ne permet pas de gnrer un flux en sortie car il est gnralement utilis avant lexcution dun script.
411
tDBSQLRow
Glissez-dposez le composant tDBSQLRow sur lespace graphique de modlisation. Dans la vue Basic settings, renseignez les proprits de la connexion la source de donnes (datasource) ODBC.
Pour plus dinformations sur les sources de donnes OBCD, consultez la section concernant les prrequis dans le tableau des proprits.
Dans le champ Property Type, slectionnez Repository pour rcuprer les informations connexion stockes dans le Repository. Dans le champ Datasource, saisissez le nom de la source de donnes ODBC laquelle est relie la base de donnes contenant la table dont vous voulez rinitialiser lauto-incrmentation. Dans les champs Username et Password, renseignez si ncessaire vos identifiant et mot de passe de connexion la source de donnes. Dans le champ Schema Type, slectionnez le mode Built-in et dcrivez la structure de la base de donnes Talend. Le schma nest pas important dans notre cas particulier puisque vous souhaitez rinitialiser lauto-incrmentation de la table et que vous ne touchez pas aux donnes. Dans le champ Table Name, renseignez le nom de la table dont vous voulez rinitialiser lauto-incrmentation. Dans le champ Query type, laissez loption Built-in. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir le SQLbuilder. Sinon, saisissez le code suivant : Alter table <TableName> auto_increment = 1 directement dans le champ Query.
tDBSQLRow
Enregistrez le Job et appuyez sur F6 pour lexcuter. Lauto-incrmentation de la base de donnes est rinitialise. Voir galement : Proprits du tMysqlRow, page 676.
413
tEXAInput
tEXAInput
Proprits du tEXAInput
Famille de composant Databases/EXA
Fonction Objectif
Le composant tEXAInput lit une base de donnes et en extrait des champs laide de requtes. Le tEXAInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host name Port Schema name Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Saisissez le nom du schma. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Saisissez le nom de la table.
Basic settings
414
tEXAInput
Query type et Query
Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Cliquez sur le bouton pour rcuprer le schma de la table. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Guess Query
Guess schema Advanced settings Additional JDBC parameters Trim all the String/Char columns Trim column
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes EXA.
Scnarios associs
Consultez les scnarios associs au composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie, page 637.
415
tEXAOutput
tEXAOutput
Proprits du tEXAOutput
Le composant tEXAOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tEXAOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Port Schema name Username et Password Table Action on table Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Saisissez le nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table.
416
tEXAOutput
Action on data
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Cochez cette case afin de dfinir, dans le champ Commit every, qui apparat alors, le nombre de lignes traiter avant de commiter.
Advanced settings
Use commit control
417
tEXAOutput
Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tEXAOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes EXA. Il permet aussi de crer un flux de rejet avec un lien Row > Rejects filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du composant tMysqlOutput.
418
tEXARow
tEXARow
Proprits du tEXARow
Fonction
tEXARow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tEXARow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Schema name Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Saisissez le nom du schma. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type Nom de la table traiter. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.
Objectif
Basic settings
419
tEXARow
Guess Query
Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.
Query
Die on error
Advanced settings
Additional JDBC parameters Propagate QUERYs recordset Commit every
Scnarios associs
420
tEXistConnection
tEXistConnection
Proprits du tEXistConnection
Ce composant est troitement li aux tEXistGet et tEXistPut. Une fois que vous avez dfini les proprits de connexion du composant, vous pouvez rutiliser cette connexion sans avoir dfinir nouveau les proprits pour chaque composant tEXist utilis dans le Job.
Famille de composant Databases/eXist
Le tEXistConnection ouvre une connexion une base de donnes eXist afin deffectuer une transaction. Ouvrir une connexion une base de donnes eXist afin deffectuer une transaction. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes.
Driver
Username et Password Advanced settings Utilisation
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants tEXist,comme le tEXistGet et le tEXistPut. La base de donnes eXist est un systme de gestion de base de donnes open source, construit laide de la technologie XML. Elle stocke des donnes XML selon le modle de donnes XML et offre une fonction efficace de traitement de la requte XQuery, base sur lindex. Pour plus dinformations concernant XQuery, consultez : http://exist.sourceforge.net/xquery.html (en anglais). Pour plus dinformations concernant les extensions de XQuery Update, consultez : http://exist.sourceforge.net/update_ext.html n/a
Limitation
Scnario associ
Ce composant est gnralement utilis avec un tEXistGet et un tEXistPut. Il nest pas trs pertinent dutiliser un de ces composants sans utiliser un tEXistConnection pour ouvrir une connexion pour la transaction.
421
tEXistConnection
Pour un scnario associ au tEXistConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630, du composant tMysqlConnection.
422
tEXistDelete
tEXistDelete
Proprits du tEXistDelete
Ce composant supprime des ressources dune base de donnes eXist. Le tEXistDelete supprime des ressources spcifies dans une base de donnes eXist distante. Use an existing Cochez cette case et slectionnez le composant connection/Compon tEXistConnection adquat partir de la liste ent List Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes. Slectionnez le type de cible : Resource(Ressource), Collection (Collection), ou All (Tous).
Driver
Username et Password Target Type
423
tEXistDelete
Files
Cliquez sur le bouton [+] afin dajouter les lignes que vous souhaitez utiliser comme filtres : Filemask : saisissez le nom du fichier ou le masque de fichier, en utilisant des caractres de remplacement (*) ou des expressions rgulires. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant est utilis en tant que sous-job ou comme composant de sortie. La base de donnes eXist est un systme de gestion de base de donnes open source, construit laide de la technologie XML. Elle stocke des donnes XML selon le modle de donnes XML et offre une fonction efficace de traitement de la requte XQuery, base sur lindex. Pour plus dinformations concernant XQuery, consultez : http://exist.sourceforge.net/xquery.html (en anglais). Pour plus dinformations concernant les extensions de XQuery Update, consultez : http://exist.sourceforge.net/update_ext.html n/a
Limitation
Scnario associ
424
tEXistGet
tEXistGet
Proprits du tEXistGet
Le composant tEXistGet rcupre des ressources partir dun serveur distant de base de donnes eXist. Le tEXistGet tlcharge les ressources slectionnes partir dun serveur distant de base de donnes dans un rpertoire local. Use an existing Cochez cette case et slectionnez le composant connection/Component tEXistConnection adquat partir de la liste List Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins.
Driver
Username et Password Informations dauthentification de lutilisateur de base de donnes. Local directory Chemin daccs au fichier de destination.
425
tEXistGet
Files
Limitation
Scnario : Rcuprer des ressources partir dun serveur distant de base de donnes eXist
Ce scnario dcrit un Job un composant qui permet de rcuprer des donnes partir dun serveur de base de donnes eXist et de tlcharger les donnes dans un rpertoire local. Ce Job simple ncessite un composant : le tEXistGet.
A partir de la Palette, dposez le composant tEXistGet dans lespace de modlisation graphique. Double-cliquez sur le composant tEXistGet pour dfinir ses proprits dans longlet Basic settings de sa vue Component.
426
tEXistGet
Renseignez le champ URI en saisissant ladresse URI de la base de donnes eXist laquelle vous souhaitez vous connecter. Dans ce scnario, lURI est xmldb:exist://192.168.0.165:8080/exist/xmlrpc. Notez que cette adresse URI est destine essentiellement la dmonstration et que ce nest pas une addresse valide. Remplissez le champ Collection avec le chemin daccs la collection souhaite sur le serveur de la base de donnes, /db/talend dans ce scnario. Renseignez le champ Driver en saisissant le pilote de la base de donnes XML, org.exist.xmldb.DatabaseImpl dans ce scnario. Remplissez les champs Username et Password avec admin et talend respectivement pour ce scnario. Cliquez sur le bouton [...] ct du champ Local directory pour dfinir le chemin daccs au rpertoire dans lequel le fichier XML tlcharg partir du serveur de la base de donnes sera sauvegard. Dans ce scnario, faites pointer ce chemin vers votre bureau, par exemple : C:/Documents and Settings/galano/Desktop/ExistGet. Dans le champ Files, cliquez sur le bouton [+] afin dajouter une nouvelle ligne dans la zone Filemask et remplissez-la avec un nom de fichier complet pour rcuprer les donnes partir dun fichier spcifique sur le serveur, ou avec un masque de fichier (filemask) pour rcuprer les donnes partir dun ensemble de fichiers. Dans ce scnario, saisissez dictionary_en.xml. Sauvegardez votre Job et appuyez sur F6 pour lexcuter.
427
tEXistGet
Le fichier XML dictionary_en.xml est rcupr et tlcharg dans le rpertoire local dfini pralablement.
428
tEXistList
tEXistList
Proprits du tEXistList
Ce composant liste les ressources stockes sur un serveur distant de base de donnes. Le tEXistList liste les ressources stockes sur un serveur distant de base de donnes. Use an existing Cochez cette case et slectionnez le composant connection/Compon tEXistConnection adquat partir de la liste ent List Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes.
Driver
Username et Password
429
tEXistList
Files
Cliquez sur le bouton [+] afin dajouter les lignes que vous souhaitez utiliser comme filtres : Filemask : saisissez le nom du fichier ou le masque de fichier, en utilisant des caractres de remplacement (*) ou des expressions rgulires. Slectionnez le type de cible : Resource(Ressource), Collection (Collection), ou All (Tous). Cochez cette case pour collecter les donnes de log au niveau du composant.
Target Type
Ce composant est gnralement utilis avec un tEXistGet afin de rcuprer les fichiers lists, par exemple. La base de donnes eXist est un systme de gestion de base de donnes open source, construit laide de la technologie XML. Elle stocke des donnes XML selon le modle de donnes XML et offre une fonction efficace de traitement de la requte XQuery, base sur lindex. Pour plus dinformations concernant XQuery, consultez : http://exist.sourceforge.net/xquery.html (en anglais). Pour plus dinformations concernant les extensions de XQuery Update, consultez : http://exist.sourceforge.net/update_ext.html n/a
Limitation
Scnario associ
Pour un scnario associ au tEXistList, consultez le Scnario : Itration sur un rpertoire distant, page 1267.
430
tEXistPut
tEXistPut
Proprits du tEXistPut
Ce composant charge des ressources dans un serveur de base de donnes. Le tEXistPut charge des fichiers spcifis dun rpertoire local dfini sur un serveur distant de base de donnes. Use an existing Cochez cette case et slectionnez le composant connection/Compon tEXistConnection adquat partir de la liste ent List Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes. Chemin daccs au fichier de destination.
Driver
Username et Password Local directory
431
tEXistPut
Files
Limitation
Scnario associ
432
tEXistXQuery
tEXistXQuery
Proprits du tEXistXQuery
Fonction
Ce composant utilise des fichiers locaux contenant des requtes XPath afin dinterroger des fichiers XML stocks dans une base de donnes distante. Le tEXistXQuery excute une requte sur des fichiers XML stocks sur une base de donnes distante, et crit les rsultats dans un fichier XML stock localement. Use an existing Cochez cette case et slectionnez le composant connection/Compon tEXistConnection adquat partir de la liste ent List Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes.
Objectif
Basic settings
Driver
433
tEXistXQuery
XQuery Input File Local Output
Parcourez votre rpertoire jusquau fichier local contenant la requte excuter. Parcourez votre rpertoire jusqu lemplacement o les rsultats de la requte doivent tre sauvegards. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant est utilis en tant que composant unique dun Job mais peut galement tre utilis dans un Job plus complexe. La base de donnes eXist est un systme de gestion de base de donnes open source, construit laide de la technologie XML. Elle stocke des donnes XML selon le modle de donnes XML et offre une fonction efficace de traitement de la requte XQuery, base sur lindex. Pour plus dinformations concernant XQuery, consultez : http://exist.sourceforge.net/xquery.html (en anglais). Pour plus dinformations concernant les extensions de XQuery Update, consultez : http://exist.sourceforge.net/update_ext.html n/a
Limitation
Scnario associ
434
tEXistXUpdate
tEXistXUpdate
Proprits du tEXistXUpdate
Ce composant traite des fichiers XML et met jour les enregistrements sur un serveur de base de donnes. Le tEXistXUpdate traite des fichiers XML et met jour les enregistrements existants sur un serveur de base de donnes. Use an existing Cochez cette case et slectionnez le composant connection/Compon tEXistConnection adquat partir de la liste ent List Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. URI Collection URI de la base de donnes laquelle vous souhaitez vous connecter. Saisissez le chemin daccs la collection laquelle vous souhaitez accder, sur le serveur de la base de donnes. Ce champ est automatiquement rempli. Par dfaut, le nom du pilote standard saffiche. Les utilisateurs peuvent spcifier un pilote diffrent, selon leurs besoins. Informations dauthentification de lutilisateur de base de donnes.
Driver
435
tEXistXUpdate
Update File
Parcourez votre rpertoire jusquau fichier local utiliser pour mettre jour les enregistrements de la base de donnes. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant est utilis en tant que composant unique dun Job mais peut galement tre utilis dans un Job plus complexe. La base de donnes eXist est un systme de gestion de base de donnes open source, construit laide de la technologie XML. Elle stocke des donnes XML selon le modle de donnes XML et offre une fonction efficace de traitement de la requte XQuery, base sur lindex. Pour plus dinformations concernant XQuery, consultez : http://exist.sourceforge.net/xquery.html (en anglais). Pour plus dinformations concernant les extensions de XQuery Update, consultez : http://exist.sourceforge.net/update_ext.html n/a
Limitation
Scnario associ
436
tFirebirdClose
tFirebirdClose
Proprits du tFirebirdClose
Famille de composant Databases/Firebird
Le composant tFirebirdClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Firebird. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tFirebirdConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tFirebirdConnection et tFirebirdRollback. Il est gnralement utilis avec un composant tFirebirdConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tFirebirdClose, consultez tMysqlConnection page 630
437
tFirebirdCommit
tFirebirdCommit
Proprits du tFirebirdCommit
Ce composant est troitement li aux composants tFirebirdConnection et tFirebirdRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tFirebirdCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tFirebirdConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tFireBirdCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Firebird et notamment avec les composants tFirebirdConnection et tFirebirdRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tFirebirdConnection et tFirebirdRollback. Ils sont gnralement utiliss avec un composant tFirebirdConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tFirebirdCommit, consultez tVerticaConnection page 944.
438
tFirebirdConnection
tFirebirdConnection
Proprits du tFirebirdConnection
Ce composant est troitement li aux composants tFirebirdCommit et tFirebirdRollback. Ils sont gnralement utiliss avec un composant tFirebirdConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tFirebirdConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Table Schema Username et Password Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.
Advanced settings
Auto commit
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est gnralement utilis avec des composants Firebird, notamment les composants tFirebirdCommit et tFirebirdRollback. n/a
439
tFirebirdConnection
Scnario associ
Pour un scnario associ au composant tFirebirdConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
440
tFirebirdInput
tFirebirdInput
Proprits du tFirebirdInput
Fonction Objectif
Le composant tFirebirdInput lit une base de donnes et en extrait des champs laide de requtes. Le tFirebirdInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Basic settings
Advanced settings
441
tFirebirdInput
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes FireBird.
Scnarios associs
Pour un scnario associ, consultez les scnarios associs au composant gnrique tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie, page 637. Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 du composant tContextLoad.
442
tFirebirdOutput
tFirebirdOutput
Proprits du tFirebirdOutput
Le composant tFirebirdOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tFirebirdOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Username et Password Table Action on table Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table.
443
tFirebirdOutput
Action on data
Die on error
444
tFirebirdOutput
Advanced settings
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de transaction (cependant pas de rollback) et surtout une meilleure performance des excutions. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tFirebirdOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
Use field options Enable debug mode Support null in SQL WHERE statement
Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. Cochez cette case pour prendre en compte les valeurs Null dune table de base de donnes. Assurez-vous que la case Nullable est bien coche pour les colonnes du schma correspondantes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Firebird. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du composant tDBOutput.
445
tFirebirdOutput
le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du composant tMysqlOutput.
446
tFirebirdRollback
tFirebirdRollback
Proprits du tFirebirdRollback
Ce composant est troitement li aux composants tFirebirdCommit et tFirebirdConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Le tFirebirdRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tFirebirdConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Firebird, notamment avec le tFirebirdConnection et le tFirebirdCommit. n/a
Scnario associ
Pour un scnario associ au tFirebirdRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674 du composant tMysqlRollback.
447
tFirebirdRow
tFirebirdRow
Proprits du tFirebirdRow
Fonction
tFirebirdRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tFirebirdRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tFirebirdConnection adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Database Adresse IP du serveur de base de donnes. Nom de la base de donnes.
Objectif
Basic settings
448
tFirebirdRow
Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Query
Die on error
Advanced settings
449
tFirebirdRow
Commit every
Scnarios associs
450
tGreenplumBulkExec
tGreenplumBulkExec
Proprits du tGreenplumBulkExec
Les composants tGreenplumOutputBulk et tGreenplumBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tGreenplumOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le changement des donnes dans la base de donnes.
Famille de composant Databases/Greenplum
Fonction Objectif
Le composant tGreenplumBulkExec effectue une action dInsert sur les donnes fournies. Le tGreenplumBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Greenplum. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tGreenplumConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Adresse IP du serveur de base de donnes.
Basic settings
451
tGreenplumBulkExec
Port Database Schema Username et Password Table
Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Nom du fichier traiter. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Les informations demandes seront diffrentes en fonction de laction choisie.
Action on table
File Name Schema et Edit Schema
Advanced settings
Action on data
Copy the OID for each Rcupre les identifiants dobjet pour chaque ligne. row Contains a header line Spcifiez que la table contient des lignes den-tte. with the names of each column in the file File type Null string Fields terminated by Escaped char Text enclosure Force not null for columns Slectionnez le type de fichiers traiter. Chane de caractres affiche pour signifier que la valeur est nulle. Caractre, chane ou expression rgulire sparant les champs. Caractre dchappement de la ligne. Caractres utiliss pour entourer le texte. Dfinissez la nullabilit des colonnes Force not null : Cochez la case correspondant la colonne (Column) que vous souhaitez dfinir comme ntant pas nulle.
452
tGreenplumBulkExec
Utilisation
Ce composant est gnralement utilis avec un composant tGreenplumOutputBulk. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes Greenplum. n/a
Limitation
Scnarios associs
Pour plus dinformations relatives au fonctionnement de tGreenplumBulkExec, consultez les scnarios suivants : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du composant tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du composant tOracleBulkExec.
453
tGreenplumClose
tGreenplumClose
Proprits du tGreenplumClose
Le composant tGreenplumClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Greenplum. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tGreenplumConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tGreenplumConnection et tGreenplumRollback. Il est gnralement utilis avec un composant tGreenplumConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tGreenplumClose, consultez tMysqlConnection page 630
454
tGreenplumCommit
tGreenplumCommit
Proprits du tGreenplumCommit
Ce composant est troitement li aux composants tGreenplumConnection et tGreenplumRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tGreenplumCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tGreenplumConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tGreenplumCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Greenplum et notamment avec les composants tGreenplumConnection et tGreenplumRollback. n/a
Limitation
Scnario associ
Ce composant est troitement li aux composants tGreenplumConnection et tGreenplumRollback. Ils sont gnralement utiliss avec un composant tGreenplumConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tGreenplumCommit, consultez tMysqlConnection page 630.
455
tGreenplumConnection
Proprits du tGreenplumConnection
Ce composant est troitement li aux composants tGreenplumCommit et tGreenplumRollback. Ils sont gnralement utiliss avec un composant tGreenplumConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tGreenplumConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Schema Username et Password Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.
Advanced settings
Auto commit
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Limitation Ce composant est gnralement utilis avec des composants Greenplum, notamment les composants tGreenplumCommit et tGreenplumRollback. n/a
456
Scnarios associs
Pour un scnario associ au composant tGreenplumConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
457
tGreenplumInput
tGreenplumInput
Proprits du tGreenplumInput
Famille de composant Databases/ Greenplum Le composant tGreenplumInput lit une base de donnes et en extrait des champs laide de requtes. Le tGreenplumInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Host Port Database Schema Username et Password Schema et Edit Schema Cochez cette case lorsque vous utilisez le composant tGreenplumConnection. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio.
Fonction Objectif
Basic settings
458
tGreenplumInput
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en une fois. Cette option permet doptimiser les performances. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Advanced settings
Use cursor
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Greenplum.
Scnarios associs
Pour un scnario associ, consultez les scnarios des composants tDBInput et tMysqlInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie, page 637. Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 du composant tContextLoad.
459
tGreenplumOutput
tGreenplumOutput
Proprits du tGreenplumOutput
Fonction Objectif
Le composant tGreenplumOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tGreenplumOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
Basic settings
460
tGreenplumOutput
Cochez cette case lorsque vous utilisez le composant tGreenplumConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Host Port Database Schema Username et Password Table Action on table
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma. Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table.
461
tGreenplumOutput
Action on data
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Die on error
462
tGreenplumOutput
Advanced settings
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tPostgresqlOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
Use field options
Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Greenplum. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ au composant tGreenplumOutput consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du tMysqlOutput.
463
tGreenplumOutputBulk
Proprits du tGreenplumOutputBulk
Les composants tGreenplumOutputBulk et tGreenplumBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tGreenplumOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Greenplum. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Greenplum. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Append Schema et Edit schema
Advanced settings
Row separator Field separator Include header
Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Cochez cette case pour inclure len-tte des colonnes dans le fichier.
464
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec le composant tGreenplumBulkExec. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes Greenplum.
Scnarios associs
Pour un scnario associ au tGreenplumOutputBulk, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec.
465
tGreenplumOutputBulkExec
Proprits du tGreenplumOutputBulkExec
Les composants tGreenplumOutputBulk et tGreenplumBulkExec sont gnralement utiliss ensemble comme deux parties dun processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime tape, ce fichier est utilis lors de lopration dINSERT afin de populer une base de donnes. Cette excution en deux tapes est unifie dans le composant tGreenplumOutputBulkExec.
Fonction Objectif
Le tGreenplumOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tGreenplumOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Greenplum. Property Type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Schema Username et Password Table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dinsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio.
Basic settings
Action on table
File Name
466
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Advanced settings
Action on data
Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Les informations demandes seront diffrentes en fonction de laction choisie.
Copy the OID for each Rcupre les identifiants dobjet pour chaque ligne. row Contains a header line Spcifiez que la table contient des lignes den-tte. with the names of each column in the file File type Null string Fields terminated by Escaped char Text enclosure Force not null for columns Slectionnez le type de fichiers traiter. Chane de caractres affiche pour signifier que la valeur est nulle. Caractre, chane ou expression rgulire sparant les champs. Caractre dchappement de la ligne. Caractres utiliss pour entourer le texte. Dfinissez la nullabilit des colonnes Force not null : Cochez la case correspondant la colonne (Column) que vous souhaitez dfinir comme ntant pas nulle.
Scnarios associs
Pour un scnario associ au tGreenplumOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk.
467
le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec.
468
tGreenplumRollback
tGreenplumRollback
Proprits du tGreenplumRollback
Ce composant est troitement li aux composants tGreenplumCommit et tGreenplumConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Le tGreenplumRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tGreenplumConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Greenplum, notamment avec le tGreenplumConnection et le tGreenplumCommit. n/a
Scnario associ
Pour un scnario associ au tGreenplumRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674 du composant tMysqlRollback.
469
tGreenplumRow
tGreenplumRow
Proprits du tGreenplumRow
Fonction
Le tGreenplumRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tGreenplumRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tGreenplumConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma
Objectif
Basic settings
470
tGreenplumRow
Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Nom de la table lire. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.
Guess Query
Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des paramtres reprsents par des ? dans linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction SQL. Parameter Type : Saisissez le type du paramtre. Parameter Value : Saisissez la valeur du paramtre. Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte. Elle permet un gain de performance.
Query
Die on error
Advanced settings
471
tGreenplumRow
Commit every
Scnarios associs
472
tGreenplumSCD
tGreenplumSCD
Le composant tGreenplumSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tGreenplumSCD, page 144.
473
tHiveClose
tHiveClose
Proprits du tHiveClose
Famille de composant Databases/Hive
Le composant tHiveClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Hive. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tHiveConnection dans la liste.
Scnario associ
Ce composant est troitement li au composant tHiveConnection. Il est gnralement utilis avec un composant tHiveConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tHiveClose, consultez tMysqlConnection page 630
474
tHiveConnection
tHiveConnection
Proprits du tHiveConnection
Le composant tHiveConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Username et Password Encoding Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant. Ce composant est gnralement utilis avec des composants Hive, notamment le composant tHiveClose. n/a
475
tHiveConnection
Scnarios associs
Pour un scnario associ au composant tHiveConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
476
tHiveRow
tHiveRow
Proprits du tHiveRow
Fonction
tHiveRow est le composant spcifique ce type de base de donnes. Il excute des requtes Hive QL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tHiveRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tHiveConnection adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur.
Objectif
Basic settings
477
tHiveRow
Guess Query
Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column.
Query
Die on error
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes Hive QL.
Scnarios associs
Pour un scnario associ, consultez :
478
tHiveRow
le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 411 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678 du composant tMySQLRow.
479
tHSQLDbInput
tHSQLDbInput
Proprits du tHSQLDbInput
Famille de composant Databases/HSQLDb
Fonction Objectif
Le composant tHSQLDbInput lit les donnes dune base de donnes et extrait les champs selon la requte excute. Le tHSQLDbInput excute une requte DB dans un ordre strictement dfini devant correspondre la dfinition du schma. Il passe ensuite la liste des champs au composant suivant laide dun lien Main row. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Running Mode Slectionnez dans la liste le type de serveur correspondant aux paramtres de votre base de donnes, parmi les quatre proposs : HSQLDb Server, HSQLDb WebServer, HSQLDb In Process Persistent, HSQLDb In Memory. Cochez cette case pour autoriser, si besoin, le mode scuris. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes.
Basic settings
Use TLS/SSL sockets Host Port Database Alias Username et Password
480
tHSQLDbInput
DB path
Spcifiez le chemin daccs la base de donnes laquelle vous souhaitez vous connecter. Ce champ nest disponible quen mode dexcution HSQLDb In Process Persistent . Par dfaut, si la base de donnes que vous spcifiez dans ce champ nxiste pas, elle sera cre automatiquement. Si vous souhaitez changer la configuration par dfaut, modifiez le paramtre de connexion dfini dans le champ Additional JDBC parameters dans la vue Advanced settings. Saisissez le nom de la base de donnes laquelle vous souhaitez vous connecter. Ce champ nest disponible quavec les modes dexcution HSQLDb In Process Persistent et HSQLDb In Memory. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Db name
Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Cliquez sur le bouton pour rcuprer le schma de la table. Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Lorsque le mode dexcution est HSQLDb In Process Persistent, cette proprit supplmentaire est dfinie comme ifexists=true par dfaut, ce qui signifie que la base de donnes sera automatiquement cre lorsque cest ncessaire.
Guess Query
Guess schema Query
Advanced settings
481
tHSQLDbInput
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Global Variables Ce composant couvre toutes les possibilits de requtes SQL sur une base de donnes HSQLDb. Number of Lines : indique le nombre de lignes traites. Disponible en tant que variable After. Retourne un entier. Query : indique le nombre de requtes traites. Disponible en tant que variable Flow. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job dans le Guide Utilisateur Talend Open Studio. Connections Liens de sortie (dun composant un autre) : Row : Main, Iterate. Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error. Liens dentre (dun composant un autre) : Row : Iterate. Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error. Pour plus dinformations concernant les connexions, consultez Types de connexions du Guide Utilisateur Talend Open Studio.
Scnarios associs
Pour des scnarios associs, consultez : le Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. le Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. le Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie, page 637.
482
tHSQLDbOutput
tHSQLDbOutput
Proprits du tHSQLDbOutput
Le composant tHSQLDbOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tHSQLDbOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Running Mode Slectionnez dans la liste le type de serveur correspondant aux paramtres de votre base de donnes, parmi les quatre proposs : HSQLDb Server, HSQLDb WebServer, HSQLDb In Process Persistent, HSQLDb In Memory. Cochez cette case pour autoriser, si besoin, le mode scuris. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes.
Use TLS/SSL sockets Host Port Database Username et Password
483
tHSQLDbOutput
DB path
Spcifiez le chemin daccs la base de donnes laquelle vous souhaitez vous connecter. Ce champ nest disponible quen mode dexcution HSQLDb In Process Persistent . Par dfaut, si la base de donnes que vous spcifiez dans ce champ nxiste pas, elle sera cre automatiquement. Si vous souhaitez changer la configuration par dfaut, modifiez le paramtre de connexion dfini dans le champ Additional JDBC parameters dans la vue Advanced settings. Saisissez le nom de la base de donnes laquelle vous souhaitez vous connecter. Ce champ nest disponible quavec les modes dexcution HSQLDb In Process Persistent et HSQLDb In Memory. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table.
Db name
Table Action on table
484
tHSQLDbOutput
Action on data
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Die on error
485
tHSQLDbOutput
Advanced settings
Spcifiez des informations supplmentaires de connexion la base de donnes cre. Lorsque le mode dexcution est HSQLDb In Process Persistent, cette proprit supplmentaire est dfinie comme ifexists=true par dfaut, ce qui signifie que la base de donnes sera automatiquement cre lorsque cest ncessaire. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitementprtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tHSQLDbOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Commit every
Additional Columns
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes HSQLDb. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
486
tHSQLDbOutput
Global Variables
Number of Lines : indique le nombre de lignes traites. Disponible en tant que variable After. Retourne un entier. NB line Updated : indique le nombre de lignes mises jour. Disponible en tant que variable After. Retourne un entier. NB line Inserted : indique le nombre de lignes insres. Disponible en tant que variable After. Retourne un entier. NB line Deleted : indique le nombre de lignes supprimes. Disponible en tant que variable After. Retourne un entier. NB line Rejected : indique le nombre de lignes rjetes. Disponible en tant que variable After. Retourne un entier. Query : indique le nombre de requtes traites. Disponible en tant que variable Flow. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job dans le Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Row : Main, Iterate. Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error. Liens dentre (dun composant un autre) : Row : Main. Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error. Pour plus dinformations concernant les connexions, consultez Types de connexions du Guide Utilisateur Talend Open Studio.
Scnarios associs
487
tHSQLDbRow
tHSQLDbRow
Proprits du tHSQLDbRow
Fonction
tHSQLDbRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tHSQLDbRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Running Mode Slectionnez dans la liste le type de serveur correspondant aux paramtres de votre base de donnes, parmi les quatre proposs : HSQLDb Server, HSQLDb WebServer, HSQLDb In Process Persistent, HSQLDb In Memory. Cochez cette case pour autoriser, si besoin, le mode scuris. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Spcifiez le chemin daccs la base de donnes laquelle vous souhaitez vous connecter. Ce champ nest disponible quen mode dexcution HSQLDb In Process Persistent . Par dfaut, si la base de donnes que vous spcifiez dans ce champ nxiste pas, elle sera cre automatiquement. Si vous souhaitez changer la configuration par dfaut, modifiez le paramtre de connexion dfini dans le champ Additional JDBC parameters dans la vue Advanced settings. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository.
Objectif
Basic settings
Use TLS/SSL sockets Host Port Database Alias Username et Password DB path
488
tHSQLDbRow
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Query type Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. Guess Query Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Lorsque le mode dexcution est HSQLDb In Process Persistent, cette proprit supplmentaire est dfinie comme ifexists=true par dfaut, ce qui signifie que la base de donnes sera automatiquement cre lorsque cest ncessaire. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des paramtres reprsents par des ? dans linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction SQL. Parameter Type : Saisissez le type du paramtre. Parameter Value : Saisissez la valeur du paramtre. Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte. Elle permet un gain de performance.
Query
Die on error
Advanced settings
489
tHSQLDbRow
Commit every
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Global Variables Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL. Query : indique le nombre de requtes traites. Disponible en tant que variable Flow. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job dans le Guide Utilisateur Talend Open Studio. Connections Liens de sortie (dun composant un autre) : Row : Main,Reject, Iterate. Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error. Liens dentre (dun composant un autre) : Row : Main, Iterate. Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error. Pour plus dinformations concernant les connexions, consultez Types de connexions du Guide Utilisateur Talend Open Studio.
Scnarios associs
Pour des scnarios associs, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 411. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678.
490
tInformixBulkExec
tInformixBulkExec
Proprits du tInformixBulkExec
Les composants tInformixOutputBulk et tInformixBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tInformixOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le changement des donnes dans la base de donnes.
Famille de composant Databases/Informix
Fonction Objectif
Le composant tInformixBulkExec excute des oprations dInsert sur les donnes fournies. Le tInformixBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Informix. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Execution Platform Slectionnez le type de systme dexploitation que vous utilisez.
Basic settings
491
tInformixBulkExec
Cochez cette case et slectionnez le composant tInformixConnection adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Host Port Database Schema Username et Password Instance
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification sur lutilisateur de base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Nom de la table crire. Notez quune seule table peut tre crite la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear table : supprimer le contenu de la table.
Table Action on table
492
tInformixBulkExec
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Informix Directory Data file
Spcifiez le chemin daccs votre rpertoire Informix. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une cl de recherche sur laquelle baser les oprations Update et Delete. Il est possible de dfinir les colonnes qui agiront comme cl de recherche partir du schma, pour une utilisation de base, ou partir des options avances (Advanced settings) pour une utilisation optimise de ces oprations.
Action on data
Advanced settings
Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Caractre, chane ou expression rgulire sparant les champs. Quand vous cochez cette case, vous pouvez dfinir votre sparateur dcimal dans le champ Decimal separator. Slectionnez le format de date que vous souhaitez appliquer. Saisissez le nombre de lignes traiter avant commit.
Field terminated by Set DBMONEY
Set DBDATE Rows Before Commit
493
tInformixBulkExec
Bad Rows Before Abort
Saisissez le nombre de lignes derreur avant arrt du Job.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Output Utilisation Slectionnez lemplacement de la sortie.
Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes DB2.
Scnario associ
Pour un scnario associ au composant tInformixBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
494
tInformixClose
tInformixClose
Proprits du tInformixClose
Le composant tInformixClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Informix. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tInformixConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tInformixConnection et tInformixRollback. Ils sont gnralement utiliss avec un composant tInformixConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tInformixClose, consultez tMysqlConnection page 630
495
tInformixCommit
tInformixCommit
Proprits du tInformixCommit
Ce composant est troitement li aux composants tInformixConnection et tInformixRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tInformixCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tInformixConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tInformixCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Informix et notamment tInformixConnection et tInformixRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tInformixConnection et tInformixRollback. Ils sont gnralement utiliss avec un composant tInformixConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tInformixCommit, consultez tMysqlConnection page 630
496
tInformixConnection
tInformixConnection
Proprits du tInformixConnection
Ce composant est troitement li aux composants tInformixCommit et tInformixRollback. Ils sont gnralement utiliss avec un composant tInformixConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tInformixConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Schema Username et Password Instance Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Dcochez cette case lorsque la base de donnes est configure en mode NO_LOG. Si la case est coche, vous pouvez choisir dactiver ou non loption Auto Commit.
Additional JDBC parameters Use or register a shared DB Connection
Advanced settings
Use Transaction
497
tInformixConnection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est gnralement utilis avec des composants Informix, notamment les composants tInformixCommit et tInformixRollback. n/a
Scnarios associs
Pour un scnario associ au composant tInformixConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
498
tInformixInput
tInformixInput
Proprits du tInformixInput
Fonction Objectif
Le composant tInformixInput lit une base de donnes et en extrait des champs laide de requtes. Le tInformixInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez cette case et slectionnez le composant adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Basic settings
Host name Port Database Schema Username et Password Instance
499
tInformixInput
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Cliquez sur le bouton pour rcuprer le schma de la table. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Guess Query
Guess schema Advanced settings Additional JDBC parameters
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Informix.
Scnarios associs
Consultez les scnarios associs aux composants tDBInput et tMysqlInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie, page 637 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 du composant tContextLoad.
500
tInformixOutput
tInformixOutput
Proprits du tInformixOutput
Le composant tInformixOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tInformixOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez cette case et slectionnez le composant adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Nom de la table crer. Vous ne pouvez crer quune seule table la fois.
Table
501
tInformixOutput
Action on table
Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete).
Action on data
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio.
502
tInformixOutput
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Die on error Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tInformixOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier. Use field options Enable debug mode Use Batch Size Optimize the batch insertion Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture dans la base de donnes. Nombre de lignes dans chaque lot de traitement de donnes. Cocher cette case optimise linsertion de donnes par lots.
Advanced settings
Commit every
Additional Columns
503
tInformixOutput
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Informix. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ au composant tInformixOutput, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du composant tMysqlOutput. le Scnario 4 : Ecrire des colonnes dynamiques dun fichier source vers une base de donnes MySQL, page 864 du composant tMysqlOutput.
504
tInformixOutputBulk
tInformixOutputBulk
Proprits du tInformixOutputBulk
Les composants tInformixOutputBulk et tInformixBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tInformixOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Informix. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Informix. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Append Schema et Edit Schema
Advanced settings
Row separator Field separator Set DBMONEY
Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Quand vous cochez cette case, vous pouvez dfinir votre sparateur dcimal dans le champ Decimal separator.
505
tInformixOutputBulk
Set DBDATE
Slectionnez le format de date que vous souhaitez appliquer.
Create directory if not Cette case est coche par dfaut. Cette option permet exists de crer le dossier contenant le fichier de sortie sil nexiste pas dj. Custom the flush buffer size Cochez cette case pour personnaliser la taille de la mmoire utilise pour stocker temporairement les donnes, et dans le champ Row number, saisissez le nombre de lignes aprs lesquelles la mmoire est nouveau libre. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec le composant tInformixBulkExec. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes Informix.
Scnarios associs
Pour un scnario associ au tInformixOutputBulk, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec.
506
tInformixOutputBulkExec
Proprits du tInformixOutputBulkExec
Les composants tInformixOutputBulk et tInformixBulkExec sont gnralement utiliss ensemble comme deux parties dun processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime tape, ce fichier est utilis lors de lopration dINSERT afin de populer une base de donnes. Cette excution en deux tapes est unifie dans le composant tInformixOutputBulkExec.
Fonction Objectif
Le tInformixOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tInformixOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Informix. Property Type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Execution platform Slectionnez le type de systme dexploitation que vous utilisez.
Basic settings
507
Cochez cette case et slectionnez le composant tInformixConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dinsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear table : supprimer le contenu de la table.
Table
Action on table
508
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Informix Directory Data file
Spcifiez le chemin daccs votre rpertoire Informix. Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Les informations demandes seront diffrentes en fonction de laction choisie. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Quand vous cochez cette case, vous pouvez dfinir votre sparateur dcimal dans le champ Decimal separator. Slectionnez le format de date que vous souhaitez appliquer. Saisissez le nombre de lignes traiter avant commit. Saisissez le nombre de lignes derreur avant arrt du Job.
Append Action on data
Advanced settings
Row separator Fields terminated by Set DBMONEY
Set DBDATE Rows Before Commit Bad Rows Before Abort
Create directory if not Cette case est coche par dfaut. Cette option permet exists de crer le dossier contenant le fichier de sortie sil nexiste pas dj.
509
Custom the flush buffer size
Cochez cette case pour personnaliser la taille de la mmoire utilise pour stocker temporairement les donnes, et dans le champ Row number, saisissez le nombre de lignes aprs lesquelles la mmoire est nouveau libre. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Output Utilisation Limitation Slectionnez lemplacement de la sortie.
Ce composant est principalement utilis lorsquaucune transformation particulire nest requise sur les donnes charger dans la base de donnes. n/a
Scnarios associs
Pour un scnario associ au tInformixOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec.
510
tInformixRollback
tInformixRollback
Proprits du tInformixRollback
Ce composant est troitement li aux composants tInformixCommit et tInformixConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Le tInformixRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tInformixConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Informix, notamment avec le tInformixConnection et le tInformixCommit. n/a
Scnario associ
Pour un scnario associ au tInformixRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674 du composant tMysqlRollback.
511
tInformixRow
tInformixRow
Proprits du tInformixRow
Fonction
tInformixRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tInformixRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tInformixConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur.
Objectif
Basic settings
512
tInformixRow
Database Schema Username et Password Instance
Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Nom de la table. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.
Query
Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Dcochez cette case lorsque la base de donnes est configure en mode NO_LOG. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column.
Guess Query
Die on error
Use Transaction Advanced settings Additional JDBC parameters
513
tInformixRow
Commit every
Scnarios associs
514
tInformixSCD
tInformixSCD
Le composant tInformixSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tInformixSCD, page 146.
515
tInformixSP
tInformixSP
Proprits du tInformixSP
Le composant tInformixSP appelle une procdure stocke de base de donnes. Le tInformixSP permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tInformixConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Username et Password Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes.
516
tInformixSP
Instance
Nom de linstance Informix utiliser. Cette information se trouve gnralement dans le fichier SQL hosts. Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est rutilisable. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Saisissez le nom exact de la Procdure Stocke (SP). Cochez cette case si une seule valeur doit tre retourne. Slectionnez dans la liste la colonne du schma sur laquelle est base la valeur obtenir. Cliquez sur le bouton [+] et slectionnez dans le champ Schema Columns les diffrentes colonnes ncessaires la procdure. Notez que le schma de la SP peut contenir plus de colonnes quil ny a de paramtres utiliss dans la procdure. Slectionnez le Type de paramtre : IN : paramtre dentre (Input) OUT : paramtre de sortie (Output)/valeur retourne IN OUT : les paramtres dentre doivent tre retournes sous forme de valeur, mme aprs modifications via la procdure (fonction). RECORDSET : les paramtres dentre doivent tre retournes sous forme densemble de valeurs, au lieu dune valeur unique. Consultez le composant tParseRecordSet si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL. Dcochez cette case lorsque la base de donnes est configure en mode NO_LOG. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.
Parameters
Use Transaction Advanced settings Additional JDBC parameters
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss. La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes. Composants Talend Open Studio 517
tInformixSP
Scnarios associs
Pour un scnario associ, consultez : le Scnario : Trouver le libell State laide dune procdure stocke, page 689 du composant tMysqlSP. le Scnario : Vrifier le format de numros laide dune procdure stocke, page 756 du composant tOracleSP. Consultez galement le composant tParseRecordSet, page 786 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.
518
tIngresClose
tIngresClose
Proprits du tIngresClose
Famille de composant Databases/Ingres
Le composant tIngresClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Ingres. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tIngresConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tIngresConnection et tIngresRollback. Ils sont gnralement utiliss avec un composant tIngresConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tIngresClose, consultez tMysqlConnection page 630
519
tIngresCommit
tIngresCommit
Proprits du tIngresCommit
Ce composant est troitement li aux composants tIngresConnection et tIngresRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tIngresCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Slectionnez le composant tIngresConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tIngresCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants JDBC et notamment avec les composants tIngresConnection et tIngresRollback. n/a
Scnario associ
Pour un scnario associ au tIngresCommit, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
520
tIngresConnection
tIngresConnection
Proprits du tIngresConnection
Ce composant est troitement li aux composants tIngresCommit et tIngresRollback. Ils sont gnralement utiliss avec un composant tIngresConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tIngresConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Server Port Database Table Schema Username et Password Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.
Ce composant est gnralement utilis avec des composants JDBC et notamment avec les composants tIngresCommit et tIngresRollback. n/a
Scnario associ
Pour un scnario associ au tIngresConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
521
tIngresInput
tIngresInput
Proprits du tIngresInput
Fonction Objectif
Le composant tIngresInput lit une base de donnes et en extrait des champs laide de requtes. Le tIngresInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Server Port Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Basic settings
522
tIngresInput
Query type et Query
Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Ingres.
Scnarios associs
Consultez les scnarios associs au composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie, page 637. Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 du composant tContextLoad.
523
tIngresOutput
tIngresOutput
Proprits du tIngresOutput
Le composant tIngresOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tIngresOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Port Database Username et Password Table Action on table Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table.
524
tIngresOutput
Action on data
Die on error
525
tIngresOutput
Advanced settings
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tIngresOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Ingres. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
526
tIngresRollback
tIngresRollback
Proprits du tIngresRollback
Ce composant est troitement li aux composants tIngresCommit et tIngresConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Le tIngresRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tIngresConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Ingres, notamment avec le tIngresConnection et le tIngresCommit. n/a
Scnario associ
Pour un scnario associ au tIngresRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674 du composant tMysqlRollback.
527
tIngresRow
tIngresRow
Proprits du tIngresRow
Fonction
tIngresRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tIngresRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type Nom de la table traiter. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.
Objectif
Basic settings
528
tIngresRow
Query
Die on error
Advanced settings
Commit every
Scnarios associs
529
tIngresSCD
tIngresSCD
Le composant tIngresSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tIngresSCD, page 148.
530
tInterbaseClose
tInterbaseClose
Proprits du tInterbaseClose
Famille de composant Databases/Interbase
Le composant tInterbaseClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Interbase. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tInterbaseConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tInterbaseConnection et tInterbaseRollback. Ils sont gnralement utiliss avec un composant tInterbaseConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tInterbaseClose, consultez tMysqlConnection page 630
531
tInterbaseCommit
tInterbaseCommit
Proprits du tInterbaseCommit
Ce composant est troitement li aux composants tInterbaseConnection et tInterbaseRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tInterbaseCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Slectionnez le composant tInterbaseConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tInterbaseCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Interbase et notamment avec les composants tInterbaseConnection et tInterbaseRollback. n/a
Limitation
Scnario associ
Pour un scnario associ au tInterbaseCommit, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
532
tInterbaseConnection
tInterbaseConnection
Proprits du tInterbaseConnection
Ce composant est troitement li aux composants tInterbaseCommit et tInterbaseRollback. Ils sont gnralement utiliss avec un composant tInterbaseConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tInterbaseConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Table Schema Username et Password Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.
Ce composant est gnralement utilis avec des composants Interbase, notamment les composants tInterbaseCommit et tInterbaseRollback. n/a
Scnarios associs
Pour un scnario associ au composant tInterbaseConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
533
tInterbaseInput
tInterbaseInput
Proprits du tInterbaseInput
Fonction Objectif
Le composant tInterbaseInput lit une base de donnes et en extrait des champs laide de requtes. Le tInterbaseInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.
Basic settings
534
tInterbaseInput
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Interbase.
Scnarios associs
Consultez les scnarios associs au composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie, page 637. Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 associ au composant tContextLoad.
535
tInterbaseOutput
tInterbaseOutput
Proprits du tInterbaseOutput
Le composant tInterbaseOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tInterbaseOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Database Username et Password Table Action on table Adresse IP du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table.
536
tInterbaseOutput
Action on data
Clear data in table
Cochez cette case pour que les donnes soient supprimes de la table slectionne avant toute action. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Die on error
537
tInterbaseOutput
Advanced settings
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tInterbaseOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Interbase. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 associ au composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 associ au composant tMysqlOutput.
538
tInterbaseRollback
tInterbaseRollback
Proprits du tInterbaseRollback
Ce composant est troitement li aux composants tInterbaseCommit et tInterbaseConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Le tInterbaseRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tInterbaseConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Interbase, notamment avec le tInterbaseConnection et le tInterbaseCommit. n/a
Scnario associ
Pour un scnario associ au tInterbaseRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674 du composant tMySQLRollback.
539
tInterbaseRow
tInterbaseRow
Proprits du tInterbaseRow
Fonction
tInterbaseRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tInterbaseRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tInterbaseConnection adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Database Adresse IP du serveur de base de donnes. Nom de la base de donnes.
Objectif
Basic settings
540
tInterbaseRow
Username et Password Table Name Schema et Edit Schema
Informations dauthentification de lutilisateur de base de donnes. Nom de la table traiter. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Query type
Query
Die on error
Advanced settings
541
tInterbaseRow
Commit every
Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 411 associ au composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678 associ au composant tMySQLRow.
542
tJavaDBInput
tJavaDBInput
Proprits du tJavaDBInput
Famille de composant Databases/JavaDB
Fonction Objectif
Le composant tJavaDBInput lit une base de donnes et en extrait des champs laide de requtes. Le tJavaDBInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Framework Database DB root path Username et Password Schema et Edit Schema Slectionnez dans la liste un framework pour votre base de donnes Java. Nom de la base de donnes. Parcourez vos fichiers jusqu la racine de votre base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio.
Basic settings
543
tJavaDBInput
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes JavaDB.
Scnarios associs
544
tJavaDBOutput
tJavaDBOutput
Proprits du tJavaDBOutput
Le composant tJavaDBOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tJavaDBOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Framework Database DB root path Username et Password Table Action on table Slectionnez dans la liste un framework pour votre base de donnes Java. Nom de la base de donnes. Parcourez vos fichiers jusqu la racine de votre base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table.
545
tJavaDBOutput
Action on data
Die on error
546
tJavaDBOutput
Advanced settings
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tJavaDBOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes JavaDB. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios asoocis
547
tJavaDBRow
tJavaDBRow
Proprits du tJavaDBRow
Fonction
tJavaDBRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tJavaDBRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Framework Type Database DB root path Username et Password Schema et Edit Schema Slectionnez dans la liste un framework pour votre base de donnes Java. Nom de la base de donnes. Parcourez vos fichiers jusqu la racine de votre base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type Nom de la table traiter. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder.
Objectif
Basic settings
548
tJavaDBRow
Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. Query Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des paramtres reprsents par des ? dans linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction SQL. Parameter Type : Saisissez le type du paramtre. Parameter Value : Saisissez la valeur du paramtre. Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte. Elle permet un gain de performance. Commit every Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.
Die on error
Advanced settings
Scnarios associs
549
tJDBCColumnList
tJDBCColumnList
Proprits du tJDBCColumnList
Famille de composants Databases/JDBC
Le composant tJDBCColumList effectue une opration ditration dans toutes les colonnes dune table donne, grce une connexion JDBC dfinie. Le tJDBCColumList permet de faire une liste des libells des colonnes dune table JDBC donne. Component list Slectionnez le composant tJDBCConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Nom de la table lire.
Table name Utilisation Limitation
Il faut utiliser ce composant en association avec les autres composants JDBC, notamment avec le tJDBCConnection. n/a
Scnario associ
Pour un scnario associ, consultez le Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table, page 625.
550
tJDBCClose
tJDBCClose
Proprits du tJDBCClose
Famille de composant Databases/JDBC
Le composant tJDBCClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes JDBC. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tJDBCConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tJDBCConnection et tJDBCRollback. Il est gnralement utilis avec un composant tJDBCConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tJDBCClose, consultez tMysqlConnection page 630
551
tJDBCCommit
tJDBCCommit
Proprits du tJDBCCommit
Ce composant est troitement li aux composants tJDBCConnection et tJDBCRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tJDBCCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Slectionnez le composant tJDBCConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tJDBCCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants JDBC et notamment avec les composants tJDBCConnection et tJDBCRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tJDBCConnection et tJDBCRollback. Ils sont gnralement utiliss avec un composant tJDBCConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tJDBCCommit, consultez tMysqlConnection page 630.
552
tJDBCConnection
tJDBCConnection
Proprits du tJDBCConnection
Ce composant est troitement li aux composants tJDBCCommit et tJDBCRollback. Ils sont gnralement utiliss avec un composant tJDBCConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tJDBCConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie.
JDBC URL
Entrez lURL JDBC dans le champ associ pour vous connecter la base de donnes. Par exemple, entrez jdbc:mysql://IP address/database name pour vous connecter une base de donnes mysql. Cliquez sur le bouton [+] sous le tableau afin dajouter autant de lignes que ncessaire pour charger diffrents JARs. Dans chaque ligne, cliquez ensuite sur le bouton [...] pour ouvrir lassistant Select Module, dans lequel vous pouvez slectionner le pilote JAR de votre choix pour chaque ligne. Renseignez la classe du driver dans le champ Driver Class en fonction de votre connexion. Par exemple, entrez com.mysql.jdbc.Driver dans ce champ pour vous connecter une base de donnes mysql. Entrez les informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case afin dafficher la case Auto Commit. Si vous la cochez, elle activera le mode auto-commit. Une fois la case Use Auto-Commit dcoche, la case Auto-Commit ne sera plus visible.
Driver JAR
Driver Class
Username et Password Use or register a shared DB Connection
Advanced settings
Use Auto commit
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, au niveau de chaque composant. Utilisation Ce composant est gnralement utilis avec des composants JDBC et notamment avec les composants tJDBCCommit et tJDBCRollback.
553
tJDBCConnection
Limitation
n/a
Scnario associ
Ce composant est troitement li aux composants tJDBCCommit et tJDBCRollback. Ils sont gnralement utiliss avec un composant tJDBCConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tJDBCConnection, consultez tMysqlConnection page 630.
554
tJDBCInput
tJDBCInput
Proprits du tJDBCInput
Fonction Objectif
Le composant tJDBCInput lit toute base de donnes via une API JDBC et en extrait des champs laide de requtes. Le tJDBCInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tJDBCConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Basic settings
555
tJDBCInput
Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. JDBC URL Driver JAR Entrez le chemin daccs la base de donnes. Cliquez sur le bouton [+] sous le tableau afin dajouter autant de lignes que ncessaire pour charger diffrents JARs. Dans chaque ligne, cliquez ensuite sur le bouton [...] pour ouvrir lassistant Select Module, dans lequel vous pouvez slectionner le pilote JAR de votre choix pour chaque ligne. Dans le champ Class name, renseignez le nom de la classe pour quelle soit indique dans le driver. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Query type et Query Nom de la table lire. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en une fois. Cette option permet doptimiser les performances. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Class Name Username et Password Schema et Edit Schema
Advanced settings
Use cursor
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes utilisant une connection JDBC.
556
tJDBCInput
Scnarios associs
557
tJDBCOutput
tJDBCOutput
Proprits du tJDBCOutput
Le composant tJDBCOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tJDBCOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut-tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tJDBCConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
558
tJDBCOutput
Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. JDBC URL Driver JAR Entrez le chemin daccs la base de donnes. Cliquez sur le bouton [+] sous le tableau afin dajouter autant de lignes que ncessaire pour charger diffrents JARs. Dans chaque ligne, cliquez ensuite sur le bouton [...] pour ouvrir lassistant Select Module, dans lequel vous pouvez slectionner le pilote JAR de votre choix pour chaque ligne. Dans le champ Class name, renseignez le nom de la classe pour quelle soit indique dans le driver. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete).
Class Name Username et Password Table Action on data
559
tJDBCOutput
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tJDBCOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Advanced settings
Commit every
Additional Columns
Use field options Enable debug mode Use Batch Size
Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture dans la base de donnes. Nombre de lignes dans chaque lot de traitement de donnes.
560
tJDBCOutput
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes JDBC. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ au tJDBCOutput, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du composant tMysqlOutput.
561
tJDBCRollback
tJDBCRollback
Proprits du tJDBCRollback
Ce composant est troitement li aux composants tJDBCCommit et tJDBCConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Le tJDBCRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tJDBCConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants JDBC, notamment avec le tJDBCConnection et le tJDBCCommit. n/a
Scnario associ
Ce composant est troitement li aux composants tJDBCConnection et tJDBCCommit. Ils sont gnralement utiliss avec un composant tJDBCConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tJDBCRollback, consultez tMysqlConnection page 630.
562
tJDBCRow
tJDBCRow
Proprits du tJDBCRow
Fonction
tJDBCRow est le composant gnrique pour tout type de base de donnes utilisant une API JDBC. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tJDBCRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Use an existing connection Cochez cette case et slectionnez le composant tJDBCConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. JDBC URL Driver JAR Entrez le chemin daccs la base de donnes. Cliquez sur le bouton [+] sous le tableau afin dajouter autant de lignes que ncessaire pour charger diffrents JARs. Dans chaque ligne, cliquez ensuite sur le bouton [...] pour ouvrir lassistant Select Module, dans lequel vous pouvez slectionner le pilote JAR de votre choix pour chaque ligne. Renseignez le nom de la classe pour quelle soit indique dans le driver.
Objectif
Basic settings
Class Name
563
tJDBCRow
Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Query type
Query
Die on error
Advanced settings
564
tJDBCRow
Commit every
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur toute base de donnes utilisant une connexion JDBC et couvre toutes les possibilits de requtes SQL.
Scnarios associs
565
tJDBCSP
tJDBCSP
Proprits du tJDBCSP
Le composant tJDBCSP appelle une procdure stocke de base de donnes. Le tJDBCSP permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. JDBC URL Driver JAR Entrez le chemin daccs la base de donnes. Cliquez sur le bouton [+] sous le tableau afin dajouter autant de lignes que ncessaire pour charger diffrents JARs. Dans chaque ligne, cliquez ensuite sur le bouton [...] pour ouvrir lassistant Select Module, dans lequel vous pouvez slectionner le pilote JAR de votre choix pour chaque ligne. Dans le champ Class name, renseignez le nom de la classe pour quelle soit indique dans le driver. Informations dauthentification de lutilisateur de base de donnes. Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est rutilisable. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. SP Name Is Function / Return result in Saisissez le nom exact de la Procdure Stocke (SP). Cochez cette case si une seule valeur doit tre retourne. Slectionnez dans la liste la colonne du schma sur laquelle est base la valeur obtenir.
Class Name Username et Password Schema et Edit Schema
566
tJDBCSP
Parameters
Cliquez sur le bouton (+) et slectionnez dans le champ Schema Columns les diffrentes colonnes ncessaires la procdure. Notez que le schma de la SP peut contenir plus de colonnes quil ny a de paramtres utiliss dans la procdure. Slectionnez le Type de paramtre : IN : paramtre dentre (Input) OUT : paramtre de sortie (Output)/valeur retourne IN OUT : les paramtres dentre doivent tre retournes sous forme de valeur, mme aprs modifications via la procdure (fonction). RECORDSET : les paramtres dentre doivent tre retournes sous forme densemble de valeurs, au lieu dune valeur unique. Consultez le composant tParseRecordSet si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss. La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.
Scnarios associs
Pour un scnario associ, consultez : le Scnario : Trouver le libell State laide dune procdure stocke, page 689 du composant tMysqlSP. le Scnario : Vrifier le format de numros laide dune procdure stocke, page 756 du composant tOracleSP. Consultez galement le composant tParseRecordSet, page 786 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.
567
tJDBCTableList
tJDBCTableList
Proprits du tJDBCTableList
Le composant tJDBCTableList effectue une opration ditration sur toutes les tables dune base de donnes, grce une connexion JDBC dfinie. Le composant tJDBCTableList permet de lister les noms des tables JDBC grce aux commandes SELECT et WHERE. Component list Slectionnez le composant de connexion tJDBCConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours.
Where clause for table Saisissez la commande WHERE permettant name selection didentifier les tables sur lesquelles effectuer lopration ditration. Utilisation Limitation Il faut utiliser ce composant en association avec les autres composants JDBC, notamment avec le tJDBCConnection. n/a
Scnario associ
568
tLDAPAttributesInput
Proprits du tLDAPAttributesInput
Famille de composant Databases/LDAP
Fonction Objectif
Le composant tLDAPAttributesInput analyse chaque lment trouv via une requte LDAP et liste une srie dattributs associs lobjet. Le tLDAPAttributesInput excute une LDAP base sur un filtre prdfini et correspondant au schma dfini. Puis la liste de champ est transmise au composant suivant via une connexion Main row. Property type Peut-tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Base DN Protocol Adresse IP du serveur dannuaire LDAP. Numro du port dcoute du serveur. Chemin daccs larborescence de lutilisateur autoris. Slectionnez le type de protocole dans la liste. LDAP : aucun codage nest utilis LDAPS : LDAP scuris. Quand cette option est slectionne, la case Advanced CA apparat. Une fois slectionn, le mode avanc vous permet de spcifier le rpertoire et le mot de de passe de la cl secrte du certificat pour le stockage dun CA spcifique. Cependant, vous pouvez toujours dsactiver la validation du certificat, en cochant la case Trust all certs. TLS : le certificat est utilis. Quand cette option est slectionne, la case Advanced CA apparat et est utilise de la mme faon que pour le type LPDAPS. Cochez Authentication si une connexion LDAP est ncessaire. Notez que le login doit correspondre la syntaxe LDAP pour tre valide. Par exemple : cn=Directory Manager. Saisissez le filtre comme attendu par lannuaire LDAP db. Saisissez le sparateur de valeur des champs valeurs multiples.
Basic settings
Authentication User et Password
Filter Multi valued field separator
569
Alias dereferencing
Slectionnez loption dans la liste. Never permet lamlioration des performances de recherche si vous tes sr quaucun alias nest drfrenc. Par dfaut, utilisez Always : Always : les alias sont toujours drfrencs. Never : les alias ne sont jamais drfrencs. Searching : cette option drfrence les alias uniquement aprs la rsolution du nom. Finding : cette option drfrence les alias uniquement lors de la rsolution du nom. Slectionnez loption dans la liste : Ignore : ne tient pas compte des redirections des requtes Follow : tient compte des redirections des requtes Cette option permet de limiter le nombre denregistrement lus, si ncessaire. Cette option permet de limiter la dure de connexion lannuaire. Spcifiez le nombre dentres retournes en une fois par le serveur LDAP. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject.
Referral handling
Limit Time Limit Paging Die on error
Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Comme ce composant sert lister les attributs associs un lment LDAP, sont schma est prdfini. Conservez ces colonnes dfinies, mme si vous avez besoin dajouter de nouvelles colonnes. Pour cela, utilisez le mode Built-In. Le schma prdfini comprend : - objectclass : liste des classes dlments - mandatoryattributes : liste des attributs obligatoires pour ces classes - optionalattributes : liste des attributs facultatifs pour ces classes - objectattributes : liste des attributs essentiels aux lments analyss.
570
Advanced settings
Class Definition Root tStatCatcher Statistics
Spcifiez la racine de lespace de nom de llment Class definition. Cochez cette case pour collecter les donnes de log au niveau du composant.
Utilisation
Ce composant couvre toutes les requtes LDAP possibles. Note : Appuyez sur Ctrl + Espace pour accder la liste des variables globales, inclus la variable GetResultName permettant de rcuprer automatiquement la base correspondante.
Scnario associ
Le composant tLDAPAttributesInput fonctionne de manire similaire au tLDAPInput. Vous pouvez donc consulter le Scnario : Afficher le contenu filtr dun annuaire LDAP, page 574
571
tLDAPInput
tLDAPInput
Proprits du tLDAPInput
Fonction Objectif
Le composant tLDAPInput lit un rpertoire et extrait les donnes en fonction dun filtre dfini. Le tLDAPInput excute une LDAP base sur un filtre prdfini et correspondant au schma dfini. Puis la liste de champ est transmise au composant suivant via une connexion Main row. Property type Peut-tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . Host Port Base DN Adresse IP du serveur dannuaire LDAP. Numro du port dcoute du serveur. Chemin daccs larborescence de lutilisateur autoris. Pour retrouver les informations compltes du Distinguished Name, ajoutez un champ appell DN dans le schma, en minuscules ou en majuscules. Slectionnez le type de protocole dans la liste. LDAP : aucun codage nest utilis LDAPS : LDAP scuris. Quand cette option est slectionne, la case Advanced CA apparat. Une fois slectionn, le mode avanc vous permet de spcifier le rpertoire et le mot de de passe de la cl secrte du certificat pour le stockage dun CA spcifique. Cependant, vous pouvez toujours dsactiver la validation du certificat, en cochant la case Trust all certs. TLS : le certificat est utilis. Quand cette option est slectionne, la case Advanced CA apparat et est utilise de la mme faon que pour le type LPDAPS.
Basic settings
Protocol
572
tLDAPInput
Authentication User et Password
Cochez Authentication si une connexion LDAP est ncessaire. Notez que le login doit correspondre la syntaxe LDAP pour tre valide. Par exemple : cn=Directory Manager. Saisissez le filtre comme attendu par lannuaire LDAP db. Saisissez le sparateur de valeur des champs valeurs multiples. Slectionnez loption dans la liste. Never permet lamlioration des performances de recherche si vous tes sr quaucun alias nest drfrenc. Par dfaut, utilisez Always : Always : les alias sont toujours drfrencs. Never : les alias ne sont jamais drfrencs. Searching : cette option drfrence les alias uniquement aprs la rsolution du nom. Finding : cette option drfrence les alias uniquement lors de la rsolution du nom. Slectionnez loption dans la liste : Ignore : ne tient pas compte des redirections des requtes Follow : tient compte des redirections des requtes Cette option permet de limiter le nombre denregistrement lus, si ncessaire. Cette option permet de limiter la dure de connexion lannuaire. Spcifiez le nombre dentres retournes en une fois par le serveur LDAP. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject.
Filter Multi valued field separator Alias dereferencing
Referral handling
Limit Time Limit Paging Die on error
Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Utilisation Ce composant couvre toutes les requtes LDAP possibles. Note : Appuyez sur Ctrl + Espace pour accder la liste des variables globales, inclus la variable GetResultName permettant de rcuprer automatiquement la base correspondante.
573
tLDAPInput
Scnario : Afficher le contenu filtr dun annuaire LDAP

Le Job dcrit ci-dessous filtre simplement lannuaire LDAP et affiche le rsultat dans la console Run Job.
Cliquez et dposez les composants tLDAPInput et tLogRow. Paramtrez les proprits du tLDAPInput. Slectionnez Repository dans le champ Property type si vous avez stock les informations de connexion LDAP dans le Metadata Manager du Repository. Puis slectionnez lentre adquate dans la liste. En mode Built-In, renseignez manuellement les champs Host et Port. Host peut tre ladresse IP du serveur de lannuaire LDAP ou son nom DNS. Aucune Base DN particulire ne doit tre paramtre.
574
tLDAPInput
Puis dans le champ Protocol, slectionnez le protocole adquat dans la liste. Dans cet exemple : un protocole LDAP simple est utilis. Cochez la case Authentication et renseignez les informations de connexion pour lire lannuaire, si ncessaire. Dans ce scnario, aucune authentification nest ncessaire. Dans la zone Filter, saisissez la commande sur laquelle est base la slection de donnes. Dans cet exemple, le filtre est : (&(objectClass=inetorgperson)&(uid=PIERRE DUPONT)). Renseignez le champ Multi-valued field separator avec une virgule, puisque certains champs contiennent plus dune valeur spare par une virgule. Comme vous ne savez pas si des alias sont utiliss dans lannuaire LDAP, slectionnez Always dans la liste. Slectionnez Ignore dans le champ Referral handling. Dans le champ Limit, dfinissez la limite 100 dans cet exemple.
Dfinissez le Schma tel quil est requis par lannuaire LDAP. Dans cet exemple, le schma est compos de 6 colonnes dont les colonnes objectClass et uid qui seront filtres. Dans le composant tLogRow, aucune configuration particulire nest exige.
Seule une entre de lannuaire correspond aux critres du filtre dfini dans le composant tLDAPInput.
575
tLDAPOutput
tLDAPOutput
Proprits du tLDAPOutput
Fonction Objectif
Le composant tLDAPOutput crit dans un annuaire LDAP. Le tLDAPOutput excute une requte LDAP base sur un filtre prdfini et correspondant un schma dfini. Puis la liste de champ est transmise au composant suivant via une connexion Main row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Port Base DN Protocol Adresse IP du serveur dannuaire LDAP. Numro de port dcoute du serveur. Chemin daccs larborescence de lutilisateur autoris. Slectionnez le type de protocole dans la liste. LDAP : aucun codage nest utilis LDAPS : LDAP scuris. Quand cette option est slectionne, la case Advanced CA apparat. Une fois slectionn, le mode avanc vous permet de spcifier le rpertoire et le mot de de passe de la cl secrte du certificat pour le stockage dun CA spcifique. Cependant, vous pouvez toujours dsactiver la validation du certificat, en cochant la case Trust all certs. TLS : le certificat est utilis. Quand cette option est slectionne, la case Advanced CA apparat et est utilise de la mme faon que pour le type LPDAPS. Renseignez les champs User (utilisateur) et Password (mot de passe) conformment lannuaire. Notez que le login doit correspondre la syntaxe LDAP pour tre valide. Par exemple : cn=Directory Manager. Caractre, chane ou expression rgulire sparant les informations dans un champ multi-valu.
Basic settings
User et Password
Multi valued field separator
576
tLDAPOutput
Alias dereferencing
Slectionnez loption dans la liste. Never permet lamlioration des performances de recherche si vous tes sr quaucun alias nest drfrenc. Par dfaut, utilisez Always. Always : les alias sont toujours drfrencs. Never : les alias ne sont jamais drfrencs. Searching : cette option drfrence les alias uniquement aprs la rsolution du nom. Finding : cette option drfrence les alias uniquement lors de la rsolution du nom. Slectionnez loption dans la liste : Ignore : ne tient pas compte des redirections des requtes. Follow : tient compte des redirections des requtes. Slectionnez laction dans la liste : Add : ajoute une valeur dans un attribut multi-valu Insert : insre de nouvelles donnes Update : met jour les donnes existantes Delete : supprime les donnes slectionnes de lannuaire Insert or Update : insre et met jour les donnes Slectionnez, partir de la liste droulante, le type dentre LDAP utilis. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Referral handling
Insert mode
DN Column Name Schema et Edit schema
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant couvre toutes les requtes LDAP possibles. Note : Appuyez sur Ctrl + Espace pour accder la liste des variables globales, inclus la variable GetResultName permettant de rcuprer automatiquement la base correspondante. Ce composant permet de faire des actions sur une table ou les donnes dune table dune base de donnes Oracle. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
577
tLDAPOutput
Scnario : Editer des donnes dans un annuaire LDAP
Le scnario suivant dcrit un Job qui lit un annuaire LDAP, met jour lemail dune entre slectionne et affiche la sortie avant de mettre jour lannuaire LDAP en sortie. Cest--dire quaucun alias nest drfrenc et quaucune requte nest redirige. Ce scnario est bas sur le scnario du LDAPInput (cf. Scnario : Afficher le contenu filtr dun annuaire LDAP, page 574). Le rsultat obtenu est une entre simple, correspondant une personne organisationnelle dont lemail est mis jour.
Cliquez et dposez les composants tLDAPInput, tLDAPOutput, tMap et tLogRow dans lespace de modlisation. Connectez le composant dentre au tMap puis au tLogRow puis au composant de sortie. Dans la vue Component du tLDAPInput, paramtrez les informations de connexion au serveur dannuaire LDAP, ainsi que les filtres tel que dcrit dans le Scnario : Afficher le contenu filtr dun annuaire LDAP, page 574. Simplifiez le schma en enlevant les champs suivants : dc, ou, objectclass.
Puis ouvrez le mapper pour dfinir les changements excuter. Glissez et dposez la colonne uid de la table dentre (input) la table de sortie (output) puisque aucune modification nest ncessaire pour cette colonne.
Dans le champ Expression de la colonne dn de la table de sortie (output), saisissez lexpression exacte attendue par le serveur LDAP afin quil atteigne larborescence souhaite et permette dcrire dans lannuaire, condition que vous nayez pas dj renseign le champ Base DN du composant tLDAPOutput.
578
tLDAPOutput
Dans cet exemple, la variable globale GetResultName est utilise pour rcuprer automatiquement le chemin daccs. Appuyez sur Ctrl+Espace pour accder la liste de variable et slectionnez tLDAPInput_1_RESULT_NAME. Dans le champ Expression de la colonne mail, saisissez ladresse email qui remplacera celle obsolte dans lannuaire LDAP. Dans cet exemple, le nouvel email est : Pierre.Dupont@talend.com. Cliquez sur OK pour valider les modifications. Le composant tLogRow ne ncessite pas de paramtrage particulier. Puis slectionnez le composant tLDAPOutput pour dfinir les proprits dcriture dans lannuaire.
Dfinissez manuellement les champs Port et Host si ces informations ne sont pas stockes dans le Repository. Dans le champ Base DN, dfinissez la plus haute arborescence laquelle vous avez accs. Si vous navez pas dfini le chemin complet et exact au DN cible, dfinissez-le ici. Dans cet exemple, le DN complet est fournit par la sortie dn du composant tMap, Ainsi, seule la plus haute arborescence accessible est fournie : o=directoryRoot. Slectionnez le protocole utiliser : LDAP pour cet exemple. Puis renseignez les champs User et Password attendus par lannuaire LDAP. Laissez les paramtres par dfaut des champs Alias Dereferencing et Referral Handling, cest--dire respectivement Always et Ignore. Dans le champ Insert mode, slectionnez loption Update pour cet exemple (ladresse email). Le schma est rcupr du composant prcdent laide dune opration de propagation. Enregistrez le Job et excutez-le en appuyant sur la touche F6.
579
tLDAPOutput
La sortie montre les champs suivants : dn, uid et mail comme dfini dans le Job.
580
tLDAPRenameEntry
tLDAPRenameEntry
Proprits du tLDAPRenameEntry
Le composant tLDAPRenameEntry renomme des entres dans un annuaire LDAP. Le tLDAPRenameEntry permet de renommer une ou des entre(s) dans un annuaire LDAP slectionn. Property type Peut-tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Base DN Protocol Adresse IP du serveur dannuaire LDAP. Numro du port dcoute du serveur. Chemin daccs larborescence de lutilisateur autoris. Slectionnez le type de protocole dans la liste. LDAP : aucun codage nest utilis LDAPS : LDAP scuris TLS : le certificat est utilis Renseignez les informations dauthentification de lutilisateur. Notez que le login doit correspondre la syntaxe LDAP pour tre valide. Par exemple : cn=Directory Manager. Slectionnez loption dans la liste. Never permet lamlioration des performances de recherche si vous tes sr quaucun alias nest drfrenc. Par dfaut, utilisez Always : Always : les alias sont toujours drfrencs. Never : les alias ne sont jamais drfrencs. Searching : cette option drfrence les alias uniquement aprs la rsolution du nom. Finding : cette option drfrence les alias uniquement lors de la rsolution du nom. Slectionnez loption dans la liste : Ignore : ne tient pas compte des redirections des requtes Follow : tient compte des redirections des requtes
User et Password
Alias dereferencing
Referrals handling
Previous DN et New DN Slectionnez partir de la liste droulante la colonne du schma portant lancien DN (Previous DN) et celle portant le nouveau DN appliquer (New DN).
581
tLDAPRenameEntry
Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Die on error Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject.
Utilisation
Ce composant couvre toutes les requtes LDAP possibles. Il est gnralement utilis comme sous-Job un seul composant mais il peut aussi tre utilis en association avec dautres composants. Note : Appuyez sur Ctrl + Espace pour accder la liste des variables globales, inclus la variable GetResultName permettant de rcuprer automatiquement la base correspondante.
Scnarios associs
Pour un scnario associ au composant tLDAPRenameEntry, consultez : le Scnario : Afficher le contenu filtr dun annuaire LDAP, page 574 du composant tLDAPInput. le Scnario : Editer des donnes dans un annuaire LDAP, page 578 du tLDAPOutput.
582
tMaxDBInput
tMaxDBInput
Proprits du tMaxDBInput
Famille de composant Databases/MaxDB
Fonction Objectif
Le composant tMaxDBInput lit une table de base de donnes et en extrait des champs laide de requtes. Le tMaxDBInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . Host name Port Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table name Entrez le nom de la table.
Basic settings
583
tMaxDBInput
Query type et Query
Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Cliquez sur le bouton pour rcuprer le schma de la table. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Guess Query
Guess schema Advanced settings Trim all the String/Char columns Trim column
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL.
Scnarios associs
Pour un scnario associ, consultez les scnarios : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie, page 637.
584
tMaxDBOutput
tMaxDBOutput
Proprits du tMaxDBOutput
Famille de composant Databases/MaxDB
Le composant tMaxDBOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tMaxDBOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Port Database Username et Password Table Action on table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback.
585
tMaxDBOutput
Action on data
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Die on error
586
tMaxDBOutput
Advanced settings
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tMaxDBOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes MaxDB. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
587
tMaxDBRow
tMaxDBRow
Proprits du tMaxDBRow
Famille de composant Databases/MaxDB0
Fonction
tMaxDBRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tMaxDBRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table name Query type Entrez le nom de la table. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.
Objectif
Basic settings
588
tMaxDBRow
Query
Die on error
Advanced settings
Commit every
Scnarios associs
589
tMSSqlBulkExec
tMSSqlBulkExec
Proprits du tMSSqlBulkExec
Les composants tMSSqlOutputBulk et tMSSqlBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tMSSqlOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le changement des donnes dans la base de donnes.
Famille de composant Databases/MSSql
Fonction Objectif
Effectue une action dInsert sur les donnes fournies. Le composant tMSSqlBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes MSSql. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tMSSqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes.
Basic settings
590
tMSSqlBulkExec
Database Schema Username et Password Table
Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Action on table
Remote File Name
Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Bcp query out Les informations demandes seront diffrentes en fonction de laction choisie. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Caractre, chane ou expression rgulire sparant les champs. Caractre, chane ou expression rgulire sparant les lignes.
Advanced settings
Action
Bulk insert & Bulk update
Fields terminated Rows terminated
591
tMSSqlBulkExec
First row Code page
Saisissez le numro du rang partir duquel vous voulez dmarrer laction. Cette valeur peut prendre plusieurs formes : OEM (valeur par dfaut) ACP RAW Personnalise par lutilisateur Slectionnez le type de donnes traiter. Slectionnez la sortie utiliser pour rcuprer la sortie standard de la base MSSql : to console : vers la console. to global variable : vers la variable globale.
Data file type Output
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Bcp query out Fields terminated Rows terminated Data file type Output Caractre, chane ou expression rgulire sparant les champs. Caractre, chane ou expression rgulire sparant les lignes. Slectionnez le type de donnes traiter. Slectionnez la sortie utiliser pour rcuprer la sortie standard de la base MSSql : to console : vers la console. to global variable : vers la variable globale.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec un composant tMSSqlOutputBulk. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes MSSql.
Scnarios associs
Pour un scnario associ au composant tMSSqlBulkExec, consultez les scnarios suivants : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec.
592
tMSSqlClose
tMSSqlClose
Proprits du tMSSqlClose
Le composant tMSSqlClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes MSSql. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tMSSqlConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tMSSqlConnection et tMSSqlRollback. Il est gnralement utilis avec un composant tMSSqlConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tMSSqlClose, consultez tMysqlConnection page 630
593
tMSSqlColumnList
tMSSqlColumnList
Proprits du tMSSqlColumnList
Famille de composant Databases/MS SQL
Fonction
Le composant tMSSqlColumList effectue une opration ditration dans toutes les colonnes dune table donne, grce une connexion MS SQL dfinie. Le tMSSqlColumList permet de faire une liste des libells des colonnes dune table MS SQL donne. Component list Slectionnez le composant tMSSqlConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Entrez le nom de la table.
Table name Utilisation Limitation
Il faut utiliser ce composant en association avec les autres composants MS SQL, notamment avec le tMSSqlConnection. n/a
Scnario associ
594
tMSSqlCommit
tMSSqlCommit
Proprits du tMSSqlCommit
Ce composant est troitement li aux composants tMSSqlConnection et tMSSqlRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tMSSqlCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tMSSqlConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tMSSqlCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants MSSql et notamment avec les composants tMSSqlConnection et tMSSqlRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tMSSqlConnection et tMSSqlRollback. Ils sont gnralement utiliss avec un composant tMSSqlConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tMSSqlCommit, consultez tMysqlConnection page 630.
595
tMSSqlConnection
tMSSqlConnection
Proprits du tMSSqlConnection
Ce composant est troitement li aux composants tMSSqlCommit et tMSSqlRollback. Ils sont gnralemet utiliss avec un composant tMSSqlConnection car il permet douvrir une connexion pour la transaction en cours.
Famille de composant Databases/MSSQL
Le composant tMSSqlConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Schema Database Username et Password Additional JDBC parameters Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom du schma. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.
Advanced settings
Auto commit
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant.
596
tMSSqlConnection
Ce composant est gnralement utilis avec des composants MSSql, notamment les composants tMSSqlCommit et tMSSqlRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tMSSqlCommit et tMSSqlRollback. Ils sont gnralement utiliss avec un composant tMSSqlConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tMSSqlConnection, consultez tMysqlConnection page 630.
597
tMSSqlInput
tMSSqlInput
Proprits du tMSSqlInput
Famille de composant Databases/MS SQL Server Le composant tMSSqlInput lit une base de donnes et en extrait des champs laide de requtes. Le tMSSqlInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Use an existing connection Cochez cette case lorsque vous utilisez le composant tMSSqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes.
Fonction Objectif
Basic settings
598
tMSSqlInput
Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Port Database Schema Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant (Repository). Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table name Query type et Query Nom de la table lire. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes MS Sql.
599
tMSSqlInput
Scnarios associs
Pour un scnario associ, consultez les scnarios des composants tDBInput et tMysqlInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie, page 637 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 du tContextLoad.
600
tMSSqlLastInsertId
tMSSqlLastInsertId
Proprits du tMSSqlLastInsertId
Famille de composant Databases/MS SQL server tMSSqlLastInsertId affiche les dernires ID ajoutes une table partir dune connexion MSSql spcifie. tMSSqlLastInsertId permet de rcuprer les cls primaires des entres dernirement ajoutes par un utilisateur une table MSSql. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Component list Advanced settings Utilisation Slectionnez le composant tMSSqlConnection dans la liste sil y a plus dune connexion dans votre Job.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL.
Scnario associ
Pour un scnario associ au composant tMSSqlLastInsertId, consultez Scnario : Rcuprer les ID des dernires entres ajoutes page 642.
601
tMSSqlOutput
tMSSqlOutput
Proprits du tMSSqlOutput
Famille de composant Databases/MS SQL server Le composant tMSSqlOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tMSSqlOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut-tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez cette case lorsque vous utilisez le composant tMSSqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Adresse IP du serveur de base de donnes.
602
tMSSqlOutput
Port Schema Database Username et Password Table Action on table
Numro du port dcoute du serveur de base de donnes. Nom du schma. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : Default : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if not exists : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback.
Turn on identity insert Cochez cette case pour utiliser votre propre squence sur les valeurs Identity des donnes insres (plutt que de laisser le serveur SQL choisir les valeurs squentielles).
603
tMSSqlOutput
Action on data
Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Single Insert Query : Ajouter de nouvelles entres la table, regroupes dans un lot. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre.. Insert if not exist : Ajouter de nouvelles entres la table si ncessaire. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete).
Specify identity field
Cochez cette case pour spcifier quel est le champ identity (Identity field), consitut dun numro didentification incrment automatiquement. Lorsque cette case est coche, trois autres champs saffichent : Identity field : slectionnez dans la liste la colonne que vous souhaitez dfinir comme champ identity. Start value : saisissez une valeur de dpart, utilise pour la premire ligne charge dans la table. Step : saisissez une valeur dincrment, ajoute la valeur de la ligne prcdemment charge. Vous pouvez galement spcifier le champ identity (Identity field) partir du schma du composant. Pour ce faire, paramtrez le type de base de donnes (DB Type) de la colonne correspondante en INT IDENTITY. Lorsque la case Specify identity field est coche, le type de base de donnes (DB Type) INT IDENTITY du schma est ignor.
604
tMSSqlOutput
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tMSSqlOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Advanced settings
Commit every
Additional Columns
605
tMSSqlOutput
Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus dcriture dans la base de donnes. Cochez cette case pour prendre en compte les valeurs Null dune table de base de donnes. Assurez-vous que la case Nullable est bien coche pour les colonnes du schma correspondantes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Use Batch Size Cochez cette case afin dactiver le mode batch pour le traitement des donnes. Dans le champ Batch Size qui apparat, vous pouvez saisir le nombre de lignes par lot charger. Cette case est disponible uniquement si vous avez choisi loption Insert, Update, Single Insert Query ou Delete dans le champ Action on data. Si vous utilisez la version 2008 du serveur MS Sql, assurez-vous que le nombre de lignes par lot charger soit infrieur ou gal 2000 marqueurs de paramtres, divis par le nombre de colonnes du schma.
Utilisation
Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes MSSql. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ au composant tMSSqlOutput, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du composant tMysqlOutput.
606
tMSSqlOutputBulk
tMSSqlOutputBulk
Proprits du tMSSqlOutputBulk
Les composants tMSSqlOutputBulk et tMSSqlBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tMSSqlOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards MSSql. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes MSSQL. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Advanced settings
607
tMSSqlOutputBulk
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec le composant tMSSQlBulkExec. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes MSSQL.
Scnarios associs
Pour un scnario associ au tMSSqlOutputBulk, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec.
608
tMSSqlOutputBulkExec
Proprits du tMSSqlOutputBulkExec
Les composants tMSSqlOutputBulk et tMSSqlBulkExec sont gnralement utiliss ensemble comme deux parties dun processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime tape, ce fichier est utilis lors de lopration dINSERT afin de populer une base de donnes. Cette excution en deux tapes est unifie dans le composant tMSSqlOutputBulkExec.
Fonction Objectif
Le tMSSqlOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tMSSqlOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes MSSQL. Action Property Type Permet de choisir entre les options Bulk Insert et Bulk update. Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tMSSqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Adresse IP du serveur de base de donnes.
Basic settings
609
Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dinsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Action on table
File Name
Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes.
Append Advanced settings Additional JDBC parameters
Field separator Row separator
610
First row Include header Data file type Encoding
Saisissez le numro du rang partir duquel vous voulez dmarrer laction. Cochez cette case pour inclure len-tte des colonnes dans le fichier. Slectionnez le type de donnes traiter. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
Scnarios associs
Pour un scnario associ au tMSSqlOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec.
611
tMSSqlRollback
tMSSqlRollback
Proprits du tMSSqlRollback
Ce composant est troitement li aux composants tMSSqlCommit et tMSSqlConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tMSSqlRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Close connection Slectionnez le composant tMSSqlConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce component est gnralement utilis avec dautres composants MSSql, notamment les composants tMSSqlConnection et tMSSqlCommit components. n/a
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674.
612
tMSSqlRow
tMSSqlRow
Proprits du tMSSqlRow
Fonction
tMSSqlRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tMSSqlRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tMSSqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma.
Objectif
Basic settings
613
tMSSqlRow
Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Table Name
Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit exister pour que lopration dInsert soit autorise.
Turn on identity insert Cochez cette case pour utiliser votre propre squence sur les valeurs Identity des donnes insres (plutt que de laisser le serveur SQL choisir les valeurs squentielles). Query type Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. Query Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column.
Die on error
Advanced settings
614
tMSSqlRow
Commit every
Scnarios associs
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 411 du composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678 du tMySQLRow.
615
tMSSqlSCD
tMSSqlSCD
Le composant tMSSqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tMSSqlSCD, page 162.
616
tMSSqlSP
tMSSqlSP
Proprits du tMSSqlSP
Le composant tMSSqlSP appelle une procdure stocke de base de donnes. Le tMSSqlSP permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier des proprits du composant. Les champs suivants sont alors pr-remplis. Use an existing connection Cochez cette case lorsque vous utilisez le composant tMSSqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification sur lutilisateur de base de donnes.
617
tMSSqlSP
Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est rutilisable. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Saisissez le nom exact de la Procdure Stocke (SP). Cochez cette case, si une seule valeur doit tre retourne. Slectionnez dans la liste la colonne du schma sur laquelle est base la valeur obtenir. Cliquez sur le bouton (+) et slectionnez dans le champ Schema Columns les diffrentes colonnes ncessaires la procdure. Notez que le schma de la SP peut contenir plus de colonnes quil ny a de paramtres utiliss dans la procdure. Slectionnez le Type de paramtre : IN : paramtre dentre (Input) OUT : paramtre de sortie (Output)/valeur retourne IN OUT : les paramtres dentre doivent tre retournes sous forme de valeur, mme aprs modifications via la procdure (fonction). RECORDSET : les paramtres dentre doivent tre retournes sous forme densemble de valeurs, au lieu dune valeur unique. Consultez le composant tParseRecordSet si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.
Parameters
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss. La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.
618
tMSSqlSP
Scnarios associs
Pour un scnario associ, consultez : le Scnario : Trouver le libell State laide dune procdure stocke, page 689 du composant tMysqlSP. le Scnario : Vrifier le format de numros laide dune procdure stocke, page 756 du tOracleSP. Consultez galement le composant tParseRecordSet, page 786 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.
619
tMSSqlTableList
tMSSqlTableList
Proprits du tMSSqlTableList
Famille de composant Databases/MS SQL
Le composant tMSSqlTableList effectue une opration ditration sur toutes les tables dune base de donnes, grce une connexion MS SQL dfinie. Le composant tMSSqlTableList permet de lister les noms des tables MS SQL grce aux commandes SELECT et WHERE. Component list Slectionnez le composant tMSSqlConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours..
Where clause for table Saisissez la commande WHERE permettant name selection didentifier les tables sur lesquelles effectuer lopration ditration. Advanced settings Utilisation Limitation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec les autres composants MS SQL, notamment avec le tMSSqlConnection. n/a
Scnario associ
620
tMysqlBulkExec
tMysqlBulkExec
Proprits du tMysqlBulkExec
Les composants tMysqlOutputBulk et tMysqlBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tMysqlOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le changement des donnes dans la base de donnes.
Famille de composant Databases/Mysql
Fonction Objectif
Le composant tMysqlBulkExec effectue une action dInsert sur les donnes fournies. Le tMysqlBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes MySQL. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version Use an existing connection Slectionnez la version de MySQL que vous utilisez. Cochez cette case lorsque vous utilisez le composant tMysqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Adresse IP du serveur de base de donnes.
Basic settings
621
tMysqlBulkExec
Port Database Username et Password Action on table
Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune action sur la table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Nom de la table crire.
Table
Une seule table peut tre crite la fois et cette table doit dj exister pour que lopration dInsert soit autorise.
Local File Name Chemin daccs et nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Caractre ou suite de caractres utiliss pour sparer les lignes. Caractre, chane ou expression rgulire sparant les champs. Caractres entourant les donnes. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert records in table : Insre de nouveaux enregistrements dans une table. Replace records in table : Remplace les enregistrements existants par de nouveaux. Update records in table : Modifie les enregistrements existants. Ignore records in table : Ignore les enregistrements existants ou insre les nouveaux.
Advanced settings
Additional JDBC parameters Lines terminated by Fields terminated by Enclosed by Action on data
622
tMysqlBulkExec
Records contain NULL value
Cochez cette case si vous souhaitez rcuprer les valeurs nulles du flux dentre. Si vous ne cochez pas cette case, les valeurs nulles en entre seront considres comme des champs vides dans le flux de sortie. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec un composant tMysqlOutputBulk. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes MySQL. n/a
Limitation
Scnarios associs
Pour plus dinformations relatives au fonctionnement de tMysqlBulkExec, consultez les scnarios suivants : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du composant tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du composant tOracleBulkExec.
623
tMysqlClose
tMysqlClose
Proprits du tMysqlClose
Famille de composant Databases/Mysql
Le composant tMysqlClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Mysql. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tMysqlConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tMysqlConnection et tMysqlRollback. Il est gnralement utilis avec un composant tMysqlConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tMysqlClose, consultez tMysqlConnection page 630
624
tMysqlColumnList
tMysqlColumnList
Proprits du tMysqlColumnList
Famille de composants Databases/MySQL
Fonction Purpose Basic settings
Le composant tMysqlColumList effectue une opration ditration dans toutes les colonnes dune table donne, grce une connexion MySQL dfinie. Le tMysqlColumList permet de faire une liste des libells des colonnes dune table MySQL donne. Component list Slectionnez le composant tMysqlConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Entrez le nom de la table.
Table name Usage Limitation
Il faut utiliser ce composant en association avec les autres composants MySQL, notamment avec le tMysqlConnection. n/a
Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table
Le scnario Java suivant permet de crer un Job cinq composants. Ce Job permet ditrer une table donne partir dune base de donnes MySQL en utilisant la commande Where et de lister tous les libells des colonnes de la table. Dans la palette, cliquez sur chacun des composants suivants et dposez-les dans lespace de modlisation : tMysqlConnection, tMysqlTableList, tMysqlColumnList, tFixedFlowInput et tLogRow. Reliez le tMysqlConnection au tMysqlTableList par le biais dun lien OnSubJobOk. Reliez les composants tMysqlTableList, tMysqlColumnList et tFixedFlowInput laide de liens Iterate. Reliez le tFixedFlowInput au tLogRow par le biais dun lien Row Main.
625
tMysqlColumnList
Dans lespace de modlisation, slectionnez le composant tMysqlConnection et cliquez sur la vue Component pour dfinir les paramtres de base. Dans longlet Basic settings, entrez manuellement les proprits de connexion la base de donnes ou slectionnez-les partir de la liste des variables de contexte : appuyez simultanment sur les touches Ctrl+Espace puis cliquez sur le champ correspondant si vous avez stock les informations en local sous le nud DB Connections du rpertoire Metadata. Pour plus dinformations sur les mtadonnes, veuillez consulter la section Centraliser les mtadonnes du Guide Utilisateur de Talend Open Studio.
Dans cet exemple, connectez-vous une base de donnes MySQL appele customers. Dans lespace de modlisation, slectionnez le composant tMysqlTableList et cliquez sur la vue Component pour dfinir ses paramtres de base.
626
tMysqlColumnList
Dans le champ Component list, slectionnez le composant de connexion MySQL adquat si vous utilisez plus dune connexion. Renseignez la clause Where en utilisant la bonne syntaxe dans le champ correspondant pour itrer les noms de la ou des tables que vous voulez lister dans la console. Dans ce scnario, itrez la table appele customer. Dans lespace de modlisation, slectionnez le composant tMysqlColumnList et cliquez sur la vue Component pour paramtrer ses proprits de base.
Dans le champ Component list, slectionnez le composant de connexion MySQL adquat si vous utilisez plus dune connexion. Dans le champ Table name, saisissez le nom de la table dont vous souhaitez lister les libells de colonnes. Dans ce scnario, lobjectif est de lister les libells des colonnes de la table customer. Dans lespace de modlisation, slectionnez le composant tFixedFlowInput et cliquez sur la vue Component pour paramtrer ses proprits de base. Dans le champ Schema, slectionnez loption Built-In et cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes que vous souhaitez utiliser en entre. Dans ce scnario, le schma est compos de deux colonnes : la premire TableName correspond au nom de la table MySQL et la deuxime ColumnName correspond aux libells des colonnes.
Cliquez sur OK pour fermer la bote de dialogue et une nouvelle bote de dialogue apparat vous demandant si vous souhaitez propager ces modifications, acceptez en cliquant sur Yes. Les colonnes dfinies apparaissent dans le champ Values de la vue Basic settings. Dans le champ Values, cliquez sur chacune des cellules de la colonne Value pour dfinir le contenu des colonnes de la table MySQL et appuyez sur Ctrl+Espace pour accder la liste des variables globales.
tMysqlColumnList
Dans la liste des variables globales, selectionnez : ((String)globalMap.get("tMysqlTableList_1_CURRENT_TABLE")) pour la colonne TableName et ((String)globalMap.get("tMysqlColumnList_1_COLUMN_NAME")) pour la colonne ColumnName.
Dans lespace de modlisation, slectionnez le composant tLogRow. Cliquez sur la vue Component et paramtrez les proprits de base du tLogRow en fonction de vos besoins. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Le nom de la table MySQL et le libell de ses colonnes sont affichs dans la console.
628
tMysqlCommit
tMysqlCommit
Proprits du tMysqlCommit
Ce composant est troitement li aux composants tMysqlConnection et tMysqlRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/MySQL
Fonction Objectif
Le composant tMysqlCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tMysqlConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tMysqlCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants MySQL et notamment avec les composants tMysqlConnection et tMysqlRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tMysqlConnection et tMysqlRollback. Ils sont gnralement utiliss avec un composant tMysqlConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tMysqlCommit, consultez tMysqlConnection page 630.
629
tMysqlConnection
tMysqlConnection
Proprits du tMysqlConnection
Ce composant est troitement li aux composants tMysqlCommit et tMysqlRollback. Ils sont gnralemet utiliss avec un composant tMysqlConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tMysqlConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Table Schema Username et Password Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.
Ce composant est gnralement utilis avec des composants MySQL, notamment les composants tMysqlCommit et tMysqlRollback. n/a
Scnario : Insrer des donnes dans des tables mre/fille

Le Job suivant est ddi des utilisateurs avancs de base de donnes qui souhaitent effectuer des insertions dans des tables multiples laide de lid dune table parent qui alimentera une table enfant.
630
tMysqlConnection
Avant de crer ce Job, suivez les tapes dcrites ci-dessous pour crer les tables ncessaires, laide dun gestionnaire de table tel que innodb. Dans un diteur de ligne de commande, connectez-vous votre serveur MySQL. Une fois connect la base de donnes correspondante, saisissez la commande suivante afin de crer la table parent : create table f1090_mum(id int not null auto_increment, name varchar(10), primary key(id)) engine=innodb; Puis crez la deuxime table : create table baby (id_baby int not null, years int) engine=innodb; Dans Talend Open Studio, le Job est constitu de sept composants, tMysqlConnection et tMysqlCommit inclus.
Cliquez et dposez les composants suivants de la Palette : tFileList, tFileInputDelimited, tMap, tMysqlOutput (x2). Connectez le composant tFileList au composant dentre tFileInputDelimited laide dune connexion de type Iterate. Ainsi, le nom du fichier traiter sera automatiquement renseign partir de la liste de fichiers du tFileList en utilisant une variable globale. Connectez le composant tFileInputDelimited au tMap et sparez le flux vers deux composants de sortie tMysqlOutput. Utilisez des connexions de type Row pour chacune de ces connexions reprsentant un flux de donnes principal. Dfinissez les proprits du composant tFileList, notamment le rpertoire dans lequel sont stocks les fichiers. Ajoutez le composant tMysqlConnection et connectez-le au composant de dpart de ce Job, (dans cet exemple, le composant tFileList) laide dune connexion OnComponentOk afin de dfinir lordre dexcution. Dans la vue Component du composant tMysqlConnection, dfinissez manuellement les informations de connexion ou rcuprez-les dans le Repository si vous les avez pralablement stockes dans le dossier DB connection du rpertoire Metadata. Pour plus dinformation concernant les Mtadonnes, consultez Centraliser les mtadonnes du Guide Utilisateur de Talend Open Studio.
631
tMysqlConnection
Dans longlet Basic settings du composant tFileInputDelimited, appuyez sur la touche Ctrl+Espace pour accder la liste des variables. Dfinissez le champ File Name avec la variable globale : tFileList_1.CURRENT_FILEPATH
Paramtrez les autres champs comme vous le souhaitez, dfinissez les sparateurs de lignes et de champs (Row et Field Separator) en fonction de la structure de votre document. Puis dfinissez manuellement le schma du fichier laide du bouton Edit schema ou slectionnez le schma dans le Repository. En version Java, assurez-vous que le type de donnes est correctement dfini, conformment la nature des donnes traites. Modifiez lencodage sil ne correspond pas celui de votre fichier. Dans la zone Output du tMap, ajoutez deux tables de sortie, une que vous nommerez mum pour la table parent et une deuxime que vous nommerez baby pour la table enfant. Cliquez sur la colonne Name de la zone Input et glissez-la dans la table mum. Cliquez sur la colonne Years de la zone Input et glissez-la dans la table baby.
Assurez-vous que la table mum est bien au dessus de la table baby car lordre des tables dtermine la squence des flux et ainsi linsertion de base de donnes est excute correctement. Puis slectionnez une connexion de sortie de type Row pour acheminer correctement le flux vers le composant Database de sortie correspondant. Dans longlet Basic settings des deux composants tMysqlOutput, cochez la case Use an existing connection pour rcuprer les informations du composant tMysqlConnection.
632
tMysqlConnection
En version Perl, le champ Commit every napparat plus puisque vous utilisez le composant tMysqlCommit au lieu de grer les commits de transaction globale. En version Java, ignorez ce champ puisque cette commande sera annule par le composant tMysqlCommit.
Nommez votre table dans le champ Table en vous assurant que vous saisissez la bonne table. Dans cet exemple, la table est soit f1090_mum, soit f1090_baby. Ne dfinissez aucune action dans le champ Action on table puisque les tables ont dj t cres. Slectionnez Insert dans le champ Action on data pour les deux composants de sortie (tMysqlOutput). Cliquez sur le bouton Sync columns pour rcuprer le schma dfini dans le tMap. Modifiez le type dencodage si ncessaire. Dans la zone Additional columns de longlet Advanced settings du composant tMysqlOutput correspondant la table enfant (f1090_baby), dfinissez la colonne id_baby de manire ce que lid de la table parent soit rutilis. Dans le champ SQL expression, saisissez : '(Select Last_Insert_id())' Dans la colonne Position, slectionnez loption Before et dans Reference column, loption years. Ajoutez le composant tMysqlCommit votre Job et connectez-le au composant tFileList laide dune connexion de type OnComponentOk afin que votre Job se termine avec un commit de transaction. Dans la vue Component du tMysqlCommit, slectionnez dans la liste la connexion utiliser. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
633
tMysqlConnection
Lid de la table parent a t rutilis pour alimenter la colonne id_baby.
634
tMysqlInput
tMysqlInput
Proprits du tMysqlInput
Fonction Objectif
Le composant tMysqlInput lit une base de donnes et en extrait des champs laide de requtes. Le tMysqlInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez cette case lorsque vous utilisez le composant tMysqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de Talend Open Studio. Host Adresse IP du serveur de base de donnes.
Basic settings
635
tMysqlInput
Port Database Username et Password Schema et Edit Schema
Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant (Repository). Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Table Name Query type et Query
Nom de la table lire. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Lorsque vous devez traiter des donnes au format date/heure 0000-00-00 00:00:00 utilisant ce composant, dfinissez les paramtres comme suit : noDatetimeStringSync=true&zeroDateTimeBehavior=convertToNull.
Advanced settings
Enable stream
Cochez cette case pour dterminer avec quelles lignes vous souhaitez travailler. Cette option permet damliorer les performances. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes MySQL.
636
tMysqlInput
Scnario : Ecrire des colonnes dynamiques dune base de donnes MySQL vers un fichier de sortie
La fonction de schma dynamique est uniquement disponible dans Talend Open Studio. Vous ne pourrez reproduire ce scnario que si vous utilisez une dition de Talend Open Studio.
Dans ce scnario, vous allez lire des colonnes dynamiques dune base de donnes MySQL, les mapper puis les crire dans une table, dans un fichier de sortie local. En dfinissant une colonne dynamique et les noms connus des colonnes, vous pouvez retrouver toutes les colonnes de la table de la base de donnes, y compris les colonnes inconnues. Dposez un composant tMysqlInput, un composant tMap et un composant tFileOutputDelimited dans lespace de modlisation graphique.
Reliez le tMysqlInput au tMap laide dun lien Row > Main. Reliez le tMap au tFileOutputDelimited laide dun lien Row > *New Output* (Main). Double-cliquez sur le tMysqlInput afin douvrir sa vue Basic Settings dans longlet Component.
La fonction de schma dynamique nest supporte quen mode Built-In.
637
tMysqlInput
Dans la liste Property Type, slectionnez Built-in. Dans la liste DB Version, slectionnez la version de la base de donnes que vous utilisez. Dans le champ Host, saisissez ladresse IP du serveur de la base de donnes. Dans le champ Port, saisissez le numro du port dcoute du serveur de la base de donnes. Dans les champs Username et Password, saisissez respectivement votre identifiant et votre mot de passe de connexion au serveur de la base de donnes. Dans la liste Schema type, slectionnez Built-in puis cliquez sur Edit schema afin de dfinir le schma dynamique. Lditeur du schma souvre :
Cliquez sur le bouton
pour ajouter une ligne au schma.
Dans les colonnes Column et Db Column, cliquez dans les champs afin de saisir le nom des colonnes correspondantes. Cliquez sur la liste Type pour dfinir le type des donnes. Cliquez sur la flche et slectionnez Dynamic dans la liste.
Dans la liste Type, le type de la colonne dynamique doit tre dfini comme Dynamic.
Cliquez sur OK pour fermer lditeur du schma. Dans le champ Table Name, cliquez sur le bouton [...] afin de slectionner la table souhaite de la base de donnes. Une bote de dialogue affiche une arborescence de toutes les tables de la base de donnes slectionne :
Cliquez sur la table souhaite, puis cliquez sur OK pour fermer la bote de dialogue. Dfinissez le type de requte, dans la liste Query Type, comme Built-In.
638
tMysqlInput
Dans le champ Query, saisissez la requte permettant de rcuprer toutes les colonnes de la table.
Dans linstruction SELECT, il est ncessaire dutiliser le caractre *, pour rcuprer toutes les colonnes de la table slectionne.
Cliquez sur le tMap afin douvrir sa vue Basic Settings dans longlet Component. Cliquez sur le bouton [...] ct du champ Map Editor pour mapper la colonne du fichier source.
Dposez la colonne dfinie comme dynamique du schma dentre, gauche, dans le schma de sortie, droite. La colonne dpose dans le schma de sortie contient ses valeurs dorigine.
La colonne dynamique doit tre mappe seule et ne peut subir de transformation. Elle ne peut tre utilise dans une expression de filtre ou dans des variables. Elle ne peut tre renomme dans la table de sortie et ne peut tre utilise comme condition de jointure.
639
tMysqlInput
Cliquez sur OK pour fermer lditeur Map Editor. Double-cliquez sur le composant tFileOutputDelimited afin de dfinir ses Basic Settings dans longlet Component.
A ct du champ File Name, cliquez sur le bouton [...] afin de parcourir votre rpertoire jusqu lendroit o vous souhaitez sauvegarder votre fichier de sortie, puis saisissez un nom pour le fichier. Cochez la case Include Header pour rcuprer le nom des colonnes ainsi que les donnes. Sauvegardez votre Job et appuyez sur F6 pour lexcuter. Le fichier de sortie contient le nom de toutes les colonnes et les donnes correspondantes, rcuprs de la base de donnes via le schma dynamique :
640
tMysqlInput
Le Job peut galement tre excut en mode Traces Debug, qui vous permet de voir les lignes telles quelles sont crites dans le fichier de sortie, dans lespace de modlisation graphique.
Pour plus dinformations concernant la dfinition et le mapping des schmas dynamiques, consultez la section Onglet Dynamic settings du Guide Utilisateur Talend Open Studio. Pour des scnarios associs, consultez : Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426. Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. Scnario 2 : Utiliser la variable StoreSQLQuery, page 403.
641
tMysqlLastInsertId
tMysqlLastInsertId
Proprits du tMysqlLastInsertId
tMysqlLastInsertId affiche les derniers ID ajouts une table partir dune connexion MySQL spcifie. tMysqlLastInsertId permet de rcuprer les cls primaires des entres dernirement ajoutes par un utilisateur une table MySQL. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Component list Slectionnez le composant tMysqlConnection dans la liste sil y a plus dune connexion dans votre Job.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est un composant intermdiaire. Si vous utilisez ce composant avec un tMysqlOutput, vrifiez que la case Extend Insert de l'onglet Advanced settings est bien dcoche. En effet, Extend Insert permet de faire un chargement par lot, ainsi seul l'ID de la dernire ligne du dernier lot sera retourn.
Limitation
n/a
Scnario : Rcuprer les ID des dernires entres ajoutes

Le scnario Java suivant permet douvrir une connexion une base de donnes MySQL, dy crire des donnes spcifies et enfin de rcuprer les derniers ID ajouts la connexion existante. Cliquez sur chacun des composants suivants et dposez-les dans lditeur graphique : tMySqlConnection, tMySqlCommit, tFileInputDelimited, tMySqlOutput, tMysqlLastInsertId, et tLogRow. Reliez le tMySqlConnection au tFileInputDelimited laide dun lien OnSubJobOk. Reliez le tFileInputDelimited au tMySqlCommit laide dun lien OnSubJobOk.
642
tMysqlLastInsertId
Reliez les trois derniers composants au tFileInputDelimited et entre eux laide de liens Row Main, comme suit :
Slectionnez le tMysqlConnection en cliquant dessus partir de lditeur graphique. Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Dans longlet Basic settings, entrez les paramtres de connexion manuellement ou slectionnez-les partir dune liste de variables de contexte, si vous les avez stockes localement sous le nud DB connections de la partie Metadata (Mtadonnes) du Repository. Vous accderez cette liste en cliquant dans le champ renseigner puis en appuyant sur Ctrl+Espace. Pour plus dinformation sur les Mtadonnes, consultez le chapitre Centraliser les mtadonnes du Guide Utilisateur de Talend Open Studio.
Slectionnez le tMysqlCommit en cliquant dessus partir de lditeur graphique, puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Dans le champ Component list, slectionnez le composant tMysqlConnection appropri si vous effectuez un Job plusieurs connexions. Slectionnez le tFileInputDelimited en cliquant dessus partir de lditeur graphique.
tMysqlLastInsertId
Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
Dans la liste Property Type, slectionnez loption Built-In. Renseignez le chemin daccs au fichier traiter dans le champ File Name. Dans cet exemple, le nom du fichier est Customers. Dans le champ Row separator, dfinissez le sparateur de lignes permettant didentifier les fins de ligne. De mme, pour Field separator, dfinissez le sparateur de champs permettant de dlimiter les diffrents champs pour chaque ligne. Dfinissez, si ncessaire, le nombre de lignes den-tte et de pied-de-page ignorer, ainsi que le nombre maximum de lignes que vous souhaitez traiter. Dans cet exemple, le fichier comporte une ligne den-tte. Dans la liste Schema, slectionnez loption Built-In, puis cliquez sur les trois points [...] ct de la mention Edit Schema pour dfinir les donnes passer au composant suivant. Sujets associs : consultez les chapitres Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Dans ce scnario, le schma se compose de deux colonnes, name et age. La premire colonne comprend le nom des employs et la seconde comporte leurs ges respectifs. Slectionnez le tMysqlOutput en cliquant dessus partir de lditeur graphique. Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
644
tMysqlLastInsertId
Cochez la case Use an existing connection. Dans le champ Table, renseignez le nom de la table dans laquelle vous voulez crire la liste des employs. Dans cet exemple, il sagit de la table employee. Slectionnez les actions effectuer dans les champs Action on table et Action on data, partir des listes proposes. Dans cet exemple, neffectuez aucune action sur la table elle-mme mais excutez une action Insert sur les donnes. Dans la liste Schema, slectionnez loption Built-In puis cliquez sur le bouton Sync columns pour synchroniser les colonnes par rapport au composant prcdent. Dans cet exemple, le schma reproduire dans la table de la base de donnes MySQL se compose des deux colonnes name et age.
Slectionnez le tMySqlLastInsertId en cliquant dessus partir de lditeur graphique. Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
645
tMysqlLastInsertId
Dans le champ Component list, slectionnez le composant tMysqlConnection appropri si vous effectuez un Job plusieurs connexions. Dans la liste Schema, slectionnez loption Built-In puis cliquez sur le bouton Sync columns pour synchroniser les colonnes par rapport au composant prcdent. Dans le schma de sortie du tMySqlLastInsertId, vous pouvez voir la colonne last_insert_id qui indique les dernires ID ajoutes la connexion existante.
Slectionnez le tLogRow en cliquant dessus partir de lditeur graphique, puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations, consultez le tLogRow, page 1399. Sauvegardez votre Job puis appuyez sur F6 pour lexcuter.
Le composant tMysqlLastInsertId affiche les dernires ID ajoutes pour chaque ligne de la connexion existante.
646
tMysqlOutput
tMysqlOutput
Proprits du tMysqlOutput
Le composant tMysqlOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tMysqlOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version Slectionnez la version de MySQL que vous utilisez. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
647
tMysqlOutput
Cochez cette case lorsque vous utilisez le composant tMysqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de Talend Open Studio.
Host Port Database
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.
Username et Password Informations dauthentification de lutilisateur de base de donnes Table Action on table Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : Default : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback.
648
tMysqlOutput
Action on data
Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Insert or update on duplicate key or unique index : Ajouter des entres si la valeur insre n'existe pas ou mettre jour les entres si la valeur insre existe dj et quun risque de violation dune cl unique se prsente. Insert ignore : Ajouter uniquement de nouvelles lignes afin dempcher les erreurs de doublons de cls. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete).
Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
649
tMysqlOutput
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Cochez cette case pour insrer un ensemble de lignes dfinies au lieu dinsrer les lignes une par une. Cette option permet un important gain de performance. Number of rows per insert : saisissez le nombre de lignes insrer en un bloc. Notez que si vous slectionnez un nombre important de lignes, cela peut augmenter la quantit de mmoire utilise et donc diminuer les performances. Cette option nest pas compatible avec le lien Reject. Vous devez donc la dcocher si vous utilisez un lien Reject en sortie du composant.
Advanced settings
Extend Insert
Use Batch size
Cochez cette case afin dactiver le mode batch pour le traitement des donnes. Dans le champ Batch Size qui apparat, vous pouvez saisir le nombre de lignes par lot charger. Cette case est disponible uniquement si vous avez choisi loption Insert, Update, Single Insert Query ou Delete dans le champ Action on data. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence.
Commit every
Additional Columns
650
tMysqlOutput
Reference column : Saisissez une colonne de rfrence que le composant tMysqlOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier. Use field options Use Hint Options Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour activer la zone de configuration des indicateurs (ou Hints) permettant doptimiser lexcution dune requte. Dans cette zone, les paramtres sont : - HINT : spcifiez lindicateur dont vous avez besoin, en utilisant la syntaxe /*+ */. - POSITION : spcifiez la place de lindicateur dans une instruction SQL. - SQL STMT : slectionnez linstruction SQL que vous souhaitez utiliser. Cochez cette case pour afficher chaque tape du processus dcriture dans la base de donnes. Met jour les valeurs des colonnes spcifies en cas de doublon de la cl primaire. Column : Saisissez entre guillemets le nom de la colonne mettre jour. Value : Saisissez lopration que vous souhaitez effectuer sur la colonne. Pour utiliser cette option, vous devez pralablement slectionner le mode Insert dans la liste Action on data de la vue Basic settings. tStatCatcher Statistics Utilisation Cochez cette case pour collecter les donnes de log au niveau du composant.
Enable debug mode Use duplicate key update mode insert
Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Ce composant doit tre utilis en tant que composant de sortie. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes MySQL. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation du tMysqlOutput, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659.
Scnario 1 : Ajouter une colonne et modifier les donnes

Ce scnario Java est un Job trois composants permettant de crer de manire alatoire des donnes de test laide du composant tRowGenerator, dupliquer la colonne modifier laide du composant tMap et de modifier les donnes insrer en utilisant une expression SQL dans le composant tMysqlOutput. Cliquez et dposez les composants suivants dans lditeur graphique : tRowGenerator, tMap et tMysqlOutput. Connectez-les laide de liens Row Main.
651
tMysqlOutput
Dans lditeur graphique, double-cliquez sur le tRowGenerator pour afficher longlet Basic settings.
Dans la liste Schema, slectionnez loption Built-In. Cliquez sur le bouton [...] ct du champ Edit schema pour dfinir les donnes transmettre au composant tMap, dans ce scnario, les deux colonnes name et random_date.
Cliquez sur OK pour fermer la bote de dialogue. Cliquez sur le bouton [...] ct du champ RowGenerator Editor pour ouvrir lditeur du tRowGenerator pour paramtrer les donnes gnrer.
652
tMysqlOutput
Cliquez dans le champ Functions correspondant et slectionnez une fonction pour chacune des deux colonnes, getFirstName pour la colonne name et getrandomDate pour la colonne random_date. Dans le champ Number of Rows for Rowgenerator, saisissez 10 pour ne gnrer que dix lignes de prnoms et cliquez sur Ok pour fermer lditeur. Double-cliquez sur le composant tMap pour ouvrir lditeur du tMap. Lditeur souvre et affiche les donnes dentre du composant tRowGenerator.
Dans le panneau Schema editor de lditeur du tMap, cliquez sur le bouton [+] de la table de sortie pour ajouter deux lignes et nommez la premire colonne random_date et la deuxime random_date1.
653
tMysqlOutput
Dans ce scnario, lobjectif est de dupliquer la colonne random_date et adapter le schma afin de modifier les donnes transfrer dans le composant de sortie. Dans lditeur du tMap, glissez la ligne random_date de la table dentre vers les lignes random_date et random_date1 de la table de sortie.
Cliquez sur OK pour fermer lditeur. Dans lditeur graphique, double-cliquez sur le composant tMysqlOutput pour afficher longlet Basic settings et paramtrer ses proprits.
654
tMysqlOutput
Dans la liste Property Type, slectionnez loption Repository et cliquez sur le bouton [...] pour ouvrir la bote de dialogue [Repository content] et slectionnez la connexion la base de donnes adquate. Les informations de connexion sont renseignes automatiquement.
Si vous navez pas stock de connexion votre base de donnes sous le nud DB connections sous le nud Metadata du Repository, slectionnez loption Built-in dans la liste Property Type et renseignez les informations de connexion manuellement.
Cliquez sur le bouton [...] ct du champ Table et slectionnez la table modifier : la table Dates dans ce scnario. Dans la liste Action on table, slectionnez loption Drop table if exists and create et slectionnez Insert dans la liste Action on data. Si ncessaire, cliquez sur Sync columns pour rcuprer le schma de colonnes du composant tMap. Cliquez sur longlet Advanced settings pour afficher la vue correspondante et dfinir les paramtres avancs du composant.
655
tMysqlOutput
Dans la zone Additional Columns, paramtrez les modifications appliquer aux colonnes. Dans ce scnario, la colonne One_month_later remplace la colonne random_date_1 et les donnes aussi sont modifies laide dune requte SQL ajoutant un mois la date gnre alatoirement dans la colonne random_date_1. Par exemple : 2007-08-12 devient 2007-09-12. -Saisissez One_Month_Later dans la cellule Name. -Dans la cellule SQL expression, saisissez la requte SQL ajoutant un mois, dans ce scnario : adddate(Random_date, interval 1 month). -Slectionnez Replace dans la liste Position. -Slectionnez Random_date1 dans la liste Reference column.
Pour ce Job, vous dupliquez la colonne random_date_1 dans la table avant de la remplacer par la colonne One_Month_Later. Le but de cette manipulation tait de voir les modifications apportes en amont.
Enregistrez le Job et appuyez sur F6 pour lexcuter. La nouvelle colonne One_month_later remplace la colonne random_date1 dans la base de donnes et ajoute un mois chaque date gnre alatoirement.
Voir galement : le Scnario : Afficher la base de donnes en sortie, page 407 du composant tDBOutput.
Scnario 2 : Effectuer des mises jour dans une base de donnes

Ce scnario Java est un Job deux composants permettant de mettre jour les donnes dune table MySQL partir dun fichier dlimit. A partir de la Palette, cliquez et dposez les composants tFileInputDelimited et tMysqlOutput dans lditeur graphique puis connectez-les laide dun lien Row Main.
Dans lditeur graphique, double-cliquez sur le tFileInputDelimited pour afficher longlet Basic settings.
656
tMysqlOutput
Dans le champ Property Type, slectionnez le mode Repository si vous avez stock les informations du fichier dlimit sous le nud Metadata du Repository ou slectionnez le mode Built-In pour les dfinir manuellement. Dans ce scnario, utilisez le mode Built-In.
Dans le champ File Name, renseignez manuellement le chemin daccs au fichier contenant les mises jour propager dans la base de donnes ou cliquez sur le bouton [...] pour parcourir vos dossiers jusqu ce fichier. Dans cet exemple, utilisez le fichier customer_update, qui comporte quatre colonnes, id, CustomerName, CustomerAddress et idState.
Dfinissez si ncessaire les sparateurs de lignes (Row separator) et de champs (Field separator), len-tte (Header) et le pied-de-page (Footer), ainsi que le nombre de lignes traiter (Limit). La premire ligne, qui porte le nom des colonnes, est ignore dans cet exemple, cest pourquoi le champ Header est dfini 1. Dans le champ Schema, slectionnez le mode Built in puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes passer au composant suivant. Dans cet exemple, le schma est constitu de quatre colonnes, id, CustomerName, CustomerAddress et idState.
657
tMysqlOutput
Devant le nom de chaque colonne se trouve une case Key. Cochez cette case pour la ou les colonne(s) que vous voulez dfinir comme cl.
Vous devez obligatoirement dfinir au moins une cl pour que le Job sexcute. Dans le cas contraire, le Job sarrte automatiquement et un message derreur saffiche dans la console de log.
Dans lditeur graphique, double-cliquez sur le composant tMysqlOutput pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] ct du champ Edit schema pour consulter le schma et vrifier quau moins une colonne a t dfinie comme cl. Dans le champ Property Type, slectionnez Repository si vous avez stock les informations de connexion la base de donnes sous le nud Metadata du Repository ou slectionnez le mode Built-In, puis renseignez manuellement les champs suivants : Host, Port, Database, Username et Password. Dans le champ Table, saisissez le nom de la table mettre jour. Dans le champ Action on table, slectionnez lopration que vous souhaitez effectuer sur la table. Pour ce scnario, slectionnez None car la table existe dj. Dans le champ Action on data, slectionnez lopration que vous souhaitez effectuer sur les donnes. Pour ce scnario, slectionnez loption Update pour mettre la table jour. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
658
tMysqlOutput
A partir de votre explorateur de base de donnes, vous pouvez vrifier que la table customers a bien t mise jour. Comme avant sa mise jour, elle se prsente sous la forme des quatre colonnes id, CustomerName, CustomerAddress et idState, mais certains champs ont t modifis selon les donnes du fichier dlimit customer_update.
Scnario 3 : Rcuprer les donnes errones laide dun lien Reject

Ce scnario dcrit un Job quatre composants effectuant une migration dun fichier client vers la table dune base de donnes MySQL et redirigeant les donnes errones vers un fichier CSV laide dun lien Reject.
Dans le Repository, slectionnez la mtadonne correspondant au fichier client que vous souhaitez migrer et glissez-la dans lespace de modlisation. Dans la bote de dialogue [Components], slectionnez tFileInputDelimited et cliquez sur OK. Les proprits du composant seront automatiquement renseignes.
tMysqlOutput
Si vous navez pas enregistr les informations concernant votre fichier client sous le nud Metadata du Repository. Glissez un composant tFileInputDelimited de la famille File > Input de la Palette et renseignez ses proprits manuellement dans la vue Component. A partir de la Palette, glissez un composant tMap de la famille Processing dans lespace de modlisation. Dans le Repository, dveloppez le nud Metadata et Db Connections, et slectionnez la mtadonne de connexion la base de donnes dans laquelle vous souhaitez migrer vos donnes et glissez-la dans lespace de modlisation. Dans la bote de dialogue [Components], slectionnez tMysqlOutput et cliquez sur OK. Les proprits de connexion la base de donnes seront automatiquement renseignes. Si vous navez pas enregistr les informations de connexion votre base de donnes sous le nud Db Connections du Repository. Glissez un composant tMysqlOutput de la famille Databases de la Palette et renseignez ses proprits manuellement dans la vue Component. Pour plus dinformations, consultez Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio. A partir de la Palette, slectionnez un composant tFileOutputDelimited de la famille File > Output et glissez-le dans lespace de modlisation. Reliez les composant customers et tMap, et les composants tMap et Localhost laide dun lien de type Row Main. Vous nommerez ce deuxime lien out. Reliez le composant Localhost au tFileOutputDelimited laide dun lien de type Row > Reject. Double-cliquez sur le composant customers pour afficher la vue Component correspondante.
Dans la liste Property Type, slectionnez le mode Repository puis cliquez sur le bouton [...] correspondant pour slectionner la mtadonne contenant la connexion votre fichier. Sinon, slectionnez le mode Built-in et paramtrez manuellement les champs suivants. Cliquez sur le bouton [...] ct du champ File Name, et indiquez le chemin daccs et le nom du fichier utiliser. Dans les champs Row et Field Separator, saisissez entre guillemets les sparateurs de lignes et de champs utiliss dans le fichier.
660
tMysqlOutput
Dans les champs Header, Footer et Limit, saisissez le nombre de ligne den-tte et de pied-de-page ignorer, ainsi que le nombre de ligne limite traiter. Dans la liste Schema, slectionnez Repository et cliquez sur le bouton [...] correspondant pour slectionner le schma de votre fichier, sil est stock sous le nud Metadata du Repository. Sinon cliquez sur le bouton [...] correspondant au champ Edit schema et dfinissez manuellement le schma de votre fichier. Le schma se prsente comme suit :
Double-cliquez sur le tMap afin douvrir son diteur.
661
tMysqlOutput
Slectionnez les colonnes id, CustomerName, CustomerAddress, idSate, id2, RegTime, RegisterTime de la zone de gauche et glissez-les dans la table out de la zone de droite.
Dans la zone Schema editor en bas de lditeur du tMap, dans le tableau droite, changez la longueur de la colonne CustomerName en 28 afin de crer une erreur. Ainsi, les donnes dont la longueur est suprieure 28 creront des erreurs qui pourront tre rcupres grce au lien Reject. Cliquez sur OK. Dans lespace de modlisation, double-cliquez sur le composant de sortie Localhost pour afficher la vue Component correspondante.
Dans la liste Property Type, slectionnez le mode Repository puis cliquez sur le bouton [...] correspondant pour slectionner la mtadonne de connexion la base de donnes. Les informations de connexion sont renseignes automatiquement. Sinon, slectionnez le mode Built-in et paramtrez ces champs manuellement.
662
tMysqlOutput
Dans le champ Table, saisissez le nom de la table crer. Dans ce scnario, vous lappelez customers_data. Dans la liste Action on data, slectionnez loption Create table. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Assurez-vous que la case Die on error est bien dcoche, afin que le Job sexcute malgr lerreur que vous venez de crer. Cliquez sur longlet Advanced settings de la vue Component pour paramtrer les paramtres avancs du composant.
Dcochez la case Extend Insert permettant dinsrer des lignes par bloc car cette option nest pas compatible avec le lien Reject. Double-cliquez sur le composant tFileOutputDelimited pour paramtrer ses proprits dans la vue Component.
Cliquez sur le bouton [...] ct du champ File Name pour indiquer le rpertoire de destination et le nom du fichier de sortie.
tMysqlOutput
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Les donnes en erreur sont envoyes dans le fichier dlimit, ainsi que le type derreur rencontre. Ici, vous avez affaire des donnes tronques : Data truncation.
664
tMysqlOutputBulk
tMysqlOutputBulk
Proprits du tMysqlOutputBulk
Les composants tMysqlOutputBulk et tMysqlBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tMysqlOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards MySQL. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes MySQL. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Cochez cette case pour inclure len-tte des colonnes dans le fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Field separator Row separator Append Include header Schema et Edit Schema
665
tMysqlOutputBulk
Encoding
Utilisation
Ce composant est gnralement utilis avec le composant tMysqlBulkExec. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes MySQL.
Scnario : Insrer des donnes transformes dans une base MySQL

Ce scnario dcrit un Job contenant quatre composants dont le but est dalimenter un base MySQL partir dun fichier paramtres contenant des donnes transformes. Deux tapes sont requises pour ce Job, dune part pour crer le fichier paramtres qui sera utilis dans un second temps. La premire tape inclut une phase de transformation des donnes contenues dans le fichier.
Glissez et dposez les composants suivants : tRowGenerator, tMap, tMysqlOutputBulk et tMysqlBulkExec dans lespace de modlisation. Connectez le flux principal laide de connexions Row > Main. Connectez le composant de dbut (tRowGenerator, dans cet exemple) au composant tMysqlBulkExec laide dune connexion trigger de type OnSubjobOk. Un composant tRowGenerator est utilis pour gnrer des donnes de faon alatoire. Double-cliquez sur le composant tRowGenerator pour lancer lditeur. Dfinissez le schma des lignes gnrer et la nature des donnes gnrer. Dans cet exemple, le fichier clients crer contient les colonnes suivantes : ID, First Name, Last Name, Address, City qui sont toutes de type chane de caractres (string) lexception de lID qui est de type entier (integer).
666
tMysqlOutputBulk
Certaines informations du schma nont pas ncessairement besoin dtre affiches. Pour les dissimuler, cliquez sur le bouton Columns dans la barre doutils et dcochez les colonnes cacher, par exemple : Precision ou Parameters. Utilisez le bouton [+] pour ajouter autant de colonnes que possible votre schma. Cliquez sur le bouton Refresh en haut droite de lditeur pour visualiser un aperu des lignes gnres en sortie dans longlet Preview en bas de lditeur. Cliquez sur OK pour valider. Dans lespace de modlisation, double-cliquez sur le composant tMap pour ouvrir son diteur et paramtrer la transformation. Faites glisser toutes les colonnes de la table dentre (row1) vers la table de sortie (clients).
Appliquez la transformation sur la colonne LastName en ajoutant .toUpperCase() la fin. Cela mettra les noms des clients en majuscule. Cliquez sur OK pour valider la transformation. Dans lespace de modlisation, double-cliquez sur le composant tMysqlOutputBulk pour afficher sa vue Component et paramtrer ses proprits.
667
tMysqlOutputBulk
Dfinissez le chemin daccs et le nom du fichier produire dans le champ File Name. Si les proprits du fichier dlimit sont conserves dans le Repository, slectionnez lentre correspondante dans le champ Property type afin de les rcuprer. Dans cet exemple, le nom de fichier est clients.txt. Le schma est propag partir du composant tMap, si vous cliquez sur Yes lorsque la bote de dialogue vous demande de confirmer la propagation. Sinon, cliquez sur le bouton Sync columns pour rcuprer le schma. Dans cet exemple, nincluez pas les informations den-tte, puisque la table doit dj les contenir. Lencodage est celui par dfaut dans ce scnario. Cliquez sur OK pour valider la sortie. Double-cliquez sur le composant tMysqlBulkExec pour paramtrer la requte INSERT excuter.
Dfinissez les informations de connexion la base de donnes. Nous vous recommandons de conserver ce type dinformations dans le Repository, afin de pouvoir les rcuprer tout moment et pour tous vos Jobs. Dans le champ Table, saisissez le nom de la table alimenter, ici, clients. Dans longlet Advanced settings, saisissez le sparateur de colonnes, dans le champ Fields terminated by. Vrifiez que lencodage dfini dans le champ Encoding correspond celui de vos donnes. Appuyez sur F6 pour excuter le Job.
668
tMysqlOutputBulk
La table de la base clients est alimente avec les donnes du fichier notamment les donnes transformes dans la colonne Last name. Pour une simple opration dInsert ne ncessitant pas de transformation, lutilisation du composant tMysqlOutputBulkExec permet dconomiser une tape dans le processus et ainsi de gagner en performance. Voir galement les Proprits du tMysqlOutputBulkExec, page 670.
669
tMysqlOutputBulkExec
Proprits du tMysqlOutputBulkExec
Les composants tMysqlOutputBulk et tMysqlBulkExec sont gnralement utiliss ensemble comme deux parties dun processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime tape, ce fichier est utilis lors de lopration dINSERT afin de populer une base de donnes. Cette excution en deux tapes est unifie dans le composant tMysqlOutputBulkExec.
Fonction Objectif
Le tMysqlOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tMysqlOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes MySQL. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version Host Port Database Username et Password Action on table Slectionnez la version de MySQL que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectue aucune action sur la table. Drop and create the table : supprime la table puis en crer une nouvelle. Create a table : cre une table qui nexiste pas encore. Create table if doesnt exist : cre la table si ncessaire. Clear a table : supprime le contenu de la table. Nom de la table crire.
Basic settings
Table
Une seule table peut tre crite la fois et cette table doit dj exister pour que lopration dInsert soit autorise.
670
Local File Name
Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Cochez cette option pour ajouter de nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Caractres entourant les donnes. Cette case est coche par dfaut. Cette option permet de crer le dossier contenant le fichier de sortie sil nexiste pas dj. Cochez cette case pour personnaliser la taille de la mmoire utilise pour stocker temporairement les donnes, et dans le champ Row number, saisissez le nombre de lignes aprs lesquelles la mmoire est nouveau libre. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert records in table : Insre de nouveaux enregistrements dans une table. Replace records in table : Remplace les enregistrements existants par de nouveaux. Update records in table : Modifie les enregistrements existants. Ignore records in table : Ignore les enregistrements existants ou insre les nouveaux. Cette case est coche par dfaut. Elle permet de prendre les champs de valeur NULL en compte. Si vous la dcochez, les valeurs NULL seront remplaces par des valeurs vides. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
Append Schema et Edit schema
Advanced settings
Row separator Field separator Text enclosure Create directory if not exists Custom the flush buffer size
Action on data
Records contain NULL value
Encoding
671
Ce composant est principalement utilis lorsquaucune transformation particulire nest requise sur les donnes charger dans la base de donnes. n/a
Scnario : Insrer des donnes dans une base MySQL

Ce scnario est un Job deux composants qui effectue le mme type dopration dalimentation que les composants tMysqlOutputBulk, page 665 et tMysqlBulkExec, page 621, mais sans transformation de donnes.
Cliquez et dposez les composants suivants : tRowGenerator et tMysqlOutputBulkExec. Connectez les composants via un lien de type Row > Main. Paramtrez le tRowGenerator de la mme manire que dans le Scnario : Insrer des donnes transformes dans une base MySQL, page 666. Le schma est constitu de plusieurs colonnes notamment : ID, First Name, Last Name, Address et City. A partir de lespace de modlisation, double-cliquez sur le composant tMysqlOutputBulkExec pour afficher la vue Component et paramtrer ses proprits.
Paramtrez la connexion la base de donnes si ncessaire, en suivant les recommandations du Scnario : Insrer des donnes transformes dans une base MySQL, page 666, concernant la conservation des informations de connexion dans la partie Metadata du Repository. Pour cela, slectionnez Repository dans le champ Property Type et slectionnez la connexion adquate dans le champ adjacent. Les champs suivants seront renseigns automatiquement. Pour plus dinformations, consultez les sections Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Dans le champ Action on table, slectionnez loption None puisque vous souhaitez insrer les donnes dans une table dj existante.
Dans le champ Table, saisissez le nom de la table alimenter, ici, clients. Dans le champ Local filename, indiquez le chemin daccs et le nom du fichier contenant les donnes charger dans la table, ici, clients.txt. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Cliquez sur longlet Advanced settings pour paramtrer les proprits avances du composant.
Dans la liste Action on data, slectionnez loption Insert records in table pour insrer ces nouvelles donnes dans la table. Appuyez sur F6 pour excuter le Job Le rsultat devrait tre relativement identique celui obtenu dans le Scnario : Insrer des donnes transformes dans une base MySQL, page 666. Cependant les donnes elles-mmes peuvent diffrer lgrement puisque les donnes sont regnres de faon alatoire chaque excution.
673
tMysqlRollback
tMysqlRollback
Proprits du tMysqlRollback
Ce composant est troitement li aux composants tMysqlCommit et tMysqlConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tMysqlRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Close connection Slectionnez le composant tMysqlConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce component est gnralement utilis avec dautres composants MySQL, notamment les composants tMysqlConnection et tMysqlCommit components. n/a
Limitation
Scnario : Annuler linsertion de donnes dans des tables mre/fille

En vous basant sur le Scnario : Insrer des donnes dans des tables mre/fille, page 630 du composant tMysqlConnection, insrez une opration de rollback (annulation) afin dviter un commit inutile.
Cliquez et dposez un composant tMysqlRollback et connectez-le au composant de dbut.
674
tMysqlRollback
Paramtrez lunique champ du Rollback avec la connexion la base de donnes adquate. Ce nouvel lment ajout au Job assure que la transaction ne sera pas commite partiellement.
675
tMysqlRow
tMysqlRow
Proprits du tMysqlRow
Fonction
tMysqlRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tMysqlRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version Use an existing connection Slectionnez la version de MySQL que vous utilisez. Cochez cette case lorsque vous utilisez le composant tMySQLConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.
Objectif
Basic settings
676
tMysqlRow
Guess Query
Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column.
Query
Die on error
Advanced settings
677
tMysqlRow
Commit every
Scnario 1 : Supprimer et re-gnrer un index de table MySQL

Le scnario suivant cre un Job quatre composants permettant de supprimer un index de table, effectuer un Insert dans cette table avant de re-gnrer lindex.
Slectionnez les composants suivants dans la Palette et dposez-le dans lespace de modlisation : tMysqlRow (x2), tRowGenerator, tMysqlOutput. Connectez le composant tMysqlIntput au tRowGenerator. Puis laide dune connexion OnComponentOk, connectez le premier composant tMysqlRow au tMysqlInput.
tMysqlRow
Connectez le composant tRowGenerator au second composant tMysqlRow laide dune connexion OnSubjobOk. Slectionnez le composant tMysqlRow et renseignez les proprits de la base de donnes dans longlet Basic settings. Dans les champs Property type et Schema, slectionnez la base de donnes approprie dans la liste. Les dtails de connexion la base de donnes ainsi que le schma de la table sont renseigns automatiquement. Propagez les informations de proprits et de schma aux autres composants du Job. La requte tant conserve dans les Metadata du Repository, vous pouvez galement slectionner Repository dans le champ Query type et cliquer sur la requte correspondante. Si vous ne conservez pas vos requtes dans le Repository, saisissez la dclaration SQL suivante : drop index <index_name> on <table_name> Puis slectionnez le deuxime composant tMysqlRow, vrifiez les proprits et le schma de base de donnes. Puis saisissez la dclaration SQL permettant de recrer un index laide de la formulation suivante : create index <index_name> on <table_name> (<column_name>); Le composant tRowGenerator permet de gnrer automatiquement les colonnes ajouter la table de sortie dfinie. Slectionnez le composant tMysqlOutput et renseignez les proprits de connexion la base de donnes soit partir du Repository ou manuellement si les informations de connexion ne sont utilises que pour ce Job. La table alimenter a pour nom : comprehensive. Le schma est automatiquement hrit du flux de donnes du tLogRow. Editez le schma et vrifiez que sa structure correspond au schma attendu par la table de base de donnes spcifie. Dans le champ Action on table, slectionnez None et dans le champ Action on data, slectionnez Insert. Aucune colonne supplmentaire nest requise pour ce Job. Appuyez sur F6 pour excuter ce Job. Si vous avez la possibilit dobserver laction sur la base de donnes, remarquez que lindex a t supprim en dbut de Job puis recr la fin de laction dInsert. Voir galement : les proprits du tDBSQLRow, page 410.
Scnario 2 : Utiliser linstance PreparedStatement pour faire une requte sur des donnes
Le scnario suivant dcrit un Job quatre composants permettant de mettre en correspondance la colonne dune table avec un fichier clients. En effet, la table MySQL contient la liste de tous les Etats amricains avec leur identifiant, et le fichier contient des informations sur vos clients avec lidentifiant de ltat dans lequel ils rsident. Lobjectif de ce scnario est de rcuprer le nom de lEtat pour chaque client laide dune requte SQL. Afin de traiter un grand nombre de donnes
tMysqlRow
plus rapidement, utilisez linstance PreparedStatement permettant de nexcuter quune seule fois la requte au lieu de leffectuer chaque ligne, puis chaque ligne de donnes est envoy en paramtre. Pour ce scnario, utilisez un fichier et une base de donnes dont vous avez pralablement stock la connexion et les proprits dans des mtadonnes dans le Repository. Pour plus dinformations concernant la cration de mtadonnes de fichiers dlimits, consultez la section Configurer un schma File Delimited, pour plus dinformations concernant la cration de mtadonnes de connexion une base de donnes, consultez la section Configurer une connexion DB, et pour plus dinformations sur lutilisation de ces mtadonnes, consultez la section Paramtrer un schma du Repository du Guide de Rfrence des composants Talend Open Studio.
A partir du Repository, dveloppez le nud Metadata et File delimited Slectionnez la mtadonne correspondant au fichier clients que vous souhaitez utiliser dans ce Job. Ici, vous utilisez la mtadonne customers. Glissez cette mtadonne dans lespace de modlisation et double-cliquez sur tFileInputDelimited dans la bote de dialogue Components afin de crer un composant tFileInputDelimited dj paramtr.
Dans la liste Schema, slectionnez Built-in afin de modifier le schma de votre composant. Puis, cliquez sur le bouton [...] ct du champ Edit schema pour ajouter la colonne dans laquelle insrer le nom de lEtat.
680
tMysqlRow
Cliquez sur le bouton [+] pour ajouter une colonne au schma. Renommez cette colonne LabelStateRecordSet, et elle est de type objet, donc slectionnez Object dans la liste Type. Cliquez sur OK pour enregistrer vos modifications. A partir de la Palette, slectionnez les composants tMysqlRow, tParseRecordSet et tFileOutputDelimited et glissez-les dans lespace de modlisation. Reliez les quatre composants via des liens de type Row > Main. Double-cliquez sur le composant tMysqlRow pour paramtrer ses proprits dans longlet Basic settings de la vue Component.
681
tMysqlRow
Dans la liste Property Type, slectionnez Repository et cliquez sur le bouton [...] pour slectionner la connexion la base de donnes centralise dans les mtadonnes du Repository. Les champs DB Version, Host, Port, Database, Username et Password sont renseigns automatiquement. Si vous tes en mode Built-in, renseignez ces champs manuellement. Dans la liste Schema, slectionnez Built-in pour paramtrer le schma manuellement et ajouter la colonne LabelStateRecordSet, ou cliquez directement sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Dans le champ Query, saisissez la requte SQL utiliser. Ici, vous souhaitez rcuprer les noms des Etats amricains contenus dans la colonne LabelState de la table MySQL us_state : "SELECT LabelState FROM us_state WHERE idState=?". Le point dinterrogation ? reprsente le paramtre dfinir dans longlet Advanced settings. Cliquez sur longlet Advanced settings pour paramtrer les proprits avances du composant.
682
tMysqlRow
Cochez la case Propagate QUERYs recordset et slectionnez la colonne LabelStateRecordSet dans la liste use column pour insrer le rsultat de la requte dans cette colonne. Cochez la case Use PreparedStatement et dfinissez le paramtre utilis dans la requte dans le tableau Set PreparedStatement Parameters. Cliquez sur le bouton [+] pour ajouter un paramtre. Dans la cellule Parameter Index, saisissez la position du paramtre dans linstruction SQL. Saisissez 1 tant donn que vous nutilisez quun seul paramtre dans lexemple. Dans la cellule Parameter Type, saisissez le type du paramtre. Ici, le paramtre est de type entier, donc slectionnez Int dans la liste. Dans la cellule Parameter Value, saisissez la valeur du paramtre. Ici, vous souhaitez rcuprer le nom de lEtat en fonction de leur ID pour chaque client du fichier dentre, saisissez donc row1.idState. Double-cliquez sur le composant tParseRecordSet pour paramtrer ses proprits dans longlet Basic settings de la vue Component.
683
tMysqlRow
Dans la liste Prev. Comp. Column list, slectionnez la colonne du composant prcdent analyser. Dans cet exemple, slectionnez la colonne LabelStateRecordSet. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent et le tableau Attribute table est automatiquement renseign avec les colonnes du schma. Dans le tableau Attribute table, dans le champ Value correspondant la colonne LabelStateRecordSet, saisissez entre guillemets le nom de la colonne contenant le nom des Etats rcuprer et mettre en correspondance avec chaque client. Dans cet exemple, saisissez LabelState. Double-cliquez sur le composant tFileOutputDelimited pour paramtrer ses proprits dans longlet Basic settings de la vue Component.
Dans le champ File Name, renseignez le chemin daccs et le nom du fichier de sortie. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
684
tMysqlRow
Une colonne contenant le nom de lEtat amricain correspondant chaque client a t ajoute au fichier.
685
tMysqlSCD
tMysqlSCD
Le composant tMysqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tMysqlSCD page 164.
686
tMysqlSCDELT
tMysqlSCDELT
Le composant tMysqlSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tMysqlSCDELT, page 177.
687
tMysqlSP
tMysqlSP
Proprits du tMysqlSP
Familles de composant Databases/Mysql
Le composant tMysqlSP appelle une procdure stocke de base de donnes. Le tMysqlSP permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier des proprits du composant. Les champs suivants sont alors pr-remplis. Use an existing connection Host Port Database Username et Password Schema et Edit Schema Cochez cette case lorsque vous utilisez le composant tMysqlConnection. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification sur lutilisateur de base de donnes. Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est rutilisable. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. SP Name Is Function / Return result in Saisissez le nom exact de la Procdure Stocke (SP). Cochez cette case, si une seule valeur doit tre retourne. Slectionnez dans la liste la colonne du schma sur laquelle est base la valeur obtenir.
688
tMysqlSP
Parameters
Cliquez sur le bouton (+) et slectionnez dans le champ Schema Columns les diffrentes colonnes ncessaires la procdure. Notez que le schma de la SP peut contenir plus de colonnes quil ny a de paramtres utiliss dans la procdure. Slectionnez le Type de paramtre : IN : paramtre dentre (Input) OUT : paramtre de sortie (Output)/valeur retourne IN OUT : les paramtres dentre doivent tre retournes sous forme de valeur, mme aprs modifications via la procdure (fonction). RECORDSET : les paramtres dentre doivent tre retournes sous forme densemble de valeurs, au lieu dune valeur unique. Consultez le composant tParseRecordSet si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.
Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss. La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.
Scnario : Trouver le libell State laide dune procdure stocke

Le Job suivant a pour but de trouver les libells State en fonction des ID impairs de la colonne State dune table MySQL deux colonnes laide dune procdure stocke.
Cliquez et dposez les composants suivants dans lespace de modlisation : tRowGenerator, tMysqlSP et tLogRow. Connectez les composants laide dune connexion de type Row Main. Le tRowGenerator est utilis pour gnrer des ID impairs. Double-cliquez sur le composant pour lancer lditeur.
Cliquez sur le bouton [+] pour ajouter une colonne au schma gnrer.
689
tMysqlSP
Cochez la case Key pour dfinir lentre comme tant une cl primaire et dfinissez le Type en Int (entier). Dans le champ Length, la longueur est de 2 chiffres au maximum. Utilisez la fonction prtablie appele sequence mais modifiez les paramtres dans la partie infrieure de la fentre.
Modifiez la valeur (Value) de step : de 1 2 pour cet exemple. Mais la valeur de dpart (start value) reste 1. Dans le champ Number of generated rows, dfinissez le nombre de lignes gnrer 25, afin que tous les ID impairs de State (il y a 50 Etats) soient gnrs. Cliquez sur OK pour valider la configuration. Puis slectionnez le composant tMysqlSP et paramtrez ses proprits.
690
tMysqlSP
Dans le champ Property type, slectionnez loption Repository puis slectionnez lentre correspondante dans la liste. Les informations de connexion sont remplies automatiquement. Sinon, paramtrez les informations de connexion manuellement. Cliquez sur Sync Column pour rcuprer le schma gnr du composant prcdent. Puis cliquez sur Edit Schema et ajoutez une colonne supplmentaire contenant les libells des Etats (State) obtenir en sortie, en plus de lID. Slectionnez le type dencodage dans la liste. Dans le champ SP Name, saisissez le nom de la procdure comme il a t dfini dans la base de donnes (ici, getstate). La procdure excuter correspond : DROP PROCEDURE IF EXISTS `talend`.`getstate` $$ CREATE DEFINER=`root`@`localhost` PROCEDURE `getstate`(IN pid INT, OUT pstate VARCHAR(50)) BEGIN SELECT LabelState INTO pstate FROM us_states WHERE idState = pid; END $$ Dans la zone Parameters, cliquez sur le bouton (+) pour ajouter une ligne la table. Dfinissez le champ Column en ID, et le champ Type en IN, ainsi il sera considr comme paramtre dentre dans la procdure. Ajoutez une deuxime ligne et dfinissez le champ Column en State et le champ Type en Out, ainsi il sera considr comme le paramtre de sortie a retourne. Et enfin, paramtrez les proprits du composant tLogRow.
Synchronisez le schma avec celui du composant prcdent en cliquant sur le bouton Sync columns. Et cochez la case Print values in cells of a table pour un meilleur confort de lecture. Puis enregistrez votre Job et excutez-le.
La sortie affiche les diffrents Etats (State) avec leur ID impair comme dfini dans la procdure.
tMysqlSP
Consultez galement le composant tParseRecordSet, page 786 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.
692
tMysqlTableList
tMysqlTableList
Proprits du tMysqlTableList
Le composant tMysqlTableList effectue une opration ditration sur toutes les tables dune base de donnes, grce une connexion MySQL dfinie. Le composant tMysqlTableList permet de lister les noms des tables MySQL grce aux commandes SELECT et WHERE. Component list Slectionnez le composant tMysqlConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours.
Where clause for table Saisissez la commande WHERE permettant name selection didentifier les tables sur lesquelles effectuer lopration ditration. Utilisation Limitation Il faut utiliser ce composant en association avec les autres composants MySQL, notamment avec le tMysqlConnection. n/a
Scnario : Effectuer une opration ditration sur des tables et en effacer le contenu grce un modle SQL dfini par lutilisateur (SQL Template)
Le scnario Java suivant dcrit un Job trois composants qui permet deffectuer une opration ditration, dans les tables spcifies dune base de donnes MySQL, en utilisant une clause de type WHERE. Le Job permet ensuite deffacer le contenu de ces tables directement sur le SGBD grce un modle SQL (SQL Template) dfini par lutilisateur. Pour une utilisation avance, commencez par crer une connexion la base de donnes qui contient les tables que vous voulez vider de leur contenu. Dans la vue en arborescence du Repository, dveloppez le nud Metadata puis cliquez droit sur DB Connections pour crer une connexion la base de donnes de travail et stocker les informations de connexion en local. Pour plus dinformations sur les mtadonnes (metadata), consultez le chapitre Centraliser les mtadonnes du Guide Utilisateur de Talend Open Studio. Sinon, dposez un composant tMySQLConnection dans lditeur graphique et renseignez les paramtres de connexion manuellement. A partir du Repository, dposez dans lditeur graphique la connexion que vous venez de crer. La bote de dialogue [Components] saffiche lcran.
693
tMysqlTableList
Slectionnez le composant tMySQLConnection puis cliquez sur OK. Le composant tMySQLConnection apparait alors dans lditeur graphique et les paramtres de connexion, accessibles depuis la vue Basic settings, sont automatiquement renseigns. A partir de la Palette, cliquez-dposez les composants tMysqlTableList et tELT dans lditeur graphique. Reliez les composants tMysqlConnection et tMysqlTableList laide dun lien Trigger de type OnSubJobOk.
Reliez les composants tMysqlTableList et tELT laide dun lien de type Iterate. Double-cliquez sur le tMysqlConnection pour afficher la vue Basic settings du composant si vous voulez en vrifier les paramtres de connexion.
Dans cet exemple, connectez-vous une base de donnes MySQL appele examples. Dans lditeur graphique, double-cliquez sur le composant tMysqlTableList pour en afficher les paramtres de bases et les dfinir (vue Basic settings).
Slectionnez la connexion MySQL approprie partir de la liste droulante Component list, dans le cas o vous utilisez plus dune connexion.
694
tMysqlTableList
Renseignez la clause de type WHERE dans le champ appropri, en veillant utiliser la bonne syntaxe, pour effectuer une itration sur la ou les tables dont vous voulez effacer le contenu. Dans ce scnario, oprez litration sur toutes les tables dont le nom commence par ex. Dans lditeur graphique, double-cliquez sur le composant tELT pour en afficher les paramtres de base et les dfinir (vue Basic settings).
Dans le champ Database Name, renseignez le nom de la base de donnes o se trouvent les tables sur lesquelles vous voulez travailler. Slectionnez la connexion MySQL approprie partir de la liste droulante Component list, dans le cas o vous utilisez plus dune connexion. Cliquez dans le champ Table name et appuyez sur Ctrl+Espace pour atteindre la liste gnrale des variables. A partir de cette liste de variables, slectionnez ((String)globalMap.get("tMysqlTableList_1_CURRENT_TABLE")). Comment crer votre propre modle SQL (SQL Template) : Dans la vue en arborescence du Repository, dveloppez successivement les nuds SQL Templates et MySQL.
Cliquez-droit sur le nud UserDefined et slectionnez loption Create SQLTemplate partir de la liste. Lassistant New SQLTemplate saffiche lcran.
695
tMysqlTableList
Saisissez un nom pour le nouveau modle (SQL template) et remplissez les autres champs si ncessaire, puis cliquez sur Finish pour fermer lassistant. Lditeur de modle SQL saffiche dans lditeur graphique. Supprimez le code existant et saisissez le code permettant dexcuter laction voulue, cest--dire, ici, effacer le contenu de toutes les tables dont les noms commencent par ex.
Dans un code SQL template, il est impratif dutiliser le nom exact de la variable, en association avec le paramtre dsignant le nom de la table (__TABLE-NAME__ dans cet exemple). Pour afficher le nom de la variable utilise, positionnez votre curseur sur le champ Table Name de la vue Basic Settings du composant tELT.
Appuyez sur Ctrl+S pour sauvegarder le nouveau modle que vous venez de dfinir. La prochaine tape consiste ajouter ce nouveau modle SQL template la liste de modles du mme type dans le composant tELT.
696
tMysqlTableList
Comment ajouter votre propre modle SQL la liste de modles du mme type : Dans la vue Component du composant tELT, cliquez sur longlet SQL Templates pour afficher la liste de modles SQLTemplate List.
Cliquez sur le bouton Add et ajoutez deux lignes de modles SQL template. Cliquez sur la premire ligne pour afficher un menu droulante puis cliquez sur la flche de ce menu pour drouler la liste des modles.
Dans la liste, slectionnez le modle SQL template que vous venez de crer. Assurez-vous que le modle de la seconde ligne est bien en mode Commit. Enregistrez le Job et appuyez sur F6 pour lexcuter. Toutes les tables de la base de donnes MySQL examples dont le nom commence par ex sont alors vides de leur contenu.
Scnario associ
697
tNetezzaBulkExec
tNetezzaBulkExec
Proprits du tNetezzaBulkExec
Famille de composant Databases/Netezza
Fonction Objectif
Le composant tNetezzaBulkExec effectue une action dInsert sur les donnes fournies. Le tNetezzaBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Netezza. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tNetezzaConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes.
Basic settings
698
tNetezzaBulkExec
Table
Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit exister pour que lopration dInsert soit autorise. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant (Repository). Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
File Name
Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Caractre, chane ou expression rgulire sparant les champs. Cochez cette case pour utiliser des caractres pour entourer les donnes. Chane (ex : \n sous Unix) sparant les lignes. Caractre dchappement de la ligne. Date format : Utilisez ce champ pour reprsenter lordre des mois, des jours et des annes sous forme de chane de caractres. Date delimiter : Utilisez ce champ pour dfinir llment sparateur entre les valeurs. Time format : Utilisez ce champ pour reprsenter le format de lheure sous forme de chane de caractres. Time delimiter : Utilisez ce champ pour dfinir llment sparateur entre les valeurs. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Saisissez le nombre maximal derreurs possibles avant que le processus ne sarrte. Renseignez le nombre de lignes ignorer.
Advanced settings
Field Separator Require quotes () around data files Row Separator Escape character Date format / Date delimiter
Time format/ Time delimiter
Encoding
Max Errors Skip Rows
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est principalement utilis lorsque des transformations non particulires sont requises sur les donnes charger dans la base de donnes Netezza. n/a
Limitation
699
tNetezzaBulkExec
Scnarios associs
Pour des scnarios associs au composant tNetezzaBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
700
tNetezzaClose
tNetezzaClose
Proprits du tNetezzaClose
Le composant tNetezzaClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Netezza. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tNetezzaConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tNetezzaConnection et tNetezzaRollback. Il est gnralement utilis avec un composant tNetezzaConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tNetezzaClose, consultez tMysqlConnection page 630
701
tNetezzaCommit
tNetezzaCommit
Proprits du tNetezzaCommit
Ce composant est troitement li aux composants tNetezzaConnection et tNetezzaRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tNetezzaCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tNetezzaConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tNetezzaCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Netezza et notamment avec les composants tNetezzaConnection et tNetezzaRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tNetezzaConnection et tNetezzaRollback. Ils sont gnralement utiliss avec un composant tNetezzaConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tNetezzaCommit, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
702
tNetezzaConnection
tNetezzaConnection
Proprits du tNetezzaConnection
Ce composant est troitement li aux composants tNetezzaCommit et tNetezzaRollback. Ils sont gnralemet utiliss avec un composant tNetezzaConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tNetezzaConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Table Schema Username et Password Additional JDBC Parameters Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.
Ce composant est gnralement utilis avec des composants Netezza, notamment les composants tNetezzaCommit et tNetezzaRollback. n/a
703
tNetezzaConnection
Scnario associ
Pour un scnario associ au composant tNetezzaConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
704
tNetezzaInput
tNetezzaInput
Proprits du tNetezzaInput
Fonction Objectif
Le composant tNetezzaInput lit une base de donnes et en extrait des champs laide de requtes. Le tNetezzaInput excute une requte de base de donnes dans laquelle lordre doit strictement correspondre lordre dfini dans le schma. Puis la liste des champs est transmise au composant via une connexion Main row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionne le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
Basic settings
705
tNetezzaInput
Cochez cette case lorsque vous utilisez un composant tOracleConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Host Port Database Username et Password Schema et Edit Schema
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Table name Query type et Query
Nom de la table de base de donnes. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en une fois. Cette option permet doptimiser les performances.
Advanced settings
Use cursor
706
tNetezzaInput
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Netezza.
Scnarios associs
Consultez les scnarios du composant tNetezzaInput : le Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. le Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Pour un scnario associ, consultez le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 du composant tContextLoad.
707
tNetezzaNzLoad
tNetezzaNzLoad
Ce composant invoque lutilitaire nzload de Netezza afin dinsrer des enregistrements dans une base de donnes Netezza. Ce composant peut tre utilis soit en mode standalone, il chargera alors les donnes partir dun fichier de donnes existant, soit connect un flux dentre, afin de charger des donnes partir du composant connect.
Proprits du tNetezzaNzLoad
Fonction Objectif
Le composant tNetezzaNzLoad insre des donnes dans la table dune base de donnes Netezza via lutilitaire nzload de Netezza. Ce composant permet de charger en masse des donnes dans une table Netezza soit partir dun fichier, soit partir dun flux dentre, soit partir dun tube nomm. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Username et Password Table Action on table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table dans laquelle les donnes doivent tre insres. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository.
Basic settings
708
tNetezzaNzLoad
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Data file Chemin daccs complet au fichier de donnes utiliser. Si ce composant est utilis seul (non connect un autre composant par un flux dentre), alors saisissez le nom dun fichier existant charger dans la base de donnes. Sil est connect un autre composant par un flux dentre, saisissez le nom du fichier gnrer et crire avec les donnes dentre, afin de lutiliser plus tard avec nzload pour charger dans la base de donnes. Cochez cette case afin dutiliser un tube nomm la place dun fichier de donnes. Cette option ne peut tre utilise que lorsque le composant est connect un autre composant par un flux dentre. Quand la case est coche, aucun fichier de donnes nest gnr, et les donnes sont transfres lutilitaire nzload via un tube nomm. Cette option amliore grandement les performances sous Linux et Windows. Ce composant, en mode tube nomm, utilise une interface JNI pour crer un tube nomm et crire dedans, dans toute plateforme Windows. Le chemin daccs associ au fichier DLL JNI doit tre configur dans le chemin daccs la bibliothque Java. Le composant est automatiquement fourni dans le Studio avec deux DLL pour les systmes dexploitation de 32 et 64 bits. Spcifiez un nom pour le tube nomm utiliser. Vrifiez que le nom saisi est valide. Cochez cette case pour fournir un fichier de contrle utiliser avec lutilitaire nzload au lieu de spcifier explicitement toutes les options dans le composant. Lorsque cette case est coche, loption Data file ainsi que les autres options lies au nzload ne sappliquent plus. Veuillez vous rfrer au manuel du nzload de Netezza pour plus dinformations concernant la cration dun fichier de contrle. Saisissez le chemin daccs au fichier de contrle utiliser, entre guillemets doubles, ou cliquez sur le bouton [...] afin de parcourir votre rpertoire jusquau fichier de contrle. Cette option est pass lutilitaire nzload via largument -cf.
Use named-pipe
Named-pipe name Advanced settings Use existing control file
Control file
709
tNetezzaNzLoad
Field separator
Caractre, chane de caractres ou expression rgulire utilis pour sparer les champs. Argument delim de lutilitaire nzload. Si vous nutilisez pas loption Wrap quotes around fields, vous devez tre sr que le dlimiteur nest pas inclus dans les donnes insres dans la base de donnes. La valeur par dfaut est\t ouTAB.. Pour amliorer les performances, utilisez la valeur par dfaut.
Wrap quotes around fields
Cette option ne sapplique quaux colonnes de type String, Byte, Byte[], Char, et Object. Slectionnez soit : None : nentourez pas les valeurs des colonnes de guillemets. Single quote : entourez les valeurs des colonnes de guillemets simples. Double quote : entourez les valeurs des colonnes de guillemets doubles. Si vous utilisez loption Single quote ou Double quote, il est ncessaire dutiliser \ en tant que Escape char.
Advanced options
Dfinissez les arguments nzload dans le tableau correspondant. Cliquez sur le bouton [+] autant de fois que ncessaire afin dajouter les arguments au tableau. Cliquez sur le champ Parameter et choisissez largument souhait dans la liste, puis cliquez sur le champ Value correspondant et saisissez une valeur entre guillemets. Nom du fichier de log gnrer. Les logs seront ajouts la suite du fichier de log, sil existe dj. Si le paramtre nest pas spcifi, le nom par dfaut du fichier de log est '<table_name>.<db_name>.nzlog'. Il est gnr dans le rpertoire de travail courant dans lequel le Job est excut. Nom du fichier de mauvais enregistrements gnrer. Le fichier de mauvais enregsitrements contient tous les enregistrements ne pouvant tre chargs, cause dune erreur interne Netezza. Les enregistrements seront ajouts la suite si le fichier de mauvais enregistrements existe dj. Si le paramtre nest pas spcifi, le nom par dfaut du fichier de mauvais enregistrements est '<table_name>.<db_name>.nzbad'. Il est gnr dans le rpertoire de travail courant, dans lequel le Job est excut. Chemin daccs au rpertoire dans lequel les fichiers de log et de mauvais enregistrements sont gnrs. Si le paramtre nest pas spcifi, les fichiers seront gnrs sous le rpertoire courant dans lequel le Job est excut.
Parameter
-If
-bf
-ouputDir
710
tNetezzaNzLoad
-logFileSize
Taille maximale du fichier de log. La valeur est en MB. La valeur par dfaut est de 2000 ou 2GB. Pour conomiser de lespace disque, spcifiez un petite valeur si votre Job est souvent excut. Slectionnez cette option si le fichier de donnes est compresse. Les valeurs valides sont "TRUE" et "FALSE". La valeur par dfaut est "FALSE". Cette option nest valide que si ce composant est utilis par lui-mme et non connect un autre composant via un flux dentre.
-compress
-skipRows <n>
Nombre de lignes ignorer au dbut du fichier de donnes. Paramtrez la valeur "1" si vous souhaitez ignorer la ligne den-tte du fichier dentre. La valeur par dfaut est "0". Cette option ne doit tre slectionne que si le composant est utilis par lui-mme et non connect un autre composant via un flux dentre.
-maxRows <n>
Nombre de lignes charger partir du fichier dentre. Cette option ne doit tre slectionne que si le composant est utilis par lui-mme et non connect un autre composant via un flux dentre.
-maxErrors
Nombre maximal denregistrements derreurs autoriser avant de terminer le processus de chargement. La valeur par dfaut est "1". Les zros contenus dans une source binaire gnreront des erreurs. Paramtrez cette option "NO" pour gnrer des erreurs ou "YES" pour ignorer les bits ayant la valeur zro. La valeur par dfaut est "NO". Cette option ncessite que toutes les valeurs soient entoures de guillemets. La valeur par dfaut est "FALSE". Cette option ne fonctionne pas avec un flux dentre pour le moment. Utilisez cette option uniquement en mode standalone avec un fichier existant.
-ignoreZero
-requireQuotes
-nullValue <token>
Spcifiez le jeton pour indiquer une valeur null dans le fichier de donnes. La valeur par dfaut est "NULL". Afin damliorer lgrement les performances, vous pouvez configurer cette valeur comme un champ vide en spcifiant la valeur : "\'\'".
711
tNetezzaNzLoad
-fillRecord
Traite les derniers champs dentre manquants comme des null. Vous navez pas besoin de spcifier de valeur pour cette option dans le champ du tableau. Cette option nest pas active par dfaut, les champs dentre devront donc correspondre exactement toutes les colonnes de la table par dfaut. Les derniers champs dentre doivent tre nullables dans la base de donnes.
-ctrlChar
Accepte les caractres de contrle dans les champs char/varchar (vous devrez chapper les caractres NUL, CR et LF). Vous navez pas besoin de spcifier de valeur pour cette option dans le champ de valeur du tableau. Cette option est dsactive par dfaut. Accepte caractre CR non chapp dans des champs char/varchar (LF becomes only end of row). Vous navez pas besoin de spcifier de valeur pour cette option dans le champ de valeur du tableau. Cette option est dsactive par dfaut. Tronque toute valeur de chane de caractres qui dpasse sa valeur dclare de stockage char/varchar. Vous navez pas besoin de spcifier de valeur pour cette option dans le champ de valeur du tableau. Cette option est dsactive par dfaut. Spcifiez le format de la date des donnes dentre. Les valeurs valides sont : "YMD", "Y2MD", "DMY", "DMY2", "MDY", "MDY2", "MONDY", "MONDY2". La valeur par dfaut est "YMD". Le format de date dans la colonne du schma du composant doit correspondre la valeur spcifie ici. Par exemple, si vous souhaitez charger une colonne DATE, spcifiez ainsi le format de date dans le schma du composant : "yyyy-MM-dd" et paramtrez loption -dateStyle "YMD". Pour une description plus prcise du chargement de champs de dates et de temps, consultez la section Charger des colonnes de type DATE, TIME et TIMESTAMP, page 714.
-ctInString
-truncString
-dateStyle
-dateDelim
Caractre dlimiteur entre les parties dune date. La valeur par dfaut est "-" pour tous les styles de date, sauf pour "MONDY[2]" pour lequel elle est " " (espace vide). Le format de date dans la colonne du schma du composant doit correspondre la valeur spcifie ici.
-y2Base
Premire anne exprimable via lutilisation du style de date deux chiffres (Y2).
712
tNetezzaNzLoad
-timeStyle
Spcifiez le format du temps dans les donnes dentre. Les valeurs valides sont : "24HOUR" et "12HOUR". La valeur par dfaut est "24HOUR". Pour amliorer lgrement les performances, gardez la valeur par dfaut. Le format de temps dans la colonne du schma du composant doit correspondre la valeur spcifie ici. Par exemple, si vous souhaitez charger une colonne de type TIME, configurez le format de date dans le schma du composant "HH:mm:ss" et loption -timeStyle "24HOUR". Pour une description plus prcise du chargement de champs de dates et de temps, consultez la section Charger des colonnes de type DATE, TIME et TIMESTAMP, page 714.
-timeDelim
Caractre dlimiteur entre les parties dune donne de temps. La valeur par dfaut est ":". Le format de temps dans la colonne du schma du composant doit correspondre la valeur spcifie ici.
-timeRoundNanos -boolStyle
Autorise mais arrondit les nombres diffrents de zro plus petits quune microseconde. Spcifiez le format dans lequel les donnes de type Boolean sont crites dans les donnes. Les valeurs valides sont : "1_0", "T_F", "Y_N", "TRUE_FALSE", "YES". La valeur par dfaut est "1_0". Pour amliorer lgrement les performances, gardez la valeur par dfaut. Permet de continuer le chargement malgr une ou plusieurs rinitialisation(s) ou chec(s) des SPU (Snippet Processing Unit). Par dfaut, ce comportement nest pas autoris. Spcifiez le nombre de continuations du chargement autoris. La valeur par dfaut est "1". Slectionnez lencodage partir de la liste. Cochez cette case afin de spcifier le chemin daccs complet lexcutable nzload. Vous devez cocher cette case si le chemin daccs nest pas spcifi dans la variable denvironnement PATH. Chemin daccs complet lexcutable nzload sur la machine en cours dutilisation. Il est recommand de spcifier le chemin daccs dans la variable denvironnement PATH au lieu de slectionner cette option.
-allowRelay
-allowRelay <n> Encoding Specify nzload path
Full path to nzload executable
713
tNetezzaNzLoad
Utilisation
Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Netezza. Il permet aussi de crer un flux de rejet avec un lien Row > Rejects filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Charger des colonnes de type DATE, TIME et TIMESTAMP

Lorsque ce composant est utilis avec un flux dentre, le format de date spcifi dans le schma du composant doit correspondre la valeur spcifie pour les options -dateStyle, -dateDelim, -timeStyle, et -timeDelim. Veuillez vous rfrer aux exemples suivants :
Type de donnes DATE TIME TIMESTAMP Format de date dans le schma "yyyy-MM-dd" "HH:mm:ss" "yyyy-MM-dd HH:mm:ss" -dateStyle "YMD" n/a "YMD" -dateDelim "-" n/a "-" -timeStyle n/a "24HOUR" "24HOUR" -timeDelim n/a ":" ":"
Scnario associ
Pour un scnario associ, consultez le Scnario : Insrer des donnes dans une base MySQL du composant tMysqlOutputBulkExec.
714
tNetezzaOutput
tNetezzaOutput
Proprits du tNetezzaOutput
Le composant tNetezzaOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tNetezzaOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez cette case lorsque vous utilisez un composant tNetezzaConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Adresse IP du serveur de base de donnes. Composants Talend Open Studio 715
tNetezzaOutput
Port Database Username et Password Table Action on table
Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : Default : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondant au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete).
Action on data
716
tNetezzaOutput
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Cochez cette case pour insrer un ensemble de lignes dfinies au lieu dinsrer les lignes une par une. Cette option permet un important gain de performance. Number of rows per insert: : saisissez le nombre de lignes insrer en un bloc. Notez que si vous slectionnez un nombre important de lignes, cela peut augmenter la quantit de mmoire utilise et donc diminuer les performances.
Advanced settings
Extend Insert
Use Batch size
Cochez cette case afin dactiver le mode batch pour le traitement des donnes. Dans le champ Batch Size qui apparat, vous pouvez saisir le nombre de lignes par lot charger. Cette case est disponible uniquement si vous avez choisi loption Insert, Update, Single Insert Query ou Delete dans le champ Action on data. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution.
Commit every
717
tNetezzaOutput
Additional Columns
Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tNetezzaOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Use field options
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Netezza. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ au composant tNetezzaOutput, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du composant tMysqlOutput.
718
tNetezzaRollback
tNetezzaRollback
Proprits du tNetezzaRollback
Ce composant est troitement li aux composants tNetezzaCommit et tNetezzaConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tNetezzaRollback annule la transaction dans une base de donnes connecte. Ce composant permet dviter le commit de transaction involontaire. Component list Slectionnez le composant tNetezzaConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce component est gnralement utilis avec dautres composants Netezza, notamment les composants tNetezzaConnection et tNetezzaCommit components. n/a
Limitation
Scnario associ
Pour un scnario associ au composant tNetezzaRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674.
719
tNetezzaRow
tNetezzaRow
Proprits du tNetezzaRow
Fonction
tNetezzaRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tNetezzaRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tNetezzaConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.
Objectif
Basic settings
720
tNetezzaRow
Query
Die on error
Advanced settings
721
tNetezzaRow
Commit every
Scnario associ
Pour un scnario associ au composant tNetezzaRow, consultez le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678.
722
tOracleBulkExec
tOracleBulkExec
Proprits du tOracleBulkExec
Les composants tOracleOutputBulk et tOracleBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tOracleOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le changement des donnes dans la base de donnes.
Famille de composant Databases/Oracle
Le composant tOracleBulkExec insre, ajoute, remplace ou supprime les donnes dune base de donnes Oracle. Le tOracleBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes de la base de donnes Oracle. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez un composant tOracleConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection type DB Version Liste droulante contenant les pilotes disponibles Slectionnez la version dOracle que vous utilisez
723
tOracleBulkExec
Host Port Database Schema Service Name Perl uniquement Username et Password Table Action on table
Adresse IP du serveur de base de donnes Numro du port dcoute du serveur de base de donnes Nom de la base de donnes. Nom du schma. Nom du service ou SID de la base de donnes Oracle. Dans les projets Java, les informations de connexion doivent tre compltes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Insre des lignes dans une table vide. Le Job sarrte en cas de doublons. Update : Met jour les entres existantes. Append : Ajoute des lignes aux donnes dj existantes. Replace : Ecrase des lignes de la table. Truncate : Supprimer les entres correspondant au flux dentre. Il est ncessaire de spcifier au minimum une cl de recherche sur laquelle baser les oprations dUpdate. Il est possible de dfinir les colonnes qui agiront comme cl de recherche partir du schma, pour une utilisation de base, ou partir des options avances (Advanced settings) pour une utilisation optimise de ces oprations.
Data file name
Action on data
724
tOracleBulkExec
Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma soit local (built-in) soit distant dans le Repository. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Cochez cette case si vous utilisez un fichier de contrle (.ctl) et spcifiez son chemin daccs dans le champ .ctl file name. Dfinissez le format de lenregistrement : Default : les paramtres du format sont dfinis par dfaut. Stream : dterminez le sparateur de fin denregistrement. Fixed : dterminez la longueur denregistrement. Variable : dterminez la taille du champ spcifiant la longueur de lenregistrement.
Advanced settings
Advanced separator (for numbers)
Use existing control file Record format
Specify .ctl files INTO Cochez cette case pour renseigner manuellement la TABLE clause clause INTO TABLE du fichier de contrle, manually directement dans le code. Fields terminated by Caractre, chane ou expression rgulire sparant les champs : None : aucun caractre de sparation. Whitespace : le caractre de sparation est un espace. EOF (used for loading LOBs from lobfile) : la sparation est constitue dun caractre de fin de fichier (End Of File). Other terminator : la sparation est constitue dun caractre autre que ceux prcdemment noncs. Cochez cette case si vous voulez utiliser des caractres pour entourer le texte : Fields enclosure (left part) : caractre dlimitant les champs sur la gauche. Field enclosure (right part) : caractre dlimitant les champs sur la droite. Cochez cette case pour utiliser le modle de date contenu dans le schma pour remplir le champ concernant la date.
Use fields enclosure
Use schemas Date Pattern to load Date field
Specify field condition Cochez cette case pour dfinir une condition de chargement des donnes. Preserve blanks Trailing null columns Cochez cette case pour conserver les espaces vides. Cochez cette case pour charger des donnes avec des colonnes vides.
725
tOracleBulkExec
Load options
Cliquez sur le bouton [+] afin dajouter des options de chargement des donnes : Parameter : choisissez lun des paramtres de chargement partir de la liste droulante. Value : dfinissez la valeur attribuer au paramtre. A partir de la liste droulante, dfinissez la langue utilise pour les donnes qui ne sont pas codes en Unicode. Cochez cette case pour modifier les conventions d'appellation utilises pour la numrotation des jours et des semaines. La valeur par dfaut est celle du systme d'exploitation. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Slectionnez la sortie utiliser pour rcuprer la sortie standard de la base Oracle : to console : vers la console. to global variable : vers la variable globale. Cochez cette case pour mettre le nom des colonnes et celui de la table en majuscules.
NLS Language
Set Parameter NLS_TERRITORY
Encoding
Output
Convert columns and table names to uppercase
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Fields terminated by Perl uniquement Perl uniquement Perl uniquement Utilisation Fields optionnally enclosed by Encoding Caractre, chane ou expression rgulire sparant les champs. Caractres entourant les donnes.
Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes dune base de donnes.
Ce composant ddi offre performance et flexibilit lors de requtes sur les bases de donnes Oracle.
Scnario : Supprimer et insrer des donnes dans une base Oracle

Ce scnario dcrit comment supprimer le contenu dune base de donnes Oracle et dinsrer de nouvelles donnes partir du contenu dun fichier dentre. Le Job est constitu de trois composants qui crent le contenu, le transfert dans un fichier qui sera ensuite charg dans la base Oracle aprs que les donnes de la table aient t supprimes.
726
tOracleBulkExec
Cliquez et dposez les composants suivants : tOracleInput, tFileOutputDelimited, tOracleBulkExec. Connectez le composant tOracleInput au tFileOutputDelimited laide dun lien Row main. Et connectez le tOracleInput au tOracleBulkExec laide dun lien OnSubjobOk. Paramtrez les informations de connexion la base de donnes Oracle. Nous vous conseillons de stocker ces informations dans une mtadonne du Repository pour pouvoir les rutiliser par la suite dans tous vos Job.
Paramtrez le schma, sil nest pas conserv dans le Repository. Dans cet exemple, le schma est comme suit : ID_Contract, ID_Client, Contract_type, Contract_Value. Dans le champ Encoding, slectionnez loption Custom et dfinissez AL32UTF8 comme encodage. Dans le champ Basic settings du composant tFileOutputDelimited, paramtrez ses proprits, notamment les champs File Name, Row separator et Fields separator avec respectivement le chemin daccs et le nom du fichier, le sparateur de lignes et de champs. Dans le champ Encoding, saisissez le mme encodage que celui saisi dans les proprits du composant tOracleInput. Double-cliquez ensuite sur le composant tOracleBulkExec pour dfinir les proprits dalimentation de la base de donnes.
727
tOracleBulkExec
Dans le champ Property Type, slectionnez le mode Repository si vous avez stock les informations de connexion la base de donnes sous le nud Metadata du Repository ou slectionnez le mode Built-In pour les dfinir manuellement. Dans ce scnario, utilisez le mode Built-In. Dfinissez si ncessaire les paramtres de connexion dans les champs Host, Port, Database, Schema, Username et Password. Dans le champ Table, renseignez le nom de la Table alimenter et dans le champ Action on data, slectionnez laction effectuer, ici : Insert Dans le champ Schema, slectionnez le mode Built in puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes passer au composant suivant. Cliquez sur la vue Advanced settings pour configurer les paramtres avancs du composant.
728
tOracleBulkExec
Cochez la case Use an existing control file si vous avez stock les informations relatives ltat de la base de donnes dans un fichier de contrle (.ctl). Sinon, renseignez si ncessaire les champs suivants manuellement : Record format, Specify .ctl files INTO TABLE clause manually, Field terminated by, Use field enclosure, Use schemas Date Pattern to load Date field, Specify field condition, Preserve blanks, Trailing null columns, Load options, NLS Language et Set Parameter NLS_TERRITORY en fonction de votre base de donnes. Dans le champ Encoding Type, paramtrez lencodage comme dans les tapes prcdentes. Et dans le champ Output, slectionnez loption to console, ainsi la sortie standard de la base sera affiche dans la console. Appuyez sur F6 pour excuter le Job. La sortie de log apparat dans la vue Run et la table est alimente par les donnes du fichier paramtr. Voir galement : Scnario : Insrer des donnes dans une base MySQL, page 672
729
tOracleClose
tOracleClose
Proprits du tOracleClose
Le composant tOracleClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Oracle. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tOracleConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tOracleConnection et tOracleRollback. Il est gnralement utilis avec un composant tOracleConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tOracleClose, consultez tMysqlConnection page 630
730
tOracleCommit
tOracleCommit
Proprits du tOracleCommit
Ce composant est troitement li aux composants tOracleCommit et tOracleRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tOracleCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tOracleConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tOracleCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Oracle et notamment tOracleConnection et tOracleRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tOracleConnection et tOracleRollback. Ils sont gnralement utiliss avec un composant tOracleConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tOracleCommit, consultez tMysqlConnection page 630
731
tOracleConnection
tOracleConnection
Proprits du tOracleConnection
Ce composant est troitement li aux composants tOracleCommit et tOracleRollback. Ils sont gnralement utiliss avec un composant tOracleConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tOracleConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Connection type DB Version Use tns file Liste droulante des pilotes disponibles. Slectionnez la version dOracle que vous utilisez. Cochez cette case pour utiliser les mtadonnes dun contexte contenu dans un fichier tns. Un mme fichier Tns peut contenir plusieurs contextes. TNS File : Renseignez manuellement le chemin daccs ou cliquez sur le bouton [...] pour parcourir vos dossiers jusquau fichier Tns utiliser. Select a DB Connection in Tns File : Cliquez sur le bouton [...] pour afficher tous les contextes du fichier Tns et slectionner celui utiliser. Host Port Database Schema Username et Password Additional JDBC parameters Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma Informations dauthentification de lutilisateur de base de donnes. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Dans ce champ, vous pouvez paramtrer le type dencodage.
732
tOracleConnection
Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.
Ce composant est gnralement utilis avec des composants Oracle, notamment les composants tOracleCommit et tOracleRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tOracleCommit et tOracleRollback. Ils sont gnralement utiliss avec un composant tOracleConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tOracleConnection, consultez tMysqlConnection page 630
733
tOracleInput
tOracleInput
Proprits du tOracleInput
Fonction Objectif
Le composant tOracleInput lit une base de donnes et en extrait des champs laide de requtes. Le tOracleInput excute une requte de base de donnes dans laquelle lordre doit strictement correspondre lordre dfini dans le schma. Puis la liste des champs est transmise au composant via une connexion Main row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionne le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
Basic settings
734
tOracleInput
Cochez cette case lorsque vous utilisez un composant tOracleConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Connection type DB Version Host Port Database Oracle schema Username et Password Schema et Edit Schema
Liste droulante des pilotes disponibles. Slectionnez la version dOracle que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma Oracle. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Table name
Nom de la table de base de donnes.
735
tOracleInput
Query type et Query
Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Use cursor Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en une fois. Cette option permet doptimiser les performances. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Trim all the String/Char columns Trim column Utilisation
Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Oracle.
Scnarios associs
Consultez les scnarios du composant tOracleInput : le Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. le Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Pour un scnario associ, consultez le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 du composant tContextLoad.
736
tOracleOutput
tOracleOutput
Proprits du tOracleOutput
Le composant tOracleOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tOracleOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
737
tOracleOutput
Cochez cette case lorsque vous utilisez le composant tOracleConnection. Lorsque vous la dcochez, une case (coche par dfaut, suivie dun champ) apparat dans les Advanced settings, Batch Size, qui vous permet de saisir le nombre de lignes dans chaque lot de traitement de donnes. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Connection type DB Version Java uniquement Host Port Database Oracle schema Perl uniquement
Liste droulante des pilotes disponibles. Slectionnez la version dOracle que vous utilisez.
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma Oracle
Username et Password Informations dauthentification de lutilisateur de la base de donnes. Table Nom de la table crer. Vous ne pouvez crer quune seule table la fois.
738
tOracleOutput
Action on table
Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : Default : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondant au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete).
Action on data
Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio.
739
tOracleOutput
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Die on error Java uniquement Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Cochez cette case afin dcraser les variables prcdemment dfinies dans un environnement au langage NLS. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cochez cette case pour collecter les donnes de log au niveau du composant. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tOracleOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier. Use field options Java uniquement Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes.
Advanced settings
Java uniquement Override any existing NLS_LANG environment variable Commit every
Perl uniquement
tStatCatcher Statistics Additional Columns
740
tOracleOutput
Use Hint Options Java uniquement Convert columns and table to uppercase Enable debug mode Java uniquement Use Batch Size Java uniquement
Cochez cette case pour ajouter des indicateurs (ou Hints) permettant doptimiser le plan dexcution de la requte afin dobtenir les meilleurs performances possibles. Cochez cette case pour passer les noms de colonnes et de tables en majuscule. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. Nombre de lignes dans chaque lot de traitement de donnes. Si cette case napparat pas, vrifiez que la case Use an existing connection dans les Basic settings est dcoche.
Java uniquement
Java uniquement Utilisation
Support null in SQL WHERE statement
Cochez cette case pour prendre en compte les valeurs Null lors dune instruction WHERE.
Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Ce composant doit tre utilis en tant que composant de sortie. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Oracle. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ au composant tOracleOutput, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du composant tMysqlOutput.
741
tOracleOutputBulk
tOracleOutputBulk
Proprits du tOracleOutputBulk
Les composants tOracleOutputBulk et tOracleBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tOracleOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Oracle. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Oracle. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio.
Create directory if not Cette option permet de crer le dossier contenant le exists fichier de sortie sil nexiste pas dj. Append Schema et Edit Schema Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
742
tOracleOutputBulk
Advanced settings
Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
Field separator Row separator Encodind Type
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec le composant tOracleBulkExec. Ensemble ils offrent un gain de performance important pour lalimentation dune base de donnes Oracle.
Scnarios associs
Pour des scnarios associs au composant tOracleOutputBulk, consultez les scnarios suivants : Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec. Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
743
tOracleOutputBulkExec
Proprits du tOracleOutputBulkExec
Les composants tOracleOutputBulk et tOracleBulkExec sont gnralement utiliss ensemble comme deux parties dun processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime tape, ce fichier est utilis lors de lopration dINSERT afin de populer une base de donnes. Cette excution en deux tapes est unifie dans le composant tOracleOutputBulkExec.
Le tOracleOutputBulkExec effectue une action dInsert sur les donnes fournies. Ce composant est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Oracle. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tOracleConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection type DB Version Host Liste droulante des pilotes disponibles. Slectionnez la version dOracle que vous utilisez. Adresse IP du serveur de base de donnes.
744
Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cette case est coche par dfaut. Cette option permet de crer un rpertoire o stocker la table de sortie si elle nexiste pas. Cochez cette case afin dajouter de nouvelles lignes la fin de lenregistrement. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Truncate : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une cl de recherche sur laquelle baser les oprations dUpdate. Il est possible de dfinir les colonnes qui agiront comme cl de recherche partir du schma, pour une utilisation de base, ou partir des options avances (Advanced settings) pour une utilisation optimise de ces oprations.
Action on table
File Name
Create directory if not exists Append Action on data
745
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Advanced settings
Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Cochez cette case si vous utilisez un fichier de contrle (.ctl). Dfinissez le format de lenregistrement : Default : les paramtres du format sont dfinis par dfaut. Stream : dterminez le sparateur de fin denregistrement. Fixed : dterminez la longueur denregistrement. Variable : dterminez la taille du champ spcifiant la longueur de lenregistrement.
Use existing control file Record format
Specify .ctl files INTO Cochez cette case pour renseigner manuellement la TABLE clause clause INTO TABLE du fichier de contrle, manually directement dans le code. Fields terminated by Caractre, chane ou expression rgulire sparant les champs : None : aucun caractre de sparation. Whitespace : le caractre de sparation est un espace. EOF (used for loading LOBs from lobfile) : la sparation est constitue dun caractre de fin de fichier (End Of File). Other terminator : la sparation est constitue dun caractre autre que ceux prcdemment noncs. Cohez cette case si vous voulez utiliser des caractres pour entourer le texte : Fields enclosure (left part) : caractre dlimitant les champs sur la gauche. Field enclosure (right part) : caractre dlimitant les champs sur la droite. Cochez cette case pour utiliser le modle de date contenu dans le schma pour remplir le champ concernant la date.
Use fields enclosure
Use schemas Date Pattern to load Date field
746
Specify field condition Cochez cette case pour dfinir une condition de chargement des donnes. Preserve blanks Trailing null columns Load options Cochez cette case pour conserver les espaces vides. Cochez cette case pour charger des donnes avec des colonnes vides. Cliquez sur le bouton [+] afin dajouter des options de chargement des donnes : Parameter : choisissez lun des paramtres de chargement partir de la liste droulante. Value : dfinissez la valeur attribuer au paramtre. A partir de la liste droulante, dfinissez la langue utilise pour les donnes qui ne sont pas codes en Unicode. Cochez cette case pour modifier les conventions d'appellation utilises pour la numrotation des jours et des semaines. La valeur par dfaut est celle du systme d'exploitation. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Slectionnez dans la liste droulante lendroit o rediriger le flux de sortie : to console : ver la console de log. to global variable : vers une variable globale. Cochez cette case pour mettre le nom des colonnes et celui de la table en majuscules.
NLS Language
Set Parameter NLS_TERRITORY
Encoding
Output
Convert columns and table names to uppercase
Scnarios associs
Pour des scnarios associs au composant tOracleOutputBulkExec, consultez les scnarios suivants : Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec. Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
747
tOracleRollback
tOracleRollback
Proprits du tOracleRollback
Ce composant est troitement li aux composants tOracleCommit et tOracleConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tOracleRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Close connection Slectionnez le composant tOracleConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants Oracle, notamment les composants tOracleConnection et tOracleCommit. n/a
Scnario associ
Ce composant est troitement li aux composants tOracleConnection et tOracleCommit. Ils sont gnralement utiliss ensemble lors dune transaction. Pour un scnario associ au composant tOracleRollback, consultez tMysqlRollback page 674.
748
tOracleRow
tOracleRow
Proprits du tOracleRow
Fonction
Le tOracleRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tOracleRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tOracleConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection type DB Version Host Port Liste droulante des pilotes disponibles. Slectionnez la version dOracle que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes.
Objectif
Basic settings
749
tOracleRow
Database Schema Username et Password Schema et Edit Schema
Nom de la base de donnes. Nom du schma Oracle. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Table name Query type
Nom de la table de base de donnes. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.
Query
Die on error
Advanced settings
750
tOracleRow
Commit every
Scnario associ
Pour un scnario associ, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 411 du tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678 du tMySQLRow.
751
tOracleSCD
tOracleSCD
Le composant tOracleSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tOracleSCD page 180.
752
tOracleSCDELT
tOracleSCDELT
Le composant tOracleSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tOracleSCDELT, page 183.
753
tOracleSP
tOracleSP
Proprits du tOracleSP
Le composant tOracleSP appelle une procdure stocke de base de donnes. Ce composant permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. Use an existing connection Cochez cette case et slectionnez le composant tOracleConnection adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection type Le type de connexion peut tre : - Oracle SID - Oracle Service Name - Oracle OCI Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier des proprits du composant. Les champs suivants sont alors pr-remplis. DB Version Host Port Slectionnez la version dOracle que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes.
Property type
754
tOracleSP
Database Schema Username et Password Schema et Edit schema
Nom de la base de donnes. Nom du schma. Informations dauthentification sur lutilisateur de base de donnes. Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est rutilisable. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Saisissez le nom exact de la Procdure Stocke (SP). Cochez cette case, si une seule valeur doit tre retourne. Slectionnez dans la liste la colonne du schma sur laquelle est base la valeur obtenir. Cliquez sur le bouton [+] et slectionnez dans le champ Schema Columns les diffrentes colonnes ncessaires la procdure. Notez que le schma de la SP peut contenir plus de colonnes quil ny a de paramtres utiliss dans la procdure. Slectionnez le Type de paramtre : IN : paramtre dentre (Input) OUT : paramtre de sortie (Output)/valeur retourne IN OUT : les paramtres dentre doivent tre retournes sous forme de valeur, mme aprs modifications via la procdure (fonction). RECORDSET : les paramtres dentre doivent tre retournes sous forme densemble de valeurs, au lieu dune valeur unique. Consultez le composant tParseRecordSet si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL. Le type Custom Type est utilis quand une colonne du schma (Schema Column) que vous souhaitez utiliser est dfinie par lutilisateur. Deux types de Custom sont disponibles dans le tableau Parameters. Pour le premier type : - Cochez la case quand la colonne du schma correspondant est dfinie par lutilisateur. - Si toutes les colonnes du schma dans le tableau Parameters sont de type personnalis, vous pouvez cocher la case devant Custom Type.
Parameters
755
tOracleSP
Slectionnez un type de base de donnes dans la liste DB Type afin de mapper le type de la base de donnes source vers le type de la base de donnes cible : - Auto-Mapping : Mappe le type de la base de donnes source au type de la base de donnes cible automatiquement (par dfaut). - CLOB : Character large object - BLOB :Binary large object - DECIMAL : objet dcimal numrique - NUMERIC : caractre compris entre 0 et 9. Dans la seconde colonne Custom Type, vous pouvez prciser le type de personnalisation. Il peut tre - STRUCT : utilis pour un lment. - ARRAY : utilis pour plusieurs lments. Dans la colonne Custom name, spcifiez le type de personnalisation. Dans le tableau Parameters, si une colonne est de Type OUT, assurez-vous que son type dans le schma est bien Object. Advanced settings Additional JDBC parameters Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. A partir de la liste droulante, dfinissez la langue utilise pour les donnes qui ne sont pas codes en Unicode. Cochez cette case pour modifier les conventions d'appellation utilises pour la numrotation des jours et des semaines. La valeur par dfaut est celle du systme d'exploitation.
NLS Language
NLS Territory
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau du composant. Utilisation Limitation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss. La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes. Quand le paramtre dfini dans ce composant est personnalis (Custom Type), les composants de la famille tJava doivent tre placs avant le tOracleSP, afin que les utilisateurs puissent dfinir des valeurs pour les paramtres personnaliss, ou bien aprs le tOracleSP, pour lire et crire les paramtres personnaliss de type OUT.
Scnario : Vrifier le format de numros laide dune procdure stocke

Le Job suivant permet de se connecter une base Oracle contenant des numros de scurit social et le nom de leur propritaire, en appelant une procdure stocke qui vrifie le format des numros
756
tOracleSP
en fonction du format standard ###-##-####. Puis le rsultat de la vrifiaction, 1 pour un format valide et 0 pour un format non valide, est affich en sortie dans la console de la vue Run.
Cliquez et dposez les composants suivants : tOracleConnection, tOracleInput, tOracleSP et tLogRow. Reliez le composant tOracleConnection au tOracleInput laide dun lien Then Run puisquaucune donne nest traite ici. Et connectez les autres composants laide de liens Row Main puisque des lignes sont transmises comme paramtres au composant SP et la console. Dans longlet Basic settings du composant tOracleConnection, paramtrez les informations de connexion la base de donnes correspondante. Vous pourrez donc rutiliser cette information dans tout autre composant li aux bases de donnes. Puis double-cliquez sur le composant tOracleInput et paramtrez ses proprits.
Cochez la case Use an existing connection et slectionnez le composant tOracleConnection dans la liste pour rutiliser les informations de connexion dj paramtres. Slectionnez loption Repository dans le champ Property type puisque le schma Oracle est dfini dans une mtadonne du dossier Db Connections du Repository. Si vous navez pas enregistr de mtadonne contenant les informations de connexion la base de donnes Oracle dans le Repository, renseignez le nom du schma manuellement. Puis slectionnez loption Repository dans le champ Schema, et rcuprez le schma correspondant la table de la base de donnes Oracle.
757
tOracleSP
Dans cet exemple, la table contenant le numro de scurit social contient un schma quatre colonnes dont : ID, NAME, CITY et SSNUMBER. Dans le champ Query, saisissez la requte Select suivante ou slectionnez-la dans la liste si vous laviez stocke dans le Repository. select ID, NAME, CITY, SSNUMBER from SSN Puis slectionnez le tOracleSP et paramtrez ses proprits dans longlet Basic settings.
Comme pour le composant tOracleInput, slectionnez loption Repository dans le champ Property type et cochez la case Use an existing connection, puis slectionnez lentre adquate dans la liste Component List. Le schma utilis pour le composant tOracleSP diffre lgrement du schma dentre. En effet, une colonne supplmentaire (SSN_Valid) est ajoute au schma dentre. Cette colonne contiendra le statut de validit (1 ou 0) gnr par la procdure.
Puis slectionnez le type dencodage adquat dans la liste Encoding type. Dans le champ SP Name, saisissez le nom exact de la procdure stocke (ou de la fonction) telle quelle est appele dans la base de donnes. Dans cet exemple, le nom de la procdure stocke est is_ssn.
758
tOracleSP
La fonction de base utilise pour cet exemple est : CREATE OR REPLACE FUNCTION is_ssn(string_in VARCHAR2) RETURN PLS_INTEGER IS -- validating ###-##-#### format BEGIN IF TRANSLATE(string_in, '0123456789A', 'AAAAAAAAAAB') = 'AAA-AA-AAAA' THEN RETURN 1; END IF; RETURN 0; END is_ssn; / Comme un valeur retourne est attendue dans cet exemple, la procdure agit comme une fonction, ainsi cochez la case Is function. La seule valeur retourne attendue est base sur la colonne ssn_valid. Ainsi, slectionnez lentre correspondante dans la liste. Dans la zone Parameters, dfinissez les paramtres dentre et de sortie utiliss dans la procdure. Dans cet exemple, seule la colonne SSNumber du schma est utilise dans la procdure. Cliquez sur le signe [+] pour ajouter un nouvelle ligne la table et slectionnez la colonne adquate (SSNumber) et son type (IN). Puis slectionnez le composant tLogRow et cliquez sur Sync Column pour rcuprer le schma du composant prcdent (tOracleSP).
Cochez la case Print values in cells of a table pour faciliter la lecture de la sortie. Puis enregistrez le Job et appuyez sur F6 pour lexcuter.
Dans la console, vous pouvez lire les rsultats en sortie. Toutes les colonnes du schma dentre sont affiches mme si elles ne sont pas utilises comme paramtres dans la procdure stocke.
759
tOracleSP
La colonne finale affiche la valeur retourne attendue, i.e. que le numro de scurit social vrifi soit valide ou non. Consultez galement le composant tParseRecordSet, page 786 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.
760
tOracleTableList
tOracleTableList
Proprits du tOracleTableList
Le composant tOracleTableList effectue une opration ditration sur toutes les tables dune base de donnes, grce une connexion Oracle dfinie. Le composant tOracleTableList permet de lister les noms des tables Oracle grce aux commandes SELECT et WHERE. Component list Slectionnez le composant de connexion tOracleConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours.
Where clause for table Saisissez la commande WHERE permettant name selection didentifier les tables sur lesquelles effectuer lopration ditration. Utilisation Limitation Il faut utiliser ce composant en association avec les autres composants Oracle, notamment avec le tOracleConnection. n/a
Scnario associ
761
tParAccelBulkExec
tParAccelBulkExec
Proprits du tParAccelBulkExec
Les composants tParAccelOutputBulk et tParAccelBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tParAccelOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le changement des donnes dans la base de donnes.
Famille de composant Databases/ParAccel
Fonction Objectif
Le composant tParAccelBulkExec effectue une action dInsert sur les donnes fournies. Le tParAccelBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Greenplum. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tParAccelConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Adresse IP du serveur de base de donnes.
Basic settings
762
tParAccelBulkExec
Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Slectionnez le mode de Copy que vous souhaitez utiliser. Basic : Mode classique, sans optimisation. Parallel : Mode permettant dutiliser plusieurs API internes ParAccel, afin damliorer les performances de chargement. Nom du fichier traiter et chemin daccs. Slectionnez dans la liste le type de fichier. Slectionnez dans la liste la disposition du fichier. Caractre, chane ou expression rgulire sparant les champs (si vous chargez un fichier dlimit). LID sera assign directement par la base de donnes ou est dj prsent dans le fichier charger. Cochez cette case afin de retirer les guillemets de votre fichier charger. Saisissez le nombre maximal derreurs avant que votre Job ne sarrte. Saisissez le format de date qui sera utilis. Saisissez le format de date et heure qui sera utilis. Saisissez loption spcifique ParAccel et personnalise que vous souhaitez utiliser. Saisissez le chemin daccs votre fichier de log, ou parcourez votre rpertoire.
Action on table
Advanced settings
Copy mode
Filename File Type Field Layout Field separator Explicit IDs Remove Quotes Max. Errors Date Format Time/Timestamp Format Additional COPY Options Log file
763
tParAccelBulkExec
Logging level
Slectionnez le niveau de verbose retourner.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec un composant tParAccelOutputBulk. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes ParAccel. n/a
Limitation
Scnarios associs
Pour plus dinformations relatives au fonctionnement de tParAccelBulkExec, consultez les scnarios suivants : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du composant tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du composant tOracleBulkExec.
764
tParAccelClose
tParAccelClose
Proprits du tParAccelClose
Le composant tParAccelClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes ParAccel. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tParAccelConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tParAccelConnection et tParAccelRollback. Il est gnralement utilis avec un composant tParAccelConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tParAccelClose, consultez tMysqlConnection page 630
765
tParAccelCommit
tParAccelCommit
Proprits du tParAccelCommit
Ce composant est troitement li aux composants tParAccelCommit et tParAccelRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tParAccelCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tParAccelConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tParAccelCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants ParAccel et notamment tParAccelConnection et tParAccelRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tParAccelConnection et tParAccelRollback. Ils sont gnralement utiliss avec un composant tParAccelConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tParAccelCommit, consultez tMysqlConnection page 630
766
tParAccelConnection
tParAccelConnection
Proprits du tParAccelConnection
Ce composant est troitement li aux composants tParAccelCommit et tParAccellRollback. Ils sont gnralement utiliss avec un composant tParAccelConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tParAccelConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Schema Username et Password Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.
Advanced settings
Auto commit
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Limitation Ce composant est gnralement utilis avec des composants ParAccel, notamment les composants tParAccelCommit et tParAccelRollback. n/a
767
tParAccelConnection
Scnario associ
Ce composant est troitement li aux composants tParAccelCommit et tParAccelRollback. Ils sont gnralement utiliss avec un composant tParAccelConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tParAccelConnection, consultez tMysqlConnection page 630
768
tParAccelInput
tParAccelInput
Proprits du tParAccelInput
Famille de composant Databases/ ParAccel
Fonction Objectif
Le composant tParAccelInput lit une base de donnes et en extrait des champs laide de requtes. Le tParAccelInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
Basic settings
769
tParAccelInput
Cochez cette case lorsque vous utilisez le composant tParAccelConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Host Port Database Schema Username et Password Schema et Edit Schema
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Nom de la table de base de donnes. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.
770
tParAccelInput
Advanced settings
Use cursor
Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en une fois. Cette option permet doptimiser les performances. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes ParAccel.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tParAccelInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401 Scnario 2 : Utiliser la variable StoreSQLQuery, page 403
771
tParAccelOutput
tParAccelOutput
Proprits du tParAccelOutput
Le composant tParAccelOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tParAccelOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez cette case lorsque vous utilisez le composant tParAccelConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
772
tParAccelOutput
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma. Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete).
Action on data
773
tParAccelOutput
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tParAccelOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Advanced settings
Commit every
Additional Columns
Use field options
774
tParAccelOutput
Utilisation
Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes ParAccel. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ au composant tParAccelOutput consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du tMysqlOutput.
775
tParAccelOutputBulk
tParAccelOutputBulk
Proprits du tParAccelOutputBulk
Les composants tParAccelOutputBulk et tParAccelBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tParAccelOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards ParAccel. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes ParAccel. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Advanced settings
776
tParAccelOutputBulk
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec le composant tParAccelBulkExec. Ensemble ils offrent un gain de performance important pour lalimentation dune base de donnes ParAccel.
Scnarios associs
Pour un scnario associ au composant tParAccelOutputBulk, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
777
tParAccelOutputBulkExec
Proprits du tParAccelOutputBulkExec
Les composants tParAccelOutputBulk et tParAccelBulkExecsont gnralement utiliss ensemble comme deux parties dun processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime tape, ce fichier est utilis lors de lopration dINSERT afin de populer une base de donnes. Cette excution en deux tapes est unifie dans le composant tParAccelOutputBulkExec.
Fonction Objectif
Le tParAccelOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tParAccelOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes ParAccel. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Schema Username et Password Table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None: neffectuer aucune opration de table. Drop and create the table: supprimer la table puis en crer une nouvelle. Create a table: crer une table qui nexiste pas encore. Create table if doesnt exist: crer la table si ncessaire. Clear a table: supprimer le contenu de la table. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository.
Basic settings
Action on table
778
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. File Name Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Slectionnez le mode de Copy que vous souhaitez utiliser. Basic : Mode classique, sans optimisation. Parallel : Mode permettant dutiliser plusieurs API internes ParAccel, afin damliorer les performances de chargement. Nom du fichier traiter et chemin daccs. Slectionnez dans la liste le type de fichier. Slectionnez dans la liste la disposition du fichier. Caractre, chane ou expression rgulire sparant les champs (si vous chargez un fichier dlimit). LID sera assign directement par la base de donnes ou est dj prsent dans le fichier charger. Cochez cette case afin de retirer les guillemets de votre fichier charger. Saisissez le nombre maximal derreurs avant que votre Job ne sarrte. Saisissez le format de date qui sera utilis. Saisissez le format de date et heure qui sera utilis. Saisissez loption spcifique ParAccel et personnalise que vous souhaitez utiliser. Saisissez le chemin daccs votre fichier de log, ou parcourez votre rpertoire. Slectionnez le niveau de verbose retourner.
Advanced settings
Copy mode
Filename File Type Field Layout Field separator Explicit IDs Remove Quotes Max. Errors Date Format Time/Timestamp Format Additional COPY Options Log file Logging level
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est principalement utilis lorsquaucune transformation particulire nest requise sur les donnes charger dans la base de donnes.
Scnarios associs
Pour un scnario associ au composant tParAccelOutputBulkExec, consultez :
779
le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
780
tParAccelRollback
tParAccelRollback
Proprits du tParAccelRollback
Ce composant est troitement li aux composants tParAccelCommit et tParAccelConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tParAccelRollback annule la transaction dans une base de donnes connecte. Ce composant permet dviter le commit de transaction involontaire. Component list Slectionnez le composant tParAccelConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce component est gnralement utilis avec dautres composants ParAccel, notamment les composants tParAccelConnection et tParAccelCommit components. n/a
Limitation
Scnario associ
Pour un scnario associ au composant tParAccelRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674.
781
tParAccelRow
tParAccelRow
Proprits du tParAccelRow
Fonction
Le tParAccelRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tParAccelRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tParAccelConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma
Objectif
Basic settings
782
tParAccelRow
Nom de la table de base lire. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.
Query
Die on error
Advanced settings
783
tParAccelRow
Commit every
Scnarios associs
784
tParAccelSCD
tParAccelSCD
Le composant tParAccelSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tParAccelSCD, page 243.
785
tParseRecordSet
tParseRecordSet
Proprits du tParseRecordSet
Ce composant se trouve la racine de la famille Databases de la Palette de Talend Open Studio. Le composant tParseRecordSet couvre des besoins indirectement lis lutilisation des bases de donnes de tout type.
Fonction
Le composant tParseRecordSet analyse un ensemble denregistrements dune table de donnes ou dune requte SQL et retourne ventuellement des enregistrements seuls. Il permet danalyser un ensemble denregistrements dune table au lieu de les analyser individuellement. Prev. Comp. Column list Schema et Edit Schema Slectionnez la colonne contenant lensemble denregistrements analyser. Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est rutilisable. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Attribute table Paramtrez la valeur positionnelle de chaque colonne de chaque enregistrement dun ensemble denregistrements.
Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss. Ce composant est principalement utilis avec la fonctionnalit Recordset dun composant SP.
Scnario associ
Pour un exemple dutilisation du tParseRecordSet, consultez le Scnario 2 : Utiliser linstance PreparedStatement pour faire une requte sur des donnes, page 679.
786
tPostgresPlusBulkExec
Proprits du tPostgresPlusBulkExec
Les composants tPostgresPlusOutputBulk et tPostgresPlusBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tPostgresPlusOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le changement des donnes dans la base de donnes.
Famille de composant Databases/PostgresPl us Le composant PostgresPlusBulkExec excute des oprations dInsert sur les donnes fournies. Le tPostgresPlusBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes DB2. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tPostgresqlConnection adquat partir de la liste Component List pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
787
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification sur lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None: neffectuer aucune opration de table. Drop and create the table: supprimer la table puis en crer une nouvelle. Create a table: crer une table qui nexiste pas encore. Create table if doesnt exist: crer la table si ncessaire. Clear a table: supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Filename
Advanced settings
Action
Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Les informations demandes seront diffrentes en fonction de laction choisie. Caractre, chane ou expression rgulire sparant les champs.
Field terminated by
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes Postgresplus.
788
Scnario associ
Pour un scnario associ au composant tPostgresPlusBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
789
tPostgresPlusClose
tPostgresPlusClose
Proprits du tPostgresPlusClose
Famille de composant Databases/PostgresPl us Le composant tPostgresPlusClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes PostgresPlus. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tPostgresPlusConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tPostgresPlusConnection et tPostgresPlusRollback. Il est gnralement utilis avec un composant tPostgresPlusConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tPostgresPlusClose, consultez tMysqlConnection page 630
790
tPostgresPlusCommit
tPostgresPlusCommit
Proprits du tPostgresPlusCommit
Ce composant est troitement li aux composants tpostgresPlusConnection et tPostgresPlusRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/PostgresPl us Le composant tPostgresPlusCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tPostgresPlusConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tPostgresPlusCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants PostgresPlus et notamment avec les composants tPostgresPlusConnection et tPostgresPlusRollback. n/a
Fonction Objectif
Basic settings
Close connection
Limitation
Scnario associ
Ce composant est troitement li aux composants tPostgresPlusConnection et tPostgresPlusRollback. Ils sont gnralement utiliss avec un composant tPostgresPlusConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tPostgresPlusCommit, consultez tMysqlConnection page 630.
791
tPostgresPlusConnection
Proprits du tPostgresPlusConnection
Ce composant est troitement li aux composants tPostgresPlusCommit et tPostgresPlusRollback. Ils sont gnralement utiliss avec un composant tPostgresPlusConnection car il permet douvrir une connexion pour la transaction en cours.
Famille de composant Databases/PostgresPl us Le composant tPostgresPlusConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Schema Username et Password Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.
Advanced settings
Auto commit
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Ce composant est gnralement utilis avec des composants PostgresPlus et notamment avec les composants tPostgresPlusCommit et tPostgresPlusRollback. n/a
Limitation
792
Scnario associ
Ce composant est troitement li aux composants tPostgresPlusCommit et tPostgresPlusRollback. Ils sont gnralement utiliss avec un composant tPostgresPlusConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tPostgresPlusConnection, consultez tMysqlConnection page 630
793
tPostgresPlusInput
tPostgresPlusInput
Proprits du tPostgresPlusInput
Famille de composant Databases/ PostgresPlus Le composant tPostgresPlusInput lit une base de donnes et en extrait des champs laide de requtes. Le tPostgresPlusInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
Fonction Objectif
Basic settings
794
tPostgresPlusInput
Cochez cette case lorsque vous utilisez le composant tPostgresPlusConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Host Port Database Schema Username et Password Schema et Edit schema
Nom de la table de base de donnes. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.
795
tPostgresPlusInput
Advanced settings
Use cursor
Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en une fois. Cette option permet doptimiser les performances Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes PostgresPlus.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tPostgresPlusInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401 Scnario 2 : Utiliser la variable StoreSQLQuery, page 403
796
tPostgresPlusOutput
tPostgresPlusOutput
Proprits du tPostgresPlusOutput
Famille de composant Databases/PostgresPl us Le tPostgresPlusOutput crit, met jour, effectue les changements ou supprime les entres dans une base de donnes. Le tPostgresPlusOutput excute laction dfinie sur la table et/ou sur les donnes contenues dans la table, partir du flux entrant du composant prcdent dans le Job. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
Fonction Objectif
Basic settings
797
tPostgresPlusOutput
Cochez cette case si vous utilisez composant tPostgresPlusConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Host Port Database Schema Username et Password Table
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback.
Action on table
798
tPostgresPlusOutput
Action on data
Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete)
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Die on error
799
tPostgresPlusOutput
Advanced settings
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tPostgresqlOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. Cochez cette case pour prendre en compte les valeurs Null dune table de base de donnes. Assurez-vous que la case Nullable est bien coche pour les colonnes du schma correspondantes. Cochez cette case afin dactiver le mode batch pour le traitement des donnes. Dans le champ Batch Size qui apparat, vous pouvez saisir le nombre de lignes par lot charger. Cette case est disponible uniquement si vous avez choisi loption Insert, Update, Single Insert Query ou Delete dans le champ Action on data.
Use Batch size
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes PostgresPlus. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
800
tPostgresPlusOutput
Scnarios associs
Pour des scnarios associs, consultez : tDBOutput Scnario : Afficher la base de donnes en sortie, page 407 tMysqlOutput Scnario 1 : Ajouter une colonne et modifier les donnes, page 651.
801
tPostgresPlusOutputBulk
Proprits du tPostgresPlusOutputBulk
Les composants tPostgresPlusOutputBulk et tPostgresPlusBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tPostgresPlusOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Famille de composant Databases/PostgresPl us Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Postgresql. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Postgresql. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Advanced settings Row separator Field separator Include header Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Cochez cette case pour inclure len-tte des colonnes dans le fichier.
802
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec le composant tPostgresPlusBulkExec. Ensemble ils offrent un gain de performance important pour lalimentation dune base de donnes PostgresPlus.
Scnarios associs
Pour un scnario associ au composant tPostgresPlusOutputBulk, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
803
tPostgresPlusOutputBulkExec
Proprits du tPostgresplusOutputBulkExec
Les composants tPostgresPlusOutputBulk et tPostgresPlusBulkExec sont gnralement utiliss ensemble comme deux parties dun processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime tape, ce fichier est utilis lors de lopration dINSERT afin de populer une base de donnes. Cette excution en deux tapes est unifie dans le composant tPostgresPlusOutputBulkExec.
Famille de composant Databases/Postgrespl us Le tPostgresPlusOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tPostgresPlusOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes PostgresPlus. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Schema Username et Password Table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio.
Fonction Objectif
Basic settings
Action on table
File Name
804
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Advanced settings
Action
Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Les informations demandes seront diffrentes en fonction de laction choisie. Slectionnez le type de fichiers traiter. Chane de caractres affiche pour signifier que la valeur est nulle. Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs : None : aucun caractre de sparation. Whitespace : le caractre de sparation est un espace. EOF (used for loading LOBs from lobfile) : la sparation est constitue dun caractre de fin de fichier (End Of File). Other terminator : la sparation est constitue dun caractre autre que ceux prcdemment noncs. Caractre dchappement de la ligne.
File type Null string Row separator Fields terminated by
Escape character
Scnarios associs
Pour un scnario associ au composant tPostgresPlusOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
805
tPostgresPlusRollback
tPostgresPlusRollback
Proprits du tPostgresPlusRollback
Ce composant est troitement li aux composants tPostgresPlusCommit et tPostgresPlusConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Famille de composant Databases/PostgresPl us Le tPostgresPlusRollback annule la transaction dans une base de donnes connecte. Ce composant permet dviter le commit de transaction involontaire. Component list Slectionnez le composant tPostgresPlusConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce component est gnralement utilis avec dautres composants PostgresPlus, notamment les composants tPostgresPlusConnection et tPostgresPlusCommit components. n/a
Limitation
Scnario associ
Pour un scnario associ au composant tPostgresPlusRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674.
806
tPostgresPlusRow
tPostgresPlusRow
Proprits du tPostgresPlusRow
Famille de composant Databases/PostgresPl us Le tPostgresPlusRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tPostgresPlusRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tPostgresPlusConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma
Fonction
Objectif
Basic settings
807
tPostgresPlusRow
Nom de la table de base lire. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.
Query
Die on error
Advanced settings
808
tPostgresPlusRow
Commit every
Scnarios associs
809
tPostgresPlusSCD
tPostgresPlusSCD
Le composant tPostgresPlusSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tPostgresPlusSCD, page 245.
810
tPostgresPlusSCDELT
tPostgresPlusSCDELT
Le composant tPostgresPlusSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tPostgresPlusSCDELT, page 247.
811
tPostgresqlBulkExec
tPostgresqlBulkExec
Proprits du tPostgresqlBulkExec
Les composants tPostgresqlOutputBulk et tPostgresqlBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tPostgresqlOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Famille de composant Databases/Postgresql
Le composant tPostgresqlBulkExec permet dinsrer les donnes dune base de donnes Postgresql. Le tPostgresqlBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes de la base de donnes Postgresql. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tPostgresqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes.
812
tPostgresqlBulkExec
Database Schema Username et Password Table
Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Les informations demandes seront diffrentes en fonction de laction choisie.
Action on table
File Name
Advanced settings
Action on data
Copy the OID for each Rcupre les identifiants dobjet pour chaque ligne. row Contains a header line Spcifiez que la table contient des lignes den-tte. with the names of each column in the file File type Null string Fields terminated by Escape char Text enclosure Use standard_conforming _string ON Slectionnez le type de fichiers traiter. Chane de caractres affiche pour signifier que la valeur est nulle. Caractre, chane ou expression rgulire sparant les champs. Caractre dchappement de la ligne. Caractres utiliss pour entourer le texte. Activez la variable
813
tPostgresqlBulkExec
Force not null for columns
Dfinissez la nullabilit des colonnes Force not null : Cochez la case correspondant la colonne (Column) que vous souhaitez dfinir comme ntant pas nulle.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant doit tre utilis en association avec le composant tPostgresqlOutputBulk. Ensemble, ils permettent dobtenir des gains de performances dans une base de donnes Postgresql. n/a
Limitation
Scnarios associs
Pour dautres exemples dutilisation du composant tPostgresqlBulkExec, consultez les scnarios suivants : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk, le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec, le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
814
tPostgresqlClose
tPostgresqlClose
Proprits du tPostgresqlClose
Le composant tPostgresqlClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Postgresql. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tPostgresqlConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tPostgresqlConnection et tPostgresqlRollback. Il est gnralement utilis avec un composant tPostgresqlConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tPostgresqlClose, consultez tMysqlConnection page 630
815
tPostgresqlCommit
tPostgresqlCommit
Proprits du tPostgresqlCommit
Ce composant est troitement li aux composants tPostgresqlConnection et tPostgresqlRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tPostgresqlCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Slectionnez le composant tPostgresqlConnection dans la liste sil y a plus dune connexion dans votre Job. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tPostgresqlCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Postgresql, notamment les composants tPostgresqlConnection et tPostgresqlRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tPostgresqlConnection et tPostgresqlRollback. Ils sont gnralement utiliss avec un composant tPostgresqlConnection car celui-ci permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tPostgresqlCommit, consultez tMysqlConnection page 630.
816
tPostgresqlConnection
Proprits du tPostgresqlConnection
Ce composant est troitement li aux composants tPostgresqlCommit et tPostgresqlRollback. Ils sont gnralement utiliss avec un composant tPostgresqlConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tPostgresqlConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Schema Username et Password Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.
Advanced settings
Auto commit
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Limitation Ce composant est gnralement utilis avec des composants Oracle, notamment les composants tPostgresqlCommit et tPostgresqlRollback. n/a
817
Scnario associ
Ce composant est troitement li aux composants tPostgresqlCommit et tPostgresqlRollback. Ils sont gnralement utiliss avec un composant tPostgresqlConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tPostgresqlConnection, consultez tMysqlConnection page 630
818
tPostgresqlInput
tPostgresqlInput
Proprits du tPostgresqlInput
Famille de composant Databases/ Postgresql
Fonction Objectif
Le composant tPostgresqlInput lit une base de donnes et en extrait des champs laide de requtes. Le tPostgresqlInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
Basic settings
819
tPostgresqlInput
Cochez cette case lorsque vous utilisez le composant tPostgresqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Host Port Database Schema Username et Password Schema et Edit Schema
Nom de la table lire. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.
820
tPostgresqlInput
Advanced settings
Use cursor
Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en une fois. Cette option permet doptimiser les performances. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Postgresql.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tPostgresqlInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401 Scnario 2 : Utiliser la variable StoreSQLQuery, page 403
821
tPostgresqlOutput
tPostgresqlOutput
Proprits du tPostgresqlOutput
Fonction Objectif
Le composant tPostgresqlOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tPostgresqlOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Use an existing connection Cochez cette case lorsque vous utilisez le composant tPostgresqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Basic settings
822
tPostgresqlOutput
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma. Informations dauthentification de lutilisateur de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete). Composants Talend Open Studio 823
Action on data
tPostgresqlOutput
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tPostgresqlOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Advanced settings
Commit every
Additional Columns
824
tPostgresqlOutput
Support null in SQL WHERE statement
Cochez cette case pour prendre en compte les valeurs Null dune table de base de donnes. Assurez-vous que la case Nullable est bien coche pour les colonnes du schma correspondantes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Postgresql. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ au composant tPostgresqlOutput consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du tMysqlOutput.
825
tPostgresqlOutputBulk
Proprits du tPostgresqlOutputBulk
Les composants tPostgresqlOutputBulk et tPostgresqlBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tPostgresqlOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Postgresql. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Postgresql. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Advanced settings
826
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec le composant tPostgresqlBulkExec. Ensemble ils offrent un gain de performance important pour lalimentation dune base de donnes Postgresql.
Scnarios associs
Pour un scnario associ au composant tPostgresqlOutputBulk, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
827
tPostgresqlOutputBulkExec
Proprits du tPostgresqlOutputBulkExec
Les composants tPostgresqlOutputBulk et tPostgresqlBulkExec sont gnralement utiliss ensemble comme deux parties dun processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime tape, ce fichier est utilis lors de lopration dINSERT afin de populer une base de donnes. Cette excution en deux tapes est unifie dans le composant tPostgresqlOutputBulkExec.
Fonction Objectif
Le tPostgresqlOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tPostgresqlOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Postgresql. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Schema Username et Password Table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None: neffectuer aucune opration de table. Drop and create the table: supprimer la table puis en crer une nouvelle. Create a table: crer une table qui nexiste pas encore. Create table if doesnt exist: crer la table si ncessaire. Drop a table if exists and create: supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table: supprimer le contenu de la table.
Basic settings
Action on table
828
File Name
Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Advanced settings
Action on data
Slectionnez lopration que vous voulez effectuer : Bulk insert Bulk update Les informations demandes seront diffrentes en fonction de laction choisie.
Copy the OID for each Rcupre les identifiants dobjet pour chaque ligne. row Contains a header line Spcifiez que la table contient des lignes den-tte. with the names of each column in the file Encoding Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Slectionnez le type de fichiers traiter. Chane de caractres affiche pour signifier que la valeur est nulle. Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Caractre dchappement de la ligne. Caractres utiliss pour entourer le texte. Activez le paramtre standard_conforming_string pour traiter les backslashs comme une chane ordinaire et non pas comme un caractre dchappement. Dfinissez la nullabilit des colonnes Force not null : Cochez la case correspondant la colonne (Column) que vous souhaitez dfinir comme ntant pas nulle.
File type Null string Row separator Fields terminated by Escape char Text enclosure Activate standard_conforming _string Force not null for columns
829
Scnarios associs
Pour un scnario associ au cmposant tPostgresqlOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
830
tPostgresqlRollback
tPostgresqlRollback
Proprits du tPostgresqlRollback
Ce composant est troitement li aux composants tPostgresqlCommit et tPostgresqlConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tPostgresqlRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant tPostgresqlConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants Oracle, notamment les composants tPostgresqlConnection et tPostgresqlCommit. n/a
Scnario associ
Ce composant est troitement li aux composants tPostgresqlConnection et tPostgresqlCommit. Ils sont gnralement utiliss avec un composant tPostgresqlConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tPostgresqlRollback, consultez tMysqlRollback page 674
831
tPostgresqlRow
tPostgresqlRow
Proprits du tPostgresqlRow
Fonction
Le tPostgresqlRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tPostgresqlRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tPostgresqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma
Objectif
Basic settings
832
tPostgresqlRow
Query
Die on error
Advanced settings
833
tPostgresqlRow
Commit every
Scnarios associs
834
tPostgresqlSCD
tPostgresqlSCD
Le composant tPostgresqlSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tPostgresqlSCD, page 250.
835
tPostgresqlSCDELT
tPostgresqlSCDELT
Le composant tPostgresqlSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tPostgresqlSCDELT, page 252.
836
tSASInput
tSASInput
Assurez-vous dinstaller au pralable les modules sas.core.jar, sas.intrnet.javatools.jar et sas.svc.connection.jar sous le chemin lib > java dans votre build Talend Open Studio pour pouvoir utiliser toutes les fonctionnalits des composants SAS. Vous pouvez vrifier que ces modules ont bien t installs partir de la vue Modules de votre studio.
Proprits du tSASInput
Famille de composant Databases/SAS
Fonction Objectif
Le composant tSASInput lit une base de donnes et en extrait des champs laide de requtes. Le tSASInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . Host name Port Librefs Nom ou adresse IP du serveur SAS. Port dcoute ouvrir. Renseignez le nom du rpertoire physique dans lequel est contenue la table lire, suivi de son chemin daccs. Par exemple : TpSas C:/SAS/TpSas Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.
Basic settings
837
tSASInput
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Table Name Renseignez le nom de la table lire, prfix par le nom du rpertoire physique dans lequel elle est contenue. Par exemple : TpSas.Customers. La requte peut tre construite manuellement (Built-in) pour un Job particulier ou stocke dans le Repository sil sagit dune requte frquemment utilise, pour en faciliter lutilisation. Saisissez votre requte, si elle nest pas stocke dans le Repository, en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma.
Query type
Query
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes utilisant une connexion SAS.
Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 du composant tContextLoad.
838
tSASOutput
tSASOutput
Assurez-vous dinstaller au pralable les modules sas.core.jar, sas.intrnet.javatools.jar et sas.svc.connection.jar sous le chemin lib > java dans votre build Talend Open Studio pour pouvoir utiliser toutes les fonctionnalits des composants SAS. Vous pouvez vrifier que ces modules ont bien t installs partir de la vue Modules de votre studio.
Proprits du tSASOutput
Famille de composant Databases/SAS
Le composant tSASOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tSASOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Use an existing connection Cochez cette case et slectionnez le composant tSASConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. SAS URL Driver JAR Entrez le chemin daccs la base de donnes. Slectionnez le driver JAR partir de la liste droulante ou cliquez sur les trois points [...] pour ajouter un nouveau JAR la liste. Dans le champ Class name, renseignez le nom de la classe pour quelle soit indique dans le driver. Informations dauthentification de lutilisateur de base de donnes.
Class Name Username et Password
839
tSASOutput
Table Action on data
Nom de la table lire. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete).
Clear data in table
Cochez cette case pour que les donnes soient supprimes de la table slectionne avant toute action. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Die on error
840
tSASOutput
Advanced settings
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tSASOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes utilisant une connexion SAS. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes SAS. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ au tSASOutput, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du composant tMysqlOutput.
841
tSQLiteClose
tSQLiteClose
Proprits du tSQLiteClose
Famille de composant Databases/SQLite
Le composant tSQLiteClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes SQLite. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tSQLiteConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tSQLiteConnection et tSQLiteRollback. Il est gnralement utilis avec un composant tSQLiteConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tSQLiteClose, consultez tMysqlConnection page 630
842
tSQLiteCommit
tSQLiteCommit
Proprits du tSQLiteCommit
Ce composant est troitement li aux composants tSQLiteConnection et tSQLiteRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tSQLiteCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Close connection Slectionnez le composant tSQLiteConnection dans la liste sil y a plus dune connexion dans votre Job. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tSQLiteCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants SQLite, notamment les composants tSQLiteConnection et tSQLiteRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tSQLiteConnection et tSQLiteRollback. Ils sont gnralement utiliss avec un composant tSQLiteConnection car celui-ci permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tSQLiteCommit, consultez tMysqlConnection page 630.
843
tSQLiteConnection
tSQLiteConnection
Proprits du tSQLiteConnection
Ce composant est troitement li aux composants tSQLiteCommit et tSQLiteRollback. Ils sont gnralemet utiliss avec un composant tSQLiteConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tSQLiteConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Database Table Schema Use or register a shared DB Connection Nom de la base de donnes. Nom du schma. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.
Advanced settings
Auto commit
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Limitation Ce composant est gnralement utilis avec des composants SQLite, notamment les composants tSQLiteCommit et tSQLiteRollback. n/a
844
tSQLiteConnection
Scnarios associs
Ce composant est troitement li aux composants tSQLiteCommit et tSQLiteRollback. Ils sont gnralement utiliss avec un composant tSQLiteConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tSQLiteConnection, consultez tMysqlConnection page 630
845
tSQLiteInput
tSQLiteInput
Proprits du tSQLiteInput
Fonction
Le composant tSQLiteInput lit une base de donnes et en extrait des champs laide de requtes. Un petit moteur de base de donnes SQLite lui est intgr, il na donc pas besoin dtre connect un serveur de base de donnes. Le tSQLiteInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tSQLiteConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Objectif
Basic settings
846
tSQLiteInput
Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . Database Schema et Edit Schema Chemin daccs au fichier de la base de donnes SQLite. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Query type La requte peut tre construite manuellement (Built-in) pour un Job particulier ou stocke dans le Repository sil sagit dune requte frquemment utilise, pour en faciliter lutilisation. Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes. Cochez cette case pour collecter les donnes de log au niveau du composant.
Query
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est tout fait autonome du fait de son moteur de base de donnes SQLite intgr. Il sagit dun composant de dbut pouvant initier un traitement de flux de donnes.
Scnario : Filtrer des donnes SQlite

Le scnario suivant dcrit un Job assez simple qui permet dappliquer une requte donne utilisant un filtre pour extraire des lignes partir dune base de donnes SQLite source et alimenter une table SQLite en sortie.
847
tSQLiteInput
Cliquez-dposez partir de la Palette les composants tSQLiteInput et tSQLiteOutput. Reliez le composant dentre et de sortie laide dun lien de type row Main. Dans longlet Basic settings du composant tSQLiteInput, entrez le chemin daccs ou parcourez vos dossiers jusquau fichier dentre la base de donne SQLite.
Le fichier contient des centaines de lignes et comprend une colonne ip servant de base la requte. Dans longlet Basic settings du composant tSQLiteInput, modifiez le schma afin quil corresponde la structure de la table.
Dans le champ Query, renseignez la requte choisie par rapport la colonne ip. Slectionnez les paramtres dencodage correspondants.
848
tSQLiteInput
Pour le composant tSQLiteOutput, dans le champ Database de longlet Basic settings, slectionnez le chemin daccs la base de donnes de sortie.
Dans le champ Table, renseignez le nom de la table alimenter avec les donnes slectionnes. A partir des listes droulantes Action on table et Action on Data, slectionnez les actions effectuer sur la table et sur les donnes. Dans le cas prsent, les actions sont, respectivement, Drop and create et Insert. Synchronisez le schma avec le schma dentre. Slectionnez lencodage puis dfinissez la limite de commit. Enregistrez le Job puis excutez-le en appuyant sur F6.
Les donnes slectionnes sont renvoyes vers le fichier SQLite dfini.
849
tSQLiteOutput
tSQLiteOutput
Proprits du tSQLiteOutput
Fonction
Le composant tSQLiteOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Un petit moteur de base de donnes SQLite lui est intgr, il na donc pas besoin dtre connect un serveur de base de donnes. Le tSQLiteOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tSQLiteConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
850
tSQLiteOutput
Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . Database Table Action on table Chemin daccs au fichier de la base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete).
Action on data
851
tSQLiteOutput
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tSQLiteOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Advanced settings
Commit every
Additional Columns
852
tSQLiteOutput
Utilisation
Ce composant doit absolument tre reli un composant dentre (Input). Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes SQLite. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnario associ
Pour un scnario associ au composant tSQLiteOutput, consultez tSQLiteInput page 846.
853
tSQLiteRollback
tSQLiteRollback
Proprits du tSQLiteRollback
Ce composant est troitement li aux composants tSQLiteCommit et tSQLiteConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Le tSQLiteRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant de connexion tSQLiteConnection dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants SQLite, notamment avec le tSQLiteConnection et le tSQLiteCommit. n/a
Scnario associ
Pour un scnario associ au tSQLiteRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674 du composant tMySQLRollback.
854
tSQLiteRow
tSQLiteRow
Proprits du tSQLiteRow
Fonction Objectif
Le tSQLiteRow excute une requte dfinie dans une base de donnes spcifie et utilise les paramtres de la colonne. Une requte prdfinie utilise le flux dentre pour remplacer les paramtres substituables par les valeurs dfinies pour chaque paramtre. Ce composant est trs utile quand il sagit de faire des mises jour. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tSQLiteConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Database Schema et Edit Schema Chemin daccs au fichier de la base de donnes SQLite. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository.
Basic settings
855
tSQLiteRow
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Table Name Query type Nom de la table lire. Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. Query Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. Cochez cette case pour utiliser une instance PreparedStatement afin de requter votre base de donnes. Dans le tableau Set PreparedStatement Parameter, dfinissez les valeurs des paramtres reprsents par des ? dans linstruction SQL dfinie dans le champ Query de longlet Basic settings. Parameter Index : Saisissez la position du paramtre dans linstruction SQL. Parameter Type : Saisissez le type du paramtre. Parameter Value : Saisissez la valeur du paramtre. Cette option est trs utile si vous devez effectuer de nombreuses fois la mme requte. Elle permet un gain de performance. Commit every Nombre de lignes avant le commit.
Die on error
Advanced settings
856
tSQLiteRow
Scnario : Mettre jour des lignes SQLite

Le scnario suivant dcrit un Job qui permet de mettre jour un fichier de base de donne SQLite en utilisant une requte prdfinie et un fichier dlimit.
Cliquez-dposez les composants tFileInputDelimited et tSQLiteRow. Dans longlet Basic settings du composant tFileInputDelimited, parcourez les dossiers et slectionnez le fichier dentre utiliser pour mettre jour les lignes dans la base de donnes.
Il ny a ni en-tte (Header) ni pied de page (Footer). Le sparateur de lignes (Row separator) est un retour chariot et le sparateur de champs (Field separator) un point-virgule. Modifiez le schma sil nest pas stock dans le Repository.
Assurez-vous que la longueur et le type dfinissent correctement les colonnes. Dans lespace de modlisation graphique, double-cliquez sur le composant tSQLiteRow pour afficher sa vue Component. Dans longlet Basic settings du composant tSQLiteRow, renseignez le champ Database avec le chemin daccs au fichier mettre jour.
857
tSQLiteRow
Le schma est en mode read-only puisquil doit correspondre au schma dentre. Saisissez la requte ou rcuprez-la partir du Repository. Dans le cas prsent, la colonne type_os a t mise jour en fonction de la valeur id dfinie dans le flux entrant. La requte se prsente comme suit : Update download set type_os=? where id=? Dans longlet Advanced Settings, cochez la case Use PreparedStatement pour afficher la table des paramtres substituables.
Dans la table des paramtres dentre, ajoutez autant de lignes quil y a de paramtres substituables. Dans cet exemple, dfinissez type_os et id. Renseignez le champ Commit every. Enregistrez le Job et appuyez sur F6 pour lexcuter. La table download de la base de donnes SQLite est ainsi mise jour avec le nouveau code type_os, selon le fichier dlimit dentre.
858
tSybaseBulkExec
tSybaseBulkExec
Proprits du tSybaseBulkExec
Les composants tSybaseOutputBulk et tSybaseBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tSybaseOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Le composant tSybaseBulkExec permet dinsrer les donnes dune base de donnes Sybase. Le tSybaseBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes de la base de donnes Sybase. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tSybaseConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Server Adresse IP du serveur de base de donnes.
859
tSybaseBulkExec
Port Database Username et Password Server Bcp Utility Batch size Table
Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Adresse IP du serveur de base de donnes pour la connexion de lutilitaire Bcp. Nom de lutilitaire bcp utiliser pour copier les donnes sur le serveur Sybase. Nombre de lignes dans chaque lot de traitement de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration sur la table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Action on table
File Name
Advanced settings
Action on data
Vous pouvez effectuer les actions suivantes sur la table dfinie : Bulk Insert : ajoute des entres multiples la table. Le Job sarrte lorsque des doublons sont trouvs. Bulk Update : effectue des changements simultans aux multiples entres. Caractre, chane ou expression rgulire sparant les champs.
Field Terminator
860
tSybaseBulkExec
Row Terminator Head row Encoding
Chane (ex : \n sous Unix) sparant les lignes. Nombre de lignes den-tte ignorer en dbut de fichier. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Slectionnez la sortie utiliser pour rcuprer la sortie standard de la base Sybase : to console : vers la console. to global variable : vers la variable globale.
Output
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job , ainsi quau niveau du composant. Utilisation Limitation Ce composant est gnralement utilis lorsque les donnes charger dans la base nexigent aucune transformation particulire. Contrairement au composant Oracle ddi, ce composant Sybase ne permet aucune action directe sur les donnes.
Scnarios associs
Pour un scnario associ au composant tSybaseBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
861
tSybaseClose
tSybaseClose
Proprits du tSybaseClose
Famille de composant Databases/Sybase
Le composant tSybaseClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Sybase. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tSybaseConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tSybaseConnection et tSybaseRollback. Il est gnralement utilis avec un composant tSybaseConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tSybaseClose, consultez tMysqlConnection page 630
862
tSybaseCommit
tSybaseCommit
Proprits du tSybaseCommit
Ce composant est troitement li aux composants tSybaseConnection et tSybaseRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tSybaseCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Close Connection Slectionnez le composant tSybaseCommit dans la liste sil y a plus dune connexion dans votre Job. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tSybaseCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Sybase, notamment les composants tSybaseConnection et tSybaseRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tSybaseConnection et tSybaseRollback. Ils sont gnralement utiliss avec un composant tSybaseConnection car celui-ci permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tSybaseCommit, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
863
tSybaseConnection
tSybaseConnection
Proprits du tSybaseConnection
Ce composant est troitement li aux composants tSybaseCommit et tSybaseRollback. Ils sont gnralement utiliss avec un composant tSybaseConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tSybaseConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier une fois quil est valid en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Database Table Schema Username et Password Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.
Ce composant est gnralement utilis avec des composants Oracle, notamment les composants tSybaseCommit et tSybaseRollback. n/a
Scnarios associs
Pour un scnario associ au composant tSybaseConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.
864
tSybaseInput
tSybaseInput
Proprits du tSybaseInput
Fonction Objectif
Le composant tSybaseInput lit une base de donnes et en extrait des champs laide de requtes. Le tSybaseInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez la section Configurer une connexion DB du Guide Utilisateur de Talend Open Studio .
Basic settings
865
tSybaseInput
Cochez cette case et slectionnez le composant tSybaseConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Server Port Database Sybase Schema Username et Password Schema et Edit Schema
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma Sybase. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Nom de la table lire. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.
866
tSybaseInput
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Sybase.
Scnario associ
Pour un scnario associ, consultez les scnarios du composant tDBInput : le Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401 le Scnario 2 : Utiliser la variable StoreSQLQuery, page 403 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 du tContextLoad..
867
tSybaseIQBulkExec
tSybaseIQBulkExec
Proprits du tSybaseIQBulkExec
Famille de composant Databases/SybaseIQ
Le composant tSybaseIQBulkExec permet de charger un fichier bulk dans une base de donnes Sybase IQ. Le tSybaseIQBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes de la base de donnes Sybase IQ. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tSybaseConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. DB Version Host Port Database Slectionnez la version de Sybase que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.
868
tSybaseIQBulkExec
Username et Password Table
Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration sur la table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Action on table
Local filename
Advanced settings
Lines terminated by Field Terminated by Use enclosed quotes Use fixed length
Caractre, chane ou expression rgulire sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Cochez cette case pour utiliser des caractres pour entourer les donnes. Cochez cette case pour dterminer une longueur fixe pour les lignes de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant offre la flexibilit des requtes sur les bases de donnes Sybase IQ. Contrairement au composant Oracle ddi bulk, il nest possible deffectuer aucune action sur les donnes avec ce composant ddi Sybase IQ.
869
tSybaseIQBulkExec
Scnario associ
Pour un scnario associ au tSybaseIQBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
870
tSybaseIQOutputBulkExec
Proprits du tSybaseIQOutputBulkExec
Famille de composant Databases/SybaseIQ
Le tSybaseIQOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tSybaseIQOutputBulkExec est un composant ddi, il permet un gain de performance lors du traitement des donnes de la base de donnes Sybase IQ. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tSybaseConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes.
871
Table
Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration sur la table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cochez cette case pour ajouter des lignes la fin des enregistrements. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Action on table
File Name
Append the file Schema et Edit Schema
Advanced settings
Fields terminated by Lines terminated by Use enclose quotes Include Head Encoding
Caractre, chane ou expression rgulire sparant les champs. Caractre, chane ou expression rgulire sparant les lignes. Cochez cette case pour utiliser des caractres pour entourer les donnes. Cochez cette case pour inclure len-tte des colonnes dans le fichier. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Usage Limitation Ce composant est principalement utilis lorsquaucune transformation particulire nest requise sur les donnes charger dans la base de donnes. n/a
872
Scnarios associs
Pour un scnario associ au composant tSybaseIQOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
873
tSybaseOutput
tSybaseOutput
tSybaseOutput Properties
Le composant tSybaseOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tSybaseOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
874
tSybaseOutput
Cochez cette case et slectionnez le composant tSybaseConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Server Port Database Sybase Schema Username et Password Table
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom exact du schma Sybase. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : Default : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback.
Action on table
875
tSybaseOutput
Turn on identity insert Cochez cette case pour utiliser votre propre squence sur les valeurs Identity des donnes insres (plutt que de laisser le serveur SQL choisir les valeurs squentielles). Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete. Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant la colonne sur laquelle baser votre opration de mise jour (Update). Procdez de la mme manire avec les cases Key in delete pour les oprations de suppression (Delete). Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Die on error Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects.
876
tSybaseOutput
Advanced settings
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tSybaseOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
Use field options Enable debug mode Use Batch size
Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. Cochez cette case afin dactiver le mode batch pour le traitement des donnes. Dans le champ Batch Size qui apparat, vous pouvez saisir le nombre de lignes par lot charger. Cette case est disponible uniquement si vous avez choisi loption Insert, Update, Single Insert Query ou Delete dans le champ Action on data.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Sybase. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnario associ
Pour un scnario associ au composant tSybaseOutput, consultez :
tSybaseOutput
le Scnario : Afficher la base de donnes en sortie, page 407 du tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du tMysqlOutput.
878
tSybaseOutputBulk
tSybaseOutputBulk
Proprits du tSybaseOutputBulk
Les composants tSybaseOutputBulk et tSybaseBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tSybaseOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Sybase. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Sybase. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Advanced settings
879
tSybaseOutputBulk
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec le composant tSybaseBulkExec. Ensemble ils offrent un gain de performance important pour lalimentation dune base de donnes Sybase.
Scnario associ
Pour un scnario associ au composant tSybaseOutputBulk, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
880
tSybaseOutputBulkExec
Proprits du tSybaseOutputBulkExec
Les composants tSybaseOutputBulk et tSybaseBulkExec sont gnralement utiliss ensemble comme deux parties dun processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime tape, ce fichier est utilis lors de lopration dINSERT afin de populer une base de donnes. Cette excution en deux tapes est unifie dans le composant tSybaseOutputBulkExec.
Le tSybaseOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tSybaseOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Sybase. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tSybaseConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Server Adresse IP du serveur de base de donnes.
881
Port Database Username et Password Bcp Utility Table
Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de lutilitaire bcp utiliser pour copier les donnes sur le serveur Sybase. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dInsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Action on table
File Name
Advanced settings
Action on data
Vous pouvez effectuer les actions suivantes sur la table dfinie : Bulk Insert : ajoute des entres multiples la table. Le Job sarrte lorsque des doublons sont trouvs. Bulk Update : effectue des changements simultans aux multiples entres. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes dans la base de donnes.
Field Terminator DB Row Terminator
882
First row N0 . Of File
Nombre de lignes den-tte ignorer en dbut de fichier.
FILE Row Terminator Caractre, chane ou expression rgulire sparant les lignes dans le fichier. Include Head Encoding Cochez cette case pour inclure len-tte des colonnes dans le fichier. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. to console : linformation est charge. to global variable : valeurs retournes partir de fichiers de log.
Output
Scnarios associs
Pour un scnario associ au composant tSybaseOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du tOracleBulkExec.
883
tSybaseRollback
tSybaseRollback
Proprits du tSybaseRollback
Ce composant est troitement li aux composants tSybaseCommit et tSybaseConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tSybaseRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Close Connection Slectionnez le composant tSybaseConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants Oracle, notamment les composants tSybaseConnection et tSybaseCommit. n/a
Scnario associ
Pour un scnario associ au composant tSybaseRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674.
884
tSybaseRow
tSybaseRow
Proprits du tSybaseRow
Fonction
Le tSybaseRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tSybaseRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case lorsque vous utilisez le composant tSybaseConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Server Port Database Sybase schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma Sybase.
Objectif
Basic settings
885
tSybaseRow
Username et Password Table name
Informations dauthentification de lutilisateur de base de donnes. Nom de la table lire.
Turn on identity insert Cochez cette case pour utiliser votre propre squence sur les valeurs Identity des donnes insres (plutt que de laisser le serveur SQL choisir les valeurs squentielles). Query type Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. Query Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Die on error Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column.
Advanced settings
886
tSybaseRow
Commit every
Scnario associ
Pour un scnario associ au composant tSybaseRow, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 411 du tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678 du tMySQLRow.
887
tSybaseSCD
tSybaseSCD
Le composant tSybaseSCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tSybaseSCD, page 265.
888
tSybaseSCDELT
tSybaseSCDELT
Le composant tSybaseSCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tSybaseSCDELT, page 267.
889
tSybaseSP
tSybaseSP
Proprits du tSybaseSP
Le composant tSybaseSP appelle une procdure stocke de base de donnes. Ce composant permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier des proprits du composant. Les champs suivants sont alors pr-remplis. Use an existing connection Cochez cette case lorsque vous utilisez le composant tSybaseConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Username et Password Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes.
890
tSybaseSP
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Saisissez le nom exact de la Procdure Stocke (SP). Cochez cette case, si une seule valeur doit tre retourne. Slectionnez dans la liste la colonne du schma sur laquelle est base la valeur obtenir. Dure maximale dattente des resultats de la procdure stocke. Cliquez sur le bouton (+) et slectionnez dans le champ Schema Columns les diffrentes colonnes ncessaires la procdure. Notez que le schma de la SP peut contenir plus de colonnes quil ny a de paramtres utiliss dans la procdure. Slectionnez le Type de paramtre : IN : paramtre dentre (Input) OUT : paramtre de sortie (Output)/valeur retourne IN OUT : les paramtres dentre doivent tre retournes sous forme de valeur, mme aprs modifications via la procdure (fonction). RECORDSET : les paramtres dentre doivent tre retournes sous forme densemble de valeurs, au lieu dune valeur unique. Consultez le composant tParseRecordSet si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.
Timeout Interval Parameters
Advanced settings
Use Multiple SELECT Cochez cette case pour utiliser des procures Procedure contenant plusieurs instructions SELECT. tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut. Dans ce cas, seuls les paramtres dentre sont autoriss. La syntaxe de la Procdure Stocke doit correspondre celle de la base de donnes.
891
tSybaseSP
Scnario associ
Pour un scnario associ, consultez le Scnario : Trouver le libell State laide dune procdure stocke, page 689 du composant tMysqlSP. Consultez galement le composant tParseRecordSet, page 786 si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.
892
tTeradataClose
tTeradataClose
Proprits du tTeradataClose
Famille de composant Databases/Teradata
Le composant tTeradataClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Teradata. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tTeradataConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tTeradataConnection et tTeradataRollback. Il est gnralement utilis avec un composant tTeradataConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tTeradataClose, consultez tMysqlConnection page 630
893
tTeradataCommit
tTeradataCommit
Proprits du tTeradataCommit
Ce composant est troitement li aux composants tTeradataConnection et tTeradataRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tTeradataCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Slectionnez le composant tTeradataConnection dans la liste sil y a plus dune connexion dans votre Job. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tTeradataCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Postgresql, notamment les composants tTeradataConnection et tTeradataRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tTeradataConnection et tTeradataRollback. Ils sont gnralement utiliss avec un composant tTeradataConnection car celui-ci permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tTeradataCommit, consultez tMysqlConnection page 630.
894
tTeradataConnection
tTeradataConnection
Proprits du tTeradataConnection
Ce composant est troitement li aux composants tTeradataCommit et tTeradataRollback. Ils sont gnralemet utiliss avec un composant tTeradataConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tTeradataConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Database Username et Password Additional JDBC parameters Adresse IP du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS pour supporter les caractres japonais. Dans ce champ, vous pouvez paramtrer le type dencodage. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.
Advanced settings
Auto Commit
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec des composants Teradata, notamment les composants tTeradataCommit et tTeradataRollback.
895
tTeradataConnection
Limitation
n/a
Scnario associ
Ce composant est troitement li aux composants tTeradataCommit et tTeradataRollback. Ils sont gnralement utiliss avec un composant tTeradataConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tTeradataConnection, consultez tMysqlConnection page 630
896
tTeradataFastExport
tTeradataFastExport
Proprits du tTeradataFastExport
Le composant tTeradataFastExport exporte trs rapidement des lots de donnes volumineux dune table ou dune vue Teradata. Le tTeradataFastExport exporte des lots de donnes dune table Teradata vers un systme client ou vers une base de donnes plus petite. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Execution platform Database name Username et Password Table Schema et Edit Schema Slectionnez le type de systme dexploitation que vous utilisez. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Script generated folder Exported file Field separator Error file Parcourez votre rpertoire et slectionnez la destination du fichier qui sera cr. Nom et chemin daccs au fichier qui sera cr. Caractre, chane ou expression rgulire sparant les champs. Parcourez votre rpertoire et slectionnez la destination du fichier dans lesquels seront enregistrs les messages derreur.
Advanced settings
897
tTeradataFastExport
Utilisation
Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Teradata.
Scnario associ
898
tTeradataFastLoad
tTeradataFastLoad
Proprits du tTeradataFastLoad
Fonction Objectif
Le composant tTeradataFastLoad lit une base de donnes et en extrait des champs laide de requtes. Le tTeradataFastLoad excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Database Username et Password Table Execute Batch every Die on error Adresse IP du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Nombre de lignes par lot charger. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Basic settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Teradata. Composants Talend Open Studio 899
tTeradataFastLoad
Scnario associ
900
tTeradataFastLoadUtility
Proprits du tTeradataFastLoadUtility
Fonction Objectif
Le composant tTeradataFastLoadUtility lit une base de donnes et en extrait des champs laide de requtes. Le tTeradataFastLoadUtility excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Execution platform Database name Username et Password Table Schema et Edit Schema Slectionnez le type de systme dexploitation que vous utilisez. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Script generated folder Load file Field separator Error file Parcourez votre rpertoire et slectionnez la destination du fichier qui sera cr. Entrez le nom du fichier partir duquel vous souhaitez charger les donnes. Caractre, chane ou expression rgulire sparant les champs. Parcourez votre rpertoire et slectionnez la destination du fichier dans lesquels seront enregistrs les messages derreur.
Basic settings
901
Advanced settings
Define character set Check point Error files
Spcifiez lencodage des caractres dont vous avez besoin pour utiliser votre systme. Saisissez la valeur du point de validation. Saisissez le nom du fichier dans lequel les messages derreur sont stocks. Par dfaut, le code saisi est ERRORFILES table_ERR1, ce qui signifie que les deux tables table_ERR1 et table_ERR2 sont utilises pour enregistrer les messages derreur. Cochez cette case pour spcifier le code de retour partir duquel retourner une erreur dans la console. Saisissez le nombre limite derreurs dtectes durant la phase de chargement. Le processus sarrte lorsque la limite est atteinte. Par dfaut, la valeur limite derreurs est de 1000000. Pour plus dinformations, consultez la documentation Teradata FastLoad Reference.
Return fastload error ERRLIMIT
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Teradata.
Scnario associ
Pour un scnario associ, consultez le Scnario : Insrer des donnes dans une table dune base de donnes Teradata, page 920.
902
tTeradataInput
tTeradataInput
Proprits du tTeradataInput
Fonction Objectif
Le composant tTeradataInput lit une base de donnes et en extrait des champs laide de requtes. Le tTeradataInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tSybaseConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Basic settings
903
tTeradataInput
Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Port Database Username et Password Schema et Edit Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS pour supporter les caractres japonais.Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Advanced settings
904
tTeradataInput
Scnario associ
Pour un scnario associ, consultez les scnarios du composant gnrique tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401 Scnario 2 : Utiliser la variable StoreSQLQuery, page 403 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 du tContextLoad.
905
tTeradataMultiLoad
tTeradataMultiLoad
Proprits du tTeradataMultiLoad
Fonction Objectif
Le composant tTeradataMultiLoad lit une base de donnes et en extrait des champs laide de requtes. Le tTeradataMultiLoad excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Execution platform Database name Username et Password Table Schema et Edit Schema Slectionnez le type de systme dexploitation que vous utilisez. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Script generated folder Parcourez votre rpertoire et slectionnez la destination du fichier qui sera cr.
Basic settings
906
tTeradataMultiLoad
Action to data
Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une cl de recherche sur laquelle baser les oprations Update et Delete. Il est possible de dfinir les colonnes qui agiront comme cl de recherche partir du schma, pour une utilisation de base, ou partir des options avances (Advanced settings) pour une utilisation optimise de ces oprations.
Where condition in case Delete Load file Field separator Error file
Saisissez une condition, qui, si elle est vrifie, supprimera la ligne. Entrez le nom du fichier partir duquel vous souhaitez charger les donnes. Caractre, chane ou expression rgulire sparant les champs. Parcourez votre rpertoire et slectionnez la destination du fichier dans lesquels seront enregistrs les messages derreur. Cochez cette case pour dfinir la table de log que vous souhaitez utiliser au lieu de celle par dfaut, savoir celle que vous avez dfinie dans longlet Basic settings. La syntaxe requise pour dfinir la table de log est databasename.logtablename. Ce champ vous permet de dfinir votre commande BEGIN LOAD pour lancer ou relancer une tche TPump. Vous pouvez spcifiez le nombre de sessions utiliser, la limite derreurs, ainsi que tout autre paramtre ncessaire lexcution de la tche. Pour plus dinformations, consultez la documentation Teradata MultiLoad Reference. Cochez cette case pour spcifier le code de retour partir duquel retourner une erreur dans la console. Spcifiez lencodage des caractres dont vous avez besoin pour utiliser votre systme.
Advanced settings
Define Log table
BEGIN LOAD
Return mload error Define character set
907
tTeradataMultiLoad
Scnario associ
Pour un scnario associ, consultez le Scnario : Insrer des donnes dans une table dune base de donnes Teradata, page 920.
908
tTeradataOutput
tTeradataOutput
Proprits du tTeradataOutput
Le composant tTeradataOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tTeradataOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tTeradataConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
909
tTeradataOutput
Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. Host Port Database Username et Password Table Action on table Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback. Elle n'est pas visible par dfaut, sauf si vous choisissez de crer une table partir de la liste droulante Action on table. La table crer peut tre : -SET TABLE: table ne permettant pas de dupliquer les lignes -MULTI SET TABLE : table permettant de dupliquer les lignes.
Create
910
tTeradataOutput
Action on data
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
911
tTeradataOutput
Advanced settings
Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS pour supporter les caractres japonais.Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tTeradataOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Commit every
Additional Columns
Use field options Enable debug mode Use Batch Size
Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. Nombre de lignes dans chaque lot de traitement de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Teradata. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
912
tTeradataOutput
Scnario associ
913
tTeradataRollback
tTeradataRollback
Proprits du tTeradataRollback
Ce composant est troitement li aux composants tTeradataCommit et tTeradataConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tTeradataRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant tTeradataConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants Teradata, notamment les composants tTeradataConnection et tTeradataCommit. n/a
Scnario associ
Pour un scnario associ au composant tTeradataRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674.
914
tTeradataRow
tTeradataRow
Proprits du tTeradataRow
Fonction
Le tTeradataRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tTeradataRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tTeradataConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes.
Objectif
Basic settings
915
tTeradataRow
Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Query
Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Ajoutez des informations de connexion supplmentaires ncessaires la connexion la base de donnes, afin de supporter des caractres spcifiques. Exemple : CHARSET=KANJISIS_OS pour supporter les caractres japonais.Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column.
Die on error
Advanced settings
916
tTeradataRow
Commit every
Scnario associ
917
tTeradataTPump
tTeradataTPump
Proprits du tTeradataTPump
Fonction Objectif
Le composant tTeradataTPump lit une base de donnes et en extrait des champs l'aide de requtes. Le tTeradataTPump excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Execution platform Database name Username et Password Table Schema et Edit Schema Slectionnez le type de systme dexploitation que vous utilisez. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Script generated folder Parcourez votre rpertoire et slectionnez la destination du fichier qui sera cr.
Basic settings
918
tTeradataTPump
Action to data
Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Delete : Supprimer les entres correspondantes au flux dentre. Il est ncessaire de spcifier au minimum une cl de recherche sur laquelle baser les oprations Update et Delete. Il est possible de dfinir les colonnes qui agiront comme cl de recherche partir du schma, pour une utilisation de base, ou partir des options avances (Advanced settings) pour une utilisation optimise de ces oprations.
Where condition in case Delete Load file Field separator Error file
Saisissez une condition, qui, si elle est vrifie, supprimera la ligne. Entrez le nom du fichier partir duquel vous souhaitez charger les donnes. Caractre, chane ou expression rgulire sparant les champs. Parcourez votre rpertoire et slectionnez la destination du fichier dans lesquels seront enregistrs les messages derreur. Cochez cette case pour dfinir la table de log que vous souhaitez utiliser au lieu de celle par dfaut, savoir celle que vous avez dfinie dans longlet Basic settings. La syntaxe requise pour dfinir la table de log est databasename.logtablename. Ce champ vous permet de dfinir votre commande BEGIN LOAD pour lancer ou relancer une tche TPump. Vous pouvez spcifiez le nombre de sessions utiliser, la limite derreurs, ainsi que tout autre paramtre ncessaire lexcution de la tche. La valeur par dfaut est : SESSIONS 8 PACK 600 ARRAYSUPPORT ON CHECKPOINT 60 TENACITY 2 ERRLIMIT 1000. Pour plus dinformations, consultez la documentation Teradata Parallel Data Pump Reference. Cochez cette case pour spcifier le code de retour partir duquel retourner une erreur dans la console. Spcifiez lencodage des caractres dont vous avez besoin pour utiliser votre systme.
Advanced settings
Define Log table
BEGIN LOAD
Return tpump error Define character set
919
tTeradataTPump
Scnario : Insrer des donnes dans une table dune base de donnes Teradata
Dans ce scnario, lobjectif est de crer un Job utilisant le composant tTeradataTPump pour insrer des donnes clients dans une table dune base de donnes Teradata et retourner la valeur de retour lorsquune erreur se produit. Trois composants sont utiliss pour implmenter cette tche : tRowGenerator : gnre autant de lignes que ncessaire, en utilisant au hasard des donnes clients prises dans une liste. tFileOutputDelimited : crit les donnes clients dans un fichier dlimit. tTeradataTPump : insre les donnes clients dans la table de la base de donnes Teradata en mode Tpump.
Dposez les composants suivants de la Palette dans lespace de modlisation graphique : tRowGenerator, tFileOutputDelimited, tTeradataTPump. Liez le tRowGenerator au tFileOutputDelimited laide dun lien Row > Main. Liez le tRowGenerator au tTeradataTPump laide dun lien Trigger > OnSubjobOk. Double-cliquez sur le tRowGenerator pour ouvrir la fentre RowGenerator Editor. Dans la fentre tRowGenerator Editor, dfinissez les donnes gnrer. Pour ce Job, le schma se compose de deux colonnes : ID et Name.
920
tTeradataTPump
Dans le champ Number of Rows for RowGenerator, saisissez le nombre de lignes gnrer, 100 dans cet exemple. Double-cliquez sur le tFileOutputDelimited afin dafficher sa vue Component et dfinir ses proprits. A ct du champ File Name, parcourez votre rpertoire jusquau fichier de sortie, ou saisissez un nom pour le fichier crer. Entre guillemets doubles, saisissez les sparateurs utiliser, ct des champs Row Separator et Field Separator, par exemple \n et un point-virgule.
Cliquez sur Edit schema et vrifiez que le schma est retrouv partir du schma dentre. Au besoin, cliquez sur Sync Columns. Double-cliquez sur le composant tTeradataTPump afin douvrir sa vue Component. Dans longlet Basic settings de la vue Component, dfinissez les paramtres du composant tTeradataTPump.
921
tTeradataTPump
Saisissez le nom de la base de donnes dans le champ Database name, votre identifiant de connexion la base de donnes dans le champ User name, et votre mot de passe dans le champ Password. Spcifiez la table dans laquelle insrer les donnes clients. Dans ce scnario, la table est mytable. Dans les champs Script generated folder, Load file et Error file, spcifiez le rpertoire respectivement au dossier dans lequel vous stockez les fichiers de scripts gnrs. Dans le champ Load File, spcifiez le fichier contenant les donnes clients insrer. Dans le champ Error file, spcifiez le fichier contenant les informations concernant les erreurs. Dans le champ Action on data, slectionnez loption Insert. Appuyez sur F6 pour excuter le Job. La console de la vue Run saffiche ainsi :
Double-cliquez sur le composant tTeradataTPump pour retourner sa vue Component.
922
tTeradataTPump
Dans longlet Advanced settings, cochez la case Return tpump error et saisissez le code de retour partir duquel retourner une erreur dans la console. Dans cet exemple, saisissez le chiffre 4 et utilisez les valeurs par dfaut pour les autres paramtres.
Appuyez sur F6 pour excuter le Job. La console de la vue Run saffiche ainsi :
Une erreur se produit et le TPump retourne le code de retour, de 12. Si vous avez besoin dinformations dtailles concernant les informations dtailles de lerreur, vous pouvez ouvrir le ficheir de log stock dans le rpertoire spcifi dans le champd Error file et dans longlet Basic settings de la vue Component.
923
tVectorWiseCommit
tVectorWiseCommit
Proprits du tVectorWiseCommit
Ce composant est troitement li aux composants tVectorWiseConnection et tVectorWiseRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/VectorWise
Fonction Objectif
Le composant tVectorWiseCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tVectorWiseConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tVectorWiseCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants VectorWise et notamment avec les composants tVectorWiseConnection et tVectorWiseRollback. n/a
Limitation
Scnario associ
Ce composant est troitement li aux composants tVectorWiseConnection et tVectorWiseRollback. Ils sont gnralement utiliss avec un composant tVectorWiseConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tVectorWiseCommit, consultez tVerticaConnection page 944.
924
tVectorWiseConnection
Proprits du tVectorWiseConnection
Ce composant est troitement li aux composants tVectorWiseCommit et tVectorWiseRollback. Ils sont gnralemet utiliss avec un composant tVectorWiseConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tVectorWiseConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Server Port Database Username et Password Use or register a shared DB Connection Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration.
Advanced settings
Auto Commit
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est gnralement utilis avec des composants VectorWise, notamment les composants tVectorWiseCommit et tVectorWiseRollback. n/a
925
Scnario associ
Ce composant est troitement li aux composants tVectorWiseCommit et tVectorWiseRollback. Ils sont gnralement utiliss avec un composant tVectorWiseConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tVectorWiseConnection, consultez tMysqlConnection page 630
926
tVectorWiseInput
tVectorWiseInput
Proprits du tVectorWiseInput
Fonction Objectif
Le composant tVectorWiseInput lit une base de donnes et en extrait des champs laide de requtes. Le tVectorWiseInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
Basic settings
927
tVectorWiseInput
Cochez cette case et slectionnez le composant tVectorWiseConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Server Port Database Username et Password Schema et Edit Schema
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Saisissez le nom de la table. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.
928
tVectorWiseInput
Guess Query
Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Cliquez sur le bouton pour rcuprer le schma de la table. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres. Dans la colonne Column, saisissez le nom de la colonne dans laquelle supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.
Guess schema Advanced settings Trim all the String/Char columns Trim column
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes VectorWise.
Scnario associ
Pour un scnario associ, consultez les scnarios du composant gnrique tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401 Scnario 2 : Utiliser la variable StoreSQLQuery, page 403 Consultez galement le Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426 du tContextLoad.
929
tVectorWiseOutput
tVectorWiseOutput
Proprits du tVectorWiseOutput
Fonction Objectif
Le composant tVectorWiseOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tVectorWiseOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio.
Basic settings
930
tVectorWiseOutput
Cochez cette case et slectionnez le composant tVectorWiseConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table.
931
tVectorWiseOutput
Action on data
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Die on error
932
tVectorWiseOutput
Advanced settings
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tTeradataOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
Additional Columns
Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. Cochez cette case pour prendre en compte les valeurs Null dune table de base de donnes. Assurez-vous que la case Nullable est bien coche pour les colonnes du schma correspondantes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes VectorWise. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnario associ
Pour un scnario associ, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du composant tDBOutput.
933
tVectorWiseOutput
le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du composant tMySQLOutput.
934
tVectorWiseRollback
tVectorWiseRollback
Proprits du tVectorWiseRollback
Ce composant est troitement li aux composants tVectorWiseCommit et tVectorWiseConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tVectorWiseRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Slectionnez le composant tVectorWiseConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants VectorWise, notamment les composants tVectorWiseConnection et tVectorWiseCommit. n/a
Limitation
Scnario associ
Pour un scnario associ au composant tVectorWiseRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674.
935
tVectorWiseRow
tVectorWiseRow
Proprits du tVectorWiseRow
Fonction
Le tVectorWiseRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tVectorWiseRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connection Cochez cette case et slectionnez le composant tVectorWiseConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinis. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes.
Objectif
Basic settings
936
tVectorWiseRow
Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Guess Query
Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Cochez cette case pour insrer les rsultats de la requte dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column.
Query
Die on error
Advanced settings
937
tVectorWiseRow
Commit every
Scnario associ
938
tVerticaBulkExec
tVerticaBulkExec
Proprits du tVerticaBulkExec
Les composants tVerticaOutputBulk et tVerticaBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tVerticaOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le changement des donnes dans la base de donnes.
Famille de composant Databases/Vertica
Le composant tVerticaBulkExec effectue une action dInsert sur les donnes fournies. Le tVerticaBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Vertica. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version Use an existing connection Slectionnez dans la liste la version de Vertica que vous utilisez. Cochez cette case lorsque vous utilisez un composant tVerticaConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Adresse IP du serveur de base de donnes
939
tVerticaBulkExec
Port Database Username et Password Action on table
Numro du port dcoute du serveur de base de donnes Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Nom de la table crire. Notez quune seule table peut tre crite la fois. Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Remote Filename
Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cochez cette case pour stocker les donnes dans une mmoire physique, et ainsi optimiser la lecture de ces donnes, puisquelles seront compresses et pr-tries. Le Job sarrte automatiquement si aucune ligne na t charge. Caractre, chane ou expression rgulire sparant les champs. Chane de caractres affiche pour signifier que la valeur est nulle.
Advanced settings
Write to ROS (Read Optimized Store)
Exit job if no row was loaded Fields terminated by Null string
940
tVerticaBulkExec
Utilisation
Ce composant est gnralement utilis avec un composant tVerticaOutputBulk. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes Vertica.
Scnarios associs
Pour un scnario associ au composant tVerticaBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du composant tMysqlOutputBulkExec. le Scnario : Supprimer et insrer des donnes dans une base Oracle, page 726 du composant tOracleBulkExec.
941
tVerticaClose
tVerticaClose
Proprits du tVerticaClose
Le composant tVerticaClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Vertica. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tVerticaConnection dans la liste.
Scnario associ
Ce composant est troitement li aux composants tVerticaConnection et tVerticaRollback. Il est gnralement utilis avec un composant tVerticaConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tVerticaClose, consultez tMysqlConnection page 630
942
tVerticaCommit
tVerticaCommit
Proprits du tVerticaCommit
Ce composant est troitement li aux composants tVerticaConnection et tVerticaRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tVerticaCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tVerticaConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tVerticaCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
Close connection
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Vertica et notamment avec les composants tVerticaConnection et tVerticaRollback. n/a
Scnario associ
Ce composant est troitement li aux composants tVerticaConnection et tVerticaRollback. Ils sont gnralement utiliss avec un composant tVerticaConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tVerticaCommit, consultez tVerticaConnection page 944.
943
tVerticaConnection
tVerticaConnection
Proprits du tVerticaConnection
Ce composant est troitement li aux composants tVerticaCommit et tVerticaRollback. Ils sont gnralemet utiliss avec un composant tVerticaConnection car il permet douvrir une connexion pour la transaction en cours.
Le composant tVerticaConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version Host Port Database Table Schema Username et Password Use or register a shared DB Connection Slectionnez dans la liste la version de Vertica que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma. Informations dauthentification de lutilisateur de base de donnes. Cochez cette case pour partager votre connexion ou rcuprer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Vertica, notamment les composants tVerticaCommit et tVerticaRollback. n/a
944
tVerticaConnection
Scnario associ
Ce composant est troitement li aux composants tVerticaCommit et tVerticaRollback. Ils sont gnralement utiliss avec un composant tVerticaConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tVerticaConnection, consultez tMysqlConnection page 630
945
tVerticaInput
tVerticaInput
Proprits du tVerticaInput
Fonction Objectif
Le composant tVerticaInput lit une base de donnes et en extrait des champs laide de requtes. Le tVerticaInput excute une requte en base de donnes selon un ordre strict qui doit correspondre celui dfini dans le schma. La liste des champs rcupre est ensuite transmise au composant suivant via une connexion de flux (Main row). Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . DB Version Slectionnez dans la liste la version de Vertica que vous utilisez.
Basic settings
946
tVerticaInput
Cochez cette case lorsque vous utilisez le composant tVerticaConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Host Port Database Username et Password Schema et Edit Schema
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant (Repository). Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Nom de la table lire. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes contenant des chanes de caractres.
Advanced settings
Trim all the String/Char columns
947
tVerticaInput
Trim column
Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Vertica.
Scnarios associs
Voir galement les scnarios du tDBInput : Scnario 1 : Afficher les donnes slectionnes partir dune table, page 401. Scnario 2 : Utiliser la variable StoreSQLQuery, page 403. Voir galement le scnario du tContextLoad, Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426.
948
tVerticaOutput
tVerticaOutput
Proprits du tVerticaOutput
Le composant tVerticaOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tVerticaOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. DB Version Slectionnez dans la liste la version de Vertica que vous utilisez.
949
tVerticaOutput
Cochez cette case lorsque vous utilisez le composant tVerticaConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio.
Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : Default : neffectuer aucune opration de table. Drop and create table : supprimer la table puis en crer une nouvelle. Create table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear table : supprimer le contenu de la table.
950
tVerticaOutput
Action on data
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Die on error
951
tVerticaOutput
Advanced settings
Commit every
Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cochez cete case afin darrter lopration de copie (Copy) sur les donnes si une ligne est rejete et annule cette opration. Ainsi, aucune donne nest traite.
Abort on error Paramtres Copy Cette zone est uniquement disponible si vous avez choisi Copy dans la liste Action on data. Pour des informations plus dtailles concernant les paramtres Copy, consultez votre Manuel de Rfrence Vertica SQL. Maximum rejects
Saisissez un nombre afin de configurer la commande REJECTMAX utilise par Vertica, qui indique la limite maximale du nombre denregistrements logiques rejeter avant quun chargement nchoue. Si ce nombre nest pas spcifi ou si sa valeur est 0, le nombre de rejets autoriss est illimit. Cochez cette case pour empcher lopration actuelle de committer automatiquement. Saisissez le chemin daccs, ou parcourez et slectionnez le fichier dans lequel sont crits les messages indiquant le nombre de lignes dentre et la raison de chaque rejet denregistrement de donnes. Indiquez quel est le nud du fichier dexception. Si ce champ nest pas renseign, le nud de linitiateur de la requte est choisi par dfaut. Saisissez le chemin daccs, ou parcourez et slectionnez le fichier dans lequel seront crites les lignes rejetes. Ce fichier pourra ensuite tre modifi afin de rsoudre des problmes, et pourra tre regnr. Indiquez quel est le nud du fichier des donnes rejetes. Si ce champ nest pas renseign, le nud de linitiateur de la requte est choisi par dfaut. Cochez cette case afin dactiver le mode batch pour le traitement des donnes. Dans le champ Batch Size qui apparat, vous pouvez saisir le nombre de lignes par lot charger. Cette case est disponible uniquement si vous avez choisi loption Insert, Update, Single Insert Query ou Delete dans le champ Action on data.
No commit Exception file
Exception file node
Rejected data file
Rejected data file node Use Batch mode
952
tVerticaOutput
Additional Columns
Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tVerticaOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes Vertica. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez le Scnario 3 : Rcuprer les donnes errones laide dun lien Reject, page 659 du composant tMysqlOutput.
Scnarios associs
Pour un scnario associ au composant tVerticaOutput, consultez : le Scnario : Afficher la base de donnes en sortie, page 407 du composant tDBOutput. le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du composant tMySQLOutput.
953
tVerticaOutputBulk
tVerticaOutputBulk
Proprits du tVerticaOutputBulk
Les composants tVerticaOutputBulk et tVerticaBulkExec sont gnralement utiliss ensemble pour dune part gnrer en sortie le fichier qui sera dautre part utilis comme paramtre dans lexcution de la requte SQL nonce. Cette excution en deux tapes est unifie dans le composant tVerticaOutputBulkExec, dtaill dans une section spare. Lintrt de proposer deux composants spars rside dans le fait que cela permet de procder des transformations avant le chargement des donnes dans la base de donnes.
Ecrit un fichier compos de colonnes et bas sur le dlimiteur dfini et sur les standards Vertica. Prpare le fichier utiliser comme paramtre dans la requte INSERT servant alimenter une base de donnes Vertica. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Advanced settings
954
tVerticaOutputBulk
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Ce composant est gnralement utilis avec le composant tVerticaBulkExec. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donnes Vertica.
Scnarios associs
Pour un scnario associ au tVerticaOutputBulk, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec.
955
tVerticaOutputBulkExec
Proprits du tVerticaOutputBulkExec
Les composants tVerticaOutputBulk et tVerticaBulkExec sont gnralement utiliss ensemble comme deux parties dun processus en deux tapes. Dans la premire tape, un fichier de sortie est gnr. Dans la deuxime tape, ce fichier est utilis lors de lopration dINSERT afin de populer une base de donnes. Cette excution en deux tapes est unifie dans le composant tVerticaOutputBulkExec.
Le composant tVerticaOutputBulkExec effectue une action dInsert sur les donnes fournies. Le tVerticaOutputBulkExec est un composant ddi qui permet un gain de performance pendant les oprations dInsert dans une base de donnes Vertica. Property Type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version Host Port DB Name Username et Password Table Slectionnez dans la liste la version de Vertica que vous utilisez. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Informations dauthentification de lutilisateur de base de donnes. Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit dj exister pour que lopration dinsert soit autorise. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository.
Action on table
956
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. File Name Nom du fichier traiter. Voir galement :Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Cochez cette case pour stocker les donnes dans une mmoire physique, et ainsi optimiser la lecture de ces donnes, puisquelles seront compresses et pr-tries. Le Job sarrte automatiquement si aucune ligne na t charge. Caractre, chane ou expression rgulire sparant les champs. Chane de caractres affiche pour signifier que la valeur est nulle. Cochez cette case pour inclure len-tte des colonnes dans le fichier. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
Append Advanced settings Write to ROS (Read Optimized Store)
Exit job if no row was loaded Field Separator Null string Include header Encoding
Scnarios associs
Pour un scnario associ au tVerticaOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk. le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec.
957
tVerticaRollback
tVerticaRollback
Proprits du tVerticaRollback
Ce composant est troitement li aux composants tVerticaCommit et tVerticaConnection. Ils sont gnralement utiliss ensemble lors dune transaction.
Le tVerticaRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Close Connection Slectionnez le composant tVerticaConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec dautres composants Oracle, notamment les composants tVerticaConnection et tVerticaCommit. n/a
Scnario associ
Pour un scnario associ au composant tVerticaRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674.
958
tVerticaRow
tVerticaRow
Proprits du tVerticaRow
Fonction
Le tVerticaRow est le composant spcifique ce type de base de donnes. Il excute des requtes SQL dclares sur la base de donnes spcifie. Le suffixe Row signifie que le composant met en place un flux dans le Job bien que ce composant ne produise pas de donnes en sortie. Selon la nature de la requte et de la base de donnes, tVerticaRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB version Use an existing connection Slectionnez la version de Vertica que vous utilisez. Cochez cette case lorsque vous utilisez le composant tVerticaConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.
Objectif
Basic settings
959
tVerticaRow
Schema Username et Password Schema et Edit Schema
Nom exact du schma. Informations dauthentification de lutilisateur de base de donnes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Query
Die on error
Advanced settings
960
tVerticaRow
Commit every
Scnario associ
Pour un scnario associ au composant tVerticaRow, consultez : le Scnario : Rinitialiser lauto-incrmentation dune base de donnes, page 411 du tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678 du tMySQLRow.
961
tVerticaRow
962
Composants ELT
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille ELT de la Palette de Talend Open Studio. La famille ELT regroupe les connecteurs de bases de donnes les plus courants, ainsi que des composants de traitement, tous ddis au mode ELT dans lequel les SGBD cibles deviennent des outils de transformation. Ce mode supporte les bases de donnes les plus courantes, comme Teradata, Oracle, Vertica, Netezza, Sybase, etc.
Composants ELT
tELTJDBCInput
tELTJDBCInput
Proprits de tELTJDBCInput
Les composants tELTJDBCInput, tELTJDBCOutput, et tELTJDBCMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base JDBC afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Famille de composant ELT
Fournit le schma de la table dentre la commande SQL qui sera excute. Permet dajouter autant de tables que ncessaires dans une commande Insert qui peut tre complexe. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Le schma dfini est ensuite pass au composant ELT Mapper afin de lutiliser dans la commande SQL Insert Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Default Table Name Saisissez le nom de la table par dfaut.
Default Schema Name Saisissez le nom du schma par dfaut. Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant. Lutilisation du composant tELTJDBCInput est troitement lie celle du tELTJDBCMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Utilisation
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTJDBCInput, consultez les scnarios suivants du composant tELTMysqlMap :
Composants ELT
tELTJDBCInput
Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 981. Scnario 2 : ELT utilisant une table Alias, page 985.
965
Composants ELT
tELTJDBCMap
tELTJDBCMap
Proprits de tELTJDBCMap
Les composants tELTJDBClInput, tELTJDBCOutput, et tELTJDBCMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base JDBC afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. ELT JDBC Map Editor Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
966
Composants ELT
tELTJDBCMap
Style link
Slectionnez le type daffichage des liens. Auto : par dfaut, les liens entre les schmas dentre et de sortie et les paramtres du service Web sont en forme de courbe. Bezier curve : les liens entre les schmas et les paramtres du service Web sont en forme de ligne. Line : les liens entre les schmas et les paramtres du service Web sont en forme de lignes droites. Cette option vous permettra doptimiser les performances. Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes.
Property type
Host Port Database Username et Password Advanced settings Additional JDBC parameters
Adresse IP du serveur de base de donnes Numro de port dcoute du serveur de la base. Nom de la base de donnes Donnes dauthentification de lutilisateur de la base Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant. Utilisation Lutilisation du composant tELTJDBCMap est troitement lie celle des composants tELTJDBCInput et tELTJDBCOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios associs, consultez les scnarios suivants du composant tELTMysqlMap : Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 981. Scnario 2 : ELT utilisant une table Alias, page 985.
967
Composants ELT
tELTJDBCOutput
tELTJDBCOutput
Proprits de tELTJDBCOutput
Les composants tELTJDBCInput, tELTJDBCOutput, et tELTJDBCMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base MSSql afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Famille du composant ELT
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert dans la base de donnes JDBC. Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Update : Met jour des lignes existantes. Delete : Supprime les entres correspondantes au flux dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Where clauses for (for UPDATE and DELETE only) Default Table Name Saisissez la clause permettant de filtrer les donnes mettre jour ou supprimer lors des oprations de mise jour ou de suppression. Saisissez le nom de la table par dfaut, entre guillemets doubles.
Default Schema Name Saisissez le nom du schma par dfaut, entre guillemets doubles. Use different table name Advanced settings Cochez cette case afin de dfinir le nom dune table de sortie diffrente, entre guillemets doubles, dans le champ Table name qui apparat.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau du composant.
968
Composants ELT
tELTJDBCOutput
Utilisation
Lutilisation du composant tELTJDBCOutput est troitement lie celle des composants tELTJDBCInput et tELTJDBCMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTJDBCOutput, consultez les scnarios suivants du composant tELTJDBCMap : Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 981. Scnario 2 : ELT utilisant une table Alias, page 985.
969
Composants ELT
tELTMSSqlInput
tELTMSSqlInput
Proprits de tELTMSSqlInput
Les composants tELTMSSqlInput, tELTMSSqlOutput, et tELTMSSqlMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base MSSql afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Default Schema Name Saisissez le nom du schma par dfaut. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTMSSqlInput est troitement lie celle du tELTMSSqlMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTMSSqlInput, consultez les scnarios suivants du composant tELTMysqlMap :
970
Composants ELT
tELTMSSqlInput
971
Composants ELT
tELTMSSqlMap
tELTMSSqlMap
Proprits de tELTMSSqlMap
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. Use an existing connection Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. ELT MSSql Map Editor Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
972
Composants ELT
tELTMSSqlMap
Style link
Property type
Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur de la base. Nom de la base de donnes. Donnes dauthentification de lutilisateur de la base. Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau du composant. Utilisation Lutilisation du composant tELTMSSqlMap est troitement lie celle des composants tELTMSSqlInput et tELTMSSqlOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
973
Composants ELT
tELTMSSqlOutput
tELTMSSqlOutput
Proprits de tELTMSSqlOutput
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert dans la base de donnes MSSql. Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Update : Met jour des lignes existantes. Delete : Supprime les entres correspondantes au flux dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Where clauses for (for UPDATE and DELETE only) Default Table Name Saisissez la clause permettant de filtrer les donnes mettre jour ou supprimer lors des oprations de mise jour ou de suppression. Saisissez le nom de la table par dfaut, entre guillemets doubles.
Default Schema Name Saisissez le nom du schma par dfaut, entre guillemets doubles. Use different table name Advanced settings Cochez cette case afin de dfinir le nom dune table de sortie diffrente, entre guillemets doubles, dans le champ Table name qui apparat.
974
Composants ELT
tELTMSSqlOutput
Utilisation
Lutilisation du composant tELTMSSqlOutput est troitement lie celle des composants tELTMSSqlInput et tELTMSSqlMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTMSSqlOutput, consultez les scnarios suivants du composant tELTMysqlMap : Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 981. Scnario 2 : ELT utilisant une table Alias, page 985.
975
Composants ELT
tELTMysqlInput
tELTMysqlInput
Proprits de tELTMysqlInput
Les composants tELTMysqlInput, tELTMysqlOutput, et tELTMysqlMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base MySQL afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fournit le schma de la table dentre la commande SQL qui sera excute. Permet dajouter autant de tables que ncessaires dans une commande Insert qui peut tre complexe. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Le schma dfini est ensuite pass au composant ELT Mapper afin de lutiliser dans la commande SQL Insert Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Default Table Name Saisissez le nom de la table par dfaut, entre guillemets doubles.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau du composant. Lutilisation du composant tELTMysqlInput est troitement lie celle du tELTMysqlMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant le composant tELTMysqlInput, consultez les scnarios suivants du composant tELTMysqlMap :
976
Composants ELT
tELTMysqlInput
977
Composants ELT
tELTMysqlMap
tELTMysqlMap
Proprits de tELTMysqlMap
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. DB Version Use an existing connection Slectionnez la version de MySQL que vous utilisez. Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. ELT Mysql Map editor Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
978
Composants ELT
tELTMysqlMap
Style link
Property type
Host Port Database Username et Password Preview
Adresse IP du serveur de base de donnes Numro de port dcoute du serveur de la base. Nom de la base de donnes Donnes dauthentification de lutilisateur de la base Laperu est un clich des donnes traites dans le Mapper. Il apparat lorsque les proprits du Mapper ont t compltes. La synchronisation de laperu nest disponible quaprs avoir enregistrer les modifications.
Utilisation
Lutilisation du composant tELTMysqlMap est troitement lie celle des composants tELTMysqlInput et tELTMysqlOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
979
Composants ELT
tELTMysqlMap
Connecter les composants ELT

Les composants ELT ne traitent pas les donnes en tant que telles mais les informations du schma descriptif de la table qui seront utilises pour alimenter les paramtres de la requte SQL excuter. Par consquent la connexion requise pour relier ces diffrents composants est simplement un lien qui porte le nom de la table.
Le nom de la sortie que vous donnez ce lien lors de sa cration doit correspondre exactement au nom de la table car ce paramtre sera utilis lors de la gnration de la commande SQL.
Voir galement : Connexion de type Link du Guide Utilisateur Talend Open Studio
Tables de jointure et de correspondance

Dans le Mapper ELT, vous pouvez slectionner des colonnes spcifiques des schmas dentre et les ajouter dans le schma de sortie. De la mme manire que dans lditeur du Mapper ETL, simplement glissez et dposez le contenu du schma dentre vers le schma de sortie. Utilisez les touches Ctrl et Maj pour la slection multiple des colonnes contigus ou non. Vous pouvez mettre en place des jointures explicites pour extraire des donnes varies de diffrentes tables. Cliquez sur la liste droulante Join et slectionnez une jointure explicite. Les jointures suivantes sont disponibles : Inner Join, Left Outer Join, Right Outer Join ou Full Outer Join et Cross Join. Par dfaut la jointure interne (Inner Join) est slectionne. Vous pouvez galement crer des tables Alias afin de slectionner des donnes varies dans une mme table. Dans la zone Input, cliquez sur le bouton plus [+] pour crer un Alias. Dfinissez la table sur laquelle lalias est bas. Saisissez un nom pour la table alias, de prfrence veillez ce quil soit diffrent de la table principale pour viter les confusions.
Ajouter des clauses WHERE

Vous pouvez galement restreindre la requte Select laide dune clause WHERE. Cliquez sur le bouton Add filter row situ en haut de la table de sortie et saisissez la condition que vous souhaitez appliquer. Veillez ce que les composants dentre soient tous lis correctement au composant ELT Map pour garantir que les inclusions, jointures et clauses fonctionnent.
980
Composants ELT
tELTMysqlMap
Gnrer la requte SQL

La mise en correspondance des lments partir des schmas dentre vers les schmas de sortie cre automatiquement la requte Select correspondante.
Les ventuelles clauses sont galement prises en compte automatiquement.
Scnario 1 : Agrger les colonnes dune table et appliquer un filtre

Le scnario suivant dcrit un Job rassemblant plusieurs schmas dune table de base de donnes en entre puis utilise une clause dans la requte SQL afin de filtrer les donnes en sortie.
Cliquez et dposez les composants suivants de la Palette dans lespace de modlisation graphique : trois tELTMysqlIntput, un tELTMysqlMap, et un tELTMysqlOutput. Double-cliquez sur le premier tELTMysqlInput afin dafficher sa vue Basic settings.
981
Composants ELT
tELTMysqlMap
Dans la liste Schema, slectionnez Repository, cliquez sur le bouton [...] ct du champ Edit schema. Dans la bote de dialogue [Repository Content], slectionnez votre connexion la base de donnes ainsi que le schma souhait. Le nom du schma slectionn apparat automatiquement dans le champ Default Table Name. Dans ce scnario, la connexion la base de donnes est Talend_MySQL et le schma pour le premier composant dentre est owners. Configurez les deuxime et troisime composants tELTMysqlInput de la mme manire, mais slectionnez cars et resellers respectivement comme nom de schma.
Dans ce scnario, tous les schmas dentre sont stocks dans la zone Metadata du Repository, afin que vous les retrouviez facilement. Pour plus dinformations concernant les mtadonnes, consultez Centraliser les mtadonnes, dans le Guide Utilisateur de Talend Open Studio. Vous pouvez galement slectionner les trois composants dentre en dposant les schmas correspondants de la zone Metadata dans lespace de modlisation graphique et en double-cliquant sur le composant tELTMysqlInput dans le bote de dialogue [Components]. Cela vous permet dviter les tapes de nommage des composants et de dfinition de leur schma.
Reliez les trois composants tELTMysqlInput au composant tELTMysqlMap laide de liens nomms strictement selon le nom des tables de la base de donnes : owners, cars et resellers. Reliez ensuite le composant tELTMysqlMap au tELTMysqlOutput et nommez le lien agg_result, qui est le nom de la table de la base de donnes dans laquelle vous allez sauvegarder le rsultat de lagrgation. Cliquez sur le composant tELTMysqlMap afin dafficher sa vue Basic settings et configurer ses proprits.
982
Composants ELT
tELTMysqlMap
Slectionnez Repository dans la liste Property Type et slectionnez la connexion la base de donnes utilise pour les composants dentre. Toutes les informations de la base de donnes sont automatiquement rcupres. Laissez les paramtres configurs par dfaut Double-cliquez sur le composant tELTMysqlMap afin douvrir le Map Editor pour mettre en place les jointures entre les tables dentre (Input) et configurer le flux de sortie.
Ajoutez les tables dentre en cliquant sur le bouton [+] dans le coin suprieur gauche de lditeur et slectionnez les noms des tables correspondants dans la bote de dialogue [Add a new alias]. Glissez-dposez la colonne ID_Owner partir de la table owners vers la colonne correspondante dans la table cars. Dans la table cars, cochez la case Explicit Join en face de ID_Owners. Une jointure INNER JOIN, le type de jointure par dfaut, saffiche dans la liste des jointures. Glissez la colonne ID_Resellers partir de la table cars vers la colonne correspondante de la table Resellers pour mettre en place la seconde jointure. Dfinissez nouveau une option de jointure INNER JOIN. Puis slectionnez les colonnes agrger dans la table de sortie, agg_result. Dposez les colonnes ID_Owners, Name et ID_Insurance de la table owners dans la table de sortie. Dposez les colonnes Registration, Make et Color de la table cars dans la table de sortie. Dposez les colonnes Name_Reseller et City de la table resellers dans la table de sortie. Avec les colonnes correspondantes slectionnes, la mise en correspondance apparat en jaune et les jointures en violet. Appliquez un filtre sur la table de sortie. Cliquez sur le bouton Add filter row en haut de la table de sortie afin dafficher le champ textuel Additional clauses, dposez la colonne City de la table resellers dans le champ textuel puis dfinissez la clause WHERE : resellers.City =Augusta.
Composants ELT
tELTMysqlMap
Cliquez sur longlet Generated SQL Select query afin dafficher linstruction SQL correspondante.
Cliquez OK pour sauvegarder le paramtrage de lELT Map. Double-cliquez sur le composant tELTMysqlOutput afin dafficher sa vue Basic settings.
984
Composants ELT
tELTMysqlMap
Dans la liste Action on data slectionnez laction que vous souhaitez effectuer sur les donnes. Slectionnez Repository dans la liste Schema et dfinissez le schma de sortie de la mme manire que pour les schmas dentre. Notez que le schma de sortie doit tre nomm comme la table dans laquelle vous souhaitez sauvegarder vos rsultats daggrgation, agg_result dans ce scnario.
Vous pouvez galement utiliser un schma en mode Built-In et rcuprer la structure du schma du composant prcdent. Cependant, vous devez tre sr davoir spcifi une table cible existant dans votre base de donnes, ayant la mme structure de donnes.
Laissez les autres paramtres configurs par dfaut. Sauvegardez votre Job et appuyez sur la touche F6 pour lexcuter. Toutes les donnes slectionnes sont insres dans la table agg_result comme spcifi dans linstruction SQL.
Scnario 2 : ELT utilisant une table Alias

Le scnario suivant dcrit un Job mappant des informations provenant des deux tables dentre et dune table Alias servant de table dentre virtuelle, vers une table de sortie. La table employees contient lID des employs, le numro de leur service, leur nom et lID de leur responsable. Ces responsables sont galement considrs comme des employs et par consquent inclus dans la table employees. La table dept contient les informations de service des employs. La table Alias rcupre le nom des responsables de la table employees.
Glissez et dposez de la Palette dans lespace de modlisation graphique deux composants tELTMysqlInput, un tELTMysqlMap et un tELTMysqlOutput. Nommez-les comme vous le souhaitez afin de dcrire au mieux leur fonctionnalit. Double-cliquez sur le premier composant tELTMysqlInput afin dafficher sa vue Basic settings et configurer ses proprits de base.
985
Composants ELT
tELTMysqlMap
Slectionnez Repository dans la liste Schema puis dfinissez la connexion la base de donnes ainsi que le schma, en cliquant sur le bouton [...] ct du champ Edit Schema. La connexion la base de donnes est Talend_MySQL et le schma du premier composant dentre est employees.
Dans ce scnario, les schmas dentre sont stocks dans le Repository, sous le noeud Metadata, afin que vous puissiez les rcuprer plus facilement. Pour plus dinformations concernant les mtadonnes, consultez Centraliser les mtadonnes dans le Guide utilisateur de Talend Open Studio.
Configurez le second composant tELTMysqlInput de la mme manire, mais slectionnez dept comme nom de schma. Double-cliquez sur le composant tELTMysqlOutput afin dafficher sa vue Basic settings et dfinir ses proprits.
Dans la liste Action on data, slectionnez laction que vous souhaitez effectuer, Insert dans ce scnario. Dans la liste Schema, slectionnez Repository et dfinissez le schma de sortie de la mme manire que pour les schmas dentre. Dans ce scnario, slectionnez result comme schma de sortie, qui est le nom de la table de la base de donnes utilise pour stocker le rsultat du mapping. Le schma de sortie contient toutes les colonnes des schmas dentre ainsi quune colonne ManagerName. Laissez les autres paramtres configurs par dfaut. Reliez les deux composants tELTMysqlInput au tELTMysqlMap laide de liens Link nomms strictement selon le nom des tables dentre, employees et dept dans ce scnario. Reliez le composant tELTMysqlMap au tELTMysqlOutput laide dun lien Link. Cliquez sur Yes (Oui) louverture de la bote de dialogue pour permettre au Mapper ELT de rcuprer la structure de la table de sortie partir du schma de sortie.
986
Composants ELT
tELTMysqlMap
Cliquez sur le composant tELTMysqlMap afin dafficher sa vue Basic settings et configurer ses proprits de base.
Dans la liste Property Type, slectionnez Repository puis slectionnez la connexion la base de donnes utilise dans les composants dentre. Les informations de connexion la base de donnes sont automatiquement rcupres. Laissez les autres paramtres configurs par dfaut. Cliquez sur le bouton [...] ct du champ ELT Mysql Map Editor ou double-cliquez sur le composant tELTMysqlMap dans lespace de modlisation graphique afin douvrir le ELT Map Editor. Le composant tELTMysqlMap est connect au composant de sortie, la table de sortie est donc affiche dans la zone correspondante. Ajoutez les tables dentre employees et dept dans la zone dentre, en cliquant sur le bouton [+] et en slectionnant le nom des tables correspondant dans la bote de dialogue [Add a new alias]. Lorsque vous crez une table Alias partir de la table employees en slectionnant employees dans la liste Select the table to use et en saisissant Managers dans le champ Type in a valid alias, dans la bote de dialogue [Add a new alias].
Dposez la colonne DeptNo de la table employees dans la table dept. Cochez la case Explicit join devant la colonne DeptNo de la table dept afin de configurer une jointure Inner Join. Dposez la colonne ManagerId de la table employees dans la colonne ID de la table Managers.
987
Composants ELT
tELTMysqlMap
Cochez la case Explicit join devant la colonne ID de la table Managers et slectionnez LEFT OUTER JOIN dans la list Join, afin que les lignes de sortie puissent contenir des valeurs Null.
Dposez toutes les colonnes de la table employees dans les colonnes correspondantes de la table de sortie. Dposez les colonnes DeptName et Location de la table dept dans les colonnes correspondantes de la table de sortie. Dposez la colonne Name de la table Managers dans la colonne ManagerName de la table de sortie.
Cliquez sur longlet Generated SQL Select query pour afficher linstruction SQL excuter.
988
Composants ELT
tELTMysqlMap
Sauvegardez votre Job et appuyez sur F6 pour lexcuter. La table de sortie result de la base de donnes contient toutes les informations concernant les employs, y compris le nom de leurs responsables respectifs.
989
Composants ELT
tELTMysqlOutput
tELTMysqlOutput
Proprits de tELTMysqlOutput
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert dans la base de donnes Mysql Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Update : Met jour des lignes existantes. Delete : Supprime les entres correspondantes au flux dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Where clauses for (for UPDATE and DELETE only) Default Table Name Use different table name Saisissez la clause permettant de filtrer les donnes mettre jour ou supprimer lors des oprations de mise jour ou de suppression. Saisissez le nom de la table par dfaut, entre guillemets doubles. Cochez cette case afin de dfinir le nom dune table de sortie diffrente, entre guillemets doubles, dans le champ Table name qui apparat.
990
Composants ELT
tELTMysqlOutput
Utilisation
Lutilisation du composant tELTMysqlOutput est troitement lie celle des composants tELTMysqlInput et tELTMysqlMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant le composant tELTMysqlOutput, consultez les scnarios suivants du composant tELTMysqlMap : Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 981. Scnario 2 : ELT utilisant une table Alias, page 985.
991
Composants ELT
tELTOracleInput
tELTOracleInput
Proprits de tELTOracleInput
Les composants tELTOracleInput, tELTOracleOutput, et tELTOracleMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Oracle afin de gnrer des commandes Insert, Udpate ou Delete y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fournit le schma de la table dentre la commande SQL qui sera excute. Permet dajouter autant de tables que ncessaires dans une commande Insert qui peut tre complexe. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Le schma dfini est ensuite pass au composant ELT Mapper afin de lutiliser dans la commande SQL Insert. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Default Table Name Java uniquement Saisissez le nom de la table par dfaut, entre guillemets doubles.
Default Schema Name Saisissez le nom du schma par dfaut, entre guillemets doubles. tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTOracleInput est troitement lie celle du tELTOracleMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
992
Composants ELT
tELTOracleInput
Scnario associ
Pour un scnario utilisant le composant tELTOracleInput, consultez le Scnario : Mettre jour les lignes dune base Oracle, page 996 du composant tELTOracleMap.
993
Composants ELT
tELTOracleMap
tELTOracleMap
Proprits de tELTOracleMap
Les composants tELTOracleInput, tELTOracleOutput, et tELTOracleMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Oracle afin de gnrer des commandes Insert, Update ou Delete y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. Use an existing connection Java uniquement Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. ELT Oracle Map Editor Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
994
Composants ELT
tELTOracleMap
Style link
Property type
Java uniquement
Connection type DB Version Host Port Database
Liste droulante des pilotes disponibles. Slectionnez la version dOracle que vous utilisez. Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur de la base. Nom de la base de donnes.
Username et Password Donnes dauthentification de lutilisateur de la base. Advanced settings Additional JDBC Parameters Java uniquement Java uniquement Use Hint Options Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Cochez cette case afin dactiver la zone de configuration des hints, afin de vous permettre doptimiser lexcution dune requte. Dans cette zone, les paramtres sont : -HINT : spcifiez le hint dont vous avez besoin, laide de la syntaxe /*+ */. -POSITION : spcifiez o placer le hint dans linstruction SQL. -SQL STMT : slectionnez linstruction SQL utiliser. Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau du composant.
tStatCatcher Statistics Utilisation
Lutilisation du composant tELTOracleMap est troitement lie celle des composants tELTOracleInput et tELTOracleOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
995
Composants ELT
tELTOracleMap

Pour plus dinformations concernant la connexion des composants ELT, consultez Connecter les composants ELT page 980. Voir galement : Connexion de type Link du Guide Utilisateur Talend Open Studio

Dans le Mapper ELT, vous pouvez slectionner des colonnes des schmas dentre et les intgrer dans le schma de sortie. Pour plus dinformations concernant la mise en correspondance et les jointures, consultez Tables de jointure et de correspondance page 980.
Lorsque vous devez faire une jointure entre de nombreuses tables, ou faire une jointure entre tables avec des conditions multiples et des jointures externes, il est recommand dutiliser les options LEFT OUTER JOIN (+) et RIGHT OUTER JOIN (+) qui vous permettent dutiliser les mots cl privs Oracle. Pour plus dinformations concernant ces deux mots cl privs, consultez le site (en anglais) : http://download.oracle.com/docs/cd/B19306_01/server.102/b14200/queries006.htm
Ajouter des clauses Where

Pour plus dinformations sur la manipulation des clauses, consultez Ajouter des clauses WHERE page 980.
Gnrer la requte SQL

La mise en correspondance dlments des schmas dentre avec le schma de sortie cre automatiquement la requte Select correspondante. La/les clauses dfinies dans le mapper ELT sont galement intgres automatiquement dans la requte.
Scnario : Mettre jour les lignes dune base Oracle

Le scnario suivant est bas sur le scnario dagrgation Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 981. Laction sur les donnes Update tant disponible en base Oracle, le scnario suivant dcrit un Job qui met jour des donnes particulires dans la table agg_result.
996
Composants ELT
tELTOracleMap
Comme dcrit dans le Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 981, crez un Job dagrgation de donnes utilisant les composants ELT pour la base de donnes Oracle : tELTOracleInput, tELTOracleMap et tELTOracleOutput, puis excutez le Job afin de sauvegarder le rsultat de lagrgation dans une table de base de donnes nomme agg_result.
Lorsque vous dfinissez des filtres dans lditeur ELT Map, notez que les chanes de caractres sont sensibles la casse dans la base de donnes Oracle.
Lancez lditeur ELT Map et ajoutez une nouvelle table de sortie nomme update_data. Ajoutez une ligne de filtre la table update_data pour tablir une relation entre tables dentre et de sortie : owners.ID_OWNER = agg_result.ID_OWNER. Glissez la colonne MAKE de la table cars la table update_data. Glissez la colonne NAME_RESELLER de la table resellers la table update_data. Ajoutez un modle entour de guillemets simples, A8 dans cet exemple, dans la colonne MAKE de la table cars, prcd de deux barres verticales. Ajoutez Sold by, entour de guillemets simples devant la colonne Name_Reseller dans la table resellers, avec deux barres verticales au milieu.
Vrifiez la requte Select gnre dans longlet Generated SQL select query.
Composants ELT
tELTOracleMap
Cliquez sur OK pour valider les modifications et fermer le mapper ELT. Dsactivez le composant tELTOracleOutput nomm Agg_Result en cliquant-droit dessus et en slectionnant Deactivate Agg_Result dans le menu contextuel. Dposez un nouveau composant tELTOracleOutput de la Palette dans lespace de modlisation graphique. Nommez-le Update_Data afin didentifier plus clairement sa fonction. Reliez le composant tELTOracleMap au nouveau tELTOracleOutput laide du lien correspondant la nouvelle table de sortie dfinie dans le mapper, update_data dans ce scnario. Double-cliquez sur le composant tELTOracleOutput afin dafficher sa vue Component et dfinir ses proprits.
Slectionnez Update dans la liste Action on data. Vrifiez le schma et cliquez sur Sync columns pour rcuprer la structure du schma du composant prcdent. Dans le champ WHERE clauses, entrez la clause suivante : agg_results.MAKE = Audi, pour mettre jour les donnes relatives la marque Audi dans la table de la base de donnes agg_result. Renseignez le champ Default Table Name en saisissant le nom du lien de sortie, update_data dans cet exemple. Cochez la case Use different table name et renseignez le champ Table name en saisissant le nom de la table mettre jour, agg_result dans ce scnario. Laissez les autres paramtres tels quils sont.
998
Composants ELT
tELTOracleMap
Sauvegardez votre Job puis appuyez sur F6 pour lexcuter. Les donnes concernes ont t mises jour dans la table de la base de donnes.
999
Composants ELT
tELTOracleOutput
tELTOracleOutput
Proprits de tELTOracleOutput
Les composants tELTOracleInput, tELTOracleOutput, et tELTOracleMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Oracle afin de gnrer des commandes Insert, Update ou Delete y compris des clauses, et ces commandes devront tre excutes dans la table de sortie dfinie.
Fonction Objectif Basic settings Loption MERGE est disponible en Java uniquement
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert ou Update dans la base de donnes Oracle Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Update : Met jour des lignes existantes. Delete : Supprime les entres correspondantes au flux dentre. MERGE : met jour ou insre les donnes dans la table. Les options disponibles pour lopration MERGE diffrent de celles disponibles pour les oprations Insert, Update et Delete. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create table : supprimer la table puis en crer une nouvelle. Create table : crer une table qui nexiste pas encore. Create table if not exists : crer la table si ncessaire. Clear table : supprimer le contenu de la table. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Where clauses for (for UPDATE and DELETE only) Saisissez la clause permettant de filtrer les donnes mettre jour ou supprimer lors des oprations de mise jour ou de suppression.
Action on table Perl uniquement
1000
Composants ELT
tELTOracleOutput
Java uniquement
Use Merge Update (pour MERGE)
Cochez cette case pour mettre jour des donnes de votre table de sortie. Column : Liste des colonnes du flux dentre. Update : Cochez la case correspondant au nom de la colonne que vous souhaitez mettre jour. Use Merge Update Where Clause : Cochez cette case et saisissez la clause WHERE permettant de filtrer les donnes mettre jour, si ncessaire. Use Merge Update Delete Clause : Cochez cette case et saisissez la clause WHERE permettant de filtrer les donnes supprimer et mettre jour, si ncessaire. Cochez cette case pour insrer des donnes dans la table. Column : Liste des colonnes du flux dentre. Check All : Cochez la case correspondant au nom de la colonne que vous souhaitez insrer. Use Merge Update Where Clause : Cochez cette case et saisissez la clause WHERE permettant de filtrer les donnes insrer. Saisissez le nom de la table par dfaut.
Java uniquement
Use Merge Insert (pour MERGE)
Default Table Name Java uniquement Use different table name Advanced settings Utilisation
Default Schema Name Saisissez le nom du schma Oracle par dfaut. Cochez cette case afin de dfinir le nom dune table de sortie diffrente, entre guillemets doubles, dans le champ Table name qui apparat.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTOracleOutput est troitement lie celle des composants tELTOracleInput et tELTOracleMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnario : Utiliser la fonction MERGE dOracle pour mettre jour et insrer simultanment des donnes
Le scnario suivant dcrit un Job trois composants ELT permettant de mettre jour les donnes dune table client grce la commande MERGE dOracle. Les informations des nouveaux clients sont ajoutes et celles des anciens sont mises jour.
A partir du noeud Metadata du Repository :
1001
Composants ELT
tELTOracleOutput
Sous le noeud correspondant la base de donnes contenant les tables utiliser pour ce scnario, slectionnez le schma de la table contenant les nouvelles donnes sur les clients et glissez dans lespace de modlisation. Dans ce scnario, le schma utilis se nomme NEW_CUSTOMERS_MLE. Dans la bote de dialogue [Components], slectionnez le composant tELTOracleInput et cliquez sur OK. Pour plus dinformations concernant les mtadonnes, consultez la section Centraliser les mtadonnes du Guide Utilisateur de Talend Open Studio. A partir de la Palette de composants : Glissez les composants tELTOracleMap et tELTOracleOutput dans lespace de modlisation. Pour relier les composants entre eux : Cliquez-droit sur le composant dentre, NEW_CUSTOMERS_MLE, glissez jusquau tELTOracleMap et relchez le bouton droit pour crer le lien. De la mme manire, connectez le tELTOracleMap au tELTOracleOutput laide dun nouveau lien appel RESULTS dans cet exemple. Double-cliquez sur le composant dentre pour afficher ses proprits dans la vue Components.
Dans la liste Schema, slectionnez Repository si vous avez stock le schma de votre table dans le rpertoire Metadata du Repository ou slectionnez Built-in et configurez-le manuellement en cliquant sur le bouton [...] ct du champ Edit schema. Le schma est configur comme suit :
1002
Composants ELT
tELTOracleOutput
Dans le champ Default Table Name, saisissez entre guillemets le nom de la table source. Ici, la table utilise se nomme NEW_CUSTOMERS_MLE. Dans le champ Default Schema Name, saisissez entre guillemets le nom du schma source. Ici, le schma utilis se nomme ROOT. Cliquez sur le tELTOracleMap et sur la vue Component pour afficher les proprits de base du composant.
Cochez la case Use an existing connection et slectionnez le composant tOracleConnection dans la liste Component list si vous souhaitez utiliser la connexion ouverte par un composant de connexion. Dans la liste Property Type, slectionnez Repository et cliquez sur le bouton [...] pour slectionner la connexion la base de donnes contenant les tables utilises dans ce scnario. Les champs suivants seront automatiquement renseigns avec les informations de connexion cette base de donnes. Si vous navez pas cr de mtadonnes avec ces informations, slectionnez le mode Built-in dans la liste Property Type et renseignez-les manuellement.
1003
Composants ELT
tELTOracleOutput
Pour plus dinformations concernant les mtadonnes, consultez la section Centraliser les mtadonnes du Guide Utilisateur de Talend Open Studio. Cliquez sur le bouton [...] correspondant au champ ELT Oracle Map Editor pour ouvrir lditeur permettant de faire les correspondances entre le flux dentre et le flux de sortie.
Cliquez sur le bouton [+] en haut gauche de lditeur pour ouvrir la bote de dialogue permettant dajouter lalias correspondant la table dentre.
Dans la bote de dialogue Add a new alias :
1004
Composants ELT
tELTOracleOutput
Slectionnez le nom du flux de la table dentre dans la liste Select the table to use. Ici, vous avez slectionn ROOT.NEW_CUSTOMERS_MLE. Saisissez le nom que vous souhaitez donner lalias correspondant dans le champ Type in a valid alias. Ici, vous avez nomm lalias new_customers.
Lalias nest pas obligatoire quand la table en entre nest utilise quune seule fois dans le tMap.
Cliquez sur OK. Dans lditeur du tELTOracleMap, slectionnez toutes les colonnes de la table dentre et glissez-les dans la table de sortie, RESULTS. Cliquez sur longlet Generated SQL Select query pour afficher la requte excuter.
Cliquez sur OK. Dans lespace de modlisation, double-cliquez sur le composant tELTOracleOutput pour paramtrer ses proprits dans la vue Component.
Dans la liste Action on data, slectionnez MERGE. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent ou paramtrez manuellement le schma de sortie en slectionnant Built-in dans la liste Schema et en cliquant sur le bouton [...] ct du champ Edit schema. Cochez la case Use Merge Update pour mettre jour les donnes grce la fonction MERGE dOracle.
1005
Composants ELT
tELTOracleOutput
Dans le tableau qui apparat, cochez les cases correspondant aux colonnes que vous souhaitez mettre jour. Lobjectif est de mettre jour les donnes client en fonction de leur ID. Ainsi, cochez toutes les cases sauf celle correspondant la colonne ID.
Les colonnes dfinies comme cl primaire NE PEUVENT PAS et NE DOIVENT PAS faire lobjet dune mise jour.
Cochez les cases Use Merge Update Where Clause et Use Merge Update Delete Clause si vous souhaitez utiliser une clause WHERE pour filtrer les donnes mettre jour et une clause DELETE WHERE pour supprimer les donnes avant de rinsrer les donnes mises jour, lors de lopration de MERGE.
Cochez la case Use Merge Insert pour insrer de nouvelles donnes en mme temps que de mettre jour les anciennes grce la fonction MERGE dOracle. Dans le tableau qui apparat, cochez les cases correspondant aux colonnes que vous souhaitez insrer. Lobjectif est dinsrer toutes les nouvelles donnes client. Ainsi, cochez toutes les cases correspondant de toutes les colonnes insrer. Cochez la case Use Merge Insert Where Clause si vous souhaitez utiliser une clause WHERE pour filtrer les donnes insrer lors de lopration de MERGE.
1006
Composants ELT
tELTOracleOutput
Dans le champ Default Table Name, saisissez entre guillemets le nom de la table source. Ici, la table utilise se nomme NEW_CUSTOMERS_MLE Dans le champ Default Schema Name, saisissez entre guillemets le nom du schma source. Ici, le schma utilis se nomme ROOT. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Les donnes sont mises jour et insres dans la base de donnes et la requte utilise saffiche dans la console. Pour un scnario utilisant le composant tELTOracleOutput, consultez le Scnario : Mettre jour les lignes dune base Oracle, page 996 du composant tELTOracleMap.
1007
Composants ELT
tELTPostgresqlInput
tELTPostgresqlInput
Proprits de tELTPostgresqlInput
Les composants tELTPostgresqlInput, tELTPostgresqlOutput, et tELTPostgresqlMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Postgresql afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Default Schema Name Saisissez le nom du schma par dfaut. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTPostgresqlInput est troitement lie celle du tELTPostrgesqlMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTPostgresqlInput, consultez les scnarios suivants du composant tELTPostgresqlMap :
1008
Composants ELT
tELTPostgresqlInput
1009
Composants ELT
tELTPostgresqlMap
tELTPostgresqlMap
Proprits de tELTPostgresqlMap
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. Use an existing connection Cochez cette case et slectionnez le composant tPostgresqlConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. ELT Postgresql Map Editor Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
1010
Composants ELT
tELTPostgresqlMap
Style link
Slectionnez le type daffichage des liens. Auto : par dfaut, les liens entre les schmas dentre et de sortie et les paramtres du service Web sont en forme de courbe. Curves : les liens entre les schmas et les paramtres du service Web sont en forme de ligne. Line : les liens entre les schmas et les paramtres du service Web sont en forme de lignes droites. Cette option vous permettra doptimiser les performances. Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes.
Property type
Adresse IP du serveur de base de donnes Numro de port dcoute du serveur de la base. Nom de la base de donnes Donnes dauthentification de lutilisateur de la base Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Lutilisation du composant tELTPostgresqlMap est troitement lie celle des composants tELTPostgresqlInput et tELTPostgresqlOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
1011
Composants ELT
tELTPostgresqlOutput
Proprits de tELTPostgresqlOutput
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert dans la base de donnes Postgresql. Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Update : Met jour des lignes existantes. Delete : Supprime les entres correspondantes au flux dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Where clauses for (for UPDATE and DELETE only) Default Table Name Saisissez la clause permettant de filtrer les donnes mettre jour ou supprimer lors des oprations de mise jour ou de suppression. Saisissez le nom de la table par dfaut.
Default Schema Name Saisissez le nom du schma par dfaut. Use different table name Advanced settings Cochez cette case afin de dfinir le nom dune table de sortie diffrente, entre guillemets doubles, dans le champ Table name qui apparat.
1012
Composants ELT
Utilisation
Lutilisation du composant tELTPostgresqlOutput est troitement lie celle des composants tELTPostgresqlInput et tELTPostgresqlMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant un composant semblable au tELTPostgresqlOutput, consultez les scnarios suivants du composant tELTMysqlMap : Scnario 1 : Agrger les colonnes dune table et appliquer un filtre, page 981. Scnario 2 : ELT utilisant une table Alias, page 985.
1013
Composants ELT
tELTSybaseInput
tELTSybaseInput
Proprits de tELTSybaseInput
Les composants tELTSybaseInput, tELTSybaseOutput, et tELTSybaseMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Sybase afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Default Schema Name Saisissez le nom du schma Sybase par dfaut. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTSybaseInput est troitement lie celle du tELTSybaseMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant le composant tELTSybaseInput, consultez les scnarios suivants du composant tELTMysqlMap :
1014
Composants ELT
tELTSybaseInput
1015
Composants ELT
tELTSybaseMap
tELTSybaseMap
Proprits de tELTSybaseMap
Les composants tELTSybaseInput, tELTSybaseOutput, et tELTSybaseMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Sybase afin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. Use an existing connection Cochez cette case et slectionnez le composant tSybaseConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. ELT Sybase Map Editor Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
1016
Composants ELT
tELTSybaseMap
Style link
Property type
Host Port Database Username et Password Advanced settings Utilisation
Adresse IP du serveur de base de donnes Numro de port dcoute du serveur de la base. Nom de la base de donnes. Donnes dauthentification de lutilisateur de la base.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTSybaseMap est troitement lie celle des composants tELTSybaseInput et tELTSybaseOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
1017
Composants ELT
tELTSybaseOutput
tELTSybaseOutput
Proprits de tELTSybaseOutput
Les composants tELTSybaseInput, tELTSybaseOutput, et tELTSybaseMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Sybase fin de gnrer des commandes Insert, y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fonction Objectif Basic settings En Java, utilisez le composant tCreateTable pour remplacer cette option.
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert dans la base de donnes Sybase. Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Update : Met jour des lignes existantes. Delete : Supprime les entres correspondantes au flux dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Where clauses for (for UPDATE and DELETE only) Default Table Name Saisissez la clause permettant de filtrer les donnes mettre jour ou supprimer lors des oprations de mise jour ou de suppression. Saisissez le nom de la table par dfaut.
Default Schema Name Saisissez le nom du schma Sybase par dfaut. Use different table name Advanced settings Cochez cette case afin de dfinir le nom dune table de sortie diffrente, entre guillemets doubles, dans le champ Table name qui apparat.
1018
Composants ELT
tELTSybaseOutput
Utilisation
Lutilisation du composant tELTSybaseOutput est troitement lie celle des composants tELTSybaseInput et tELTSybaseMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
1019
Composants ELT
tELTTeradataInput
tELTTeradataInput
Proprits de tELTTeradataInput
Les composants tELTTeradataInput, tELTTeradataOutput, et tELTTeradataMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Teradata afin de gnrer des commandes Insert y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Fournit le schma de la table dentre la commande SQL qui sera excute. Permet dajouter autant de tables que ncessaires dans une commande Insert qui peut tre complexe. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Le schma dfini est ensuite pass au composant ELT Mapper afin de lutiliser dans la commande SQL Insert Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Default Table Name Saisissez le nom par dfaut de la table, entre guillemets doubles.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Lutilisation du composant tELTTeradataInput est troitement lie celle du tELTTeradataMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
Pour des scnarios utilisant le composant tELTTeradataInput, consultez les scnarios suivants du tELTTeradataMap :
1020
Composants ELT
tELTTeradataInput
1021
Composants ELT
tELTTeradataMap
tELTTeradataMap
Proprits de tELTTeradataMap
Les composants tELTTeradataInput, tELTTeradataOutput, et tELTTeradataMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Teradata afin de gnrer des commandes Insert y compris des clauses, et ces commandes devront tre excutes dans la table de sortie dfinie.
Fonction Objectif
Permet de construire votre commande SQL graphiquement en utilisant la table fournie en entre. Utilise les tables fournies en entre pour alimenter les paramtres ncessaires lexcution de la commande SQL souhaite. La commande peut contenir des jointures internes comme externes entre diffrentes tables ou entre une table et ses alias. Use an existing connection Cochez cette case et slectionnez le composant tSybaseConnection adquat partir de la liste Component pour rutiliser les paramtres dune connexion que vous avez dj dfinie. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. ELT Teradata Map editor Lditeur ELT du Mapper vous permet de dfinir le schma de sortie ainsi que de construire graphiquement la commande SQL excuter.
Basic settings
1022
Composants ELT
tELTTeradataMap
Style link
Property type
Host Port Database Username et Password Utilisation
Adresse IP du serveur de base de donnes Numro de port dcoute du serveur de la base. Nom de la base de donnes Donnes dauthentification de lutilisateur de la base
Lutilisation du composant tELTTeradataMap est troitement lie celle des composants tELTTeradataInput et tELTTeradataOutput. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
1023
Composants ELT
tELTTeradataMap

Pour plus dinformations concernant la connexion des composants ELT, consultez Connecter les composants ELT page 980. Voir galement : Connexion de type Link du Guide Utilisateur Talend Open Studio

Dans le Mapper ELT, vous pouvez slectionner des colonnes des schmas dentre et les intgrer dans le schma de sortie. Pour plus dinformations concernant la mise en correspondance et les jointures, consultez Tables de jointure et de correspondance page 980.
Ajouter des clauses Where

Pour plus dinformations sur la manipulation des clauses, consultez Ajouter des clauses WHERE page 980.
Gnrer la requte SQL

La mise en correspondance dlments des schmas dentre avec le schma de sortie cre automatiquement la requte Select correspondante. La/les clause(s) dfinie(s) dans le mapper ELT est (sont) galement intgre(s) automatiquement dans la requte.
Scnarios associs
1024
Composants ELT
tELTTeradataOutput
tELTTeradataOutput
Proprits de tELTTeradataOutput
Les composants tELTTeradataInput, tELTTeradataOutput, et tELTTeradataMap sont trs proches dans leurs conditions de fonctionnement. En effet, ces trois composants sont conus pour manipuler des schmas de donnes dune base Teradata afin de gnrer des commandes Insert y compris des clauses, qui devront tre excutes dans la table de sortie dfinie.
Effectue laction sur la table telle que spcifie et insre les donnes selon le schma de sortie dfini dans le Mapper ELT. Excute la requte Insert ou Update dans la base de donnes Teradata Action on data Sur les donnes de la table dfinie, vous pouvez effectuer les oprations suivantes : Insert : Ajoute de nouvelles lignes la table. Si des doublons sont identifis, le Job sarrte. Update : Met jour des lignes existantes. Delete : Supprime les entres correspondantes au flux dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Where clauses for (for UPDATE and DELETE only) Default Table Name Use different table name Saisissez la clause permettant de filtrer les donnes mettre jour ou supprimer lors des oprations de mise jour ou de suppression. Saisissez le nom par dfaut de la table, entre guillemets doubles. Cochez cette case afin de dfinir le nom dune table de sortie diffrente, entre guillemets doubles, dans le champ Table name qui apparat.
Advanced settings
1025
Composants ELT
tELTTeradataOutput
Utilisation
Lutilisation du composant tELTTeradataOutput est troitement lie celle des composants tELTTeradataInput et tELTTeradataMap. Notez que le lien de sortie (output) utiliser avec ces deux composants doit respecter strictement la syntaxe du nom de la table. Les composants ELT ne traitent pas le flux de donnes lui-mme mais uniquement les informations du schma.
Scnarios associs
1026
Composants ELT
tSQLTemplateAggregate
Proprits du tSQLTemplateAggregate
Famille de composant ELT/SQLTemplate
Fonction
Le composant tSQLTemplateAggregate collecte les donnes dune ou plusieurs colonnes et gre ces donnes en un seul bloc. Ce composant excute en temps rel des transformations de donnes dans le SGBD lui-mme. Il permet dtablir des mtriques bases sur des valeurs ou des calculs. Database Type Component List Slectionnez dans le menu droulant le type de base de donnes sur lequel vous voulez travailler. Slectionnez le composant de connexion la base de donnes dans la liste si vous utilisez plus dune connexion dans le Job en cours. Nom de la base de donnes. Nom de la table contenant les donnes dont vous souhaitez collecter les donnes. Nom de la table dans laquelle vous souhaitez crire les donnes collectes et transformes. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Operations Slectionnez le type dopration et la valeur utiliser pour le calcul et le champ de sortie. Output Column : Slectionnez le champ de destination dans la liste.
Database name Source table name Target table name Schema et Edit schema
1027
Composants ELT
Function : Slectionnez une des oprations suivantes effectuer sur les donnes : count : calcule le nombre de lignes, min : slectionne la plus petite valeur, max : slectionne la plus grande valeur, avg : calcule la moyenne, sum : calcule la somme, count (distinct) : compte le nombre de lignes sans les doublons. Input column position : Slectionnez la colonne dentre partir de laquelle vous souhaitez collecter les donnes agrger. Group by Dfinit les ensembles dagrgation, dont les valeurs sont utilises pour les calculs. Output Column : Slectionnez le libell de colonne dans la liste fournie, base sur la structure de schma que vous avez dfinie. Vous pouvez ajouter autant de colonnes de sortie que vous le souhaitez afin daffiner les agrgations. Input Column position : Faites la correspondance entre les libells des colonnes dentre avec ceux des colonnes de sortie, dans le cas o vous souhaitez que les libells du schma de sortie soient diffrents du schma dentre. Advanced settings SQL Template tStatCatcher Statistics SQLTemplate List Cochez cette case pour collecter les donnes de log au niveau du composant. Cliquez sur le bouton Add pour ajouter un ou plusieurs modle SQL du systme la liste SQLTemplateList. Cliquez dans la cellule de la colonne SQLTemplate List que vous venez dajouter et slectionnez le modle SQL du systme adquat dans la liste de modles fournis par Talend. Note : Vous pouvez crer vos propres modles SQL et les ajouter la liste SQLTemplate List. Pour crer un nouveau modle SQL : 1- Slectionnez un modle dj existant dans la liste SQLTemplate list et cliquez dans son code dans le champ de code. Une bote de dialogue souvrira vous demandant de crer un nouveau modle. 2- Cliquez sur Yes pour ouvrir la bote de dialogue New SQLTemplate. 3- Renseignez les informations de votre modle SQL et cliquez sur Finish pour fermer la bote de dialogue. Un diteur de modle SQL apparat dans lequel vous pouvez saisir votre code. 4- Cliquez sur le bouton Add pour ajouter le nouveau modle dans la liste SQLTemplate list. Pour plus dinformations, consultez la section Utilisation des SQL Templates, page 159 du Guide Utilisateur Talend Open Studio.
1028
Composants ELT
Utilisation
Ce composant est un composant intermdiaire. Vous pouvez lutiliser avec dautres composants de base de donnes, notamment les composants de connexion et de commit. n/a
Limitation
Scnario : Filtrer et agrger les colonnes dune table directement dans le SGBD
Le scnario Java suivant cre un Job qui ouvre une connexion une base de donnes Mysql et : cre un schma partir de la table dune base de donnes, les lignes de ce schma correspondent aux noms des colonnes spcifies dans le filtre, filtre les colonnes de cette mme table afin de nobtenir que les donnes correspondant aux colonnes filtres, collecte les donnes de la colonne filtre, regroupes en fonction dune valeur spcifique et crit les donnes agrges dans la table de cible. Pour filtrer et agrger les colonnes de la table de votre base de donnes : Cliquez et dposez les composants suivants dans lespace de modlisation : tELTMysqlconnection, tSQLTemplateFilterColumns, tSQLTemplateFilterRows, tSQLTemplateAggregate, tSQLTemplateCommit et tSQLTemplateRollback. Connectez les cinq composants laide de liens de type OnComponentOk. Connectez les composants tSQLTemplateAggregate et tSQLTemplateRollback laide dun lien de type OnComponentError.
Dans lespace de modlisation, slectionnez le tMysqlConnection et cliquez sur la vue Component pour paramtrer ses proprits. Dans longlet Basic settings, renseignez manuellement les informations de connexion ou slectionnez-les partir des variables de contexte, via la raccourci Ctrl+Espace cliquez sur le champ correspondant si les vous avez stock sous le noeud DB connection du rpertoire Metadata du Repository. Pour plus dinformations sur les mtadonnes, consultez Centraliser les mtadonnes du Guide utilisateur de Talend Open Studio.
1029
Composants ELT
Dans lespace de modlisation, slectionnez le composant tSQLTemplateFilterColumns et cliquez sur la vue Component pour paramtrer ses proprits.
Dans la liste droulante Database type, slectionnez la base de donnes adquate. Dans la liste droulante Component list, slectionnez le composant de connexion la base de donnes si plusieurs composants de connexion sont utiliss dans votre Job. Dans le champ Database name, saisissez le nom de la base de donnes laquelle vous vous tes connect. Dans le champ Source table name, saisissez le nom de votre table source contenant les donnes que vous souhaitez traiter et cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure des donnes de votre table source. Dans le champ Target table name, saisissez le nom de la table cible contenant vos nouvelles donnes traites et cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure de la table cible.
Lorsque vous dfinissez la structure des donnes de la table source, le nom des colonnes apparat automatiquement dans la colonne Column du tableau Column filters.
Dans ce scnario, la table source contient les cinq colonnes : id, First_Name, Last_Name, Address et id_State.
1030
Composants ELT
Dans le tableau Column filters, filtrez les colonnes en cochant la case des colonnes que vous souhaitez crire dans votre table cible. Dans ce scnario, le composant tSQLTemplateFilterColumns ne garde que les colonnes id, First_Name et id_State de la table source.
Dans la vue Component, vous pouvez cliquer sur longlet SQL Template et ajouter des modles SQL du systme ou crer vos propres modles SQL et les utilisez dans votre Job afin deffectuer les oprations que vous souhaitez. Pour plus dinformations, consultez Proprits du tSQLTemplateFilterColumns page 1036.
Dans lespace de modlisation, slectionnez le composant tSQLTemplateFilterRows et cliquez sur longlet Component pour paramtrer ses proprits.
Dans la liste droulante Database type, slectionnez la base de donnes adquate. Dans la liste droulante Component list, slectionnez le composant de connexion la base de donnes si plusieurs composants de connexion sont utiliss dans votre Job. Dans le champ Database name, saisissez le nom de la base de donnes laquelle vous vous tes connect. Dans le champ Source table name, saisissez le nom de votre table source contenant les donnes que vous souhaitez traiter et cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure des donnes de votre table source. Dans le champ Target table name, saisissez le nom de la table cible contenant vos nouvelles donnes traites et cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure de la table cible. Dans ce scnario, la table source et la table cible contiennent les trois colonnes filtres id, First_Name et id_State. Dans le champ Where condition, saisissez la commande WHERE vous permettant de nextraire que les champs correspondant vos critres. Dans ce scnario, le composant tSQLTemplateFilterRows filtre la colonne First_Name de la table source pour nobtenir que les prnoms commencent par la lettre a. Dans lespace de modlisation, slectionnez le composant tSQLTemplateAggregate et cliquez sur la vue Component pour paramtrer ses proprits. Dans la liste droulante Database type, slectionnez la base de donnes adquate. Dans la liste Component list, slectionnez le composant de connexion la base de donnes si plusieurs composants de connexion sont utiliss dans votre Job. Dans le champ Database name, saisissez le nom de la base de donnes laquelle vous vous tes connect.
Composants ELT
Dans le champ Source table name, saisissez le nom de votre table source contenant les donnes que vous souhaitez traiter et cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure des donnes de votre table source. Dans le champ Target table name, saisissez le nom de la table cible contenant vos nouvelles donnes traites et cliquez sur le bouton [...] ct du champ Edit schema pour dfinir la structure de la table cible. Le schma de la table source est compos de trois colonnes : id, First_Name et id_State. Le schma de la table cible est compos de deux colonnes : customers_status et customers_number. Dans ce scnario, vous souhaitez regrouper les clients par statut marital et compter le nombre de client pour chaque groupe marital. Pour cela, dfinissez les tableaux Operations et Grouped by.
Dans le tableau Operations, cliquez sur le bouton [+] pour ajouter une ou plusieurs lignes et cliquez dans la cellule de la colonne Output column et slectionnez la colonne de sortie qui contiendra les donnes compter. Cliquez dans la cellule de la colonne Function et slectionnez lopration effectuer. Dans le tableau Group by, cliquez sur le bouton [+] pour ajouter une ou plusieurs lignes et cliquez dans la cellule de la colonne Output column pour slectionner la colonne de sortie qui contiendra les donnes agrges.
1032
Composants ELT
Dans lespace de modlisation, slectionnez le composant tSQLTemplateCommit et cliquez sur la vue Component pour paramtrer ses proprits. Dans la liste droulante Database type, slectionnez la base de donnes adquate. Dans la liste droulante Component list, slectionnez le composant de connexion la base de donnes si plusieurs composants de connexion sont utiliss dans votre Job. Effectuez la mme procdure pour le composant tSQLTemplateRollback. Enregistrez le Job et appuyez sur F6 pour lexcuter. La table aggregate_customers compose de deux colonnes est cre dans la base de donnes. Elle regroupe les clients en fonction de leur statut marital et compte le nombre de client pour chaque statut marital.
1033
Composants ELT
tSQLTemplateCommit
tSQLTemplateCommit
Proprits du tSQLTemplateCommit
Ce composant est troitement li au composant tSQLTemplateRollback et au composant ELT de connexion la base de donnes sur laquelle vous travaillez. Ils sont gnralement utiliss ensemble lors de transactions.
Famille du composant ELT/SQLTemplate
Fonction Objectif
Le composant tSQLTemplateCommit valide les donnes traites dans un Job partir dune base de donnes connecte. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Database Type Component List Slectionnez dans le menu droulant le type de base de donnes sur lequel vous voulez travailler. Sil y a plus dune connexion dans le Job en cours, slectionnez le composant de connexion la base de donnes que vous utilisez dans la liste. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Basic settings
Close Connection
Advanced settings SQL Template
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. SQLTemplate List Cliquez sur le bouton Add pour ajouter un ou plusieurs modle SQL du systme la liste SQLTemplateList. Cliquez dans la cellule de la colonne SQLTemplate List que vous venez dajouter et slectionnez le modle SQL du systme adquat dans la liste de modles fournis par Talend. Note : Vous pouvez crer vos propres modles SQL et les ajouter la liste SQLTemplate List. Pour crer un nouveau modle SQL : 1- Slectionnez un modle dj existant dans la liste SQLTemplate list et cliquez dans son code dans le champ de code. Une bote de dialogue souvrira vous demandant de crer un nouveau modle. 2- Cliquez sur Yes pour ouvrir la bote de dialogue New SQLTemplate. 3- Renseignez les informations de votre modle SQL et cliquez sur Finish pour fermer la bote de dialogue. Un diteur de modle SQL apparat dans lequel vous pouvez saisir votre code. 4- Cliquez sur le bouton Add pour ajouter le nouveau modle dans la liste SQLTemplate list. Pour plus dinformations, consultez la section Utilisation des SQL Templates, page 159 du Guide Utilisateur Talend Open Studio.
1034
Composants ELT
tSQLTemplateCommit
Utilisation
Ce composant est gnralement utilis avec des composants ELT et notamment avec le composant tELTRollback, ainsi quavec le composant ELT de connexion la base de donnes que vous utilisez. n/a
Limitation
Scnario associ
Ce composant est troitement li au composant tSQLTemplateRollback et au composant ELT de connexion la base de donnes avec laquelle vous travaillez. Ils sont gnralement utiliss avec le composant ELT de connexion correspondant car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tSQLTemplateCommit, consultez Scnario : Filtrer et agrger les colonnes dune table directement dans le SGBD page 1029.
1035
Composants ELT
tSQLTemplateFilterColumns
Proprits du tSQLTemplateFilterColumns
Fonction
Le composant tSQLTemplateFilterColumns modifie le schma de la table dune base de donnes en filtrant les colonnes. Ce composant filtre en temps rel les donnes dans le SGBD lui-mme. Il permet dhomogniser des schmas en rorganisant ou en supprimant des colonnes ou en ajoutant de nouvelles colonnes. Database Type Component List Slectionnez dans le menu droulant le type de base de donnes sur lequel vous voulez travailler. Slectionnez le composant de connexion la base de donnes si vous utilisez plus dune connexion dans votre Job en cours. Nom de la base de donnes. Nom de la table contenant les donnes filtrer. Nom de la table dans laquelle vous souhaitez crire les donnes filtres. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Column filters Dans le tableau, cochez la case Filter pour filtrer toutes vos colonnes, ou, pour en filtrer moins, cliquez sur la ou les case(s) en face du nom de la ou des colonne(s). Cochez cette case pour collecter les donnes de log au niveau du composant.
Advanced settings
1036
Composants ELT
SQL Template
SQLTemplate List
Cliquez sur le bouton Add pour ajouter un ou plusieurs modle SQL du systme la liste SQLTemplateList. Cliquez dans la cellule de la colonne SQLTemplate List que vous venez dajouter et slectionnez le modle SQL du systme adquat dans la liste de modles fournis par Talend. Note : Vous pouvez crer vos propres modles SQL et les ajouter la liste SQLTemplate List. Pour crer un nouveau modle SQL : 1- Slectionnez un modle dj existant dans la liste SQLTemplate list et cliquez dans son code dans le champ de code. Une bote de dialogue souvrira vous demandant de crer un nouveau modle. 2- Cliquez sur Yes pour ouvrir la bote de dialogue New SQLTemplate. 3- Renseignez les informations de votre modle SQL et cliquez sur Finish pour fermer la bote de dialogue. Un diteur de modle SQL apparat dans lequel vous pouvez saisir votre code. 4- Cliquez sur le bouton Add pour ajouter le nouveau modle dans la liste SQLTemplate list. Pour plus dinformations, consultez la section Utilisation des SQL Templates, page 159 du Guide Utilisateur Talend Open Studio.
Utilisation
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Filtrer et agrger les colonnes dune table directement dans le SGBD, page 1029.
1037
Composants ELT
tSQLTemplateFilterRows
Proprits du tSQLTemplateFilterRows
Fonction
Le composant tSQLTemplateFilterRows vous permet de filtrer les lignes dune table. Ce composant filtre en temps rel les donnes dans le SGBD lui-mme. Il permet de mettre en place un filtrage de lignes sur nimporte quelle donne source grce une commande WHERE. Database Type Component List Slectionnez dans le menu droulant le type de base de donnes sur lequel vous voulez travailler. Slectionne le composant de connexion la base de donnes si vous utilisez plus dune connexion dans le Job en cours. Nom de la base de donnes. Nom de la table contenant les donnes filtrer. Nom de la table dans laquelle vous souhaitez crire les donnes filtres. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Where condition Utilisez une commande WHERE pour dfinir un critre partir duquel vous souhaitez filtrer vos donnes. Vous pouvez utiliser la commande WHERE pour slectionner des lignes spcifiques de votre table en fonction de certains critres ou certaines conditions. Cochez cette case pour collecter les donnes de log aussi bien au niveau du Job quau niveau du composant.
Advanced settings
1038
Composants ELT
SQL Template
SQLTemplate List
Utilisation
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Filtrer et agrger les colonnes dune table directement dans le SGBD, page 1029.
1039
Composants ELT
tSQLTemplateMerge
tSQLTemplateMerge
Proprits du tSQLTemplateMerge
Fonction Objectif
Le composant tSQLTemplateMerge cre une instruction SQL MERGE sur les donnes dans une table de la base de donnes. Ce composant est utilis pour effectuer des oprations de MERGE sur les donnes (insertion, mise jour ou suppression) directement dans une table du SGBD. Pour cela, il cre et excute une instruction MERGE. Database Type Component list Slectionnez dans le menu droulant le type de base de donnes sur lequel vous voulez travailler. Slectionnez le composant ELT de connexion le plus pertinent dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Nom de la table contenant les donnes sur lesquelles vous souhaitez effectuer les oprations dinsertion ou de mise jour dans la table cible. Nom de la table dans laquelle vous souhaitez effectuer les oprations dinsertion ou de mise jour. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Merge ON Spcifiez les colonnes source et cible que vous souhaitez utiliser comme cls primaires.
Basic settings
Source table name
Target table name Schema et Edit schema
Use UPDATE (WHEN Cochez cette case pour mettre jour les MATCHED) enregistrements existants. Une fois cette case coche, la table UPDATE Columns apparat, vous permettant de dfinir les colonnes dans lesquelles les enregistrements seront mis jour.
1040
Composants ELT
tSQLTemplateMerge
Specify additional output columns
Cochez cette case pour mettre jour les enregistrements dans des colonnes autres que celles listes dans la table UPDATE Columns. Une fois cette case coche, la table Additional UPDATE Columns apparat, vous permettant de dfinir des colonnes supplmentaires. Cochez cette case et saisissez une clause de type WHERE dans le champ WHERE clause afin de filtrer les donnes lors de lopration de mise jour. Il est probable que cette option ne fonctionne pas avec certaines versions des bases de donnes, notamment Oracle 9i.
Specify UPDATE WHERE clause
Use INSERT (WHEN MATCHED)
Cochez cette case pour insrer de nouveaux enregistrements. Une fois cette case coche, la table INSERT Columns apparat, vous permettant de dfinir des colonnes to be involved in the insert operation. Cochez cette case pour insrer des enregistrements dans les colonnes des colonnes autres que celles listes dans la table INSERT Columns. Une fois cette case coche, la table Additional INSERT Columns apparat, vous permettant de dfinir des colonnes supplmentaires. Cochez cette case et saisissez une clause de type WHERE dans le champ WHERE clause fin de filtrer les donnes lors de lopration dinsertion. Il est probable que cette option ne fonctionne pas avec certaines versions des bases de donnes, notamment Oracle 9i.
Specify additional output columns
Specify INSERT WHERE clause
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log aussi bien au niveau du Job quau niveau du composant.
1041
Composants ELT
tSQLTemplateMerge
SQL Template
SQL Template List
Utilisation
Ce composant est un composant intermdiaire. Vous pouvez lutiliser avec dautres composants de base de donnes, notamment les composants de connexion et de commit.
Scnario : Effectuer des oprations de MERGE directement dans le SGBD

Ce scnario dcrit un Job simple permettant douvrir une connexion une base de donnes MySQL, deffectuer des oprations dinsertion ou de mise jour sur les donnes dune table source vers une table cible en fonction de lidentifiant de lutilisateur et dafficher le contenu de la table cible avant et aprs les oprations de MERGE. Une clause de type WHERE est utilise pour filtrer les donnes lors de ces oprations.
1042
Composants ELT
tSQLTemplateMerge
A partir de la Palette, dposez les composants suivants dans lespace de modlisation graphique : un tMysqlConnection, un tSQLTemplateMerge, deux tMysqlInput et deux tLogRow. Connectez le composant tMysqlConnection au premier tMysqlInput laide dun lien Trigger > OnSubjobOK. Connectez le premier tMysqlInput au premier tLogRow laide dun lien Row > Main. Cette ligne affichera le contenu initial de la table cible dans la console de la vue Run. Connectez le premier tMysqlInput au composant tSQLTemplateMerge, et le tSQLTemplateMerge au second composant tMysqlInput laide de connexions Trigger > OnSubjobOK. Connectez le second tMysqlInput au second tLogRow laide dun lien Row > Main. Cette ligne affichera le rsultat des oprations de MERGE dans la console de la vue Run. Double-cliquez sur le composant tMysqlConnection pour afficher longlet Basic settings de sa vue Component.
1043
Composants ELT
tSQLTemplateMerge
Paramtrez manuellement les dtails de la connexion la base de donnes ou slectionnez Repository dans la liste Property Type et slectionnez votre connexion une base de donnes si celle-ci a dj t dfinie et stocke dans la zone Metadata de la vue Repository. Pour plus dinformations concernant les Mtadonnes, consultez Centraliser les mtadonnes dans le Guide utilisateur Talend Open Studio. Double-cliquez sur le premier composant tMysqlInput pour afficher longlet Basic settings de sa vue Component.
Cochez la case Use an existing connection. Si vous souhaitez utiliser plus dun composant de connexion dans votre Job, slectionnez le composant que vous souhaitez utiliser partir de la liste Component List. Cliquez sur le bouton [...] ct de Edit schema et dfinissez la structure des donnes de la table cible, ou slectionnez Repository partir de la liste Schema puis slectionnez la table cible si le schma a dj t dfini et stock dans la zone Metadata de la vue Repository. Pour ce scnario, choisissez Built-in.
Dfinissez les colonnes comme indiqu ci-dessus, puis cliquez sur OK pour propager la structure du schma au composant de sortie et fermer la bote de dialogue.
Composants ELT
tSQLTemplateMerge
Renseignez le champ Table Name avec le nom de la table cible, soit customer_info_merge pour ce scnario. Cliquez sur le bouton Guess Query, ou saisissez SELECT * FROM customer_info_merge dans la zone Query afin de rcuprer toutes les colonnes des tables. Dfinissez les proprits du second composant tMysqlInput en utilisant exactement les mmes paramtres que dans le premier composant tMysqlInput. Dans longlet Basic settings de la vue Component de chaque composant tLogRow, slectionnez loption Table dans la zone Mode afin dafficher le rsultat sous forme de tableau dans la console de la vue Run.
Double-cliquez sur le composant tSQLTemplateMerge pour afficher longlet Basic settings de sa vue Component.
Saisissez les noms de la table source et de la table cible dans les champs correspondants. Pour ce scnario, la table source, new_customer_info, contient huit enregistrements ; la table cible, customer_info_merge, contient cinq enregistrements et les deux tables ont la mme structure.
Il est possible que la table source et la table cible aient des schmas diffrents. Dans ce cas, cependant, assurez-vous que la colonne source et la colonne cible spcifies dans chaque ligne des tables Merge ON, UPDATE Columns et INSERT Columns aient un type de donnes identique et que la longueur de la colonne cible permette linsertion de donnes partir de la colonne source correspondante.
Dfinissez le schma source manuellement, ou slectionnez Repository partir de la liste Schema et slectionnez la table souhaite si le schma a dj t dfini et stock dans la zone Metadata de la vue Repository. Pour ce scnario, nous utilisons des schmas en mode Built-in.
1045
Composants ELT
tSQLTemplateMerge
Dfinissez les colonnes comme indiqu ci-dessus puis cliquez sur OK pour fermer la bote de dialogue. Faites de mme pour le schma cible. Cliquez sur le bouton [+] sous la table Merge ON pour ajouter une ligne et slectionnez la colonne ID comme cl primaire.
Cochez la case Use UPDATE (WHEN MATCHED) pour mettre jour les donnes existantes lors des oprations de MERGE, dfinissez les colonnes mettre jour en cliquant sur le bouton [+] et slectionnez les colonnes souhaites. Le but de ce scnario est de mettre jour toutes les colonnes selon lidentifiant (ID) des utilisateurs. Pour cela, slectionnez toutes les colonnes sauf la colonne ID.
Les colonnes dfinies comme cls primaires NE PEUVENT et NE DOIVENT PAS tre mises jour.
Cochez la case Specify UPDATE WHERE clause et saisissez customer_info_merge.ID >= 4 entre guillemets doubles, dans le champ WHERE clause afin que seuls les enregistrements existants ayant un ID gal ou suprieur 4 soient mis jour.
1046
Composants ELT
tSQLTemplateMerge
Cochez la case Use INSERT puis dfinissez dans la table INSERT Columns les colonnes o les donnes seront prises et insres. Pour ce scnario, nous souhaitons insrer tous les enregistrements qui nexistent pas dans la table cible.
Slectionnez longlet SQL Template pour afficher et ajouter les modles SQL utiliser. Par dfaut, le composant SQLTemplateMerge utilise deux modles SQL systme : MergeUpdate et MergeInsert.
IDans longlet SQL Template, vous pouvez ajouter des modles SQL systme ou crer vos propres modles et les utiliser dans votre Job pour effectuer des oprations codes. Pour plus dinformations, consultez Proprits du tSQLTemplateFilterColumns, page 1036.
1047
Composants ELT
tSQLTemplateMerge
Cliquez sur le bouton Add pour ajouter une ligne puis slectionnez Commit dans la liste des modles afin de commiter les rsultats des oprations de MERGE dans votre base de donnes. Autrement, vous pouvez connecter le composant tSQLTemplateMerge un tSQLTemplateCommit ou un tMysqlCommit laide dun lien Trigger > OnSubjobOK afin de commiter les rsultats des oprations dans votre base de donnes. Sauvegardez votre Job et appuyez sur F6 pour lexcuter. La console de la vue Run affiche la fois le contenu dorigine de la table cible ainsi que les rsultats des oprations de MERGE. Dans la table cible, les enregistrements No. 4 et No. 5 contiennent les informations mises jour, tandis que les enregistrements No .6, No. 7 et No. 8 contiennent les informations insres dans la table.
1048
Composants ELT
tSQLTemplateRollback
Proprits du tSQLTemplateRollback
Ce composant est troitement li au composant tSQLTemplateCommit et au composant ELT de connexion correspondant la base de donnes sur laquelle vous travaillez. Ils sont gnralement utiliss ensemble lors de transactions.
Famille du composant ELT/SQLTemplate
Le tSQLTemplateRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Database Type Component List Slectionnez dans le menu droulant le type de base de donnes sur lequel vous voulez travailler. Slectionnez le composant ELT de connexion le plus pertinent dans la liste si vous prvoyez dajouter plus dune connexion votre Job en cours. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
Close Connection
Advanced settings SQL Template
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. SQLTemplate List Cliquez sur le bouton Add pour ajouter un ou plusieurs modle SQL du systme la liste SQLTemplateList. Cliquez dans la cellule de la colonne SQLTemplate List que vous venez dajouter et slectionnez le modle SQL du systme adquat dans la liste de modles fournis par Talend. Note : Vous pouvez crer vos propres modles SQL et les ajouter la liste SQLTemplate List. Pour crer un nouveau modle SQL : 1- Slectionnez un modle dj existant dans la liste SQLTemplate list et cliquez dans son code dans le champ de code. Une bote de dialogue souvrira vous demandant de crer un nouveau modle. 2- Cliquez sur Yes pour ouvrir la bote de dialogue New SQLTemplate. 3- Renseignez les informations de votre modle SQL et cliquez sur Finish pour fermer la bote de dialogue. Un diteur de modle SQL apparat dans lequel vous pouvez saisir votre code. 4- Cliquez sur le bouton Add pour ajouter le nouveau modle dans la liste SQLTemplate list. Pour plus dinformations, consultez la section Utilisation des SQL Templates, page 159 du Guide Utilisateur Talend Open Studio.
1049
Composants ELT
Utilisation
Il faut utiliser ce composant en association avec des composants ELT, notamment avec le tSQLTemplateCommit et le composant ELT de connexion correspondant la base de donnes avec laquelle vous travaillez. n/a
Limitation
Scnario associ
Pour un scnario associ au tSQLTemplateRollback, consultez le Scnario : Filtrer et agrger les colonnes dune table directement dans le SGBD, page 1029.
1050
Composants ESB
Ce chapitre passe en revue les principaux composants de la famille ESB de la Palette de Talend Open Studio.
Composants ESB
tESBConsumer
tESBConsumer
Proprits du tESBConsumer
Famille de composant ESB
Appelle la mthode dfinie du Service Web invoqu et retourne la classe, selon les paramtres spcifis. Invoque une mthode via un Service Web. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Service Configuration Mapping display link as Description des bindings et de la configuration du Service Web. Auto : Par dfaut, les liens entre les schmas dentre, de sortie et les paramtres du Service Web sont en forme de courbes. Curves : Les liens entre le schma et les paramtres du Service Web sont en forme de courbes. Lines : Les liens entre le schma et les paramtres du Service Web sont en forme de lignes droites. Cette options otpimise lgrement les performances.
Connection time out Configurez une valeur en secondes avant interruption de la connexion au Service Web. Receive time out Input schema and Edit schema Configurez une valeur en secondes pour la rception de la rponse. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Sync columns Cliquez sur ce bouton afin de rcuprer automatiquement les colonnes du composant prcdent.
1052
Composants ESB
tESBConsumer
Response schema et Edit schema
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Fault Schema et Edit Un schma est une description de lignes, i.e., il Schema dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Use NTLM/Domain et Host Cochez cette case si vous souhaitez utiliser le protocole NTLM dauthentification. Domain : Nom de domaine client. Host : Adresse IP client.
Need Cochez cette case et saisissez un nom Authentication/User dutilisateur et un mot de passe dans les champs name et Password correspondants, si cela est ncessaire pour accder au service. Use HTTP Proxy/Proxy host, Proxy port, Proxy user, et Proxy password Trust Server with SSL Cochez cette case si vous utilisez un serveur proxy et renseignez les informations ncessaires.
Cochez cette case pour authentifier le serveur auprs du client via un protocole scuris SSL et renseignez les champs suivants : TrustStore file : saisissez le chemin daccs et le nom du fichier TrustStore contenant la liste des certificats approuvs par le client. TrustStore password : saisissez le mot de passe utilis pour vrifier lintgrit des donnes TrustStore. Cochez cette case si vous souhaitez arrter le Job en cas derreur.
Die on error
1053
Composants ESB
tESBConsumer
Advanced Setting
Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant.
Ce composant peut tre utilis comme composant intermdiaire. Il ncessite un composant dentre et un composant de sortie. Une JDK est requise pour que ce composant puisse fonctionner.
Scnario : Retourner une adresse e-mail valide

Ce scnario Java dcrit un Job utilisant un composant tESBConsumer afin de rcuprer une adresse e-mail valide. Pour crer le Job : Dposez les composants de la Palette dans lespace de modlisation graphique : tFixedFlowInput, tESBConsumer, deux tJavaFlex et deux tLogRow et connectez-les comme dans la capture dcran ci-dessous :
Configurez ensuite les proprits des composants. Dans lespace de modlisation graphique, double-cliquez sur le composant tFixedFlowInput_1 afin dafficher sa vue Component et dfinir ses proprits de base (Basic settings). Slectionnez, dans la liste Schema, le mode Built-in, puis cliquez sur le bouton [...] ct du champ Edit Schema et configurez le schma comme suit :
1054
Composants ESB
tESBConsumer
Cliquez sur le bouton [+] pour ajouter une nouvelle ligne de type String et nommez-la payloadString. Cliquez sur OK.
Dans le champ Number of rows, configurez le nombre de lignes 1. Dans la zone Mode, slectionnez Use Single Table et saisissez la requte suivante tentre guillemets dans le champ Value : <web:IsValidEmail xmlns:web='http://www.webservicex.net'><web:Email>nomatter@g mail.com</web:Email></web:IsValidEmail> Dans le Job, double-cliquez sur le composant tJavaFlex_1 afin dafficher sa vue Component et dfinir ses Basic settings.
1055
Composants ESB
tESBConsumer
Ajoutez le code suivant dans le champ Main code : org.dom4j.Document doc = org.dom4j.DocumentHelper.parseText(row1.payloadString); Document talendDoc = new Document(); talendDoc.setDocument(doc); row2.payload = talendDoc; Dans la liste Schema, slectionnez Built-in et cliquez sur le bouton [...] ct du champ Edit Schema et configurez le schma comme suit :
Dans lespace de modlisation graphique, double-cliquez sur le composant tESBConsumer_1 afin dafficher sa vue Component et dfinissez ses Basic settings.
1056
Composants ESB
tESBConsumer
Cliquez sur le bouton [...] ct du champ Service Configuration afin douvrir lditeur.
Dans le champ WSDL, saisissez : http://www.webservicex.net/ValidateEmail.asmx?WSDL
1057
Composants ESB
tESBConsumer
Cliquez sur Refresh pour rcuprer le nom du port et de lopration. Dans la liste Port Name, slectionnez le port que vous souhaitez utiliser, ValidateEmailSoap dans cet exemple. Cliquez sur OK. Dans longlet Basic settings du composant tESBConsumer, configurez le schma dentre Input Schema comme suit :
Configurez le Response Schema comme suit :
Configurez le Fault Schema comme suit :
Dans le Job, double-cliquez sur le composant tJavaFlex_2 afin dafficher sa vue Component et dfinir ses Basic settings.
1058
Composants ESB
tESBConsumer
Ajoutez le code suivant dans le champ Main code dans longlet Basic properties : if (null != row4.faultDetail) { row6.faultDetailString = row4.faultDetail.getDocument().asXML(); } Dans la liste Schema, slectionnez Built-in puis cliquez sur le bouton [...] ct du champ Edit Schema et configurez le schma comme suit :
Dans lespace de modlisation graphique, double-cliquez sur le composant tLogRow_1 afin dafficher sa vue Component et dfinir ses Basic settings
1059
Composants ESB
tESBConsumer
Dans la liste Schema, slectionnez Built-in puis cliquez sur le bouton [...] ct du champ Edit Schema et configurez le schma comme suit :
Dans lespace de modlisation graphique, double-cliquez sur le composant tLogRow_2 afin dafficher sa vue Component et dfinir ses Basic settings.
Dans la liste Schema, slectionnez Built-in puis cliquez sur le bouton [...] ct du champ Edit Schema puis configurez le schma comme suit :
Sauvegardez votre Job et appuyez sur F6 pour lexcuter. Dans le log dexcution, vous pouvez voir : Starting job consumer4 at 15:02 21/04/2011. [statistics] connecting to socket on port 4057 [statistics] connected ValidateEmail ValidateEmailSoap | {http://www.webservicex.net}ValidateEmail {http://www.webservicex.net}ValidateEmailSoap IsValidEmail [tLogRow_2] payload: <?xml version="1.0" encoding="UTF-8"?> <IsValidEmailResponse xmlns="http://www.webservicex.net"><IsValidEmailResult>false</IsV alidEmailResult></IsValidEmailResponse>
1060
Composants ESB
tESBConsumer
[statistics] disconnected Job consumer4 ended at 15:03 21/04/2011. [exit code=0]
1061
Composants ESB
tESBProviderFault
tESBProviderFault
Proprits du tESBProviderFault
Gnre un message Fault (message derreur) provenant du Service Web, la fin du Job Talend. Retourne un message Fault provenant du Service Web la fin du cycle du Job Talend. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Sync columns Cliquez sur ce bouton afin de rcuprer automatiquement les colonnes du composant prcdent. Valeur de faultString dans le message Fault.
EBS service settings fault title Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant. Ce composant doit tre utilis uniquement avec le composant tESBProviderRequest. Une JDK est requise pour que ce composant puisse fonctionner.
Scnario : Retourner un message Fault

Ce scnario Java dcrit comment utiliser un composant tESBProviderFault afin de retourner un message Fault. Vous devez crer deux Jobs pour ce scnario : un Job fournisseur un Job consommateur
1062
Composants ESB
tESBProviderFault
Crer un Job fournisseur

Cette section vous montre comment crer un Job fournisseur.
Dposez les composants suivants de la Palette dans lespace de modlisation graphique : un tESBProviderRequest, trois tLogRow, deux tJavaFlex et un tESBProviderFault. Connectez les composants comme dans la capture dcran. Configurez les proprits du composant tESBProvider Request_1.
Modifiez le schma du composant tESBProvider Request_1.
Configurez les proprits du composant tLogRow_1.
1063
Composants ESB
tESBProviderFault
Modifiez le schma du composant tLogRow_1 component.
Configurez les proprits du composant tJavaFlex_1. Ajoutez le code suivant dans le champ Main code, comme ci-dessous. Document requestTalendDoc = row2.payload; org.dom4j.Document requestDoc = requestTaldndDoc.getDocument(); org.dom4j.Element rootElement = requestDoc.getRootElement(); String text = rootElement.getTextTrim(); System.out.println("### " + text); row3.content = text;
1064
Composants ESB
tESBProviderFault
Configurez le schma du composant tJavaFlex_1.
Configurez le schma du composant tLogRow_2.
1065
Composants ESB
tESBProviderFault
Dfinissez les proprits du composant tJavaFlex_2. Ajoutez le code suivant dans le champ Main code comme suit. String fMessage = row4.content; String faultText = "Fault message text: " + fMessage + "!"; org.dom4j.Document faultDoc = org.dom4j.DocumentHelper.createDocument(); faultDoc.addElement(new org.dom4j.QName("response",
org.dom4j.Namespace.get("http://talend.org/esb/service/jo b")) ).addText(faultText); Document faultTalendDoc = new Document(); faultTalendDoc.setDocument(faultDoc); row5.payload = faultTalendDoc;
1066
Composants ESB
tESBProviderFault
Dfinissez les proprits du composant tESBProviderFault_1.
Configurez le schma du composant tESBProviderFault_1.
Le Job peut tre excut sans erreur.
Crer un Job consommateur

Cette section explique comment crer un Job consommateur.
1067
Composants ESB
tESBProviderFault
Dposez les composants suivants de la Palette dans lespace de modlisation graphique : un tESBConsumer, deux tLogRow, un JavaFlex et un tFixedFlowInput. Connectez les composants comme dans la capture dcran. Configurez le schma du composant tFixedFlowInput_1.
Configurez les proprits du composant tFixedFlowInput_1.
1068
Composants ESB
tESBProviderFault
Dfinissez les proprits du composant tJavaFlex_1. Ajoutez le code suivant dans le champ Main code. org.dom4j.Document doc = org.dom4j.DocumentHelper.parseText(row1.payloadString); Document talendDoc = new Document(); talendDoc.setDocument(doc); row2.payload = talendDoc;
Excutez le Job fournisseur. Dans le log dexcution, vous pouvez voir : ... web service [endpoint: http://127.0.0.1:8008/esb/provider] published ... Ouvrez Service Configuration et saisissez le chemin daccs au WSDL : http://127.0.0.1.8088/esbprovider?WSDL
1069
Composants ESB
tESBProviderFault
afin de rcuprer le nom du port et le nom de lopration.
1070
Composants ESB
tESBProviderFault
Configurez le schma dentre, le schma de rponse (response) et le schma derreur (fault) du composant tESBComsumer_1.
1071
Composants ESB
tESBProviderFault
Arrtez le Job fournisseur. Configurez les proprits du composant tLogRow_1.
Dfinissez les proprits du composant tLogRow_2.

Composants ESB
tESBProviderFault
Le Job peut tre excut sans erreur.
Excuter le scnario
Excutez le scnario pour visualiser le message Fault. Excutez le Job fournisseur. Vous pouvez voir dans le log dexcution : ... 2011-04-19 15:38:33.486:INFO::jetty-7.2.2.v20101205 2011-04-19 15:38:33.721:INFO::Started SelectChannelConnector@127.0.0.1:8088 web service [endpoint: http://127.0.0.1:8088/esb/provider] published Excutez le Job consommateur. Vous pouvez voir dans le log dexcution du Job : Starting job consumer at 15:39 19/04/2011. [statistics] connecting to socket on port 3850 [statistics] connected LOCAL_provider LOCAL_providerSoapBinding | {http://talend.org/esb/service/job}LOCAL_provider {http://talend.org/esb/service/job}LOCAL_providerSoapBind ing invoke [tLogRow_1] faultString: TestFaultTitle [tESBProviderFault_1] faultDetail: <?xml version="1.0" encoding="UTF-8"?> <response xmlns="http://talend.org/esb/service/job">Fault message text: Test error!</response> [statistics] disconnected Job consumer ended at 15:39 19/04/2011. [exit code=0] Dans le log du fournisseur vous pouvez voir les traces des erreurs : ... WARNING: Application {http://talend.org/esb/service/job}LOCAL_provider#{http:/ /talend.org/esb/service/job}invoke has thrown exception, unwinding now org.apache.cxf.binding.soap.SoapFault: TestFaultTitle [tESBProviderFault_1] ... Lerreur est attendue puisque le message Fault est gnr.
1073
Composants ESB
tESBProviderRequest
tESBProviderRequest
Le composant tESBProviderRequest doit tre utilis avec le composant tESBProviderResponse, afin de fournit une rponse comme rsultat du Job, dans le cas dune communication de style requte-rponse.
Proprits du tESBProviderRequest
Expose un Job Talend comme un Service Web. Attend un message de requte dun consommateur et le passe au composant suivant. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. ESB Service Settings Keep listening Endpoint : spcifiez lURL partir de laquelle accder au Service Web pour les requtes. Cochez cette case lorsque vous souhaitez assurer que le fournisseur (et donc le Job Talend) va continuer couter les requtes aprs traitement de la premire requte entrante.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant. Ce composant couvre la possibilit dexposer un Job Talend en tant que Service, avec la possibilit dcrire une requte de service dans un Job et retourne le rsultat du Job en tant que rponse. Une JDK est requise pour que ce composant fonctionne.
Utilisation
Limitation
Scnario : Un service reoit un message sans attendre de rponse

Ce scnario se compose de deux Jobs : un Job consommateur et un Job fournisseur.
1074
Composants ESB
tESBProviderRequest

Cette section explique comment crer un Job fournisseur.
Dposez les composants suivants de la Palette dans lespace de modlisation graphique : un tESBProviderRequest, trois tLogRow et deux tJavaFlex. Connectez les composants comme dans la capture dcran. Configurez les proprits du composant tESBProvider Request_1.
Configurez le schma du composant tESBProvider Request_1.
1075
Composants ESB
tESBProviderRequest
Dfinissez les proprits du composant tJavaFlex_1. Ajoutez le code suivant dans le champ Main code comme suit. Document requestTalendDoc = row2.payload; org.dom4j.Document requestDoc = requestTalendDoc.getDocument(); org.dom4j.Element rootElement = requestDoc.getRootElement(); String text = rootElement.getTextTrim(); System.out.println("### " + text); row3.content = text;
1076
Composants ESB
tESBProviderRequest
1077
Composants ESB
tESBProviderRequest
Configurez les proprits du composant tJavaFlex_2. Ajoutez le code suivant dans le champ Main code comme suit. String name = row5 content String faultText = "Hello, " + name + "!"; org.dom4j.Document faultDoc = org.dom4j.DocumentHelper.createDocument(); faultDoc.addElement( new org.dom4j.QName("response", org.dom4j.Namespace.get("http://talend.org/esb/serv ice/job")) ).addText(faultText); Document faultTalendDoc = new Document(); faultTalendDoc.setDocument(faultDoc); row6.payload = faultTalendDoc;
1078
Composants ESB
tESBProviderRequest
Sauvegardez le Job.

Dposez les composants suivants de la Palette dans lespace de modlisation graphique : un tESBConsumer, trois tLogRow, deux JavaFlex et un tFixedFlowInput. Connectez les composants comme dans la capture dcran. Configurez le schma du composant tFixedFlowInput_1.
1079
Composants ESB
tESBProviderRequest
Configurez les proprites du composant tLogRow_2.
1080
Composants ESB
tESBProviderRequest
Configurez les proprits du composant tJavaFlex_1. Ajoutez le code suivant dans le champ Main code. org.dom4j.Document doc = org.dom4j.DocumentHelper.parseText(row5.payloadString); Document talendDoc = new Document(); talendDoc.setDocument(doc); row4.payload = talendDoc;
Dmarrez le Job fournisseur. Vous pouvez voir dans le log dexcution : ... web service [endpoint: http://127.0.0.1:8088/esb/provider] published ... Double-cliquez sur le composant tESBConsumer_1 pour louvrir.
1081
Composants ESB
tESBProviderRequest
Ouvrez Service Configuration et saisissez le chemin daccs au WSDL : http://127.0.0.1.8088/esbprovider?WSDL
1082
Composants ESB
tESBProviderRequest
Modifiez le schma dentre, le schma de rponse (response) et le schma derreur (fault) du composant tESBComsumer_1.
1083
Composants ESB
tESBProviderRequest
Configurez les proprits du composant tJavaFlex_2. Ajoutez le code suivant dans le champ Main code. if (null != row6.faultDetail) { row7.payload = row6.faultDetail; }
1084
Composants ESB
tESBProviderRequest
Sauvegardez le Job.
Excuter le scnario
Excutez le Job fournisseur. Vous pouvez voir dans le log dexcution : INFO: Setting the server's publish address to be http://127.0.0.1:8088/esb/provider 2011-04-21 14:14:36.793:INFO::jetty-7.2.2.v20101205 2011-04-21 14:14:37.856:INFO::Started SelectChannelConnector@127.0.0.1:8088 web service [endpoint: http://127.0.0.1:8088/esb/provider] published
1085
Composants ESB
tESBProviderRequest
Excutez le Job consommateur. Vous pouvez voir dans le log dexcution du Job : Starting job CallProvider at 14:15 21/04/2011. [statistics] connecting to socket on port 3942 [statistics] connected TEST_ESBProvider2 TEST_ESBProvider2SoapBingding | [tLogRow_2] payloadString: <request>world</request> {http://talend.org/esb/service/job}TEST_ESBProvider2 {http://talend.org/esb/service/job}TEST_ESBProvider2SoapB inding invoke [tLogRow_1] payload: null [statistics] disconnected Job CallProvider2 ended at 14:16 21/04/2011. [exit code=0] Dans le log du fournisseur vous pouvez voir le log des traces : web service [endpoint: http://127.0.0.1:8088/esb/provider] published [tLogRow_1] payload: <?xml version="1.0" encoding="UTF-8"?> <request>world</request> ### world [tLogRow_2] content: world [tLogRow_3] payload: <?xml version="1.0" encoding="UTF-8"?> <response xmlns="http://talend.org/esb/service/job">Hello, world!</response> web service [endpoint: http://127.0.0.1:8088/esb/provider] unpublished [statistics] disconnected Job ESBProvider2 ended at 14:16 21/04/2011. [exit code=0]
1086
Composants ESB
tESBProviderResponse
Le composant tESBProviderResponse doit tre utilis avec le composant tESBProviderRequest, pour fournir une rponse en tant que rsultat du Job, pour un fournisseur de Service Web, dans le cas dune communication de style requte-rponse.
Proprits du tESBProviderResponse
Gnre un message de rponse et un message Fault la fin dun Job Talend provenant dun Service Web. Retourne une rponse comme fournisseur de service la fin de chaque cycle dun Job Talend. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant. Ce composant fonctionne comme aide au composant tESBProviderRequest. Une JDK est requise pour que ce composant fonctionne.
Scnario : Retourner une rponse Hello world

Ce scnario comprend deux Jobs : un Job consommateur et un Job fournisseur.

Cette section explique comment crer un Job fournisseur.
1087
Composants ESB
Dposez les composants suivants de la Palette dans lespace de modlisation graphique : un tESBProviderRequest, trois tLogRow, deux tJavaFlex et un tESBProviderResponse. Connectez les composants comme dans la capture dcran. Configurez les proprits du composant tESBProvider Request_1.
Configurez le schma du composant tESBProvider Request_1.
1088
Composants ESB
Configurez les proprits du composant tJavaFlex_1. Ajouter le code suivant dans le champ Main code comme suit. Document requestTalendDoc = row2.payload; org.dom4j.Document requestDoc = requestTaldndDoc.getDocument(); org.dom4j.Element rootElement = requestDoc.getRootElement(); String text = rootElement.getTextTrim(); System.out.println("### " + text); row3.content = text;
1089
Composants ESB
1090
Composants ESB
Configurez les proprits du composant tJavaFlex_2. Ajoutez le code dans le champ Main code comme suit. String name = row5 content String faultText = "Hello, " + name + "!"; org.dom4j.Document faultDoc = org.dom4j.DocumentHelper.createDocument(); faultDoc.addElement( new org.dom4j.QName("response", org.dom4j.Namespace.get("http://talend.org/esb/serv ice/job")) ).addText(faultText); Document faultTalendDoc = new Document(); faultTalendDoc.setDocument(faultDoc); row6.payload = faultTalendDoc;
1091
Composants ESB
Configurez les proprits du composant tESBProviderResponse_1.
Configurez le schma du composant tESBProviderResponse_1.
Sauvegardez le Job.

1092
Composants ESB
Dposez les composants suivants de la Palette dans lespace de modlisation graphique : un tESBConsumer, trois tLogRow, un JavaFlex et un tFixedFlowInput. Connectez les composants comme dans la capture dcran. Configurez le schma du composant tFixedFlowInput_1.
1093
Composants ESB
Configurez les proprits du composant tJavaFlex_1. Ajoutez le code suivant dans le champ Main code comme suit. org.dom4j.Document doc = org.dom4j.DocumentHelper.parseText(row1.payloadString); Document talendDoc = new Document(); talendDoc.setDocument(doc); row2.payload = talendDoc;
Dmarrez le Job fournisseur. Dans le log dexcution vous pouvez voir : ... web service [endpoint: http://127.0.0.1:8088/esb/provider] published ... Double-cliquez sur le composant tESBConsumer_1 afin de louvrir.
1094
Composants ESB
Ouvrez Service Configuration et saisissez le chemin daccs au WSDL : http://127.0.0.1.8088/esbprovider?WSDL
1095
Composants ESB
Configurez le schma dentre, le schma de rponse (response) et le schma derreur (fault) du composant tESBComsumer_1.
1096
Composants ESB
Configurez les proprits du composant tJavaFlex_3. Ajoutez le code suivant dans longlet Main code comme suit. if (null != row4.faultDetail) { row6.faultDetailString = row4.faultDetail.getDocument().asXML() }
1097
Composants ESB
Configurez le schma du composant for the tLogRow_3.
Sauvegardez votre Job.
Excuter le scnario
1098
Composants ESB
Excuter le Job fournisseur. Vous pouvez voir, dans le log dexcution : 2011-04-21 15:28:26.874:INFO::jetty-7.2.2.v20101205 2011-04-21 15:28:27.108:INFO::Started web service [endpoint: http://127.0.0.1:8088/esb/provider] published Excutez le Job consommateur. Vous pouvez voir, dans le log dexcution du Job : Starting job ConsumerJob at 15:29 21/04/2011. [statistics] connecting to socket on port 3690 [statistics] connected TEST_ProviderJob LOCAL_ProviderJobSoapBinding | {http://talend.org/esb/service/job}TEST_ProviderJob {http://talend.org/esb/service/job}TEST_ProviderJobSoapBinding invoke [tLogRow_2] payload: <?xml version="1.0" encoding="UTF-8"?> <response xmlns="http://talend.org/esb/service/job">Hello, world!</response> [statistics] disconnected Job ConsumerJob ended at 15:29 21/04/2011. [exit code=0] Dans le log fournisseur, vous pouvez voir les traces : W[tLogRow_1] payload: <?xml version="1.0" encoding="UTF-8"?> <request>world</request> ### world [tLogRow_2] content: world [tLogRow_3] payload: <?xml version="1.0" encoding="UTF-8"?> <response xmlns="http://talend.org/esb/service/job">Hello, world!</response> web service [endpoint: http://127.0.0.1:8088/esb/provider] unpublished [statistics] disconnected Job ProviderJob ended at 15:29 21/04/2011. [exit code=0].
1099
Composants ESB
1100
Composants File
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille File de la Palette de Talend Open Studio. La famille File regroupe les composants qui lisent et crivent des donnes dans tous types de fichiers un seul ou plusieurs schmas, du plus courant au format le plus spcifique (dans les sous-familles Input et Output). De plus, la sous-famille Management regroupe des composants ddis aux fichiers qui peuvent effectuer diverses traitements sur les fichiers, notamment la dcompression, la suppression, la copie, la comparaison de fichiers, etc.
Composants File
tAdvancedFileOutputXML
tAdvancedFileOutputXML appartient deux familles de composants : File et XML. Pour plus dinformations concernant le composant tAdvancedFileOutputXML, consultez tAdvancedFileOutputXML page 1674.
1102
Composants File
tApacheLogInput
tApacheLogInput
Proprits du tApacheLogInput
Component family File/Input
Fonction Objectif
Le composant tApacheLogInput permet de lire le fichier de log daccs dun serveur Apache. Le tApacheLogInput aide la gestion effective du serveur Apache. Il est obligatoire lorsquil sagit dobtenir un retour sur lactivit et les performances du serveur, mais aussi sur les problmes susceptibles de se produire. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. File Name Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Die on error Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Basic settings
Advanced settings
Encoding
1103
Composants File
tApacheLogInput
Utilisation
Ce composant peut tre utilis en standalone. Il permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1703 du composant tFileInputXML. n/a
Limitation
Scnario : Lire un fichier de log daccs Apache

Le scnario suivant cre un Job deux composants permettant de lire le fichier de log daccs dun serveur Apache et dafficher les donnes en sortie dans la console de log Run. A partir de la Palette, cliquez-dposez les composants tApacheLogInput et tLogRow dans lditeur graphique. Cliquez droit sur le tApacheLogInput et slectionnez une connexion Row > Main dans le menu contextuel. Cliquez ensuite sur le tLogRow, le lien appropri apparat entre les deux composants.
Dans lditeur graphique, slectionnez le tApacheLogInput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du composant tApacheLogInput.
Configurer les champs Property Type et Schema en mode Built-In. Cliquez sur le bouton Edit schema si vous souhaitez voir les colonnes (en mode read-only). Dans le champ File Name, renseignez le chemin daccs ou parcourez vos dossiers jusquau fichier de log daccs que vous voulez lire.
1104
Composants File
tApacheLogInput
Dans lditeur graphique, slectionnez le composant tLogRow et cliquez sur la vue Component pour un dfinir la configuration de base (Basic settings). Pour plus dinformations, consultez le composant tLogRow, page 1399. Appuyez sur F6 pour excuter le Job.
Les lignes de log du fichier dfini sont affiches dans la console.
1105
Composants File
tChangeFileEncoding
tChangeFileEncoding
tChangeFileEncoding Properties
Component family File/Management
Function Purpose
Le composant tChangeFileEncoding permet de modifier lencodage dun fichier donn. Le tChangeFileEncoding transforme lencodage des caractres dun fichier donn, et gnre un nouveau fichier en fonction de lencodage des caractres transforms. Use Custom Input Encoding Cochez cette case pour personnaliser le type dencodage des caractres. Lorsque cette case est coche, une liste des types dencodage dentre apparat, vous permettant soit de slectionner un type dencodage dentre parmi les encodages proposs, soit de spcifier vous-mme un type dencodage dentre en slectionnant CUSTOM. A partir de cette liste de types dencodage, vous pouvez slectionnez lune des options proposes, ou personnaliser lencodage des caractres en slectionnant CUSTOM, et spcifier un type dencodage de caractres.. Chemin daccs au fichier dentre. Chemin daccs au fichier de sortie.
Basic settings
Encoding
Input File Name Output File Name Utilisation Limitation
Ce composant doit tre utilis en standalone. n/a
Scnario: Transformer lencodage des caractres dun fichier

Ce scnario Java dcrit un Job trs simple permettant de transformer lencodage des caractres dun fichier texte, et de gnrer un nouveau fichier en tenant compte du nouvel encodage des caractres. A partir de la Palette, cliquez et dposez un composant tChangeFileEncoding dans lespace de modlisation graphique.
Double-cliquez sur le composant tChangeFileEncoding pour afficher longlet Basic settings de sa vue Component.
1106
Composants File
tChangeFileEncoding
Cochez la case Use Custom Input Encoding. Slectionnez le type dencodage GB2312 dans la liste droulante Encoding. Dans le champ Input File Name, parcourez ou saisissez le chemin daccs au fichier dentre. Dans le champ Output File Name, parcourez ou saisissez le chemin daccs au fichier de sortie. Slectionnez CUSTOM dans la liste droulante Encoding, et saisissez UTF-16 dans le champ texte. Sauvegardez votre Job et appuyez sur F6 pour lexcuter.
1107
Composants File
tChangeFileEncoding
Le type dencodage du fichier in.txt est transform, et out.txt est gnr avec un type dencodage UTF-16.
1108
Composants File
tCreateTemporaryFile
Proprits du tCreateTemporaryFile
Famille du composant File/Management
Fonction Objectif
Le composant tCreateTemporaryFile permet de crer et dorganiser les fichiers temporaires. Le tCreateTemporaryFile aide la cration dun fichier temporaire et sa redirection dans dossier dfini. Ce composant permet galement de conserver ou de supprimer ce fichier temporaire, selon le cas, aprs lexcution du Job. Remove file when execution is over Directory Template Suffix Cochez cette case pour que le fichier temporaire soit supprim aprs lexcution du Job. Renseignez le chemin daccs au dossier o sont stocks les fichiers temporaires. Attribuez un nom au fichier temporaire en respectant le modle. Entrez une extension de fichier pour prciser le format que vous voulez donner au fichier temporaire.
Basic settings
Utilisation
Le composant tCreateTemporaryFile vous donne la possibilit de grer vos fichiers temporaires pour que la mmoire soit libre au profit dautres projets, ce qui permet doptimiser les performances systme. Filepath : retrouve le chemin daccs lemplacement o a t cr le fichier. Disponible comme variable After. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Global Variables
Connections
Liens de sortie (dun composant un autre) : Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Iterate. Trigger : Run if, OnSubjobOk, OnSubjobError, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
1109
Composants File
Scnario : Crer un fichier temporaire et y crire des donnes

Le scnario suivant dcrit un Job simple permettant de crer un fichier temporaire vide dans un dossier dfini, puis dy crire des donnes et enfin de le supprimer aprs lexcution du Job. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tCreateTemporaryFile, le tRowgenerator, le tFileOutputDelimited, le tFileInputDelimited et le tLogRow. Reliez le tCreateTemporaryFile au tRowGenerator laide dun lien de type SubJobOk. Reliez le tRowGenerator au tFileOutputDelimited laide dun lien de type Row Main. Reliez le tRowGenerator au tFileInputDelimited laide dun lien de type SubJobOk. Reliez le tFileInputDelimited au tLogRow laide dun lien de type Row Main.
Dans lditeur graphique, slectionnez le composant tCreateTemporaryFile. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tCreateTemporaryFile.
Cochez la case Remove file when execution is over pour supprimer, aprs lexcution du Job, le fichier temporaire cr. Cliquez sur le bouton [...] ct du champ Directory pour parcourir vos dossiers jusqu celui o seront stocks les fichiers temporaires. Vous pouvez galement entrer directement le chemin daccs.
Composants File
Dans le champ Template, renseignez le nom du fichier temporaire en veillant ce quil respecte le format du modle. Dans le champ Suffix, renseignez lextension du fichier pour indiquer le format que vous voulez donner au fichier temporaire. Dans lditeur graphique, slectionnez le tRowGenerator puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
Dans la liste droulante Schema, choisissez le mode Built-In. Cliquez sur le bouton [...] du champ Edit schema pour dfinir les donnes passer au composant tFileOutputDelimited. Dans cet exemple, seules les donnes de la colonne value sont traites.
Cliquez sur OK pour fermer la bote de dialogue. Cliquez sur le bouton [...] du champ RowGenerator Editor pour ouvrir la bote de dialogue de lditeur.
Dans le champ Number of Rows for Rowgenerator, entrez le chiffre 5 pour gnrer cinq lignes puis cliquez sur Ok pour fermer la bote de dialogue.
Composants File
Dans lditeur graphique, slectionnez le tFileOutputDelimited puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
Dans la liste droulante Property Type, choisissez le mode Built-In. Cliquez dans le champ File Name puis appuyez simultanment sur Ctrl+Espace pour accder la liste dauto-compltion. Pour envoyer les donnes en sortie vers le fichier temporaire cr, slectionnez loption tCreateTemporaryFile_1.FILEPATH dans la liste des variables. Renseignez les sparateurs de lignes et de champs dans leurs champs respectifs Row Separator et Field Separator. Choisissez le mode Built-In dans la liste droulante Schema puis cliquez sur Sync columns pour synchroniser les colonnes dentre et de sortie. Notez que la connexion Row permet dalimenter automatiquement le schma de sortie. Pour plus dinformations sur les types de schmas, consultez les chapitres Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Dans lditeur graphique, slectionnez le composant tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileInputDelimited.
Choisissez le mode Built-in dans la liste droulante Property Type. Cliquez dans le champ File Name puis appuyez simultanment sur Ctrl+Espace pour accder la liste dauto-compltion. Pour lire les donnes du fichier temporaire cr, slectionnez tCreateTemporaryFile_1.FILEPATH dans la liste des variables.
1112
Composants File
Renseignez les sparateurs de lignes et de champs dans leurs champs respectifs Row Separator et Field Separator. Dans la liste droulante Schema, choisissez le mode Built-In puis cliquez sur le bouton [...] du champ Edit schema pour dfinir les donnes passer au composant tLogRow. Dans cet exemple, le schma est compos de la seule colonne value. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
Le fichier temporaire est cr, lors de lexcution du Job, dans le dossier qui a t dfini et les cinq lignes gnres sont inscrites dans ce fichier. Le fichier temporaire est supprim aprs lexcution du Job.
1113
Composants File
tFileArchive
tFileArchive
Proprits du tFileArchive
Famille de composant File/Management
Fonction
Le composant tFileArchive zippe un ou plusieurs fichier(s) en fonction des paramtres dfinis et place larchive cre dans le rpertoire souhait. Ce composant zippe un ou plusieurs fichier(s) pour un ventuel traitement. Directory Rpertoire dans lequel le fichier zipp sera plac. Subdirectories (en Perl, ce champ se nomme Include subdirectories) : Cochez cette case si le ou les rpertoire(s) slectionn(s) contiennent des sous-dossiers. Rpertoire de destination et nom du fichier archive. Choisissez le niveau de compression que vous souhaitez appliquer. Best : la qualit de compression sera optimale mais le temps de compression sera long. Normal : qualit et temps de compression intermdiaires. Fast : la compression sera rapide mais la qualit de compression sera amoindrie. Cochez cette case si vous souhaitez que tous les fichiers du dossier soient zipps. Dcochez-la pour spcifier dans le tableau Files le ou les fichier(s) que vous dsirez zipper. Filemask : entrez un nom de fichier ou masque de fichier utilisant un caractre spcial ou une expression rgulire. Cochez cette case pour crer un nouveau dossier si votre dossier de destination nexiste pas. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cette case est coche par dfaut. Elle vous permet de sauvegarder une archive en remplaant larchive existante. Cependant, si vous dcochez la case, une erreur sera rapporte, le remplacement darchive chouera et la nouvelle archive ne pourra tre sauvegarde. Lorsque le remplacement choue, le Job poursuit son excution.
Archive file Compress level
All files
Java uniquement
Create directory if not exists Encoding
Java uniquement
Overwrite Existing Archive
1114
Composants File
tFileArchive
Java uniquement
Encrypt files
Cochez cette case si vous souhaitez que votre archive soit protge par un mot de passe. Le champ Enter Password apparat et vous permet de saisir votre mot de passe. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant doit tre utilis en standalone. Archive File Path : retrouve le chemin daccs au fichier archive. Disponible comme variable After. Retourne une chane de caractres. Archive File Name : retrouve le nom du fichier archive. Disponible comme variable After. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Row : Main, Reject, Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Main, Reject, Iterate. Trigger : Run if, OnSubjobOk, OnSubjobError, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Scnario : Zipper des fichiers laide dun tFileArchive

Ce scnario met en scne un Job form dun composant unique. Il a pour but de zipper des fichiers et de les enregistrer dans le rpertoire choisi. Cliquez-dposez le composant tFileArchive de la Palette dans lespace de modlisation graphique. Double-cliquez sur le composant afin dafficher sa vue Component.
1115
Composants File
tFileArchive
Dans le champ Directory, cliquez sur [...], parcourez votre rpertoire et slectionnez le dossier ou le fichier que vous souhaitez compresser. Cochez la case Subdirectories si vous dsirez inclure dans larchive les fichiers des sous-dossiers. Renseignez ensuite le champ Archive file, en indiquant le rpertoire de destination et le nom de votre archive. Cochez la case Create directory if not exists si votre rpertoire de destination nexiste pas encore et que vous souhaitez le crer. Dans la liste Compress level, slectionnez le niveau de compression que vous dsirez appliquer votre archive. Dans cet exemple, utilisez le niveau normal. Dcochez la case All Files si vous ne souhaitez compresser que des fichiers spcifiques.
Ajoutez une ligne dans le tableau laide du bouton [+], et cliquez sur le nom qui saffiche. Saisissez entre toiles une partie du nom du ou des fichier(s) que vous souhaitez compresser. Appuyez sur F6 afin dexcuter votre Job. Le tArchiveFile a compress les fichiers slectionns et a cr le dossier dans le rpertoire indiqu.
1116
Composants File
tFileCompare
tFileCompare
Proprits du tFileCompare
Le composant tFileCompare compare deux fichiers et fournit des informations de comparaison (en fonction dun schma en lecture seule). Ce composant permet de contrler la qualit des donnes des fichiers traits. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository mais pour ce composant le schma est en lecture seule. Le chemin daccs au fichier vrifier. Le chemin daccs du fichier sur lequel la comparaison est bas. Saisissez le message afficher dans la console Run en fonction du rsultat de la comparaison.
File to compare Reference file If differences are detected, display If no difference detected, display Print to console Utilisation
Cochez cette case pour afficher le message saisi.
Ce composant peut tre utilis en standalone mais il est gnralement reli un composant de sortie pour regrouper les informations de comparaison. Difference : Vrifie si deux fichiers sont identiques ou non. Disponible comme variable Flow. Retourne une valeur boolenne : -true si les deux fichiers sont identiques. -false sil y a une (des) diffrence(s) entre eux. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Global Variables
1117
Composants File
tFileCompare
Connections
Liens de sortie (dun composant un autre) : Row : Main. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Main, Reject, Iterate. Trigger : Run if, OnSubjobOk, OnSubjobError, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Scnario : Comparer des fichiers dzipps

Ce scnario dcrit un Job permettant de dzipper un fichier et de le comparer avec un fichier de rfrence pour sassurer quil na pas t modifi. La sortie de cette comparaison est stocke dans un fichier dlimit et un message est affich dans la console.
Cliquez et dposez les composants suivants : tFileUnarchive, tFileCompare et tFileOutputDelimited. Reliez les composants tFileUnarchive et tFileCompare laide dune connexion de type Iterate. Connectez le composant tFileCompare au composant de sortie laide dun lien Main row. Dans longlet Basic settings du composant tFileUnarchive, renseignez le chemin daccs au fichier dzipper. Dans le champ Extraction Directory, renseignez le chemin de destination du fichier dzipp. Dans longlet Basic settings du composant tFileCompare, paramtrez les proprits du fichier comparer. Dans le champ File to compare, appuyez sur Ctrl+Espace pour afficher la liste des variables globales. Slectionnez $_globals{tFileUnarchive_1}{CURRENT_FILEPATH} ou "((String)globalMap.get("tFileUnarchive_1_CURRENT_FILEPATH"))" en fonction du langage avec lequel vous travaillez, pour rcuprer le chemin daccs du fichier partir du composant tFileUnarchive.
1118
Composants File
tFileCompare
Puis dans le champ Reference file, paramtrez le fichier de rfrence sur lequel est base la comparaison. Dans les champs If differences detected, display et If no differences detected, dispay, paramtrez les messages afficher lorsque les fichiers sont diffrents et lorsquils sont identiques, par exemple : '[Job '.$_globals{Job_name}.'] Files differ' si vous travaillez en Perl ou "[Job " + JobName + "] Files differ" si vous travaillez en Java. Cohez la case Print to Console, pour que le message dfini apparaisse la fin de lexcution du Job. Le schma est en lecture seule et contient les informations standard. Cliquez sur Edit schema pour le consulter.
Puis paramtrez le composant de sortie en utilisant des points-virgules comme sparateurs de donnes. Enregistrez le Job et appuyez sur F6 pour lexcuter.
Le message paramtr apparat dans la console et la sortie contient les informations telles quelles ont t dfinies dans le schma.
1119
Composants File
tFileCompare
1120
Composants File
tFileCopy
tFileCopy
Proprits du tFileCopy
Le composant tFileCopy fait une copie dun fichier source dans un rpertoire cible et peut supprimer le fichier source, si ncessaire. Ce composant permet de rationnaliser les traitements en effectuant des tches rcurrentes et fastidieuses de manire automatique. File Name Destination Remove source file Replace existing file Chemin daccs au fichier copier ou dplacer. Chemin daccs du rpertoire dans lequel le fichier est copi ou dplac. Cochez cette case pour dplacer le fichier. Cochez cette case pour craser le fichier dj existant.
Ce composant peut tre utilis en standalone. Destination File Name : retrouve le nom du fichier de destination. Disponible comme variable After. Retourne une chane de caractres. Destination File Path : retrouve le chemin daccs au fichier de destination. Disponible comme variable After. Retourne une chane de caractres. Source Directory : retrouve le chemin daccs au fichier source. Disponible comme variable After. Retourne une chane de caractres. Destination Directory : retrouve le chemin daccs au rpertoire de destination. Disponible comme variable After. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
1121
Composants File
tFileCopy
Connections
Limitation
n/a
Scnario : Rcuprer un fichier de la corbeille

Ce scnario dcrit un Job faisant une boucle sur une liste de fichiers, copie chaque fichier du rpertoire source vers le rpertoire cible. Puis il supprime les fichiers copis du rpertoire source.
Cliquez-dposez les composants tFileList et tFileCopy. Reliez-les laide dune connexion Iterate. Dans longlet Basic settings du composant tFileList, spcifiez le rpertoire sur lequel sera effectue la boucle.
Dans le champ Filemask, paramtrez le masque du fichier en *.txt pour ne tenir compte que des fichiers avec cette extension. Dans cet exemple, la casse nest pas prise en compte, ainsi dans la liste droulante Case Sensitive, slectionnez loption No. Puis slectionnez le composant tFileCopy et paramtrez ses proprits dans longlet Basic settings.
1122
Composants File
tFileCopy
Dans le champ File Name, appuyez sur Ctrl+Espace pour accder la liste des variables. Slectionnez la variable globale ((String)globalMap.get("tFileList_1_CURRENT_FILEPATH")) si vous travaillez en Java, ou $_globals{tFileList_1}{CURRENT_FILEPATH} si vous travaillez en Perl. De cette manire, tous les fichiers du rpertoire source peuvent tre traits. Cochez la case Remove Source file pour supprimer le fichier ayant t copi. Cochez la case Replace existing file pour craser tout fichier dj existant dans le rpertoire de destination. Enregistrez le Job et appuyez sur F6. Les fichiers sont copis dans le rpertoire de destination et supprims du rpertoire source.
1123
Composants File
tFileDelete
tFileDelete
Proprits du tFileDelete
Fonction Objectif Basic settings Utilisation Global Variables
Le composant tFileDelete supprime un fichier dun rpertoire spcifi. Ce composant permet de rationnaliser les traitements en effectuant des tches rcurrentes et fastidieuses de manire automatique. File Name Chemin daccs au fichier supprimer.
Ce composant peut tre utilis en standalone. Delete Path : retrouve le chemin daccs lemplacement o se trouvait le fichier supprim. Disponible comme variable After. Retourne une chane de caractres. Current status : indique si un lment a t supprim ou non. Disponible comme variable Flow. Retourne une chane de caractres et le libell de la commande de suppression. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Connections
Limitation
n/a
Scnario : Supprimer des fichiers

Ce scnario dcrit un Job trs simple supprimant des fichiers dun rpertoire donn.
1124
Composants File
tFileDelete
Cliquez et dposez les composants suivants : tFileList, tFileDelete, tJava. Dans le champ Directory de longlet Basic settings du composant tFileList, spcifiez le rpertoire sur lequel la boucle doit tre effectue.
Dans le champ Filemask, paramtrez le masque de fichier en *.txt. Ne cochez aucune case. Dans longlet Basic settings du composant tFileDelete, paramtrez le champ File Name afin que le fichier slectionn par le composant tFileList soit supprim. Ceci permet de supprimer tous les fichiers dun rpertoire spcifi.
1125
Composants File
tFileDelete
Appuyez sur Ctrl+Espace pour accder la liste des variables globales. En Java, la variable adquate permettant de rcuprer le fichier en cours est : ((String)globalMap.get("tFileList_1_CURRENT_FILEPATH")). Puis dans le composant tJava, dfinissez le message afficher dans la sortie standard (la console Run). Dans cet exemple Java, saisissez le script suivant dans le champ Code : System.out.println( ((String)globalMap.get("tFileList_1_CURRENT_FILE")) + " has been deleted!" ); Puis enregistrez le Job et appuyez sur F6 pour lexcuter.
Le message dfini dans le composant tJava apparat dans la console pour chaque fichier supprim laide du composant tFileDelete.
1126
Composants File
tFileExist
tFileExist
Proprits du tFileExist
Fonction Objectif
Le composant tFileExist vrifie si un fichier existe ou non. Le tFileExists aide rationaliser les processus en automatisant les tches rcurrentes et fastidieuses, comme par exemple vrifier si un fichier existe ou non. File Name Chemin daccs au fichier dont vous voulez vrifier lexistence.
Basic settings Utilisation Global Variables
Ce composant peut tre utilis en standalone. Exists : indique si un fichier spcifi existe ou non. Disponible comme variable Flow. Retourne une valeur boolenne : -true si le fichier existe. -false si le fichier nexiste pas. File name : retrouve le nom et le chemin daccs dun fichier. Disponible comme variable After. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Connections
Limitation
n/a
1127
Composants File
tFileExist
Scnario : Vrifier lexistence dun fichier et le crer sil nexiste pas

Ce scnario dcrit un Job simple qui permet de vrifier si le fichier spcifi existe, dafficher un message lcran si le fichier nexiste pas, de lire les donnes dun autre fichier dentre spcifi et de les crire dans un fichier dlimit en sortie. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFileExist, le tFileInputDelimited, le tFileOutputDelimited et le tMsgBox. Reliez dabord le tFileExist au tFile InputDelimited laide dun lien de type OnSubjobOk, puis au tMsgBox laide dun lien de type Run If.
Reliez le tFileInputDelimited au tFileOutputDelimite laide dun lien de type Row Main. Dans lditeur graphique, slectionnez le tFileExist puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
Dans le champ File name, renseignez le chemin daccs au fichier ou parcourez vos dossiers la recherche du fichier dont vous voulez vrifier lexistence. Dans lditeur graphique, slectionnez le composant tFileInputDelimited puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings).
1128
Composants File
tFileExist
Remplissez le champ File Name en parcourant vos dossiers jusquau fichier dentre que vous voulez lire. Dfinissez les sparateurs de lignes et de champs dans leurs champs respectifs Row separator et Field Separator. Dfinissez le nombre de lignes den-tte (Header), de pied de page (Footer) et le nombre maximal de lignes traiter (Limit) en fonction de vos besoins. Dans ce scnario, notre tableau comporte une ligne den-tte. Dans la liste droulante Schema, choisissez le mode Built-In. Cliquez ensuite sur le bouton [...] du champ Edit schema pour dfinir les donnes passer au composant tFileOutputDelimited. Dfinissez les donnes prsentes dans le fichier lire (file2 dans ce scnario). Pour plus dinformations sur les types de schmas, consultez les chapitres Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Le schma du fichier file2 est compos de cinq colonnes : Num, Ref, Price, Quant et Tax. Dans lditeur graphique, slectionnez le composant tFileOutputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileOutputDelimited.
1129
Composants File
tFileExist
Dfinissez le champ Property Type en mode Built-in. Dans le champ File name, appuyez simultanment sur Ctrl+Espace pour accder la liste des variables et slectionner FILENAME. Dfinissez les sparateurs de lignes et de champs dans leurs champs respectifs Row separator et Field Separator. Cochez la case Include Header car, dans cet exemple, le fichier file2 comprend un en-tte. Dfinissez le champ Schema en mode Built-in puis cliquez sur le bouton Sync columns pour synchroniser le schma du fichier de sortie (file1) avec le schma du fichier dentre (file2).
Dans lditeur graphique, slectionnez le composant tMsgBox. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tMsgBox.
1130
Composants File
tFileExist
Cliquez sur le lien If pour en afficher les proprits dans la vue Basic settings. Dans le panneau Condition, appuyez simultanment sur Ctrl+Espace pour accder la liste de variable et slectionner EXISTS. Entrez un point dexclamation avant la variable pour en inverser le sens.
Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
Une bote de dialogue apparat pour confirmer que le fichier nexiste pas. Cliquez sur OK pour fermer cette bote de dialogue et continuer lexcution du Job. Le fichier manquant, file1 dans cet exemple, est crit sous la forme dun fichier dlimit lendroit pralablement dtermin.
1131
Composants File
tFileInputARFF
tFileInputARFF
Proprits du tFileInputARFF
Famille de composant File/Input
Fonction Objectif
Le composant tFileInputARFF lit un fichier ARFF ligne ligne et spare des champs simples. Ce composant ouvre un fichier et le lit ligne par ligne afin de le diviser en champs et denvoyer ces champs au composant suivant, comme dfini par le schma, via une connexion Row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant connexion de base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio. File Name Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Basic settings
1132
Composants File
tFileInputARFF
Advanced settings
Encoding
Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour collecter les informations de log au niveau du composant.
Utilisez ce composant pour lire un fichier et sparer les champs laide du sparateur spcifi.
Scnario : Afficher le contenu dun fichier ARFF

Le scnario suivant dcrit un Job form de deux composants ayant pour objectif de lire ligne ligne un fichier ARFF, de slectionner des donnes dlimites et dafficher la sortie dans la console de la vue Run. Un fichier ARFF se prsente comme suit :
Un fichier ARFF est gnralement compos de deux parties : la description de la structure des donnes, correspondant aux lignes qui dbutent par @attribute, et les donnes brutes, qui suivent lexpression @data. Dans lespace de modlisation du studio de Talend Open Studio, crez le Job suivant :
1133
Composants File
tFileInputARFF
Glissez et dposez le composant tFileInputARFF de la Palette dans lespace de modlisation graphique. Glissez et dposez de la mme manire le composant tLogRow Cliquez-droit sur le composant tFileInputARFF et slectionnez Row > Main dans le menu contextuel. Puis glissez ce lien vers le tLogRow et relchez lorsque le symbole de prise de courant apparat. La transmission du flux de donne entre les deux composants est ainsi tablie. Double-cliquez sur le tFileInputARFF pour paramtrer ce composant. Dans la vue Component, renseignez le champ File Name. Parcourez votre rpertoire de fichiers, afin de slectionner le fichier .arff. Dans le champ Schema, slectionnez Built-In. Cliquez sur le bouton [...] du champ Edit schema, pour effectuer manuellement la description des colonnes du fichier lu. Cliquez autant de fois sur le bouton que ncessaire pour dcrire chacune des colonnes du fichier lu. Dans cet exemple, 17 colonnes sont ajoutes, nommez-les comme suit :
Pour chacune des colonnes slectionnez le Type : chaine de caractres (String). Cliquez sur OK.
1134
Composants File
tFileInputARFF
Dans lespace de modlisation, double-cliquez sur le composant tLogRow pour afficher sa vue Component. Cliquez sur le bouton [...] du champ Edit schema pour vrifier que le schma a bien t propag. Si ce nest pas le cas, cliquez sur le bouton Sync columns.
Conservez les paramtres par dfaut. Appuyez sur F6 pour excuter votre Job.
La console affiche les donnes contenues dans le fichier ARFF dlimites par une barre verticale (sparateur par dfaut).
1135
Composants File
tFileInputDelimited
tFileInputDelimited
Proprits du tFileInputDelimited
Fonction Objectif
Le composant tFileInputDelimited lit un fichier ou un flux de donnes ligne par ligne et spare des champs simples. Ce composant lit un fichier ou un flux de donnes ligne par ligne, afin de le diviser en champs et denvoyer ses champs au composant suivant, comme dfini par le schma, via une connexion Row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File name/Stream File name : Chemin daccs et nom du fichier, et/ou variable traiter. Stream : Flux de donnes traiter. Les donnes doivent pralablement tre mises en flux afin dtre rcupres par le tFileInputDelimited via la variable INPUT_STREAM disponible dans la liste dauto-compltion (Ctrl+Espace). Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Row separator Field separator CSV options Chane (ex : \nsous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Cochez cette case pour prendre en compte les paramtres spcifiques aux fichiers CSV, notamment la manire de protger les caractres dans le champ Escape char et le type de guillemet dans le champ Enclosure. Nombre de lignes ignorer au dbut dun fichier. Nombre de lignes ignorer la fin dun fichier. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ni traite.
Basic settings
Header Footer Limit
1136
Composants File
tFileInputDelimited
Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Skip empty rows Uncompress as zip file Die on error Cochez cette case pour ignorer les lignes vides. Cochez cette case pour dcompresser le fichier dentre. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux.
Advanced settings
Extract lines at random Cochez cette case pour dfinir le nombre de lignes extraire de faon alatoire. Encoding Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes. Cochez cette case pour synchroniser chaque ligne avec le schma dentre. Cochez la case devant le nom de chacune des colonnes dont vous voulez supprimer les espaces de dbut et de fin de champ. Cochez cette case pour sparer les lignes avant de sparer les champs. Cochez cette case pour collecter les donnes de log au niveau du composant.
Trim all columns Check each row structure against schema Check columns to trim
Split row before field tStatCatcher Statistics
1137
Composants File
tFileInputDelimited
Utilisation
Utilisez ce composant pour lire un fichier et sparer les champs laide du sparateur spcifi. Il permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1703 du composant tFileInputXML.
Scnario 1 : Afficher le contenu dun fichier dlimit

Le scnario suivant est un Job de deux composants ayant pour objectif de lire les lignes dun fichier, de slectionner des donnes dlimites et dafficher la sortie dans la console de la vue Run.
Cliquez et dposez un composant tFileInputDelimited de la Palette dans lespace de modlisation. De la mme manire, cliquez et dposez un composant tLogRow. Cliquez-droit sur le composant tFileInputDelimited et slectionnez Row > Main dans le menu contextuel. Puis glissez ce lien vers le tLogRow et relchez lorsque le symbole de prise de courant apparat. Slectionnez le composant tFileInputDelimited nouveau et dfinissez ses proprits dans longlet Basic Settings :
Renseignez le chemin daccs au fichier dans le champ File Name. Ce champ est obligatoire. Dfinissez le sparateur de lignes dans le champ Row separator afin didentifier la fin dune ligne. Puis dfinissez le sparateur de champs dans Field separator pour dlimiter les champs composant une ligne. Dans ce scnario, len-tte (Header) et le pied de page (Footer) nont pas besoin dtre dfinis. Et la limite de lignes lues (Limit ) est de 50 pour cet exemple. Slectionnez soit local (Built-in) soit distant (Repository) comme Schema pour dfinir les donnes qui passent par le composant tLogRow.
Composants File
tFileInputDelimited
Vous pouvez charger et/ou diter le schma laide de la fonction Edit Schema. Voir galement : Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Assurez-vous que la case Skip empty rows est coche afin dignorer les lignes vierges. Saisissez lencodage utilis dans le fichier dentre. Ce paramtre permet dassurer lhomognit de lencodage dans tous les fichiers dentre et de sortie. Slectionnez le composant tLogRow et dfinissez le sparateur de champs de la sortie affiche. Voir galement : Proprits du tLogRow, page 1399. Cochez la case Print schema column name in front of each value pour rcuprer le libell des colonnes dans la sortie affiche. Cliquez sur la vue Run, puis cliquez sur Run pour excuter le Job. Le fichier est lu ligne par ligne et les champs extraits sont affichs dans la console, tel que dfini dans les proprits du composant (dans longlet Basic settings).
La console affiche len-tte suivi des donnes lues par le Job.
Scnario 2 : Lire les donnes dun fichier distant en mode stream

Le scnario suivant illustre un Job quatre composants ayant pour objectif de rcuprer les donnes dun fichier volumineux quasiment aussitt quelles ne sont lues afin dviter lattente du tlchargement de lensemble du fichier de donnes, et les affichent dans la console de la vue Run.
Dposez les composants suivants dans lespace de modlisation : tFileFetch, tSleep, tFileInputDelimited, et tLogRow. Reliez les composants tSleep et tFileInputDelimited via un lien de type Trigger > OnComponentOk et reliez les composants tFileInputDelimited et tLogRow via un lien de type Row > Main.
1139
Composants File
tFileInputDelimited
Double-cliquez sur le composant tFileFetch pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
Dans la liste Protocol, slectionnez le type de protocole vous permettant daccder au serveur sur lequel est stock votre fichier de donnes. Dans le champ URI, saisissez lURI daccs au serveur sur lequel est stock votre fichier. Cochez la case Use cache to save the resource pour mettre les donnes de votre fichier en mmoire cache. Cette option permet dutiliser le mode stream pour transfrer les donnes du fichier. A partir de lespace de modlisation, double-cliquez sur le composant tSleep pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits. Par dfaut, le champ Pause du composant tSleep correspond 1 seconde. Laissez ce paramtre par dfaut. Il met le deuxime Job en pause afin de laisser le temps au premier Job contenant le tFileFetch de lire les donnes du fichier. A partir de lespace de modlisation, double-cliquez sur le composant tFileInputDelimited pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
1140
Composants File
tFileInputDelimited
Dans le champ File name/Stream : - Effacez le contenu par dfaut. - Faites un Ctrl+Espace pour faire apparatre la liste des variables disponibles partir de ce composant. - Slectionnez la variable tFileFetch_1_INPUT_STREAM dans la liste dauto-compltion, la varaible suivante apparat dans le champ Filename : ((java.io.InputStream)globalMap.get("tFileFetch_1_INPUT_STRE AM")). Dans la liste Schema, slectionnez Built-in et cliquez sur le bouton [...] ct du champ Edit schema pour dcrire la structure des donnes du fichier que vous souhaitez rcuprer. Le fichier US_Employees est compos de six colonnes : ID, Employee, Age, Address, State, EntryDate.
Cliquez sur le bouton [+] pour ajouter les six colonnes et paramtrez-les comme indiqu sur la capture dcran ci-dessus. Cliquez sur OK. A partir de lespace de modlisation, double-cliquez sur le composant tLogRow pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits. Cliquez sur Edit schema et assurez-vous que le schma est rcupr du composant prcdent. Sinon, cliquez sur Sync Columns pour le rcuprer. A partir de lespace de modlisation, cliquez sur la vue Job et sur longlet Extra.
1141
Composants File
tFileInputDelimited
Cochez la case Multi thread execution afin dexcuter les deux Jobs en parallle, sachant que le deuxime Job a un retard dune seconde par rapport au premier comme dfini dans le tSleep. Cette option permet donc de rcuprer les donnes grce au tFileDelimited quasiment ds leur lecture par le tFileFetch. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Les donnes sont affiches dans la console ds leur lecture.
1142
Composants File
tFileInputEBCDIC
tFileInputEBCDIC
Ce composant requiert lutilisation dun JDK Sun.
Proprits du tFileInputEBCDIC
Fonction Objectif
Le composant tFileInputEBCDIC lit un fichier EBCDIC et extrait les donnes en fonction du schma slectionn. Ce composant ouvre un fichier et le lit afin disoler les donnes en fonction des schmas dcrivant la structure de ce fichier et denvoyer ses donnes et schmas au(x) composant(s) suivant(s) via une connexion Row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Schema(s) Data file Xc2j file Ajoutez les diffrents schmas transmettre en sortie. Slectionnez le fichier EBCDIC contenant les donnes traiter. Slectionnez le fichier xc2j de transformation. Cochez cette case pour collecter les donnes de log au niveau du composant.
Basic settings
Utilisez ce composant pour lire un fichier EBCDIC et sparer les donnes en fonction des schmas identifis dans ce fichier.
Scnario : Extraire les donnes dun fichier EBCDIC et alimenter une base de donnes
Ce scnario utilise lassistant [Copybook Connection] guidant lutilisateur travers les diffrentes tapes de cration de connexion au fichier Copybook et de rcupration des schmas EBCDIC. Lassistant [Copybook Connection] est uniquement disponible pour les utilisateurs . Si vous tes utilisateur de Talend Open Studio ou Talend On Demand, vous devez configurer les proprits du composant tFileInputEBCDIC manuellement.
Le scnario suivant est un Job de quatre composants ayant pour objectif de lire un fichier au format EBCDIC contenant des informations sur les clients et sur leurs transactions financires, den extraire et de transformer les donnes, et de crer deux tables dans une base de donnes partir des deux schmas, clients et transactions, extraits du fichier EBCDIC dorigine.
1143
Composants File
tFileInputEBCDIC
Ce scnario Java utilise lassistant EBCDIC Connection pour crer une connexion au fichier Copybook et gnrer un fichier xc2j permettant de rcuprer et de transformer les diffrents schmas du fichier. Crez une connexion au fichier Copybook dcrivant la structure de votre fichier EBCDIC. Dans ce scnario la connexion Copybook est appele EBCDIC. Rcuprez le schma du fichier. Une fois la connexion au fichier Copybook cre et les schmas rcuprs laide des assistants EBCDIC et Schema, ils apparaissent sous le noeud Metadata > Copybook. Ces nouveaux schmas sappellent Schema01, Schema04 et Schema05.
Pour rcuprer les diffrentes structures du fichier et les utiliser dans Talend Open Studio : A partir du Repository, dposez le schma Schema01 dans lditeur graphique. Cette manipulation crera le composant dentre tFileInputEBCDIC. Dposez le composant tMysqlOutput de la Palette dans lespace de modlisation graphique. Double-cliquez sur le tFileInputEBCDIC pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
1144
Composants File
tFileInputEBCDIC
Les champs Property Type, Schema(s), Data file et Xc2j file sont automatiquement renseigns par les informations de la mtadonne. Le champ Property Type indique la mtadonne utilise pour le composant. Le champ Schema indique quel schma est transmis au composant suivant. Le champ Data file indique le chemin daccs au fichier de donnes EBCDIC. Le champ Xc2j file indique le chemin daccs au fichier permettant dextraire le schma dcrivant la structure du fichier EBCDIC. Si vous tes en mode Built-In, renseignez ces champs manuellement. Dans lditeur graphique, cliquez-droit sur le tFileInputEBCDIC, slectionnez Row > row_Schema01_1 dans le menu contextuel puis cliquez sur le tMysqlOutput pour relier les composants entre eux. Double-cliquez sur le composant tMysqlOutput pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
Dans la liste Property Type, slectionnez le mode Repository et cliquez sur le bouton [...] pour slectionner la connexion la base de donnes centralise dans les mtadonnes du Repository. Les champs Host, Port, Database, Username et Password seront renseigns automatiquement. Si vous tes en mode Built-In, renseignez ces champs manuellement.
1145
Composants File
tFileInputEBCDIC
Dans le champ Table, renseignez le nom de la table crer qui contiendra les donnes extraites du fichier EBCDIC. Ici, appelez cette table ebcdic_01. Dans le champ Action on table, slectionnez loption Create table pour crer la table. A ce stade, le Job rcupre le schma Schema01 du fichier EBCDIC et le transmet ainsi que ses donnes correspondantes vers la base de donnes. Vous souhaitez maintenant rcuprer le schma et les donnes du schma Schema04 du fichier EBCDIC, effectuer une transformation sur ces donnes et les transmettre cette mme base de donnes. Pour cela : Cliquez et dposez les composants tMap et tMysqlOutputBulkExec dans lditeur graphique. Double-cliquez sur le composant tFileInputEBCDIC pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
Dans le champ Schema(s), cliquez sur le bouton [+] pour ajouter une ligne. Cliquez sur cette ligne puis sur le bouton [...] qui apparat en fin de champ. Dans la bote de dialogue qui souvre, slectionnez Create schema from repository pour rcuprer le schma dfini dans la mtadonne EBCDIC puis dans la liste droulante, slectionnnez le schma Schema04. Cliquez sur OK pour fermer la bote de dialogue. Si vous navez pas rcupr le schma dans les mtadonnes du repository, slectionnez Create schema for built-in, puis spcifiez manuellement le nom et la description de votre schma. Les deux schmas Schema01 et Schema04 apparaissent dans le champ Schema(s) du composant tFileInputEBCDIC. Pour relier les composants entre eux, cliquez-droit sur le tFileInputEBCDIC, slectionnez Row > row_Schema04_1 dans le menu contextuel puis cliquez sur le tMap. Puis cliquez-droit sur le tMap, glissez le lien jusquau tMysqlOutputBulkExec et relachez le bouton. Dans la bote de dialogue qui souvre, indiquez le nom de la sortie ebcdic_04. Double-cliquez sur le tMap pour ouvrir son diteur
1146
Composants File
tFileInputEBCDIC
Slectionnez toutes les colonnes de la table row_Schema04_1 et glissez-les dans la table ebcdic_04. Dans le tableau ebcdic_04 de la zone Schema editor en bas de lditeur, cliquez sur le bouton [+] pour ajouter une colonne au schma. Nommez cette colonne SUM_AG_NUMBER. Dans la table row_Schema04_1 gauche de lditeur, appuyez sur Ctrl puis slectionnez les colonnes CC01404_L_11_MENAG_1_1 et CC01404_AG_CAM_1_1 et glissez-les dans la nouvelle colonne SUM_AG_NUMBER de la table ebcdic_04, et ajoutez le signe + entre les deux colonnes concatnes pour obtenir : row_04_1.CC01404_L_11_MENAG_1_1 + row_04_1.CC01404_AG_CAM_1_ 1. Cliquez sur OK pour validere vos modifications et fermer lditeur. Dans lditeur graphique, double-cliquez sur le tMysqlOutputBulkExec pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
1147
Composants File
tFileInputEBCDIC
Dans la liste Property Type, slectionnez le mode Repository et cliquez sur le bouton [...] pour slectionner la connexion la base de donnes centralise dans les mtadonnes du Repository. Les champs Host, Port, Database, Username et Password seront renseigns automatiquement. Si vous tes en mode Built-In, renseignez ces champs manuellement. Dans le champ Table, renseignez le nom de la table crer qui contiendra les donnes extraites du fichier EBCDIC. Dans le champ Action on table, slectionnez loption Create table pour crer la table. Enregistrez votre Job via Ctrl+S et cliquez sur la vue Run, cochez les cases Statistics et Exec time puis cliquez sur Run pour excuter le Job. Les deux tables ont t cres dans la base de donnes et contiennent la structure ainsi que les donnes, de transactions et clients, du fichier EBCDIC dorigine.
1148
Composants File
tFileInputExcel
tFileInputExcel
Proprits du tFileInputExcel
Famille du composant File/Input
Fonction Objectif
Le composant tFileInputExcel lit un fichier Excel (.xls ou .xlsx) ou un flux de donnes et en extrait les donnes ligne par ligne. Ce composant lit un fichier Excel ou un flux de donnes ligne par ligne pour le scinder en champs et envoie les champs tel que dfinis dans le schma au composant suivant du Job via une connexion Row. Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de connexion et enregistrer les paramtres de connexion au fichier Excel que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de fichier, consultez le chapitre Configurer un schma File Excel du Guide Utilisateur de Talend Open Studio . File name/Stream File name : Chemin daccs et nom du fichier, et/ou variable traiter. Stream : Flux de donnes traiter. Les donnes doivent pralablement tre mises en flux afin dtre rcupres par le tFileInputExcel via la variable INPUT_STREAM disponible dans la liste dauto-compltion (Ctrl+Espace). Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. All sheets Sheet list Cochez cette case pour traiter toutes les feuilles du fichier Excel. Cliquez sur le bouton [+] pour ajouter de nouvelles lignes la liste de feuilles traiter : Sheet (name or position) : renseignez le nom ou la position de la feuille traiter. Use Regex : cochez cette case si vous utilisez une expression rgulire pour filtrer les feuilles selon un modle. Nombre de lignes ignorer au dbut dun fichier.
Basic settings
Header
1149
Composants File
tFileInputExcel
Footer Limit Affect each sheet(header&footer) Die on error
Nombre de lignes ignorer la fin dun fichier. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ni traite. Cochez cette case pour appliquer les paramtres dfinis dans les champs Header et Footer toutes les feuilles traites. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject. Renseignez lintervalle de colonnes que vous voulez traiter : la position de la premire colonne dans le champ First column et celle de la dernire colonne traiter dans le champ Last column. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
First column et Last column
Advanced settings
Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes. Lorsque cette case est dcoche, le tableau Check column to trim saffiche, vous permettant de slectionner la ou les colonne(s) dont vous souhaitez retirer les espaces de dbut ou de fin. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour lire les nombres en valeur relle. Cochez cette case pour ignorer les lignes vides.
Trim all columns
Encoding
Read real values for numbers Stop to read on empty rows
1150
Composants File
tFileInputExcel
Dont validate the cells Ignore the warning
Cochez cette case pour ne pas effectuer de validation des donnes. Cochez cette case pour ignorer les avertissements gnrs par des erreurs sur le fichier Excel.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Utilisez ce composant pour lire un fichier Excel (.xls ou .xlsx) et sparer les champs en fonction dun schma dfini. Ce composant permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1703 du composant tFileInputXML.
Scnario associ
1151
Composants File
tFileInputFullRow
tFileInputFullRow
Proprits du tFileInputFullRow
Famille du composant Fonction Objectif File/Input
Le composant tFileInputFullRow lit un fichier donn ligne par ligne. Le tFileInputFullRow ouvre un fichier quil lit ligne par ligne et passe les lignes compltes au composant suivant comme dfini dans le schma, via une connnexion de type Row. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant tFileInputFullRow prcdent. File Name Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Row separator Header Footer Limit Skip empty rows Die on error Chane (ex : \n sous Unix) sparant les lignes. Nombre de lignes ignorer en dbut de fichier. Nombre de lignes ignorer la fin dun fichier. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ni traite. Cochez cette case pour ignorer les lignes vides. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Basic settings
Advanced settings
Encoding
Extract lines at random Cochez cette case pour dfinir le nombre de lignes extraire de faon alatoire.
1152
Composants File
tFileInputFullRow
Utilisation
Utilisez ce composant pour lire des lignes compltes dans un fichier dlimit pouvant tre trs gros. Ce composant permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1703 du composant tFileInputXML.
Scnario : Lire des lignes compltes dans un fichier dlimit

Le scnario suivant cre un Job deux composants permettant de lire des lignes compltes partir dun fichier et dafficher les donnes de sortie dans la console de log Run. A partir de la Palette, cliquez-dposez les composants tFileInputFullRow et tLogRow dans lditeur graphique. Cliquez-droit sur le composant tFileInputFullRow et connectez-le au tLogRow laide dun lien de type Row Main.
Dans lditeur graphique, slectionnez le composant tFileInputFullRow. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileInputFullRow.
Dans longlet Basic settings, configurez le champ Schema en mode Built-In. Clickez sur le bouton [...] du champ Edit schema pour voir les donnes passer au composant tLogRow. Notez que le schma est en read-only et ne comporte quune seule colonne, line.
1153
Composants File
tFileInputFullRow
Dans le champ File Name, renseignez le chemin daccs au fichier traiter ou cliquez sur le bouton [...]. Ce champ est obligatoire. Dans ce scnario, le fichier lire sappelle test5 et comporte trois lignes comprenant chacune deux champs spars par un point-virgule. Dans le champ Row separator, renseignez le sparateur permettant didentifier les fins de ligne. Dans la champ Header, indiquez la valeur 1. Dans ce scnario, ni le pied-de-page ni le nombre de lignes traiter ne sont renseigns. Dans lditeur graphique, slectionnez le tLogRow puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations, consultez le tLogRow, page 1399. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
Le composant tFileInputFullRow lit les trois lignes une une sans tenir compte des sparateurs de champs et les lignes compltes apparaissent dans la console Run.
Pour extraire des lignes uniquement les champs, utilisez le tExtractDelimitedFields, le tExtractPositionalFields et le tExtractRegexFields. Pour plus dinformations, consultez les composants tExtractDelimitedFields, page 1512, tExtractPositionalFields, page 1517 et tExtractRegexFields, page 1519.
1154
Composants File
tFileInputJSON
tFileInputJSON
Proprits du tFileInputJSON
Famille de composant File
Fonction Objectif
Le composant tFileInputJSON lit un fichier JSON et extrait les donnes en fonction du schma slectionn. Ce composant ouvre un fichier et le lit afin disoler les donnes en fonction des schmas dcrivant la structure de ce fichier et denvoyer ses donnes et schmas au(x) composant(s) suivant(s) via une connexion Row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement.. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Use URL Cochez cette case pour rcuprer les donnes directement partir dinternet. URL : entrez le chemin daccs lURL partir de laquelle rcuprer les donnes. Nom du fichier partir duquel rcuprer les donnes. Column : reflte le schma tel quil est dfini dans lditeur Edit Schema. JSONPath Query : Saisissez les champs extraire de la structure JSON dentre. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux.
Basic settings
Filename Mapping
Advanced settings
1155
Composants File
tFileInputJSON
Encoding
Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant. Utilisation Limitation Utilisez ce composant pour lire un fichier JSON et sparer les donnes en fonction des schmas identifis dans ce fichier. n/a
Scnario : Extraire les donnes des champs dun fichier au format JSON
Ce scnario est de deux composants et permet de lire un fichier au format JSON et den extraire les donnes.
Glissez les composants tFileInputJSON de la famille File et tLogRow de la famille Logs & Errors partir de la Palette dans le Job designer. Reliez les composants entre eux via des connexions de type Main > Row. Double-cliquez sur le composant tFileInputJSON pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
Si votre schma est dj stock sous le noeud Db Connections dans le Repository, slectionnez loption Repository dans le champ Schema Type puis choisissez les mtadonnes appropries partir de la liste.
1156
Composants File
tFileInputJSON
Si vous navez encore dfini aucun schma, slectionnez loption Built-in et renseignez manuellement les informations de connexion et la structure des donnes dans un schma. Cliquez sur le bouton [...] du champ Edit schema pour ouvrir une bote de dialogue dans laquelle vous pouvez dfinir le schma afficher en sortie. Cliquez sur le bouton OK pour fermer la bote de dialogue. Dans la zone Mapping, les lments du champ Column sont alors renseigns automatiquement selon le schma que vous venez de dfinir. Dans cet exemple, le schma comporte quatre colonnes FirstName, LastName, Address et City. Dans le champ Filename, renseignez le chemin daccs au fichier JSON dont vous voulez rcuprer les donnes. Si les donnes sont stockes distance sur Internet, cochez la case Use URL puis, de la mme faon, renseignez lURL daccs au fichier traiter. Dans cet exemple, le fichier trait se prsente comme suit :
Dans la zone Mapping, les lignes du champ Column sont dj renseignes. Pour chacune delle, indiquez dans le champ JSONPath query le niveau de larborescence sur lequel rcuprer les donnes. Dans le Job designer, double-cliquez sur le composant tLogRow pour paramtrer ses proprits dans longlet Basic settings de la vue Component.
Cliquez sur le bouton Sync Columns pour rcuprer le schma du composant prcdent. Enregistrez le Job et appuyez sur F6 pour lxecuter.
1157
Composants File
tFileInputJSON
Le Job retourne les informations du client selon les paramtres slectionns dans le schma.
1158
Composants File
tFileInputLDIF
tFileInputLDIF
Proprits du tFileInputLDIF
Le composant tFileInputLDIF lit un fichier LDIF donn ligne par ligne. Le tFileInputLDIF ouvre un fichier quil lit ligne par ligne et passe les lignes compltes au composant suivant comme dfini dans le schma, via une connnexion de type Row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. add operation as prefix when the entry is modify type Value separator Cochez cette case pour afficher le mode doprations effectues. Saisissez le sparateur requis pour dcouper les donnes dans un fichier donn. Par dfaut, le sparateur utilis est ,. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject.
Basic settings
Die on error
Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant tFileInputLDIF prcdent. Advanced settings Encoding Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
1159
Composants File
tFileInputLDIF
Utilisation
Utilisez ce composant pour lire des lignes compltes dans un fichier dlimit pouvant tre trs gros.Ce composant permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1703 du composant tFileInputXML.
Scnario associ
Pour un scnario associ, consultez Scnario : Ecrire des donnes dans un fichier LDIF page 1217.
1160
Composants File
tFileInputMail
tFileInputMail
Proprits du tFileInputMail
Le composant tFileInputMail lit len-tte et le contenu du fichier e-mail dfini. Ce composant permet dextraire les donnes standard des emails. File name Schema et Edit Schema Entrez le fichier email source. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma dans cette vue, le schma devient automatiquement ponctuel (built-in). Cliquez sur Sync columns pour rcuprer le schma partir du composant prcdent dans le Job. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Attachment export directory Mail parts Renseignez le chemin daccs au rpertoire dans lequel exporter les pices jointes. Column : Ce champ est automatiquement renseign avec les colonnes dfinies dans le schma que vous avez propag. Mail part : Saisissez ltiquette den-tte ou de corps de message afficher dans la sortie. Multi value : Cochez cette case pour chaque colonne comportant des champs valeurs multiples. Field separator : Saisissez le sparateur de valeur des champs valeurs multiples.
1161
Composants File
tFileInputMail
Die on error
Cochez cette case pour arrter lexcution du Job lorsquune erreur survient. Dcochez la case pour la ligne en erreur et terminer le processus avec les lignes sans erreur. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Advanced settings
Ce composant traite un flux de donnes et par consquant requiert un composant de sortie. n/a
Scnario : Extraire des champs cls dun email

Ce scnario est constitu de deux composants et a pour objectif dextraire certains champs cls et den afficher les valeurs dans la console Run.
Cliquez et dposez les composants tFileInputMail et tLogRow. Reliez les composants laide dun lien de type Row Main. Double-cliquez sur le composant tFileInputMail pour afficher longlet Basic settings de la vue Component et configurer les paramtres de base :
Dans le champ File Name, slectionnez le fichier email traiter. Renseignez manuellement le chemin daccs ou cliquez sur le bouton [...] pour parcourir vos dossiers jusquau fichier choisi. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir la bote de dialogue permettant de dfinir le schma afficher en sortie.
1162
Composants File
tFileInputMail
Dfinissez votre schma en incluant toutes les colonnes que vous souhaitez retrouver dans le flux de sortie. Dans cet exemple, le schma comporte quatre colonnes Date, Author, Object et Status. Une fois dfini, cliquez sur OK pour fermer la bote de dialogue et propager le schma dans le tableau Mail parts. Dans la colonne Mail part du tableau, saisissez les cls standards des parties header (en -tte) et body (corps de message) qui seront utilises pour retrouver les valeurs envoyer en sortie. Cochez la case Multi Value pour chacune des cls standards pouvant se retrouver plus dune fois dans votre fichier dentre. Dfinissez si besoin un sparateur pour les valeurs de ces cls dans le champ Separator. Double-cliquez sur le composant tLogRow pour afficher longlet Basic settings de la vue Component et configurer les paramtres de base. Dfinissez le composant tLogRow afin que les valeurs affiches soient spares par un retour chariot. Sous Windows, saisissez \n entre guillemets doubles. Pour plus dinformations sur le composant tLogRow, consultez le chapitre tLogRow, page 1399. Enregistrez votre Job puis appuyez sur F6 pour lexcuter et afficher le flux de sortie dans la console de la vue Run Job.
Les valeurs cls den-tte sont extraites comme spcifi dans le tableau Mail parts. En effet, la date de rception, lauteur, le sujet ainsi que les diffrents statuts contenus dans lemail sont affichs.
1163
Composants File
tFileInputMSDelimited
Proprits du tFileInputMSDelimited
Le composant tFileInputMSDelimited permet de lire des fichiers dlimits multi structure complexes. Le tFileInputMSDelimited ouvre le fichier multi structure complexe, en lit la structure (schmas) puis utilise des liens de type Row pour envoyer les champs, tels quils ont t dfinis dans les diffrents schmas, vers les composants suivants dans le Job. Multi Schema Editor Lditeur de schmas [Multi Schema Editor] permet de construire et de configurer le flux de donnes dans un fichier dlimit multi structure pour pouvoir associer un schma pour chaque sortie. Pour plus dinformations, consultez Lditeur de schmas Multi Schema Editor, page 1164. Les schmas dfinis dans lditeur de schmas [Multi Schema Editor], ainsi que les types denregistrements correspondants, saffichent automatiquement dans le tableau Output. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Cochez cette case pour collecter les donnes de log au niveau du composant.
Basic settings
Output
Die on error
Advanced settings
Trim all columns Advanced separator (for numbers)
Utilisez ce composant pour lire des fichiers dlimits multi structure et dfinissez un sparateur de champs pour diffrencier les champs contenus dans ces fichiers.
Lditeur de schmas Multi Schema Editor

Lditeur [Multi Shema Editor] vous permet de dfinir : le chemin daccs au fichier source, les proprits du fichier source, la structure des donnes pour chacun des schmas de sortie.
1164
Composants File
Lorsque vous dfinissez la structure de chaque schma de sortie dans le [Multi Schema Editor], le nom des colonnes des diffrentes structures saffichent automatiquement dans la liste du schma dentre des composants qui suivent le tFileInputMSDelimited. Vous pouvez cependant dfinir la structure des donnes directement dans la vue Basic settings de chacun de ces composants.
Le [Multi Schema Editor] permet galement de slectionner un schma qui servira de source (cl primaire) aux donnes entrantes, afin den assurer lunicit. Lditeur utilise ce procd de mapping pour associer tous les schmas traits dans le fichier dlimit au schma source de ce mme fichier.
Lditeur souvre en affichant par dfaut la premire colume. Cette colume contient gnralement lindicateur de type des enregistrements. Une fois ouvert, vous pouvez cependant dfinir comme cl primaire nimporte quelle colonne du schma en cochant la case associe.
Limage ci-dessous donne un aperu de lditeur de schmas [Multi Schema Editor].
1165
Composants File
Pour des informations plus dtailles sur le Multi Schema Editor, consultez le Scnario : Lecture dun fichier dlimit multi structure, page 1166.
Scnario : Lecture dun fichier dlimit multi structure

Le prsent scnario sert crer un Job en Java permettant de lire trois schmas dans un mme fichier dlimit et den afficher la structure sur la console de la vue Run. Le fichier dlimit trait dans ce scnario se prsente comme suit :
1166
Composants File
A partir de la Palette, cliquez sur les composants suivants et dposez-les dans lditeur graphique : un composant tFileInputMSDelimited et trois tLogRow. Double-cliquez sur le tFileInputMSDelimited pour ouvrir lditeur Multi Schema Editor.
Cliquez sur le bouton Browse... ct du champ File name pour indiquer o se trouve le fichier dlimit multi-schma que vous voulez traiter. Dans la zone File Settings, renseignez : -le type dencodage de votre fichier source, partir de la liste droulante. Cette option permet de garantir une certaine cohrence entre tous les fichiers dentre et de sortie. -les sparateurs de champ et de ligne utiliss dans le fichier source.
Cochez la case Use Multiple Separator et configurez les champs qui suivent si diffrents sparateurs de champs sont utiliss pour sparer les schmas du fichier source.
Un aperu des donnes du fichier source apparat automatiquement dans le panneau daffichage Preview.
1167
Composants File
La colonne Column 0, qui contient gnralement lindicateur de type des enregistrements est slectionne par dfaut. Vous pouvez cependant dfinir nimporte quelle autre colonne comme cl primaire en cochant sa case associe.
Cliquez sur le bouton Fetch Codes droite du panneau Preview pour cataloguer les types de schmas et les enregistrements du fichier source. Dans ce scnario, le fichier source comporte trois types de schmas (A, B, C). A partir du panneau daffichage Fetch Codes, cliquez sur chacun des trois types pour que la structure de leurs donnes saffiche dans le panneau Preview.
1168
Composants File
Cliquez dans les cellules de la ligne Name et choisissez le nom des colonnes de chacun des schmas slectionns. Dans ce scnario, les colonnes se lisent comme suit : -Schma A : Type, DiscName, Author, Date, -Schma B : Type, SongName, -Schma C : Type, LibraryName. Vous devez prsent dfinir, partir des donnes dentre, la cl primaire qui permettra de conserver leur unicit (dans ce scnario, il sagit de DiscName). Il vous faut pour cela : Slectionner, partir du panneau daffichage Fetch Codes, le schma contenant la colonne que vous voulez dfinir comme cl primaire (dans ce scnario, il sagit du schma A) pour en afficher la structure. Cliquer dans la cellule Key correspondant la colonne DiscName et cocher la case qui saffiche alors.
Cliquer nimporte o dans lditeur pour que la mention false, dans la case Key, devienne true. Vous devez maintenant indiquer le schma pre auquel vous voulez rattacher les autres schmas fils (dans ce scnario, il sagit de DiscName). Il vous faut pour cela : Slectionner le schma B, partir du panneau daffichage Fetch Codes, puis cliquer sur le bouton flche droite pour le dplacer vers la droite. Faire de mme pour le schma C.
1169
Composants File
Le champ Cardinality nest pas obligatoire. Il vous permet de dterminer le nombre (ou lintervalle) de champs des schmas fils rattachs au schma pre. Cependant, si vous entrez un nombre ou un intervalle inexact et essayez dexcuter le Job, un message derreur apparatra.
Dans le [Multi Schema Editor], cliquez sur le bouton OK pour valider tous les changements que vous venez deffectuer et fermer lditeur de schmas. Les trois schmas dfinis, ainsi que les types denregistrements correspondants, saffichent automatiquement dans la vue Basic settings du composant tFileInputMSDelimited.
Dans lditeur graphique, effectuez un clic-droit sur le composant tFileInputMSDelimited et connectez-le aux trois autres composants tLogRow1, tLogRow2 et tLogRow3 laide des liens respectifs row_A_1, row_B_1 et row_C_1.
Les trois schmas que vous avez dfinis dans lditeur [Multi Schema Editor] sont automatiquement communiqus aux trois composants tLogRow.
1170
Composants File
Si ncessaire, cliquez sur le bouton Edit schema dans la vue Basic settings de chacun des composants tLogRow pour avoir un aperu des structures de donnes en entre et en sortie, telles que vous les avez dfinies dans le Multi Schema Editor, ou pour les modifier.
Enregistrez votre Job puis appuyez sur F6 pour lexcuter. Le fichier dlimit multi-schma est lu ligne par ligne et les champs extraits sont affichs dans la console Run Job comme dfini dans le [Multi Schema Editor].
1171
Composants File
tFileInputMSPositional
Proprits du tFileInputMSPositional
Fonction Objectif
Le composant tFileInputMSPositional permet de lire des schmas multiples partir dun fichier positionnel. Le tFileInputMSPositional ouvre le fichier multi structure complexe, en lit la structure (schmas) puis utilise des liens de type Row pour envoyer les champs, tels quils ont t dfinis dans les diffrents schmas, vers les composants suivants dans le Job. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Row separator Schema Identifier Field Position Records Chane de caractres (ex : \n sous Unix) sparant les lignes. Position de la chane de caractres identifiant les diffrents schmas. Schema : dfinissez autant de schmas que ncessaire. Schema Identifier value : valeur de la chane de caractres identifiant les diffrents schmas. Saisissez le nom de la colonne. Pattern : Chane de caractres reprsentant la longueur de chacune des colonnes du schma correspondant, spares par des virgules. Vrifiez que les valeurs dfinies dans ce champ sont cohrentes avec le schma dfini. Reject incorrect row size : cochez les cases des schmas pour lesquels vous nacceptez pas une taille de ligne incorrecte. Parent key column : Saisissez le nom de la colonne cl parente. Key column : Saisissez le nom de la colonne cl. Nombre de lignes ignorer au dbut du fichier. Nombre de lignes ignorer la fin du fichier. Nombre maximal de lignes traiter. Si Limit = 0, aucune ligne ne sera lue ni traite.
Basic settings
Skip from header Skip from footer Limit
1172
Composants File
Die on parse error
Dcochez cette case pour passer les lignes contenant des erreurs de parse et terminer le traitement avec les lignes sans erreur. Dcochez cette case pour passer les lignes dont le type den-tte est inconnu et terminer le traitement avec les lignes sans erreurs. Cochez cette case afin de pouvoir traiter de longues lignes (ceci est ncessaire pour traiter des lignes contenant plus de 100 000 caractres). Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Die on unknown header type Advanced settings Process long rows (needed for processing rows longger than 100,000 characters wide) Advanced separator (for numbers)
Trim all columns Encoding
Utilisation
Utilisez ce composant pour lire un fichier positionnel multi-schma et servez-vous dune valeur spcifiant lemplacement pour sparer les champs. Ce composant permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1703 du composant tFileInputXML.
Scnario associ
Pour un scnario associ, consultez le Scnario : Lecture dun fichier dlimit multi structure, page 1166 du composant tFileInputMSDelimited.
1173
Composants File
tFileInputMSXML
tFileInputMSXML
Proprits du tFileInputMSXML
Famille du composant XML ou File/Input
Fonction Objectif
Le composant tFileInputMSXML permet de lire des schmas multiples partir dun fichier XML structur et de les restituer en sortie. Le tFileInputMSXML ouvre le fichier multi structure complexe, en lit la structure (schmas) puis utilise des liens de type Row pour envoyer les champs, tels quils ont t dfinis dans les diffrents schmas, vers les composants suivants dans le Job. File Name Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Root XPath query Enable XPath in column Schema XPath loop But lose the order Racine de larborescence XML sur laquelle se base la requte. Cochez cette case si vous souhaitez dfinir un chemin XPath dans le champ Schema XPath loop du tableau Outputs. Cette option nest disponible quavec le mode de gnration dom4j. Vrifiez donc que ce mode a bien t slectionn dans la liste Generation mode dans longlet Advanced settings de votre composant. Si vous utilisez cette option, les donnes ne seront pas retournes dans lordre. Outputs Schema : dfinissez autant de schmas que ncessaire. Schema XPath loop : noeud ou chemin XPath de larborescence XML sur lequel la boucle est base. Si vous souhaitez utiliser un chemin XPath dans le champ Schema XPath loop, vous devez pralablement cocher la case Enable XPath in column Schema XPath loop but lose the order. XPath Queries : renseignez les champs extraire de la structure XML dentre. Create empty row : cochez les cases des schmas pour lesquels vous voulez crer des lignes vides. Die on error Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur.
Basic settings
1174
Composants File
tFileInputMSXML
Advanced settings
Trim all column Generation mode Encoding
Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes. Slectionnez le mode de gnration dans la liste. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant. Limitation n/a
Scnario : Lecture dun fichier XML multi structur

Le prsent scnario sert crer un Job en Java permettant de lire un fichier XML multi-schma et den afficher la structure sur la console de la vue Run. Le fichier XML trait dans ce scnario se prsente comme suit :
Cliquez et dposez le composant tFileInputMSXML et deux composants tLogRow dans lditeur graphique. Double-cliquez sur le tFileInputMSXML pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
1175
Composants File
tFileInputMSXML
Dans le champ File Name, slectionnez le fichier XML que vous souhaitez traiter. Dans le champ Root XPath query, indiquez la racine de larborescence XML sur laquelle sera base la requte. Cochez la case Enable XPath in column Schema XPath loop But lose the order si vous souhaitez dfinir un chemin XPath dans le champ Schema XPath loop du tableau Outputs. Dans ce scnario, vous nutilisez pas cette option. Cliquez sur le bouton [+] pour ajouter des lignes au tableau Outputs dans lesquelles vous pouvez dfinir les schmas de sortie. Dans le tableau Outputs, cliquez dans chaque cellule Schema et cliquez sur le bouton [...] pour saisir le nom du schma dans la bote de dialogue qui souvre.
Saisissez le nom du schma de sortie et cliquez sur OK. Lditeur de schma du tFileInputMSXML apparat. Dfinissez le schma dj dfini dans le tableau Outputs. Effectuez cette procdure pour chaque schma de sortie que vous crez. Dans ce scnario, lobjectif est de dfinir deux schmas de sortie : record et book. Dans lditeur graphique, cliquez-droit sur le tFileInputMSXML et connectez-le aux tLogRow1 et tLogRow2 laide des liens record et book.
1176
Composants File
tFileInputMSXML
Dans la vue Basic settings et dans la cellule Schema XPath loop, indiquez le noeud de larborescence XML sur laquelle sera base la requte. Dans la cellule XPath Queries, indiquez les champs extraire du fichier XML dentre. Cochez les cases Create empty row ct des noms des schmas dans lesquels vous souhaitez crer des lignes vides. Enregistrez votre Job et appuyez sur F6 pour lancer son excution. Les schmas spcifis sont extraits du fichier XML multi-schma et sont affichs dans la console. Le fichier XML multi-schma est lu ligne par ligne et les champs extraits sont affichs dans la console de la vue Run.
1177
Composants File
tFileInputPositional
Proprits du tFileInputPositional
Fonction Objectif
Le composant tFileInputPositional lit un fichier ou un flux de donnes ligne par ligne et extrait les champs selon un modle (pattern). tFileInputPositional lit un fichier ou un flux de donnes ligne par ligne, spare les champs tels que dfinis par le schma et passe les donnes extraites au composant suivant via une connnexion de type Row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File name/Stream File name : Chemin daccs et nom du fichier, et/ou variable traiter. Stream : Flux de donnes traiter. Les donnes doivent pralablement tre mises en flux afin dtre rcupres par le tFileInputPositional via la variable INPUT_STREAM disponible dans la liste dauto-compltion (Ctrl+Espace). Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Row separator Use byte length as the cardinality Customize Chane (ex : \n sous Unix) sparant les lignes. Cochez cette case pour permettre la prise en charge des caractres deux octets dans ce composant. Pour cette fonction, JDK 1.6 est requis. Cochez cette case pour personnaliser le format des donnes du fichier positionnel et renseignez les colonnes du tableau Formats. Column : Slectionnez la colonne que vous souhaitez personnaliser. Size : Saisissez la taille correspondant la colonne. Padding char : Saisissez entre guillemets le caractre de remplissage utilis afin quil soit supprim de votre champ. Le caractre par dfaut est un espace. Alignment : Slectionnez le paramtre dalignement appropri. Longueurs spares par des virgules, interptes comme une chane de caractres entre guillemets. Vrifiez que les valeurs saisies dans ce champ sont cohrentes avec le schma dfini. Cochez cette case pour ignorer les lignes vides. Cochez cette case pour dcompresser le fichier dentre.
Basic settings
Pattern
Skip empty rows Uncompress as zip file
1178
Composants File
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject. Nombre de lignes ignorer au dbut dun fichier. Nombre de ligne ignorer la fin dun fichier. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ni traite. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Header Footer Limit Schema et Edit Schema
Advanced settings
Needed to process rows longer than 100 000 characters Advanced separator Trim all columns Check columns to trim
Cochez cette case si les lignes traiter dans le fichier dentre font plus de 100 000 caractres de long. Cochez cette case pour modifier les sparateurs de lignes utiliss. Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans toutes les colonnes. Cochez la case devant le nom de chacune des colonnes dont vous souhaitez supprimer les espaces de dbut et de fin de champ. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Encoding
Utilisez ce composant pour lire un fichier et sparer les champs laide du sparateur spcifi. Ce composant permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1703 du composant tFileInputXML.
1179
Composants File
Scnario : Transformer un fichier positionnel en XML

Le scnario suivant construit un Job avec deux composants, qui a pour objectif de lire les donnes dun fichier positionnel en entre et de rendre des donnes slectionnes en sortie (selon leur position) dans un fichier XML.
Cliquez et dposez un composant tFileInputPositional de la Palette dans lespace de modlisation. Le fichier contient des lignes de donnes, dans cet exemple, contract nr, customer references et insurance numbers. Cliquez-dposez un composant tFileOutputXML. Ce fichier recevra les rfrences de manire structure. Cliquez-droit sur le composant tFileInputPositional et slectionnez une connexion Row > Main. Glissez cette connexion vers le composant tFileOutputXML et relchez la souris lorsque le symbole de prise de courant apparat. Slectionnez le composant tFileInputPositional nouveau et dfinissez ses proprits. Les proprits de ce Job sont de type Built-in pour ce scnario. Par consquent, les informations de proprits sont renseignes pour ce Job seulement et ne peuvent tre rutilises pour un autre Job, contrairement des proprits de type Repository.
Renseignez le chemin daccs au fichier dans le champ File Name. Ce champ est obligatoire. Puis dfinissez le sparateur de lignes (Row separator) permettant didentifier la fin de la ligne : le retour chariot par dfaut. Si ncessaire, cochez la case Use byte length as the cardinality pour permettre la prise en charge des caractres deux octets. Puis dans le champ Pattern dfinissant les champs dune ligne. Le pattern est une srie de longueurs correspondant aux valeurs de champs du fichier en entre. Les valeurs doivent tre saisies entre guillemets simples et spares par une virgule. Veillez ce que les valeurs saisies correspondent la longueur des champs dfinis dans le schma.
1180
Composants File
Dans ce scnario, les champs den-tte (Header), de pied de page (Footer) et de limite (Limit) nont pas besoin dtre dfinis. Slectionnez le type de schma (Schema) pour dfinir les donnes transmettre au composant tFileOutputXML. Vous pouvez slectionner et/ou modifier le schma via la fonction Edit Schema. Pour ce schma, dfinissez trois colonnes, respectivement Contracts, CustomerRef et InsuranceNr correspondant aux trois valeurs de longueurs dfinies.
Puis dfinissez les proprits du composant de sortie. Saisissez le chemin daccs au fichier XML de sortie.
Saisissez une (ou plusieurs) balise racine (Root tag) pour envelopper la structure en sortie XML. Dans ce cas, la balise est ContractsList. Dfinissez la balise de la ligne (Row tag) qui dfinit chaque ligne. Dans ce cas, la balise est ContractRef.
1181
Composants File
Cochez la case Column name as tag name pour rutiliser le libell des colonnes du schma dentre comme nom de balise pour structurer le fichier XML de sortie. Par dfaut, le nom de balise est field, quel que soit le type de valeur dans les colonnes. Saisissez lencodage (Encoding) du fichier dentre. Notez que pour linstant la vrification de lencodage nest pas fonctionnellement supporte. Slectionnez le type de schma dans le champ Schema. Si vous avez dj mis en place la connexion entre les composants dentre et de sortie du Job, la propagation du schma est automatique. Sinon, cliquez sur Sync columns pour les synchroniser. Passez la vue Run et cliquez sur le bouton Run pour xecuter le Job. Le fichier est lu ligne par ligne et divis en champs bass sur les longueurs dfinies prcdemment dans le champ Pattern. Vous pouvez louvrir dans nimporte quel diteur XML standard.
1182
Composants File
tFileInputProperties
Proprits du tFileInputProperties
Le composant tFileInputProperties lit un fichier texte ligne par ligne et extrait les champs. Il ouvre un fichier texte quil lit ligne par ligne, spare les champs sur le modle cl=valeur. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Pour ce composant, le schma est en lecture seule puisque les fichiers sont structurs sur le modle cl=valeur. Slectionnez le format de votre fichier .properties ou .ini. .properties : fichier de configuration dont les donnes sont disposes sur deux lignes et structures de la manire suivante cl=valeur. .ini : fichier de configuration dont les donnes sont disposes sur deux lignes, structures de la manire suivante cl=valeur.et regroupes en sections. Retrieve Mode : - Retrieve All pour rcuprer lintgralit du fichier, - Retrieve Sections pour rcuprer les sections du fichier, - Retrieve by section pour rcuprer les donnes contenues dans la section spcifie dans le champ Section Name. Section Name : saisissez le nom de la section sur laquelle effectuer lopration ditration. File Chemin daccs et nom du fichier, et/ou variable traiter. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Calculate MD5 Hash Cochez cette case pour que lalgorithme vrifie que le fichier est bien tlcharg. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
File format
Advanced settings
Encoding
Utilisez ce composant pour lire un fichier et sparer les donnes en fonction de la structure cl=valeur du fichier.
1183
Composants File
Scnario : Lire et mapper la cl et les valeurs de fichiers properties et alimenter un glossaire

Le scnario suivant est un Job de quatre composants lisant deux fichiers proprits en anglais et en franais. Ces donnes sont ensuite mises en correspondance afin de constituer un glossaire.
Les fichiers de proprits utiliss pour ce scnario sont des fichiers contenant les chanes de caractres utiliss pour la localisation du composant tMysqlInput de Talend Open Studio.
Cliquez-glissez deux composants tFileInputProperties de la famille File > Input dans le Job designer, un composant tMap de la famille Processing et un composant tLogRow de la famille Log & Errors. Reliez les composants entre eux via des connexions Row > Main Le second fichier, FR, est utilis comme flux de rfrence . Double-cliquez sur le premier composant tFileInputProperties pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
1184
Composants File
Dans le champ File Format, slectionnez le format de votre fichier. Dans le champ File Name, cliquez sur le bouton [...] et slectionnez le fichier .properties anglais que vous souhaitez utiliser. Rptez cette procdure avec le deuxime composant et le fichier franais :
Double-cliquez sur le composant tMap pour ouvrir son diteur :
1185
Composants File
Slectionnez toutes les colonnes de la table English_terms et glissez-les vers la table de sortie. Slectionnez la colonne key de la table English_terms et glissez-la dans la colonne key de la table French_terms. Dans le tableau glossary de la zone Schema editor en bas du tMap, renommez le champ value en EN puisquil contiendra les valeurs du fichier anglais. Cliquez sur le bouton [+] pour ajouter une ligne au tableau glossary et renommez-la FR. Dans le champ Length, configurez la taille maximum du champ 255. Dans le coin suprieur gauche de lditeur du tMap, slectionnez la colone value de la table English_terms et glissez-la dans la colonne FR de la table French_terms. Cliquez sur OK pour valider vos changements et fermer lditeur. Dans le Job designer, double-cliquez sur le composant tLogRow pour paramtrer ses proprits dans longlet Basic settings de la vue Component. Cliquez sur le bouton Sync Columns pour rcuprer le schma du composant prcdent. Enregitrez votre Job et appuyez sur F6 pour lexcuter.
1186
Composants File
Le glossaire apparat dans la console de la vue Run avec dans la premire colonne le nom de la cl, dans la deuxime le terme du fichier anglais et dans le troisime colonne le terme correspondant du fichier franais.
1187
Composants File
tFileInputRegex
tFileInputRegex
Proprits du tFileInputRegex
Fonction Objectif
Puissant composant qui peut remplacer bon nombre des composants File. Il requiert des connaissances avances en rdaction dexpressions rgulires. Le tFileInputRegex lit un fichier ou un flux de donnes ligne par ligne afin de le diviser en champs laide dexpressions rgulires et denvoyer les champs dfinis dans le schma au composant suivant via une connexion Row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File name/Stream File name : Chemin daccs et nom du fichier, et/ou variable traiter. Stream : Flux de donnes traiter. Les donnes doivent pralablement tre mises en flux afin dtre rcupres par le tFileInputRegex via la variable INPUT_STREAM disponible dans la liste dauto-compltion (Ctrl+Espace). Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Row separator Regex Chane (ex : \n sous Unix) pour distinguer les lignes. Ce champ est compatible Perl ou Java et peut contenir plusieurs lignes. Intgrez vos expressions rgulires le subpattern correspondant aux champs extraire. En Java, doublez les antislashes en regexp La syntaxe Regexp est diffrente en Java et en Perl et requiert des guillemets respectivement doubles et simples. Header Footer Limit Nombre de lignes ignorer en dbut de fichier. Nombre de lignes ignorer en fin de fichier. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ni traite.
Basic settings
Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository.
1188
Composants File
tFileInputRegex
Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et stock dans le Repository. Ainsi, il est rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Skip empty rows Die on error Cochez cette case pour ignorer les lignes vides. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Advanced settings
Encoding
Ce composant sert lire un fichier et en sparer les champs selon les Regex dfinies.Ce composant permet de crer un flux de donnes laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1703 du composant tFileInputXML. n/a
Limitation
Scnario : Transformer en fichier Regex en Positional

Le scnario suivant est un Job form de deux composants, qui a pour objectif de lire les donnes dun fichier dentre utilisant des expressions rgulires et transformant les donnes ainsi dlimites en sortie positionnelle.
Cliquez et dposez un composant tFileInputRegex et tFileOutputPositional de la Palette dans lespace de modlisation. Cliquez droit sur le composant tFileInputRegex et slectionnez une connexion Row > Main dans le menu contextuel. Faites glisser cette connexion vers le composant tFileOutputPositional et relchez lorsque le symbole appropri apparat.
1189
Composants File
tFileInputRegex
Slectionnez tFileInputRegex nouveau et dfinissez ses proprits dans longlet Component :
Les proprits de ce Job sont de type built-in. Par consquent, elles ne sont dfinies que pour ce Job et ne peuvent tre partages avec dautres utilisateurs. Indiquez le chemin daccs au fichier dans le champ File Name. Ce champ est obligatoire. Dfinissez le sparateur de lignes, dans le champ Row separator, afin didentifer la fin dune ligne. Puis, dans Regular expression, dfinissez lexpression rgulire utiliser pour dlimiter les champs dune ligne qui seront passs au composant suivant. Vous pouvez utiliser Java ou Perl et saisir une expression rgulire multiligne si vous en avez besoin.
Veillez utiliser la bonne expression rgulire en fonction de la langue de gnration de code que vous utilisez. En effet, la syntaxe nest pas la mme en Java et en Perl. Assurez-vous aussi dinsrer les expressions rgulires dans des guillemets simples ou doubles en fonction de la langue de gnration.
Assurez-vous dinclure dans cette expression tous les sous-patterns des champs extraire. Dans ce scnario, ignorez les champs en-tte (Header), pied de page (Footer) et limite (Limit). Dans le Schema, slectionnez local (Built-in) comme type de schma des donnes transfrer au composant tFileOutputPositional. Vous pouvez charger ou crer partir de la fonction Edit Schema. Puis dfinissez les proprits du deuxime composant :
1190
Composants File
tFileInputRegex
Saisissez le chemin daccs au fichier de sortie. Saisissez lencodage du fichier de sortie dans le champ Encoding. Notez que pour linstant, lhomognit de lencodage dans un Job nest pas vrifie. Slectionnez le type de schma dans Schema. Cliquez sur le bouton Sync columns pour rcuprer en sortie le schma dentre. Passez longlet Run et cliquez sur le bouton Run pour excuter le Job. Le fichier dentre est lu ligne par ligne puis divis en champs dlimits selon la valeur de lexpression regulire dfinie. Vous pouvez ouvrir le fichier de sortie avec tout diteur standard.
1191
Composants File
tFileInputXML
tFileInputXML
Le tFileInputXML appartient deux familles de composants : File et XML. Pour plus dinformations concernant le composant tFileInputXML, consultez tFileInputXML page 1699.
1192
Composants File
tFileList
tFileList
Proprits du tFileList
Le composant tFileList fait une boucle sur les fichiers et/ou les dossiers dun rpertoire donn. Le tFileList rcupre un groupe de fichiers et/ou de dossiers suivant un masque donn et fait une boucle sur chacun deux. Directory FileList Type Chemin daccs au rpertoire de fichiers. Slectionnez partir de la liste droulante le type de source dentre utilis : Files pour des fichiers, Directories pour des rpertoires ou Both pour les deux types. Cochez cette case si le ou les rpertoires slectionn(s) contiennent des sous-dossiers. Cochez cette case pour crer un filtre selon la casse des noms des fichiers.
Include subdirectories Case Sensitive
Generate Error if no Cochez cette case pour tre averti par un message file found derreur que la recherche de fichier na pas abouti. Use Glob Expressions as Filemask (Unchecked means Perl5 Regex Expressions) Files Cette case est coche par dfaut et permet de filtrer les rsultats laide dexpressions globales (Glob Expressions). Dcochez la case pour filtrer les rsultats laide dexpressions de type regex Perl5. Cliquez sur le bouton [+] pour ajouter des lignes de filtre : Filemask : entrez un nom de fichier ou masque de fichier utilisant un caractre spcial ou une expression rgulire.
1193
Composants File
tFileList
Order by
Les dossiers sont lists en premier, puis viennent ensuite les fichiers. Vous pouvez dfinir les priorits des dossiers et des fichiers de diffrentes manires : By default : par ordre alphabtique, par dossier puis par fichier, By file name :par ordre alphabtique ou ordre alphabtique invers, By file size : du plus petit lger au plus lourd ou du plus lourd au plus lger, By modified date : du plus rcent au plus ancien ou du plus ancien au plus rcent. Lorsque vous slectionnez loption By file name, si deux fichiers ont le mme nom, le classement seffectuera via loption By modified date. Si vous choisissez loption By file size, et que les fichiers font le mme poids, ils seront classs selon loption By file name. Si vous slectionnez loption By modified date et que la date de modification est la mme pour deux fichiers, alors ils seront classs selon loption By file name.
Order action
Choisissez de classer par ordre : ASC : ordre alphabtique / du plus petit au plus grand / du plus ancien au plus rcent. DESC : linverse de lordre alphabtique / du plus grand au plus petit / du plus ancien au plus rcent. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Advanced settings
Utilisation
Le composant tFileList fournit une liste de fichiers dun rpertoire donn sur lequel il fait une boucle.
1194
Composants File
tFileList
Global Variables
Current File Name : indique le nom actuel du fichier. Disponible comme variable Flow. Retourne une chane de caractres. Current File Name with Path : indique le nom actuel du fichier et son chemin daccs. Disponible comme variable Flow. Retourne une chane de caractres. Current File Extension : indique lextension actuelle du fichier. Disponible comme variable Flow. Retourne une chane de caractres. Current File Directory : indique le chemin daccs au dossier ou au sous-dossier dans lequel le fichier est stock. Disponible comme variable Flow. Retourne une chane de caractres. Number of files : indique le nombre de fichiers sur lesquels a t effectue une boucle. Disponible comme variable Flow. Retourne un entier. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Row : Iterate. Trigger : OnSubjobOk, OnSubjobError, OnComponentOk, OnComponentError. Les liens dentre (dun composant un autre) : Row : Iterate. Trigger : Run If, OnSubjobOk, OnSubjobError, Synchronize, Parallelize. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur de Talend Open Studio.
Scnario : Itration sur un rpertoire

Le scnario suivant dcrit un Job de trois composants, qui a pour objectif de rpertorier les fichiers dun rpertoire donn, de lire chaque fichier par itration, de slectionner les donnes dlimites et dafficher ces donnes en sortie dans la console Run.
1195
Composants File
tFileList
Cliquez et dposez les composants suivants : tFileList, tFileInputDelimited et tLogRow dans lespace de modlisation. Cliquez-droit sur le composant tFileList et connectez-le au composant tFileInputDelimited via une connexion de type Row Iterate. Puis connectez le tFileInputDelimited au tLogRow laide dune connexion de type Row Main. Paramtrez ensuite les proprits respectives des composants. Tout dabord, slectionnez le composant tFileList et cliquez sur longlet Basic settings :
Dans le champ Directory, indiquez le chemin daccs des fichiers traiter. Pour faire apparatre ce chemin daccs dans le Job lui-mme, utilisez le nom de champ (__DIRECTORY__) qui apparat en bulle info lorsque vous passez le souris sur le champ Directory. Saisissez cette rfrence dans le champ Label Format de longlet View.
Dans le champ FileList Type, slectionnez loption Files. Dfinissez le champ Case sensitive sur Yes pour prendre la casse en compte dans cet exemple. Laissez la case Use Glob Expressions as Filemask coche si vous utilisez des expressions globales pour filtrer les fichiers. Dans le champ Filemask, indiquez un masque de fichier. Utilisez les caractres spciaux si besoin est.
1196
Composants File
tFileList
Paramtrez les proprits du deuxime composant tFileInputDelimited :
Dans le champ File Name, nommez le fichier laide dune variable contenant son chemin daccs, tel que vous lavez renseign dans les proprits du tFileList. Appuyez sur Ctrl+Espace pour accder la liste dautocompltion des variables. Slectionnez la variable globale ((String)globalMap.get("tFileList_1_CURRENT_FILEPATH")) si vous travaillez en Java, ou $_globals{tFileList_1}{CURRENT_FILEPATH} si vous travaillez en Perl. De cette manire, tous les fichiers du rpertoire source peuvent tre traits. Renseignez les autres champs comme pour un fichier dlimit tFileInputDelimited standard. Voir galement : Proprits du tFileInputDelimited, page 1136. Slectionnez le composant de sortie tLogRow et renseignez le sparateur de champs qui saffichera dans la console de longlet Run. Voir galement : Proprits du tLogRow, page 1399.
1197
Composants File
tFileList
Litration seffectue sur le rpertoire dfini. Chacun des fichiers contenus dans ce rpertoire est lu. Puis les donnes dlimites sont transmises au composant de sortie qui les affiche dans la console Log de la vue Run. Pour dautres scnarios utilisant le tFileList, consultez tFileCopy page 1121
1198
Composants File
tFileOutputARFF
tFileOutputARFF
Proprits du tFileOutputARFF
Famille de composant File/Output
Le composant tFileOutputARFF transmet des donnes vers un fichier ARFF. Ce composant crit un fichier ARFF contenant des donnes organises en fonction du schma dfini. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant connexion de base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le chapitre Configurer une connexion DB du Guide Utilisateur de Talend Open Studio . File name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Attribute Define Reflte le schma tel quil est dfini dans la bote de dialogue Edit schema. Column : Nom de la colonne. Type : Type des donnes de la colonne. Pattern : Saisissez le modle (pattern) de la donne si ncessaire. Saisissez le nom de la relation. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository.
Relation Append Schema et Edit Schema
1199
Composants File
tFileOutputARFF
Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Create directory if not Cette case est coche par dfaut. Cette option permet exists de crer le dossier contenant le fichier de sortie sil nexiste pas dj. Advanced settings Dont generate empty file Cochez cette case pour empcher la gnration dun fichier vide.
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Global Variables Utilisez ce composant pour crire dans un fichier ARFF des donnes rcupres dautres composants laide dune connexion de type Row. Les variables globales peuvent tre utilises comme paramtres dans la plupart des champs de proprits descurseur dans le champ puis appuyez sur Ctrl+Espace. Double-cliquez sur la variable afin de populer le champ. La principale variable globale associe au tFileOutputARFF est : Number of Lines : indique le nombre de lignes traites. Disponible comme variable After. Connections Liens de sortie (dun composant un autre) : Row : Main. Trigger : OnSubjobOk, OnSubjobError, Run if. Liens dentre (dun composant un autre) : Row : Main, Reject, Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio. Limitation n/a
Scnario associ
Pour un scnario associ, consultez le Scnario : Afficher le contenu dun fichier ARFF, page 1133.
1200
Composants File
tFileOutputDelimited
Proprits du tFileOutputDelimited
Le composant tFileOutputDelimited transmet des donnes vers un fichier dlimit. Ce composant crit un fichier dlimit contenant des donnes organises en fonction du schma dfini. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Row Separator Field Separator Append Include Header Compress as zip file Schema et Edit schema Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire pour sparer les champs du fichier de sortie. Cochez cette option pour ajouter de nouvelles lignes la fin du fichier. Cochez cette case pour tenir compte de len-tte dans le fichier de sortie. Cochez cette case pour compresser en zip le fichier de sortie. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository.. Si vous effectuez des modifications, le schma passe automatiquement en mode Built-In. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Composants Talend Open Studio 1201
Composants File
Sync columns
Cliquez sur ce bouton pour synchroniser le schma de sortie avec celui dentre. La fonction Sync ne saffiche que si une connexion de type Row est lie au composant de sortie. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Cochez cette case pour prendre en compte les paramtres spcifiques aux fichiers CSV, notamment la manire de protger les caractres dans le champ Escape char et le type de guillemet dans le champ Enclosure.
Advanced settings
CSV options
Create directory if not Cette case est coche par dfaut. Cette option permet exists de crer le dossier contenant le fichier de sortie sil nexiste pas dj. Split output in several files Si le fichier dlimit en sortie est volumineux, vous pouvez le scinder en plusieurs fichiers. Rows in each output file : saisissez le nombre de lignes pour chaque fichier de sortie. Cochez cette case pour personnaliser le nombre de lignes crire avant de vider le tampon. Row Number: Nombre de lignes crire avant de vider le tampon. Cochez cette case pour que lcriture se fasse en mode ligne. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour empcher la gnration dun fichier vide.
Output in row mode Encoding
Dont generate empty file
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Utilisez ce composant pour crire dans un fichier dlimit des donnes rcupres dautres composants laide dune connexion de type Row et sparer les champs laide dun sparateur. n/a
Limitation
Scnario : Ecrire des donnes dans un fichier dlimit

Ce scnario est constitu de trois composants et a pour objectif dextraire certaines donnes dun fichier contenant des informations sur les clients (customers) puis de les crire dans un fichier dlimit en sortie.
1202
Composants File
Dans lexemple suivant, vous avez enregistr les informations de connexion et les mtadonnes dans le Repository afin de faciliter leur rutilisation. Pour plus dinformations sur comment centraliser les donnes de connexion et autres mtadonnes dun fichier dans le Repository, consultez Configurer un schma File Delimited page 304.
Dans le Repository, ouvrez le noeud File Delimited de la catgorie Metadata. Cliquez sur la mtadonne customers, et dposez-le dans lespace de modlisation graphique. Une bote de dialogue souvre et vous demande quel type de composant vous voulez dposer.
Cliquez sur tFileInputDelimited puis sur OK Un composant tFileInputDelimited contenant le nom de votre schma dentre saffiche dans lespace de modlisation graphique. Dposez un composant tMap et un composant tFileOutputDelimited de la Palette dans lespace de modlisation graphique. Reliez les composants laide dun lien Row > Main. Double-cliquez sur le composant afin dafficher la vue Component, afin de paramtrer les informations de connexion et dfinir le schma des donnes d'entre.
1203
Composants File
Si vous slectionnez Repository dans la liste Property Type, les champs suivants seront automatiquement renseigns partir des informations centralises dans le Repository. Si vous slectionnez le mode Built-In, renseignez les champs manuellement. Cliquez sur le bouton [...] correspondant au champ File Name. Dans la bote de dialogue de slection, parcourez le systme de fichiers et slectionnez le fichier dentre, dans cet exemple: customer.csv. Dans les champs Row et Field Separators, saisissez respectivement le sparateur de lignes "\n" et le sparateur de champs ";". Si votre fichier contient des en-ttes ou des pieds-de-page, indiquez le nombre de lignes concernes dans les champs Header et Footer. Dans cet exemple, saisissez 6 dans le champ Header. Vous pouvez galement dfinir une limite au nombre de lignes traites, en saisissant un nombre dans le champ Limit. Si vous avez slectionn le mode Repository, le schma du fichier sera automatiquement renseign. En mode Built-in, cliquez sur Edit Schema afin de dcrire les donnes dentre, et ainsi dfinir le schma trait. Le schma du fichier Customers se prsente comme suit :
1204
Composants File
Cliquez sur OK pour fermer la bote de dialogue. Double-cliquez sur le tMap afin douvrir son diteur.
Dans cet diteur, cliquez sur le bouton plus vert dialogue [Add a new output table].
en haut droite pour ouvrir la bote de
Saisissez un nom pour la table que vous souhaitez crer, row2 dans cet exemple. Cliquez sur OK pour valider vos modifications et fermer la bote de dialogue. Dans la table de gauche (row1), slectionnez les trois premires lignes (Id, CustomerName et CustomerAddress) en appuyant sur Ctrl, puis glissez-les dans la table de droite. Dans le Schema editor en bas de lditeur, changez le Type de la ligne RegisterTime, dans la table de droite, et passez-le en chane de caractres, String.
Cliquez sur OK pour enregistrer les modifications et fermer lditeur. Dans lespace de modlisation, double-cliquez sur le composant tFileOutputDelimited pour ouvrir la vue Component et dfinir ses proprits.
1205
Composants File
Dans le champ Property Type, slectionnez le mode Built-in et renseignez les champs suivants manuellement. Cliquez sur le bouton [...] correspondant au champ File Name. Dans la bote de dialogue de slection, indiquez le rpertoire de destination et le nom de votre fichier. Pour les champs Row et Field Separators, saisissez respectivement le sparateur de lignes \n et le sparateur de champs ;. Ils seront utiliss dans le fichier de sortie pour dlimiter les valeurs et les lignes. Cochez la case Include Header si vous souhaitez rcuprer le libell des colonnes. Cliquez sur Edit schema et assurez-vous que le schma est correctement rcupr du schma dentre. Si ncessaire, cliquez sur Sync Columns pour rcuprer le schma du composant prcdent. Pour excuter le job, appuyez sur F6.
Le fichier cr est dlimit par des points-virgules, il ne contient que les colonnes Id, CustomerName et CustomerAddress.
1206
Composants File
tFileOutputEBCDIC
tFileOutputEBCDIC
Ce composant requiert lutilisation dun JDK Sun.
Proprits du tFileOutputEBCDIC
Le composant tFileOutputEBCDIC crit un fichier EBCDIC partir de plusieurs fichiers de donnes diffrents ayant chacun un schma diffrent. Ce composant crit un fichier EBCDIC avec des donnes extraites de fichier(s) en fonction des schmas dcrivant leur structure. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Chemin daccs et nom du fichier EBCDIC de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Xc2j file Slectionnez le fichier xc2j de transformation. Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Advanced settings
Utilisation
Utilisez ce composant pour crire un fichier EBCDIC et sparer les donnes en fonction des schmas identifis dans les fichiers en entre.
Scnario : Crer un fichier EBCDIC partir de deux fichiers dlimits

Ce scnario utilise lassistant [Copybook Connection] guidant lutilisateur travers les diffrentes tapes de cration de connexion au fichier Copybook et de rcupration des schmas EBCDIC. Lassistant [Copybook Connection] est uniquement disponible pour les utilisateurs . Si vous tes utilisateur de Talend Open Studio ou Talend On Demand, vous devez configurer les proprits du composant tFileOutputEBCDIC manuellement.
Le scnario suivant est un Job de trois composants ayant pour objectif dcrire un fichier au format EBCDIC partir de deux fichiers dlimits ayant des schmas diffrents.
1207
Composants File
tFileOutputEBCDIC
Ce scnario Java utilise lassistant EBCDIC Connection pour crer une connexion au fichier Copybook et gnrer un fichier xc2j permettant de rcuprer et de transformer les diffrents schmas du fichier. Crez une connexion au fichier Copybook dcrivant la structure dun fichier EBCDIC. Dans ce scnario la connexion Copybook est appele EBCDIC. Rcuprez le schma du fichier. Une fois la connexion au fichier Copybook cre et les schmas rcuprs laide des assistants EBCDIC et Schema, ils apparaissent sous le noeud Metadata > Copybook. Ces nouveaux schmas sappellent Schema01, Schema04 et Schema05. Pour crer un fichier EBCDIC partir de deux fichiers dlimits dans Talend Open Studio : Cliquez et dposez deux composants tFileInputDelimited et un composant tFileOutputEBCDIC dans lditeur graphique. Pour les relier, cliquez-droit sur chaque composant tFileInputDelimited, slectionnez Row > Main dans le menu contextuel et cliquez sur le composant tFileOutputEBCDIC. Double-cliquez sur le premier tFileInputDelimited pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
Dans le champ File Name, slectionnez le fichier dlimit en cliquant sur le bouton [...]. Dans le champ Schema, slectionnez loption Repository, puis cliquez sur le bouton [...] et slectionnez le schma correspondant votre fichier dans la bote de dialogue, sous le noeud Copybook.
Composants File
tFileOutputEBCDIC
Dans le champ Header, indiquez le nombre de ligne en-tte rcuprer et passer au composant suivant : 1 dans ce scnario. Paramtrez les proprits du deuxime tFileInputDelimited de la mme manire que le premier. Double-cliquez sur le tFileOutputEBCDIC pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits :
Dans le champ Data file, indiquez le rpertoire et le nom du fichier EBCDIC qui sera cr partir des deux fichiers dlimits. Dans le champ Xc2j file, renseignez le chemin daccs au fichier permettant dextraire le schma dcrivant la structure du fichier EBCDIC. Enregistrez votre Job via Ctrl+S et cliquez sur la vue Run, cochez les cases Statistics et Exec time puis cliquez sur Run pour excuter le Job
1209
Composants File
tFileOutputExcel
tFileOutputExcel
Proprits du tFileOutputExcel
Le composant tFileOutputExcel transmet des donnes vers un fichier de type MS Excel. Ce composant crit un fichier MS Excel contenant des donnes organises en fonction du schma dfini. File name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Sheet name Include header Append existing file Nom de la feuille. Cochez cette case pour tenir compte de len-tte dans le fichier de sortie. Cochez cette option pour ajouter de nouvelles lignes la fin du fichier. Append existing sheet : Cochez cette option pour ajouter de nouvelles lignes la fin de la feuille Excel. Cochez cette case pour rajouter des informations dans des cellules prexistantes : First cell X : emplacement de la cellule sur laxe des abcisses. First cell Y : emplacement de la cellule sur laxe des ordonnes. Keep existing cell format : lorsque la case est coche, cette option permet de garder le format et lalignement de la cellule. Slectionnez dans la liste droulante la police utiliser. Cette case est dcoche par dfaut, vous pouvez alors prciser dans le tableau associ quelles sont les colonnes dfinir automatiquement. Cochez cette case pour que la taille de toutes les colonnes soit dfinies automatiquement. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio.
Is absolute Y pos.
Font Define all columns auto size
1210
Composants File
tFileOutputExcel
Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Sync columns Cliquez sur ce bouton pour synchroniser le schma de sortie avec celui dentre. La fonction Sync ne saffiche que si une connexion de type Row est lie au composant de sortie.
Advanced settings
Create directory if not Cette case est coche par dfaut. Cette option permet exists de crer le dossier contenant le fichier de sortie sil nexiste pas dj. Advanced separator (for numbers) Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Limitation Utilisez ce composant pour crire dans un fichier MS Excel des donnes rcupres dautres composants laide dune connexion de type Row. n/a
Scnario associ
Pour un scnario associ, consultez le Scnario: Extraire les donnes dun compte partir de SugarCRM, page 123.
1211
Composants File
tFileOutputJSON
tFileOutputJSON
Propits du tFileOutputJSON
Famille de composant File
Le composant tFileOutputJSON crit des donnes dans un fichier structur JSON de sortie. Ce composant reoit des donnes et les rcrit dans un bloc de donnes structures JSON, dans un ficher de sortie. File Name Name of data blocks Schema et Edit Schema Nom du fichier de sortie et son chemin daccs. Saisissez, entre guillemets doubles, un nom pour le bloc de donnes crire. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Sync columns Cliquez pour synchroniser le schma du fichier de sortie et le schma du fichier dentre. La fonction Sync ne saffiche que lorsquun lien Row connecte le composant de sortie.
Advanced settings
Create directory if not Cette case est coche par dfaut. Cette option permet exists de crer le dossier contenant le fichier de sortie sil nexiste pas dj. tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Utilisez ce composant pour rcrire des donnes reues dans un fichier de sortie structur JSON. n/a
Scnario : Ecrire un fichier JSON structur

Ce scnario de deux composants comprend un composant tRowGenerator qui gnre des donnes au hasard, ainsi quun composant tFileOutputJSON qui crit dans un fichier structur JSON de sortie.
Composants File
tFileOutputJSON
Glissez de la Palette dans lespace de modlisation graphique un tRowGenerator et un tFileOutputJSON. Liez les composants laide dun lien Row > Main. Double-cliquez sur le tRowGenerator pour dfinir ses Basic Settings dans la vue Component.
Si le schma dont vous avez besoin est dj stock sous le noeud Db Connections dans le noeud Repository, slectionnez Repository dans le champ Schema et choisissez les mtadonn dans la liste. Sinon, cliquez sur [...] ct du bouton Edit Schema afin dafficher la bote de dialogue et dfinir son schma.
Cliquez sur le bouton [+] pour ajouter les colonns dsires. Under Columns type in the column names. Sous Type, slectionnez le type dans la liste. Cliquez sur OK pour fermer la bote de dialogue Cliquez sur le bouton [+] ct de RowGenerator Editor pour ouvrir la bote de dialogue correspondante.
1213
Composants File
tFileOutputJSON
Sous Functions, slectionnez les fonctions pr-dfinies pour les colonnes, si besoin, ou slectionnez [...] pour dfinir les paramtres personnaliss des fonctions, dans longlet Function parameters. Saisissez le nombre de lignes gnrer, dans le champ Number of Rows for RowGenerator. Cliquez sur OK pour fermer la bote de dialogue. Cliquez sur le composant tFileOutputJSON afin de dfinir ses proprits, dans longlet Basic Settings de la vue Component.
Cliquez sur le bouton [...] pour parcourir votre rpertoire et dfinir o vous souhaitez gnrer le fichier de sortie JSON, puis saisissez un nom de fichier. Saisissez un nom pour le bloc de donnes gnrer dans le champ correspondant, entre guillemets doubles. Slectionnez Built-In dans la liste Schema. Cliquez sur Sync Columns afin de retrouver le schma du prcdent composant. Appuyez sur F6 pour excuter le Job.
Composants File
tFileOutputJSON
Les donnes du schma dentre sont crites dans un bloc de donnes structures JSON, dans le fichier de sortie.
1215
Composants File
tFileOutputLDIF
tFileOutputLDIF
Proprits du tFileOutputLDIF
Fonction Objectif
Le composant tFileOutputLDIF extrait des donnes vers un fichier LDIF qui peut ensuite tre charg dans un annuaire LDAP. Le tFileOutputLDIF crit ou modifie un fichier LDIF avec des donnes dlimites en entre selon le schma dfini. Peut galement supprimer le contenu dun fichier LDIF. File name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Wrap Change type Place un retour chariot aprs le nombre de caractres dfini. Slectionnez Add, Modify ou Delete pour respectivement crer un nouveau fichier LDIF, modifier ou supprimer un fichier LDIF. En cas de modification, paramtrez le type de modification apporte. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Sync columns Cliquez pour synchroniser le schma du fichier de sortie avec le schma du fichier dentre. La fonction Sync napparat quune fois la connexion Row mise en place entre les composants dentre et de sortie. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier.
Basic settings
Append Advanced settings
Create directory if not Cochez cette case pour crer un nouveau dossier si exists votre dossier de destination nexiste pas.
1216
Composants File
tFileOutputLDIF
Cochez cette case pour personnaliser le nombre de lignes crire avant de vider le tampon. Row Number: Nombre de lignes crire avant de vider le tampon. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour empcher la gnration dun fichier vide.
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant. Utilisation Limitation Utilisez ce composant pour crire un fichier LDIF laide des donnes provenant dautres composants relis par une connexion de type Row. n/a
Scnario : Ecrire des donnes dans un fichier LDIF

Ce scnario est constitu de deux composants et a pour objectif dextraire les donnes dune table de base de donnes puis dcrire ses donnes dans un fichier LDIF de sortie.
Cliquez et dposez les composants tMysqlInput et tFileOutputLDIF de la Palette dans lespace de modlisation. Connectez les deux composants laide dun lien Row > Main. Slectionnez le composant tMysqlInput et cliquez sur longlet Basic settings de la vue Component. Si vous conservez les informations de connexion votre base de donnes dans la zone Metadata du Repository, slectionnez loption Repository dans le champ Property type . De mme, dans le champ Schema type, slectionnez le schma correspondant parmi les mtadonnes si votre schma est galement stock dans le Repository. Tous les paramtres de connexion comme de schma sont ainsi rcuprs.
1217
Composants File
tFileOutputLDIF
Sinon, slectionnez Built-in dans les champs Property type et Schema et paramtrez manuellement votre connexion la base de donnes et les informations du schma. Puis double-cliquez sur le composant tFileOutpuLDIF et paramtrez ses proprits dans longlet Basic settings. Renseignez le nom et le chemin daccs au fichier LDIF. Sil nexiste pas, le Job se chargera de le crer. Dans le champ Wrap, saisissez le nombre de caractres contenus sur une ligne. Les caractres qui suivent seront automatiquement placs sur la ligne suivante.
Slectionnez Add dans le champ Change Type puisque, par dfinition, un fichier nouvellement cr est vide. Dans le cas dune modification, vous devrez dfinir la nature de la modification que vous souhaitez effectuer dans le fichier. Dans le champ Schema, slectionnez loption Built-in et cliquez sur Sync Columns pour rcuprer la dfinition du schma dentre. Appuyez sur F6 pour excuter le Job.
1218
Composants File
tFileOutputLDIF
Le fichier LDIF cr comporte les donnes de la table de la base de donnes et le type de changement effectu sur le fichier est, dans ce cas, dfini comme : addition.
1219
Composants File
tFileOutputMSDelimited
Proprits du tFileOutputMSDelimited
Famille du composant File/Output
Fonction Objectif
Le composant tFileOutputMSDelimited permet dcrire des schmas multiples dans un fichier dlimit. Le tFileOutputMSDelimited cre un fichier dlimit multi structure complexe laide de la structure des donnes (schmas) venant des diffrents flux dentre de type Row. File Name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Row Separator Field Separator Use Multi Field Separators Schemas Chane (ex : \n sous Unix) sparant les lignes. Caractre, chane ou expression rgulire sparant les champs. Cochez cette case attribuer un sparateur diffrent chacun des schmas, partir de la colonne Field separator du champ Schemas. La table est automatiquement charge avec des schmas rsultant des diffrents flux dentre connects au composant tFileOutputMSDelimited. Renseignez les relations de dpendance entre les diffrents schmas : Parent row : Saisissez le nom du flux pre (en fonction du nom du lien Row qui transfre les donnes). Parent key column : Saisissez le nom de la colonne cl du flux pre. Key column : Saisissez le nom de la colonne cl pour la ligne slectionne. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Cochez cette case pour prendre en compte les paramtres spcifiques aux fichiers CSV, notamment la manire de protger les caractres dans le champ Escape char et le type de guillemet dans le champ Text enclosure. Cette case est coche par dfaut. Cette option permet de crer le dossier contenant le fichier dlimit de sortie sil nexiste pas dj.
Basic settings
Advanced settings
CSV options
Create directory if not exists
1220
Composants File
Encoding
Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour annuler la gnration du fichier si celui-ci est vide. Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Dont generate empty file tStatCatcher Statistics
Utilisation
Utilisez ce composant pour crire un fichier dlimit multi structure et sparer les champs laide dun sparateur de champ.
Scnario associ
1221
Composants File
tFileOutputMSPositional
Proprits du tFileOutputMSPositional
Famille du composant File/Output
Le composant tFileOutputMSPositional permet dcrire des schmas multiples dans un fichier positionnel. Le tFileOutputMSPositional cre un fichier multi structure complexe laide de la structure des donnes (schmas) venant des diffrents flux dentre de type Row. File Name Chemin daccs et nom du fichier crer, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Row separator Schemas Chane (ex : \n sous Unix) sparant les lignes. La table est automatiquement charge avec des schmas rsultant des diffrents flux dentre connects au composant tFileOutputMSPositional. Renseignez les relations de dpendance entre les diffrents schmas : Parent row : Saisissez le nom du flux pre (en fonction du nom du lien Row qui transfre les donnes). Parent key column : Saisissez le nom de la colonne cl du flux pre. Key column : Saisissez le nom de la colonne cl pour la ligne slectionne. Pattern : Saisissez le modle (pattern) qui permet de positionner les sparateurs de champ pour chaque ligne dentre. Padding char : Saisissez entre guillemets le caractre de remplissage utiliser. Le caractre par dfaut est un espace. Alignment : Slectionnez le paramtre dalignement appropri. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Cette case est coche par dfaut. Cette option permet de crer le dossier contenant le fichier dlimit de sortie sil nexiste pas dj.
Advanced settings
Create directory if not exists
1222
Composants File
Encoding
Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Utilisation
Utilisez ce composant pour crire un fichier positionnel multi structure et sparer les champs laide dun sparateur de position.
Scnario associ
1223
Composants File
tFileOutputMSXML
tFileOutputMSXML
Proprits du tFileOutputMSXML
Fonction Objectif
Le composant tFileOutputMSXML permet dcrire des schmas multiples dans un fichier XML structur. tFileOutputMSXML cre un fichier XML multi structure complexe laide de la structure des donnes (schmas) venant des diffrents flux dentre de type Row. File Name Chemin daccs et nom du fichier crer, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Configure XML tree Ouvre linterface ddie pour vous aider mettre en place le mapping XML. Pour plus de dtails sur linterface, voir Dfinir un arbre XML Multischma, page 1224.
Basic settings
Advanced settings
Create directory if not Cette case est coche par dfaut. Cette option permet exists de crer le dossier contenant le fichier dlimit de sortie sil nexiste pas dj. Advanced separator (for numbers) Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour annuler la gnration du fichier si celui-ci est vide.
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant. Limitation n/a
Dfinir un arbre XML Multischma

Double-cliquez sur le composant tFileOutputMSXML pour ouvrir linterface ddie ou cliquez sur le bouton [...] de longlet Basic settings de la vue Component.
1224
Composants File
tFileOutputMSXML
La liste droulante de la zone Linker source, gauche de linterface, contient tous les schmas dentre qui peuvent tre ajouts au fichier XML multischma de sortie ( la condition que plusieurs flux dentre soient connects au composant tFileOutputMSXML). Dans le champ Schema List, on retrouve la liste de toutes les colonnes rcupres du flux dentre de la slection. Sur la droite de linterface, dfinissez la structure XML que vous souhaitez obtenir dans le fichier XML en sortie. Vous pouvez la crer manuellement ou tout simplement importer la structure XML. Puis importez les colonnes de chaque schma dentre de la slection dans llment de larbre XML correspondant. Importer un arbre XML Le meilleur moyen de renseigner larbre XML est dimporter un fichier XML bien form. Dans la colonne XML Tree, cliquez une fois sur le champ root tag, qui saffiche par dfaut, pour le renommer. Cliquez droit sur ce champ pour afficher le menu contextuel. Dans le menu, slectionnez Import XML tree. Slectionnez le fichier importer et cliquez sur OK.
1225
Composants File
tFileOutputMSXML
La colonne XML Tree est donc automatiquement renseigne avec les bons lments. Vous pouvez supprimer et ajouter des lments ou des sous lments larbre : Slectionnez llment adquat dans larbre. Cliquez-droit pour faire apparatre le menu contextuel. Slectionnez Delete pour supprimer la slection de larbre ou slectionnez loption adquate parmi les suivantes : Add sub-element, Add attribute, Add namespace pour enrichir larbre.
1226
Composants File
tFileOutputMSXML
Crer manuellement larbre XML Si vous ne possdez pas de structure XML dj dfinie, vous pouvez la crer manuellement. Dans la colonne XML Tree, cliquez une fois sur le champ root tag, qui saffiche par dfaut, pour le renommer. Cliquez-droit sur ce champ pour afficher le menu contextuel. Dans le menu, slectionnez Add sub-element pour crer le premier lment de la structure. Vous pouvez aussi ajouter un attribut ou un lment enfant nimporte quel lment de larbre ou supprimer nimporte quel lment de larbre. Slectionnez llment adquat dans larbre que vous venez de crer. Cliquez-droit gauche du nom de llment pour afficher le menu contextuel. Dans le menu, slectionnez loption adquate parmi les suivantes : Add sub-element, Add attribute, Add namespace ou Delete.
Mapping de donnes XML partir de sources multischma

Une fois votre arbre XML cr, slectionnez le premier schma mapper. Vous pouvez alimenter chaque lment ou sous-lment XML avec les colonnes du flux dentre dans la colonne Related Column : Cliquez sur lune des entres de la colonne Schema column name. Glissez-la dans le sous-lment correspondant droite. Relchez-la pour que le mapping soit effectif.
Une flche bleue apparat pour illustrer ce mapping. Sil est disponible, utilisez le bouton Auto-Map situ en bas gauche de linterface, il permet deffectuer cette opration automatiquement. Vous pouvez dconnecter nimporte quel mapping de nimporte quel lment de larbre XML : Slectionnez llment de larbre XML que vous souhaitez dconnecter de sa source respective.
1227
Composants File
tFileOutputMSXML
Cliquez-droit gauche de son nom pour afficher le menu contextuel. Slectionnez Disconnect linker. La flche bleue disparat.
Dfinir le statut du noeud

Dfinir larbre XML et le transfert de donnes ne suffit pas. Vous devez aussi dfinir les lments sur lesquels la boucle est effectue pour chacune des sources de la slection et, si ncessaire, llment partir duquel le regroupement est effectu. Elment Boucle Llment Boucle permet de dfinir llment objet dune itration. Llment Boucle est gnralement un gnrateur de lignes. Pour dfinir un lment comme un lment Boucle : Slectionnez llment adquat dans larbre XML. Cliquez-droit gauche du nom de llment pour afficher le menu contextuel. Slectionnez loption Set as Loop Element.
La colonne Node Status affiche le nouveau statut slectionn.

Il ne peut y avoir quun seul lment Boucle la fois.
Elment Group Llment Group est optionnel, il reprsente un lment constant sur lequel est effectue une fonction Groupby. Llment Group ne peut tre dfini que si un lment Boucle a t pralablement dfini. Lorsque vous utilisez un lment Group, les lignes doivent tre tries pour pouvoir tre regroupes par le noeud slectionn.
Composants File
tFileOutputMSXML
Pour dfinir un lment comme lment Group : Slectionnnez llment adquat dans larbre XML. Cliquez-droit gauche du nom de llment pour afficher le menu contextuel. Slectionnez loption Set as Group Element.
La colonne Node Status affiche le nouveau statut slectionn et tout autre statut de regroupement est automatiquement dfini, si ncessaire. Une fois le mapping termin, cliquez sur OK pour valider les paramtres et continuez la configuration de votre Job.
Scnario associ
1229
Composants File
tFileOutputPositional
Proprits du tFileOutputPositional
Le composant tFileOutputPositional crit un fichier ligne par ligne en se basant sur la longueur et le format des champ ou colonnes dune ligne. Il crit un fichier ligne par ligne, en se basant sur la structure des donnes (schma) venant du flux dentre. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier o sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. File Name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Row separator Append Include header Compress as zip file Chane (ex : \n sous Unix) sparant les lignes. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Cochez cette case pour tenir compte de len-tte dans le fichier de sortie. Cochez cette case pour compresser en zip le fichier de sortie.
1230
Composants File
Formats
Personnalisez le format des donnes du fichier positionnel et renseignez les colonnes du tableau Formats. Column : Slectionnez la colonne que vous souhaitez personnaliser. Size : Saisissez la taille correspondant la colonne. Padding char : Saisissez entre guillemets le caractre de remplissage utiliser. Le caractre par dfaut est un espace. Alignment : Slectionnez le paramtre dalignement appropri. Keep : Si les donnes contenues dans la colonne ou dans le champ sont trop longues, slectionnez la partie que vous souhaitez garder. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Cochez cette case pour permettre la prise en charge des caractres deux octets dans ce composant. Pour cette fonction, JDK 1.6 est requis. Cochez cette case pour crer un nouveau dossier si votre dossier de destination nexiste pas. Cochez cette case pour personnaliser le nombre de lignes crire avant de vider le tampon. Row Number : Nombre de lignes crire avant de vider le tampon. Cochez cette case pour que lcriture se fasse en mode ligne. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour empcher la gnration dun fichier vide. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Advanced settings
Use byte length as the cardinality Create directory if not exists Custom the flush buffer size
Output in row mode Encoding
Dont generate empty file tStatCatcher Statistics
Utilisation
Utilisez ce composant pour lire un fichier et sparer les champs laide du sparateur spcifi.
Scnario associ :
Pour un scnario associ, consultez Scnario : Transformer un fichier positionnel en XML, page 1180.
1231
Composants File
tFileOutputProperties
Proprits du tFileOutputProperties
Le composant tFileInputProperties crit un fichier de configuration de type ini ou properties. Il crit un fichier de configuration contenant des donnes texte organises sur le modle cl=valeur. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Pour ce composant, le schma est en lecture seule puisque les fichiers sont structurs sur le modle cl=valeur. Slectionnez le format de votre fichier .properties ou .ini. .properties : fichier de configuration dont les donnes sont disposes sur deux lignes et structures de la manire suivante cl=valeur. .ini : fichier de configuration dont les donnes sont disposes sur deux lignes, structures de la manire suivante cl=valeur. et regroupes en sections.. Section Name : saisissez le nom de la section sur laquelle effectuer lopration ditration. Append File Name Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio.
File format
Advanced settings
Encoding
Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Utilisation
Utilisez ce composant pour crire un fichier dont les donnes sont organises selon la structure cl=valeur.
1232
Composants File
Scnario associ
Pour un scnario associ, consultez le Scnario : Lire et mapper la cl et les valeurs de fichiers properties et alimenter un glossaire, page 1184 du composant tFileInputProperties.
1233
Composants File
tFileOutputXML
tFileOutputXML
Le tFileOutputXML appartient deux familles de composants : File et XML. Pour plus dinformations concernant le composant tFileOutputXML, consultez tFileOutputXML page 1707.
1234
Composants File
tFileProperties
tFileProperties
Proprits du tFileProperties
Le composant tFileProperties permet de crer un flux monoligne affichant les proprits du fichier trait. Le tFileProperties permet de recueillir les informations concernant les proprits principales dun fichier dfini. Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Edit schema File :Le nombre de lignes en lecture seule est diffrent sous Java et sous Perl. Chemin daccs et nom du fichier traiter, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Calculate MD5 Hash Cochez cette case pour vrifier le MD5 du fichier tlcharg.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant peut tre utilis en standalone.
1235
Composants File
tFileProperties
Connections
Liens de sortie (dun composant un autre) : Row : Main, Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Scnario : Afficher les proprits dun fichier trait

Ce scnario Java dcrit un Job trs simple permettant dafficher les proprits dun fichier spcifi. A partir de la Palette, cliquez-dposez les composants tFileProperties et tLogRow dans lditeur graphique. Cliquez-droit sur le tFileProperties et connectez-le au tLogRow laide dun lien de type Row Main.
Dans lditeur graphique, slectionnez le composant tFileProperties. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileProperties.
Configurez le champ Schema en mode Built-In.
1236
Composants File
tFileProperties
Cliquez sur le bouton [...] du champ Edit schema si vous voulez voir les colonnes en lecture seule. Dans le champ File, saisissez le chemin daccs ou parcourez vos dossiers jusquau fichier dont vous voulez afficher les proprits. Dans lditeur graphique, slectionnez le tLogRow et cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations, consultez le composant tLogRow, page 1399. Enregistrez le Job et appuyez sur F6 pour lexcuter.
Les proprits du fichier dfini saffichent dans la console Run.
1237
Composants File
tFileRowCount
tFileRowCount
Proprits du tFileRowCount
Le composant tFileRowCount compte le nombre de lignes dans un fichier. Ce composant ouvre un fichier et le lit ligne par ligne afin de dterminer le nombre de lignes quil contient. File Name Chemin daccs et nom du fichier traiter, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Row separator Ignore empty rows Encoding Chane (ex : \n sous Unix) sparant les lignes. Cochez cette case pour que les lignes vides ne soient pas prises en compte. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour collecter les donnes de log au niveau du composant.
Le tFileRowCount est un composant standalone, et doit tre utilis avec un lien de type OnSubjobOk vers un tJava. Number of counted lines : retourne le nombre de lignes dans un fichier. Disponible comme variable Flow. Retourne un entier. Pour plus dinformations concernant les variables, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Row : Main. Trigger : OnSubjobOk, OnSubjobError, Run if. Liens dentre (dun composant un autre) : Row : Main, Reject, Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
1238
Composants File
tFileRowCount
Scnario associ :
1239
Composants File
tFileTouch
tFileTouch
Proprits du tFileTouch
Le composant tFileTouch cre un fichier vide. Ce composant cre un fichier vide, et cre le rpertoire de destination sil nexiste pas. File Name Chemin daccs et nom du fichier crer, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Create directory if not exists Cochez cette case pour crer un nouveau dossier si votre dossier de destination nexiste pas. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant peut tre utilis en standalone. Liens de sortie (dun composant un autre) : Row : Main. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Main, Reject, Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Scnario associ :
1240
Composants File
tFileUnarchive
tFileUnarchive
Proprits du tFileUnarchive
Le composant tFileUnarchive dzippe un fichier archive en fonction des paramtres dfinis et le place dans le rpertoire souhait. Ce composant dzippe un fichier archive de nimporte quel format (zip, rar, etc.) pour un ventuel traitement. Archive file Extraction Directory Java uniquement Chemin daccs au fichier archive. Rpertoire dans lequel le fichier dzipp sera plac.
Use archive name as Cochez cette case pour crer un dossier du mme root directory nom que larchive, sil nexiste pas, dans le rpertoire spcifi et extraire le(s) fichier(s) dzipp(s) dans ce dossier. Use Command line tools Check the integrity before unzip Extract file paths Cochez cette case pour utiliser un autre dzippeur que celui utilis par dfaut par Perl. Cochez cette case pour effectuer une vrification dintgrit avant de dzipper larchive. Cochez cette case pour reproduire la structure du chemin daccs au fichier zipp dans larchive. Cochez cette case et saisissez le mot de passe correct si la dcompression de larchive est protge par un mot de passe. Notez que larchive crypte doit tre cre par le composant tFileArchive, sinon des messages derreur apparatront ou rien ne sera extrait, mme si aucun message derreur nest apparu. Cochez cette case pour collecter les donnes de log au niveau du composant.
Perl uniquement Java uniquement Java uniquement
Need a password Java uniquement
Ce composant peut tre utilis en standalone mais il peut aussi tre utilis en composant de dpart dans un Job via un lien Iterate.
1241
Composants File
tFileUnarchive
Global Variables
Current File : retourne le nom du fichier archive dcompress. Disponible comme variable Flow. Retourne une chane de caractres. Current File Path : retourne le chemin daccs au fichier archive dcompress. Disponible comme variable Flow. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Row : Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Iterate. Trigger : Run if, OnSubjobOk, OnSubjobError, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Scnario associ
Pour un exemple dutilisation du composant tFileUnarchive, consultez tFileCompare page 1117.
1242
Composants File
tGPGDecrypt
tGPGDecrypt
Proprits du tGPGDecrypt
Famille de conposant File/Management
Fonction Objectif
Le composant tGPGDecrypt dcrypte un fichier crypt GnuPG et sauvegarde le fichier dcrypt dans le rpertoire cible spcifi. Ce composant appelle la commande gpg -d afin de dcrypter un fichier crypt GnuPG et sauvegarde le fichier dcrypt dans le rpertoire spcif. Input encrypted file Output decrypted file GPG binary path Perl uniquement Secret key Passphrase Java uniquement No TTY Terminal Chemin daccs au fichier crypt file. Chemin daccs au fichier dcrypt. Chemin daccs la commande GPG. Saisissez votre cl secrte. Saisissez la phrase secrte utilise pour crypter le fichier dentre spcifi. Cochez cette case pour spcifier quaucun terminal TTY nest utilis en ajoutant loption --no-tty la commande de dcryptage. Cochez cette case pour collecter les donnes de log au niveau du composant.
Basic settings
Ce composant peut tre utilis en standalone. n/a
Scnario : Dcrypter un fichier crypt GnuPG et afficher son contenu

Le scnario suivant dcrit un Job de trois composants qui dcrypte un fichier crypt GnuPG et affiche son contenu dans la console de la vue Run.
1243
Composants File
tGPGDecrypt
Dposez un composant tGPGDecrypt, un tFileInputDelimited et un tLogRow de la Palette dans lespace de modlisation graphique. Reliez le composant tGPGDecrypt au tFileInputDelimited laide dun lien Trigger > OnSubjobOk puis connectez le tFileInputDelimited au tLogRow en utilisant un lien Row > Main. Double-cliquez sur le composant tGPGDecrypt afin douvrir sa vue Component et dfinir ses proprits :
Dans le champ Input encrypted file, parcourez votre rpertoire jusquau fichier dcrypter. Dans le champ Output decrypted file, saisissez le chemin daccs au fichier dcrypt. Dans le champ GPG binary path, parcourez votre rpertoire jusquau fichier de commandes GPG. Dans le champ Passphrase, saisissez la phrase secrte utilise lors du cryptage du fichier dentre. Double-cliquez sur le composant tFileInputDelimited afin douvrir sa vue Component et dfinir ses proprits :
1244
Composants File
tGPGDecrypt
Dans la liste Property Type, slectionnez Built-In. Dans le champ File name/Stream, dfinissez le chemin daccs au fichier dcrypt, le chemin de sortie dfini dans votre composant tGPGDecrypt. Dans le champ Header, dfinissez le nombre de lignes ignorer au dbut du fichier. Dans cet exemple, saisissez 1. Dans le champ Footer, saisissez le nombre de lignes ignorer la fin du fichier. Dans cet exemple, aucune ligne nest ignorer, saisissez donc 0. Dans le champ Limit, saisissez le nombre de lignes traiter. Saisissez 10. Dans la liste Schema, slectionnez Built-In. Cela signifie que les proprits que vous configurez dans le composant ne seront pas rutilisables dans dautres Jobs. Cliquez sur Edit schema et ditez le schma du composant. Cliquez deux fois sur le bouton [+] pour ajouter deux colonnes que vous nommerez idState et labelState. Cliquez sur OK afin de valider vos modifications et fermer lditeur.
Double-cliquez sur le composant tLogRow afin dafficher sa vue Component et dfinir ses proprits.
1245
Composants File
tGPGDecrypt
Dans la liste Schema, slectionnez Built-In. Dans la zone Mode, slectionnez loption Table (print values in cells of a table). Sauvegardez votre Job et appuyez sur F6 pour lexcuter.
Le fichier spcifi est dcrypt et le nombre dfini de lignes saffiche dans la console de la vue Run.
1246
Composants File
tPivotToColumnsDelimited
Proprits du tPivotToColumnsDelimited
Le composant tPivotToColumnsDelimited extrait les donnes en fonction dune opration dagrgation exerce sur une colonne pivot. Le tPivotToColumnsDelimited permet dajuster la slection de donnes transmettre en sortie. Pivot column Aggregation column Aggregation function Slectionnez la colonne qui sert de pivot pour lopration dagrgation dans le flux dentre. Slectionnez la colonne contenant les donnes agrger dans le flux dentre. Slectionnez la fonction utiliser dans le cas o plusieurs valeurs sont disponibles dans la colonne pivot. Dfinissez les ensembles dagrgation dont les valeurs qui sont utilises pour les calculs. Input Column : Faites le lien entre les libells des colonnes dentre et ceux des colonnes de sortie, dans le cas o vous souhaitez que les libells du schma de sortie soient diffrents du schma dentre. File Name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Field separator Row separator Caractre, chane ou expression rgulire pour sparer les champs du fichier de sortie. Chane (ex : \n sous Unix) sparant les lignes.
Group by
Ce composant ncessite un flux dentre. n/a
Scnario : Utiliser une colonne pivot pour agrger des donnes

Le scnario suivant dcrit un Job qui agrge des donnes dun fichier dentre dlimit laide dune colonne pivot.
1247
Composants File
Cliquez sur les composants suivant et dposez-les dans lespace de modlisation : tFileInputDelimited, tPivotToColumnsDelimited. Le fichier utiliser en entre est compos de 3 colonnes : ID, Question et les rponses correspondantes : Answer
Dans lespace de modlisation, slectionnez le composant tFileInputDelimited. Dfinissez ses proprits dans longlet Basic settings de la vue Component.
Slectionnez le fichier dentre pour renseigner le champ File Name. Dfinissez les sparateurs de lignes (Row) et de champs (Field), respectivement : retour chariot et point virgule, dans cet exemple. Le fichier contient un en-tte, ainsi dfinissez-le. Paramtrez le schma avec les trois colonnes : ID, Questions, Answers.
1248
Composants File
Puis slectionnez le composant tPivotToColumnsDelimited et paramtrez ses proprits dans longlet Basic Settings de la vue Component.
Dans le champ Pivot column, slectionnez la colonne pivot dans le schma dentre. La colonne pivot est gnralement celle prsentant le plus de doublons (valeurs dagrgation pivot). Dans le champ Aggregation column, slectionnez la colonne agrger dans le schma dentre. Dans le champ Aggregation function, slectionnez la fonction effectuer lorsque des doublons sont trouvs. Dans la table Group by, ajoutez une entre dans la colonne Input column, qui sera utilise pour regrouper la colonne agrge. Dans le champ File Name, indiquez le chemin daccs et le nom du fichier de sortie. Et dans les champs Row et Field separator, paramtrez les sparateurs pour les lignes et donnes de sortie ayant t agrges. Puis, appuyez sur F6 pour excuter le Job. Le fichier de sortie affiche les donnes qui viennent dtre agrges.
1249
Composants File
1250
Composants Internet
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Internet de la Palette de Talend Open Studio. La famille Internet regroupe les composants vous permettant daccder du contenu stock sur Internet, des services Web aux e-mails en passant par les flux RSS, le SCP, le MOM, le FTP, etc.
Composants Internet
tFileFetch
tFileFetch
Proprits du tFileFetch
Famille de composant Internet
Le composant tFileFetch rcupre un fichier partir dun protocole. Ce composant permet de rcuprer des donnes dun fichier partir dun protocole. Protocol Slectionnez parmi la liste suivante le protocole utiliser, puis renseignez les champs correspondants : http, https, ftp, smb. Les proprits peuvent diffrer lgrement en fonction du type de protocole slectionn. Les champs additionnels sont dfinis dans ce tableau la suite des proprits gnrales. URI Use cache to save the resource Saisissez lURI du site sur lequel le fichier doit tre rcupr. Cochez cette case pour enregistrer les donnes dans le cache. Cette option vous permet de traiter directment le flux de donnes du fichier (en mode stream) sans sauvegarder ce fichier sur votre disque. Elle permet donc un gain de temps et de performance.
smb smb
Domain Username et Password Destination directory Destination Filename
Saisissez le nom du domaine du serveur Microsoft. Saisissez lidentifiant utilisateur et le mot de passe de connexion au serveur. Slectionnez le rpertoire de destination dans lequel le fichier rcupr sera plac. Saisissez le nouveau nom du fichier rcupr. Cette case est coche par dfaut elle permet de reproduire larborescence de rpertoires de lURI. Pour enregistrer le fichier la racine de votre rpertoire de destination, dcochez la case. Cochez cette case si vous souhaitez ajouter un ou plusieurs en-tte(s) comme conditions de rcupration. Dans le tableau Headers, saisissez le(s) paramtre(s) den-tte HTTP dans le champ Name et la valeur correspondante dans le champ Value.
http, https, ftp
Create full path according to URI
http, https
Add header
1252
Composants Internet
tFileFetch
http, https
POST method
Cette case est coche par dfaut, elle permet dutiliser la mthode POST. Dans le tableau Parameters, saisissez le nom de la ou des variable(s) dans le champ Name et leur valeur correspondante dans le champ Value. Dcochez cette case si vous souhaitez utiliser la mthode GET. Dcochez cette case pour passer les lignes en erreur et terminer le traitement des lignes sans erreur. Cochez cette case pour que le tFileFetch charge un cookie dauthentification Web. Cochez cette case pour sauvegarder le cookie dauthentification Web. Cela signifie que vous naurez plus vous identifier sur le mme site Web. Cliquez sur le bouton [...] et parcourez votre rpertoire jusqu lendroit o vous souhaitez sauvegarder votre cookie, ou jusqu lendroit o il est dj sauvegard. Cochez cette case pour collecter les donnes de log au niveau du composant. Nombre de secondes avant fermeture de la connexion au protocole. Cochez cette case pour imprimer la rponse du serveur dans la console. Cochez cette case pour charger un ou plusieurs fichier(s) sur le serveur. Dans le champ Name, saisissez le nom du fichier que vous souhaitez charger, et dans le champ File, saisissez le chemin daccs au fichier.
http, https, ftp
Die on error
http, https, ftp http, https, ftp
Read Cookie Save Cookie
http, https, ftp
Cookie directory
Advanced settings http, https http, https http, https
tStatCatcher Statistics Timeout Print response to console Upload file
http, https, ftp
Enable proxy server Cochez cette case si vous vous connectez derrire un proxy et renseignez les informations correspondantes. Enable NTLM Credentials Cochez cette case si vous utiliser un protocole dauthentification NTLM. Domain : Nom de domaine du client. Host : Adresse IP du client.
http, https, ftp
http, https
Need authentication Cochez la case dauthentification et renseignez le nom de lutilisateur dans le champs Username et son mot de passe dans le champs Password, si cela est ncessaire pour accder au protocole. Support redirection Cochez cette case pour rpter la requte de redirection jusqu ce que la redirection soit effective et que le fichier puisse tre rcupr.
http, https
Utilisation
Ce composant est gnralement utilis en composant de dpart pour alimenter le flux dentre dun Job et est souvent utilis avec un lien de type OnSubjobOk ou OnComponentOk, en fonction du contexte. n/a
Limitation
1253
Composants Internet
tFileFetch
Scnario 1 : Rcuprer des donnes partir dun protocole HTTP

Ce scnario dcrit un Job comprenant trois composants, qui retrouve des donnes partir dun site internet HTTP et slectionne des donnes qui seront stockes dans un fichier dlimit.
Cliquez et dposez les composants tFileFetch, tFileInputRegex et tFileOutputDelimited dans lespace de modlisation, puis connectez-les comme illustr sur la figure ci-dessus. Dans longlet Basic settings du composant tFileFetch, slectionnez le protocole que vous souhaitez utiliser. Ici, utilisez le protocole HTTP. Saisissez lURI sur lequel le fichier peut tre rcupr. Dans le champ Destination directory, slectionnez le rpertoire dans lequel le fichier rcupr doit tre stock. Dans le champ Filename, saisissez le nouveau nom du fichier si vous souhaitez le renommer. Dans cet exemple, filefetch.txt. Si ncessaire, cochez la case Add header et dfinissez une ou plusieurs requtes HTTP comme conditions de rcupration. Par exemple, vous pouvez rcuprer le fichier sil a t modifi depuis une date prcise. Dans le tableau Headers, dans le champ Name, saisissez If-Modified-Since puis saisissez "Sat, 29 Oct 1994 19:43:31 GMT" dans le champ Value. Pour plus dinformations concernant la dfinition den-ttes HTTP, consultez Header Field Definitions (en anglais). Slectionnez le composant tFileInputRegex. Dans le champ File name paramtrez le nom du fichier afin quil corresponde au fichier rcupr prcdemment. Dans le champ Regex, utilisez une expression rgulire pour slectionner les donnes adquates du fichier rcupr. Dans cet exemple : <td(?: class="leftalign")?> \s* (t\w+) \s* </td>
Utilisez la bonne expression rgulire en fonction du langage de gnration utilis. En effet, la syntaxe est diffrente en Java et en Perl, ainsi que les guillemets utilises pour introduire les expressions rgulires : guillemets simples en Perl et guillemets doubles en Java.
Si ncessaire, dfinissez len-tte dans le champ Header, le pied de page dans le champ Footer et le nombre de lignes traiter dans le champ Limit. Pour cet exemple, ignorez ces champs.
1254
Composants Internet
tFileFetch
Dfinissez le schma dcrivant le flux transmettre au composant de sortie. Le schma devrait tre automatiquement propag au flux de sortie, mais pour en tre sr, vrifiez le schma dans longlet Basic settings du composant tFileOutputDelimited. Puis appuyez sur F6 pour excuter le Job.
Scnario 2 : Rutiliser un cookie stock pour rcuprerdes fichiers via un protocole HTTP
Ce scnario dcrit un Job comprenant deux composants, qui se connecte un site Web HTTP donn et, laide dun cookie stock dans un rpertoire local spcifi, rcupre les donnes de ce site.
Dposez deux composants tFileFetch de la Palette dans lespace de modlisation graphique. Reliez ces deux composants laide dun lien Trigger > OnSubjobOk Double-cliquez sur le tFileFetch_1 afin douvrir sa vue Component et dfinir ses proprits.
1255
Composants Internet
tFileFetch
Dans la liste Procotol, slectionnez le protocole que vous souhaitez utiliser. Ici, utilisez le protocole http. Dans le champ URI, saisissez lURI via laquelle vous pouvez vous connecter au site Web et rcuprer la page Web. Dans cet exemple, lURI est http://www.codeproject.com/script/Membership/LogOn.aspx?rp=h ttp%3a%2f%2fwww.codeproject.com%2fKB%2fcross-platform%2fjava csharp.aspx&download=true. Dans le champ Destination directory, parcourez votre rpertoire jusquau dossier dans lequel stocker le fichier rcupr. Ce dossier sera cr la vole sil nexiste pas. Dans cet exemple, saisissez C:/Logpage. Dans le champ Destination Filename, saisissez un nouveau nom pour le fichier si vous souhaitez le modifier. Dans cet exemple, saisissez webpage.html. Sous le tableau Parameters, cliquez deux fois sur le bouton [+] pour ajouter deux lignes. Dans la colonne Name du tableau Parameters, saisissez respectivement le nom des deux lignes, Email et Password, requises par le site Web auquel vous vous connectez. Dans la colonne Value, saisissez les informations correspondantes, respectivement votre adresse e-mail et votre mot de passe. Cochez la case Save cookie pour activer le champ Cookie directory.
1256
Composants Internet
tFileFetch
Dans le champ Cookie directory, parcourez votre rpertoire jusquau dossier dans lequel vous souhaitez stocker le cookie puis saisissez un nom pour le cookie sauvegarder. Le dossier doit dj exister. Dans cet exemple, le rpertoire est C:/temp/Cookie. Double-cliquez sur le tFileFetch_2 afin douvrir sa vue Component et dfinir ses proprits.
Dans la liste Procotol, slectionnez http. Dans le champ URI, saisissez ladresse partir de laquelle rcuprer les fichiers qui vous intressent. Dans cet exemple, ladresse est http://www.codeproject.com/KB/java/RemoteShell/RemoteShell .zip. Dans le champ Destination directory, parcourez votre rpertoire jusquau dossier dans lequel vous souhaitez stocker les fichiers rcuprs. Ce dossier peut tre automatiquement cr sil nexiste pas durant le processus dexcution. Dans cet exemple, saisissez C:/JavaProject. Dans le champ Destination Filename, saisissez un nouveau nom pour le fichier si vous souhaitez le modifier. Dans cet exemple, saisissez RemoteShell.zip. Dcochez la case Post method pour dsactiver le tableau Parameters. Cochez la case Read cookie afin dactiver le champ Cookie directory. Dans le champ Cookie directory, parcourez votre rpertoire jusquau cookie que vous avez sauvegard et que vous souhaitez utiliser. Dans cet exemple, le rpertoire est C:/temp/Cookie. Sauvegardez votre Job et appuyez sur F6 pour lexcuter. Vrifiez les dossiers dans lesquels vous avez stock les fichiers rcuprs.
1257
Composants Internet
tFileFetch
Scnario associ
Pour un exemple de transfert de donnes en mode stream, consultez le Scnario 2 : Lire les donnes dun fichier distant en mode stream, page 1139.
1258
Composants Internet
tFileInputJSON
tFileInputJSON
Le composant tFileInputJSON appartient deux familles diffrentes : Internet et File. Pour plus dinformations, consultez tFileInputJSON, page 1155.
1259
Composants Internet
tFTPConnection
tFTPConnection
Proprits du tFTPConnection
Famille de composant Internet/FTP
Le composant tFTPConnection ouvre une connexion FTP afin deffectuer une transaction. Le tFTPConnection permet douvrir une connexion FTP afin deffectuer des transferts de fichiers en une seule transaction. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Port Username Password Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Identifiant de connexion au serveur FTP. Mot de passe de connexion au serveur FTP.
SFTP Cochez cette case puis, partir de la liste Support/Anthenticat droulante Authentication method, ion method slectionnez loption adquate dauthentification au serveur : Password : Renseignez le mot de passe. Public key : Renseignez la cl prive ou cliquez sur le bouton [...] ct du champ Private key pour parcourir vos dossiers jusquau fichier adquat. Si vous choisissez loption Public Key comme mthode dauthentification, assurez-vous que la cl ait t ajoute lagent ou quaucune passphrase (phrase secrte) ne soit demande. Lorsque la case est dcoche, slectionnez votre mode de connexion, Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes, ou Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. Advanced settings Use Socks Proxy Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant est gnralement utilis comme sous-Job a un seul composant.
1260
Composants Internet
tFTPConnection
Limitation
n/a
Scnarios associs
Pour un scnario associ, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1277. Consultez galement le Scnario : Itration sur un rpertoire distant, page 1267 du tFTPFileList Pour un scnario associ utilisant un protocole diffrent, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1334.
1261
Composants Internet
tFTPDelete
tFTPDelete
Proprits du tFTPDelete
Le composant tFTPDelete supprime les fichiers slectionns via une connexion FTP. Le tFTPDelete supprime les fichiers dun serveur FTP distant. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent List pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vous pouvez utiliser longlet Dynamic settings, pour partager la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct travers les deux niveaux de Job. Pour plus dinformations concernant les Dynamic settings, consultez le Guide Utilisateur de votre Studio. Host Port Username et Password Remote directory Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Informations dauthentification de lutilisateur du serveur FTP. Rpertoire source o se trouvent les fichiers supprimer.
1262
Composants Internet
tFTPDelete
SFTP Cochez cette case puis, partir de la liste Support/Anthenticat droulante Authentication method, ion method slectionnez loption adquate dauthentification au serveur : Password : Renseignez le mot de passe. Public key : Renseignez la cl prive ou cliquez sur le bouton [...] ct du champ Private key pour parcourir vos dossiers jusquau fichier adquat. Si vous choisissez loption Public Key comme mthode dauthentification, assurez-vous que la cl ait t ajoute lagent ou quaucune passphrase (phrase secrte) ne soit demande. Lorsque la case est dcoche, slectionnez votre mode de connexion, Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes, ou Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. Files Advanced settings Use Socks Proxy Noms ou chemins daccs aux fichiers supprimer. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ignore Failure At Quit (FTP) tStatCatcher Statistics Utilisation
Ce composant est gnralement utilis comme sous-Job un seul composant mais il peut aussi tre utilis comme composant de sortie ou de fin. n/a
Limitation
Scnarios associs
Pour un scnario associ, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1277. Pour un scnario associ utilisant un protocole diffrent, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1334.
1263
Composants Internet
tFTPFileExist
tFTPFileExist
Proprits du tFTPFileExist
Le composant tFTPFileExist vrifie si un fichier est prsent sur le serveur FTP. Le tFTPFileExist permet de vrifier la prsence dun fichier sur le serveur FTP distant. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent List pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vous pouvez utiliser longlet Dynamic settings, pour partager la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct travers les deux niveaux de Job. Pour plus dinformations concernant les Dynamic settings, consultez le Guide Utilisateur de votre Studio. Host Port Username et Password Remote directory File Name Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Informations dauthentification de lutilisateur du serveur FTP. Rpertoire source o se trouvent les fichiers supprimer. Nom du fichier dont vous voulez vrifier la prsence.
1264
Composants Internet
tFTPFileExist
SFTP Cochez cette case puis, partir de la liste Support/Anthenticat droulante Authentication method, ion method slectionnez loption adquate dauthentification au serveur : Password : Renseignez le mot de passe. Public key : Renseignez la cl prive ou cliquez sur le bouton [...] ct du champ Private key pour parcourir vos dossiers jusquau fichier adquat. Si vous choisissez loption Public Key comme mthode dauthentification, assurez-vous que la cl ait t ajoute lagent ou quaucune passphrase (phrase secrte) ne soit demande. Lorsque la case est dcoche, slectionnez votre mode de connexion, Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes, ou Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. Encoding Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.
Advanced settings
Use Socks Proxy
Ce composant est gnralement utilis comme sous-Job un seul composant mais il peut aussi tre utilis comme composant de sortie ou de fin. n/a
Limitation
Scnarios associs
Pour un scnario associ, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1277. Pour un scnario associ utilisant un protocole diffrent, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1334.
1265
Composants Internet
tFTPFileList
tFTPFileList
Proprits du tFTPFileList
Fonction Objectif
Le composant tFTPFileList fait une boucle sur les fichiers et/ou les dossiers dun rpertoire distant donn. Le tFTPFileList rcupre un groupe de fichiers et/ou de dossiers suivant un masque donn et fait une boucle sur chacun deux, en se connectant un rpertoire distant via un protocole FTP. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent List pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vous pouvez utiliser longlet Dynamic settings, pour partager la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct travers les deux niveaux de Job. Pour plus dinformations concernant les Dynamic settings, consultez le Guide Utilisateur de votre Studio. Host Port Username et Password Remote directory File detail Adresse IP. Numro du port dcoute. Informations dauthentification de lutilisateur. Chemin daccs au rpertoire distant. Cochez cette case pour voir toutes les informations du fichier, et non pas juste son nom.
Basic settings
1266
Composants Internet
tFTPFileList
SFTP Cochez cette case puis, partir de la liste Support/Anthenticat droulante Authentication method, ion method slectionnez loption adquate dauthentification au serveur : Password : Renseignez le mot de passe. Public key : Renseignez la cl prive ou cliquez sur le bouton [...] ct du champ Private key pour parcourir vos dossiers jusquau fichier adquat. Si vous choisissez loption Public Key comme mthode dauthentification, assurez-vous que la cl ait t ajoute lagent ou quaucune passphrase (phrase secrte) ne soit demande. Lorsque la case est dcoche, slectionnez votre mode de connexion, Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes, ou Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. Connect Mode Slectionnez le mode adquat de connexion au serveur : Active : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes. Passive : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du composant.
Advanced settings
Use Socks Proxy
Le composant tFTPFilelist est gnralement utilis comme composant seul dans un sous-job mais il peut aussi tre utilis avec dautres composants.
Scnario : Itration sur un rpertoire distant

Le scnario suivant dcrit un Job de trois composants qui a pour objectif de se connecter un serveur FTP, de lister les fichiers dun rpertoire distant donn en fonction dun masque, de les rcuprer et de les envoyer vers un rpertoire local dfini.
1267
Composants Internet
tFTPFileList
Cliquez et dposez les composants suivants : tFTPConnection, tFTPFileList et tFTPGet dans lespace de modlisation. Cliquez droit sur le composant tFTPConnection et connectez-le au composant tFTPFileList via une connexion de type OnSubjobOk. Puis connectez le tFTPFileList au tFTPGet laide dune connexion de type Iterate. Slectionnez le tFTPConnection et cliquez sur longlet Basic settings de la vue Component pour paramtrer le composant :
Dans le champ Host, renseignez ladresse IP du serveur FTP. Dans le champ Port, renseignez le numro du port dcoute. Dans les champs Username et Password, renseignez respectivement le login et le mot de passe de connexion au serveur distant. Dans la liste Connect Mode, slectionnez le mode de connexion au serveur FTP que vous souhaitez utiliser. Slectionnez le tFTPFileList et cliquez sur longlet Basic settings de la vue Component pour paramtrer le composant :
1268
Composants Internet
tFTPFileList
Cochez la case Use an existing connection et dans la liste Component list, slectionnez le composant de connexion tFTPConnection_1. Les informations de connexion sont automatiquement renseignes. Dans le champ Remote directory, renseignez le chemin relatif du rpertoire contenant les fichiers lister. Dans le champ Filemask, indiquez un masque de fichier. Utilisez les caractres spciaux si besoin est. Dans cet exemple, on ne veut rcuprer que les fichiers dlimits (.csv). Dans la liste Connect Mode, slectionnez le mode de connexion au serveur FTP que vous souhaitez utiliser. Dans cet exemple, il sagit du mode Passive. Slectionnez le tFTPGet et cliquez sur longlet Basic settings de la vue Component pour paramtrer le composant :
Cochez la case Use an existing connection et dans la liste Component list, slectionnez le composant de connexion adquat, tFTPConnection_1 dans cet exemple. Les informations de connexion sont automatiquement renseignes. Dans le champ Local directory, renseignez le chemin relatif du rpertoire de destination des fichiers rcuprer. Dans le champ Remote directory, renseignez le chemin relatif du rpertoire contenant les fichiers rcuprer. Dans la liste Transfer Mode, slectionnez le mode de transfert FTP que vous souhaitez utiliser. Dans la liste Overwrite file, slectionnez lune des options disponibles pour le transfert du fichier. Dans le champ Filemask, slectionnez la variable globale ((String)globalMap.get("tFTPFileList_1_CURRENT_FILEPATH")) de manire traiter tous les fichiers du rpertoire source.
1269
Composants Internet
tFTPFileList
Dans la liste Connect Mode, slectionnez le mode de connexion au serveur FTP que vous souhaitez utiliser. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
Une fois la connexion au serveur FTP tablie, les fichiers sont lists dans le rpertoire spcifi, selon le masque choisi, puis sont rcuprs et stocks dans le rpertoire de destination pralablement dfini. Vous pouvez vrifier que la copie des fichiers a t ralise partir de votre explorateur de disque.
1270
Composants Internet
tFTPFileProperties
tFTPFileProperties
Proprits du tFTPFileProperties
Famille du composant Internet
Le composant tFTPFileProperties permet de crer un flux monoligne affichant les proprits du fichier trait sur un serveur FTP. Le tFTPFileProperties permet de recueillir les informations concernant les proprits principales dun fichier dfini sur un serveur FTP. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Schema type Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Edit schema Use an existing connection/Compone nt List Host Port Username Password Local directory Remote directory :Le nombre de lignes en lecture seule est diffrent sous Java et sous Perl. Cochez la case et cliquez sur le composant de connexion adquat dans la liste Component list pour rutiliser les informations de connexion que vous avez dj dfinies. Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Login de connexion au serveur FTP. Mot de passe de connexion au serveur FTP. Chemin daccs lemplacement de destination du fichier. Chemin daccs du rpertoire source o les fichiers sont rcuprs.
1271
Composants Internet
tFTPFileProperties
File
Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio. Cochez cette case puis, partir de la liste droulante Authentication method, slectionnez loption adquate dauthentification au serveur : Password : Renseignez le mot de passe. Public key : Renseignez la cl prive ou cliquez sur le bouton [...] ct du champ Private key pour parcourir vos dossiers jusquau fichier adquat. Si vous choisissez loption Public Key comme mthode dauthentification, assurez-vous que la cl ait t ajoute lagent ou quaucune passphrase (phrase secrte) ne soit demande. Lorsque la case est dcoche, slectionnez votre mode de connexion, Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes, ou Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes.
SFTP Support/Anthenticat ion method
Encoding
Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour vrifier le MD5 du fichier tlcharg. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy.
Calculate MD5 Hash Advanced settings Use Socks Proxy
Ignore Failure At Quit Cochez cette case afin dignorer les erreurs dues la (FTP) fermeture du FTP ou de la bibliothque. tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant peut tre utilis en standalone. n/a
Scnario associ
Pour un scnario associ, consultez le Scnario : Afficher les proprits dun fichier trait, page 1236.
1272
Composants Internet
tFTPGet
tFTPGet
Proprits du tFTPGet
Le composant tFTPGet rcupre les fichiers slectionns via une connexion FTP. Le tFTPGet rcupre les fichiers slectionns dun serveur FTP distant et les copie dans un rpertoire local. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent List pour rutiliser les informations de connexion que vous avez dj dfinies. Host Port Username Password Local directory Remote directory Transfer mode Overwrite file Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Login de connexion au serveur FTP. Mot de passe de connexion au serveur FTP. Chemin daccs lemplacement de destination du fichier. Chemin daccs du rpertoire source o les fichiers sont rcuprs. Diffrents modes de transfert FTP. Liste des options disponibles pour le transfert du fichier. Append : Cochez cette case pour crire les donnes la fin de lenregistrement, et ainsi ne pas lcraser.
1273
Composants Internet
tFTPGet
SFTP Support
Lorsque vous cochez cette case, les champs Overwrite file et Authentication method saffichent. Overwrite file vous propose trois options : Overwrite : pour craser le fichier dj existant. Resume : pour reprendre le tlchargement du fichier l o il a t interrompu. Append : pour crire la suite du fichier sans lcraser. Authentication vous propose deux modes dauthentification : Public key : Renseignez le chemin daccs la cl publique. Password : Renseignez le mot de passe. Cochez cette case si vous souhaitez vous connecter au serveur FTP via une connexion FTPS. Deux champs apparaissent : Keystore File : Saisissez le chemin daccs au keystore (fichier protg par un mot de passe, qui peut contenir plusieurs cls et certificats). Keystore Password : saisissez votre mot de passe correspondant au keystore. Noms ou chemins daccs aux fichiers transfrer. Slectionnez votre mode de connexion. Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes. Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et les lignes contenant les erreurs seront ignores. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour afficher dans la console la liste des fichiers tlchargs. Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.
FTPS Support
Files Connection Mode
Encoding
Die on error
Advanced settings
Use Socks Proxy
Ignore Failure At Quit (FTP) Print message tStatCatcher Statistics
1274
Composants Internet
tFTPGet
Utilisation
Ce composant est gnralement utilis comme sous-Job a un seul composant mais il peut aussi tre utilis comme composant de sortie ou de fin. n/a
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1277. Consultez galement le Scnario : Itration sur un rpertoire distant, page 1267. du tFTPFileList. Pour un scnario associ utilisant un protocole diffrent, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1334.
1275
Composants Internet
tFTPPut
tFTPPut
Proprits du tFTPPut
Le composant tFTPPut copie les fichiers slectionns via une connexion FTP. Le tFTPPut copie les fichiers slectionns dun rpertoire local dfini vers un rpertoire FTP distant. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent List pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vous pouvez utiliser longlet Dynamic settings, pour partager la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct travers les deux niveaux de Job. Pour plus dinformations concernant les Dynamic settings, consultez le Guide Utilisateur de votre Studio. Host Port Username Password Local directory Remote directory Transfer mode Overwrite file Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Login de connexion au serveur FTP. Mot de passe de connexion au serveur FTP. Chemin daccs au rpertoire source du ou des fichier(s). Chemin daccs au rpertoire de destination du ou des fichier(s). Diffrents modes de transfert FTP. Liste des options disponibles pour le fichier transfr. Append : Cochez cette case pour crire les donnes la fin de lenregistrement, et ainsi ne pas lcraser.
1276
Composants Internet
tFTPPut
SFTP Support et Authentication method
SFTP Support: cochez cette case pour tablir une mthode dauthentification. Authentication method: slectionnez la mthode dauthentification partir de la liste droulante. Cliquez sur le bouton [+] pour ajouter une ligne puis remplissez les colonnes. Filemask: noms et chemins daccs aux fichiers transfrer. New name: nom donner au fichier FTP aprs le transfert. Slectionnez votre mode de connexion. Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes. Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et les lignes contenant les erreurs seront ignores. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.
Files
Connection Mode
Encoding
Die on error
Advanced settings
Use Socks Proxy
Limitation
Scnario : Copier des fichiers sur un serveur FTP distant

Ce scnario cre un Job deux composants permettant douvrir une connexion un serveur distant afin de copier les fichiers souhaits en une seule transaction.
1277
Composants Internet
tFTPPut
Cliquez et dposez les composants tFTPConnection permettant deffectuer toutes les oprations en une seule transaction et tFTPPut de la famille Internet dans le Job Designer. Reliez le tFTPConnection au tFTPPut laide dun lien de type OnSubJobOk. Dans le Job designer, double-cliquez sur le tFTPConnection pour paramtrer ses proprits de base dans longlet Basic settings de la vue Component :
Dans le champ Host, renseignez ladresse IP du serveur. Dans le champ Port, renseignez le numro du port dcoute. Dans les champs Username et Password, renseignez respectivement le login et le mot de passe de connexion au serveur distant. Dans la liste Connection Mode, slectionnez le mode de connexion au serveur FTP que vous souhaitez utiliser. Dans le Job designer, double-cliquez sur le tFTPPut pour paramtrer ses proprits de base dans longlet Basic settings de la vue Component :
1278
Composants Internet
tFTPPut
Cochez la case Use an existing connection et dans la liste Component list, slectionnez le composant de connexion tFTPConnection_1. Les informations de connexion sont automatiquement renseignes. Dans le champ Local directory, renseignez le chemin daccs au rpertoire local contenant le fichier, moins que vous ne renseigniez directement les masques des fichiers dans la colonne Filemask du champ Files. Dans le champ Remote directory, renseignez les informations de connexion au rpertoire du seveur distant. Dans la liste Transfert mode, slectionnez le mode de transfert utilis. Dans la liste Overwrite file, slectionnez loption dcrasement du fichier. Dans le tableau Files, cliquez deux fois sur le bouton [+] pour ajouter deux lignes la liste Filemask, renseignez les masques de fichier pour chaque fichier que vous souhaitez copier dans le rpertoire distant. Enregistrez votre Job et appuyez sur F6 pour lexcuter. Les fichiers spcifis dans le champ Filemask sont copis dans le rpertoire du serveur distant.
1279
Composants Internet
tFTPRename
tFTPRename
Proprits du tFTPRename
Le composant tFTPRename renomme les fichiers slectionns via une connexion FTP. Le tFTPRename renomme les fichiers slectionns dun rpertoire local dfini vers un rpertoire FTP distant. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent List pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vous pouvez utiliser longlet Dynamic settings, pour partager la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct travers les deux niveaux de Job. Pour plus dinformations concernant les Dynamic settings, consultez le Guide Utilisateur de votre Studio. Host Port Username Password Remote directory Overwrite file Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Login de connexion au serveur FTP. Mot de passe de connexion au serveur FTP. Chemin daccs au rpertoire de destination du ou des fichier(s). Liste des options disponibles pour le fichier transfr. Append : Cochez cette case pour crire les donnes la fin de lenregistrement, et ainsi ne pas lcraser.
1280
Composants Internet
tFTPRename
SFTP Support et Authentication method
SFTP Support : cochez cette case pour tablir une mthode dauthentification. Authentication method : slectionnez la mthode dauthentification partir de la liste droulante. Cliquez sur le bouton [+] pour ajouter une ligne puis remplissez les colonnes. Filemask : noms et chemins daccs aux fichiers transfrer. New name : nom donner au fichier FTP aprs le transfert. Slectionnez votre mode de connexion. Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes. Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et les lignes contenant les erreurs seront ignores. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.
Files
Connection Mode
Encoding
Die on error
Advanced settings
Use Socks Proxy
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1277 .
1281
Composants Internet
tFTPTruncate
tFTPTruncate
Proprits du tFTPTruncate
Le composant tFTPTruncate tronque les fichiers slectionns via une connexion FTP. Le tFTPTruncate tronque les fichiers slectionns dun rpertoire local dfini vers un rpertoire FTP distant. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent List pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vous pouvez utiliser longlet Dynamic settings, pour partager la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct travers les deux niveaux de Job. Pour plus dinformations concernant les Dynamic settings, consultez le Guide Utilisateur de votre Studio. Host Port Username Password Remote directory SFTP Support et Authentication method Adresse IP du serveur FTP. Numro du port dcoute du serveur FTP. Login de connexion au serveur FTP. Mot de passe de connexion au serveur FTP. Chemin daccs au rpertoire de destination du ou des fichier(s). SFTP Support : cochez cette case pour tablir une mthode dauthentification. Authentication method : slectionnez la mthode dauthentification partir de la liste droulante.
1282
Composants Internet
tFTPTruncate
Files
Cliquez sur le bouton [+] pour ajouter une ligne puis remplissez les colonnes. Filemask : noms et chemins daccs aux fichiers transfrer. New name : nom donner au fichier FTP aprs le transfert. Slectionnez votre mode de connexion. Passive : vous dterminez le port de connexion utiliser pour permettre le transfert des donnes. Active : le serveur FTP dtermine le port de connexion utiliser pour permettre le transfert des donnes. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case si vous souhaitez utiliser un proxy, puis paramtrez les champs Host, Port, User et Password du proxy. Cochez cette case afin dignorer les erreurs dues la fermeture du FTP ou de la bibliothque. Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.
Connection Mode
Encoding
Advanced settings
Use Socks Proxy
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1277 .
1283
Composants Internet
tHttpRequest
tHttpRequest
Proprits du tHttpRequest
Fonction Objectif
Ce composant envoie une requte HTTP au serveur et obtient des rponses HTTP du serveur. Le composant tHttpRequest vous permet denvoyer des requtes HTTP au serveur et dcrire les rponses localement. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement :Paramtrer un schma built-in, page 98 du Guide utilisateur Talend Open Studio. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Sync columns URI Cliquez sur ce bouton pour rcuprer le schma du composant prcdent. Saisissez lURI (Identifiant uniforme de ressource) partir duquel seront identifies les ressources sur le serveur. Un URI est similaire un URL mais il est plus gnrique. Slectionnez dans la liste la mthode pour dfinir laction effectuer : Post : Choisissez cette mthode pour envoyer des donnes ct serveur (des donnes de formulaires HTML par exemple). Get : Choisissez cette mthode pour rcuprer des donnes ct serveur. Cochez cette case afin de sauvegarder la rponse HTTP dans un fichier local. Vous pouvez soit renseigner le chemin daccs au fichier dentre, soit cliquer sur [...] pour choisir le chemin daccs dans votre systme de fichiers. Renseignez la (les) paire(s) nom-valeur des en-ttes HTTP pour dfinir les paramtres de lopration HTTP requise : Header key : Saisissez le nom du champ den-tte de len-tte HTTP. Value : Saisissez le contenu du champ den-tte de len-tte HTTP. Pour plus dinformations concernant la dfinition des en-ttes HTTP, consultez (en anglais) : en.wikipedia.org/wiki/List_of_HTTP_headers.
Method
Write response content to file
Headers
1284
Composants Internet
tHttpRequest
Need authentication
Cochez cette case afin de saisir un identifiant et un mot de passe dans les champs correspondants si une authentification est ncessaire : user : Saisissez lidentifiant de connexion au serveur. password : Saisissez le mot de passe de connexion au serveur.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant. Ce composant peut tre utilis pour lenvoi de requtes HTTP au serveur ainsi que pour lenregistrement des rponses HTTP obtenues. Il peut tre utilis en standalone. N/A
Utilisation
Limitation
Scnario : Envoyer une requte HTTP au serveur et sauvegarder localement les rponses HTTP obtenues
Ce scnario Java dcrit un Job deux composants qui utilise la mthode GET pour rcuprer des informations du serveur et crire les rponses dans un fichier local ainsi que dans la console. A partir de la Palette, dposez les composants suivants dans lespace de modlisation graphique : un composant tHttpRequest et un tLogRow.
Connectez le composant tHttpRequest au composant tLogRow laide dune connexion de type Row > Main. Double-cliquez sur le composant tHttpRequest pour ouvrir longlet Basic settings de sa vue Component et paramtrer ses proprits.
1285
Composants Internet
tHttpRequest
Saisissez http://192.168.0.63:8081/testHttpRequest/build.xml dans le champ URI. Notez que ladresse URI fournie dans ce scnario est destine essentiellement la dmonstration, ce nest pas une adresse valide. Slectionnez GET dans la liste droulante Method. Cochez la case Write response content to file et renseignez le chemin daccs dans le champ de saisie manuelle qui apparat.Pour ce scnario, saisissez .D:/test.txt. Cochez la case Need authentication. Pour ce scnario, saisissez tomcat dans les champs user et password qui apparaissent. Double-cliquez sur le composant tLogRow pour ouvrir longlet Basic settings de sa vue Component et slectionnez Table dans le champ Mode. Sauvegardez votre Job et appuyez sur F6 pour lexcuter. La rponse HTTP du serveur est alors sauvegarde et affiche.
1286
Composants Internet
tJMSInput
tJMSInput
Proprits du tJMSInput
Fonction Objectif
Ce composant cre une interface entre une application Java et un systme Middleware orient Message. Le tJMSInput permet de mettre en place des interactions entre composants applicatifs dans un cadre faiblement coupl, asynchrone et fiable via un serveur JMS. Module List Context Provider Slectionnez dans cette liste la bibliothque utiliser. Saisissez l'URL de contexte, par exemple "com.tibco.tibjms.naming.TibjmsInitialContextFact ory". Attention cependant, la syntaxe peut varier selon le serveur JMS utilis Saisissez lURL du serveur en respectant la syntaxe, par exemple "tibjmsnaming://localhost:7222". Saisissez le nom JDNI. Si vous devez vous identifier, cochez la case et saisissez votre nom dutilisateur et votre mot de passe. Slectionnez le type de message, Topic ou Queue. Saisissez la source du message, telle quattendue par le serveur. Celle-ci peut tre compos du type et du nom de la source, par exemple : queue/A ou topic/testtopic. Notez que ce champ est sensible la casse. Renseignez le dlai (en secondes) avant de passer au message suivant. Saisissez le nombre maximal de messages traiter. Spcifiez votre filtre. Slectionnez le mode de traitement des messages : Raw Message : message brut, Message Content : contenu du message. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma du composant tJMSInput est en lecture seule. Il est compos dune colonne : Message. Cliquez sur le bouton [+] sous le tableau afin dajouter des lignes contenant le nom et le mot de passe de lutilisateur requis lauthentification.
Basic settings
Server URL Connection Factory JDNI Name Use Specified User Identity Message Type Message From
Timeout for Next Message (in sec) Maximum Messages Message Selector Expression Processing Mode
Advanced settings
Properties
1287
Composants Internet
tJMSInput
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant est gnralement utilis en tant que composant de dbut. Il requiert un composant de sortie. Assurez-vous que le serveur JMS correspondant est lanc.
Scnario associ :
Pour un scnario associ, consultez le Scnario : Communication asynchrone via un serveur MOM, page 1298.
1288
Composants Internet
tJMSOutput
tJMSOutput
Proprits du tJMSOutput
Fonction Objectif
Ce composant cre une interface entre une application Java et un systme Middleware orient Message. Le tJMSOutput permet de mettre en place des interactions entre composants applicatifs dans un cadre faiblement coupl, asynchrone et fiable via un serveur JMS. Module List Context Provider Slectionnez dans cette liste la bibliothque utiliser. Saisissez l'URL de contexte, par exemple "com.tibco.tibjms.naming.TibjmsInitialContextFact ory". Attention cependant, la syntaxe peut varier selon le serveur JMS utilis Saisissez lURL du serveur en respectant la syntaxe, par exemple "tibjmsnaming://localhost:7222". Saisissez le nom JDNI. Si vous devez vous identifier, cochez la case et saisissez votre nom dutilisateur et votre mot de passe. Slectionnez le type de message, Topic ou Queue. Saisissez la cible du message, telle quattendue par le serveur. Slectionnez le mode de traitement des messages : Raw Message : message brut, Message Content : contenu du message. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma du composant tJMSInput est en lecture seule. Il est compos dune colonne : Message. Slectionnez un mode de rception dans la liste afin dassurer la qualit des donnes lors de la rception : Not Persistent : Ce mode autorise les pertes de donnes durant lchange. Persistent : Ce mode assure lintgrit du message la rception. Cliquez sur le bouton [+] sous le tableau afin dajouter des lignes contenant le nom et le mot de passe de lutilisateur requis lauthentification.
Basic settings
Server URL Connection Factory JDNI Name Use Specified User Identity Message Type To Processing Mode
Advanced settings
Delivery Mode
Properties
1289
Composants Internet
tJMSOutput
Ce composant est gnralement utilis en tant que composant de sortie. Il requiert un composant dentre. Assurez-vous que le serveur JMS correspondant est lanc.
Scnario associ :
Pour un scnario associ, consultez le Scnario : Communication asynchrone via un serveur MOM, page 1298.
1290
Composants Internet
tMicrosoftMQInput
tMicrosoftMQInput
Proprits du tMicrosoftMQInput
Famille de composant Internet/MOM et JMS
Fonction
Le composant tMicrosoftMQInput rcupre le premier message dune file dattente de message Microsoft donne (le composant supporte uniquement le type String). Ce composant vous permet de rcuprer les messages un par un dans lordre de leur ID, dans la file dattente de message Microsoft. Chaque excution rcupre un seul message. PROPERTY Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Queue Saisissez le nom de lhte ou ladresse IP du serveur hte. Saisissez le nom de la file dattente partir de laquelle vous souhaitez rcuprer les messages.
Objectif
Basic settings
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.. Ce composant est gnralement utilis en tant que composant de dbut dans un Job ou un sous-job. Il doit tre li un composant de sortie. Liens de sortie (dun composant un autre) : Row : Main, Iterate. Trigger : Run if, On Subjob Ok, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Main, Iterate Trigger : Run if, On Subjob Ok, On Component Ok, On Component Error. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Utilisation Connexions
Limitation
Ce composant ne supporte que le type String.
1291
Composants Internet
tMicrosoftMQInput
Scnario : Ecrire et rcuprer des messages dans une file dattente de message Microsoft
Ce scnario se compose de deux Jobs. Le premier Job poste des messages dans une file de message Microsoft et le second Job rcupre les messages du serveur. Dans le premier Job, un message de type string est cr via un tRowGenerator et post dans une file dattente de message Microsoft laide dun composant tMicrosoftMQOutput. Un composant tLogRow intermdiaire affiche le flux pass dun composant lautre.
Dposez de la Palette dans lespace de modlisation graphique un tRowGenerator, un tLogRow et un tMicrosoftMQOutput. Cliquez-droit sur le composant tRowGenerator afin douvrir son menu contextuel. Dans ce menu, slectionnez Row > Main afin de relier ce composant au tLogRow. Effectuez la mme opration pour relier le tLogRow au tMicrosoftMQOutput. Double-cliquez sur le tRowGenerator afin douvrir son diteur.
Dans cet diteur, cliquez sur le bouton [+] pour ajouter trois lignes au schma. Dans la colonne Column, saisissez un nouveau nom pour chaque ligne, afin de les renommer. Ici, saisissez respectivement ID, Name et Address. Dans la colonne Type, slectionnez Integer pour la ligne ID dans la liste droulante et laissez les autres lignes en String. Dans la colonne Functions, slectionnez random pour la ligne ID, getFirstName pour la ligne Name et getUsCity pour la ligne Address. Dans le champ Number of Rows for RowGenerator, saisissez 12 afin de limiter le nombre de lignes gnrer. Cliquez sur OK pour valider vos modifications.
Composants Internet
tMicrosoftMQInput
Lors dune utilisation relle, vous devrez utiliser un composant dentre pour charger les donnes qui vous intressent, au lieu du tRowGenerator.
Double-cliquez sur le composant tMicrosoftMQOutput afin douvrir sa vue Component.
Dans le champ Host, saisissez ladresse de lhte. Dans cet exemple, saisissez localhost. Dans le champ Queue, saisissez le nom de la file de messages dans laquelle vous souhaitez crire le message. Dans cet exemple, nommez-la AddressQueue. Dans le champ Message column (String Type), slectionnez Address dans la liste droulante afin de dterminer le corps du message crire. Appuyez sur F6 pour excuter le Job.
Vous pouvez voir que la file a t cre automatiquement et que les messages ont t crits. Crez ensuite le second Job pour rcuprer le premier message de la file dattente.
1293
Composants Internet
tMicrosoftMQInput
Dposez un tMicrosoftMQInput et un tLogRow de la Palette dans lespace de modlisation graphique. Reliez ces deux composants laide dun lien Row > Main. Double-cliquez sur le tMicrosoftMQInput afin douvrir sa vue Component.
Dans le champ Host, saisissez le nom ou ladresse de lhte. Ici, saisissez localhost. Dans le champ Queue, saisissez le nom de la file dattente de message aprtir de laquelle vous souhaitez rcuprer le message. Dans cet exemple, saisissez AddressQueue. Appuyez sur F6 pour excuter le Job.
Le corps du message Atlanta rcupr de la file dattente saffiche dans la console.
1294
Composants Internet
tMicrosoftMQOutput
tMicrosoftMQOutput
Proprits du tMicrosoftMQOutput
Famille de composant Internet/MOM and JMS Le composant tMicrosoftMQOutput crit une colonne dfinie dun flux dentre de donnes dans une file de messages Microsoft (le composant supporte uniquement le type String). Ce composant permet dcrire des messages dans une file dattente de messages Microsoft. PROPERTY Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Host Queue Saisissez le nom de lhte ou ladresse IP du serveur hte. Saisissez le nom de la file de messages dans laquelle vous souhaitez crire un message. Cette file peut tre cre automatiquement la vole si elle nexiste pas. Slectionnez le message crire dans la file de messages Microsoft. Le message slectionn doit tre de type String.
Fonction
Message column
Ce composant doit tre li un composant dentre ou intermdiaire. Liens de sortie (dun composant un autre) : Row : Main, Iterate. Trigger : Run if, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Main, Reject, Iterate Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
Le message crire ne peut tre null.
Scnario associ
Pour un scnario associ, consultez le Scnario : Ecrire et rcuprer des messages dans une file dattente de message Microsoft, page 1292
1295
Composants Internet
tMomCommit
tMomCommit
Proprits du tMomCommit
Ce composant est troitement li au composant tMomRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Fonction Objectif
Le composant tMomCommit commite des donnes sur le serveur MQ. En utilisant une connexion unique, commitez en une seule fois une transaction globale au lieu de commiter chaque ligne ou chaque lot de lignes. Ce composant permet un gain de performance. Component list MQ Server Close connection Slectionnez dans la liste le composant de connexion du le Job en cours. Slectionnez dans cette liste le serveur MOM utiliser. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tMomCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne.
Basic settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis avec des composants Mom, notamment avec le composant tMomRollback. n/a
Scnario associ
Pour plus dinformations relatives au fonctionnement du composant tMomCommit, consultez Proprits du tMysqlConnection page 630.
1296
Composants Internet
tMomInput
tMomInput
Proprits du tMomInput
Ce composant rcupre un message dune file dattente dun systme Middleware orient Message et le passe au composant suivant. Le tMomInput permet de mettre en place des communications asynchrones via un serveur MOM. Keep Listening Cochez cette case pour consulter en continu le serveur MOM pour rcuprer les nouveaux messages. - Si vous slectionnez le serveur JBoss Messaging, cocher cette case fera apparatre le champ Sleeping time (in sec). - Si vous slectionnez le serveur ActiveMQ, cocher cette case fera disparatre le champ Sleeping time (in sec). Saisissez en secondes la frquence de variation. Ce champ nest pas disponible si vous slectionnez le serveur Websphere MQ dans la liste MQ Server. MQ Server Slectionnez dans cette liste le serveur MOM utiliser. Les paramtres requis diffrent lgrement en fonction du serveur slectionn. Renseignez le nom de lhte (Host) et ladresse IP du serveur MOM ainsi que le Port. Identifiant de connexion au serveur MQ. Mot de passe de connexion au serveur MQ. Saisissez la source du message, telle quattendue par le serveur. Celle-ci peut tre compos du type et du nom de la source, par exemple : queue/A ou topic/testtopic. Notez que ce champ est sensible la casse. Ce champ nest pas disponible si vous slectionnez le serveur Websphere MQ dans la liste MQ Server. Message Type Slectionnez le type de message : topic ou queue. Ce champ nest pas disponible si vous slectionnez le serveur Websphere MQ dans la liste MQ Server. Message Body Type Slectionnez le type de message : Text, Bytes ou Map.
Sleeping time (in sec)
Host/Port Username Password Message From
1297
Composants Internet
tMomInput
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma du composant tMomInput est en lecture seule. Il est compos de deux colonnes : From et Message. La valeur par dfaut est DC.SVRCONN. Renseignez le gestionnaire de file(s) dattente. Saisissez le nom de la file dattente. Cochez cette case pour appliquer un filtre portant sur les messages id, filtre que vous dterminerez dans le champ Message id.
Websphere MQ uniquement
Channel Queue Manager Message Queue Is using message id to fetch
Commit (delete Cochez cette case afin de forcer le commit aprs message after reading lecture de chaque message dans la file dattente. from the queue) ActiveMQ uniquement Receive number of messages Cochez cette case afin de limiter le nombre de messages recevoir. Une fois la case coche, le champ maximum messages apparat, dans lequel vous pouvez saisir le nombre maximum de messages recevoir. Lorsque vous choisissez de limiter le nombre de messages recevoir, la limite de temps devient inactive, les champs Keep listening/Sleeping time (in sec) disparaissent. Advanced settings Utilisation Limitation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est gnralement utilis en tant que composant de dbut. Il requiert un composant de sortie. Assurez-vous que le serveur Websphere, JBoss ou ActiveMQ correspondant est lanc.
Scnario : Communication asynchrone via un serveur MOM

Ce scnario est compos de deux Jobs. Le premier permet de poster des messages sur la file dattente du serveur JBoss et le deuxime recupre les messages de ce serveur. Dans le premier Job, un message compos de chanes de caractres est cr laide du composant tRowGenerator puis transmis au serveur JBoss laide du composant tMomOutput. Un composant intermdiaire, le composant tLogRow, permet dafficher le flux transmis.
1298
Composants Internet
tMomInput
Cliquez et dposez ces trois composants dans votre premier Job et connectez-les via le clic-droit avec des liens de type Main row. Double-cliquez sur le composant tRowGenerator pour configurer le schma des donnes qui seront gnres de manire alatoire.
Crez une seule colonne appele message. Elle correspond au message qui sera mis sur la file dattente du MOM. Cette colonne est de type String et peut contenir une valeur nulle. Pour produire les donnes, utilisez une fonction prdfinie permettant de concatner de manire alatoire les caractres ascii choisis pour former la chane de 6 caractres. Cette fonction est la suivante : getAsciiRandomString. (version Java). Cliquez sur le bouton daperu pour afficher un chantillon au hasard des donnes gnres. Paramtrez le champ Number of rows to be generated permettant de dfinir le nombre de lignes gnre 10. Cliquez sur OK pour valider. Le composant tLogRow est uniquement utilis pour afficher un tat intermdiaire des donnes manipules. Dans cet exemple, aucune configuration spcifique nest ncessaire. Puis slectionnez le composant tMomOutput.
Dans cet exemple, le serveur MQ server utiliser est de type JBoss. Dans les champs Host et Port, renseignez les informations de connexion correspondantes. Slectionnez le type de message dans la liste droulante Message type, il peut tre de type Queue ou Topic. Pour cet exemple, slectionnez le type Queue dans la liste. Dans le champ To, saisissez les informations source du message strictement telles quelles sont attendues par le serveur. Il doit correspondre au type de message que vous avez slectionn dans la liste droulante Message Type, notamment : queue/A.
Le nom du message est sensible la casse, ainsi queue/A et Queue/A sont diffrents.
1299
Composants Internet
tMomInput
Puis cliquez sur Sync Columns pour rcuprer le schma du composant prcdent. Le schma tant en lecture seule, il ne peut tre modifi. Les donnes envoyes sur le serveur MQ proviennent de la premire colonne rencontre du schma. Excutez le Job et, grce au composant tLogRow, observez dans la console le flux de donnes transmis.
Puis paramtrez le deuxime Job pour rcuprer les messages de la file dattente du serveur MOM.
Cliquez et dposez un composant tMomInput (dans la famille Internet de la Palette) et un composant tLogRow pour afficher les messages rcuprs. Slectionnez le tMomInput et dfinissez ses paramtres.
Slectionnez le serveur MQ server dans la liste. Dans cet exemple, un serveur de message JBoss est utilis. Renseignez les informations Host et Port du serveur. Renseignez les paramtres des champs Message From et Message Type afin quils correspondent la source et au type de message attendus par le serveur de message. Le schma dans le champ Schema est en lecture seule et est compos de deux colonnes : From et Message. Cochez la case Keep listening et paramtrez la frquence de vrification 5 secondes.
Lorsque vous utilisez loption Keep Listening, vous devez cliquez sur le bouton Kill pour stopper le Job.
Laissez les paramtres par dfaut du composant tLogRow. Enregistrez le Job et excutez-le (si vous le lancez pour la premire fois ou si vous lavez stopper au cours dun lancement prcdent).
1300
Composants Internet
tMomInput
Les messages rcuprs sur le serveur sont affichs dans la console.
1301
Composants Internet
tMomMessageIdList
tMomMessageIdList
Proprits du tMomMessageIdList
Fonction
Le composant tMomMessageIdList rcupre la liste des ID des messages partir de la file dattente dun systme Middleware orient Message et la passe au composant suivant. Le tMomMessageIdList permet ditrer les ID de certains messages. Il est gnralement utilis avec le tMomInput. Pour plus dinformations, consultez tMomInput, page 1297. MQ Server Slectionnez dans cette liste le serveur MOM utiliser. Les paramtres requis diffrent lgrement en fonction du serveur slectionn. Renseignez le nom de lhte (Host) et ladresse IP du serveur MOM ainsi que le Port. La valeur par dfaut est Channel. Renseignez le gestionnaire de file(s) dattente. Saisissez le nom de la file dattente.
Objectif
Basic settings
Host/Port Websphere Channel Queue Manager Message Queue Utilisation Limitation
Ce composant est gnralement utilis en tant que composant de dbut. Il requiert un composant de sortie. Assurez-vous que le serveur Websphere correspondant est lanc.
Scnario associ
Pour un scnario associ, consultez le composant tMomInput, page 1297.
1302
Composants Internet
tMomOutput
tMomOutput
Proprits du tMomOutput
Dpose un message sur la file dattente dun systme Middleware orient message afin quil soit rcupr de manire asynchrone. Le tMomOutput permet de mettre en place des communications asynchrones via un serveur MOM. MQ Server Slectionnez dans la liste le serveur MOM utiliser. En fonction du serveur slectionn, les paramtres diffrent lgrement. Renseignez le nom de lhte ou ladresse IP du serveur MOM dans le champ Host, ainsi que le Port. Identifiant de connexion au serveur. Mot de passe de connexion au serveur. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Lors de lutilisation du composant tMomOutput, le schma est en lecture seule mais changera en fonction du schma dentre. Le serveur attend uniquement un schma une colonne pour contenir les Messages. La valeur par dfaut est Channel. Slectionnez le type de message : Text, Bytes ou Map. Renseignez le gestionnaire de file(s) dattente. Saisissez le nom de la file dattente. Cochez cette case pour paramtrer les messages selon leur ID. Saisissez la destination du message, telle quelle est attendue par le serveur ; le type est le nom du dossier cible doivent tre indiqus, par exemple : queue/A ou topic/testtopic Notez que ce champ est sensible la casse. Slectionnez le type de message : topic ou queue. Slectionnez le type de message : Text, Bytes ou Map. Saisissez la destination du message, telle quelle est attendue par le serveur ; le type est le nom du dossier cible doivent tre indiqus, par exemple : queue/A ou topic/testtopic Notez que ce champ est sensible la casse.
Host/Port Username Password Schema et Edit Schema
Websphere
Channel Message Body Type Queue Manager Message Queue Is using message id to set
JBoss Messaging
To
Message Type Message Body Type ActiveMQ To
1303
Composants Internet
tMomOutput
Message Type Message Body Type Utilisation Limitation
Slectionnez le type de message : topic ou queue. Slectionnez le type de message : Text, Bytes ou Map.
Ce composant ncessite un composant dentre ou un composant intermdiaire. Assurez-vous que le serveur Websphere, JBoss ou ActiveMQ correspondant est bien lanc.
Scnario associ
Pour un exemple dutilisation du tMomOutput, consultez tMomInput page 1297.
1304
Composants Internet
tMomRollback
tMomRollback
Proprits du tMomRollback
Ce composant est troitement li au composant tMomCommit. Ils sont gnralement utiliss ensemble lors de transactions.
Le tMomRollback annule la transaction sur le serveur MQ. Ce composant vite le commit de transaction involontaire. Component list MQ Server Close Connection Slectionnez dans la liste le composant de connexion du Job en cours. Slectionnez dans cette liste le serveur MOM utiliser. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Il faut utiliser ce composant en association avec des composants Mom, notamment avec le tMomCommit. n/a
Scnario associ
Pour un scnario associ au tMomRollback, consultez le Scnario : Annuler linsertion de donnes dans des tables mre/fille, page 674 du composant tMysqlRollback.
1305
Composants Internet
tPOP
tPOP
Proprits du tPOP
Fonction Objectif
Le composant tPOP rcupre un ou plusieurs e-mails partir dun protocole POP3 ou IMAP. Le composant tPOP utilise le protocole POP ou IMAP pour se connecter au serveur de messagerie spcifi. Il rcupre ensuite un ou plusieurs e-mails et crit les informations rcupres dans un ou plusieurs fichiers dfinis. Les paramtres avancs (Advanced settings) permettent d'appliquer un ou plusieurs filtres la slection. Host Renseignez le nom de lhte ou ladresse IP du serveur de messagerie auquel vous voulez vous connecter. Renseignez le numro du port du serveur de messagerie. Renseignez les informations dauthentification votre compte de messagerie : Username : entrez lidentifiant que vous utilisez pour accder votre bote mail. Password : entrez le mot de passe de connexion votre bote mail. Renseignez le chemin daccs au dossier dans lequel vous voulez stocker les e-mails rcuprs partir de votre messagerie, ou cliquez sur [...] pour parcourir vos dossiers jusqu lemplacement souhait. Appuyez sur Ctrl+Espace pour afficher la liste des modles prdfinis ou dfinissez manuellement la syntaxe du nom des fichiers cible. Les donnes des e-mails rcuprs partir du serveur de messagerie sont crites dans ces fichiers. Par dfaut, tous les messages prsents sur le serveur de messagerie spcifi sont rcuprs. Pour ne rcuprer qu'un nombre dfini de messages, dcochez cette case et renseignez dans le champ Number of emails to retrieve : le nombre de-mails rcuprer. La collecte des e-mails se fait du plus rcent au plus ancien. Cochez cette case si vous ne souhaitez pas conserver sur le serveur les e-mails rcuprs. Pour les serveurs Gmail, cette option ne fonctionne pas avec le protocole POP3. Slectionnez le protocole IMAP et vrifiez que le compte Gmail est configur pour utiliser ce protocole.
Basic settings
Java uniquement
Port Username et Password
Output directory
Filename pattern
Retrieve all emails?
Delete emails from server
1306
Composants Internet
tPOP
Java uniquement
Choose the protocol
Slectionnez partir de la liste droulante le protocole utiliser pour rcuprer les e-mails. Le protocole dpend de celui utilis par votre messagerie. Si vous choisissez le protocole imap, vous aurez la possibilit de spcifier le dossier contenant les e-mails que vous souhaitez rcuprer. Cochez cette case si votre serveur de messagerie utilise ce protocole de scurisation des changes. Cette option est obligatoire pour les utilisateurs de messagerie Gmail.
Java uniquement
Use SSL
Advanced settings Java uniquement
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Filter Cliquez sur le bouton [+] pour ajouter des lignes de filtre afin de ne rcuprer quune slection de-mails : Filter item : slectionnez lun des types de filtre suivants partir de la liste droulante : From : les messages sont filtrs en fonction de ladresse e-mail de provenance. To : les messages sont filtrs en fonction de ladresse e-mail de destination. Subject : les messages sont filtrs en fonction du sujet. Before date : les messages sont filtrs en fonction de la date dmission ou de rception ; ils doivent tre antrieurs la date indique. After date : les messages sont filtrs en fonction de la date dmission ou de rception ; ils doivent tre postrieurs la date indique. Pattern : appuyez sur Ctrl+Espace pour afficher la liste des valeurs disponibles et slectionnez la valeur utiliser pour chacun des filtres.
Java uniquement
Filter condition relation
Slectionnez le type de relation appliquer entre les filtres : and : les conditions dtermines par les filtres sajoutent les unes aux autres, la recherche est plus restrictive. or : les conditions dtermines par les filtres sont indpendantes les unes des autres, la recherche est plus large.
Ce composant ne traite pas de flux de donnes, il peut donc tre utilis seul. n/a
Scnario : Rcuprer une slection de-mails partir dun compte de messagerie

Ce scnario Java un seul composant a pour but de rcuprer un nombre prdfini de-mails partir dun compte de messagerie. A partir de la Palette, cliquez-dposez un composant tPOP dans lditeur graphique,
Composants Internet
tPOP
Double-cliquez sur le tPOP pour afficher la vue Basic settings et paramtrer le composant. Renseignez les informations de connexion au serveur de messagerie : le nom de lhte ou son adresse IP entre guillemets dans le champ Host et le numro de port dans le champ Port. Saisissez ensuite les informations d'authentification de votre compte de messagerie. Dans le champ Username, saisissez entre guillemets votre identifiant et dans le champ Password, saisissez votre mot de passe. Dans cet exemple, le serveur de messagerie s'appelle Free.
Dans le champ Output directory, slectionnez manuellement le chemin daccs ou cliquez sur [...] pour slectionner le dossier de destination des e-mails rcuprs sur le serveur. Dans le champ Filename pattern, dfinissez la syntaxe de nommage des fichiers de destination ou appuyez sur Ctrl+Espace pour afficher la liste des modles prdfinis. Dans cet exemple, la syntaxe est la suivante : TalendDate.getDate("yyyyMMdd-hhmmss") + "_" + (counter_tPOP_1 + 1) + ".txt" Les fichiers de destination, enregistrs au format texte, sont dfinis par leur date, heure et ordre de collecte. Dcochez la case Retrieve all emails? pour ne rcuprer quun nombre dfini de-mails. Dans cet exemple, 10 messages sont rcuprs. Cochez la case Delete emails from server pour supprimer les e-mails du serveur une fois quils ont t rcuprs en local. Slectionnez un type de protocole partir de la liste droulante Choose the protocol. Le choix du protocole dpend de celui utilis par votre fournisseur de messagerie. Certains fournisseurs comme Gmail utilisent les deux protocoles. Dans cet exemple, le protocole slectionn est pop3. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
1308
Composants Internet
tPOP
Le composant tPOP a ainsi rcupr les 10 derniers messages du compte de messagerie spcifi. Pour chaque e-mail rcupr, un fichier .txt a t cr dans le dossier tPOP. Chaque fichier contient les mtadonnes d'envoi du message (expditeur, destinataire, objet du message) ainsi que les donnes propres au message.
1309
Composants Internet
tREST
tREST
Proprits du tREST
Fonction
Le composant tREST envoie des requtes HTTP un fournisseur de services Web REpresentational State Transfer (REST) et obtient les rponses correspondantes. Le composant tREST sert de client dun service Web REST. Il envoie des requtes HTTP un fournisseur de services Web et obtient les rponses correspondantes. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le composant tREST utilise toujours un schma local (built-in) en lecture seule qui contient deux colonnes : - Body : stocke les rsultats provenant du serveur - ERROR_CODE : stocke le code de statut HTTP lorsquune erreur survient pendant le processus dinvocation. Le sens spcifique des codes derreur est soumis aux dfinitions de votre fournisseur de services Web. Pour plus dinformations, consultez en.wikipedia.org/wiki/List_of_HTTP_stat us_codes. (en anglais). Cliquez sur Edit Schema pour visualiser le schma. Modifier le schma peut engendrer une perte de la structure du schma et donc un chec du composant. URL HTTP Method Renseignez ladresse URL du serveur Web REST invoquer. A partir de cette liste, slectionnez une mthode HTTP qui dcrit laction souhaite. Le sens spcifique des mthodes HTTP est soumis aux dfinitions de votre fournisseur de services Web. Ci-dessous, les dfinitions des mthodes HTTP gnralement admises : - GET : rcupre les donnes du ct serveur en fonction des paramtres donns. - POST : cre et tlcharge les donnes en fonction des paramtres donns. - PUT : met jour les donnes en fonction des paramtres donns, ou cre les donnes si elles sont inexistantes. - DELETE : supprime les donnes en fonction des paramtres donns.
Objectif
Basic settings
1310
Composants Internet
tREST
HTTP Headers
Saisissez les paires nom/valeur (name/value) pour les en-ttes HTTP afin de dfinir les paramtres de lopration HTTP demande. Pour connatre les dfinitions spcifiques den-ttes HTTP, consultez votre fournisseur de services Web REST. Pour plus dinformations, consultez en.wikipedia.org/wiki/List_of_HTTP_hea ders. (en anglais). Saisissez les donnes utiles (payload) charger du ct serveur lorsque les actions POST ou PUT sont slectionnes.
HTTP Body
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.. Ce composant est utilis comme client dun service Web REST afin de communiquer avec un fournisseur de services Web REST. Il requiert un composant de sortie. Lexcution de JRE 1.6 est requise pour faire fonctionner ce composant.
Utilisation
Limitation
Scnario : Crer et rcuprer des donnes en invoquant un service Web REST

Ce scnario dcrit un Job simple qui invoque un service Web REST afin de crer un nouvel enregistrement client du ct serveur et de rcuprer les informations du client. Une fois excut, ce Job affiche les informations correspondantes dans la console de la vue Run. A partir de la Palette, cliquez-dposez les composants suivants dans lespace de modlisation graphique : deux composants tREST et deux composants tLogRow. Renommez les deux composants tREST afin quils dcrivent au mieux les actions effectuer. Connectez chaque composant tREST un tLogRow laide dune connexion de type Row > Main. Connectez le premier composant tREST au second tREST laide dune connexion de type Trigger > OnSubjobOK.
1311
Composants Internet
tREST
Double-cliquez sur le premier composant tREST afin dafficher longlet Basic settings de sa vue Component.
Renseignez le champ URL avec ladresse URL du serveur Web que vous tes sur le point dinvoquer. Notez que ladresse URL fournie dans ce scnario est destine essentiellement la dmonstration, ce nest pas une adresse valide. A partir de la liste HTTP Method, slectionnez POST afin denvoyer une requte HTTP permettant de crer un nouvel enregistrement. Cliquez sur le bouton [+] afin dajouter une ligne au tableau HTTP Headers, et saisissez la paire nom-valeur (name-value) adquate, soumise aux dfinitions de votre fournisseur de service, en indiquant le type de mdia des donnes utiles (payload) envoyer du ct serveur. Dans ce scnario, saisissez Content-Type et application/xml. Pour plus dinformations concernant les types de mdia Internet, consultez www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.7. (en anglais). Saisissez dans le champ HTTP Body les donnes utiles (payload) charger du ct serveur, savoir <Customer><name>Steven</name></Customer> dans ce scnario, pour crer un enregistrement dun nouvel utilisateur appel Steven.
Si vous souhaitez inclure des guillemets double dans votre payload, assurez-vous dutiliser un caractre dchappement, la barre oblique inverse, avant chaque guillemet. Dans ce scnario par exemple, saisissez <Customer><name>\"Steven\"</name></Customer> si vous souhaitez mettre le prnom Steven entre guillemets double.
Double-cliquez sur le second tREST afin dafficher longlet Basic settings de sa vue Component. Renseignez le champ URL avec la mme adresse URL que celle utilise dans le premier composant tREST. A partir de la liste HTTP Method, slectionnez GET afin denvoyer une requte HTTP permettant de rcuprer tous les enregistrements existants.
1312
Composants Internet
tREST
Dans longlet Basic settings de la vue Component de chaque tLogRow, cochez la case Print component unique name in front of each output row (Afficher le nom unique du composant en face de chaque ligne de sortie) pour identifier au mieux les deux flux de sortie.
Sauvegardez votre Job et appuyez sur F6 pour lexcuter. La console indique que le premier composant tREST envoie une requte HTTP ct serveur afin de crer un nouvel utilisateur appel Steven et que le second composant tREST lit avec succs les donnes ct serveur comprenant les informations de lutilisateur nouvellement cr.
1313
Composants Internet
tRSSInput
tRSSInput
Proprits du tRSSInput
Fonction Objectif
Le composant tRSSInput lit des flux RSS en utilisant des URLs. Le tRSSInput permet de suivre les billets posts sur certains sites en particulier afin den rassembler et organiser les informations rapidement et facilement pour votre utilisation. Schema type et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Dans le contexte dutilisation du tRSSInput, le schma est compos de quatre colonnes : TITLE, DESCRIPTION, PUBDATE et Link. Les paramtres de titre sont en lecture seule, contrairement leur type et leur longueur. Saisissez lURL du flux RSS lire. Lorsque cette case est coche, le composant tRSSInput lit les articles du flux RSS partir de la date renseigne en cliquant sur le bouton [...] situ ct du champ date time. Lorsque cette case est coche, le composant tRSSInput lit autant darticles que le nombre spcifi dans le champ max amount. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et les lignes contenant les erreurs seront ignores.
Basic settings
RSS URL Read articles from
Max number of articles Die on error
Ce composant est gnralement utilis en tant que composant de dbut. Il requiert un composant de sortie. n/a.
Scnario : Rcuprer les billets frquemment mis jour sur un blog

Ce scnario Java deux composants a pour but de rcuprer les billets qui sont souvent mis jour sur un blog, partir dun flux RSS local Talend, en utilisant le composant tRSSInput. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tRSSInput et le tLogRow. Cliquez-droit sur le premier pour le connecter au second laide dun lien de type Row Main.
1314
Composants Internet
tRSSInput
Dans lditeur graphique, slectionnez le tRSSInput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tRSSInput.
Configurez le champ Schema Type en mode Built-In puis cliquez sur le bouton [...] situ ct du champ Edit Schema pour changer le type et la longueur des paramtres du schma si ncessaire. Cliquez sur OK pour fermer la bote de dialogue.
Le schma du tRSSInput est compos de quatre colonnes, TITLE, Description, PUBDATE, et LINK. Il est en lecture seule, except pour les paramtres de type et de longueur.
Dans longlet Basic settings du composant tRSSInput, saisissez lURL daccs au flux RSS. Dans ce scnario, le tRSSInput est associ au flux RSS Talend : http://feeds.feedburner.com/Talend.
1315
Composants Internet
tRSSInput
Cochez/dcochez les autres cases selon vos besoins. Dans ce scnario, on veut afficher les informations de deux articles dats du 20 juillet 2008. Dans lespace graphique, slectionnez le tLogRow puis cliquez sur la vue Component pour en dfinir la configuration de base. Pour plus dinformations sur les proprits du composant tLogRow, consultez les Proprits du tLogRow, page 1399. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
Le composant tRSSInput a accd au flux RSS du site de Talend votre place et en a organis les informations pour vous. Deux billets sont affichs sur la console. Chacun deux a ses propres titre, description, date de publication et URL du flux RSS correspondante. Les blogs prsentent le dernier billet en premier et vous pouvez faire dfiler vers le bas pour lire les billets les plus anciens.
1316
Composants Internet
tRSSOutput
tRSSOutput
Proprits du tRSSOutput
Le composant tRSSOutput crit des fichiersXML RSS_Feed ou Atom_Feed. Le tRSSOutput permet de crer des fichiers XML contenant des flux RSS ou Atom. File Name Chemin daccs ou nom du fichier XML en sortie. Consultez galement la section Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette option pour ajouter des nouvelles lignes la fin du fichier. Slectionnez RSS ou ATOM selon le flux que vous souhaitez gnrer. Les informations renseigner dans cette zone concernent lintgralit des donnes saisies, du site, etc. plutt que des lments particuliers. Title : Saisissez un titre significatif. Description : Entrez une description du contenu qui vous semble suffisamment dtaille. Publication date : Renseignez la date adquate. Link : Saisissez lURL approprie. Feed (en mode ATOM) Title : Saisissez un titre significatif. Link : Saisissez lURL approprie. Id : Saisissez lURL valide correspondant au champ Link. Update date : Saisissez la date de mise jour. Author name : Saisissez le nom de lauteur. Renseignez dans le tableau les informations relatives aux mtadonnes du flux RSS. Cliquez sur le bouton [+] pour ajouter de nouvelles lignes : Element Name : nom de la mtadonne. Element Value : contenu de la mtadonne.
Encoding
Append Mode Channel (en mode RSS)
Optionnal Channel Elements
1317
Composants Internet
tRSSOutput
Schema type et Edit schema
Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Dans le contexte dutilisation du tRSSInput, le schma est compos de quatre colonnes : TITLE, DESCRIPTION, PUBDATE et Link. Les paramtres de titre sont en lecture seule, contrairement leur type et leur longueur.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant. Ce composant doit obligatoirement tre reli un composant de dbut ou un composant intermdiaire. n/a
Scnario 1 : Crer un flux RSS et stocker les fichiers sur un serveur FTP
Ce scnario Java a pour but de : crer un flux RSS pour des fichiers que vous souhaitez partager avec dautres personnes, et stocker lensemble des fichiers sur un serveur FTP. Ce scnario permet dcrire un fichier XML de flux RSS partir dune table MySQL contenant des informations concernant des livres. Il ajoute galement des liens vers les fichiers stocks sur un serveur FTP au cas o les utilisateurs voudraient avoir accs aux fichiers dans leur intgralit. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tMysqlInput, le tRSSOutput et le tFTPPut. Cliquez droit sur le tMysqlInput et connectez-le au tRSSOutput laide dun lien de type Row Main. Cliquez droit sur le tMysqlInput et connectez-le au tFTPPut laide dun lien de type OnSubjobOk.
1318
Composants Internet
tRSSOutput
Dans lespace graphique, slectionnez le tMysqlInput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tMysqlInput.
Configurez le champ Property type en mode Repository puis cliquez sur le bouton [...] pour slectionner la base de donnes adquate dans la liste. Les dtails de connexion ainsi que le schma sont remplis automatiquement. Dans le champ Table Name, saisissez le nom de votre table ou cliquez sur le bouton [...] et slectionnez le nom de la table partir de la liste. Dans ce scnario, la table Mysql de donnes saisies sappelle rss_talend et le schma comporte quatre colonnes, TITLE, Description, PUBDATE, et LINK. Dans le champ Query, saisissez la requte de base de donnes en faisant particulirement attention ce que lordre des champs corresponde au schma dfini, ou cliquez sur Guess Query. Dans lespace graphique, slectionnez le composant tRSSOutput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tRSSOutput.
1319
Composants Internet
tRSSOutput
Dans le champ File name, utilisez le nom de fichier et son chemin daccs dfinis par dfaut ou parcourez vos dossiers pour dfinir votre propre fichier XML de sortie. Slectionnez le type dencodage partir de la liste Encoding Type. Dans la zone Mode, slectionnez RSS. Dans le panneau Channel, saisissez un titre, une description, une date de publication et un lien dfinissant lensemble de vos donnes saisies. Slectionnez le type de schma dans la liste Schema Type puis cliquez sur Edit Schema pour le modifier si ncessaire.
Vous pouvez galement cliquer sur Sync Column pour rcuprer le schma gnr par le composant prcdent.
Enregistrez votre Job puis appuyez sur F6 pour en excuter la premire partie.
1320
Composants Internet
tRSSOutput
Le composant tRSSOutput a cr en sortie un flux RSS au format XML pour les fichiers dfinis. Pour stocker lintgralit des fichiers sur un serveur FTP : Dans lespace graphique, slectionnez le FTPPut. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFTPPut.
1321
Composants Internet
tRSSOutput
Saisissez le nom du serveur et le numro de port dans les champs correspondants. Renseignez vos dtails de connexion dans les champs Username et Password. Parcourez vos dossier jusquau rpertoire local ou tapez manuellement le chemin daccs dans le champ Local directory. Entrez les dtails du serveur de rpertoire distant. Slectionnez le mode de transfert partir de la liste Transfer mode. Dans le panneau Files, cliquez sur le bouton [+] pour ajouter des lignes puis remplissez les masques de fichiers de tous les fichiers copier sur le rpertoire distant. Dans ce scnario, les fichiers enregistrer sur le serveur FTP sont tous des fichiers texte. Enregistrez votre Job puis appuyez sur F6 pour lexcuter. Les fichiers dfinis sont copis sur le serveur distant.
Scnario 2 : Crer un flux RSS contenant des mtadonnes

Ce scnario Java deux composants a pour but de crer un flux RSS contenant des mtadonnes et de rediriger les informations obtenues dans un fichier XML de flux RSS en sortie. A partir de la Palette, cliquez-dposez les composants tRSSInput et tRSSOutput dans lditeur graphique. Cliquez droit sur le tRSSInput et connectez-le au tRSSOutput laide dun lien de type Row Main.
Dans lespace graphique, slectionnez le tRSSInput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tRSSInput.
Dfinissez le type du schma comme Built-In.
1322
Composants Internet
tRSSOutput
Si votre schma est dj stock localement dans le Repository, slectionnez loption Repository dans le champ Schema, puis cliquez sur le bouton [...] ct du champ Edit Schema pour afficher une bote de dialogue dans lasquelle vous pouvez choisir les mtadonnes appropries. Pour plus dinformations concerenant les mtadonnes, consultez Gestion des mtadonnes dans le Guide Utilisateur Talend Open Studio.
Cliquez sur le bouton [...] situ ct du champ Edit Schema pour vrifier les paramtres du schma si ncessaire.
Le schma du tRSSInput est compos de quatre colonnes, TITLE, DESCRIPTION, PUBDATE, et LINK et il est en lecture seule. Cliquez sur OK pour fermer la bote de dialogue. Dans lespace graphique, double-cliquez sur le composant tRSSOutput pour ouvrir sa vue Component et dfinir sa configuration de base (Basic settings).
1323
Composants Internet
tRSSOutput
Dans le champ File name, utilisez le nom de fichier de sortie et son chemin daccs dfinis par dfaut ou parcourez vos dossiers pour dfinir votre propre fichier XML de sortie. Slectionnez le type dencodage partir de la liste Encoding Type. Dans la zone Mode, slectionnez RSS. Dans le panneau Channel, saisissez un titre, une description, une date de publication et un lien dfinissant lensemble de vos donnes saisies. Dans le tableau Optional Channel Element, dfinissez les mtadonnes de votre flux RSS. Dans ce scnario, le flux comprend deux mtadonnes : copyright, laquelle est associe la valeur tos, et language, laquelle est associe la valeur en_us. Slectionnez le type de schma dans la liste Schema Type puis cliquez sur Edit Schema pour le modifier si ncessaire.
Vous pouvez galement cliquer sur Sync Column pour rcuprer le schma gnr par le composant prcdent.
Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
1324
Composants Internet
tRSSOutput
Les fichiers dfinis sont copis dans le fichier XML de sortie et les mtadonnes apparaissent sous le noeud <channel>, en dessous des informations de base du flux RSS.
Scnario 3 : Crer un fichier XML de flux ATOM

Ce scnario Java dcrit un Job deux composants, qui gnre des donnes et les crit dans un fichier XML de flux ATOM. Dposez les composants suivants de la Palette dans lespace de modlisation graphique : un tFixedFlowInput du groupe Misc et un tRSSOutput du groupe Internet. Cliquez-droit sur le tFixedFlowInput et connectez-le au tRSSOutput laide dun lien Row Main. Une fentre pop-up saffiche et vous demande si vous souhaitez passer le schma du tRSSOutput au tFixedFlowInput, cliquez sur Yes (Oui).
1325
Composants Internet
tRSSOutput
Dans lespace de modlisation graphique, double-cliquez sur le tFixedFlowInput afin dafficher sa vue Component et dfinir ses Basic settings.
Laissez le type de Schema en Built-in. Cliquez sur le bouton [...] ct du champ Edit schema pour afficher le schma import du composant de sortie. Dans le champ Number of rows, laissez le paramtre par dfaut, 1, pour ne gnrer quune ligne de donnes. Dans la zone Mode, laissez slectionne loption Use Single Table et remplissez le tableau Values. Notez que le champ Column du tableau Values est rempli par les colonnes du schma dfini dans le composant. Dans le champ Value du tableau Values, saisissez les donnes que vous souhaitez envoyer au composant suivant. Dans lespace de modlisation, double-cliquez sur le composant tRSSOutput afin dafficher sa vue Component et dfinir ses Basic settings.
1326
Composants Internet
tRSSOutput
Cliquez sur le bouton [...] ct du champ File Name afin de dfinir le rpertoire et le nom du fichier XML de sortie. Dans la zone Mode, slectionnez ATOM pour gnrer un fichier XML de flux ATOM. Dans la zone Feed, saisissez un titre, un lien, un ID, la date de mise jour, et le nom de lauteur, afin de dfinir vos donnes comme un tout. Slectionnez le type de votre schma, dans la liste Schema Type puis cliquez sur le bouton [...] du champ Edit Schema afin dafficher le schma et de le modifier si ncessaire.
1327
Composants Internet
tRSSOutput
Comme le format du flux ATOM est strict, des informations par dfaut sont requises afin de crer le fichier XML. Le schma du tRSSOutput comprend donc des colonnes par dfaut contenant ces informations. Ces colonnes par dfaut sont grises pour indiquer quelles ne doivent pas tre modifies. Si vous choisissez de modifier le schma du composant, le fichier XML ATOM cr ne sera pas valide.
Save your Job and press F6 to execute it.
Le composant tRSSOutput cre un flux de sortie ATOM au format XML.
1328
Composants Internet
tSCPClose
tSCPClose
Proprits du tSCPClose
Famille de composant Internet/SCP
Le composant tSCPClose ferme la connexion au protocole entirement crypt. Ce composant permet de fermer une connexion au protocole SCP. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tSCPConnection dans la liste.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant. Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a
Scnario associ
Ce composant est troitement li aux composants tSCPConnection et tSCPRollback. Il est gnralement utilis avec un composant tSCPConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tSCPClose, consultez tMysqlConnection page 630..
1329
Composants Internet
tSCPConnection
tSCPConnection
Proprits du tSCPConnection
Le composant tSCPConnection ouvre une connexion SCP afin deffectuer une transaction. Le tSCPConnection permet douvrir une connexion SCP afin deffectuer des transferts scuriss de fichiers en une seule transaction. Host Port Username Authentication method Password Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP.
Ce composant est gnralement utilis comme sous-Job un seul composant. n/a
Scnarios associs
Pour un scnario associ, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1277. Pour un scnario associ utilisant un protocole diffrent, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1334
1330
Composants Internet
tSCPDelete
tSCPDelete
Proprits du tSCPDelete
Le composant tSCPDelete supprime les fichiers slectionns dun serveur distant par le biais dun protocole entirement crypt. Le tSCPDelete permet de supprimer un fichier dun serveur SCP donn. Host Port Username Authentication method Password Filelist Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP. Nom ou chemin daccs du fichier supprimer.
Utilisation
Ce composant est gnralement utilis comme sous-Job un seul composant mais il peut aussi tre utilis en association avec dautres composants. n/a
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1334. Pour un scnario associ utilisant un protocole diffrent, consultez le Scnario : Copier des fichiers sur un serveur FTP distant, page 1277.
1331
Composants Internet
tSCPFileExists
tSCPFileExists
Proprits du tSCPFileExists
Le composant tSCPFileExists vrifie si un fichier est prsent sur le serveur distant, par le biais dun protocole entirement crypt. Le tSCPFileExists permet de vrifier la prsence dun fichier sur le serveur SCP spcifi. Host Port Username Authentication method Password Remote directory Filename Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP. Chemindaccs au rpertoire du serveur distant. Nom du fichier chercher.
Utilisation
Limitation
Scnario associ
1332
Composants Internet
tSCPFileList
tSCPFileList
Proprits du tSCPFileList
Fonction
Le composant tSCPFileList fait une opration ditration sur les fichiers dun rpertoire du serveur distant, par le biais dun protocole entirement crypt. Le tSCPFileList permet de lister les fichiers dun serveur SCP spcifi. Host Port Username Authentication method Password Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP.
Command separator Le caractre utilis pour sparer les diffrentes commandes. Filelist Utilisation Nom ou chemin daccs au rpertoire contenant les fichiers lister.
Limitation
Scnario associ
1333
Composants Internet
tSCPGet
tSCPGet
Proprits du tSCPGet
Le composant tSCPGet transfre les fichiers slectionns par le biais dun protocole entirement crypt via une connexion SCP. Le tSCPGet permet de copier de fichiers du serveur SCP spcifi. Host Port Username Authentication method Password Local directory Overwrite or Append Filelist Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP. Chemin daccs du rpertoire de destination. Liste des options disponibles pour le transfert des fichiers. Nom ou chemin daccs du ou des fichier(s) copier.
Utilisation
Limitation
Scnario : Rcuprer des fichiers dun serveur SCP distant

Ce scnario Java cre un Job un seul composant qui rcupre le fichier slectionn dun serveur SCP distant. Cliquez et dposez le composant tSCPGet dans lditeur graphique. Dans lditeur graphique, slectionnez le tSCPGet et cliquez sur la vue Component pour paramtrer ses proprits de base.
1334
Composants Internet
tSCPGet
Dans le champ Host, renseignez ladresse IP du serveur SCP. Dans le champ Port ,renseignez le numro du port dcoute du serveur SCP. Dans les champs Username et Password, renseignez respectivement le login et le mot de passe de connexion au serveur SCP. Dans la liste Authentication method, slectionnez la mthode dauthentification approprie. Notez que les champs suivants changent en fonction de la mthode dauthentification slectionne. La mthode dauthentification Password est utilise dans ce scnario. Dans le champ Local directory, renseignez le chemin daccs au rpertoire dans lequel sera copi le fichier. Dans la liste Overwrite or Append, slectionnez laction effectuer. Dans la zone Filelist, cliquez sur le bouton [+] pour ajouter une ligne la liste Source et renseignez le chemin daccs au fichier sur le serveur SCP distant. Dans ce scnario, le fichier copier du serveur SCP distant sur le disque local sappelle backport.pl. Enregistrez le Job et appuyez sur F6 lexcuter. Le fichier du serveur distant est copi sur le disque local.
1335
Composants Internet
tSCPPut
tSCPPut
Proprits du tSCPPut
Le composant tSCPPut copie les fichiers slectionns sur un serveur SCP distant par le biais dun protocole entirement crypt. Le tSCPPut permet de copier les fichiers dans le rpertoire dun serveur SCP distant. Host Port Username Authentication method Password Remote directory Filelist Adresse IP dun serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP. Chemin daccs au rpertoire de destination. Nom ou chemin daccs au(x) fichier(s) copier.
Utilisation
Limitation
Scnario associ
1336
Composants Internet
tSCPRename
tSCPRename
Proprits du tSCPRename
Le composant tSCPRename renomme des fichiers sur un serveur SCP distant. Le tSCPRename permet de renommer un ou des fichier(s) sur le serveur SCP slectionn. Host Port Username Authentication method Password File to rename Rename to Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP. Nom ou chemin daccs au fichier renommer. Saisissez le nouveau nom du fichier.
Utilisation
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1334.
1337
Composants Internet
tSCPTruncate
tSCPTruncate
Proprits du tSCPRename
Le composant tSCPTruncate supprime toutes les donnes dun fichier via une connexion SCP. Le tSCPTruncate permet de supprimer les donnes dun ou plusieurs fichier(s) dun serveur SCP. Host Port Username Authentication method Password Remote directory Filelist Adresse IP du serveur SCP. Numro du port dcoute du serveur SCP. Login de connexion au serveur SCP. Mthode dauthentification au serveur SCP. Mot de passe de connexion au serveur SCP. Chemin daccs au fichier de destination. Nom ou chemin daccs au(x) fichier(s) vider.
Utilisation
Ce composant est gnralement utilis en tant que sous-Job un seul composant mais il peut aussi tre utilis en association avec dautres composants. n/a
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Rcuprer des fichiers dun serveur SCP distant, page 1334.
1338
Composants Internet
tSendMail
tSendMail
Proprits du tSendMail
Le composant tSendMail envoie des messages et toute autre pice jointe aux destinataires spcifis. Le tSendMail permet de prvenir des destinataires dun tat particulier dun Job ou de possibles erreurs. To From Show senders name? Cc Bcc Subject Message Adresse e-mail du destinataire principal. Adresse e-mail du serveur denvoi. Cochez cette case pour dfinir le nom dexpditeur afficher dans les messages. Sendername : renseignez le nom de lexpditeur. Adresse e-mail des destinataires en copie. Adresse e-mail des destinataires en copie cache. Objet du mail. Contenu du message. Appuyez sur Ctrl+Espace pour afficher la liste des variables disponibles.
Die if the attachment Dcochez cette case pour que les messages soient file doesnt exist envoys mme si aucune pice jointe nest attache. Attachment Cliquez sur le bouton [+] pour ajouter des lignes de filtre : File : masque du fichier ou chemin daccs au fichier joindre le-mail. Cliquez sur le bouton [+] pour ajouter des lignes de filtre : Key : saisissez la cl de tout en-tte diffrent de len-tte standard. Value : saisissez la valeur correspondante la cl. Adresse IP du serveur SMTP utilis pour lenvoi de-mails. Cochez cette case pour authentifier le serveur auprs du client via un protocole scuris SSL. Cochez cette case pour authentifier le serveur auprs du client via un protocole scuris STARTTLS. Slectionnez dans la liste droulante le niveau de priorit de votre message.
Other Headers
SMTP Host et Port SSL Support STARTTLS Support
Importance
1339
Composants Internet
tSendMail
Need authentication?
Cochez la case dauthentification et renseignez le nom de lutilisateur (username) et son mot de passe (password), si cela est ncessaire pour accder au service. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et les lignes contenant les erreurs seront ignores.
Die on error
Advanced settings
MIME subtype from Slectionnez dans la liste droulante la forme the text MIME type attribuer au texte du message. Encoding Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes. Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.
Ce component est gnralement utilis en tant que sous-Job mais peut aussi tre utilis comme composant de sortie ou de fin de Job. Il peut tre connect aux autres composants via des liens Row ou Iterate. Notez que lenvoi de-mail requiert deux modules (Perl) diffrents suivant quil contient une pice jointe ou non.
Limitation
Scnario : Envoyer un e-mail lors dune erreur

Ce scnario est un Job compos de trois composants permettant denvoyer un e-mail des destinataires spcifiques lorsquune erreur se produit.
A partir de la Palette, cliquez-dposez les composants suivants dans lespace de modlisation : tFileInputDelimited, tFileOutputXML et tSendMail. Cliquez-droit sur le composant tFileInputDelimited et reliez-le au composant tFileOutputXML laide dun lien de type Row > Main. Cliquez-droit sur le composant tFileInputDelimited et reliez-le au composant tSendMail laide dun lien de type Trigger > OnSubjobError. Double-cliquez sur le composant tFileInputDelimited pour afficher longlet Basic settings du composant et configurer ses paramtres de base.
1340
Composants Internet
tSendMail
A partir de la liste Property type, slectionnez : -Repository si vous avez dj stock les mtadonnes de votre fichier dentre dans le Repository, les champs suivants sont alors renseigns automatiquement avec les informations stockes, ou -Built-in si aucune mtadonne nest stocke pour votre fichier dentre ; vous devez alors renseigner manuellement les champs suivants. Dans cet exemple, cest le mode Built-in qui est utilis. Dans le champ File Name, renseignez le chemin daccs ou cliquez sur le bouton [...] pour parcourir vos dossiers jusquau fichier traiter. Ce champ est obligatoire. Dans cet exemple, le fichier traiter est customer_mail.csv. Dfinissez le sparateur de lignes dans le champ Row separator afin didentifier la fin dune ligne. Puis dfinissez le sparateur de champs dans Field separator pour dlimiter les champs composant une ligne. Les sparateurs utiliss dans ce scnario sont des sparateurs de champs et de lignes classiques de fichier CSV. Dans ce scnario, len-tte (Header), le pied de page (Footer) et la limite de lignes lues (Limit) nont pas besoin dtre dfinis. Slectionnez loption Built-in partir de la liste droulante Schema et renseignez manuellement les informations concernant le fichier dlimit dans les champs correspondants. Cliquez sur le bouton [...] ct du champ Edit schema pour afficher la bote de dialogue permettant de dfinir la structure des donnes. Dans ce scnario, le schma comporte quatre colonnes : Id, Name, Address et IdState. Cliquez sur le bouton [+] pour ajouter autant de lignes que ncessaire la structure des donnes. Dans cet exemple, il ny a quune seule colonne dans le schma : xmlStr. Cliquez sur OK pour valider vos changements et fermer la bote de dialogue.
1341
Composants Internet
tSendMail
Si vous avez pralablement stock votre schma dans le rpertoire Metadata sous File delimited, slectionnez loption Repository dans la liste droulante Schema puis cliquez sur le bouton [...] ct du champ pour afficher la bote de dialogue [Repository Content] paritr de laquelle vous pouvez slectionner un schma pertinent. Cliquez sur Ok pour fermer la bote de dialogue et remplir les champs automatiquement avec les mtadonnes contenues dans le schma. Pour plus dinformations sur le stockage des schmas de mtadonnes dans le Repository, consultez les sections Configurer un schma File Delimited et Dposer des composants partir du rpertoire Metadata du Guide Utilisateur de Talend Open Studio.
Voir galement : Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Assurez-vous que la case Skip empty rows est coche afin dignorer les lignes vierges. Double-cliquez sur le composant tFileOutputXML pour afficher longlet Basic settings du composant et configurer ses paramtres de base.
Cliquez sur le bouton [...] ct du champ File Name pour slectionner le rpertoire de destination du fichier et saisissez le nom du fichier. Dans ce scnario, appelez le fichier customer_data.xml. Dans le champ Row tag, saisissez entre guillemets le nom que vous souhaitez donner la balise contenant les donnes. Cliquez sur Edit schema et assurez-vous que le schma est rcupr partir du schma dentre. Si ncessaire, cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Double-cliquez sur le composant tSendMail pour afficher longlet Basic settings du composant et configurer ses paramtres de base.
1342
Composants Internet
tSendMail
Saisissez les adresses e-mail des destinataires dans le champ To et les champs Cc et Bcc selon vos prfrences, ainsi que celle de lexpditeur dans le champ From. Cochez la case Show senders name? puis renseignez le nom de lexpditeur dans le champ Sendername pour que votre message ait une meilleure visibilit auprs de vos destinataires. Renseignez lobjet du message dans le champ Subject. Saisissez dans le champ Message le message contenant le code derreur produit laide de la variable globale correspondante. Accdez la liste des variables en appuyant sur Ctrl+Espace. Ajoutez des pices jointes et des informations sur les en-ttes, si ncessaire, dans les champs respectifs Attachments et Other headers. Saisissez les informations SMTP dans les champs SMTP host et SMTP port. Enregistrez votre Job puis appuyez sur F6 pour lexcuter. Dans ce scnario, le fichier contenant les donnes transfrer vers une sortie XML ne peut tre trouv. Le composant tSendmail sexcute lorsque cette erreur est rencontre et envoie un mail de notification au destinataire spcifi.
Composants Internet
tSetKeystore
tSetKeystore
Proprits du tSetKeystore
Le composant tSetKeystore soumet des donnes dauthentification dun TrustStore avec ou sans Keystore pour valider la connexion SSL. Ce composant vous permet de dfinir le type des donnes dauthentification entre PKCS 12 et JKS. TrustStore type TrustStore file Slectionnez le type of the TrustStore to be used. It may be PKCS 12 or JKS. Saisissez le chemin daccs et le nom du fichier TrustStore, ou parcourez votre rpertoire jusquau TrustStore contenant la liste des certificats approuvs par le client. Saisissez le mot de passe utilis pour vrifier lintgrit des donnes TrustStore. Cochez cette case pour valider les donnes keystore. Vous devez ensuite complter trois champs : - KeyStore type : slectionnez le type de keystore utiliser. Il peut tre PKCS 12 ou JKS. - KeyStore file : saisissez le chemin daccs et le nom du fichier Keystore, ou parcourez votre rpertoire jusquau fichier contenant les donnes keystore. - KeyStore password : saisissez le mot de passe keystore.
TrustStore password Need Client authentication
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant. Ce composant est utilis en standalone. Liens de sortie (dun composant un autre) : Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Trigger : Run if, On Subjob Ok, On Component Ok, On Component Error. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a.
1344
Composants Internet
tSetKeystore
Scnario : Extraire des informations client dun fichier WSDL priv

Ce scnario dcrit un Job comprenant trois composants, qui se connecte un fichier WSDL priv, pour extraire des informations client. Le fichier WSDL utilis dans ce Job accde au service Web correspondant via le protocole SSL. Le code correspondant dans le fichier est le suivant : <wsdl:port name="CustomerServiceHttpSoap11Endpoint" binding="ns:CustomerServiceSoap11Binding"> <soap:address location="https://192.168.0.22:8443/axis2/services/CustomerServic e.CustomerServiceHttpSoap11Endpoint/"/> </wsdl:port> Saisissez le code suivant dans le fichier server.xml de Tomcat : <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="true" sslProtocol="TLS" keystoreFile="D:/server.keystore" keystorePass="password" keystoreType="JKS" truststoreFile="D:/server.p12" truststorePass="password" truststoreType="PKCS12" /> Vous avez besoin de fichiers Keystore pour vous connecter ce fichier WSDL. Pour reproduire ce Job, procdez comme suit : Dposez les composants suivants de la Palette dans lespace de modlisation graphique : tSetKeystore, tWebService, et tLogRow.
Cliquez-droit sur le composant tSetKeystore pour ouvrir son menu contextuel. Dans ce menu, slectionnez Trigger > On Subjob Ok afin de relier ce composant au tWebService. Cliquez-droit sur le tWebService pour ouvrir son menu contextuel. Dans ce menu, slectionnez Row > Main pour connecter ce composant au tLogRow. Double-cliquez sur le tSetKeystore pour ouvrir sa vue Basic settings et dfinir ses proprits.
1345
Composants Internet
tSetKeystore
Dans la liste TrustStore type, slectionnez PKCS12. Dans le champ TrustStore file, parcourez votre rpertoire jusquau fichier TrustStore. Ici, le fichier est server.p12. Dans le champ TrustStore password, saisissez le mot de passe pour ce fichier TrustStore. Dans cet exemple, le mot de passe est password. Cochez la case Need Client authentication afin dactiver les champs de configuration Keystore. Dans la liste KeyStore type, slectionnez JKS. Dans le champ KeyStore file, parcourez votre rpertoire jusquau fichier Keystore correspondant. Ici, le fichier est server.keystore. Double-cliquez sur le composant tWebService pour ouvrir lditeur du composant, ou slectionnez le composant dans lespace de modlisation graphique et dans sa vue Basic settings, cliquez sur le bouton [...] ct du champ Service configuration.
1346
Composants Internet
tSetKeystore
Dans le champ WSDL, parcourez votre rpertoire jusquau fichier WSDL priv utiliser. Dans cet exemple, ce fichier est CustomerService.wsdl. Cliquez sur le bouton Refresh ct du champ WSDL afin de rcuprer la description WSDL et lafficher dans les champs qui suivent. Dans la liste Port Name, slectionnez le port que vous souhaitez utiliser, CustomerServiceHttpSoap11Endpoint dans cet exemple. Dans la liste Operation, slectionnez le service que vous souhaitez utiliser. Dans cet exemple, le service slectionn est getCustomer(parameters):Customer. Cliquez sur Next pour ouvrir une nouvelle vue dans lditeur.
Dans le panneau de droite de la vue Input mapping, le paramtre dentre du service saffiche automatiquement. Cependant, vous pouvez ajouter dautres paramtres si vous slectionnez [+] parameters et que vous cliquez sur le bouton [+] en haut, afin dafficher la bote de dialogue [Parameter Tree] dans laquelle vous pouvez slectionner nimporte lequel des paramtres lists. Le service Web de cet exemple na quun seul paramtre dentre, ID. Dans la colonne Expression de la ligne parameters.ID, saisissez entre guillemets lID du client qui vous intresse. Dans cet exemple, lID est A00001. Cliquez sur Next pour ouvrir une nouvelle vue dans lditeur.
1347
Composants Internet
tSetKeystore
Dans la liste Element gauche de la vue saffiche automatiquement le paramtre de sortie du service Web. Cependant, vous pouvez ajouter dautres paramtres si vous slectionnez [+] parameters et que vous cliquez sur le bouton [+] en haut afin dafficher la bote de dialogue [Parameter Tree] dans laquelle vous pouvez slectionner nimporte lequel des paramtres affichs. Le service Web dans cet exemple contient quatre paramtres de sortie : return.address, return.email, return.name et return.phone. Vous devez crer une connexion entre le paramtre de sortie du service Web dfini et le schma du composant de sortie. Pour ce faire : Dans le panneau droite de la vue, cliquez sur le bouton [...] ct du champ Edit Schema afin douvrir une bote de dialogue dans laquelle vous pouvez dfinir le schma de sortie.
Dans lditeur de schma, cliquez sur le bouton [+] pour ajouter quatre colonnes au schma de sortie. Cliquez dans chaque colonne et saisissez les nouveaux noms : Name, Phone, Email et Address dans cet exemple. Cela vous permettra de rcuprer les informations client qui vous intressent.
1348
Composants Internet
tSetKeystore
Cliquez sur OK pour valider les modifications et fermer la bote de dialogue du schma. Dans la liste Element droite de lditeur, glissez chaque paramtre dans le champ correspondant la colonne que vous avez dfinie dans lditeur de schma.
Sil est disponible, vous pouvez utiliser le bouton Auto map!, situ en bas gauche de linterface, afin deffectuer lopration de mapping automatiquement.
Cliquez sur OK pour valider vos modifications et femer lditeur. Dans lespace de modlisation graphique, double-cliquez sur le composant tLogRow afin douvrir sa vue Basic settings et dfinir ses proprits. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Sauvegardez votre Job et appuyez sur F6 pour lexcuter. Les informations du client dont lID est A00001 sont retournes et affiches dans la console de Talend Open Studio.
1349
Composants Internet
tSocketInput
tSocketInput
Proprits du tSocketInput
Fonction Objectif JAVA Basic settings
Le composant tSocketInput ouvre un port de socket et permet dcouter les donnes envoyes. Le tSocketInput est un composant dcoute, permettant de transmettre des donnes via un port dfini. Host name Port Timeout Uncompress Die on error Nom ou adresse IP du serveur Hte. Port dcoute ouvrir. Nombre de secondes avant fermeture du socket du port dcoute. Cochez cette case pour extraire les donnes si ncessaire. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \nsous Unix) utilise pour sparer les lignes. Caractre de la ligne viter. Caractres utiliss pour entourer le texte. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Field separator Row separator Escape Char Text enclosure Schema et Edit schema
1350
Composants Internet
tSocketInput
Encoding
Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.
Utilisation
Ce composant ouvre un point daccs au poste de travail ou au serveur. Ce composant est un composant de dbut de Job et sarrte uniquement aprs expiration. n/a
Limitation
Les proprits Perl tant lgrement diffrentes des proprits Java, elles sont dcrites dans le tableau suivant :
PERL basic settings Schema type et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Host name Port Field separator End of Line separator End of data Opening message /Message /Acknowledge message /Closing message Utilisation Nom ou adresse IP du serveur Hte Port dcoute ouvrir. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) utilise pour sparer les lignes. Caractre, chane ou expression rgulire indiquant la fin de la section de donnes. Description du message, si ncessaire.
Ce composant ouvre un point daccs un poste de travail ou un serveur. Ce composant dbute un Job et ne sarrte quaprs avoir reu un message de fermeture.
1351
Composants Internet
tSocketInput
Scnario : Transfrer des donnes vers un port dcoute (Java)

Le scnario suivant dcrit un double Job dont le but est de transfrer des donnes via un port dcoute. Le composant Socket peut aussi permettre de contrler la communication entre les serveurs ne pouvant pas communiquer directement entre eux.
Crez deux Jobs : le premier (SocketInput) ouvre un port dcoute et attend que les donnes soient envoyes. Le deuxime (SocketOutput) transmet des donnes dlimits dun fichier vers le numro de port correspondant au port dcoute. Dans le premier Job, cliquez et dposez les composants suivants : tSocketInput et tLogRow. Dans le deuxime Job, cliquez et dposez les composants suivants : tFileInputDelimited et tSocketOutput. Commencez par configurer les paramtres du deuxime Job. Slectionnez tFileInputDelimited et dans longlet Basic Settings de la vue Component, configurez les paramtres daccs au fichier dentre.
Dans le champ File Name, renseignez le chemin daccs au fichier. Renseignez les sparateurs de lignes et de champs respectivement dans les champs Row et Field separators, ainsi que len-tte dans le champ Header.
1352
Composants Internet
tSocketInput
Dcrivez le schma des donnes passer au composant tSocketOutput. Slectionnez le composant tSocketOutput et configurez les paramtres de longlet Basic Settings de la vue Component.
Dans le champ Host, renseignez ladresse IP et dans le champ Port, renseignez le numro du port vers lequel les donnes seront transfres. Dans le champ Retry, dfinissez le nombre dessais effectuer et dans le champ Timeout renseignez la dure (en seconde) avant que le Job ne sarrte automatiquement. Configurez le reste des options si ncessaire. Le schma devrait se propager du composant prcdent. Maintenant, configurez les paramtres du premier Job (SocketInput) contenant le composant tSocketInput.
Dans le champ Host, renseignez ladresse IP et dans le champ Port, renseignez le numro du port dcoute vers lequel les donnes sont transfres. Dans le champ Timeout, dfinissez la dure (en secondes) avant que le Job ne sarrte automatiquement.
1353
Composants Internet
tSocketInput
Configurez le reste des options si ncessaire. Modifiez le schma afin quil corresponde en tout point ou en partie au schma du deuxime Job. Laissez les proprits par dfaut du composant tLogRow. Excutez le Job SocketInput en premier, afin douvrir le port dcoute et de le prparer recevoir les donnes. Avant que le Job ne sarrte, lancez lautre Job (SocketOutput) afin de transmettre les donnes. Le rsultat saffiche dans la vue Run, ainsi que les informations douverture du socket.
1354
Composants Internet
tSocketOutput
tSocketOutput
Proprits du tSocketOutput
Le composant tSocketOutput crit des donnes sur un port dcoute. Le tSocketOutput transfert des donnes dun flux dentre vers le port dcoute du socket. Host Port Compress Retry times Timeout Field separator Row separator Escape Char Text enclosure Schema et Edit schema Nom ou adresse IP du serveur Hte. Port dcoute ouvrir Cochez cette case pour archiver les donnes si ncessaire. Nombre dessais avant que le Job ne soit mis en chec. Nombre de secondes avant fermeture du port dcoute. Caractre, chane ou expression rgulire sparant les champs. Chane (ex : \n sous Unix) sparant les lignes. Caractre de la ligne viter. Caractres utiliss pour entourer le texte. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Encoding Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.
Utilisation
Ce composant ouvre un point daccs au poste de travail ou au serveur. Ce composant est un composant de dbut de Job et sarrte uniquement aprs expiration.
1355
Composants Internet
tSocketOutput
Limitation
n/a
Scnario associ
Pour un exemple dutilisation du tSocketOutput, consultez Scnario : Transfrer des donnes vers un port dcoute (Java) page 1352.
1356
Composants Internet
tSOAP
tSOAP
Proprits du tSOAP
Fonction
Le composant tSOAP envoie le message SOAP dfini avec les paramtres donns au service Web invoqu et retourne la valeur comme dfinie, partir des paramtres donns. Ce composant appelle une mthode via un service Web afin de rcuprer les valeurs des paramtres dfiniese dans lditeur du composant. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Ce composant utilise toujours un schma local (built-in) en lecture seule qui contient trois colonnes : - Header : stocke len-tte du message SOAP de la rponse donne ct serveur. - Body : stocke le corps du message SOAP de la rponse donne ct serveur. - Fault : stocke les informations derreur lorsquune erreur survient pendant le traitement du message SOAP. Cliquez sur Edit Schema pour visualiser le schma. Modifier le schma peut engendrer une perte de la structure du schma et donc un chec du composant. Use NTLM Cochez cette case si vous utilisez un protocole dauthentification NTLM. Domain : Nom de domaine du client. Cochez la case dauthentification et renseignez le nom de lutilisateur dans le champ Username et son mot de passe dans le champ Password, si cela est ncessaire pour accder au service. Cochez cette case si vous vous connectez derrire un proxy et renseignez les informations correspondantes. Cochez cette case pour authentifier le serveur auprs du client via un protocole SSL et renseignez les champs correspondants. TrustStore file : saisissez le chemin daccs et le nom du fichier TrustStore contenant la liste des certificats approuvs par le client. TrustStore password : saisissez le mot de passe utilis pour vrifier lintgrit des donnes TrustStore. Saisissez lURL du serveur Web invoqu.
Need authentication
Use http proxy
Trust server with SSL
ENDPOINT
1357
Composants Internet
tSOAP
SOAP action
Saisissez lURL de len-tte HTTP SOAPAction utiliser pour identifier le but de la requte HTTP SOAP. Slectionnez la version du systme SOAP que vous utilisez.
SOAP version
Lenveloppe SOAP requise varie selon les versions. SOAP message Saisissez le message SOAP envoyer au service Web invoqu. Les variables globales et de contexte peuvent tre utilises lorsque vous crivez un message SOAP. Pour plus dinformations concernant les variables de contexte, consultez Variables, page 256 du Guide Utilisateur Talend Open Studio. Dfinissez (ou parcourez votre rpertoire jusqu) un dossier temporaire configur o stocker les fichiers WSDL.
Advanced settings
Temporary folder (for wsdl2java)
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant. Utilisation Connexions Ce composant peut tre utilis en tant que composant dentre ou intermdiaire. Liens de sortie (dun composant un autre) : Row : Main, Iterate. Trigger : Run if, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Main, Iterate Trigger : Run if, On Component Ok, On Component Error. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio. Limitation N/A
Scnario : Extraire des informations mto en utilisant un Service Web

Ce scnario Java dcrit un Job deux composants utilisant un Service Web pour rcuprer les informations concernant la mto dune ville amricaine. Le service Web utiliser est ; http://www.deeptraining.com/webservices/weather.asmx. Dposez les composants suivants de la Palette dans lespace de modlisation graphique : tSOAP et tLogRow.
1358
Composants Internet
tSOAP
Cliquez-droit sur le composant tSOAP afin douvrir le menu contextuel. Slectionnez Row > Main. Cliquez sur le tLogRow pour relier les composants laide dun lien Main Row. Double-cliquez sur le tSOAP afin douvrir sa vue Basic settings et dfinir ses proprits.
Dans le champ ENDPOINT, saisissez ou collez lURL du Service Web utiliser, entre guillemets : http://www.deeptraining.com/webservices/weather.asmx. Dans le champ SOAP Action, saisissez ou collez lURL de len-tte HTTP SOAPAction permettant de dterminer que vous souhaitez rcuprer les informations concernant la mto : http://litwinconsulting.com/webservices/GetWeather.
Vous pouvez voir cette adresse en regardant le WSDL du Service Web que vous appelez. Pour le Service Web de cet exemple, dans votre navigateur, saiaissez ?wsdl la fin de lURL du Service Web utilis dans le champ ENDPOINT, ouvrez la page Web correspondante, puis regardez laction SOAPAction dfinie sous le noeud Operation : <wsdl:operation name="GetWeather"> <soap:operation soapAction="http://litwinconsulting.com/webservices/GetWeathe r" style="document"/>
1359
Composants Internet
tSOAP
Dans le champ SOAP version, slectionnez la version du systme SOAP utilis. Dans ce scnario, la version est SOAP 1.1. Dans le champ SOAP message, saisissez le message, au format XML, utilis pour rcuprer les informations du Service Web invoqu. Dans cet exemple, rcuprez les informations mto de Chicago, saisissez donc : "<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:web=\"http://litwinconsulting.com/webservices/\"> <soapenv:Header/> <soapenv:Body> <web:GetWeather> <web:City>Chicago</web:City> </web:GetWeather> </soapenv:Body> </soapenv:Envelope>" Sauvegardez votre Job et appuyez sur F6 pour lexcuter. La mto de Chicago est rcupre et affiche dans la console de la vue Run.
1360
Composants Internet
tWebServiceInput
tWebServiceInput
Proprits du tWebServiceInput
Fonction Objectif
Ce composant appelle la mthode du service Web invoqu et retourne la classe dfinie en fonction des paramtres donns. Le tWebServiceInput invoque une mthode via un service Web dont lobjectif est celui dcrit dans les proprits. Pour traiter des donnes complexes hirarchiques, vous devez utiliser les fonctions avances du tWebServiceInput en codant directement du Java dans le champ Code de la vue Advanced settings. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de cration de schma WSDL et enregistrer les paramtres de connexion WSDL que vous avez dfinis dans la vue Basic settings du composant dans le Repository. Pour plus dinformations sur la configuration et le stockage des paramtres de connexion WSDL, consultez la section Configurer un schma Web Service du Guide Utilisateur de Talend Open Studio. Perl uniquement Encoding Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.
Basic settings
Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
1361
Composants Internet
tWebServiceInput
Perl uniquement
End Point URI WSDL
Identificateur de ressources du service Web. Description des bindings et de la configuration du service Web.
Java uniquement
Need authentication / Cochez cette case dauthentification et : Username et Password - Saisissez un identifiant, ainsi quun mot de passe, dans les champs correspondants, si ncessaire pour accder au service. Sinon, - Cochez la case Windows authentication et saisissez le nom de domaine Windows dans le champ correspondant si cela est ncessaire pour accder au service. Use http proxy Cochez cette case si vous vous connectez derrire un proxy et renseignez les informations correspondantes. Cochez cette case pour authentifier le serveur auprs du client via un protocole SSL et renseignez les champs correspondants. TrustStore file : saisissez le chemin daccs et le nom du fichier TrustStore contenant la liste des certificats approuvs par le client. TrustStore password : saisissez le mot de passe utilis pour vrifier lintgrit des donnes TrustStore. Saisissez en secondes la dure de connexion au service Web. Saisissez le nom exact de la mthode invoquer. Le nom de la mthode DOIT correspondre la mthode dcrite dans le service Web. Le nom de la mthode est sensible la casse. Saisissez les paramtres attendus et les valeurs retourner. Assurez-vous que les paramtres saisis correspondent parfaitement aux noms et la casse des paramtres dcrits dans la mthode. Cochez cette case pour afficher les champs suivants permettant dutiliser les fonctions avances du tWebServiceInput : WSDL2Java : cliquez sur le bouton [...] pour gnrer des routines contenant les codes Java ncessaires la connexion et linterrogation du service Web. Code : saisissez le code permettant de se connecter et dinterroger le service Web en vous basant sur les deux modles proposs en utilisant les routines gnres automatiquement. Match Brackets : slectionnez le nombre daccolades utiliser pour fermer la boucle for en fonction du nombre daccolades ouvertes. Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.
Java uniquement
Java uniquement
Trust server with SSL
Java uniquement
Time out (second) Method Name
Parameters
Advanced settings
Advanced Use Java uniquement
1362
Composants Internet
tWebServiceInput
Ce component est gnralement utilis comme composant de dbut. Il requiert un composant de sortie. n/a
Scnario 1 : Extraire des images laide dun Webservice

Ce scnario dcrit un Job constitu de deux composants dont le but est dutiliser une mthode de service Web et dafficher le rsultat en sortie dans une vue standard. La mthode rcupre une adresse URL complte sous forme de chane en entre et retourne une liste dimages provenant dune page Web donne.
Cliquez et dposez les composants tWebServiceInput et tLogRow. Dans la vue Component du composant tWebServiceInput, configurez les spcifications WSDL : WSDL et End Point URI lorsque cela est ncessaire. Si le service Web invoqu requiert des informations dauthentification, cochez la case Need authentication? et renseignez ces informations.
Si vous vous connectez derrire un proxy, cochez la case Use http proxy et renseignez les champs concernant lhte, lutilisateur, le port et le mot de passe. Dans le champ Method Name, saisissez le nom de la mthode tel que dfini dans la description du service Web. Le nom et la casse de la mthode saisie doivent correspondre parfaitement la mthode du service Web demand.
1363
Composants Internet
tWebServiceInput
Dans la zone Parameters, cliquez sur le bouton [+] pour ajouter une ligne au tableau, puis saisissez le nom exact des paramtres tel quattendus par la mthode. Dans la colonne Value, saisissez ladresse URL du site Web partir duquel les images seront extraites. Connectez le composant tWebServiceInput au composant de sortie standard, tLogRow. Appuyez sur F6 pour excuter le Job.
Toutes les images extraites du site Web spcifi sont retournes dans la vue Run, sous la forme dune liste dadresses URL.
Scnario 2 : Lire des donnes publies dans un service Web, en utilisant les fonctions avances du tWebServiceInput (Java)
Ce scnario dcrit un Job constitu de deux composants dont le but est de rcuprer une liste de fonds publie sur un service Web financier (distribu par www.xignite.com) et dafficher le rsultat en sortie dans la vue standard (la vue Run). Ce scnario est destin des utilisateurs avancs ayant des notions de Java. En effet, lobjectif de ce Job tant de rcuprer des donnes complexes hirarchiques, il est ncessaire de coder en Java les fonctions dont vous avez besoin pour rcuprer ces donnes.
1364
Composants Internet
tWebServiceInput
Cliquez et dposez le composant tWebServiceInput de la famille Internet et le composant tLogRow de la famille Logs & Errors dans lespace de modlisation. Reliez les composants laide dune connexion de type Row Main. Double-cliquez sur le tWebServiceInput pour afficher la vue Component et paramtrer ses proprits :
Dans longlet Basic settings : Dans la liste Property Type, slectionnez loption Built-in et renseignez manuellement les champs suivants. Dans la liste Schema Type, slectionnez Built-in et cliquez sur le bouton [...] pour configurer manuellement le schma comme dans la figure ci-dessous :
1365
Composants Internet
tWebServiceInput
Cliquez sur OK pour valider le schma et fermer la fentre. Une bote de dialogue souvre et vous demande si vous souhaitez propager les modifications. Cliquez sur Yes (Oui). Dans le champ WSDL, saisissez ladresse du WSDL auquel vous connecter. Dans le champ Time out, saisissez en secondes la dure de la connexion au service Web. Cliquez sur longlet Advanced settings pour renseigner les fonctions avances du composant tWebServiceInput :
Cochez la case Advanced Use pour afficher les champs de configuration avance. Cliquez sur le bouton [...] situ ct du champ WSDL2Java pour gnrer automatiquement des routines partir du WSDL du service Web.
1366
Composants Internet
tWebServiceInput
Ces routines apparaissent sous le noeud Code > Routines du Repository, et peuvent tre utilises dans le code pour construire les fonctions ncessaires la rcupration des donnes hirarchiques du service Web. Saisissez les fonctions adquates dans le champ Code. Par dfaut, deux exemples de code sont fournis dans le champ Code : le premier sert retourner une donne et le deuxime en retourner plusieurs. Pour ce scnario, lobjectif est de retourner plusieurs donnes. Ainsi, supprimez le premier exemple de code et utilisez le deuxime exemple de code pour construire les fonctions. Dans le deuxime exemple, remplacez les morceaux de code exemple par le code correspondant gnr dans les routines partir du WDSL. Remplacez TalendJob_PortType par le nom de la routine terminant par _Port_Type : XigniteFundHoldingsSoap_PortType. Remplacez les diffrentes instances de TalendJob par un nom plus parlant tel que le nom de la mthode utilise : fundHolding. Remplacez TalendJobServiceLocator par le nom de la routine terminant par Locator : XigniteFundHoldingsLocator. Remplacez les deux instances de TalendJobSoapBindingStub par le nom de la routine terminant par BindingStub : XigniteFundHoldingsSoap_BindingStub. Dans les parenthses correspondant aux codes stub.setUsername et stub.setPassword, saisissez respectivement votre identifiant et votre mot de passe entre guillemets. Dans un souci de confidentialit ou de maintenance, vous pouvez mettre votre identifiant et votre mot de passe dans des variables de contexte.
1367
Composants Internet
tWebServiceInput
La liste des fonds fournis par le service Web de Xignite sont identifis laide de symboles (Symbol), qui sont de type String (chane de caractres). Dans cet exemple, lobjectif est de rcuprer la liste des fonds dont la premire lettre du symbole est comprise entre I et J. Pour cela, dfinissez les arguments utiliser : string startSymbol=I et String endSymbol=J. Puis saisissez le code permettant de crer le tableau de rsultat rcuprant la liste des fonds (listFunds) de participation (fundholdings) en utilisant les arguments dfinis : routines.Fund[] result = fundHoldings.listFunds(startSymbol, endSymbol); Effectuez une boucle sur la liste des fonds pour rcuprer les fonds compris entre I et J : for(int i = 0; i < result.length; i++) { Puis dfinissez les sorties retourner, par exemple : rcuprez les donnes CIK du schma Security avec le code getSecurity().getCIK() et transmettez-les au champ CIK du schma de sortie. Le code obtenu pour faire fonctionner le service Web doit correspondre au code suivant : routines.XigniteFundHoldingsSoap_PortType fundHoldings = new routines.XigniteFundHoldingsLocator().getXigniteFundHoldingsSoap( ); routines.XigniteFundHoldingsSoap_BindingStub stub = (routines.XigniteFundHoldingsSoap_BindingStub)fundHoldings; stub.setUsername(identifiant); stub.setPassword(mot de passe); String startSymbol="I"; String endSymbol="J"; routines.Fund[] result = fundHoldings.listFunds(startSymbol, endSymbol); for(int i = 0; i < result.length; i++) { output_row.CIK = (result[i]).getSecurity().getCIK(); output_row.cusip = (result[i]).getSecurity().getCusip(); output_row.symbol = (result[i]).getSecurity().getSymbol(); output_row.ISIN = (result[i]).getSecurity().getISIN(); output_row.valoren = (result[i]).getSecurity().getValoren(); output_row.name = (result[i]).getSecurity().getName(); output_row.market = (result[i]).getSecurity().getMarket(); output_row.category = (result[i]).getSecurity().getCategoryOrIndustry(); output_row.asOfDate = (result[i]).getAsOfDate();
Les sorties dfinies dans le code Java output_row.sortie doivent correspondre exactement aux noms des colonnes dfinis dans le schma du composant. En effet, la casse doit tre respecte pour que les donnes soient rcupres.
1368
Composants Internet
tWebServiceInput
Dans le champ Match Brackets, slectionnez le nombre daccolades utiliser pour fermer la boucle for en fonction du nombre daccolades ouvertes. Pour ce scnario, slectionnez une seule accolade puisquune seule accolade a t ouverte dans le code. Double-cliquez sur le composant tLogRow pour afficher la vue Component et paramtrer ses proprits. Cliquez sur le bouton [...] situ ct du champ Edit Schema pour vrifier que le schma du composant prcdent a bien t propag au composant de sortie. Sinon, cliquez sur le bouton Sync columns pour rcuprer le schma. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Les fonds compris entre I et J sont retourns et affichs dans la console de Talend Open Studio.
1369
Composants Internet
tXMLRPCInput
tXMLRPCInput
Proprits du tXMLRPCInput
Ce composant appelle la mthode du service RPC invoqu et retourne la classe dfinie en fonction des paramtres donns. Le composant tXMLRPCInput invoque une mthode via un service Web dont lobjectif est celui dcrit dans les proprits. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Dans le contexte du RPC, le schma correspond aux paramtres de sortie. Si deux paramtres doivent tre retourns, alors le schma comportera deux colonnes. Adresse URL du service RPC accder Cochez la case dauthentification et renseignez le nom de lutilisateur (username) et son mot de passe (password), si cela est ncessaire pour accder au service. Saisissez le nom exact de la mthode invoquer. Le nom de la mthode DOIT correspondre parfaitement la mthode dcrite dans le service RPC. Le nom de la mthode est sensible la casse. Slectionnez le type de donnes retourner par la mthode. Assurez-vous quil correspond parfaitement celui dfini dans la mthode. Saisissez les paramtres attendus en entre par la mthode.
Server URL Need authentication / Username et Password Method Name
Return class
Parameters Utilisation Limitation
Ce composant est gnralement utilis comme composant de dbut. Il ncessite un composant de sortie. n/a
Scnario : Chercher le nom dun Etat via une mthode XMLRPC

Ce scnario dcrit un Job deux composants utilisant une mthode RPC et affichant le rsultat dans la console.
1370
Composants Internet
tXMLRPCInput
Cliquez et dposez les composants tXMLRPCInput et tLogRow. Dans longlet Basic settings, paramtrez les proprits du composant tXMLRPCInput.
Dans la liste droulante Schema type, slectionnez loption Built-in. Configurez un schma contenant une unique colonne puisque seul un paramtre est attendu en sortie : StateName.
Dans le champ Server url, renseignez ladresse URL du serveur. Pour cet exemple, utilisez : http://phpxmlrpc.sourceforge.net/server.php Aucune information dauthentification nest ncessaire pour cet exemple. Dans le champ Method, renseignez la mhode appeler, ici : examples.getStateName Pour cet exemple, la classe retourne nest pas obligatoire. Ainsi, dans le champ return class, laissez les paramtres par dfaut. Puis, dans le tableau Parameters, configurez les paramtres ncessaires la mthode appele. La colonne Name nest pas utilise dans le code mais la valeur doit correspondre la syntaxe attendue par la mthode. Dans cet exemple, saisissez State Nr dans le champ Name et dans le champ Value, choisissez un numro au hasard, ici : 42.
1371
Composants Internet
tXMLRPCInput
La classe na pas beaucoup dimpact sur cette mthode dmo mais pourrait en avoir sur une autre mthode. Ainsi, laissez les paramtres par dfaut. Dans la vue Component du composant tLogRow, cochez la case Print schema column name in front of each value. Enregistrez le Job puis excutez-le, en appuyant sur F6.
Le rsultat obtenu en sortie en utilisant la mthode RPC GetStateName et correspondant au quarante deuxime Etat des Etats Unis est donc South Dakota.
1372
Composants Logs & Errors

Ce chapitre passe en revue les principaux composants de la famille Logs & Errors de la Palette de Talend Open Studio. La famille Logs & Errors regroupe les composants ddis la gestion des donnes de log et des erreurs des Jobs.

tAssert
tAssert
Proprits du tAssert
Le composant tAssert est troitement li au tAssertCatcher pour tester une excution de Job. Il gnre une assertion boolenne partir dune instruction conditionnelle, dans le but dalimenter le statut dexcution prsent par le tAssertCatcher.
Famille de composant Logs & Errors
Fonction Objectif
Envoie le message de statut du Job au tAssertCatcher. Gnre lassertion boolenne relative lanalyse du Job. Le statut peut tre : Ok : lexcution du Job a russi. Fail : lexcution a chou. Les rsultats du Job test ne correspondent pas ce qui tait attendu, ou une erreur est survenue lors de lexcution. Description Expression Saisissez votre message descriptif afin d'identifier l'assertion du tAssert. Saisissez linstruction conditionnelle sur laquelle baser votre assertion.
Basic settings
Utilisation
Ce composant suit l'action laquelle est lie directement la condition assertive. Il peut tre utilis comme composant intermdiaire ou final du Job principal, ou bien en tant que composant de dbut, intermdiaire ou de fin du Job secondaire. Lvaluation du tAssert est capture par le tAssertCatcher.
Limitation
Scnario : Paramtrer une condition assertive pour lexcution dun Job

Ce scnario dcrit comment paramtrer une condition assertive dans le composant tAssert afin dvaluer si lexcution du Job a russi ou non. De plus, vous pouvez galement trouver comment deux rsultats diffrents dvaluation saffichent et comment les lire. Le scnario utilise un tAssert, mais aussi : un tFileInputDelimited et un tFileOutputDelimited. Les deux composants constituent le Job principal, duquel le statut dexcution est valu. Pour plus dinformations sur ces deux composants, consultez les composants : tFileInputDelimited, page 1136 et tFileOutputDelimited, page 1201. un tFileCompare. Il ralise la comparaison entre le fichier de sortie du Job principal et un fichier de rfrence standard. Le rsultat comparatif est valu par le tAssert par rapport la condition assertive configure dans ses paramtres. Pour plus dinformations propos du tFileCompare, consultez le composant tFileCompare, page 1117. un tAssertCatcher. Il capture lvaluation gnre par le tAssert. Pour plus dinformations propos du composant tAssertCatcher, consultez le composant tAssertCatcher, page 1380.

tAssert
un tLogRow. Il vous permet de lire lvaluation capture. Pour plus dinformations propos du tLogRow, consultez le composant tLogRow, page 1399. Afin de crer le Job principal, procdez comme suit : Prparez un fichier dlimit .csv comme fichier source lu par votre Job principal. Editez deux lignes dans ce fichier. Les modifications nont pas dimportance, vous pouvez uniquement simplifier le contenu. Nommez-le source.csv. Dans Talend Open Studio, crez un nouveau Job, que vous appelerez JobAssertion. Placez un tFileInputDelimited et un tFileOutputDelimited dans lespace de modlisation graphique. Connectez- les laide dun lien Row Main afin de crer le Job principal.
Double-cliquez sur le tFileInputDelimited afin douvrir sa vue Component. Dans le champ File Name de la vue Component, renseignez le chemin daccs votre fichier source.csv.
Slectionnez dans la liste Property Type le mode Built-In et cliquez sur le bouton [...] de loption Edit schema afin de dfinir les donnes passer au tFileOutputDelimited. Dans ce scnario, slectionnez les donnes prsentes dans le fichier source.csv que vous avez cr. Pour plus dinformations propos des types de schma, consultez Paramtrer un schma built-in et Paramtrer un schma du Repository du Guide Utilisateur Talend Open Studio. Dfinissez les autres paramtres dans les champs correspondants, selon le fichier source.csv que vous avez cr. Double-cliquez sur le tFileOutputDelimited afin douvrir sa vue Component. Dans le champ File Name de la vue Component, renseignez le chemin daccs votre fichier de sortie, et laissez les autres champs comme dfinis par dfaut.
1375

tAssert
Appuyez sur F6 afin dexcuter le Job principal. Il lit votre fichier source.csv, passe les donnes au tFileOutputDelimited et crit un fichier dlimit de sortie, out.csv. Continuez modifier votre Job, afin de voir comment le tAssert value le statut dexcution du Job principal. Renommez le fichier out.csv en reference.csv. Ce fichier est le rsultat attendu de lcriture du Job principal. Placez un tFileCompare, un tAssert et un tLogRow dans lespace de modlisation graphique. Connectez-les avec un lien Row Main. Connectez le tFileInputDelimited au tFileCompare avec un lien OnSubjobOk.
Double-cliquez sur le tFileCompare afin douvrir sa vue Component. Dans la vue Component, renseignez les chemins daccs dans les champs File to compare et Reference file correspondants, et laissez les autres champs comme dfinis par dfaut.
1376

tAssert
Pour plus dinformations propos du composant tFileCompare, consultez le composant tFileCompare, page 1117. Cliquez ensuite sur le tAssert, puis cliquez sur longlet Component, au bas de lespace de modlisation graphique.
Dans la vue Component, ditez la condition row2.differ==0, dans le champ expression ainsi que la description de lassertion. Dans le champ expression, row2 constitue le flux de donnes transmis du tFileCompare au tAssert, differ est une colonne du schma du tFileCompare qui affiche si les fichiers compars sont identiques. 0 signifie quaucune diffrence na t dtecte entre le fichier out.csv et le fichier reference.csv par le tFileCompare. Les fichiers compars sont donc identiques, la condition assertive est remplie, le tAssert conclut que le Job principal a t excut avec succs. Sinon, il conclut quil a chou.
La colonne differ fait partie du schma, en lecture seule, du tFileCompare. Pour plus dinformations sur son schma, consultez le composant tFileCompare, page 1117.
Appuyez sur F6 afin dexcuter votre Job. Vrifiez le rsultat retourn dans la vue Run.
1377

tAssert
La console affiche les rsultats de la comparaison du tFileCompare : Files are identical. Mais lvaluation du tAssert nest visible nulle part. Vous avez donc besoin du composant tAssertCatcher pour capturer lvaluation. Placez un tAssertCatcher et un tLogRow dans lespace de modlisation graphique. Connectez-les laide dun lien Row Main.
Utilisez la configuration par dfaut du tAssertCatcher dans sa vue Component.
1378

tAssert
Appuyez sur F6 afin dexcuter votre Job. Vrifiez les rsultats prsents dans la vue Run. Vous pouvez voir que les informations sur le statut du Job ont t ajoutes : 2010-01-29 15:37:33|fAvAzH|TASSERT|JobAssertion|java|tAssert_1|Ok|--| The output file should be identical with the reference file.
La description du JobAssertion dans la console est organise selon le schma du tAssertCatcher, lequel comprend des colonnes correspondant au temps dexcution, lID trait, au nom du projet, au langage du code, lorigine de lvaluation, le rsultat de lvaluation, les informations dtailles de lvaluation, et le message descriptif de lassertion. Pour plus dinformations propos du schma du tAssertCatcher, consultez le composant tAssertCatcher, page 1380. La console indique que le statut dexcution du Job JobAssertion est Ok. En plus de lvaluation, vous pouvez toujours voir les informations descriptives du JobAssertion, parmi lesquelles la description que vous avez saisie dans les Basic settings du tAssert. Effectuez ensuite quelques oprations pour que le Job principal ne puisse gnrer le fichier attendu. Pour ce faire, procdez comme suit : Effacez une ligne de votre fichier reference.csv. Appuyez sur F6 pour excuter votre Job nouveau. Vrifiez les rsultats retourns dans la vue Run. 2010-02-01 19:47:43|GeHJNO|TASSERT|JobAssertion|tAssert_1|Failed|Test logically failed|The output file should be identical with the reference file.
La console indique que le statut dexcution du Job principal est Failed (a chou). Lexplication dtaille suit peu aprs, Test logically failed (chec logique du test). Vous pouvez avoir une ide du statut de votre Job : il a chou lors de la gnration du fichier attendu cause dun chec logique. Cet chec logique peut provenirdune erreur logique lors de la cration du Job. Le statut et ses explications sont prsents respectivement dans les colonnes de statut et de sous-statut du schma du tAssertCatcher. Pour plus dinformations propos de cette colonne, consultez le composant tAssertCatcher, page 1380.
1379

tAssertCatcher
tAssertCatcher
Proprits du tAssertCatcher
A partir de son schma prdfini, le tAssertCatcher retrouve les informations des statuts d'excution, des excutions des Jobs et du tAssert. Gnre un flux de donnes consolidant les informations de statut dune excution de Job, et transfre les donnes dans les fichiers de sortie dfinis. Schema type Un schma est une description de lignes, i.e., il dfinit les champs traiter et passer au composant suivant. Pour ce composant, le schma est en lecture seule puisquil regroupe les informations de log standard, notamment : Moment : Date et heure de traitement. Pid : ID traits. Project : Projet auquel appartiennent les Jobs analyss. Job : Nom du Job analys. Language : Langage utilis par le Job. Cela peut tre Java ou Perl. Origin : Origine de lassertion de statut. Elle peut provenir de diffrents composants tAssert. Status : Jugements retrouvs partir du tAssert. Ils peuvent tre : - Ok : si linstruction conditionnelle du tAssert est value comme vraie (true) lexcution. - Failed : si linstruction conditionnelle du tAssert est value comme fausse (false), ou si des erreurs surviennent lexcution. Les rsultats du Job test ne correspondent pas ce qui tait attendu, ou une erreur est survenue lors de lexcution. Substatus : Explications dtailles propos des assertions de statut. Les explications peuvent tre : - Test logically failed : le Job analys ne produit pas le rsultat attendu. - Execution Error : une erreur dexcution est survenue lors de lexcution. Description : La description textuelle que vous avez saisie dans le tAssert. Catch Java Exception Cette case, une fois coche, vous permet de capturer les erreurs dexception Java. Catch tAssert Cette case vous permet de capturer les assertions du tAssert.
1380

tAssertCatcher
Utilisation
Ce composant est un composant de dbut de Job secondaire qui retrouve les informations de statut dexcution partir de diffrentes sources. Il gnre un flux de donnes afin de transfrer les informations au composant suivant. Ce composant doit tre utilis avec le composant tAssert.
Limitation
Scnario associ
Pour un scnario associ, consultez le scnario du tAssert : Scnario : Paramtrer une condition assertive pour lexcution dun Job, page 1374
1381

tChronometerStart
tChronometerStart
Proprits du tChronometerStart
Fonction Objectif
Le composant tChronometerStart dmarre lopration de mesure du temps dexcution dun sous-Job. Le tChronometerStart fonctionne comme un chronomtre : le composant commence calculer soit le temps de traitement dun ou plusieurs sous-Jobs du Job principal, soit le temps de traitement dune partie dun sous-Job. Vous pouvez utiliser le tChronometerStart comme composant de dbut ou au milieu dun Job. Il peut prcder une ou plusieurs tches de traitement dans un sous-Job. Il peut galement prcder un ou plusieurs sous-Jobs dans le Job principal. n/a
Utilisation
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Mesurer la dure de traitement dun sous-Job ou dune partie dun sous-Job.
1382

tChronometerStop
tChronometerStop
Proprits du tChronometerStop
Fonction Objectif
Le composant tChronometerStop mesure le temps dexcution dun sous-Job. Le tChronometerStop fonctionne comme un chronomtre : arrte le calcul du temps de traitement soit dun ou de plusieurs sous-Jobs dans le Job principal, soit dune partie dun sous-Job. En Perl, le composant tChronometerStop affiche le temps dexcution total, le nombre dexcutions, le nombre de lignes traites la seconde ainsi que le temps minimal, maximal et moyen de traitement dune ligne. En Java, il affiche le temps dexcution total. Since options Cochez lune des deux cases pour choisir le point de dpart du processus de mesure : Since the beginning : arrte le calcul du temps dont la mesure a commenc au dbut dun sous-Job. Since a tChronometerStart : arrte le calcul du temps dont la mesure a commenc partir dun composant tChronometerStart utilis sur le flux de donnes du sous-Job. Cochez cette case pour afficher les informations dexcution du sous-Job sur la console. Cochez cette case pour afficher le nom des composants sur la console. Entrez un texte, pour permettre didentifier votre sous-Job par exemple. Cochez cette case pour afficher les informations dexcution du sous-Job en units de temps exploitables.
Basic settings
Display duration in console Display component name Caption Display human readable duration Utilisation Limitation
Ne peut tre utilis comme composant de dbut. n/a
Scnario : Mesurer la dure de traitement dun sous-Job ou dune partie dun sous-Job
Ce scnario est un sous-Job, qui, dans une squence, effectue les oprations suivantes : gnre 1 000 000 lignes de noms et de prnoms ; regroupe les noms et les prnoms correspondants ; stocke les donnes de sortie dans un fichier dlimit ; mesure la dure densemble du sous-Job ;
1383

tChronometerStop
mesure la dure de lopration de remplacement des noms, affiche les informations relatives au temps de traitement dans la console de log Run. Pour mesurer le temps dexcution du sous-Job : A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tRowGenerator, le tMap, le tFileOutputDelimited et le tChronometerStop. Reliez les trois premiers composants laide de liens de type Main Row.
Lorsque vous reliez le tMap au tFileOutputDelimited, vous serez invits donner un nom la table en sortie. Le nom utilis dans cet exemple est new_order.
Reliez le tFileOutputDelimited au tChronometerStop laide dun lien de type OnComponentOk. Slectionnez le tRowGenerator puis cliquez sur la vue Component pour paramtrer ses proprits de base, dfinies par dfaut, dans longlet Basic settings.
Cliquez sur le bouton [...] du champ Edit schema pour dfinir le schma du tRowGenerator. Cliquez deux fois sur le bouton [+] pour ajouter deux colonnes : First_Name et Last_Name. Cliquez sur OK afin de fermer la bote de dialogue. Cliquez sur le bouton [...] du champ RowGenerator Editor pour ouvrir lditeur et dfinir les donnes gnrer.
1384

tChronometerStop
Dans le champ Number of Rows for RowGenerator de lditeur [RowGenerator Editor], prcisez le nombre de lignes gnrer puis cliquez sur OK. Lditeur [RowGenerator Editor] se ferme. Une bote de dialogue souvre et vous demande si vous souhaitez propager les changements. Cliquez sur Yes (Oui). Double-cliquez sur le composant tMap pour ouvrir son diteur. Lditeur du tMap affiche le schma du component tRowGenerator.
Dans longlet Schema editor de lditeur du tMap, cliquez sur le bouton [+] de la table de sortie pour ajouter deux lignes puis configurez-les. Dans lditeur du tMap, glissez la ligne First_Name de la table dentre dans la ligne Last_Name de la table de sortie et glissez la ligne Last_Name dans la ligne First_Name de la table de sortie. Cliquez sur Apply pour enregistrer les modifications. A nouveau, une bote de dialogue souvre et vous demande si vous souhaitez propager les changements. Cliquez sur Yes. Cliquez sur OK pour fermer lditeur.
1385

tChronometerStop
Slectionnez le tFileOutputDelimited et cliquez sur la vue Component pour paramtrer ses proprits de base dans longlet Basic settings :
Slectionnez le tChronometerStop et cliquez sur la vue Component pour paramtrer ses proprits de base dans longlet Basic settings. Dans la zone Since options, cochez loption Since the beginning pour mesurer la dure dexcution du sous-Job entier.
t
1386

tChronometerStop
Cochez/dcochez les autres cases en fonction de vos besoins. Dans ce scnario, lobjectif est dafficher dans la console la dure dexcution du sous-Job, prcde du nom du composant. Si ncessaire, saisissez du texte de le champ Caption. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Vous pouvez aussi mesurer la dure du sous-Job en plaant un tChronometerStop en dessous du tRowGenerator, et en les connectant via un lien OnSubJobOk.
1387

tDie
tDie
Proprits du tDie
Les composants tDie et tWarn sont troitements lis au composant tLogCatcher. Ils sont gnralement utiliss ensemble afin que les donnes de log collectes par le tLogCatcher soient rassembles et envoyes vers la sortie dfinie.
Le composant tDie tue le Job en cours dexcution. Il est gnralement utilis avec un composant tCatch afin de collecter des donnes de log. Ce composant dclenche le composant tLogCatcher afin de collecter des donnes de log exhaustives avant de tuer le Job. Die message Error code Priority Saisissez le message qui sera affich avant que le Job ne soit tu. Saisissez le code de lerreur (un entier) si ncessaire. Slectionnez le niveau de priorit.
Ce composant ne peut tre utilis en tant que composant de dbut. n/a
Scnarios associs
Pour des exemples dutilisation du composant tDie, consultez les scnarios du composant tLogCatcher : Scnario 1 : Avertissement & log lors de la cration dentres, page 1395 Scnario 2 : Monitorer & arrter un Job, page 1397
1388

tFlowMeter
tFlowMeter
Proprits du tFlowMeter
Le composant tFlowMeter compte le nombre de lignes traites dans le flux spcifi. Le nombre de lignes est ensuite rcupr par le composant tFlowMeterCatcher afin dtre ajout dans les donnes de log. Use input connection name as label Mode Cochez cette case pour rutiliser le nom donn au flux dentre Main Row comme libell des donnes logge. Slectionnez le type de valeur des donnes mesures : Absolute : le nombre actuel de lignes est logg. Relative : un pourcentage (%) du nombre de lignes est logg. Lorsque cette option est slectionne, la liste Connections List vous permet de slectionner une connexion de rfrence. Ajoutez un seuil pour observer les proportions en volumes mesurs. Vous pouvez dcider que le flux doit tre compris entre un nombre minimum et maximum de lignes, et si le flux est infrieur au seuil minimum, il y a un goulot dtranglement.
Thresholds
Ce composant ne peut tre utilis comme composant de dbut puisquil ncessite un flux dentre pour fonctionner. n/a
Si vous avez besoin dutiliser les donnes de log, les statistiques et tout autre mesure des flux de donnes, consultez Automatiser lutilisation de statistiques & logs du Guide utilisateur de Talend Open Studio.
Scnario associ
Pour plus dinformations sur lutilisation du tFlowMeter, consultez le Scnario : Mesurer le flux dun Job, page 1391
1389

tFlowMeterCatcher
tFlowMeterCatcher
Proprits du tFlowMeterCatcher
Fonction
Le composant tFlowMeterCatcher est bas sur le schma dfini. Il rcupre les donnes du composant tFlowMeter et les transmet au composant de sortie. Ce composant fonctionne comme une fonction de log dclenche par lutilisation du composant tFlowMeter dans le Job. Schema type Un schma est une description de lignes, i.e., il dfinit les champs traiter et passer au composant suivant. Pour ce composant, le schma est en lecture seule puisquil regroupe les informations de log standard, notamment : Moment : Date et heure du traitement Pid : Identifiant systme du Job. Father_pid : Identifiant systme du Job parent, le cas chant. Sinon, le Pid est dupliqu. Root_pid : Identifiant systme du Job racine, le cas chant. Sinon, le Pid est dupliqu. System_pid : Identifiant systme gnr par le systme. Project : Nom du projet auquel appartient le Job. Job : Nom du Job en cours. Job_repository_id : Identifiant gnr par lapplication. Job_version : Numro de version du Job en cours. Context : Nom du contexte en cours. Origin : Nom du composant, le cas chant. Label : Libell de la connexion main Row prcdent le composant tFlowMeter dans le Job et dont la volumtrie sera analyse. Count : Nombre de lignes en cours de traitement. Reference : Nom de la ligne de rfrence telle quelle a t dfinie dans le composant tFlowMeter lorsque le mode Relative a t slectionn. Thresholds : cette fonction ne sutilise que si le mode Relative a t slectionn dans le composant tFlowMeter.
Utilisation
Ce composant est le composant de dbut du Job secondaire qui se dclenche automatiquement la fin du Job principal.
1390

tFlowMeterCatcher
Limitation
Lutilisation de ce composant est lie lutilisation du composant tFlowMeter. Pour plus dinformations, consultez tFlowMeter page 1389.
Scnario : Mesurer le flux dun Job

Le Job suivant permet de recueillir le nombre de lignes traites. Les mesures sont prises deux fois, une fois aprs le composant dentre, cest--dire avant quelles soient filtres, et aprs leur filtrage, avant le composant de sortie.
Cliquez et dposez les composants suivants : tMysqlInput, tFlowMeter (x2), tMap, tLogRow, tFlowMeterCatcher et tFileOutputDelimited. Connectez les composants du Job principal laide de liens de type Row main et cliquez sur le libell pour lui donner un nom plus parlant, par exemple US_States aprs le composant dentre et filtered_states aprs le tMap. Reliez aussi les composants tFlowMeterCatcher et tFileOutputCSV laide dune connexion de type Row main puisque les donnes sont transmises au composant de sortie. Dans la vue Component du composant tMysqlInput, slectionnez loption Repository dans le champ Property Type, si les proprits de connexion la base de donnes sont stockes dans une mtadonne du Repository. Sinon, slectionnez loption Built-in et paramtrez les proprits et le schma manuellement.
1391

tFlowMeterCatcher
Les 50 Etats des Etats Unis sont enregistrs dans la table states. Pour que les 50 entres soient slectionnes, la requte effectuer dans la base de donnes Mysql est la suivante : select * from states. Dans longlet Advanced settings, slectionnez lencodage adquat. Puis slectionnez le composant suivant, le tFlowMeter, et paramtrez ses proprits.
Cochez la case Use input connection name as label pour rutiliser le nom de la connexion dentre dans le fichier log de sortie (tFileOutputCSV). Dans le champ Mode, slectionnez loption Absolute puisquil ny a pas de flux de rfrence, et aucun seuil ne doit tre dfini dans le champ Threshold pour cet exemple.
Les informations du champ Thresholds sont utilises dans un outil de monitoring tel que lActivity Monitoring Console de Talend afin dobtenir une reprsentation proportionnelle du flux trait. Pour plus dinformations, consultez le Guide utilisateur de lActivity Monitoring Console.
Puis lancez lditeur du tMap pour paramtrer les proprits de filtrage. Pour cet exemple, glissez et dposez les colonnes ID et State de la zone Input ( gauche) du tMap vers la zone Output ( droite). Aucune variable nest utilise pour cet exemple.
1392

tFlowMeterCatcher
Dans la table du flux de sortie (ici, la table filtered_states), cliquez sur la flche dote dun (+) pour ajouter un ligne de filtre. Glissez la colonne State de la zone Input (row2) vers le champ filtre et saisissez un filtre permettant de nobtenir que les Etats commenant par la lettre M. Lexpression finale ressemble : row2.State.startsWith("M") Cliquez sur OK pour valider les paramtres. Puis slectionnez le deuxime composant tFlowMeter et paramtrez ses proprits.
Cochez la case Use input connection name as label. Dans le champ Mode, slectionnez loption Relative et dans la liste droulante Reference connection, slectionnez US_States comme rfrence. Une fois de plus, aucun seuil nest utilis pour cet exemple, ainsi laissez le champ Threshold vide. Aucun paramtre particulier nest requis pour le composant tLogRow. Il en va de mme pour le composant tFlowMeterCatcher puisque ses proprits sont limites au schma prdfini contenant les informations de log. Paramtrez les proprits du composant de sortie (tFileOutputCSV).
1393

tFlowMeterCatcher
Cochez la case Append pour logger toutes les mesures du tFlowMeter. Enregistrez le Job et excutez-le.
La vue Run affiche le nom des Etats filtrs tel quil a t dfini dans le Job.
Dans le fichier csv dlimit, le nombre de lignes de la colonne count varie entre le composant tFlowMeter1 et le tFlowMeter2 puisque les donnes ont t filtres. La colonne reference affiche cette diffrence.
1394

tLogCatcher
tLogCatcher
Proprits du tLogCatcher
Fonction
Le composant tLogCatcher rcupre les champs et les messages des fonctions Java Exception/PerlDie et des composants tDie et/ou tWarn et les transmet au composant suivant. Ce composant fonctionne comme une fonction de log dclenche par une des trois fonctions suivantes : Java exception/PerlDie, tDie ou tWarn, pour collecter et transfrer des donnes de log. Schema type et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Catch PerlDie Cochez cette case pour dclencher la fonction tCatch Catch Java Exception lorsque les fonctions PerlDie/Java Exception sont appeles dans le Job. Catch tDie Catch tWarn Cochez cette case pour dclencher la fonction tCatch lorsque le composant tDie est appel dans le Job. Cochez cette case pour dclencher la fonction tCatch lorsque le composant tWarn est appel dans le Job.
Objectif
Basic settings
Ce composant est le composant de dbut dun Job secondaire qui se dclenche automatiquement la fin du Job principal. n/a
Scnario 1 : Avertissement & log lors de la cration dentres

Dans ce scnario constitu de trois composants, un composant tRowGenerator cre des donnes alatoires (des id incrmenter). Le flux dentre atteint le composant tWarn qui dclenche le sous-Job commenant par le tLogCatcher. Ce sous-Job rcupre le message davertissement ainsi que les informations standard et les transmet au tLogRow afin dafficher les donnes de log.
1395

tLogCatcher
Cliquez et dposez les composants tRowGenerator, tWarn, tLogCatcher et tLogRow dans lespace de modlisation. Connectez les composants tRowGenerator et tWarn. Connectez les composants tLogCatcher et tLogRow sparement. Dans lditeur du tRowGenerator, paramtrez la cration des donnes alatoires laide de fonction de base :
Dans la vue Component du composant tWarn, paramtrez le message davertissement dans le champ Warn message, le code et le niveau de priorit dans le champ Priority. Pour cet exemple, le message est this is a warning. Pour ce scnario, concatnez le message ci-dessus avec une fonction pour collecter la premire valeur de la table Input.
Dans la vue Component du composant tLogCatcher, cochez la case tWarn pour que le message dfini dans le tWarn soit rcupr par le sous-Job. Cliquez sur Edit Schema pour vrifier le schma utilis pour la sortie de log. Notez que le log est complet.
1396

tLogCatcher
Appuyez sur F6 pour excuter le Job. Notez que le Log produit est exhaustif.
Scnario 2 : Monitorer & arrter un Job

Ce scnario utilise les composants tLogCatcher et tDie. Un composant tRowGenerator est connect un composant tFileOutputDelimited laide dun lien Row. Lorsquune erreur survient, le composant tDie dclenche le sous-Job contenant le tLogCatcher qui affiche les donnes de log dans la console Run.
Cliquez et dposez les composants ncessaires de la Palette : tRowGenerator, tFileOutputDelimited, tDie, tLogCatcher, tLogRow. Dans la vue Component du composant tRowGenerator, paramtrez les proprits des donnes dentre qui seront traites.
Editez le schma et paramtrez les colonnes suivantes : id, name, quantity, flag et creation. Dans le champ Number of rows, saisissez 0. Cela consituera lerreur sur laquelle sera base opration Die. Dans la colonne Values, dfinissez les fonctions permettant dalimenter le flux dentre.

tLogCatcher
Paramtrez les proprits du tFileOutputDelimited afin quil contienne les donnes transmises. La connexion Row provenant du tRowGenerator alimente automatiquement le schma du tFileOutputDelimited. Dans le champ Row separator, saisissez un point-virgule comme sparateur de champ. Connectez le composant de sortie au tDie laide dun lien Trigger > If. Double-cliquez sur cette nouvelle connexion et paramtrez le if : ((Integer)globalMap.get("tRowGenerator_1_NB_LINE")) <=0 Puis double-cliquez pour slectionner et paramtrer les proprits du composant tDie dans longlet Basic settings.
Dans le champ Die message, saisissez le message transmettre au tLogCatcher avant que le Job ne soit arrt par la fonction Kill. Dans le mme Job, cliquez et dposez un tLogCatcher, sans pour autant le connecter aux composants prcdents, et connectez-le un composant tLogRow. Dans longlet Basic settings du composant tLogCatcher, paramtrez ses proprits. Assurez-vous que la case tDie est bien coche pour pouvoir ajouter un message Die aux informations de Log transmises au composant final.
Appuyez sur F6 pour excuter le Job et notez que le log contient un message en noir et un en rouge. Les donnes de log en noir proviennent du tDie et sont transmises par le tLogCatcher. Et le message Java Exception en rouge apparat puisque le Job sest arrt.
1398

tLogRow
tLogRow
Proprits du tLogRow
Le composant tLogRow affiche les donnes ou les rsultats dans la console Run. Ce composant permet de monitorer les donnes traites. Print values in table cells Separator Le flux de sortie apparat dans un tableau. Saisissez le sparateur qui dlimitera les donnes dans la console.
Print component Cochez cette case si plusieurs composants unique name in front LogRow sont utiliss. Cela permet de diffrencier of each output row les sorties. Print schema column name in front of each value Use fixed length for values Utilisation Limitation Cochez cette case pour rcuprer les libells des colonnes du schma de sortie. Cochez cette case pour paramtrer une largeur fixe aux valeurs affiches.
Ce composant peut tre utilis en composant intermdiaire dans un flux de donnes ou en composant de fin dans un Job design. n/a
Scnarios associs
Pour plus dinformations sur lutilisation du tLogRow, consultez les composants : tFileInputDelimited, Scnario 1 : Afficher le contenu dun fichier dlimit, page 1138. tContextLoad, Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL, page 1426. tWarn, tDie et tLogCatcher, Scnario 1 : Avertissement & log lors de la cration dentres, page 1395 et Scnario 2 : Monitorer & arrter un Job, page 1397.
1399

tStatCatcher
tStatCatcher
Proprits du tStatCatcher
Fonction
Le composant tStatCatcher est bas sur le schma dfini et regroupe les mtadonnes du Job en cours dexcution, ainsi que les mtadonnes de chaque composant de ce Job. Ce composant fonctionne comme une fonction de log dclenche pour chaque composant dont la case StatsCatcher Statistics est coche. Il collecte et transfert ces donnes de log la sortie dfinie. Schema type Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Pour ce composant, le schma est en lecture seule, puisquil regroupe les informations de log standard, notamment : Moment : Date et heure du traitement Pid : Identifiant systme du Job. Father_pid : Identifiant systme du Job parent, le cas chant. Sinon, le Pid est dupliqu. Root_pid : Identifiant systme du Job racine, le cas chant. Sinon, le Pid est dupliqu. Project : Nom du projet auquel appartient le Job. Job : Nom du Job en cours. Context : Nom du contexte en cours. Origin : Nom du composant, le cas chant. Message : Informations de dbut et de fin du Job.
Objectif
Basic settings
Utilisation
Ce composant est le composant de dbut dun Job secondaire qui se dclenche automatiquement la fin du Job principal. Les dates de dbut et de fin apparaissent dans le log. n/a
Limitation
Scnario : Afficher les statistiques du Job

Ce scnario dcrit un Job quatre composants, permettant dafficher dans la console Run les statistiques recueillies lors de la gnration du fichier grce au composant tStatCatcher.
1400

tStatCatcher
Cliquez et dposez les composants : tRowGenerator, tFileOutputDelimited, tStatCatcher et tLogRow Dans longlet Basic settings du composant tRowGenerator, paramtrez les donnes gnrer. Pour ce Job, le schma est compos de trois colonnes : ID_Owners, Name_Customer et ID_Insurance, gnres laide dun script Perl.
Le nombre de lignes peut tre limit 100. Cliquez sur longlet Main de la vue Component.
Et cochez la case tStatCatcher Statistics pour activer la fonction de rcupration des statistiques. Puis, paramtrez les proprits du composant de sortie. Dans la vue Component du tFileOutputDelimited, slectionnez le fichier de sortie ou saisissez le nom du fichier de sortie crer. Paramtrez les sparateurs de champs (point-virgule) et lencodage. Cliquez sur Edit schema et assurez-vous que le schma est rcupr du schma dentre. Si ncessaire, cliquez sur Sync Columns pour rcuprer le schma du composant prcdent.
1401

tStatCatcher
Puis cliquez sur longlet Advanced settings de la vue Component, et cochez la case tStatCatcher Statistics pour activer la fonction de rcupration des statistiques. Dans le deuxime Job, double-cliquez sur le composant tStatCatcher. Notez que les proprits sont fournis uniquement pour information puisque le schma reprsentant les donnes regrouper et agrger en statistiques, est en lecture seule.
Paramtrez ensuite les proprits du tLogRow. Dfinissez le sparateur de donnes qui apparatra dans la console. Enfin, appuyez sur F6 pour excuter le Job et afficher les rsultats du Job.
Les donnes de log affiche les informations de dbut et de fin du Job en lui-mme, ainsi que pour chaque composant.
1402

tWarn
tWarn
Proprits du tWarn
Le composant tWarn envoie un message davertissement au composant suivant. Ce composant dclenche un avertissement souvent pris comme donnes de log exhaustives par le composant tLogCatcher. Warn message Code Priority Saisissez votre message davertissement. Saisissez le niveau de code. Slectionnez le niveau de priorit.
Utilisation
Ce composant ne peut tre utilis comme composant de dbut. Ainsi, sil est connect un composant de sortie, il doit aussi tre connect un composant dentre. n/a
Limitation
Scnarios associs
Pour des exemples dutilisation du tWarn, consultez les scnarios du composant tLogCatcher : Scnario 1 : Avertissement & log lors de la cration dentres, page 1395 Scnario 2 : Monitorer & arrter un Job, page 1397
1403

tWarn
1404
Composants Misc
Ce chapitre passe en revue les principaux composants prsents dans la famille Misc de la Palette de Talend Open Studio. La famille Misc regroupe divers connecteurs permettant de rpondre des besoins, tels que la cration de lignes de donnes factices, la mise en tampon de donnes, le chargement de variables de contexte.
Composants Misc
tAddLocationFromIP
tAddLocationFromIP
Proprits du tAddLocationFromIP
Famille du composant Misc
Fonction Objectif
Le composant tAddLocationFromIP remplace des adresses IP par le lieu gographique correspondant. Le tAddLocationFromIP vous permet de localiser gographiquement les visiteurs grce leurs adresses IP : il identifie le lieu gographique des visiteurs (pays, rgion, ville, latitude, longitude, code postal, etc.) en utilisant un fichier de consultation dadresse IP. Schema type et Un schma est une description de lignes, i.e., il Edit Schema dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Database Filepath Input parameters Chemin daccs au fichier de consultation dadresses IP. Input column : Slectionnez la colonne dentre partir de laquelle les valeurs sont collectes pour lagrgation. input value is a hostname : Cochez cette case si la colonne dentre comporte des noms dhtes. input value is an IP address : Cochez cette case si la colonne dentre comporte des adresses IP. Location type Country code : Cochez cette case pour remplacer ladresse IP par le code du pays correspondant. Country name : Cochez cette case pour remplacer ladresse IP par le nom du pays correspondant.
Basic settings
Utilisation
Ce composant peut tre utilis comme tape intermdiaire du traitement permettant de remplacer des adresses IP par des informations golocalises. Il ne peut tre utilis comme composant de dbut car il ncessite un flux en entre, ainsi quun composant de sortie. n/a
Limitation
1406
Composants Misc
tAddLocationFromIP
Scnario : Identifier la localisation gographique dune adresse IP

Le scnario Java suivant cre un Job trois composants associant une adresse IP un lieu gographique. Il permet dobtenir la localisation gographique du visiteur dun site partir de son adresse IP. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFixedFlowInput, le tAddLocationFromIP, et le tLogRow. Connectez les trois composants en utilisant des liens de type Row Main.
Dans lespace graphique, slectionnez le tFixedFlowInput. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFixedFlowInput. Configurez le champ Schema Type en mode Built-In puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes que vous voulez utiliser en entre. Dans ce scnario, le schma est constitu dune colonne comportant une adresse IP.
Cliquez sur le bouton OK pour fermer la bote de dialogue, puis acceptez la propagation des modifications lorsque le systme vous invite le faire. La colonne dfinie saffiche dans la section Values de la vue Basic settings. Cliquez dans la cellule Value puis dfinissez la valeur de ladresse IP.
1407
Composants Misc
tAddLocationFromIP
Dans le champ Number of rows, entrez le nombre de lignes gnrer. Dans lespace graphique, slectionnez le composant tAddLocationFromIP. Cliquez dans la vue Component pour dfinir la configuration de base (Basic settings) du tAddLocationFromIP.
Cliquez sur le bouton Sync columns pour synchroniser le schma avec le schma dentre du tFixedFlowInput. Parcourez vos dossiers jusquau fichier GeoIP.dat pour en dfinir le chemin daccs dans le champ Database filepath.
Assurez-vous de tlcharger la dernire version du fichier de consultation des adresses IP, partir du site indiqu dans la vue Basic settings du composant tAddLocationFromIp.
Dans la zone Input parameters, dfinissez les paramtres dentre selon vos besoins. Dans ce scnario, la colonne dentre correspond la colonne ip, qui comporte une adresse IP, dfinie prcdemment. Dans la zone Location type, dfinissez le type de lieu selon vos besoins. Dans ce scnario, on veut afficher le nom du pays. Dans lditeur graphique, slectionnez le composant tLogRow. Cliquez sur la vue Component puis dfinissez la configuration de base (Basic settings) du tLogRow selon vos besoins. Dans ce scnario, on veut afficher les valeurs dans les cellules dune table. Enregistrez votre Job puis cliquez sur F6 pour lexcuter.
1408
Composants Misc
tAddLocationFromIP
La ligne unique gnre par le Job affiche le nom du pays correspondant ladresse IP renseigne.
1409
Composants Misc
tBufferInput
tBufferInput
Proprits du tBufferInput
Famille de composant Misc
Fonction Objectif
Ce composant permet de rcuprer les donnes mises en tampon pour pouvoir les rutiliser dans un deuxime sous-job. Lee composant tBufferInput rcupre les donnes mises en mmoire tampon, via un composant tBufferOutput par exemple, pour les traiter dans un deuxime temps. Schema type et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Lors de lutilisation du tBufferInput, cest lordre des colonnes qui est pris en compte, ainsi lordre des colonnes est plus important que leur libell. Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Basic settings
Utilisation
Ce composant est le composant de dbut dun Job secondaire qui se dclenche automatiquement la fin du Job principal.
Scnario : Rcuprer les donnes mises en tampon (Java)

Ce scnario dcrit un Job qui rcupre les donnes mises en mmoire tampon lors de lexcution dun premier sous-job et les affiche dans la console standard.
1410
Composants Misc
tBufferInput
Cliquez et dposez les composants suivants : tFileInputDelimited et tBufferOutput. Slectionnez le composant tFileInputDelimited et dans longlet Basic Settings de la vue Component, paramtrez les proprits daccs au fichier dentre.
Dans le champ File Name, paramtrez le chemin daccs au fichier dlimit contenant les donnes mettre en tampon. Dans les champs Row et Field separators, renseignez respectivement les sparateurs de lignes et de champs. Dans le champ Header, renseignez les informations sur un ventuel en-tte. Cliquez sur le bouton [...] cot du champ Schema type pour dcrire la structure du fichier
Dcrivez le Schma des donnes passer au composant tBufferOutput. Slectionnez le composant tBufferOutput et paramtrez ses proprits dans longlet Basic Settings de la vue Component.
1411
Composants Misc
tBufferInput
Gnralement le schma du composant dentre alimente automatiquement le schma du composant tBufferOutput. Mais vous pouvez aussi configurer une partie du schma mettre en tampon si vous le souhaitez. Dposez les composants tBufferInput et tLogRow en dessous du sous-job que vous venez de crer. Reliez le composant tFileInputDelimited au tBufferInput via un lien de type Trigger > OnSubjobOk et reliez le composant tBufferInput au tLogRow via un lien de type Row > Main. Double-cliquez sur le composant tBufferInput pour paramtrer ses proprits dans la vue Component. Dans longlet Basic settings, cliquez sur le bouton [...] cot du champ Schema pour dcrire la structure du fichier.
Utilisez la mme description de fichier que celle dfinie pour le composant tFileInputDelimited et cliquez sur OK. Le schma du composant tBufferInput alimente automatiquement le schma du composant tLogRow. Sinon double-cliquez sur le tLogRow pour afficher ses proprits dans la vue Component et cliquez sur le bouton Sync columns. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
La console affiche les donnes qui ont t rcuprs de la mmoire tampon.
1412
Composants Misc
tBufferOutput
tBufferOutput
Proprits du tBufferOutput
Fonction Objectif
Ce composant met en tampon des donnes afin de pouvoir y accder plus tard via un service Web par exemple. Ce composant permet daccder aux donnes via un service Web. En effet, il a t conu pour tre export en tant que service Web afin daccder aux donnes directement partir du serveur dapplication Web. Pour plus dinformations, consultez Exporter un Job en tant que WebService du Guide utilisateur de Talend Open Studio. Schema type et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Lors de lutilisation du tBufferOutput, cest lordre des colonnes qui est pris en compte, ainsi lordre des colonnes est plus important que leur libell. Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Basic settings
Utilisation
Ce composant nest pas un composant de dbut (font vert) et il requiert un composant de sortie.
Scnario 1 : Mettre des donnes en tampon (Java)

Ce scnario dcrit un Job volontairement basique qui met en tampon les donnes dun Job enfant pendant quun Job parent affiche les donnes mise en tampon dans la console standard. Gnralement, un Job utilisant un composant tBufferOutput incluerait une tape dexport en tant que service Web, afin que les donnes soient accessibles directement via le serveur dapplication Web.
1413
Composants Misc
tBufferOutput
Crez deux Jobs : le premier Job (BufferFatherJob) excute le deuxime et affiche le contenu dans la console Run. Le deuxime Job (BufferChildJob) stocke les donnes dfinies dans une mmoire tampon. Dans le premier Job, cliquez et dposez les composants suivants : tRunJob et tLogRow. Dans le deuxime Job, cliquez et dposez les composants suivants : tFileInputDelimited et tBufferOutput. Commencez par paramtrer les proprits du deuxime Job. Slectionnez le composant tFileInputDelimited et dans longlet Basic Settings de la vue Component, paramtrez les proprits daccs au fichier dentre.
Dans le champ File Name, paramtrez le chemin daccs au fichier dlimit contenant les donnes mettre en tampon. Dans les champs Row et Field separators, renseignez respectivement les sparateurs de lignes et de champs. Dans le champ Header, renseignez les informations sur un ventuel en-tte.
1414
Composants Misc
tBufferOutput
Dcrivez le Schma des donnes passer au composant tBufferOutput. Slectionnez le composant tBufferOutput et paramtrez ses proprits dans longlet Basic Settings de la vue Component.
Gnralement le schma du composant dentre alimente automatiquement le schma du composant tBufferOutput. Mais vous pouvez aussi configurer une partie du schma mettre en tampon si vous le souhaitez. Maintenant le premier Job (BufferFatherJob), paramtrez les proprits du composant tRunJob.
Cliquez sur Edit schema pour modifier le schma si ncessaire et slectionner la colonne afficher. Le schma peut tre identique ou diffrent du schma mis en tampon. Dans le tableau Context Param, vous pouvez aussi dfinir les paramtres de contexte utiliser pour lexcution de ce Job. Pour cet exemple, gardez le contexte par dfaut. Appuyez sur F6 pour excuter les Jobs parent. Le composant tRunJob se charge dexcuter le Job enfant et affiche les donnes dans la console standard :
1415
Composants Misc
tBufferOutput
Scnario 2 : Mettre les donnes de sortie en mmoire tampon du serveur dapplication Web
Ce scnario dcrit un Job appelant un service Web et stockant les donnes de sortie directement sur la mmoire tampon du serveur dapplication Web. Ce scnario cre dabord un Job utilisant des variables de contexte qui pourra ensuite tre utilis en tant que service Web, puis exporte de Job en tant que service Web. Crer un Job utilisant des variables de contexte et pouvant tre export en tant que service Web : Cliquez-dposez les composants suivants dans le Job Designer : tFixedFlowInput et tBufferOutput. Reliez-les via une connexion de type Row Main.
Dans lespace de travail, slectionnez le tFixedFlowInput. Cliquez sur la vue Component pour paramtrer ses proprits de base dans longlet Basic settings. Dans la liste Schema Type, slectionnez Built-In et cliquez sur le bouton [...] cot du champ Edit Schema pour dcrire la structure des donnes que vous souhaitez partir des variables internes. Dans ce scnario, le schma est constitu de trois colonnes : now, firstname, et lastname.
1416
Composants Misc
tBufferOutput
Cliquez trois fois sur le bouton (+) pour ajouter trois lignes de paramtre et configurez vos variables. Cliquez sur OK pour fermer la bote de dialogue et acceptez la propagation des modifications lorsque vous y tes invit. Les trois colonnes dfinies apparaissent dans le champ Values de longlet Basic settings du tFixedFlowInput.
Cliquez dans le cellule Value de chaque ligne des deux premier paramtres dfinis et appuyez sur Ctrl+Space pour accder la liste des variables globales. A partir de la liste des variables globales, slectionnez TalendDate.getCurrentDate() pour la colonne now et talendDatagenerator.getFirstName pour la colonne firstname. Pour ce scnario, lobjectif est de dfinir deux variables de contexte : nb_lines et lastname. Dans la premire, paramtrez le nombre de lignes gnrer, et dans le deuxime, paramtrez les noms qui apparaitront dans la liste de sortie. Le composant tFixedFlowInput gnrera le nombre de lignes et les trois colonnes : now, firstname, et lastname dfinies dans les variables de contexte. Pour plus dinformations concernant lutilisation des variables de contexte : consultez Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Pour dfinir les deux variables de contexte : Slectionnez le composant tFixedFlowInput et cliquez sur la vue Contexts. Dans la vue Variables, cliquez sur le bouton [+] pour ajouter deux lignes de paramtres et configurez-les.
1417
Composants Misc
tBufferOutput
Cliquez sur longlet Values as table et configurez le premier paramtre dfinissant le nombre de lignes gnrer et le second paramtre dfinissant les noms afficher.
Cliquez sur la vue Component pour afficher longlet Basic settings du composant tFixedFlowInput. Cliquez dans la cellule Value de la colonne lastname et appuyez sur Ctrl+Space pour accder la liste des variables globales. A partir de la liste des variables globales, slectionnez context.lastname, la variable de contexte que vous avez cr pour la colonne lastname.
1418
Composants Misc
tBufferOutput
Exporter un Job en tant que service Web : Avant dexporter votre Job en tant que service Web, consultez la section Export de Job en Java du Guide utilisateur de Talend Open Studio. Dans la vue Repository, cliquez-droit sur le Job que vous venez de crer et slectionnez Export Job Scripts dans le menu. La bote de dialogue [Export Job Scripts] souvre.
Cliquez sur le bouton Browse... et slectionnez le rpertoire dans lequel enregistrer votre Job. Dans la zone Export type, slectionnez le type dexport que vous souhaitez utiliser dans votre application Web Tomcat (WAR pour cet exemple) et cliquez sur Finish. La bote de dialogue [Export Job Scripts] se referme. Copiez le fichier War et collez-le dans le rpertoire de votre Tomcat.
1419
Composants Misc
tBufferOutput
Scnario 3 : Appeler un Job contenant des variables de contexte partir de votre navigateur Web
Ce scnario dcrit la procdure utiliser pour appeler le Job cr dans le scnario 2 partir de votre navigateur Web en modifiant/sans modifier les valeurs des variables de contexte. Saisissez lURL suivante dans votre navigateur Web : http://localhost:8080//export_job/services/export_job3?method=runJob dans laquelle export_job correspond au nom du rpertoire de votre application Web dploy sur le Tomcat et export_job3 correspond au nom de votre Job.
Cliquez sur Enter pour excuter votre Job partir du navigateur.
Le Job utilise les valeurs par dfaut des variables de contexte : nb_lines et lastname, et donc gnre trois lignes contenant la date en cours, un prnom et le nom Ford. Vous pouvez modifier les valeurs des variables de contexte directement partir de votre navigateur. Pour appeler le Job partir de votre navigateur et modifier les valeurs des deux variables de contexte, saisissez lURL suivante : http://localhost:8080//export_job/services/export_job3?method=runJob&arg1=--context_param %20lastname=MASSY&arg2=--context_param%20nb_lines=2.
1420
Composants Misc
tBufferOutput
%20 correspond un espace blanc lorsquil est utilis dans une URL. Dans le premier argument arg1, dfinissez la valeur MASSY pour la variable de contexte lastname. Ainsi le nom qui apparatra sera MASSY. Dans le deuxime argument arg2, dfinissez la valeur 2 pour la variable de contexte nb_lines pour ne gnrer que deux lignes de donnes. Cliquez sur Enter pour excuter le Job partir du navigateur.
Le Job gnre deux lignes avec MASSY comme nom.
Scnario 4 : Appeler un Job export en tant que service Web dans un autre Job
Ce scnario dcrit un Job appelant un autre Job export en tant que service Web en utilisant un composant tWebServiceInput. Ce scnario appelera le Job cr dans le scnario 2. Cliquez-dposez les composants suivants dans le Job Designer : tWebServiceInput et tLogRow. Reliez-les via une connexion de type Row Main.
Dans lespace de travail, slectionnez le composant tWebServiceInput. Cliquez sur la vue Component pour dfinir ses proprits de base dans longlet Basic settings.
1421
Composants Misc
tBufferOutput
Dans la liste Schema Type, slectionnez Built-In et cliquez sur le bouton [...] cot du champ Edit Schema pour dcrire la structure des donnes que vous souhaitez appeler du Job export. Dans ce scnario, le schma est constitu de trois colonnes, now, firstname, et lastname.
Cliquez sur le bouton (+) pour ajouter les trois lignes de paramtres et dfinir vos variables. Cliquez sur OK pour fermer la bote de dialogue. Dans le champ WSDL de longlet Basic settings de la vue Component du tWebServiceInput, saisissez lURL : http://localhost:8080/export_job/services/export_job3?WSDL dans laquelle export_job correspond au nom du rpertoire de votre application Web dans lequel le Job appeler est stock et export_job3 correspond au nom du Job.
1422
Composants Misc
tBufferOutput
Dans le champ Method name, saisissez runJob. Dans la zone Parameters, cliquez sur le bouton (+) pour ajouter deux lignes de paramtres et dfinir vos variables de contexte. Cliquez dans la premire cellule Value pour configurer le paramtre dfinissant le nombre de lignes gnrer : --context_param nb_line=3. Cliquez dans la deuxime cellule Value pour configurer le maramtre dfinissant le nom afficher : --context_param lastname=Ford. Slectionnez le tLogRow et cliquez sur la vue Component pour afficher les proprits du composant. Dans la vue Basic settings du tLogRow, slectionnez loption Table pour afficher les donnes de sortie sous forme de tableau. Pour plus dinformations, consultez les Proprits du tLogRow, page 1399. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Le Job gnre trois colonnes contenant la date en cours, des prnoms et des noms, et les affiche dans la console sous forme de tableau.
1423
Composants Misc
tContextDump
tContextDump
Proprits du tContextDump
Fonction Objectif
tContextDump fait une copie des valeurs du contexte utilis dans le Job. Le tContextDump peut tre utilis pour transformer les paramtres de contexte dun flux et les rutilisez via un composant tContextLoad. Cette fonction est trs pratique pour rutiliser un contexte que vous naurez dfini quune seule fois, dans plusieurs Jobs via le tContextLoad.. Schema type et Edit Schema Le schma du composant tContextDump est en lecture seule et est compos de deux colonnes : Key et Value, qui correspondent au nom et la valeur du paramtre copier. Un schma est une description de lignes, i.e., il dfinit les champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que lorsque vous modifiez le schma, les proprits deviennent automatiquement built-in. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Print operations Cochez cette case pour afficher les paramtres de contexte dans la vue Run.
Basic settings
Ce composant cre un flux de donnes partir des valeurs de contexte, ainsi il doit tre connect un composant de sortie. Le tContextDump ne cre pas de variable de contexte non dfinie.
Scnario associ
1424
Composants Misc
tContextLoad
tContextLoad
Proprits du tContextLoad
Fonction Objectif
Le composant tContextLoad modifie dynamiquement les valeurs du contexte actif. Le tContextLoad permet de charger un contexte partir dun flux entrant. Ce composant effectue aussi deux contrles. Il prvient lorsque les paramtres dfinis dans le flux entrant ne sont pas dfinis dans le contexte. Il avertit galement lorsque la valeur dun contexte nest pas initialise dans le flux entrant. Mais notez que ces avertissements ne bloquent pas le traitement. Schema type et Edit Schema Le schma du composant tContextLoad doit tre compos de deux colonnes, lune contenant le nom du paramtre et la deuxime contenant la valeur du paramtre charger. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, les proprits deviennent automatiquement built-in. Built-in : Le shma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. If a variable loaded, Si une variable est charge mais napparat pas but not in the context dans le contexte, choisissez comment doit safficher la notification. Sous forme derreur (Error), de warning (warning), ou dinformation (info). If a variable in the context, but not loaded Si une variable apparat dans le contexte mais nest pas charge, choisissez comment doit safficher la notification. Sous forme derreur (Error), de warning (warning), ou dinformation (info). Cochez cette case pour afficher les paramtres de contexte dans la vue Run. Cochez cette case pour ne pas afficher derreur.
Basic settings
Print operations Disable errors
1425
Composants Misc
tContextLoad
Disable warnings Disable infos Die on error
Cochez cette case pour ne pas afficher de warning. Cochez cette case pour ne pas afficher dinformation. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et les lignes contenant les erreurs seront ignores. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant sappuie sur le flux de donnes pour charger les valeurs de contexte utiliser. Ainsi, il requiert un composant dentre et ne peut pas tre un composant de dbut. Le tContextLoad ne cre aucune variable qui na pas t dfinie dans le contexte par dfaut.
Limitation
Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL
Ce scnario est compos de deux sous-Jobs. Le premier permet de charger dynamiquement des paramtres de contexte et le deuxime utilise ces paramtres chargs pour afficher le contenu dune base de donnes.
Cliquez et dposez les composants : tFilelist, tFileInputDelimited, tContextLoad pour le premier sous-Job. Et cliquez et dposez les composants tMysqlInput et tLogRow pour le deuxime. Connectez-les comme indiqu sur le schma ci-dessus. Crez autant de fichiers dlimits quil y a de contextes diffrents et conservez-les dans un rpertoire spcifique appel Contexts. Dans ce scnario, test.txt contient les informations de connexion la base de donnes locale de test et prod.txt contient les informations de connexion de la base de donnes distante de production. Chaque fichier est constitu de deux champs contenant le nom du paramtre et sa valeur correspondante, en fonction du contexte.
1426
Composants Misc
tContextLoad
Dans longlet Basic settings du composant tFileList, slectionnez le rpertoire contexts dans lequel les deux fichiers test et prod seront stocks. Dans longlet Basic settings du composant tFileInputDelimited, dans le champ File Name, appuyez sur Ctrl+Espace pour accder la liste des variables globales. Slectionnez tFileList_1.CURRENT_FILEPATH qui permet de faire une boucle sur le rpertoire contenant les fichiers de contexte. Dfinissez le schma manuellement (Built-in) en cliquant sur le bouton Edit schema. Il contient deux colonnes : Key et Value, correspondant respectivement au paramtre et sa valeur. Acceptez la propagation du schma dfini au composant suivant (tContextLoad). Pour ce scnario, cochez la case Print operations pour afficher les paramtres de contexte utiliss dans la vue Run. Puis double-cliquez sur le composant tMysqlInput pour accder ses proprits dans longet Basic settings. Pour chacune des valeurs stockes dans le fichier de contexte, appuyez sur F5 et dfinissez le paramtre de contexte devant tre dfini par lutilisateur. Par exemple, le champ Host a pour valeur de paramtre context.host, dont le nom de paramtre est host dans le fichier de contexte. Sa valeur actuelle est talend-dbms.
1427
Composants Misc
tContextLoad
Puis dans le champ Schema Type, renseignez les informations sur le schma. Si le schma est stock dans le noeud Metadata du Repository sous forme de mtadonne, slectionnez-le aprs avoir slectionn loption Repository. Dans le champ Query, saisissez la requte SQL devant tre excute sur la table spcifie. Dans ce Job, effectuez un simple SELECT des colonnes de la table, qui seront ensuite affiches dans longlet Run grce au composant tLogRow. Enfin, appuyez sur F6 pour excuter le Job.
Les paramtres de contexte et les valeurs slectionns dans la table sont affichs dans la console Run.
1428
Composants Misc
tFixedFlowInput
tFixedFlowInput
Proprits du tFixedFlowInput
Famille du composant Misc
Le composant tFixedFlowInput gnre autant de lignes et de champs que vous souhaitez alimenter par des valeurs fixes. Le tFixedFlowInput permet de gnrer des donnes fixes partir de variables internes. Schema type et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Mode Slectionnez le mode, parmi les trois proposs, que vous souhaitez utiliser. Use Single Table : Saisissez la donne que vous souhaitez gnrer dans la colonne Value correspondante. Use Inline Table : Ajoutez la ou les ligne(s) que vous souhaitez gnrer. Use Inline Content : Saisissez vos donnes gnrer, spares par les sparateurs pralablement dfinis dans les champs Row et Field Separator. Saisissez le nombre de lignes de donnes gnrer. Saisissez entre guillemets les valeurs correspondant aux colonnes dfinies dans la bote de dialogue du schma, via le bouton Edit schema.
Number of rows Values
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant peut tre utilis comme composant de dbut ou de milieu, il requiert donc un composant de sortie.
Scnarios associs
Pour des scnarios associs, consultez :
1429
Composants Misc
tFixedFlowInput
Scnario 2 : Mettre les donnes de sortie en mmoire tampon du serveur dapplication Web, page 1416. Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table, page 625.
1430
Composants Misc
tMemorizeRows
tMemorizeRows
Proprits du tMemorizeRows
Fonction
Le composant tMemorizeRows mmorise temporairement une collection de donnes entrantes en squence ligne par ligne et instancie cette collection en indexant chaque ligne mmorise partir de 0. Le nombre maximum de lignes mmoriser un moment donn est dfini dans la vue Basic settings. Le tMemorizeRows mmorise une squence de lignes passant dans ce composant et permet au(x) composant(s) suivant(s) deffectuer des oprations sur les lignes mmorises, selon vos besoins. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. - Cliquez sur Edit Schema afin dapporter des modifications au schma. Notez que, si vous modifiez le schma, il devient automatiquement Built-In. - Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Row count to memorize Columns to memorize Saisissez le nom de lignes dfinir. Slectionnez les colonnes mmoriser du schma dentre. Cochez cette case pour collecter les donnes de log au niveau du composant.
Objectif
Ce composant peut tre utilis en tant qutape intermdiaire dans un flux de donnes ou comme dernire tape avant de lancer un sous-job. Note: Vous pouvez utiliser la variable globale NB_LINE_ROWS afin de rcuprr la valeur renseigne dans le champ Row count to memorize du composant tMemorizeRows.
1431
Composants Misc
tMemorizeRows
Connections
Liens de sortie (dun composant un autre) : Row : Main. Trigger : Run if, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Main. Pour plus dinformations concernant les connexions, consultez Connection types dans le Guide Utilisateur Talend Open Studio.
Scnario : Compter le nombre doccurrences de diffrents ges

Ce scnario a pour objectif de compter le nombre dges diffrents se trouvant dans un groupe de 12 clients. Dans ce scnario, les donnes client sont gnres de manire alatoire.
Ce Job utilise les cinq composants suivants : tRowGenerator : ce composant gnre 12 lignes de donnes client contenant les IDs, noms et ges des 12 clients. tSortRow : ce composant trie les 12 lignes selon les donnes de lge. tMemorizeRows : il mmorise temporairement un nombre spcifique de lignes de donnes entrantes un moment donn et indexe les lignes de donnes mmorises. tJavaFlex : ce composant compare la valeur des ges dans les donnes mmorises par le composant prcdent, compte le nombre doccurrences des diffrents ges et affiche ces ges dans la vue Run. tJava : il affiche le nombre doccurrences des diffrents ges. Pour reproduire le scnario, procdez comme suit : Dposez les composants suivants de la Palette dans lespace de modlisation graphique : tRowGenerator, tSortRow, tMemorizeRows, tJavaFlex et tJava. Cliquez-droit sur le tRowGenerator Dans le menu contextuel, slectionnez le lien Row > Main. Cliquez sur le tSortRow afin de lier ces deux composants.
1432
Composants Misc
tMemorizeRows
Rptez lopration pour connecter le tSortRow, le tMemorizeRows et le tJavaFlex laide dun lien Row > Main. Cliquez-droit sur le tRowGenerator Dans le menu contextuel, slectionnez le lien Trigger > OnSubjobOk. Cliquez sur le tJava pour relier les composants. Double-cliquez sur le composant tRowGenerator afin douvrir son diteur.
Dans cet diteur, cliquez trois fois sur le bouton [+] pour ajouter trois colonnes, que vous nommerez : id, name, age. Dans la colonne Type, slectionnez Integer pour les colonnes id et age. Dans la colonne Length, saisissez 50 pour la colonne name. Dans la colonne Functions, slectionnez random pour id et age, puis slectionnez getFirstName pour name. Dans le champ Number of Rows for RowGenerator, saisissez 12. Dans la colonne Column, cliquez sur age afin douvrir sa vue Function parameters dans la partie infrieure de lditeur.
1433
Composants Misc
tMemorizeRows
Dans la colonne Value de la vue Function parameters, saisissez lge minimum et lge maximum gnrer pour les 12 clients. Dans cet exemple, saisissez respectivement 10 et 25. Cliquez sur OK afin de sauvegarder la configuration. Dans la bote de dialogue qui souvre, cliquez sur Yes (Oui) afin de propager les modifications aux autres composants. Double-cliquez sur le tSortRow afin douvrir sa vue Component.
Dans le tableau Criteria, cliquez sur le bouton [+] afin dajouter une ligne.
1434
Composants Misc
tMemorizeRows
Dans la colonne Schema column, slectionnez la colonne de donnes sur laquelle vous souhaitez baser le tri. Dans cet exemple, slectionnez age, puisque les ges seront compars et compts. Dans la colonne Sort num or alpha, slectionnez le type de tri. Dans cet exemple, comme age est un entier (integer), slectionnez num, pour numrique. Dans la colonne Order asc or desc, slectionnez desc comme ordre de tri. Double-cliquez sur le composant tMemorizeRows afin douvrir sa vue Component.
Dans le champ Row count to memorize, saisissez le nombre maximum de lignes mmoriser un moment donn. Puisque vous devez comparer les ges de deux clients chaque fois, saisissez 2. Ce composant mmorise deux lignes au maximum un moment donn et indexe toujours la nouvelle ligne entrante comme 0 et la ligne prcdente comme 1. Dans la colonne Memorize du tableau Columns to memorize, cochez la (les) case(s) de la (des) colonne(s) mmoriser. Dans cet exemple, cochez la case correspondant la colonne age. Double-cliquez sur le tJavaFlex afin douvrir sa vue Component.
1435
Composants Misc
tMemorizeRows
Dans la zone Start code, saisissez le code Java qui sera appel durant la phase dinitialisation. Dans cet exemple, saisissez int count=0; afin de dclarer une variable count et de lui assigner la valeur 0. Dans la zone Main code, saisissez le code Java appliquer chaque ligne du flux de donnes. Dans ce scnario, saisissez : if(age_tMemorizeRows_1[1]!=age_tMemorizeRows_1[0]) { count++; } System.out.println(age_tMemorizeRows_1[0]); Ce code compare les deux ges mmoriss chaque fois par le tMemorizeRows et compte un changement chaque fois que des ges diffrents sont trouvs. Ce code affiche galement les ges indexs comme 0 par le tMemorizeRows. Dans la zone End code, saisissez le code qui sera appel durant la phase de fermeture. Dans cet exemple, saisissez globalMap.put("count", count); afin dcrire le rsultat du compte. Double-cliquez sur le tJava afin douvrir sa vue Component.
1436
Composants Misc
tMemorizeRows
Dans la zone Code, saisissez le code System.out.println("Different ages : "+globalMap.get("count")); afin de rcuprer le rsultat du compte. Appuyez sur F6 afin dexcuter le Job. Le rsultat saffiche dans la console de la vue Run.
Dans la console, vous pouvez constater quil y a dix ges diffrents dans le groupe des 12 clients.
1437
Composants Misc
tMsgBox
tMsgBox
Proprits du tMsgBox
Le composant tMsgBox ouvre une bote de dialogue contenant un bouton OK, ncessitant une action de la part de lutilisateur. Ce composant est une pause graphique dans le cours du traitement. Title Buttons Le texte saisi saffiche dans la barre de titre de la bote de dialogue. Liste des boutons que vous souhaitez inclure dans la bote de dialogue. Les combinaisons de bouton sont restreintes et ne peuvent tre changes. Icne de la barre de titre de la bote de dialogue. Texte libre afficher dans la bote de dialogue. Le texte peut tre dynamique (ex : reprendre un nom de fichier).
Icon Message
Utilisation
Ce composant peut tre utilis comme tape intermdiaire du traitement ou comme composant de dbut ou de fin de Job. Il peut tre connect laide dun lien Row ou Iterate. Si vous utilisez Perl, assurez-vous que le package adquat est install sur votre ordinateur.
Limitation
Scnario : Test de type Hello world!

Le scnario suivant reprsente un Job un seul composant utilis pour afficher lheure et la date la place du message Hello World!. Cliquez et dposez un composant tMsgBox dans lespace de modlisation. Paramtrez les proprits daffichage du message :
Title est le titre de la bote de message, vous pouvez utiliser nimporte quelle variable.
1438
Composants Misc
tMsgBox
Dans le champ Message, saisissez le texte "Current date is: " entre guillemets doubles concatn laide dun +, puis appuyez sur Ctrl+Espace afin dafficher la liste dauto-compltion, et slectionnez la routine systme TalendDate.getCurrentDate. Entourez-la de parenthses. Cliquez sur longlet Run puis excutez le Job. Le message affiche le texte dfini prcdemment et requiert une action de lutilisateur pour disparatre et passer au composant suivant ou terminer le Job.
Aprs avoir cliqu sur le bouton OK, le log de la vue Run est mis jour. Voir galement : Excution dun job du Guide utilisateur de Talend Open Studio.
1439
Composants Misc
tRowGenerator
tRowGenerator
Proprits du tRowGenerator
Fonction
Le composant tRowGenerator gnre autant de lignes et de champs que vous souhaitez alimenter par des valeurs prises de faon alatoire dans une liste dfinie. Ce composant peut tre utilis des fins de test, pour crer un flux dentre dans le cadre de jeux de tests. Schema type et Un schma est une description de lignes, i.e., il Edit Schema dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Objectif
Basic settings
RowGenerato r editor
Lditeur vous permet de dfinir prcisment les colonnes et la nature des donnes gnrer. Vous pouvez prdfinir des routines ou saisir vous-mme la fonction utiliser pour gnrer les donnes souhaites. Cochez cette case pour collecter les donnes de log au niveau du composant.
La simplicit dutilisation de lditeur du tRowGenerator vous permet de gnrer des donnes de faon alatoire sans connaissance des langages Perl et Java. n/a
Limitation
Lditeur du tRowGenerator souvre dans une fentre spare constitue de deux parties : dans la partie suprieure de la fentre, une vue de dfinition de Schema, dans la partie infrieure, une vue Function de dfinition et daperu des fonctions.
Dfinition du schma
Pour commencer, vous devez dfinir la structure des donnes gnrer. Ajoutez autant de colonnes que ncessaire laide du bouton plus [+]. Dans la zone Columns, saisissez les noms des colonnes crer et cochez la case Key si ncessaire.
Composants Misc
tRowGenerator
Assurez-vous davoir correctement dfini la nature des donnes contenues dans la colonne en slectionnant le type dans la colonne Type. En fonction du type slectionn, la liste des fonctions proposes dans la colonne Function diffre. Cette information est obligatoire.
Dautres informations, bien que facultatives, peuvent tre utiles, telles que les colonnes Length, Precision ou Comment. Mais vous avez la possibilit de cacher les colonnes que vous nutilisez pas, en cliquant sur le bouton Columns dans la barre doutils et en dcochant les colonnes que vous souhaitez cacher. Dans la zone Function, slectionnez la routine/fonction prdfinie si lune des propositions correspond vos besoins. Vous pouvez galement ajouter cette liste toute routine que vous avez dveloppe et stocke dans la partie Routine du Repository. Vous avez enfin la possiblit de saisir directement la fonction que vous souhaitez utiliser dans la vue Function. Voir galement : Dfinition dune fonction, page 1441. Cliquez sur Refresh pour visualiser un aperu des donnes gnres. Saisissez le nombre de lignes gnrer. Plus le nombre de lignes est lev, plus la dure dexcution sera longue pour cette opration de gnration.
La liste des fonctions propose diffre selon la langue de votre projet (Perl ou Java).
Dfinition dune fonction

Vous avez slectionn les trois points [...] dans la colonne Function de lditeur du Schma, car vous souhaitez personnaliser la fonction de gnration. Slectionnez longlet Function parameters. La zone Parameter affiche Customized parameter comme nom du paramtre (en lecture seule).
1441
Composants Misc
tRowGenerator
Dans la zone Value, saisissez la fonction Perl ou Java que vous souhaitez utiliser pour gnrer des donnes. Cliquez sur longlet Preview et cliquez sur le bouton Preview pour visualiser un chantillon des donnes qui seront gnres.
Scnario : Gnration alatoire de fichiers de test

Le scnario suivant dcrit un Job de deux composants, gnrant 50 lignes composes de la manire suivante : un ID alatoire compris entre 1 et 3, un nom et un prnom pris de manire alatoire dans une liste de chanes de caractres, et le champ Date dfinie dans une priode donne.
Cliquez et dposez un composant tRowGenerator et un composant tLogRow dans lespace de modlisation. Cliquez-droit sur le composant tRowGenerator et slectionnez le lien Row > Main. Faites glisser ce lien jusquau composant tLogRow. Double-cliquez sur le composant tRowGenerator pour ouvrir lditeur. Dfinissez les champs gnrer.
La colonne ID (random_ID) est de type entier (integer), les noms et prnoms sont de type chane de caractres (String) et la Date est de type Date. Dans la colonne Function, slectionnez la fonction adapte dans la liste ou les trois points [...] pour la fonction personnalise. Dans longlet Function parameters, dfinissez les valeurs prendre de faon alatoire.
Les colonnes First_Name et Last_Name sont gnrer laide dune fonction getAsciiRandomString prdfinie dans les routines systme. Par dfaut, la longueur dfinie est de 6 caractres, mais vous pouvez la changer.
1442
Composants Misc
tRowGenerator
La colonne Date appelle galement une fonction prdfinie getRandomDate. Vous pouvez diter les valeurs de paramtre dans longlet Function parameters. Dans le champ Number of Rows, paramtrez le nombre de lignes 50. Cliquez sur OK pour valider les paramtres. Double-cliquez sur le composant tLogRow pour visualiser les paramtres dans longlet Basic settings. Retenez les paramtres par dfaut. Appuyez sur F6 pour excuter le Job.
Les 50 lignes sont gnres selon les paramtres dfinis dans lditeur du composant tRowGenerator et sont affiches en sortie standard de la vue Run.
1443
Composants Misc
tRowGenerator
1444
Composants Orchestration
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Orchestration de la Palette de Talend Open Studio. La famille Orchestration regroupe les composants vous permettant de squencer et dorchestrer les tches ou les traitements de vos Jobs et sous-Jobs.
tFileList
tFileList
Le tFileList appartient deux familles : File et Orchestration. Pour plus dinformations concernant le composant tFileList, consultez tFileList page 1193..
1446
tFlowToIterate
tFlowToIterate
Proprits du tFlowToIterate
Famille du composant Orchestration
Le composant tFlowToIterate transforme un flux de donnes en une liste. Le tFlowToIterate permet de transformer un flux traitable en donnes non traitables. Use the default (key, value) in global variables Customize Lorsque cette case est coche, le systme utilise la valeur par dfaut de la variable gobale utilise dans le Job. key : Entrez le nom de la nouvelle variable globale. Appuyez sur Ctrl+Espace pour accder lensemble des variables disponibles, quelles soient globales ou dfinies par lutilisateur. value : Cliquez dans la cellule pour accder la liste des colonnes rattaches la variable globale dfinie.
Le tFlowToIterate nest pas un composant de dbut, et il requiert un composant de sortie. Number of Lines : indique le nombre de lignes traites. Disponible comme variable After. Retourne un entier. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Row : Iterate. Trigger : Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Main. Pour plus dinformations concernant les liens, consultez Types de connexions, dans le Guide Utilisateur Talend Open Studio.
Scnario : Transformer un flux de donnes en liste

Le scnario suivant dcrit un Job permettant de lire une liste de fichiers partir dun fichier dentre donn. Il effectue galement une itration sur chacun des fichiers, slectionne les donnes dentre et affiche le rsultat en sortie dans la console de log Run.
tFlowToIterate
A partir de la Palette, cliquez-dposez les composants suivants dans lespace de modlisation : deux tFileInputDelimited, un tFlowToIterate et un tLogRow. Cliquez-droit sur chacun des composants pour les relier entre eux. Connectez le premier tFileInputDelimited au tFlowToIterate laide dun lien de type Row Main, puis le tFlowToIterate au deuxime tFileInputDelimited laide dun lien de type Iterate, enfin le second tFileInputDelimited au tLogRow laide dun lien de type Row Main.
Dans lespace graphique, slectionnez le premier tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du composant tFileInputDelimited. Dans la vue Basic settings, cliquez sur le bouton [...] situ ct du champ File Name pour dterminer le chemin daccs au fichier dentre.
Le champ File Name est obligatoire.
Le fichier dentre utilis dans ce scnario sappelle Customers. Il sagit dun fichier texte contenant trois autres fichiers texte simples : Name, E-mail et Address. Le fichier Name est constitu dune colonne contenant le nom des clients et le fichier E-mail dune colonne contenant ladresse email de ces clients. Le troisime fichier texte, Address, est compos dune colonne comprenant ladresse postale des clients. Renseignez les autres champs en fonction de votre fichier. Pour plus dinformations sur le tFileInputDelimited, consultez les Proprits du tFileInputDelimited, page 1136. Dans ce scnario, len-tte, le pied de page et le nombre limite de lignes traiter ne sont pas dfinis. Donc, laissez les champs Header (en-tte) et Footer (pied de page) et Limit par dfaut. Cliquez sur le bouton Edit schema pour dcrire la structure des donnes du fichier dentre. Dans ce scnario, le schma comporte une seule colonne appele FileName.
1448
tFlowToIterate
Dans lespace graphique, slectionnez le tFlowToIterate. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du composant tFlowToIterate.
Cochez la case Use the default (key, value) in global variables si besoin. Cette option permet dutiliser la valeur par dfaut de la variable globale. Cliquez sur le bouton [+] pour ajouter une ligne de paramtres puis dfinissez vos variables. Cliquez dans la cellule de la colonne key pour modifier le nom de la variable selon vos dsirs.
Vous pouvez appuyer sur Ctrl+Espace partir de la cellule de la colonne key pour accder la liste des variables globales et des variables utilisateur.
Dans lespace graphique, slectionnez le second composant tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) de ce second tFileInputDelimited.
1449
tFlowToIterate
Dans le champ File Name, renseignez le nom du fichier en utilisant la variable approprie. Vous devez utiliser la syntaxe correspondant au langage employ (Perl ou Java). En Perl, la syntaxe exacte est .$_globals{tFlowToIterate}{Name_of_File}. En Java, la syntaxe correcte est +globalMap.get(file). Remplissez les autres champs selon vos besoins. Pour plus dinformations, consultez les Proprits du tFileInputDelimited, page 1136. Dans lespace graphique, slectionnez le dernier composant, le tLogRow. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tLogRow.
Dfinissez les paramtres selon vos besoins. Pour plus dinformations, consultez Proprits du tLogRow, page 1399. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
1450
tFlowToIterate
La console affiche, pour chaque ligne, le nom du client, son e-mail et son adresse, prcds du nom de la colonne du schma.
1451
tForeach
tForeach
Proprits du tForeach
Famille de composant Orchestration
Le composant tForeach cre une boucle sur une liste pour un lien Iterate. Le tForeach vous permet de crer une boucle sur une liste pour un lien Iterate. Values Utilisez le bouton [+] pour ajouter des lignes au tableau Values. Cliquez ensuite sur les champs afin de saisir, entre guillemets, les valeurs de la liste sur laquelle effectuer une boucle. Cochez cette case pour collecter les donnes de log au niveau du composant.
Le tForeach est un composant dentre. Un lien Iterate est requis pour relier ce composant un autre. n/a
Scnario : Faire une boucle sur une liste et rcuprer les valeurs
Ce scnario dcrit un Job deux composants dans lequel une liste est cre et sur laquelle est effectue une boucle, via un composant tForeach. Les valeurs sont rcupres par un composant tJava. Dposez de la Palette dans lespace de modlisation graphique les composants tForeach et tJava.
Reliez le tForeach au tJava laide dun lien Row > Iterate. Double-cliquez sur le tForeach afin douvrir sa vue Basic settings.
1452
tForeach
Cliquez sur le bouton Values.
pour ajouter autant de lignes que ncessaire dans le tableau
Cliquez sur les champs Value afin de saisir les valeurs de la liste, entre guillemets doubles. Double-cliquez sur le tJava afin douvrir sa vue Basic settings.
Saisissez le code Java suivant dans la zone Code : System.out.println(globalMap.get("tForeach_1_CURRENT_VALUE") +"_out"); Sauvegardez le Job et appuyez sur F6 pour lexcuter. La console affiche la liste des valeurs rcupres du tForeach, chaque valeur ayant le suffixe _out.
1453
tForeach
1454
tInfiniteLoop
tInfiniteLoop
Proprits du tInfiniteLoop
Le composant tInfiniteLoop fait une boucle linfini sur lexcution dune tche. Le tInfiniteLoop permet dexcuter automatiquement une tche ou un Job dans une boucle, linfini. Wait at each iteration (in millisecondes) tStatCatcher Statistics Saisissez le temps, en millisecondes, dattente entre chaque itration. Cochez cette case pour collecter les donnes de log au niveau du composant.
Le composant tInifniteLoop est un composant de dbut et requiert une connexion de type Iterate au composant suivant. Current iteration : indique le nombre ditrations. Disponible comme variable Flow. Retourne un entier. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Row : Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Main. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Scnario associ
Pour un exemple dutilisation proche, consultez le Scnario : Excuter un Job partir dune boucle, page 1460 du composant tLoop.
1455
tIterateToFlow
tIterateToFlow
Proprits du tIterateToFlow
Le composant tIterateToFlow transforme une liste en flux de donnes pouvant tre trait. Ce composant permet de transformer des donnes non traitables en flux traitable. Schema type et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Lors de lutilisation du tIterateToFlow, le schma doit tre dfini. Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Mapping Column :Saisissez le nom des colonnes crer. Value : Appuyez sur Ctrl+Espace pour accder toutes les variables disponibles soit globales soit celles que vous avez dfinies. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant nest pas un composant de dbut (fond vert) et requiert un composant de sortie. Liens de sortie (dun composant un autre) : Row : Main. Trigger : Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Iterate. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
1456
tIterateToFlow
Scnario : Transformer une liste de fichiers en flux de donnes

Le scnario suivant dcrit un Job permettant de faire une boucle sur une liste de fichiers, de rcuprer leur nom, ainsi que la date en cours, pour ensuite transformer ces donnes en un flux qui sera affich dans la console.
Cliquez et dposez les composants suivants : tFileList, tIterateToFlow et tLogRow. Connectez le tFileList au tIterateToFlow laide dun lien Iterate et connectez le Job au composant tLogRow laide dun lien Row main. Dans la vue Component du composant tFileList, donnez le chemin daccs au rpertoire contenant la liste de fichiers.
Dans cet exemple, les fichiers sont trois fichiers .txt simples stocks dans le rpertoire Countries. Dans la liste Case sensitive, slectionnez No (Non) pour ne pas tenir compte de la casse. Slectionnez le composant tIterateToFlow et cliquez sur Edit Schema pour modifier le nouveau schma.
Ajoutez deux nouvelles colonnes : Filename de type String et Date de type date. Assurez-vous davoir paramtr le bon modle en Java. Cliquez sur OK pour valider.
1457
tIterateToFlow
Une bote de dialogue souvre et vous demande si vous souhaitez propager les changements. Cliquez sur Yes (Oui). Notez que ce nouveau schma apparat dans le tableau Mapping.
Dans chaque cellule de la colonne Value, appuyez sur Ctrl+Espace pour accder la liste des variables globales et celles que vous avez dfinies. Pour la colonne Filename, utilisez la variable globale : tFileList_1CURRENT_FILEPATH. Elle reprend le chemin daccs courant pour recueillir le nom de chaque fichier, le Job fait une boucle sur ce rpertoire. Pour le colonne Date, utilisez la routine Talend : Date.GetDate (en Perl) ou TalendDate.getCurrentDate() (en Java) Puis dans la vue Component du composant tLogRow, cochez la case Print values in cells of a table. Enregistrez votre Job et excutez-le, en appuyant sur F6.
Le chemin daccs apparat dans la colonne Filename et la date en cours apparat dans la colonne Date.
1458
tLoop
tLoop
Proprits du tLoop
Le composant tLoop fait une boucle sur lexcution dune tche. Le tLoop permet dexcuter automatiquement une tche ou un Job dans une boucle. Loop Type Slectionnez le type de boucle effectuer : For ou While. For : La tche ou le Job est excut(e) pour le nombre de boucle dfini. While : La tche ou le Job est excut(e) jusqu ce que la condition soit rencontre. Saisissez le numro de la premire instance sur laquelle la boucle doit commencer. Si vous slectionnez linstance numro 2 comme instance de dpart et que vous prenez un cart de 2, cela signifie que la boucle se fera sur tous les nombres pairs. Saisissez la dernire instance sur laquelle la boucle doit passer. Saisissez lcart entre deux instances avec lequel la boucle doit seffectuer. Un cart de 2 signifie que la boucle passe toutes les deux instances. Saisissez une expression dclenchant la boucle. Saisissez la condition devant tre rencontre pour que la boucle sarrte. Saisissez lexpression dcrivant lopration effectuer chaque boucle. Cochez cette case pour collecter les donnes de log au niveau du composant.
For
From
To Step
While
Declaration Condition Iteration
Le composant tLoop est un composant de dbut et requiert une connexion de type Iterate au composant suivant. Current value : indique la valeur actuelle. Disponible comme variable Flow. Retourne un entier. Current iteration : indique le nombre ditrations. Disponible comme variable Flow. Retourne un entier. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
1459
tLoop
Connections
Liens de sortie (dun composant un autre) : Row : Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Scnario : Excuter un Job partir dune boucle

Ce scnario dcrit un Job constitu dun Job parent et dun Job enfant. Le Job parent excute une boucle qui permet dexcuter un Job enfant n nombre de fois, avec une pause entre chaque excution.
Dans le Job parent, cliquez et dposez les composants tLoop, tRunJob et tSleep dans lespace de modlisation. Connectez le composant tLoop au tRunJob laide dune connexion de type Iterate. Puis connectez le tRunJob au tSleep laide dune connexion de type Row. Dans le Job enfant, cliquez et dposez les composants suivants : tPOP, tFileInputMail et tLogRow. Dans longlet Basic settings du composant tLoop, saisissez le numro de linstance sur lequel commencer (1), le numro de linstance sur lequel finir (5) et lcart utiliser (1).
1460
tLoop
Dans longlet Basic settings du composant tRunJob, slectionnez le Job enfant dans la liste des Jobs proposs, pour cet exemple : popinputmail. Slectionnez le contexte, si ncessaire. Pour cet exemple, le contexte est celui par dfaut (default) ne contenant aucune variable. Dans longlet Basic settings du composant tSleep, saisissez la dure de la pause en secondes dans le champ Pause. Pour cet exemple, la pause est de 3 seconds. Dans longlet Basic settings du Job enfant, dfinissez les paramtres de connexion au serveur pop. Dans longlet Basic settings du composant tFileInputMail, slectionnez une variable globale dans le champ File Name, pour collecter le fichier courant dans le rpertoire dfini dans le composant tPOP. Appuyez sur Ctrl+Espace pour accder la liste des variables. Pour cet exemple, la variable utiliser est : $_globals{tPOP_1}{CURRENT_FILEPATH} (pour Perl) ((String)globalMap.get("tPOP_1_CURRENT_FILEPATH")) (pour Java) Dfinissez le Schema pour quil inclue llment du mail traiter. Les champs du schma sont les suivants : author, topic, delivery date et number of lines. Dans la colonne Mail part de la table Mail Parts, saisissez le champ de le-mail correspondant chaque colonne dfinie dans le schma. Par exemple : author provient du champ From du fichier e-mail. Puis connectez les composants tFileInputMail et tLogRow. Appuyez sur F6 pour excuter le Job, et vrifiez les rsultats de lexcution dans la vue Run.
1461
tPostjob
tPostjob
Proprits du tPostjob
Fonction Objectif Utilisation Connections
Le composant tPostjob dmarre lexcution dun post-job. Le tPostjob dclenche une action requise aprs lexcution dun Job. Le tPostjob est un composant de dbut. Il ne peut tre reli au composant suivant quavec une connexion de type Iterate. Liens de sortie (dun composant un autre) : Trigger : OnComponentOk. Liens dentre (dun composant un autre) : Trigger : Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Pour plus dinformations sur le composant tPostjob, consultez la section Utiliser les composants tPrejob et tPostjob du Guide Utilisateur de Talend Open Studio.
Scnario associ
1462
tPrejob
tPrejob
Proprits du tPrejob
Fonction Objectif Utilisation Connections
Le composant tPrejob dmarre lexcution dun pr-job. Le tPrejob dclenche une action requise pour lexcution dun Job. Le tPrejob est un composant de dbut. Il ne peut tre reli au composant suivant quavec une connexion de type Iterate. Liens de sortie (dun composant un autre) : Trigger : OnComponentOk. Liens dentre (dun composant un autre) : Trigger : Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Pour plus dinformations sur le composant tPrejob, consultez la section Utiliser les composants tPrejob et tPostjob du Guide Utilisateur de Talend Open Studio.
Scnario associ
1463
tReplicate
tReplicate
Proprits du tReplicate
Le composant tReplicate duplique le schma entrant en deux flux identiques. Ce composant permet deffectuer diffrentes oprations sur le mme schma. Schema type et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository: Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Ce composant nest pas un composant de dbut (fond vert) puisquil requiert un composant dentre et un composant de sortie. Liens de sortie (dun composant un autre) : Row : Main Trigger : Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row :Main, Reject. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Scnario associ
Pour un exemple dutilisation du tReplicate, consultez le tReplaceList, page 314
1464
tRunJob
tRunJob
Le tRunJob appartient deux familles : Orchestration et System. Pour plus dinformations concernant le composant tRunJob, consultez tRunJob, page 1596.
1465
tUnite
tUnite
Proprits du tUnite
Le composant tUnite fusionne des donnes de diverses sources, bases sur un mme schma. Ce composant centralise des donnes provenant de sources diverses et htrognes. Schema type et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio.
Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant nest pas un composant de dbut; il requiert un ou plusieurs composants en entre et un composant de sortie. Number of lines : indique le nombre de lignes traites. Disponible comme variable After. Retourne un entier. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Row : Main. Trigger : Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Main, Reject. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
1466
tUnite
Scnario : Itration sur des fichiers et fusion de contenu

Le Job suivant effectue une itration sur une liste de fichiers puis fusionne leur contenu et affiche le contenu final des deux colonnes dans la console.
Cliquez et dposez les composants suivants dans lespace de modlisation : tFileList, tFileInputDelimited, tUnite et tLogRow. Connectez le composant tFileList au tFileInputDelimited laide dun lien Iterate et connectez les autres composants laide de liens Row main. Dans longlet Basic settings du composant tFileList, slectionnez le rpertoire dans lequel les fichiers fusionner sont stocks.
Dans la liste Case Sensitive, slectionnez Yes (Oui) si vous souhaitez tenir compte de la casse, ou No (Non) si vous ne vous voulez pas la prendre en compte. Pour cet exemple, slectionnez Yes. Les fichiers sont trs basiques et contiennent une liste de pays et leur score respectif.
1467
tUnite
Slectionnez le composant tFileInputDelimited et affichez son onglet Basic settings. Dans cet exemple, les paramtres de connexion des fichiers dentre ne sont pas stocks dans les mtadonnes du Repository. Ainsi, slectionnez loption Built-In dans le champ Property type et paramtrez les proprits manuellement.
Pour renseigner le champ File Name, appuyez sur Ctrl+Espace pour accder la liste des variables. Pour traiter tous les fichiers du rpertoire dfini dans le composant tFileList, slectionnez tFileList.CURRENT_FILEPATH dans la liste des variables globales. Conservez les paramtres par dfaut des champs Row et Field separators, ainsi que des autres champs. Cliquez sur le bouton Edit Schema et dfinissez manuellement le schma deux colonnes pour quil corresponde au contenu des fichiers dentre.
Pour cet exemple, les deux colonnes sont Country et Points. Elles peuvent toutes les deux prendre une valeur nulle, ainsi cochez les cases de la colonne Nullable. La colonne Country sera de type String, et la colonne Points sera de type Integer.
1468
tUnite
Cliquez sur OK pour valider les paramtres, puis acceptez la propagation du schma dans le reste du Job. Puis slectionnez le composant tUnite et affichez la vue Component. Notez que le schma de sortie reflte exactement celui dentre et quil est en lecture seule. Dans la vue Component du composant tLogRow, cochez la case Print values in cells of the table pour afficher correctement les valeurs de sortie. Enregistrez le Job et excutez-le.
La console affiche les donnes des diffrents fichiers, fusionnes dans une seule table.
1469
tSleep
tSleep
Proprits du tSleep
Fonction Objectif
Le composant tSleep effectue une pause lors de lexcution dun Job. Ce composant permet didentifier les goulots dtranglement ventuels laide dune pause lors de lexcution du Job des fins de test ou de monitoring. En production, il peut tre utilis pour tout type de pause dans le traitement dun Job, pour alimenter un flux entrant par exemple. Pause (in second) Temps en seconde pendant lequel le Job est suspendu.
Basic settings Utilisation Connections
Le composant tSleep est gnralement utilis comme composant intermdiaire mettant un Job en pause, avant de le reprendre. Liens de sortie (dun composant un autre) : Row : Main, Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Main, Reject, Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Scnario associ
Pour un exemple dutilisation du tSleep, consultez le Scnario : Excuter un Job partir dune boucle, page 1460.
1470
tWaitForFile
tWaitForFile
Proprits du tWaitForFile
Fonction
Le composant tWaitForFile fait une boucle sur un rpertoire donn la recherche dajout ou de suppression de fichier puis dclenche un sous-Job lorsque la condition est rencontre. Ce composant permet de dclencher un Job en fonction dune condition lie la prsence ou au retrait dun fichier. Wait at each iteration (in seconds) Max. iterations (infinite if empty) Directory to scan File mask Include subdirectories Case sensitive Include present file Trigger action when Paramtrez lintervalle de temps entre chaque boucle. Nombre de vrifications effectuer avant que le Job ne sarrte. Nom du rpertoire vrifier. Masque du fichier recherch. Cochez cette case pour inclure les sous-dossiers. Cochez cette case pour tenir compte de la casse. Cochez cette case pour inclure le fichier courant. Slectionnez la condition remplir pour effectuer laction : A file is created : un fichier est cr. A file is deleted : un fichier est supprim. A file is updated : un fichier est mis jour A file is created or updated or deleted : un fichier est cr, supprim ou mis jour. Slectionnez laction effectuer : soit stopper litration lorsque la condition est rencontre (exit loop) soit continuer la boucle jusqu ce que le nombre maximum ditrations soit atteint (continue loop). Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Composants Talend Open Studio 1471
Then
Schema type et Edit Schema
tWaitForFile
Wait for file to be released
Cochez cette case pour empcher lexcution du Job si votre fichier est ouvert.
Ce composant est un composant de dbut (ou de dclenchement) pour le sous-Job excut en fonction de la condition tablie. Ainsi, ce composant doit tre connect un sous-job via un lien Iterate. Current iteration : indique le nombre ditrations. Disponible comme variable Flow. Retourne un entier. Present File : indique le nom du fichier courant dans litration ayant activ le dclenchement. Disponible comme variable Flow. Retourne une chane de caractres. Deleted File : indique le nom et le chemin daccs du fichier supprim qui a activ le dclenchement. Disponible comme variable Flow. Retourne une chane de caractres. Created File Name : indique le nom et le chemin daccs du fichier nouvellement cr ayant activ le dclenchement. Disponible comme variable Flow. Retourne une chane de caractres. Updated File : indique le nom et le chemin daccs du fichier mis jour, activant ainsi le dclenchement. Disponible comme variable Flow. Retourne une chane de caractres. File Name : indique le nom dun fichier cr, supprim ou mis jour, activant ainsi le dclenchement. Disponible comme variable Flow. Retourne une chane de caractres. Not Updated File Name : indique les noms des fichiers nayant pas t mis jour, activant ainsi le dclenchement. Disponible comme variable Flow. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Global Variables
1472
tWaitForFile
Connections
Liens de sortie (dun composant un autre) : Row : Main, Iterate. Trigger : OnSubjobOk, Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Iterate. Trigger : OnSubjobOk, Run if, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Scnario : Attendre la suppression dun fichier

Ce scnario dcrit un Job permettant de scanner un rpertoire la recherche dun fichier qui sera supprim de ce rpertoire, pour ensuite lancer un sous-Job. Ainsi, lorsquun fichier est supprim, le sous-Job affiche un message indiquant cette suppression.
Ce Job est constitu de deux composants : le tWaitForFile et le tMsgbox. Cliquez et dposez ces composants dans lespace de modlisation et connectez-les laide dun lien Iterate pour effectuer la boucle. Puis slectionnez le composant tWaitForFile, et dans longlet Basic settings de la vue Component, paramtrez les proprits de la condition et de la boucle :
1473
tWaitForFile
Dans le champ Time (in seconds) between iterations, paramtrez la dure en secondes entre chaque itration. Dans cet exemple, le rpertoire sera scann toutes les 5 secondes. Dans le champ Max. number of iterations (infinite loop if empty), saisissez le nombre ditration effectuer avant que le Job ne soit arrt. Dans cet exemple, le rpertoire est scann 5 fois maximum. Dans le champ Directory to scan, renseignez le chemin daccs au rpertoire devant tre scann. Dans le champ Trigger action when, slectionnez la condition rencontrer pour que le sous-Job soit lanc. Dans cet exemple, la condition est la suppression (ou le dplacement) dun fichier du rpertoire. Dans le champ Then, slectionnez laction effectuer lorsque la condition est rencontre avant que le nombre ditrations dfini ne soit atteint. Dans cet exemple, la boucle sarrte ds que la condition est rencontre. Puis dfinissez le sous-Job effectuer lorsque la condition est rencontre. Dans cet exemple, le sous-Job affiche une bote de dialogue. Slectionnez le composant tMsgBox, et dans longlet Basic settings de la vue Component, saisissez le message afficher. Dans les champs Title et Message, renseignez le titre et le message. Dans les champs Buttons et Icon, renseignez le type de boutons et dicnes utiliser.
Dans le champ Message, vous pouvez saisir nimporte quel type de message que vous souhaitez faire apparatre et utiliser des variables globales disponibles dans la liste dauto-compltion via le raccourci Ctrl+Espace. Par exemple, en Perl, le message utilis pour ce Job est : "Deleted File: $_globals{tWaitForFile_1}{DELETED_FILE}, on Iteration : $_globals{tWaitForFile_1}{CURRENT_ITERATION}\n" Le message en Java est : "Deleted file: "+((String)globalMap.get("tWaitForFile_1_DELETED_FILE"))+" on iteration Nr:"+((Integer)globalMap.get("tWaitForFile_1_CURRENT_ITERATI ON"))
1474
tWaitForFile
Excutez le Job via la raccourci F6. Pendant que la boucle seffectue, supprimez un fichier du rpertoire dfini et la bote de dialogue contenant le message dfini apparat.
1475
tWaitForSocket
tWaitForSocket
Proprits du tWaitForSocket
Fonction
Le composant tWaitForSocket fait une boucle sur un port dfini la recherche de donnes puis dclenche un sous-job lorsque la condition est rencontre. Ce composant permet de dclencher un Job en fonction dune condition dfinie. Port End of line separator Then Saisissez le numro du port couter. Saisissez le sparateur de fin de ligne de vos donnes. Slectionnez laction effectuer : soit continuer couter le port (keep on listening) soit fermer la connexion (close socket). Cochez cette case afin dafficher les donnes client ou serveur. Cochez cette case pour collecter les donnes de log au niveau du composant.
Print client/server data Advanced settings Utilisation tStatCatcher Statistics
Ce composant est un composant de dbut (ou de dclenchement) pour le sous-Job excut en fonction de la condition tablie. Ainsi, ce composant doit tre connect un sous-job via un lien Iterate. Client input data : retourne les donnes transmises par le client. Disponible comme variable Flow. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Global Variables
Connections
Liens de sortie (dun composant un autre) : Row : Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
1476
tWaitForSocket
Scnario associ
1477
tWaitForSqlData
tWaitForSqlData
Proprit du tWaitForSqlData
Fonction
Le composant tWaitForSqlData effectue une boucle sur une connexion donne la recherche dun ajout ou dune suppression de lignes, puis dclenche un sous-Job lorsque la condition est rencontre. Ce composant permet de dclencher un sous-Job en fonction de la prsence de donnes sql. Wait at each iteration (in seconds) Max. iterations (infinite loop if empty) Paramtrez en secondes lintervalle de temps entre chaque vrification. Nombre de vrifications effectuer avant que le Job ne sarrte (si vous ne saisissez rien, la boucle sera infinie).
Use an existing Cochez la case et cliquez sur le composant de connection/Compon connexion adquat dans la liste Component list ent List pour rutiliser les informations de connexion que vous avez dj dfinies. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afinde paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Table to scan Nom de la table vrifier.
1478
tWaitForSqlData
Trigger action when rowcount is
Slectionnez la condition rencontrer pour excuter laction : Equal to : gal Not Equal to : diffrent de Greater than : suprieur Lower than : infrieur Greater or equal to : suprieur ou gal Lower or equal to :infrieur ou gal . Dfinissez la valeur prendre en compte. Slectionnez laction effectuer lorsque la condition est rencontre : soit arrter la boucle (exit loop), soit continuer la boucle jusqu ce que le nombre ditration maximum soit atteint (continue loop).
Value Then
Utilisation
Bien que ce composant ait besoin dun composant de connexion pour ouvrir laccs une base de donnes, il joue aussi le rle de composant de dbut (ou de dclenchement) pour le sous-Job excuter lorsque la condition est rencontre. Ainsi, ce composant doit tre connect un sous-Job via un lien Iterate. Current iteration : indique le nombre ditrations. Disponible comme variable Flow. Retourne un entier. Row count : indique le nombre denregistrements dtects dans la table. Disponible comme variable Flow. Retourne un entier. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Global Variables
Limitation
n/a
Scnario : Attendre lajout de lignes dans une table

Ce scnario dcrit un Job lisant la table dune base de donnes dans lattente dun ajout de donnes dans cette table, pour ensuite excuter un sous-Job. Lorsque des donnes sont ajoutes, le sous-Job effectue un Select* sur la table et affiche le contenu des donnes insres dans la console standard. Cet exemple est prsent en Perl, mais les paramtres sont les mmes si vous souhaitez leffectuer en Java.
Cliquez et dposez les composants suivants de la Palette dans lespace de modlisation : tMysqlConnection, tWaitForSqlData, tMysqlInput, tLogRow.
1479
tWaitForSqlData
Connectez le composant tMysqlConnection au composant tWaitforSqlData laide un lien OnSubJobOK, disponible via le clic-droit. Puis connectez le composant tWaitForSqlData au sous-Job laide dun lien Iterate puisquaucune donne nest transfre pour le moment. En effet, le tWaitForSqlData effectue seulement des boucles jusqu ce que la condition soit rencontre. Dans le sous-Job excuter si la condition est rencontre, le composant tMysqlInput est connect au tLogRow. Puisque cette connexion sert transfrer des donnes, utilisez un lien de type Row main. Maintenant, paramtrez la connexion la table devant tre vrife intervalles rguliers. Dans longlet Basic Settings de la vue Component du composant tMySqlConnection, paramtrez les proprits de connexion la base de donnes.
Renseignez les champs Host, Port, Database, Username, Password pour ouvrir une connexion la base de donnes. Pour plus dinformations, consultez les composants de connexion aux bases de donnes. Par exemple, pour une base de donnes Mysql, consultez tMysqlConnection page 630. Dans le champ Encoding, slectionnez lencodage adquat, si ncessaire. Puis slectionnez le composant tWaitForSqlData, et dans longlet Basic Settings de la vue Component, paramtrez ses proprits. Dans le champ Wait at each iteration, paramtrez en secondes lintervalle entre chaque itration.
Dans le champ Max iterations, saisissez le nombre ditrations maximum effectuer avant que le Job ne sarrte. Pour utiliser le composant tWaitForSqlData, il faut quune connexion soit ouverte pour effectuer le nombre de boucles dfini. Slectionnez la connexion adquate (sil y en a plusieurs) dans la liste droulante Component List.
1480
tWaitForSqlData
Dans le champ Table to scan, saisissez le nom de la table scanner. Dans cet exemple : test_datatypes. Dans les champs Trigger action when rowcount is et Value, slectionnez la condition rencontrer afin de lancer le sous-Job. Pour cet exemple, le nombre de lignes prendre en compte dans la table scanne soit tre suprieur ou gal 1, ainsi slectionnez be greater or equal to 1. Dans le champ Then, slectionnez laction effectuer lorsque la condition est rencontre avant que le nombre maximum ditrations dfini ne soit atteint. Dans cet exemple, ds que la condition est rencontre, la boucle devrait sarrter. Puis paramtrez le sous-Job excuter lorsque la condition est rencontre. Dans cet exemple, le sous-Job slectionne les donnes de la table scanne et les affiche dans le console. Slectionnez le composant tMysqlInput, et dans longlet Basic Settings de la vue Component, paramtrez la connexion la table.
Si la connexion est stocke dans le Repository, slectionnez-la dans la liste droulante. Sinon, cochez la case Use an existing connection et slectionnez le composant de connexion correspondant dans la liste. Dans cet exemple, le schma correspondant la structure de la table est stock dans le Repository. Dans le champ Table Name, renseignez le nom de la table partir de laquelle les donnes seront extraites, Test_datatypes. Puis dans le champ Query, saisissez la commande Select permettant dextraire le contenu de la table. Pour cet exemple, laissez les proprits par dfaut du composant tLogRow. Avant dexcuter le Job, assurez-vous que la table scanner (test_datatypes) est bien vide, afin que la condition (greater or equal to 1) soit rencontre. Puis excutez le Job via le raccourci F6. Avant la fin de la boucle, ajoutez une ou deux lignes la table test_datatypes afin que la condition soit rencontre.
1481
tWaitForSqlData
Le Job sarrte lorsque les donnes ajoutes la table sont dtectes lors de la boucle et le contenu de la table est affich dans la console.
1482
Composants Processing
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Processing de la Palette de Talend Open Studio. La famille Processing regroupe les composants vous permettant deffectuer diffrents types de traitement de flux de donnes, notamment lagrgation, le mapping, la transformation, la dnormalisation, le filtrage, etc.
tAggregateRow
tAggregateRow
Proprits du tAggregateRow
Famille de composant Processing
Fonction
Le composant tAggregateRow reoit un flux de donnes et fait une agrgation base sur une ou plusieurs colonnes. Pour chacune des lignes en sortie, une cl dagrgation est fournie, ainsi que le rsultat de lopration dagrgation correspondant (min, max, sum, etc.). Il permet dtablir des mtriques et des statistiques bases sur des valeurs ou des calculs. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que lorsque vous modifiez le schma, il se met automatiquement en built-in. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Group by Dfinit les ensembles dagrgation, dont les valeurs sont utilises pour les calculs. Output Column : Slectionnez le libell de colonne dans la liste fournie, base sur la structure de schma que vous avez dfinie. Vous pouvez ajouter autant de colonnes de sortie que vous le souhaitez afin daffiner les agrgations. Ex : Slectionnez Country (Pays) pour calculer la moyenne des valeurs pour chaque pays ou slectionnez Country et Region pour comparer les rsultats des rgions dun pays par rapport aux rgions dun autre pays. Input Column : Faites la correspondance entre les libells des colonnes dentre avec ceux des colonnes de sortie, dans le cas o vous souhaitez que les libells du schma de sortie soient diffrents du schma dentre. Operations Slectionnez le type dopration effectuer ainsi que la valeur utiliser pour le calcul et le champ de sortie.
1484
tAggregateRow
Output Column : Slectionnez le champ de destination dans la liste. Fonction : Slectionnez loprateur parmi : count : calcule le nombre de ligne, min : slectionne la plus petite valeur, max : slectionne la plus grande valeur, avg : calcule la moyenne, sum : calcule la somme, first : retourne la premire valeur, last : retourne la dernire valeur, list : liste les valeurs dune agrgation de plusieurs cls. list (object) : liste les valeurs Java dune agrgation de plusieurs cls, count (distinct) : compte le nombre de lignes sans les doublons, standard deviation : calcule lcart-type. Input column position : Slectionnez la colonne dentre partir de laquelle les valeurs sont collectes pour lagrgation. Ignore null values : Cochez cette case devant le nom de toutes les colonnes pour lesquelles vous voulez que les valeurs nulles soient ignores. Advanced settings Delimiter(only for list operation) Use financial precision, this is the max precision for sum and avg operations, checked option heaps more memory and slower than unchecked. Saisissez le sparateur que vous souhaitez utiliser afin de sparer les diffrentes oprations. Cochez cette case afin dutiliser une prcision financire, une prcision maximale, mais qui consomme plus de mmoire et rend le processus plus lent. Nous vous conseillons dutiliser le type BigDecimal en sortie avec cette option, afin dobtenir des rsultats prcis.
Check type overflow Vrifie les types des donnes afin dviter que le (slower) Job ne plante Check ULP (Unit in the Last Place), ensure that a value will be incremented or decremented correctly, only float and double types. (slower) tStatCatcher Statistics Utilisation Cochez cette case afin davoir la meilleure prcision possible pour les types Float et Double.
Ce composant est un composant intermdiaire car il traite un flux de donnes, par consquent il requiert des composants en entre comme en sortie. Gnralement, lutilisation du composant tAggregateRow est combine au composant tSortRow. n/a
Limitation
1485
tAggregateRow
Scnario : Agrger des valeurs et trier des donnes

Le scnario suivant dcrit un Job quatre composants. Le composant dentre, un fichier dlimit CSV, contient des noms de pays et des valeurs de notation trier par ordre dcroissant de moyenne. Ce composant dentre est connect un oprateur tAggregateRow qui se charge de calculer les moyennes puis un composant tSortRow qui se charge du tri. Le flux de sortie est dirig dans un nouveau fichier CSV.
A partir du dossier File de la Palette, cliquez et dposez un composant tFileInputDelimited. Cliquez sur le libell du composant et renommez-le en Countries. Ou passez dans longlet View pour le changer. Dans longlet Basic settings, dfinissez le chemin daccs ainsi que les critres de dlimitation. Ou slectionnez lentre de mtadonnes correspondant votre fichier dentre, si vous en avez dfini une. Cliquez sur Edit schema... et paramtrez les colonnes : Countries et Points correspondant la structure du fichier. Si la description du fichier est conserve dans les Metadata du Repository, le schma est automatiquement charg lorsque vous cliquez sur Repository dans le champ Schema type. Puis dans le dossier Processing de la Palette, cliquez et dposez le composant tAggregateRow. Renommez-le en Calculation. Cliquez-droit et connectez Countries Calculation laide dune connexion Row > Main. Double-cliquez sur Calculation (composant tAggregateRow) pour dfinir les proprits. Cliquez sur Edit schema et dfinissez le schma de sortie. Vous pouvez ajouter autant de colonnes que vous le voulez selon le nombre doprations densemble que vous souhaitez obtenir en sortie.
1486
tAggregateRow
Dans cet exemple, calculez la moyenne de la notation par pays et affichez les valeurs minimale et maximale par pays, sachant que chaque pays possde plusieurs notes. Cliquez sur OK lorsque le schma est termin. Dfinissez prsent les diffrentes oprations densemble effectuer. Dans le champ Group By de la fentre Basic settings du composant tAggregateRow, dfinissez les ensembles sur lesquels les oprations sont effectues. Dans cet exemple, slectionnez Country comme colonne de regroupement. Notez que dans la colonne de sortie, un champ cl doit tre dfini dans le schma. La premire colonne cite comme de sortie (Output) dans la table Group By devient lensemble principal de calcul. Toutes les autres sorties deviennent alors secondaires dans lordre daffichage. Slectionnez la colonne dentre (Input) dont sont extraites les valeurs. Puis renseignez les diverses oprations ralises. Les fonctions utilises dans cet exemple sont des moyennes (average), min, max. Slectionnez la colonne dentre dont sont extraites les valeurs de calcul et slectionnez les cases Ignore null values si ncessaire.
1487
tAggregateRow
Cliquez-dposez un composant tSortRow dans lespace de modlisation. Pour plus dinformations concernant ce composant, consultez Proprits du tSortRow page 1585. Connectez-le au composant tAggregateRow laide dune connexion de type Row > Main. Dans la vue Component du composant tSortRow, dfinissez la colonne de tri, le type ainsi que lordre de tri.
Dans ce scnario, la colonne trier est Country, le type de tri est alphabtique et lordre est ascendant. Ajoutez un composant de sortie ce Job. Cliquez et dposez un composant tFileOutputDelimited et paramtrez-le. Connectez le composant tSortRow ce composant de sortie. Dans la vue Component, saisissez le chemin daccs au fichier de sortie. Cliquez sur Edit schema pour le configurer si ncessaire. Dans ce scnario, le fichier dlimit est de type CSV. Cochez la case Include Header afin de rutiliser les libells des colonnes du schma dans le flux de sortie. Appuyez sur F6 pour excuter le Job. Le fichier CSV est ainsi cr et il contient les rsultats des oprations dagrgation.
1488
tAggregateRow
1489
tAggregateSortedRow
tAggregateSortedRow
Proprits du tAggregateSortedRow
Famille du composant Processing
Fonction
Le composant tAggregateSortedRow reoit un flux de donnes tries sur lequel il effectue une agrgation base sur une ou plusieurs colonnes. La cl dagrgation et les rsultats pertinents des oprations (min, max, sum, etc.) sont dispenss pour chaque ligne de sortie. Le tAggregateSortedRow vous permet de rcuprer un chantillon de mtriques reposant sur des valeurs ou des calculs. Etant donn que les donnes du flux dentre sont supposes tre dj tries, les performances nen sont que plus optimises. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que lorsque vous modifiez le schma, il se met automatiquement en built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent connect dans le Job. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job Designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Input rows count Spcifiez le nombre de lignes envoy au composant tAggregateSortedRow. Si vous spcifiez une limite (dans le champ Limit) au nombre de lignes traiter dans le compoasnt dentre, vous devez utiliser cette mme limite dans le champ Input rows count. Group by Dfinit les ensembles dagrgation, dont les valeurs sont utilises pour les calculs.
Objectif
Basic settings
1490
tAggregateSortedRow
Output Column : Slectionnez le libell de colonne dans la liste fournie, base sur la structure de schma que vous avez dfinie. Vous pouvez ajouter autant de colonnes de sortie que vous le souhaitez afin daffiner les agrgations. Ex : Slectionnez Country (Pays) pour calculer la moyenne des valeurs pour chaque pays ou slectionnez Country et Region pour comparer les rsultats des rgions dun pays par rapport aux rgions dun autre pays. Input Column : Faites la correspondance entre les libells des colonnes dentre avec ceux des colonnes de sortie, dans le cas o vous souhaitez que les libells du schma de sortie soient diffrents du schma dentre. Operations Slectionnez le type dopration effectuer ainsi que la valeur utiliser pour le calcul et le champ de sortie. Output Column : Slectionnez le champ de destination partir de la liste droulante. Function : Choisissez loprateur parmi : count, min, max, avg, first, last. Input column position : Slectionnez la colonne dentre partir de laquelle les valeurs sont rcupres avant dtre agrges. Ignore null values : Cochez cette case devant le nom de toutes les colonnes pour lesquelles vous voulez que les valeurs nulles soient ignores. Utilisation Ce composant traite des flux de donnes, il ncessite donc des composants dentre et sortie. Il est donc dfini en tant que composant intermdiaire. n/a
Limitation
Scnario associ
Pour un scnario associ, consultez le Scnario : Agrger des valeurs et trier des donnes, page 1486 du composant tAggregateRow.
1491
tConvertType
tConvertType
Proprits du tConvertType
Fonction
Le composant tConvertType permet deffectuer des conversions spcifiques du type de donnes Java vers un autre type de donnes Talend au cours de lexcution. Le composant tConvertType permet de convertir automatiquement des donnes de type Java vers un autre type utilis par Talend, ce qui permet dviter les erreurs de compilation. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que lorsque vous modifiez le schma, il se met automatiquement en built-in. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Auto Cast Cette case est coche par dfaut. Elle permet de convertir automatiquement des donnes de type Java. Ce mode nest pas visible si la case Auto Cast est coche. Elle permet de prciser manuellement les colonnes o une conversion de type Java est ncessaire. Cochez cette case pour dfinir les valeurs des lments de type String ou Object comme null pour les donnes d'entre. Cette case est coche pour arrter le Job lorsque survient une erreur. Cochez cette case pour collecter les donnes de log au niveau du composant.
Objectif
Basic settings
Manual Cast
Set empty values to Null before converting Die on error Advanced settings Utilisation Limitation tStatCatcher Statistics
Ce composant ne peut tre utilis comme composant de dbut. Il requiert un flux dentre pour fonctionner. n/a
1492
tConvertType
Scnario : Convertir des types de donnes Java

Le scnario Java suivant permet de crer un Job quatre composants dans lequel le tConvertType est utilis pour convertir des donnes de type Java stockes dans trois colonnes diffrentes et le tMap est utilis pour modifier le schma : la premire colonne reste intacte et les deux dernires colonnes du schma dentre sont fusionnes en une seule colonne dans le schma de sortie.
Dans ce scnario, le schma du fichier dlimit utilis en entre est stock dans le Repository, vous pouvez donc renseigner les proprits du composant tFileInputDelimited dun simple glisser-dposer du rpertoire Repository > Metadata > File delimited vers lespace de modlisation. Pour plus dinformations, consultez Dposer des composants partir du rpertoire Metadata du Guide utilisateur de Talend Open Studio.
Cliquez et dposez les composants suivants dans lespace de modlisation : tConvertType, tMap et tLogRow. Dans le Repository, dveloppez les noeuds Metadata > File Delimited et glissez-dposez la mtadonne correspondante dans lespace de modlisation. Pour ce scnario, JavaTypes. La bote de dialogue [Components] apparat. Dans la bote de dialogue, slectionnez le tFileInputDelimited dans la liste des composants et cliquez sur Ok. Un composant tFileInputComponent appel Java types apparat dans lespace de modlisation. Connectez les composants laide de liens Row Main.
Dans lespace de modlisation, slectionnez le composant tFileInputDelimited et cliquez sur la vue Component pour paramtrer ses proprits de base. Dans longlet Basic settings, slectionnez loption Repository dans la liste Property Type puisque les proprits du fichier sont stockes dans le Repository. Les autres champs sont alors renseigns automatiquement grce aux donnes rcupres.
1493
tConvertType
Le fichier dentre utilis pour ce scnario est un fichier texte appel input contenant des donnes Java de type string (chane de caractres), integer (entier) et float.
Dans la vue Basic settings, renseignez les autres champs, si ncessaire. Pour plus dinformations, consultez les Proprits du tFileInputDelimited, page 1136. Dans ce scnario, il ny a ni en-tte ni pied de page et il ny a pas de nombre limite de lignes traiter. Cliquez sur Edit schema pour dcrire la structure des donnes du fichier dentre. Dans ce scnario, le schma est compos de trois colonnes : StringtoInteger, IntegerField et FloatToInteger.
Cliquez sur OK pour fermer la bote de dialogue. Dans lespace de modlisation, slectionnez le tConvertType et cliquez sur la vue Component pour paramtrer ses proprits de base.
Dans la liste Schema Type, slectionnez loption Built in et cliquez sur le bouton Sync columns pour rcuprer automatiquement les colonnes du composant tFileInputDelimited. Si ncessaire, cliquez sur Edit schema pour dcrire manuellement la structure des donnes de ce composant de traitement.
1494
tConvertType
Dans ce scnario, lobjectif est de convertir les donnes de type string (chane de caractres) en integer (entier) et des donnes de type float en integer. Cliquez sur OK pour fermer la bote de dialogue [Schema of tConvertType]. Dans lespace de modlisation, double-cliquez sur le tMap pour ouvrir lditeur du tMap. Lditeur du tMap souvre et affiche les noms des colonnes du fichier dentre.
Dans longlet Schema editor en bas de lditeur du tMap, cliquez sur le bouton [+] de la table de sortie pour ajouter deux lignes et nommez-les StringToInteger et Sum. Dans lditeur du tMap, glissez la ligne StringToInteger de la table dentre vers la ligne StringToInteger de la table de sortie. Dans lditeur du tMap, glissez les lignes IntegerField et FloatToInteger de la table dentre vers la ligne Sum de la table de sortie. Cliquez sur OK pour fermer lditeur du tMap.
tConvertType
Dans lespace de modlisation, slectionnez le tLogRow et cliquez sur la vue Component pour paramtrer ses proprits de base. Pour plus dinformations, consultez le tLogRow, page 1399. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
Les donnes de type string sont converties en integer et affiches dans la colonne StringToInteger dans la console. Les donnes de type float sont converties en integer et ajoutes la valeur IntegerField et leur somme est affiche dans la colonne Sum dans la console.
1496
tDenormalize
tDenormalize
Proprits du tDenormalize
Famille de composant Processing/Fields
Le composant tDenormalize dnormalise un flux entrant en fonction dune colonne. Le tDenormalize permet de synthtiser un flux entrant. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. En Perl, le schma est en lecture seule et obligatoirement en Built-In. Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. To denormalize Java uniquement Ce tableau vous permet de choisir les paramtres de dnormalisation des colonnes. Column : Slectionnez la colonne dnormaliser. Delimiter : Saisissez, entre guillemets doubles, le sparateur que vous souhaitez utiliser. Merge same value : Cochez cette case si vous voulez fusionner les valeurs identiques. Slectionnez la colonne du flux entrant sur laquelle est base la dnormalisation (inclus dans la cl). Slectionnez une ou plusieurs colonnes regrouper. Nous vous conseillons de supprimer du schma les colonnes qui ne sont pas utilises avant de procder au traitement. Renseignez le sparateur dlimitant les donnes du flux dnormalis.
Perl uniquement Java uniquement
Column to denormalize Group by
Item Separator Perl uniquement Advanced settings Deduplicate items Perl uniquement tStatCatcher Statistics Utilisation Limitation
Supprime les doublons lorsque les valeurs dnormalises sont concatnes. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant peut tre utilis en tape intermdiaire dans un flux de donnes. Notez que ce composant peut changer lordre du flux entrant en Java et en Perl.
1497
tDenormalize
Scnario 1 : Dnormaliser une colonne

Ce scnario illustre un Job dnormalisant une colonne dun fichier dlimit via un composant de dnormalisation, et affichant le rsultat dans la console.
Cliquez et dposez les composants suivants : tFileInputDelimited, tDenormalize, tLogRow. Connectez ces composants laide dun lien Row main. Dans la vue Component du composant tFileInputDelimited, renseignez le chemin daccs au fichier dnormaliser.
Dans les champs Header, Row Separator et Field Separator, renseignez respectivement le nombre de lignes den-tte, le type de sparateur de lignes et de champs. Le fichier dentre est compos de deux colonnes : Fathers et Children.
Dans longlet Basic settings du tDenormalize, paramtrez la colonne contenant des valeurs multiples regrouper. Dans le tableau To denormalize, slectionnez la colonne Children. Dans cet exemple, la colonne Children est celle dnormaliser.
1498
tDenormalize
Dans le champ Delimiter, paramtrez le sparateur des valeurs regroupes. Attention, une seule colonne peut tre dnormalise. Cochez la case Merge same value si vous souhaitez supprimer les ventuels doublons. Enregistrez le Job et excutez-le en appuyant sur F6.
Toutes les valeurs de la colonne Children (dfinie comme colonne dnormaliser) sont regroupes en fonction des valeurs de la colonne Fathers. Les valeurs sont spares par des virgules.
Scnario 2 : Dnormaliser plusieurs colonnes

Ce scnario illustre un Job dnormalisant deux colonnes dun fichier dlimit via un composant de dnormalisation et affichant le rsultat dans la console.
Cliquez et dposez les composants suivants : tFileInputDelimited, tDenormalize, tLogRow. Connectez tous les composants laide dune connexion Row > main.
1499
tDenormalize
Dans longlet Basic settings du composant tFileInputDelimited, renseignez le chemin daccs au fichier dnormaliser.
Renseignez les autres champs, dont les champs Row Separator, Field separators et Header contenant respectivement les sparateurs de lignes et de champs et le nombre de lignes den-tte. Le schma du fichier est compos de quatre colonnes : Name, FirstName, HomeCity, WorkCity.
Dans longlet Basic settings du composant tDenormalize, slectionnez les colonnes contenant les rptitions. Elles correspondent aux colonnes apparaissant plusieurs fois dans le document. Dans cet exemple, FirstName, HomeCity et WorkCity sont les colonnes partir desquelles la dnormalisation est effectue. Ajoutez autant trois lignes la table To denormalize que vous le souhaitez en cliquant sur le bouton [+]. Puis slectionnez les colonnes FirstName, HomeCity et WorkCity dans la liste droulante.
1500
tDenormalize
Dans la colonne Delimiter, paramtrez les dlimiteurs en les saisissant entre guillemets, afin de sparer les valeurs concatnes. Pour la colonne FirstName, saisissez #, pour la colonne HomeCity, saisissez , et pour la colonne WorkCity, saisissez . Enregistrez le Job et excutez-le, en appuyant sur F6.
Le rsultat affiche les valeurs dnormalises concatnes laide des sparateurs. Dans longlet Basic settings du composant tDenormalize, dans le tableau To denormalize, cochez la case Merge same value pour fusionner les valeurs identiques. Enregistrez le Job et excutez-le en appuyant sur F6.
Cette fois-ci, la console affiche les rsultats sans doublon.
1501
tDenormalizeSortedRow
Proprits du tDenormalizeSortedRow
Famille du composant Processing/Fields
Fonction
Le composant tDenormalizeSortedRow rassemble dans un groupe toutes les lignes dentre dnormalises tries ainsi que leurs valeurs distinctes, associes par des sparateurs de champ. Le tDenormalizeSortedRow permet de synthtiser les lignes dentre tries afin de faire des conomies de mmoire. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Input rows count To denormalize Renseignez le nombre de lignes dentre. Renseignez le nom de la colonne dnormaliser.
Ce composant traite des flux de donnes, il ncessite donc un composant dentre et un composant de sortie. n/a
Scnario : Regrouper des lignes tries

Ce scnario Java dcrit un Job quatre composants. Il permet de lire un fichier dlimit donn ligne par ligne, de trier les donnes dentres en fonction de leur type et de leur ordre, de dnormaliser toutes les lignes dentres tries et enfin dafficher le rsultat dans la console de log Run. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFileInputDelimited, le tSortRow, le tDenormalizeSortedRow et le tLogRow. Connectez les quatre composants laide de liens de type Row Main.
1502
Dans lditeur graphique, slectionnez le composant tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileInputDelimited.
Dfinissez le champ Property Type en mode Built-In. Renseignez le chemin daccs au fichier traiter dans le champ File Name. Dans cet exemple, on utilise le fichier name_list, qui comporte deux colonnes, id et first name.
Dfinissez si ncessaire les sparateurs de lignes et de champs, len-tte et le pied-de-page, ainsi que le nombre de lignes traites. Dfinissez le champ Schema en mode Built in puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes passer au composant suivant. Dans cet exemple, le schma est constitu de deux colonnes, id et name.
1503
Dans lespace graphique, slectionnez le composant tSortRow. Cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings) du tSortRow.
Dfinissez le champ Schema Type en mode Built-In puis cliquez sur Sync columns pour rcuprer le schma partir du composant tFileInputDelimited. Dans le panneau Criteria, cliquez sur le bouton [+] pour ajouter une ligne puis dfinissez les paramtres de tri pour la colonne du schma traiter. Dans cet exemple, on veut trier la colonne id dans lordre croissant. Dans lespace graphique, slectionnez le composant tDenormalizeSortedRow. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tDenormalizeSortedRow.
1504
Dfinissez le champ Schema Type en mode Built-In puis cliquez sur Sync columns pour rcuprer le schma partir du schma du composant tSortRow. Dans le champ Input rows count, saisissez le nombre de lignes dentre traiter ou cliquez simultanment sur Ctrl+Espace pour accder la liste des variables de contexte puis slectionnez la variable : tDenormalizeSortedRow_1.NB_LINE. Dans le panneau To denormalize, cliquez sur le bouton [+] pour ajouter une ligne puis dfinissez les paramtres de la colonne dnormaliser. Dans cet exemple, on veut dnormaliser la colonne name. Dans lditeur graphique, slectionnez le composant tLogRow puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations sur le tLogRow, consultez le composant tLogRow, page 1399. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
Le rsultat affich sur la console montre la faon dont la colonne name a t dnormalise.
1505
tEmptyToNull
tEmptyToNull
Proprits du tEmptyToNull
Fonction Objectif
Le composant tEmptyToNull transforme les champs vides dun fichier ou dune table en champs NULL dans une base de donnes. Le tEmptyToNull permet de remplacer des champs vides par des champs non dfinis produisant des valeurs NULL dans le composant de sortie. Ce composant ne ncessite aucune configuration, il sexcute automatiquement. tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
Basic settings Advanced settings Utilisation
Ce composant est gnralement utilis comme composant intermdiaire dans un flux de donnes, il ncessite donc un composant en entre et un composant en sortie. Le composant en sortie doit obligatoirement tre de type base de donnes. n/a
Limitation
Scnario : Remplacer des champs vides par des champs non-dfinis (NULL)
Ce scnario dcrit un Job trois composants. Il permet de remplacer les champs sans chanes de caractres par des champs non-dfinis afin de gnrer des valeurs NULL en sortie. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFileInputDelimited, le tEmptyToNull et le tMysqlOutput. Connectez les trois composants laide de liens de type Row > Main.
Dans lditeur graphique, slectionnez le composant tFileInputDelimited. Cliquez sur la vue Component pour configurer les paramtres de base (Basic settings) du tFileInputDelimited.
1506
tEmptyToNull
Dans le champ Property Type, slectionnez le mode Repository si vous avez stock les informations du fichier dlimit sous le noeud Metadata du Repository ou slectionnez le mode Built-In pour les dfinir manuellement. Dans ce scnario, on utilise le mode Built-In. Renseignez le chemin daccs au fichier traiter dans le champ File Name. Dans cet exemple, on utilise le fichier name_list, qui comporte quatre colonnes, id, first name, last name et login.
Dfinissez si ncessaire les sparateurs de lignes (Row separator) et de champs (Field separator), len-tte (Header) et le pied-de-page (Footer), ainsi que le nombre de lignes traiter (Limit). La premire ligne, qui porte le nom des colonnes, est ignore dans cet exemple, cest pourquoi le champ Header est dfini 1. Dans le champ Schema, slectionnez le mode Built in puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes passer au composant suivant. Dans cet exemple, le schma est constitu de quatre colonnes, id, first_name, last_name et login.
1507
tEmptyToNull
Dans lditeur graphique, double-cliquez sur le composant tMysqlOutput pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] cot du champ Edit schema pour consulter le schma. Dans le champ Property Type, slectionnez Repository si vous avez stock les informations de connexion la base de donnes sous le noeud Metadata du Repository ou slectionnez le mode Built-In, puis renseignez manuellement les champs suivants : Host, Port, Database, Username et Password. Pour plus dinformations sur les proprits du composant tMysqlOutput, consultez tMysqlOutput page 647. Dans le champ Table, saisissez le nom de la table dont les champs contiendront les donnes extraites du fichier dlimit. Dans le champ Action on table, slectionnez lopration que vous souhaitez effectuer sur la table. Pour ce scnario, slectionnez Create table pour crer la table.
1508
tEmptyToNull
Dans le champ Action on data, slectionnez lopration que vous souhaitez effectuer sur les donnes. Pour ce scnario, laissez loption Insert. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
A partir de votre explorateur de base de donnes, vous pouvez vrifier que la table namelist a bien t cre. Elle se prsente sous la forme des quatre colonnes id, first_name, last_name et login du schma dfini en sortie et les champs vides du fichier de dpart on t remplacs par la valeur NULL.
1509
tExternalSortRow
tExternalSortRow
Proprits du tExternalSortRow
Fonction
Le composant tExternalSortRow utilise une application externe de tri pour trier les donnes dentre dune ou plusieurs colonnes, en fonction de leur type et de leur ordre. Le tExternalSortRow permet dtablir des mtriques et des tables de classification. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. File Name Nom du fichier traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide Utilisateur de Talend Open Studio. Caractre, chane ou expression rgulire sparant les champs. Renseignez le chemin daccs au fichier externe contenant lalgorithme de tri utiliser. Cliquez sur [+] pour ajouter autant de lignes que ncessaire pour mettre en place le tri. La premire colonne dfinie dans le schma est slectionne par dfaut. Schema column : Slectionnez la colonne de votre schma sur laquelle vous souhaitez baser votre tri. Notez que lordre est important car il dtermine la priorit de tri. Sort type : Numrique ou Alphabtique. Order : Ordre ascendant ou descendant.
Field separator External command sort path Criteria
1510
tExternalSortRow
Advanced settings
Maximum memory
Renseignez la taille de la mmoire physique que vous voulez allouer au processus de tri.
Temporary directory Dfinissez lendroit o stocker les fichiers temporaires. Set temporary input file directory Add a dummy EOF line tStatCatcher Statistics Utilisation Limitation Cochez la case pour afficher le champ dans lequel vous pouvez spcifier le rpertoire du fichier dentre temporaire. Cochez cette case lorsque vous utilisez le composant tAggregateSortedRow. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant traite des flux de donnes, il ncessite donc un composant dentre et un composant de sortie. n/a
Scnario associ
Pour un scnario associ, consultez le Scnario : Trier des donnes, page 1586 du composant tSortRow.
1511
tExtractDelimitedFields
Proprits du tExtractDelimitedFields
Fonction Objectif
Le composant tExtractDelimitedFields gnre des colonnes multiples partir dune colonne donne dans un fichier dlimit. Le tExtractDelimitedFields permet dextraire les champs partir dune chane de caractres, pour les crire un autre endroit par exemple. Field to split Field separator Slectionnez partir de la liste le champ sparer. Dfinissez le sparateur de champs. La syntaxe regex utilise un certain nombre de caractres spciaux comme oprateurs. Si vous utilisez lun de ces oprateurs comme sparateur de champs, il est ncessaire de protger le caractre par un double backslash. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Basic settings
Die on error
Advanced settings
Advanced separator(for number)
Cochez cette option pour modifier les sparateurs utiliss pour les nombres.
1512
Trim columns
Cochez cette case pour supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes. Cochez cette case pour synchroniser chaque ligne avec le schma dentre. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Check each row structure against schema tStatCatcher Statistics Utilisation
Ce composant traite des flux de donnes, il ncessite donc un composant dentre et un composant de sortie. Il permet d'extraire des donnes d'un champ dlimit l'aide d'un lien Row > Main, et permet de crer un flux de rejet avec un lien Row > Reject, filtrant les donnes dont le type ne correspond pas au type dfini. n/a
Limitation
Scnario : Extraire des champs partir dun fichier dlimit par des virgules
Ce scnario Java dcrit un Job trois composants o le composant tExtractdelimitedFields est utilis pour extraire deux colonnes partir dun fichier dlimit par des virgules. A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFileInputDelimited, le tExtractDelimitedFields et le tLogRow. Effectuez un clic-droit sur chacun des trois composants pour les connecter laide de liens Row Main.
Dans lespace graphique, slectionnez le composant tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileInputDelimited. Dans longlet Basic settings, dfinissez le champ Property Type en mode Built-In. Cliquez sur le bouton [...] ct du champ File Name pour dfinir le chemin daccs au fichier dentre.
1513
Dans ce scnario, on utilise le fichier dentre test5. Il sagit dun fichier texte dont certaines donnes sont spares par des virgules.
Dans longlet Basic settings, renseignez les autres champs. Pour plus dinformations, consultez le chapitre Proprits du tFileInputDelimited, page 1136. Dans ce scnario, len-tte et le pied-de-page ne sont pas dfinis et aucune limite nest renseigne concernant le nombre de lignes traites. Cliquez sur Edit schema pour dcrire la structure des donnes du fichier dentre. Dans ce scnario, le schma est compos dune seule colonne, name.
Dans lespace graphique, slectionnez le composant tExtractDelimitedFields. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tExtractDelimitedFields.
1514
A partir de la liste droulante Field to split, slectionnez la colonne dissocier. Dans ce scnario, il sagit de la colonne name. Dans le champ Field separator, renseignez le sparateur de champs correspondant. Cliquez sur Edit schema pour dcrire la structure des donnes de ce composant de traitement. Dans le panneau de sortie de la bote de dialogue [Schema of tExtractRegexFields], cliquez sur le bouton [+] pour ajouter deux colonnes, firstname et lastname, au schma de sortie.
Dans ce scnario, on veut sparer la colonne name en deux colonnes dans le flux de sortie, firstname et lastname. Cliquez sur OK pour fermer la bote de dialogue [Schema of tExtractDelimitedFields]. Dans lespace graphique, slectionnez le composant tLogRow puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations, consultez le composant tLogRow, page 1399. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
1515
Les prnoms (firstname) et les noms (lastname) sont extraits et affichs sur la console dans leurs colonnes dfinies correspondantes.
1516
tExtractPositionalFields
Proprits du tExtractPositionalFields
Le composant tExtractPositionalFields gnre des colonnes multiples partir dune colonne donne en utilisant des champs positionnels. Le tExtractPositionalFields permet dextraire les donnes dun fichier positionnel selon un modle (pattern). Field Customize Slectionnez dans la liste le champ partir duquel effectuer lextraction. Cochez cette case pour personnaliser le format des donnes du fichier positionnel et renseignez les colonnes du tableau Formats. Column : Slectionnez la colonne que vous souhaitez personnaliser. Size : Saisissez la taille correspondant la colonne. Padding char : Saisissez entre guillemets le caractre de remplissage utilis afin quil soit supprim de votre champ. Le caractre par dfaut est un espace. Alignment : Slectionnez le paramtre dalignement appropri. Renseignez le modle utiliser pour lextraction. Un modle est constitu de valeurs de longueur spares par des virgules et interprtes comme une chane de caractres entre guillemets. Assurez-vous que les valeurs saisies dans ces champs correspondent au schma dfini. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent.
Pattern
Die on error
1517
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Advanced settings Advanced separator(for number) Trim Column Cochez cette option pour modifier les sparateurs utiliss pour les nombres. Cochez cette case afin de supprimer les espaces en dbut et en fin de champ, dans toutes les colonnes. Cochez cette case pour synchroniser chaque ligne avec le schma dentre. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Check each row structure against schema tStatCatcher Statistics Utilisation
Limitation
Scnario associ
Pour un scnario associ, consultez le composant tExtractRegexFields, page 1519.
1518
tExtractRegexFields
tExtractRegexFields
Proprits du tExtractRegexFields
Fonction Purpose Basic settings
Le composant tExtractRegexFields gnre des colonnes multiples partir dune colonne donne en utilisant des correspondances regex. Le tExtractRegexFields permet dutiliser des expressions rgulires pour extraire les donnes selon un modle. Field to split Regex Schema et Edit Schema Slectionnez dans la liste le champ (ou colonne) sparer. Renseignez lexpression rgulire en fonction du langage de programmation que vous utilisez. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Advanced settings
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject. Cochez cette case pour synchroniser chaque ligne avec le schma dentre. Cochez cette case pour collecter les donnes de log au niveau du Job, ainsi quau niveau de chaque composant.
Check each row structure against schema tStatCatcher Statistics
1519
tExtractRegexFields
Utilisation
Limitation
Scnario : Extraire des noms, des domaines et domaines de premier niveau partir dadresses e-mail
Ce scnario Java dcrit un Job trois composants dans lequel le tExtractRegexFields est utilis pour dfinir une expression rgulire correspondant lune des colonnes des donnes dentre. Dans ce scnario, il sagit de la colonne email. Le composant tExtractRegexFields est galement utilis pour trouver les correspondances avec ladite expression rgulire. Cette expression comprend des identifieurs de champ permettant de sparer le nom dutilisateur, le nom de domaine ainsi que le nom du domaine de premier niveau pour chaque adresse e-mail. Si ladresse e-mail est valide, ces trois parties sont extraites et affiches sur la console dans trois colonnes diffrentes. Les donnes des deux autres colonnes dentre, id et age, sont galement extraites puis rediriges. A partir de la Palette, cliquez-dposez les composants suivants dans lespace graphique : le tFileInputDelimited, le tExtractRegexFields et le tLogRow. Connectez les trois composants laide de liens Row Main comme ci-dessous.
Dans lespace graphique, cliquez sur le composant tFileInputDelimited. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tFileInputDelimited. A partir de longlet Basic settings, configurez le champ Property Type en mode Built-In. Cliquez sur le bouton [...] ct du champ File Name pour dfinir le chemin daccs au fichier dentre.
1520
tExtractRegexFields
Dans ce scnario, le fichier dentre utilis est test4. Il sagit dun fichier texte comportant trois colonnes : id, email et age. Renseignez tous les autres champs comme demand. Pour plus dinformations, consultez Proprits du tFileInputDelimited, page 1136. Dans ce scnario, len-tte et le pied-de-page ne sont pas dfinis et aucune limite nest renseigne concernant le nombre de lignes traites. Cliquez sur le bouton [...] du champ Edit schema pour dfinir la structure des donnes du fichier dentre. Dans ce scnario, le schma est compos de trois colonnes, id, email et age. Dans lespace graphique, slectionnez le composant tExtractRegexFields. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tExtractRegexFields. A partir de la liste droulante Field to split, slectionnez la colonne sparer, savoir email dans ce scnario. Dans le panneau Regex, renseignez lexpression rgulire utiliser pour effectuer la correspondance. Dans ce scnario, il sagit dune expression rgulire Java.
Cliquez sur Edit schema pour dcrire la structure des donnes du composant de traitement. Dans le panneau Output de la bote de dialogue [Schema of tExtractRegexFields], cliquez sur le bouton [+] pour ajouter cinq colonnes au schma de sortie.
1521
tExtractRegexFields
Dans ce scnario, on veut sparer la colonne dentre email en trois colonnes name, domain et tld dans le flux de sortie. Les deux autres colonnes dentre seront extraites telles quelles. Cliquez sur OK pour fermer la bote de dialogue [Schema of tExtractRegexFields]. Dans lespace graphique, slectionnez le composant tLogRow puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations, consultez le composant tLogRow, page 1399. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
Le composant tExtractRegexFields effectue une correspondance entre toutes les adresse e-mail donnes et lexpression rgulire dfinie, puis extrait le nom dutilisateur, le domaine et le domaine de premier niveau, quil affiche sur la console dans trois colonnes spares. Les deux autres colonnes, id et age, sont extraites telles quelles.
1522
tExtractXMLField
tExtractXMLField
tExtractXMLField appartient deux familles de composants : Processing et XML. Pour plus dinformations concernant le composant tExtractXMLField, consultez tExtractXMLField, page 1691.
1523
tFilterColumns
tFilterColumns
Proprits du tFilterColumns
Fonction
Le composant tFilterColumns opre des modifications spcifiques, tablies partir dun mapping du nom des colonnes, sur un schma dfini. Le tFilterColumns permet dhomogniser des schmas, soit en fonction de lordre des colonnes, soit en supprimant ou en ajoutant des colonnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio.
Objectif
Basic settings
Utilisation
Ce composant nest pas un composant de dbut (fond vert) et il ncessite un composant de sortie.
Scnario associ
Pour plus dinformations concernant lutilisation du composant tFilterColumns, consultez le Scnario : Remplacement mutliple et filtrage de colonnes, page 1578 du composant tReplace.
1524
tFilterRow
tFilterRow
Proprits du tFilterRow
Le composant tFilterRow filtre des lignes dentre en dfinissant des conditions sur les colonnes slectionnes. Le composant tFilterRow aide paramtrer les filtres sur les donnes source. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository.
Le schma est en lecture seule. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Logical operator used to combine conditions Conditions Si vous souhaitez utiliser les modes de filtrage simple et avanc la fois, slectionnez loprateur permettant de combiner les deux modes. Cliquez sur le bouton [+] pour ajouter autant de conditions que voulu. Les conditions sont excutes les unes aprs les autres pour chaque ligne. Input column : Slectionnez la colonne du schma sur laquelle excuter la fonction. Function : Slectionnez une fonction dans la liste. Operator : Slectionnez loprateur permettant de relier la colonne dentre et la valeur. Value : Renseignez la valeur filtre, entre guillemets si besoin est.
Use advanced mode Cochez cette case lorsque lopration effectuer ne peut aboutir grce aux fonctions standard proposes. Dans le champ texte, entrez lexpression rgulire comme demand. Advanced settings tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.
1525
tFilterRow
Utilisation
Ce composant nest pas un composant de dbut (fond vert) et il ncessite un composant de sortie.
Scnario : Filtrer une liste de noms et faire une recherche dans la liste
Le scnario suivant est un Job Java qui utilise une condition simple et une expression rgulire pour filtrer une liste denregistrements. Le Job crit deux tables de sortie : la premire liste tous les enregistrements de langue italienne dont les prnoms contiennent moins de six caractres et la seconde liste tous les enregistrements rejets. Un message derreur saffichera dans la table pour chaque enregistrement rejet, afin dexpliquer pourquoi lenregistrement a t rejet.
A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : un tFixedFlowInput, un tFilterRow et un tLogRow. Connectez le tFixedFlowInput au tFilterRow laide dun lien Row > Main. Ensuite, connectez le tFilterRow au tLogRow, laide dun lien Row > Filter. Dposez de la Palette dans lespace de modlisation graphique un nouveau tLogRow et renommez-le reject. Reliez le tFilterRow ce tLogRow laide dun lien Row > Reject. Dans lespace graphique, cliquez sur le composant tFixedFlowInput afin dafficher sa vue Basic settings et dfinir ses proprits. Slectionnez loption Use Inline Content(delimited file) dans la zone Mode. Cliquez sur le bouton [...] ct du champ File Name pour dfinir le chemin daccs au fichier dentre.
1526
tFilterRow
Renseignez les sparateurs de lignes (Row Separator) et de champs (Field Separator). Le sparateur de lignes est constitu dun retour chariot et le sparateur de champs dun point-virgule. Dans la liste Schema, slectionnez Buil-In. Le schma nest donc pas stock dans le Repository. Cliquez sur le bouton [...] ct du champ Edit schema pour dfinir le schma du fichier dentre. Dans cet exemple, le schma se compose de quatre colonnes : firstname, gender, language et frequency. Dans la colonne Type, slectionnez String pour les trois premires colonnes et Integer pour la colonne frequency.
Cliquez sur OK pour valider et fermer lditeur. Une bote de dialogue souvre et vous demande si vous voulez propager les changements. Cliquez sur Yes (oui). Dans la zone de texte Content, saisissez votre texte en respectant votre schma. Double-cliquez sur le composant tFilterRow pour afficher sa vue Basic settings et dfinir ses proprits.
1527
tFilterRow
Dans le tableau Conditions, renseignez les paramtres de filtre sur la colonne firstname. Dans la colonne InputColumn, slectionnez firstname. Dans la colonne Function, slectionnez Length. Dans la colonne Operator, slectionnez Lower than. Dans la colonne Value, saisissez 6 afin de filtrer uniquement les noms dont la longueur est suprieure six caractres.
Dans la colonne Value, vous devez saisir vos valeurs entre guillemets doubles pour tous les types de donnes, sauf pour le type Integer, qui nen ncessite pas.
Pour implmenter la recherche sur les noms italiens, cochez la case Use advanced mode et saisissez lexpression rgulire suivante, qui comprend le nom de la colonne dans laquelle chercher : input_row.language.equals(italian). Pour combiner les deux conditions, simple et avance, slectionnez loprateur logique And dans la liste Logical operator used to combine conditions. Dans la vue Basic settings des composants tLogRow, slectionnez loption Table (print values in cells of a table) dans la zone Mode. Sauvegardez votre Job puis appuyez sur F6 pour lexcuter.
1528
tFilterRow
La premire table liste les enregistrements contenant des prnoms italiens comprenant moins de six caractres et la seconde affiche les enregistrements ne correspondant pas la condition de filtre. A chaque enregistrement rejet correspond un message derreur expliquant la raison du rejet.
1529
tJoin
tJoin
Proprits du tJoin
Fonction
Le tJoin joint deux tables, en appliquant la correspondance exacte dans plusieurs colonnes. Il compare les colonnes du flux principal et les colonnes de rfrence du flux de rfrence (Lookup), et crit les donnes du flux principal et/ou les donnes rejetes. Il aide vrifier la qualit des donnes de nimporte quelle source par rapport une source de donnes de rfrence. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilisable dans divers projets et Job Designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Include lookup columns in output Cochez cette case pour inclure les colonnes de rfrence (lookup), que vous avez dfinies, dans le flux de sortie. Slectionnez la ou les colonne(s) du flux principal qui doivent tre vrifies par rapport la colonne cl de rfrence (lookup).
Key definition
Input key attribute
Lookup key attribute Slectionnez les colonnes cl de rfrence (lookup) que vous utiliserez comme rfrence, afin de les comparer aux colonnes du flux dentre. Inner join (with reject output) Advanced settings tStatCatcher Statistics Cochez cette case pour joindre dabord les deux tables et ensuite rassembler les donnes rejetes du flux principal. Cochez cette case pour collecter les mtadonnes de process du Job, aussi bien au niveau du Job quau niveau de chaque composant.
Usage Limitation/prrequis
Ce composant nest pas un composant de dbut (fond vert), il ncessite deux composants dentre, et un ou plusieurs composant(s) de sortie. n/a
1530
tJoin
Scnario : Faire une correspondance exacte entre deux colonnes et crire les donnes rejetes
Ce scnario Java dcrit un Job cinq composants dont le but est deffectuer une correspondance exacte entre la colonne firstnameClient dun fichier dentre, par rapport aux donnes du fichier de rfrence dentre, et la colonne lastnameClient, par rapport aux donnes du fichier dentre de rfrence. Les sorties de cette correspondance sont crites dans des fichiers de sortie distincts : les donnes exactes sont crites dans un fichier Excel, tandis que les donnes inexactes sont crites dans un fichier dlimit. Dans ce scnario, vous avez dj stock les schmas dentre et les fichiers de rfrence dans le Repository. Pour plus dinformations propos du stockage de mtadonnes dans larborescence du Repository, consultez le Guide Utilisateur Talend Open Studio. Dans larborescence du Repository, dveloppez le noeud Metadata ainsi que le noeud des fichiers (File) o vous avez stock les schmas dentre, et glissez la mtadonne correspondante dans lespace de modlisation graphique. La bote de dialogue [Components] souvre.
Slectionnez tFileInputDelimited dans la liste et cliquez sur OK afin de fermer la bote de dialogue. Le composant tFileInputDelimited apparat dans lespace de modlisation. Le fichier dentre utilis dans ce scnario est appel ClientSample. Il contient quatre colonnes, y compris les deux colonnes firstnameClient et lastnameClient sur lesquelles vous voulez appliquer la correspondance exacte. Rptez lopration pour le deuxime fichier dentre que vous souhaitez utiliser comme rfrence, ClientSample_Update dans ce scnario. Glissez les composants suivants de la Palette dans lespace de modlisation graphique : tJoin, tFileOutputExcel, et tFileOutputDelimited.
1531
tJoin
Connectez les fichiers principal et de rfrence au tJoin laide dune connexion de type Row > Main. Le lien principal entre le fichier de rfrence et le tJoin saffiche comme un lien Lookup (de rfrence) dans lespace de modlisation. Connectez le tJoin au tFileOutputExcel laide dune connexion Main, et le tJoin au tFileOutputDelimited avec une connexion Inner join reject. Au besoin, double-cliquez sur les fichiers dentre principal et de rfrence afin dafficher leur vue Basic settings. Toutes les proprits sont automatiquement renseignes. Si vous ne dfinissez pas vos fichiers dentre dans le Repository, remplissez les champs manuellement, aprs avoir slectionn Built-in dans le champ Property Type. Pour plus dinformations, consultez Paramtrer un schma built-in, page 91 et Paramtrer un schma du Repository, page 91, du Guide Utilisateur Talend Open Studio. Double-cliquez sur le tJoin afin dafficher sa vue Basic settings et dfinir ses proprits. Cliquez sur le bouton situ ct du champ Edit schema pour ouvrir une bote de dialogue qui affiche la structure des donnes des fichiers dentre, et dfinissez les donnes que vous souhaitez passer aux composants de sortie, trois colonnes dans ce scnario, idClient, firstnameClient et lastnameClient.
1532
tJoin
Cliquez sur OK pour fermer la bote de dialogue. Dans la zone Key definition de longlet Basic settings du composant tJoin, cliquez sur le bouton [+] pour ajouter deux colonnes la liste, puis slectionnez les colonnes dentre et de sortie sur lesquelles la correspondance exacte sera applique, depuis les listes Input key attribute et Lookup key attribute, respectivement firstnameClient et lastnameClient dans cet exemple. Cochez la case Inner join (with reject output) pour dfinir lune des sorties comme table de rejet de linner join. Double-cliquez sur le composant tFileOutputExcel pour afficher longlet Basic settings de sa vue Component, et dfinir ses proprits.
Paramtrez le rpertoire de destination ainsi que le nom de la feuille (Sheet name) et cochez la case Include header. Double-cliquez sur le composant tFileOutputDelimited pour afficher longlet Basic settings de sa vue Component, et dfinir ses proprits.
Paramtrez le rpertoire de destination ainsi que les sparateurs de lignes (Row separator) et de champs (Field separator) et cochez la case Include header.
1533
tJoin
Sauvgardez votre Job et appuyez sur F6 pour lexcuter.
La sortie de la correspondance exacte des colonnes firstnameClient et lastnameClient est crite dans le fichier Excel dfini.
Les donnes qui ne correspondent pas sont crites dans le fichier delimit dfini.
1534
tMap
tMap
Proprits du tMap
Le tMap est un composant avanc qui sintgre Talend Open Studio comme un plug-in. Le tMap transforme et dirige les donnes partir dune ou plusieurs source(s) et vers une ou plusieurs destination(s). Preview Laperu est un instantan des donnes du Mapper. Il nest visible que lorsque les proprits du Mapper sont renseignes. La synchronisation de laperu ne prend effet quaprs la sauvegarde des modifications. Auto : par dfaut, les liens sont en forme de courbes. Curves : les liens du mapping sont en forme de courbes. Lines : les liens du mapping sont en forme de lignes droites. Cette dernire option amliore lgrement les performances. Le Mapper est lditeur du tMap. Il vous permet de dfinir les proprits daiguillage et de transformation des donnes. Si vous ne souhaitez pas grer les erreurs dexcution, vous pouvez utiliser loption Die on error (coche par dfaut), en haut droite de lditeur. Cette option arrte le Job en cas derreur.
Mapping links display as
Map editor
Utilisation
Plusieurs utilisations sont possibles, de la simple rorganisation des champs de donnes aux transformations les plus complexes, telles que le multiplexage et le dmultiplexage de donnes, la concatnation, linversion, le filtrage, etc. Lutilisation du composant tMap requiert un niveau moyen de connaissances Perl ou Java afin dexploiter au mieux ses fonctionnalits. Ce composant est utilis comme une tape intermdiaire, cest pourquoi il ne peut pas tre utilis comme composant de dbut ou de fin de Job. Pour plus dinformations, consultez Mapper des flux de donnes du Guide utilisateur de Talend Open Studio.
Limitation
Scnario 1 : Mapping simple de donnes avec filtre et jointure explicite

Le Job Java ci-dessous a pour objectif de lire des donnes dun fichier .csv stock dans le Repository, de rechercher des donnes dun fichier de rfrence, dont le schma est galement stock dans le Repository puis dextraire des donnes de ces deux fichiers en fonction de filtres et denvoyer ces donnes vers les fichiers de sortie et de rejet.
1535
tMap
Cliquez sur File dans la Palette de composants, slectionnez tFileInputDelimited et dposez-le dans lespace de modlisation. Changez le libell en Cars (vhicules), soit en double-cliquant sur le libell directement dans lespace de modlisation graphique, soit via longlet View de la vue Component. Rptez cette opration et renommez le second composant dentre en Owners (propritaires). Cliquez sur Processing dans la Palette de composants, slectionnez le tMap et dposez-le dans lespace de modlisation. Reliez les deux composants dentre Owners et Cars au composant tMap et renommez les libells des connexions, Cars_data et Owners_data respectivement. Double-cliquez sur le composant tFileInputDelimited nomm Cars pour paramtrer ses proprits de base (Basic settings).
Slectionnez Repository dans les champs Property type et Schema. Pour le schma, slectionnez la mtadonne cars dans la bote de dialogue [Repository Content]. Le reste des champs est automatiquement renseign lorsque vous slectionnez la mtadonne approprie dans la liste. Double-cliquez sur le composant Owners et dfinissez nouveau les proprits. Slectionnez la mtadonne approprie, owners dans cet exemple.
1536
tMap
Dans ce scnario, les schmas dentre sont stocks dans le noeud Metadata de la vue Repository afin de les retrouver plus facilement. Pour plus dinformations concernant la cration de mtadonnes dans le Repository, consultez Centraliser les mtadonnes dans le Guide utilisateur de Talend Open Studio.
Double-cliquez sur le composant tMap pour ouvrir le Mapper. La zone Input (donnes en entre) est dj renseigne avec les schmas des composants dentre et la premire table correspond au flux principal (Main Row). Les libells de chacune des connexions dentre apparaissent en en-tte des tables. Crez une jointure entre les deux tables dentre en faisant simplement glisser le champ ID_Owner de la table principale (Cars_data) vers le champ quivalent de la table de rfrence (Owners_data). Dfinissez le lien en Inner Join en cliquant sur le bouton tMap settings, en cliquant dans le champ Value pour Join Model, en cliquant sur le bouton qui apparat dans le champ et en slectionnant Inner Join dans la liste Options.
Cliquez sur le signe [+] dans la zone Output (sortie) du Map Editor et ajoutez trois tables de sortie : Insured, Reject_NoInsur, Reject_OwnerID. Glissez et dposez le contenu de la table Cars_data vers la table Insured. Glissez les colonnes ID_Owner, Registration et ID_Reseller de la table Cars_data, ainsi que la colonne Name de la table Owners_data dans la table Reject_NoInsur. Glissez toutes les colonnes de la table Cars_data dans la table Reject_OwnerID. Pour plus dinformations concernant le mapping de donnes, consultez Mapper des flux de donnes dans le Guide utilisateur de Talend Open Studio. Cliquez sur le bouton [+] en haut de la table Insured afin dajouter une ligne de filtre.
1537
tMap
Glissez la colonne ID_Insurance de la table Owners_data vers la zone de filtre et saisissez la formule suivante dexclusion des valeurs non dfinies : Owners_data.ID_Insurance != null. Avec ce filtre, la table Insured va rassemble tous les enregistrements qui possdent un ID Insurance.
Cliquez sur le bouton tMap settings en haut de la table Reject_NoInsur et slectionnez true pour Catch lookup inner join reject afin que de dfinir cette table comme le flux de rejet standard pour rassembler les enregistrements nayant pas dID Insurance.
Cliquez sur le bouton tMap Settings en haut de la table Reject_OwnerID puis slectionnez true pour Catch lookup inner join reject afin que cette table rassemble les enregistrements du flux Cars_data ayant des IDs manquants ou ne correspondant pas.
1538
tMap
Cliquez sur OK pour valider et revenir lespace de modlisation. Ajoutez trois composants tFileOutputDelimited dans lespace de modlisation graphique. Reliez le tMap laide ces trois composants de sortie laide des liens Row correspondants. Renommez les trois composants selon les liens. Double-cliquez sur chacun des composants de sortie afin de dfinir leurs proprits. Si vous souhaitez crer un nouveau fichier, parcourez votre systme jusquau dossier de destination et saisissez le nom du fichier avec son extension. Cochez la case Include header pour rutiliser les libells des colonnes du schma dentre dans comme en-tte dans votre fichier de sortie.
Sauvegardez votre Job et appuyez sur F6 pour excuter le Job ou passez longlet Run Job et cliquez sur le bouton Run. Les fichiers de sortie sont crs et ils contiennent les donnes dfinies.
1539
tMap
Scnario 2 : Mapping de donnes avec rejet Inner join

Ce scnario, bas sur le scnario 1, requiert lajout dun fichier dentre contenant les informations sur les revendeurs, ainsi que lajout de champs supplmentaires dans la table de sortie principale. De plus, deux filtres sont ajouts sur les jointures Inner Join afin de rcuprer les rejets spcifiques.
Cliquez sur File dans la Palette des composants et dposez un composant tFileInputDelimited dans lespace de modlisation graphique. Renommez-le Resellers. Connectez ce nouveau composant au tMap et ajoutez un libell cette connexion : ici, Resellers_data. Double-cliquez sur le composant Resellers pour dfinir ses proprits dans la vue Basic settings.
1540
tMap
Slectionnez Repository dans la liste Property Type et slectionnez le schma resellers, dans la bote de dialogue [Repository Content]. Les autres champs sont automatiquement renseigns.
Dans ce scnario, les schmas dentre sont stocks sous le noeud Metadata du Repository afin de les retrouver facilement. Pour plus dinformations concernant la cration de mtadonnes dans le Repository, consultez Centraliser les mtadonnes dans le Guide utilisateur de Talend Open Studio.
Double-cliquez sur le composant tMap pour ouvrir le Map Editor. Vous remarquerez que le schma est automatiquement ajout la zone Input des schmas dentre. Crez une jointure entre le flux dentre principal et le nouveau flux dentre en dposant la colonne ID_Reseller de la table Cars_data dans la colonne ID_Reseller de la table Resellers_data. Cliquez sur le bouton tMap settings en haut de la table Resellers_data et slectionnez Inner Join comme modle de jointure (Join Model).
1541
tMap
Glissez-dposez toutes les colonnes de la table Resellers_data sauf ID_Reseller dans la table de sortie principale, Insured.
1542
tMap
Lorsque deux Inner Joins sont dfinis, vous devez soit dfinir deux tables de rejet inner join pour diffrencier les deux rejets, soit rassembler les deux rejets inner join dans une seule et mme table de sortie, sil ny a quune seule sortie.
Dans la zone de sortie Output, cliquez sur le signe [+] pour ajouter une nouvelle table de sortie et nommez-la Reject_ResellerID. Dposez toutes les colonnes de la table Cars_data dans la table Reject_ResellerID. Cliquez sur le bouton tMap Settings puis slectionnez true pour Catch lookup inner join reject afin de dfinir la dernire table comme tant la table du flux de sortie de rejets Inner Join.Si la jointure Inner Join ne peut tre tablie pour une entre, les informations concernant les voitures correspondantes seront rassembles dans le flux de sortie.
Appliquez maintenant un filtre sur chacune des sorties de rejet Inner Join afin de distinguer les deux types de rejets. Dans la premire table de rejet (Reject_OwnerID), cliquez sur la flche dote dun signe [+] pour ajouter une ligne de filtre et renseignez ce champ avec la formule suivante pour ne recueillir que les rejets lis au champ OwnerID non dfini : Owners_data.ID_Owner==null Dans la seconde table de rejet Inner Join (Reject_ResellerID), renouvelez lopration et utilisez la formule suivante : Resellers_data.ID_Reseller==null
1543
tMap
Cliquez sur Apply pour enregistrer les changements, puis sur OK pour fermer le Mapper. Dposez un nouveau composant tFileOutputDelimited de la Palette dans lespace de modlisation graphique et nommez-le No_Reseller_ID. Configurez ses proprits. Dans ce scnario, spcifiez simplement le chemin daccs au fichier de sortie et cochez la case Include Header. Laissez les autres paramtres tels quils sont.
Connectez le tMap au nouveau tFileOutputDelimited laide du lien Row nomm Reject_ResellerID. Pour comprendre le fonctionnement du Mapper, dans ce scnario, retirez du fichier Resellers.csv les lignes correspondant aux Reseller ID 5 et 8.
1544
tMap
Excutez le Job via la touche F6 du clavier, ou partir de la vue Run. Les quatre fichiers de sortie sont tous crs dans le dossier dfini dans les proprits de la vue Component. Remarquez que dans le fichier de rejet li lInner Join, NoResellerID.csv, le champ ID_Owners correspond aux entres du fichier Cars dont le Reseller ID est gal 5 et 8, manquant dans le fichier Resellers.csv.
Scnario 3 : Mapping de jointure en cascade

Un troisime scnario plus avanc et bas sur le scnario 2 requiert lajout dune nouvelle entre contenant les informations dassurance, par exemple. Dans le Mapper, mettez en place une jointure Inner Join entre deux tables de rfrence (Lookup) des flux secondaires Owners et Insurance afin de grer les rfrences en cascade et par consquent de rcuprer les informations de la table Insurance via les donnes de la table Owners.
Scnario 4 : Mapping avanc avec filtres, jointures explicites et rejet Inner join
Ce scnario prsente un Job utilisant le tMap et permettant de trouver les clients propritaires dune voiture de marque dfinie et avoir entre 2 et 6 enfants (inclus) dans un but de vente incitative.
1545
tMap
Cliquez-dposez les composants suivants de la Palette dans lespace de modlisation graphique : tFileInputDelimited (x3), tMap, tFileOutputDelimited (x2) Connectez les composants dentre au tMap laide de connexions de type Main row. Faites attention au premier composant que vous connectez car son flux de donnes sera automatiquement un flux Main (principal). Et toutes les autres connexions seront alors de type Lookup (flux de rfrence). Dans ce scnario, le composant dentre Owners sera reli au tMap par le flux Main. Dfinissez les proprits de chaque composant dentre dans longlet Basic settings. Configurez les proprits du composant Owners.
Slectionnez Repository dans la liste Property Type et slectionnez le schma resellers, dans la bote de dialogue [Repository Content]. Les autres champs sont automatiquement renseigns.
Dans ce scnario, les schmas dentre sont stocks sous le noeud Metadata du Repository afin de les retrouver facilement. Pour plus dinformations concernant la cration de mtadonnes dans le Repository, consultez Centraliser les mtadonnes dans le Guide utilisateur de Talend Open Studio.
Rptez ces tapes pour les autres composants dentre : Cars et Resellers. Ces deux flux de rfrence (Lookup) renseigneront les tables secondaires (lookup) de la zone dentre du Map Editor. Dobule-cliquez sur le composant tMap pour ouvrir le Map Editor et dfinir le mapping et les filtres. Configurez une jointure explicite entre le flux Main Owner et le flux Lookup Cars en glissant-dposant la colonne ID_Owner de la table Owner dans la colonne ID_Owner de la table Cars. La jointure explicite saffiche avec une cl de hachage.
1546
tMap
Dans le champ Expr. Key de la colonne Make (Marque), saisissez (en Java) le filtre appliquer. Dans ce cas dutilisation, saisissez simplement BMW puisque ce qui est recherch ce sont les propritaires (Owners) de cette marque en particulier. Effectuez une jointure en cascade entre les deux tables de rfrence Cars et Resellers, sur la colonne ID_Reseller, afin de retrouver les informations sur les propritaires et plus prcisment le nombre denfants quils ont.
1547
tMap
Comme vous souhaitez exclure les valeurs nulles dans une table spare et les exclure de la sortie standard, cliquez sur le bouton tMap Settings puis slectionnez Inner Join comme modle de jointure pour chaque table Lookup filtrer.
1548
tMap
Dans les paramtres du tMap, vous pouvez slectionner une des options suivantes : Unique match, First match, ou All Matches. Dans cet exemple, slectionnez loption All matches. Ainsi, si plusieurs correspondances sont trouves dans lInner Join (i.e. les lignes rpondant la jointure explicite ainsi quau filtre), elles seront toutes prises en compte dans le flux de sortie (soit dans le flux de rejet, soit dans le flux de sortie standard).
Loption Unique match fonctionne de la mme manire que loption Last match. Les options First match et All matches fonctionnent comme lindiquent leurs noms (respectivement premire correspondance et toutes les correspondances).
Puis dans la zone Output du Map Editor, ajoutez deux tables : une pour les correspondances rpondant la jointure explicite et au filtre et une pour les rejets. Dposez toutes les colonnes de la table Owners, les colonnes Registration, Make et Color de la table Cars ainsi que les colonnes ID_Reseller et Name_Reseller de la table Reseller dans la table de sortie principale. Dposez toutes les colonnes de la table Owners dans la table de rejets. Cliquez sur le bouton Filter en haut de la table de sortie principale afin dafficher la zone dexpression Filter. Saisissez une instruction afin de rduire le nombre de lignes charges dans le flux principale de sortie. Dans cet exemple, saisissez : Owners.Children_Nr >=2 && Owners.Children_Nr <= 6. Dans la table de rejets, cliquez sur le bouton tMap settings et dfinissez les types de rejets.
tMap
Slectionnez true pour Catch output reject afin de collecter des donnes concernant les dtenteurs de voitures BMW ayant moins de deux enfants ou plus de six enfants. Slectionnez true pour Catch lookup inner join reject afin de collecter des donnes concernant les propritaires dautres marques et ceux pour qui linformation Reseller est introuvable.
Cliquez sur OK pour valider le mapping et fermer lditeur. Dans lditeur graphique, cliquez droit sur le tMap et crez une connexion de sortie vers les composants correspondants. Dfinissez les paramtres des composants de sortie dans longlet Basic settings. Dans ce scnario, spcifiez simplement les chemins daccs aux fichiers de sortie et cochez la case Include Header. Laissez les autres paramtres tels quils sont.
1550
tMap
Enregistrez votre Job, puis appuyez sur F6 pour lexcuter. Le fichier de sortie principal contient les informations concernant les dtenteurs de BMW ayant entre deux et six enfants, et le fichier de rejet contient les informations concernant les autres possesseurs de voiture(s).
Scnario 5 : Mapping avanc avec filtres et diffrents rejets

Ce scnario est une version modifie du scnario prcdent. Il dcrit un Job qui applique des filtres pour limiter la recherche aux possesseurs de voitures BMW ou Mercedes ayant entre deux et six enfants et divise les donnes sans correspondance en diffrents flux de rejets.
1551
tMap
Reprenez le Job du Scnario 4 : Mapping avanc avec filtres, jointures explicites et rejet Inner join, page 1545. Dposez un nouveau tFileOutputDelimited de la Palette dans lespace de modlisation graphique et nommez-le Rejects_BMW_Mercedes. Connectez le composant tMap au nouveau composant de sortie laide dune connexion Row et nommez cette connexion selon la fonction du composant de sortie. Ce lien deviendra le nom de la nouvelle table de sortie dans le Map Editor. Renommez les connexions et les composants de sortie existants afin de prsenter leur fonction. Les tables de sortie dans le Map Editor seront automatiquement renommes selon le libell des liens. Dans cet exemple, renommez les connexions de sortie BMW_Mercedes_withChildren et Owners_Other_Makes, respectivement. Double-cliquez sur le composant tMap afin de lancer le Map Editor pour modifier le mapping et les filtres. Remarquez que la zone de sortie contient une nouvelle table de sortie, vide, nomme Rejects BMW_Mercedes. Vous pouvez ajuster la position de la table en la slectionnant et en cliquant sur les flches pointant vers le haut ou vers le bas, en haut de la zone de sortie. Supprimez le filtre BMW de la table Cars dans la zone dentre. Cliquez sur le bouton Filters pour afficher le champ Filter et saisissez un nouveau filtre afin de limiter la recherche aux seules marques de voitures BMW et Mercedes. Linstruction est la suivante : Cars.Make.equals(BMW) || Cars.Make.equals(Mercedes).
1552
tMap
Slectionnez toutes les colonnes de la table principale de sortie et dposez-les dans la nouvelle table de sortie. Sinon, vous pouvez glisser les colonnes des tables dentre correspondantes dans la nouvelle table de sortie. Cliquez sur le bouton tMap settings en haut de la nouvelle table de sortie et slectionnez true pour Catch output reject afin de collecter les donnes concernant les dtenteurs de voiture(s) BMW ou Mercedes ayant moins de deux enfants ou plus de six. Dans la table Owners_Other_Makes, slectionnez true pour Catch lookup inner join reject afin de collecter les donnes concernant les possesseurs de voitures dautres marques et ceux dont linformation reseller est introuvable.
1553
tMap
Cliquez sur OK pour valider le mapping et fermer le Map Editor. Configurez les proprits des composants de sortie dans leur vue Basic settings respective. Dans ce scnario, dfinissez simplement les nouveaux chemins daccs aux fichiers de sortie et cochez la case Include Header.
1554
tMap
Sauvegardez votre Job et appuyez sur F6 pour lexcuter. Le contenu du flux de sortie principal montre que les lignes filtres sont bien passes.
1555
tMap
Scnario 6 : Mapping avanc avec rechargement de la base de rfrence chaque ligne

Le scnario suivant dcrit un Job permettant de rcuprer certaines informations sur des personnes dans une base de donnes de rfrence, en se basant sur une jointure effectue sur leur ge. Le flux principal des donnes source est lu partir dune table MySQL appele people_age contenant certains dtails sur les personnes, comme leur identifiant (numrique), leur nom et prnom (alphanumrique) ainsi que leur ge (numrique), qui peut tre soit 40, soit 60 ans. On a intentionnellement rduit le nombre dentres de cette table. Les informations de rfrence sont galement stockes dans une table MySQL appele large_data_volume. Cette table de rfrence contient un certain nombre dentres, dont le nom des villes dans lesquelles les personnes enregistres dans la table principale sont alles. Le nombre dentres a t restreint pour plus de clart mais, dans le cas dune utilisation normale, le Job ci-dessous a des rsultats plus significatifs quand on traite un gros volume de donnes de rfrence. Pour optimiser les performances, un composant de connexion aux bases de donnes est utilis au dbut de ce Job pour ouvrir une connexion la base de donnes de rfrence afin de ne pas ouvrir et refermer une connexion chaque ligne de la table de rfrence charge. Un filtre dexpression (expression filter) est appliqu ce flux de rfrence, qui permet de ne slectionner que les donnes des personnes dont lge est 60 ou 40 ans. Ainsi, seules les lignes pertinentes de la table de rfrence sont enregistres pour chaque ligne du flux principal. Ce Job prsente donc comment, partir dun nombre limit de lignes de flux principal, on peut optimiser la base de donnes de rfrence pour nenregistrer que les rsultats correspondant la cl dexpression (expression key).
En gnral, comme le chargement des rfrences seffectue pour chacune des lignes de flux principal, il est plus intressant dutiliser cette option quand on ne traite quun nombre limit de lignes de flux principal et un grand nombre de lignes de rfrence.
La jointure seffectue au niveau du champ age. Les informations de la base de rfrence sont ensuite charges pour chacune des lignes du flux principal en entre, en utilisant loption de chargement approprie dans lditeur du composant tMap.
1556
tMap
Dans cet exemple, les mtadonnes ont t prpares pour le composant de connexion et les composants source. Pour plus dinformations sur les mtadonnes de connexion aux bases de donnes et les mtadonnes de cration de schmas des tables, consultez la section ddie au sujet dans le Guide Utilisateur de Talend Open Studio. Le Job est form de cinq composants, quatre composants de bases de donnes et un composant de mapping. A partir du noeud Metadata > Db Connections dans le Repository, glissez le schma de base de donnes dans lditeur graphique. Dans cet exemple, la table source sappelle people_age. Lorsque vous dposez le composant, une liste apparat lcran : slectionnez le composant tMysqlInput.
1557
tMap
Dposez le schma de base de donne de rfrence partir du noeud Metadata > Db Connections. Dans cet exemple, la table de rfrence sappelle large_data_volume. De la mme manire, glissez une connexion la base de donnes du noeud Db Connections dans le Repository dans lditeur graphique. Dans la bote de dialogue [Components], slectionnez le composant tMysqlConnection. Ce composant cre une connexion permanente la base de donnes de rfrence afin dviter que la connexion ne se referme au chargement que chaque ligne de rfrence. A partir de la Palette, dposez dans lditeur graphique le composant tMap (famille Processing) et les composants tMysqlCommit et tMysqlOutput (famille Database). Reliez maintenant tous les composants entre eux : faites un clic-droit sur le tMysqlInput correspondant la table people et maintenez le bouton enfonc tout en dplaant le curseur jusquau tMap. Relchez le bouton lorsque vous tes sur le tMap, le flux principal de lignes est cr automatiquement. Renommez le lien de type Main en people, pour pouvoir identifier plus facilement le flux de donnes principal. Effectuez la mme opration pour connecter la table de rfrence (large_data_volume) au tMap et le tMap au tMysqlOutput. Une bote de dialogue apparat et vous devez donner un nom au lien de sortie. Dans cet exemple, le flux de sortie sappelle people_mixandmatch. Renommez galement le lien de connexion la base de rfrence en large_volume pour pouvoir identifier plus facilement le flux de donnes. Connectez le tMysqlConnection au tMysqlInput via un lien de type OnSubjobOk. Double-cliquez ensuite sur le composant tMap pour ouvrir lditeur graphique de mapping.
1558
tMap
La table Output (qui sest cre automatiquement quand vous avez li le tMap au tMysqlOutput) sera compose des lignes concordantes du flux de rfrence (large_data_volume) et du flux principal (people_age). Slectionnez les lignes du flux principal que vous voulez passer en sortie et faites les glisser vers la table de sortie (dans le coin suprieur droit de lditeur de mapping) : ils y seront copis. Dans cet exemple, la slection des lignes du flux principal inclut les champs suivants : id, first_name, last_Name et age. Dans la table de rfrence, la colonne city est slectionne. Faites glisser les colonnes slectionnes des tables dentre (people et large_volume) vers la table de sortie. Crez maintenant la jointure entre le flux principal et le flux de rfrence. Slectionnez la colonne age dans la table du flux principal (en haut) et faites-la glisser vers la colonne age de la table du flux de rfrence (large_volume dans cet exemple). Licne dune cl apparat ct de lexpression lie dans la table de rfrence. La jointure est maintenant tablie.
1559
tMap
Cliquez sur le bouton tMap Settings puis sur le bouton [...] correspondant Lookup Model et slectionnez loption Reload at each row dans la bote de dialogue [Options] pour que la base de rfrence soit charge nouveau pour chaque nouvelle ligne traite.
De la mme manire, paramtrez Match Model comme All matches dans la table de rfrence pour rcuprer dans le flux de sortie toutes les occurrences de age qui correspondent. Implmentez ensuite le filtre, tabli partir de la colonne age, dans la table de rfrence. Le champ GlobalMapKey est cr automatiquement lorsque vous slectionnez loption Reload at each row. Vous pouvez donc utiliser cette expression pour filtrer les donnes de rfrence de manire dynamique, pour que seules les informations pertinentes soient charges avec le flux principal. Comme la soulign lintroduction de ce scnario, le flux de donnes principal contient uniquement les personnes dont lge vaut 40 ou 60. Pour viter de charger toutes les lignes de la table de rfrence, dont les ges sont diffrents de 40 et 60, vous pouvez utiliser la valeur ge du flux principal comme variable globale pour alimenter le filtre de rfrence.
1560
tMap
Glissez la colonne Age de la table de flux principal vers le champ Expr. dans la table de rfrence. Renseignez ensuite le nom de la variable dans le champ globalMap Key, en utilisant une expression. Dans cet exemple, lexpression est : people.Age. Cliquez sur le bouton OK pour enregistrer les paramtres de mapping et retourner dans lditeur graphique. Pour terminer limplmentation du filtrage dynamique du flux de rfrence, vous devez maintenant ajouter une clause WHERE la requte de la base de donnes dentre.
1561
tMap
A la fin du champ Query, juste aprs la commande Select, entrez la clause de type WHERE suivante : WHERE AGE ='"+((Integer)globalMap.get("people.Age"))+"'". Assurez-vous que le type correspond la colonne utilise comme variable. Dans cet exemple, la donne Age est du type Integer. Veillez aussi utiliser la variable de la manire dont vous lavez paramtre dans le champ globalMap key de lditeur de mapping. Double-cliquez ensuite sur le composant tMysqlOutput et vrifiez que le schma correspond aux paramtres de mapping.
Cochez la case Use an existing connection afin dutiliser la connexion cre. Spcifiez dans le champ Table le nom de la table cible. Dans les listes Action on table et Action on data, slectionnez les actions que vous souhaitez effectuer. Cliquez sur longlet Run au bas de lespace de modlisation graphique, afin dafficher longlet dexcution. Dans la vue Debug Run, cliquez sur le bouton Traces Debug pour voir la progression du traitement des donnes. Pour une meilleure visibilit, il est possible dagrandir la vue du Job dans lditeur graphique lors de lexcution en double-cliquant simplement sur longlet portant le nom du Job.
1562
tMap
Les donnes de rfrence sont charges nouveau pour chaque ligne du flux principal qui correspond la contrainte dge. Toutes les correspondances la condition age sont rcupres partir des lignes de la table de rfrence et regroupes dans le flux de sortie. Si vous vrifiez les donnes contenues dans la table people_mixandmatch nouvellement cre, vous y trouverez toutes les copies bases sur age correspondant aux diffrentes personnes dont lge vaut 40 ou 60, ainsi que les villes o ils sont alls.
Scnario 7 : Mapping avec des tables de sortie

Le scnario suivant dcrit un Job traitant des flux de rejet sans les sparer du flux principal.
1563
tMap
Dans la vue Repository, cliquez sur Metadata > File delimited. Glissez-dposez la mtadonne customers dans lespace de modlisation graphique. La mtadonne customers contient des informations relatives aux clients, comme leur ID, leur nom, leur adresse, etc. Pour plus dinformations concernant la centralisation des mtadonnes, consultez Centraliser les mtadonnes, page 145 du Guide Utilisateur de Talend Open Studio. Une bote de dialogue souvre et vous demande de choisir le type de composant que vous souhaitez utiliser. Slectionnez le composant tFileInputDelimited et cliquez sur OK. Ensuite, glissez-dposez la mtadonne states. Slectionnez le mme composant dans la bote de dialogue et cliquez sur OK. La mtadonne states contient lidentifiant de ltat, ainsi que son nom. Glissez-dposez de la Palette dans lespace de modlisation graphique un tMap et deux composants tLogRow. Reliez le composant customers au tMap laide dun lien Row > Main. Reliez le composant states au tMap, en utilisant un lien Row > Main. Il sera automatiquement dfini comme Lookup. Double-cliquez sur le composant tMap afin douvrir le Map Editor. Glissez-dposez la colonne idState dans la premire ligne de la seconde table, afin de crer une jointure. Cliquez sur le bouton tMap settings et slectionnre Inner Join pour Join Model. Cliquez sur le bouton Property settings en haut de la zone dentre afin douvrir la bote de dialogue [Property settings] et dcochez la case Die on error si vous souhaitez grer les erreurs dexcution. La table ErrorReject est maintenant cre.
1564
tMap
Slectionnez les colonnes id, idState, RegTime et RegisterTime de la table dentre et dposez-les dans la table ErrorReject.
Cliquez sur le bouton [+] en haut droite de lditeur afin dajouter une table de sortie. Dans la bote de dialogue qui souvre, slectionnez New output. Dans le champ ct, saisissez le nom de la table, out1. Cliquez sur OK. Dposez les colonnes suivantes des tables dentre dans la table out1 : id, CustomerName, idState et LabelState. Ajoutez deux colonnes RegTime et RegisterTime la fin de la colonne out1 et paramtrez leur format de date : dd/MM/yyyy HH:mm et yyyy-MM-dd HH:mm:ss.SSS, respectivement. Cliquez sur le champ Expression pour RegTime et appuyez sur Ctrl+Espace pour afficher la liste dautocompltion. Slectionnez TalendDate.parseDate. Changez le modle en ("dd/MM/yyyy HH:mm",row1.RegTime). Rptez lopration pour la seconde colonne, mais changez le modle en ("yyyy-MM-dd HH:mm:ss.SSS",row1.RegisterTime).
Cliquez sur le bouton [+] en haut droite de lditeur, afin dajouter une table de sortie. Dans la bote de dialogue qui souvre, slectionnez Create join table from, choisissez Out1 et donnez le nom rejectInner. Cliquez sur OK. Cliquez sur le bouton tMap settings et slectionnez true pour Catch lookup inner join reject, afin de grer les rejets. Dposez les colonnes id, CustomerName et idState des tables dentre dans les colonnes correspondantes de la table rejectInner. Cliquez dans le champ Expression de la colonne LabelState et saisissez UNKNOWN. Cliquez dans le champ Expression de la colonne RegTime, appuyez sur Ctrl+Espace, et slectionnez TalendDate.parseDate. Changez le modle en ("dd/MM/yyyy HH:mm",row1.RegTime.)
1565
tMap
Dans la colonne RegisterTime, appuyez sur Ctrl+Espace, et slectionnez TalendDate.parseDate, mais changez le modle en ("yyyy-MM-dd HH:mm:ss.SSS",row1.RegisterTime). Si les donnes de la ligne row1 ont un modle incorrect, elles seront retournes par le flux ErrorReject.
Cliquez sur OK afin de valider les modifications et fermer lditeur. Double-cliquez sur le composant tLogRow afin dafficher sa vue Component. Cliquez sur Sync columns pour rcuprer la structure du schma depuis le mapper si ncessaire. Dans la zone Mode, slectionnez Table. Rptez lopration avec le second tLogRow. Sauvegardez votre Job et appuyez sur F6 pour lexcuter. La console de la vue Run affiche les flux de sortie principal et le flux ErrorReject. Le flux de sortie principal unifie les donnes valides et les rejets Inner Join, alors que le flux ErrorReject contient les informations des erreurs concernant les lignes ayant un format de date non analysable
1566
tNormalize
tNormalize
Proprits du tNormalize
Famille de composant Processing/Fields
Le composant tNormalize normalise un flux entrant en fonction du standard SQL. Le tNormalize permet damliorer la qualit de donnes et donc facilite la mise jour des donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Pour ce composant, le schma est en lecture seule. Built-in : Le schma est cr et conserv pour ce composant uniquement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Column to normalize Item separator Slectionnez la colonne du flux entrant sur laquelle est base la normalisation. Renseignez le sparateur dlimitant les donnes du flux entrant.
Advanced settings Java uniquement Java uniquement Get rid of duplicated Cochez cette case pour supprimer les lignes rows from output doublons du flux de sortie. Use CSV parameters Cochez cette case pour prendre en compte les paramtres spcifiques aux fichiers CSV, notamment la manire de protger les caractres dans le champ escape mode et le type de guillemet dans le champ enclosure. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant est gnralement utilis comme composant intermdiaire dans un flux de donnes. n/a
Scnario : Normaliser des donnes

Ce scnario illustre un Job qui normalise une liste de mots-cls des sujets dun forum puis les transmet sous forme de tableau dans la console de la vue Run.
1567
tNormalize
Cliquez et dposez les composants suivants dans lespace de modlisation : tFileInputDelimited, tNormalize, tLogRow. Dans longlet Basic settings du composant tFileInputDelimited, slectionnez le fichier normaliser.
Le schma du fichier est stock dans le Repository. Il est compos dune colonne, appele Tags, et chaque ligne possde un ou plusieurs mots-cls. Dans les champs Row Separator et Field Separator, renseignez les sparateurs de lignes et de champs.
Dans longlet Basic settings du composant tNormalize, dans la liste Column to normalize, slectionnez la colonne sur laquelle la normalisation est base. Dans ce scnario, la colonne normaliser est Tags.
1568
tNormalize
Dans le champ Item separator, renseignez le sparateur de donnes, ici la virgule, que vous devez saisir entre guillemets. Dans les proprits du composant tLogRow, slectionnez le mode Table (print values in the cells of table). Enregistrez le Job et excutez-le, en appuyant sur F6.
Les valeurs sont normalises et affiches dans un tableau dans la console.
1569
tPerl
tPerl
Proprits du tPerl
Le tPerl transforme nimporte quelle donne saisie en code Perl. Le tPerl est un diteur (Perl) et aussi un outil trs flexible dans le Job. Code Saisissez le code Perl en fonction de la commande ou de la tche que vous souhaitez excuter. Pour plus dinformations concernant la syntaxe des fonctions Perl, consultez laide en ligne de Talend Open Studio dans le menu Talend Open Studio > User Guide > Perl. Cochez cette case pour collecter les donnes de log, aussi bien au niveau du Job quau niveau de chaque composant.
Advanced settings
Ce composant est gnralement utilis pour dbogger une erreur mais peut aussi tre utlis pour afficher le contenu dune variable. Ce composant est ddi aux utilisateurs Perl avancs et ne doit pas tre utilis avec un lien de type Row > Main car il est destin tre utilis seul.
Scnario : Afficher le nombre de lignes traites

Ce scnario est un Job trois composants qui affiche dans la console de log le nombre de lignes traites et passes en sortie dans un fichier Excel.
A partir de la Palette, cliquez-dposez les trois composants suivants dans lditeur graphique : le tFileInputDelimited, le tFileOutputExcel et le tPerl. Cliquez-droit sur le tFileInputDelimited et connectez-le au tFileOutputExcel laide dun lien de type Row > Main.
1570
tPerl
Cliquez-droit nouveau sur le tFileInputDelimited et reliez-le au tPerl laide dun lien Trigger > OnSubjobOk. Ce lien signifie que, comme lindique la flche, le premier composant (tFileDelimited) sexcutera avant le second (tPerl). Cliquez une fois sur le tFileInputDelimited et slectionnez longlet Basic settings de la vue Component pour dfinir les proprits du composant.
Les proprits (Properties) ne sont pas rutilises pour ou partir dun Job stock dans le Repository, elles sont au contraire utilises pour ce Job uniquement. Par consquent, slectionnez loption Built-In dans la liste droulante du champ Property Type. Renseignez le chemin daccs au fichier contenant les donnes traiter ou parcourez vos dossiers jusqu celui-ci. Dans cet exemple, le fichier texte comprend une liste de noms associe aux adresses email correspondantes. Dfinissez les sparateurs de ligne (Row) et de champ (Field). Dans ce scnario, chaque ligne comprend un nom et son adresse e-mail associe. Les champs sont spars par des points-virgules. La premire ligne du fichier contient le nom des colonnes, elle doit donc tre ignore dans ce Job. La valeur de len-tte (champ Header) est alors de 1. Il nest pas ncessaire de dfinir un pied-de-page (Footer) ou une valeur maximale (Limit) pour ce scnario. Le champ Schema type est galement dfini en mode Built-in dans cet exemple. Cliquez sur Edit Schema pour dcrire le contenu du fichier dentre. Dans ce scnario, il existe deux colonnes appeles Name et Emails contenant des chanes de caractres (String) dont la longueur nest pas dfinie. La cl est porte par le champ Email. Slectionnez le composant tFileOutputExcel et dfinissez-en les paramtres en fonction de vos besoins. Slectionnez le chemin daccs au fichier de sortie, appel Sheet, puis synchronisez le schma. Dfinissez ensuite le sous-Job tPerl de manire rcuprer le nombre de lignes lues par le tFileInputDelimited.
1571
tPerl
Entrez la commande Perl print pour afficher la variable relative au nombre de lignes lues dans le tFileInputDelimited. Pour accder la liste des variables disponibles, appuyez sur Ctrl+Espace puis slectionnez la variable adquate partir de la liste. Pour une meilleure lisibilit de la console de log Run Job, ajoutez le signe gal avant et aprs la commande. Notez que les commandes, les chanes de caractres et les variables apparaissent dans des couleurs diffrentes. Passez la vue Run Job et excutez le Job. Le Job sexcute normalement et cre un fichier Excel en sortie qui correspond au schma deux colonnes ayant t dfini : Name et Email.
Le rsultat de la commande Perl apparat dans la console de log du Job.
1572
tPivotToRows
tPivotToRows
Proprits du tPivotToRows
Fonction Objectif
Le composant tPivotToRows transforme des colonnes en lignes. Le composant tPivotToRows permet de choisir une liste de colonnes du flux entrant pour en fournir l'quivalent sous forme de lignes dans le flux sortant. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Row keys Slectionnez la liste des colonnes du schma dentre que vous voulez afficher sous forme de ligne unique. Les colonnes non slectionnes constitueront le pivot. Cliquez sur le bouton [+] pour ajouter autant de lignes que de colonnes concatner. Dans le champ Input column de chaque ligne, slectionnez le nom des colonnes choisies. Dterminez le sparateur des valeurs concatnes.
Basic settings
Row key concatenate delimiter Advanced settings Utilisation tStatCatcher Statistics
Ce composant est gnralement utilis comme composant intermdiaire dans un flux de donnes, il ncessite donc un composant en entre et un composant en sortie.
1573
tPivotToRows
Scnario : Concatner une liste de colonnes partir dune table en utilisant les autres colonnes comme pivot
Le scnario suivant est un Job Perl quatre composants permettant de concatner sur une mme ligne les informations de plusieurs colonnes dune table, en utilisant les autres colonnes comme pivot.
A partir de la Palette, cliquez-dposez les composants suivants dans lditeur graphique : le tFileInputDelimited, le tPivotToRows et deux tLogRow. Connectez les quatre composants laide de liens Row > Main comme ci-dessus. Dans lespace graphique, cliquez sur le composant tFileInputDelimited. Cliquez sur la vue Component pour configurer les paramtres de base (Basic settings) du tFileInputDelimited.
Dans le champ Property Type, slectionnez le mode Repository si vous avez stock les informations du fichier dlimit sous le noeud Metadata du Repository ou slectionnez le mode Built-In pour les dfinir manuellement. Dans ce scnario, on utilise le mode Built-In. Renseignez le chemin daccs au fichier traiter dans le champ File Name. Dans cet exemple, on utilise le fichier use_case_tunpivotrow, qui comporte huit colonnes : id, CustomerName, CustomerAddress, id2 et RegisterTime qui sont destines tre concatnes, ainsi que Sum1, Sum2 et Sum3 qui serviront de pivot. Dfinissez si ncessaire les sparateurs de lignes (Row separator) et de champs (Field separator), len-tte (Header) et le pied-de-page (Footer), ainsi que le nombre de lignes traiter (Limit). La premire ligne, qui porte le nom des colonnes, est ignore dans cet exemple, cest pourquoi le champ Header est dfini 1.
1574
tPivotToRows
Dans le champ Schema, slectionnez le mode Built in puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes passer au composant suivant. Dans cet exemple, le schma est constitu des huit colonnes du fichier dentre use_case_tunpivotrow.
Dans lespace graphique, cliquez sur le composant tPivotToRows. Cliquez sur la vue Component pour configurer les paramtres de base (Basic settings) du tPivotToRows. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] cot du champ Edit schema pour consulter le schma. Cliquez sur le bouton [+] pour insrer dans la zone Row keys autant de lignes quil y a de colonnes concatner. Dans cet exemple, on a ajout cinq lignes.
A partir de la liste droulante du champ Input column, slectionnez pour chaque ligne lintitul de la colonne concatner. Les colonnes du schma dentre qui ne seront pas slectionnes serviront de pivot. Dans cet exemple, les colonnes id, CustomerName, CustomerAddress, id2 et RegisterTime sont slectionnes pour la concatnation alors que les colonnes Sum1, Sum2 et Sum3 sont laisses de ct pour servir de pivot. Dans le champ Row key concatenate delimiter, dfinissez un caractre pour sparer les donnes des diffrentes colonnes une fois la concatnation acheve.
tPivotToRows
Cliquez sur un des composants tLogRow puis cliquez sur la vue Component pour configurer leurs paramtres de base (Basic settings).
Choisissez le mode Table pour visualiser le fichier de dpart et le rsultat du tPivotToRows au mme format et ainsi pouvoir les comparer. Utilisez les mmes paramtres pour le second composant tLogRow. Enregistrez le Job puis appuyez sur F6 pour lexcuter.
La console de log prsente les rsultats des deux composants tLogRow. Le tableau tLogRow_1 donne un aperu du fichier de dpart et le tableau tLogRow_2 montre la concatnation des colonnes id, CustomerName, CustomerAddress, id2 et RegisterTime ainsi que la transformation des colonnes Sum1, Sum2 et Sum3 en pivot.
1576
tReplace
tReplace
Proprits du tReplace
Le composant tReplace effectue un Rechercher/Remplacer dans les colonnes dentre spcifies. Ce composant permet de nettoyer tous les fichiers avant traitement. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Deux colonnes en lecture seule sont automatiquement ajoutes au schma de sortie : Value et Match. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Simple Mode Search / Replace Cliquez sur le bouton [+] pour ajouter autant de conditions que vous le souhaitez. Les conditions sont excutes lune aprs lautre pour chaque ligne. Input column : Slectionnez la colonne du schma sur laquelle effectuer le Rechercher/Remplacer. Search : Saisissez la valeur chercher dans la colonne dentre. Replace with : Saisissez la valeur de remplacement. Whole word : Cochez cette case si la valeur recherche constitue un mot entier. Case sensitive : Cochez cette case pour tenir compte de la casse. Notez que vous ne pouvez pas utiliser dexpression rgulire dans ces colonnes.
Use advanced mode Cochez cette case si vous souhaitez utiliser des expressions rgulires. Ce composant nest pas un composant de dbut puisquil requiert un flux de donnes. Il requiert aussi un composant de sortie.
1577
tReplace
Scnario : Remplacement mutliple et filtrage de colonnes

Le Job suivant recherche et remplace diffrentes coquilles et fautes dans un fichier .CSV puis filtre une colonne avant de gnrer en sortie un nouveau fichier .CSV contenant les donnes modifies.
Cliquez et dposez les composants suivants dans lespace de modlisation : tFileInputDelimited, tReplace, tFilterColumn et tFileOutputDelimited. Connectez les composants laide de liens de type Main > Row via un clic-droit sur chaque composant. Slectionnez le composant tFileInputDelimited et paramtrez les proprits du flux dentre.
Dans la liste droulante Property type, slectionnez loption Built-in. Puis renseignez manuellement les champs suivants. Si les proprits sont centralises dans le Repository, choisissez loption Repository et les champs seront automatiquement remplis. Le Fichier est un simple fichier .csv stock localement. Ainsi, dans le champ Filepath, renseignez le chemin daccs au fichier. Dans le champ Row Separator, renseignez le sparateur de lignes, ici le retour chariot. Dans le champ Field Separator, renseignez le sparateur de champs, ici un point virgule. Dans cet exemple, il ny a pas den-tte (Header), de pied de page (Footer) ou de nombre limite de lignes traiter (Limit). Le fichier contient des caractres tels que : \t, |||, [d] ou *d qui ne devraient pas tre interprts comme des caractres spciaux ou comme des caractres gnriques.
1578
tReplace
Dans le champ Schema, slectionnez aussi loption Built-in. Le schma est compos de quatre colonnes de diffrents types : chanes de caractres (string) ou entier (int). Slectionnez le composant tReplace pour paramtrer les proprits des Rechercher/Remplacer.
Le schma peut tre synchronis partir du flux dentre. Cochez la case Simple mode car les paramtres de recherche peuvent tre facilement dfinis sans avoir recours aux expressions rgulires. Cliquez sur le signe [+] pour ajouter des lignes aux tableaux des paramtres. En premier paramtre, slectionnez amount dans la colonne Input column. Dans la colonne Search, cherchez tous les points et dans la colonne Replace indiquez la valeur de remplacement, ici la virgule. Les valeurs doivent tre mises entre guillemets. En deuxime paramtre, slectionnez str dans la colonne Input column. Dans la colonne Search, cherchez les chanes de caractres stret ou streat ou stre. Notez que ces valeurs sont spares par une barre verticale qui signifie OU et qui quivaut au or en langage Perl. Dans la colonne Replace, renseignez la valeur de remplacement, ici Street. Cochez la case whole word. En troisime paramtre, slectionnez nouveau str dans la colonne Input column. Dans la colonne Search, cherchez les barres verticales en mettant une barre oblique inverse devant pour viter de la confondre avec le or en langage Perl. Et dans la colonne Replace, ne mettez rien entre les guillemets.
tReplace
En quatrime paramtre, slectionnez firstname dans la colonne Input column. Dans le champ Search, cherchez les caractres suivants : [, ], +, *. Notez que ces valeurs sont spares par une barre verticale qui signifie OU et qui est quivaut au or en langage Perl. Et dans la colonne Replace, ne mettez rien entre les guillemets. En cinquime paramtre, slectionnez amount dans la colonne Input column. Dans le champ Search, saisissez le signe du dollar entre guillemets simples et dans le champ Replace, saisissez le signe de leuro entre guillemets. En dernier paramtre, slectionnez firstname dans la colonne Input column. Dans la colonne Search, cherchez la chane \t. Pour diffrencier cette chane de la tabulation, ajoutez autant de barres obliques inverses devant quil y a de vrifications. En dautres termes, il faut ajouter deux barres obliques inverses pour que la chane ne soit pas confondue avec la tabulation et deux autres qui font partie du caractre recherch. En tout, il doit y avoir quatre barres obliques inverses inclue celle constituant la chane de caractres. Dans le champ Replace, ne mettez rien entre les guillemets. Cochez la case whole word. Loption Advanced mode nest pas utilise pour ce scnario. Slectionnez le composant suivant : tFilterColumn.
Le composant tFilterColumn contient un diteur de schma permettant de crer un schma de sortie bas sur le nom des colonnes du schma dentre. Dans cet exemple, changez lordre des colonnes et ajoutez trois nouvelles colonnes pour obtenir le schma suivant : empty_field, firstname, name, str, amount, filler1, filler2. Cliquez sur OK pour valider. Double-cliquez sur le tFileOutputDelimited afin dafficher sa vue Component.
1580
tReplace
Dans le champ Property Type, slectionnez loption Built-in et paramtrez les proprits du composant tFileOutputDelimited manuellement. Dans le champ Schema, slectionnez loption Built-in et cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Enregistrez le Job et excutez-le.
La premire colonne est vide et les caractres parasites ont t supprims des autres colonnes. La colonne street a t dplace, les dcimales sont dornavant spares par une virgule et le symbole montaire a t chang.
1581
tSampleRow
tSampleRow
Proprits du tSampleRow
Le composant tSampleRow filtre les lignes en fonction de leur position. Le tSampleRow permet de slectionner des lignes en fonction dune liste de lignes simples et/ou de groupes de lignes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Range Renseignez la position ou lintervalle choisi, en utilisant la syntaxe approprie, pour rcuprer une liste de lignes simples et/ou de groupes de lignes.
Ce composant traite des flux de donnes, il ncessite donc des composants dentre et sortie. n/a
Scnario : Filtrer des lignes et des groupes de lignes

Ce scnario Java dcrit un Job trois composants. On utilise un composant tRowGenerator pour crer des entres au hasard qui sont directement envoyes au tSampleRow, o elles seront filtres en fonction de leur position. Dans ce scnario, on suppose que le flux dentre contient les noms des vendeurs associs au nombre de produits quils ont chacun vendus ainsi que le nombre dannes passes dans lentreprise. Le rsultat de lopration de filtrage apparat dans la console Run. A partir de la Palette, cliquez dposez les composants suivants dans lditeur graphique : le tRowGenerator, le tSampleRow et le tLogRow. Connectez ces trois composants laide de liens de type Row > Main.
1582
tSampleRow
Dans lditeur graphique, slectionnez le tRowGenerator. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tRowGenerator. Dans la vue Basic settings, dfinissez loption Schema en mode Built-In puis cliquez sur le bouton [...] ct du champ Edit Schema pour dfinir les donnes que vous voulez utiliser en entre. Dans ce scnario, le schma est compos de cinq colonnes.
Dans longlet Basic settings, cliquez sur RowGenerator Editor pour dfinir les donnes gnrer. Dans lditeur RowGenerator Editor, prcisez le nombre de lignes gnrer dans le champ Number of Rows for RowGenerator puis cliquez sur OK pour fermer lditeur.
Dans lditeur graphique, slectionnez le tSampleRow. Cliquez sur la vue Component pour dfinir la configuration de base (Basic settings) du tSampleRow.
tSampleRow
Dans longlet Basic settings, dfinissez loption Schema en mode Built-In puis cliquez sur Sync columns pour rcuprer le schma partir du composant tRowGenerator. Dans la bote de texte Range, dfinissez le filtre de slection des lignes en utilisant la syntaxe approprie comme indiqu plus haut. Dans ce scnario, on veut slectionner la premire et la cinquime ligne, ainsi que le groupe de lignes entre 9 et 12. Dans lespace graphique, slectionnez le tLogRow puis cliquez sur la vue Component pour en dfinir la configuration de base (Basic settings). Pour plus dinformations sur les proprits du tLogRow, consultez le tLogRow, page 1399. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
Les rsultats filtrs apparaissent dans la console de log. Ils affichent la premire et la cinquime ligne, ainsi que les lignes entre 9 et 12.
1584
tSortRow
tSortRow
Proprits du tSortRow
Ce composant trie les donnes dentre bases sur une ou plusieurs colonnes, selon un type de tri et un ordre. Il permet dtablir des mtriques et des tables de classification. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma dans cette vue, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent dans le Job. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. Criteria Cliquez sur [+] pour ajouter autant de lignes que ncessaire pour mettre en place le tri. La premire colonne dfinie dans le schma est slectionne par dfaut. Schema column : Slectionnez la colonne de votre schma sur laquelle vous souhaitez baser votre tri. Notez que lordre est important car il dtermine la priorit de tri. Sort type : Numrique ou Alphabtique. Order : Ordre ascendant ou descendant.
Advanced settings
Sort on disk
Personnalisez la mmoire utilise de manire temporaire pour stocker les donnes de sortie. Temp data directory path : Dfinissez le chemin daccs au dossier dans lequel stocker les fichiers temporaires. Create temp data directory if not exists : Cochez cette case afin de crer le dossier sil nexiste pas. Buffer size of external sort : Entrez la taille de la mmoire physique allouer au processus de tri.
1585
tSortRow
Ce composant manipule le flux de donnes et par consquent requiert un composant en entre et un composant en sortie. Il sagit donc dun composant intermdiaire. n/a
Limitation
Scnario : Trier des donnes

Le scnario suivant dcrit un Job constitu de trois composants. Un composant tRowGenerator est utilis pour crer des entres de faon alatoire. Ces entres seront ensuite envoyes au composant tSortRow afin dtre tries selon une valeur dfinie. Dans ce scnario, le flux dentre contient des noms de vendeurs ainsi que leur volume de vente respectif et leur nombre dannes danciennet dans lentreprise. Le rsultat de lopration de tri est affich dans la console Run.
Cliquez et dposez les trois composants requis pour ce scnario : tRowGenerator, tSortRow et tLogRow. Connectez-les laide de liens de type Row Main. Dans le RowGenerator editor, dfinissez les valeurs qui seront cres de manire alatoire et qui seront ensuite tries par le tSortRow. Pour plus dinformations concernant lutilisation du tRowGenerator, consultez Proprits du tRowGenerator, page 1440
Dans ce scnario, chaque vendeur est class en fonction de la valeur de ses ventes (Sales) et de son anciennet dans lentreprise (YearsInComp). Double-cliquez sur tSortRow pour afficher longlet Basic settings. Dfinissez la priorit de tri sur la valeur des ventes et, en second critre, sur lanciennet.
1586
tSortRow
Utilisez le bouton [+] pour ajouter le nombre de lignes de critres requis. Paramtrez le type de tri, dans cet exemple, les deux critres sont de type numrique. Enfin, tant donn que la sortie est une classification, dfinissez lordre de tri comme descendant. Dans longlet Advanced Settings, cochez loption Sort on disk pour modifier les paramtres de la mmoire temporaire. Dans le champ Temp data directory path, renseignez le chemin daccs au dossier dans lequel vous voulez stocker les donnes temporaires. Dans le champ Buffer size of external sort, dfinissez la taille maximale de la mmoire tampon allouer au traitement des donnes.
La valeur par dfaut de la mmoire tampon est de 1000000 mais plus vous traitez un nombre important de lignes et/ou colonnes, plus cette valeur devra tre leve pour viter linterruption automatique du Job signifie par le message derreur out of memory.
Assurez-vous que ce flux est connect au composant de sortie tLogRow, afin dafficher le rsultat dans la console Run. Appuyez sur F6 pour excuter le Job ou passez la vue Run et cliquez sur le bouton Run. Le classement est dabord bas sur la valeur des ventes puis sur le nombre dannes danciennet.
1587
tSortRow
1588
tXMLMap
tXMLMap
Proprits du tXMLMap
Fonction
Le composant tXMLMap est un composant avanc personnalisable permettant de transformer et de router des flux de donnes XML (donnes de type document). Le tXMLMap transforme et route des donnes partir dune ou plusieurs source(s) de donnes vers une ou plusieurs destination(s). Map editor Le Map Editor vous permet de dfinir les proprits du routage et des transformations du tXMLMap. Si vous ne souhaitez pas grer les erreurs dexcutions, vous pouvez cocher la case Die on error (coche par dfaut) dans la barre suprieure de la zone de sortie. Cela arrtera la Job en cas derreur.
Objectif
Basic settings
Advanced settings
Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.
Utilisation
Plusieurs utilisations sont possibles, de la simple rorganisation des champs de donnes aux transformations les plus complexes, telles que le multiplexage et le dmultiplexage de donnes, la concatnation, linversion, le filtrage, etc. Ce composant est utilis comme composant intermdiaire et correspond parfaitement au processus ncessitant de nombreuses sources de donnes XML, comme les processus ESB de requte/rponse. Lutilisation du composant tXMLMap requiert des connaissances minimales en Java et XML afin dexploiter au mieux ses fonctionnalits. Ce composant est une tape de jonction. Il ne peut donc tre ni un composant dentre, ni un composant de sortie. Un seul lment de boucle est requis pour chaque flux de donnes XML. Pour plus dinformations, consultez Mapping de flux de donnes dans le Guide utilisateur de Talend Open Studio.
Limitation
Scnario : Mapper et transformer des donnes de source XML

Dans ce scnario, un Job trois composants est excut pour mapper et transformer des donnes provenant dune source XML, customer.xml, et gnrer un flux de sortie XML pouvant tre rutilis dans diffrents buts, comme, par exemple, pour une requte ESB.
tXMLMap
Ces trois composants sont : tFileInputXML : ce composant est utilis pour fournir des donnes dentre au tXMLMap. tXMLMap : ce composant mappe et transforme les flux de donnes XML en un seul flux de donnes XML. tLogRow : ce composant est utilis pour afficher les donnes de sortie.
Afin de reproduire ce scnario, procdez comme suit : De la Palette, dposez un tFileInputXML, un tXMLMap et un tLogRow dans lespace de modlisation graphique.
Un composant utilis dans lespace de modlisation peut tre renomm comme vous le souhaitez. Dans ce scnario, le composant dentre est nomm Customers. Pour plus dinformations concernant le renommage dun composant, consultez la section Onglet View dans le Guide utilisateur de Talend Open Studio.
Double-cliquez sur le composant tFileInputXML nomm Customers pour ouvrir son menu contextuel. Dans ce menu, slectionnez Row > Main afin de relier ce composant au tXMLMap. Rptez lopration afin de connectez ensuite le tXMLMap au tLogRow laide dun lien Row > *New output* (Main). Une bote de dialogue souvre et vous demande de nommer ce lien de sortie. Dans ce scnario, nommez-le Customer_States.
Double-cliquez sur le composant tFileInputXML nomm Customers afin dafficher sa vue Basic settings.
1590
tXMLMap
A ct du champ Edit schema, cliquez sur le bouton [...] afin douvrir lditeur du schma.
Dans lditeur du schma, cliquez sur le bouton [+] pour ajouter une ligne. Dans la colonne Column, saisissez un nouveau nom pour cette ligne. Dans ce scnario, le nom est Customer. Dans la colonne Type, slectionnez le type de donnes de cette ligne. Dans ce scnario, le type est Document. Le type de donnes document est essentiel pour utiliser au maximum les fonctionnalits du tXMLMap. Pour plus dinformations concernant ce type de donnes, consultez la section Utiliser le type Document dans le Guide utilisateur de Talend Open Studio. Cliquez sur OK pour valider ce changement et acceptez la propagation propose par la fentre pop-up. Une ligne est ajoute automatiquement la table Mapping. Dans le champ File name / Stream, parcourez votre systme jusquau fichier XML source fournissant les donnes client, ou bien saisissez son chemin daccs. Dans le champ Loop XPath query, saisissez / pour remplacer le paramtre par dfaut. Cela signifie que les donnes source sont interroges depuis la racine.
1591
tXMLMap
Dans la colonne XPath query de la table Mapping, saisissez le XPath. Dans ce scnario, saisissez ., ce qui signifie que toutes les donnes de la source seront interroges. Cochez la case Get Nodes dans la colonne de la table Mapping. Double-cliquez sur le composant tXMLMap pour ouvrir le Map Editor. Notez que la zone dentre est dj remplie par les tables dentre dfinies et que la table suprieure est la table principale dentre (flux Main). Dans la table gauche, cliquez-droit sur Customer pour ouvrir le menu contextuel.
Dans ce menu contextuel, slectionnez Import From File et dans la fentre pop-up, parcourez votre systme jusquau fichier source correspondant, afin dimporter la structure XML utilise par les donnes reues par le tXMLMap. Dans ce scnario, le fichier source est Customer.xml, qui est galement connects au tFileInputXML (Customers). Dans la table du ct gauche, cliquez-droit sur le noeud Customer et slectionnez As loop element pour le dfinir comme lment de boucle.
Dans la partie infrieure du Map Editor, cliquez sur longlet Schema editor afin dafficher la vue correspondante. Du ct droit de cette vue, cliquez sur le bouton [+] pour ajouter une ligne la table Customer et renommez cette ligne Customer_States.
Dans la colonne Type de la ligne Customer_States, slectionnez Document comme type de donnes. La racine XML correspondante est ajoute automatiquement la table suprieure, du ct droit, qui reprsente le flux de sortie.
1592
tXMLMap
Du ct droit de la table suprieure nomme Customer_States, importez la structure XML des donnes que vous devez utiliser du fichier source XML correspondant. Dans ce scnario, le fichier est Customer_State.xml.
Cliquez-droit sur le noeud customer et slectionnez As loop element dans le menu contextuel. Vous pouvez ensuite commencer mapper le flux dentre vers le flux de sortie. Dans la table du ct de lentre (gauche) du Map Editor, cliquez sur le noeud id et glissez-le dans la colonne Expression dans la ligne correspondant la ligne de sortie que vous devez mapper. Dans ce scnario, le noeud est @id.
1593
tXMLMap
Rptez lopration pour mapper CustomerName CustomerName, CustomerAddress CustomerAddress et idState idState du ct gauche au ct droit. Cliquez sur OK pour valider le mapping et fermer le Map Editor. Appuyez sur F6 pour excuter le Job.
1594
Composants System
Ce chapitre passe en revue les principaux composants de la famille System de la Palette de Talend Open Studio. La famille System regroupe les composants permettant dinteragir avec votre systme dexploitation.
Composants System
tRunJob
tRunJob
Proprits du tRunJob
Famille de composant System
Le composant tRunJob excute le Job spcifi dans ses proprits dans un contexte dfini. Le tRunJob permet de matriser des systmes de Job complexes devant tre excuter lun aprs lautre. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma dans cette vue, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent dans le Job. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Use dynamic job Cochez cette case afin de pouvoir appeler et traiter de nombreux Jobs. Lorsque cette case est coche, seule la dernire version des Jobs peut tre appele et traite. Un processus indpendant sera utilis pour excuter le sous-job. Les options Context et Use an independent process to run subjob disparaissent. Ce champ est visible uniquement lorsque loption Use dynamic job est coche. Saisissez le nom du Job que vous souhaitez appeler dans la liste des Jobs slectionns. Cliquez sur ce bouton pour rcuprer le schma du Job fils. Slectionnez le Job appeler et traiter. Assurez-vous que le Job appel ait t excut au moins une fois auparavant pour que son excution via le tRunJob se droule le mieux possible.
Context job
CopyChild Job Schema Job
1596
Composants System
tRunJob
Version Context
Slectionnez la version du Job fils que vous souhaitez utiliser. Si vous avez paramtr des contextes et des variables pour les Jobs excuter via le tRunJob, slectionnez dans la liste le contexte appliquer. Cochez cette case afin dutiliser un processus idpendant pour excuter le sous-job. Cela vous permettra de rsoudre des problmes lis la taille limite de la mmoire. Dcochez cette case pour excuter le Job parent mme sil y a une erreur lors de lexcution du Job fils. Cochez cette case pour obtenir les contextes du Job parent. Dcochez-la pour obtenir les contextes du Job fils. Vous pouvez modifier les paramtres de contexte slectionns. Cliquez sur le bouton [+] pour ajouter les paramtres tels quils ont t dfinis dans le contexte du Job fils. Pour plus dinformations sur les paramtres de contexte, consultez la section Dfinir les paramtres de contexte du Guide Utilisateur de
Use an independent process to run subjob Die on child error
Transmit whole context Context Param
Talend Open Studio.

Advanced settings Print Parameters tStatCatcher Statistics Utilisation Cochez cette case pour afficher les paramtres internes et externes dans la Console. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant peut tre utilis en Job standalone ou peut aider clarifier certains Jobs complexes en vitant davoir un nombre important de sous-jobs dans le mme Job. Child return code : indique le code de retour Java du Job fils. Disponible comme variable After. Retourne un entier : sans erreur > la valeur du code est 0. avec erreur(s) > un message derreur apparat. Child exception stack trace : retourne la trace de la pile Java dun Job fils. Disponible comme variable After. Retourne une chane de caractres. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Global Variables
1597
Composants System
tRunJob
Connections
Liens de sortie (dun composant un autre) : Row : Main. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError. Liens dentre (dun composant un autre) : Row : Main, Reject, Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
Scnario : Excuter un Job fils

Le scnario suivant dcrit un Job un composant appelant et excutant un autre Job. Le Job excuter lit une liste de fichiers dlimits de base et affiche son contenu dans la console de la vue Run. La particularit de ce Job rside dans le fait que ce dernier est excut partir dun autre Job et utilise la variable de contexte provenant du fichier dentre devant tre trait.
Crez le premier Job lisant un fichier dlimit. A partir de la Palette, cliquez et dposez les composants tFileInputDelimited et tLogRow dans lespace de modlisation. Connectez ces deux composants laide dun lien de type Row Main. Double-cliquez sur le composant tFileInputDelimited pour afficher la vue Basic settings et paramtrer les proprits du composant dentre. Dans la liste droulante Property Type, slectionnez loption Built-In.
1598
Composants System
tRunJob
Cliquez dans le champ File Name puis appuyez sur la touche F5 pour ouvrir la fentre de configuration de variable. Nommez File cette nouvelle variable de contexte.
Pour cet exemple, laissez les paramtres par dfaut, i.e. ne cochez pas la case Prompt for value et laissez le champ Prompt vide. Cliquez sur Finish pour valider puis appuyez sur Enter pour vous assurer que la nouvelle variable de contexte est conserve dans le champ File Name. Dans les champs Field separator et Row separator de longlet Basic settings, renseignez respectivement les sparateurs de champs et de lignes utiliss dans le fichier dentre. Dans cet exemple, les fichiers ne possdent ni en-tte ni pied de page. Ainsi, laissez les champs Header et Footer vides. Les fichiers sont relativement courts, vous pouvez donc laisser le champ Limit vide.
1599
Composants System
tRunJob
Dans la liste droulante Schema type, slectionnez loption Built-in. Cliquez sur le bouton [...] pour configurer manuellement le schma. Ajoutez deux colonnes et nommez-les comme les deux premires colonnes du fichier dentre. Dans cet exemple : username et age.
Si vous avez stock le schma dans le Repository, slectionnez la mtadonne correspondant la structure de votre fichier dentre.
Double-cliquez sur le composant tLogRow pour afficher la vue Basic settings et paramtrer les proprits du composant de sortie. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant dentre puis paramtrez les autres options selon vos besoins. Enregistrez le Job fils puis appuyez sur la touche F6 vous assurer quil sexcute correctement. Crez le deuxime Job jouant le rle de Job parent. Cliquez et dposez les composants tFileList et tRunJob dans lespace de modlisation. Connectez ces deux composants laide dun lien de type Iterate. Double-cliquez sur le composant tFileList pour afficher la vue Basic settings et paramtrer les proprits du composant.
Dans le champ Directory, renseignez le chemin daccs au rpertoire contenant les fichiers traiter ou cliquez sur le bouton [...] pour parcourir vos dossiers jusqu ce rpertoire. Dans cet exemple, il sagit du rpertoire tRunJob qui contient trois fichiers dlimits. Dans la liste droulante FileList Type, slectionnez loption Files. Cochez la case Use Glob Expressions as Filemask pour pouvoir utiliser des expressions rgulires dans vos masques. Cliquez sur le bouton [...] pour ajouter un masque et renseignez le filtre appliquer. Dans cet exemple, les fichiers rcuprer sont de type dlimit, le filtre choisi est *.csv. Double-cliquez sur le composant tRunJob pour afficher la vue Basic settings et paramtrer les proprits du composant.
1600
Composants System
tRunJob
Cliquez sur le bouton [...] ct du champ Job pour accder la bote de dialogue [Find a Job].
Slectionnez le Job fils excuter puis cliquez sur OK pour fermer la bote de dialogue. Le nom du Job slectionn apparat dans le champ Job de la vue Basic settings du tRunJob. Cliquez sur le bouton Copy Child Job Schema pour rcuprer le schma dfini dans le Job fils. Cliquez sur le bouton [+] pour ajouter une ligne de paramtres dans le champ Context Param.
1601
Composants System
tRunJob
Cliquez dans la cellule Values puis appuyez sur Ctrl+Espace pour accder la liste des variables de contexte et slectionnez le contexte tFileList-1.CURRENT_FILEPATH. La cellule Values est automatiquement renseigne par la variable de contexte correspondante : ((String)globalMap.get(tFileList-1.CURRENT_FILEPATH)). Pour plus dinformations sur les paramtres de contexte, consultez la section Dfinir les paramtres de contexte du Guide Utilisateur de Talend Open Studio. Enregistrez le Job matre puis appuyez sur la touche F6 pour lexcuter.
Le Job appel lit les donnes contenues dans les fichiers dentre comme dfini dans le schma dentre et le rsultat de ce Job est directement affich dans la console Run. Voir galement : Le composant tLoop, page 1459, Le Scnario 1 : Mettre des donnes en tampon (Java), page 1413 du composant tBufferOutput.
1602
Composants System
tSetEnv
tSetEnv
Proprits du tSetEnv
Famille du composant System
Fonction Objectif
Le composant tSetEnv ajoute des variables lenvironnement du systme de manire temporaire, pendant lexcution du Job. Le tSetEnv permet de crer des variables et dexcuter un Job script en communicant les informations des variables nouvellement cres entre les diffrents sous-jobs. Aprs lexcution du Job, ces nouvelles variables sont supprimes. Parameters Cliquez sur le bouton [+] pour ajouter les variables ncessaires au Job. name : Renseignez la syntaxe de la nouvelle variable. value : Entrez une valeur pour ce paramtre en fonction du contexte. append : Cochez cette case pour ajouter la nouvelle variable la fin.
Basic settings
Le tSetEnv peut tre utilis comme composant de dbut ou composant intermdiaire. n/a
Scnario : Modifier la variable Date lors de lexcution dun Job

Le scnario suivant est un Job qui permet de lire une colonne dans une base de donnes Oracle, de rcuprer la date courante partir de cette colonne en utilisant une requte de base de donnes de crer une nouvelle variable grce au tSetEnv pour modifier le format de la date puis dafficher la date modifie dans la console. Pour modifier le format de la date en utilisant une nouvelle variable cre par le tSetEnv : A partir de la Palette, cliquez-dposez les composants tSetEnv, tOracleInput et tLogRow dans lditeur graphique. Connectez le tSetEnv au tOracleInput laide dun lien OnSubjobOk. Connectez le tOracleInput au tLogRow laide dun lien Row Main.
1603
Composants System
tSetEnv
Slectionnez le tSetEnv dans lditeur graphique puis cliquez sur la vue Component. Dans longlet Basic settings, cliquez sur le bouton [+] pour ajouter une ligne de paramtres et dfinissez votre nouvelle variable. Cliquez dans la cellule name puis renseignez la syntaxe de la variable concernant la date. Dans cet exemple, on utilise NLS_DATE_FORMAT. Cliquez dans la cellule value puis renseignez la valeur dsire pour votre nouvelle variable de date.
Dans cet exemple, on veut transformer le format de date DD-MMM-YY prdfini par le systme en YYYY-MM-DD. Slectionnez le tOracleInput puis cliquez sur longlet Component . Paramtrez la configuration de base (Basic settings) du composant tOracleInput. Pour plus dinformations, consultez le composant tOracleInput, page 734.
1604
Composants System
tSetEnv
Dans cet exemple, on effectue une requte sur une base Oracle pour extraire les donnes contenues dans la colonne the REGISTERDATE de la table NEW_CUSTOMERS_MLE. Slectionnez le tLogRow puis cliquez sur la vue Component. Renseignez la configuration de base (Basic settings) du composant tLogRow. Pour plus dinformations, consultez le composant tLogRow, page 1399. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
La date saffiche dans la console au format YYYY-MM-DD modifi par le composant tSetEnv. Pour afficher la date au format pr-dfini par le systme en utilisant ce Job : Dans lespace graphique, cliquez-droit sur le composant tSetEnv et slectionnez loption Deactivate tSetEnv_1 partir de la liste droulante. Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
1605
Composants System
tSetEnv
La date saffiche dans la console au format DD-MMM-YY pr-dfini par le systme.
1606
Composants System
tSSH
tSSH
Proprits du tSSH
Le composant tSSH renvoie les donnes dun ordinateur distant via le protocole Secure Shell dfini. Le tSSH permet dentrer en communication avec un serveur distant et de renvoyer les informations de scurit. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma dans cette vue, il devient automatiquement Built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent dans le Job. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Host Port User Adresse IP. Numro du port dcoute. Informations dauthentification de lutilisateur. Slectionnez loption adquate. Si vous choisissez loption Public Key, saisissez la passphrase (phrase secrte), si ncessaire, dans le champ Key passphrase. Puis, dans le champ Private Key, saisissez la cl prive ou cliquez sur le bouton [...] ct du champ Private Key pour parcourir votre rpertoire jusqu la cl prive. Slectionnez loption adquate. Si vous choisissez loption Password, saisissez votre mot de passe dans le champ Password. Slectionnez loption adquate. Si vous choisissez loption Keyboard Interactive, saisissez le mot de passe requis dans le champ Password.
Authentication method
Public Key/Key Passphrase/Private Key
Password/Password
Keyboard Interactive/Password
1607
Composants System
tSSH
Pseudo terminal
Cochez cette case pour appeler un interprteur de commandes interactif effectuant les oprations de terminal. Saisissez le sparateur de commandes requis. Lorsque la case Pseudo terminal est coche, ce champ nest plus disponible. Saisissez la commande permettant de rcuprer linformation de lordinateur distant. Lorsque la case Pseudo terminal est coche, ce tableau devient un mulateur de terminal, et chaque ligne du tableau devient une commande. Dfinit la dure avant expiration. Un message notifiant lexpiration sera gnr si lactuel temps de rponse dpasse ce dlai dexpiration. Slectionnez la destination de la sortie standard retourner La sortie peut tre retourne vers : - la console (to console) : la sortie saffiche dans la console de la vue Run. - les variables globales (to global variables) : la sortie est indique par la variable globale correspondante. - la console et les variables globales (both to console and global variable) : la sortie est indique par les deux moyens. - une sortie normale (normal) : la sortie est une sortie SSH standard. Slectionnez la destination de la sortie derreurs retourner. La sortie peut tre retourne vers : - la console (to console) : la sortie saffiche dans la console de la vue Run. - les variables globales (to global variables) : la sortie est indique par la variable globale correspondante. - la console et les variables globales (both to console and global variable) : la sortie est indique par les deux moyens. - une sortie normale (normal) : la sortie est une sortie SSH standard.
Command separator
Commands
Use timeout/timeout in seconds Standard Output
Error Output
Utilisation
Ce composant peut tre utilis en standalone.
1608
Composants System
tSSH
Global variables
Standard Output : Indique la sortie standard de lexcution de la commande distante. Disponible en tant que variable After. Retourne une chane de caractres. Error output : Indique la sortie derreurs de lexcution de la commande distante. Disponible en tant que variable After. Retourne une chane de caractres. Exit value : Indique le statut de sortie de la commande distante. Disponible en tant que variable After. Retourne un entier. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Row : Main. Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error. Liens dentre (dun composant un autre) : Row : Main, Iterate. Trigger : Run if, On Component Ok, On Component Error, On Subjob Ok, On Subjob Error. Pour plus dinformations concernant les connexions, consultez Types de connexions du Guide Utilisateur Talend Open Studio.
Limitation
Lutilisation de ce composant est adapte pour les systmes de type Unix.
Scnario : Accder aux informations du systme distant via SSH

Le scnario suivant dcrit un Job utilisant un protocole SSH pour afficher le nom dhte du serveur distant auquel vous souhaitez vous connecter et la date actuelle de ce systme distant. Un composant tSSH est suffisant pour ce Job. Cliquez et dposez-le de la famille System de la Palette. Double-cliquez sur le tSSH et slectionnez longlet Basic settings de la vue Component.
1609
Composants System
tSSH
Renseignez le nom de lhte dans le champ Host auquel accder partir du SSH, ainsi que le numro du port dans le champ Port. Dans le champ User, renseignez le nom didentification de lutilisateur sur lordinateur distant. Slectionnez la mthode dauthentification dans la liste droulante Authentication method. Dans cet exemple, la mthode dauthentification utilise est Public key (cl publique). Renseignez donc le champ Private key avec votre cl prive. Dans le champ Command, saisissez la commande suivante. Dans cet exemple, saisissez hostname; date entre guillemets simples (puisque le Job est gnr en Perl). Cochez la case Use timeout et paramtrez la dure avant expiration 5 secondes.
Lordinateur distant renvoie le nom de lhte, ainsi que la date et lheure en cours.
1610
Composants System
tSystem
tSystem
Proprits du tSystem
Le composant tSystem excute une ou plusieurs commande(s) systme. tSystem peut appeler dautres commandes de traitement, fonctionnant dj dans un Job plus grand. Use home directory Command Cochez cette case pour changer le nom et le chemin du rpertoire ddi. Saisissez la commande systme excuter. Notez que la syntaxe nest pas vrifie. Sous Windows, les commandes MS-DOS ne permettent pas de passer directement du dossier courant au dossier contenant le fichier excuter. Pour excuter un fichier, vous devez donc utiliser une premire commande afin de changer de dossier courant, puis une deuxime commande excutant le fichier. Standard Output et Error Output Slectionnez le type de sortie auquel les donnes traites seront transfres. to console : transmet les donnes vers la console de la vue Run. to global variable : les donnes sont envoyes dans une variable de sortie lie au composant tSystem. both to console and to global variable : les donnes sont envoyes la fois vers la console de la vue Run et dans une variable de sortie lie au composant tSystem. normal : les donnes sont envoyes au composant suivant. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma dans cette vue, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent dans le Job.
1611
Composants System
tSystem
Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Environment variables Cliquez sur le bouton [+] pour ajouter les variables denvironnement ncessaires au Job. name : Renseignez la syntaxe de la nouvelle variable. value : Entrez une valeur pour ce paramtre en fonction du contexte.
Ce composant sert aux entreprises qui utilisent dj dautres applications quils souhaitent intgrer leur flux via Talend. Standard Output : retourne la sortie standard dun processus. Disponible comme variable After. Retourne une chane de caractres. Error Output : retourne la sortie errone dun processus. Disponible comme variable After. Retourne une chane de caractres. Exit Value : retourne un code de sortie. Disponible comme variable After. Retourne un entier : -sans derreur > le code de sortie est 0. -avec erreurs(s) > le code de sortie est 1. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 dans le Guide Utilisateur Talend Open Studio.
Connections
Liens de sortie (dun composant un autre) : Row : Main. Trigger : OnSubjobOk, OnSubjobError, Run if. Liens dentre (dun composant un autre) : Row : Main, Reject, Iterate. Trigger : OnSubjobOk, OnSubjobError, Run if, OnComponentOk, OnComponentError, Synchronize, Parallelize. Pour plus dinformations concernant les liens, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
n/a
1612
Composants System
tSystem
Scnario : Echo Hello World!

Ce scnario est constitu dun Job deux composants permettant dafficher un message dans la console de la vue Run.
A partir de la Palette, dposez les composants tSystem et tJava dans lespace graphique. Cliquez-droit sur le composant tSystem et slectionnez un lien de type OnSubjobOk pour relier ces deux composants. Lorsque vous excutez le Job, le premier composant dclenchera le deuxime. Double-cliquez sur le composant tSystem pour afficher longlet Basic settings et configurer ses paramtres de base.
Dans le champ Command, saisissez la commande echo suivie de la chane de caractres afficher : cmd /c echo HELLO WORLD Dans le champ Standard Output, slectionnez loption to a global variable pour envoyer la sortie dans une variable globale. Laissez les autres champs par dfaut. Slectionnez ensuite le composant tJava.
1613
Composants System
tSystem
Saisissez la commande Java permettant dafficher la variable de sortie du tSystem dans la console : System.out.println(Hello World!); Enregistrez votre Job puis appuyez sur F6 pour lexcuter.
Le Job excute une commande echo et affiche la sortie dans la console de log de la vue Run grce la fonction println de la commande Java du composant tJava.
1614
Composants Talend MDM

Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille Talend MDM de la Palette de Talend Open Studio. La famille Talend MDM regroupe les composants qui lisent et crivent des donnes dans les fichiers XML du hub XML MDM.

tMDMBulkLoad
tMDMBulkLoad
Proprits du tMDMBulkLoad
Famille de composant Talend MDM
Fonction Objectif
Le composant tMDMBulkLoad crit en masse des donnes matre structures XML dans le hub MDM. Ce composant utilise le mode bulk pour crire des donnes, de faon ce que de gros lots de donnes ou des donnes trs complexes puissent tre charg(e)s rapidement sur le serveur MDM. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Si vous modifiez le schma, il redevient automatiquement built-in. Cliquez sur le bouton Sync columns afin de rcuprer le schma du composant prcdent. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. XML Field URL Username et Password Version Slectionnez le nom de la colonne dans laquelle vous souhaitez crire les donnes XML. Saisissez lURL daccs au serveur MDM. Informations dauthentification de lutilisateur du serveur MDM. Saisissez le nom de la Version des donnes matre laquelle vous souhaitez vous connecter, en fonction de vos droits utilisateur. Laissez ce champ vide pour afficher la Version par dfaut des donnes matre. Saisissez le nom du modle de donnes par rapport auquel vous souhaitez valider les donnes crire. Saisissez le nom du conteneur de donnes contenant les donnes que vous souhaitez crire. Saisissez le nom de lentit contenant les donnes que vous souhaitez effacer.
Basic settings
Data model Data Container Entity
1616

tMDMBulkLoad
Validate
Cochez cette case afin de valider les donnes que vous souhaitez crire sur le serveur MDM, par rapport des rgles de validation dfinies pour le modle de donnes courant. Pour plus dinformations concernant la dfinition des rgles de validation, consultez Modles de donnes dans le Guide Administrateur de Talend Master Data Management. Si vous prfrez un chargement plus rapide, ne cochez pas cette case.
Generate ID
Cochez cette case pour gnrer un identifiant aux donnes crites. Si vous prfrez un chargement plus rapide, ne cochez pas cette case.
Commit size Advanced settings Connections tStatCatcher Statistics
Saisissez le nombre de lignes de chaque lot crire sur le serveur MDM. Cochez cette case pour collecter les donnes de log au niveau du composant. Liens de sortie (dun composant un autre) : Row : Main. Trigger : Run If, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError. Liens dentre (dun composant un autre) : Row : Main. Trigger : Run If, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Utilisation
Ce composant ncessite toujours un flux dentre afin de stucturer des donnes en XML. Si vos donnes ne sont pas encore structures XML, vous devez utiliser des composants tels que le tWriteXMLField afin de transformer ces donnes en XML. Pour plus dinformations concernant le tWriteXMLField, consultez tWriteXMLField, page 1709.
Amliorer les chargements de donnes MDM de masse

Les informations ci-dessous concernent uniquement MDM utilis avec eXist. Lanalyse XML est un processus qui consomme beaucoup de ressources du processeur et de mmoire et qui nest pas vraiment compatible avec des ensembles de donnes particulirement volumineux. Le Scnario : Charger des enregistrements dans une entit mtier donn en exemple pour le composant tMDMBulkLoad possde des limitations parce quil ne fonctionne pas avec un ensemble de donnes trs volumineux, pour le moment au moins. Un scnario alternatif dans lequel vous pouvez traiter lensemble de donnes par itrations de chargement de masse peut tre cr comme suit :
1617

tMDMBulkLoad
Dans un tel scnario, le composant tMDMBulkLoad attend des donnes XML en entre. Vous devez formater manuellement ces donnes entrantes afin de les faire correspondre au schma de lentit dfini dans MDM Studio. La plupart du temps, les donnes que vous souhaitez importer sont au format plat et vous devez les transformer en XML. Puisque lanalyse XML consomme beaucoup de mmoire, vous pouvez rgler ce problme en sparant votre fichier source en plusieurs fichiers utilisant le composant tAdvancedFileOutputXML. Pour ce faire, slectionnez loption Split output in several files dans la vue Advaced settings du composant puis configurez les lignes dans chaque fichier de sortie via une variable de contexte (context.chunkSize), par exemple.
Le schma XML que vous devez dfinir dans lditeur XML du composant doit tre une correspondance exactea de lentit mtier dfinie dans le Studio MDM. Le schma XML dans

tMDMBulkLoad
lditeur doit reprsenter un seul lment racine <root> qui contient tous les autres lments, Afin que vous puissiez effectuer une boucle sur chaque lment. Le chemin daccs au fichier doit tre dfini dans un dossier temporaire. Utilisez un composant tFileList pour lire tous les fichiers XML ayant t crs. Ce composant vous permet de parallliser le processus. Connectez-le un composant tFileInputXML laide dun lien Iterate.
Pour le lien Iterate, il est recommand de configurer autant de processus dexcution quil y a de coeurs votre ordinateur. Vous pouvez faire ceci en utilisant Runtime.getRuntime().availableProcessors()
Le composant tFileInputXML va lire les donnes des fichiers XML que vous avez crs, en dfinissant une boucle sur les lments et en rcuprant tous les noeuds dj formats en XML. Vous devez ensuite cocher la case Get Nodes.
Enfin, vous devez configurer le composant tMDMBulkLoad comme suit :
Soyez sr davoir configur la taille de commit avec la mme valeur que celle dfinie dans le composant tAdvancedfileOutputXML, la variable de contexte context.chunkSize.
Le composant tFiledelete dans ce scnario va supprimer toutes les donnes temporaires la fin du Job.
1619

tMDMBulkLoad
Scnario : Charger des enregistrements dans une entit mtier

Ce scnario dcrit un Job qui charge des enregistrements dans lentit mtier ProductFamily dfinie par un modle de donnes spcifique dans le hub MDM. Prrequis pour ce Job : Le conteneur de donnes Product : ce conteneur de donnes est utilis pour sparer le domaine de donnes matre des produits des autres domaines de donnes matre. Le modle de donnes Product : ce modle de donnes est utilis pour dfinir les attributs, les rgles de validation, les droits daccs des utilisateurs et les relations des entits en rapport. Il dfinit les attributs de lentit mtier ProductFamily. Lentit mtier ProductFamily : cette entit mtier contient les attributs Id et Name, dfinis dans le modle de donnes Product. Pour plus dinformations concernant la cration dun conteneur de donnes, dun modle de donnes et dune entit mtier ainsi que de ses attributs, consultez le Guide Administrateur de Talend Master Data Management. Le Job dans ce scnario utilise trois composants.
Un tFixedFlowInput : ce composant gnre les enregistrements charger dans lentit mtier ProductFamily. Gnralement, les enregistrements charger sont volumineux et stocks dans un fichier spcifique, cependant, pour faciliter la reproduction de ce scnario, ce Job utilise un tFixedFlowInput afin de gnrer quatre exemples denregistrements. Un tWriteXMLField : ce composant transforme les donnes dentre pour leur donner une structure XML. Un tMDMBulkLoad : ce composant crit en masse les donnes dentre dans lentit mtier ProductFamily et gnre une valeur dID pour chaque donne de lenregistrement. Pour reproduire ce scnario, procdez comme suit : Dposez un tFixedFlowInput, un tWriteXMLField et un tMDMBulkLoad de la Palette dans lespace de modlisation graphique. Cliquez-droit sur le tFixedFlowInput afin douvrir son menu contextuel. Slectionnez Row > Main pour relier le tFixedFlowInput au composant suivant laide dun lien Main. Rptez lopration pour lier les autres composants. Double-cliquez sur le tFixedFlowInput afin douvrir sa vue Basic settings.
1620

tMDMBulkLoad
Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir lditeur du schma.
Dans lditeur du schma, cliquez sur le bouton [+] pour ajouter une ligne. Cliquez sur la nouvelle et saisissez son nom : family. Cliquez sur OK. Dans la zone Mode de la vue Basic settings, slectionnez loption Use inline table. Sous le tableau, cliquez sur le bouton [+] quatre fois afin dajouter quatre lignes au tableau. Dans le tableau, cliquez sur chacune des lignes ajoutes et saisissez leur nom, entre guillemets : Shirts, Hats, Pets, Mugs (Chemises, chapeaux, vtements pour animaux, tasses). Double-cliquez sur le composant tWriteXMLField afin douvrir sa vue Basic settings.
1621

tMDMBulkLoad
Cliquez sur le bouton [...] ct du champ Edit schema afin douvrir lditeur du schma, dans lequel vous pouvez ajouter une ligne en cliquant sur le bouton [+].
Cliquez sur la nouvelle ligne, dans la partie droite de lditeur du schma et saisissez le nom de la colonne de sortie dans laquelle vous souhaitez crire le contenu XML. Dans cet exemple, saisissez xmlRecord. Cliquez sur OK pour valider le schma de sortie et fermer lditeur du schma. Dans la bote de dialogue qui souvre, cliquez sur OK afin de propager le schma au composant suivant. Dans la vue Basic settings, cliquez sur le bouton [...] ct du champ Configure Xml Tree pour ouvrir linterface permettant de crer la structure XML.
1622

tMDMBulkLoad
Dans la zone Link Target, cliquez sur rootTag et renommez le champ ProductFamily, qui est le nom de lentit mtier utilise dans ce scnario. De la zone Linker source, glissez-dposez family dans ProductFamily, dans la zone Link target. Une bote de dialogue saffiche et vous demande quel type dopration vous souhaitez effectuer. Slectionnez Create as sub-element of target node afin de crer un sous-lment du noeud ProductFamily. Llment family apparat sous le noeud ProductFamily. Dans la zone Link target, cliquez sur le noeud family et renommez-le Name, qui est lun des attributs de lentit mtier ProductFamily. Cliquez-droit sur le noeud Name et slectionnez Set As Loop Element dans le menu contextuel. Cliquez sur OK afin de valider la structure XML que vous avez dfinie. Double-cliquez sur le tMDMBulkLoad afin douvrir sa vue Basic settings.
Dans la liste XML Field, slectionnez xmlRecord. Dans le champ URL, saisissez lURL du serveur MDM, entre guillemets : par exemple, http://localhost:8080/talend/TalendPort. Dans les champs Username et Password, saisissez respectivement votre identifiant et votre mot de passe de connexion au serveur MDM. Dans les champs Data Model et Data Container, saisissez les noms correspondants au modle de donnes et au conteneur de donnes que vous souhaitez utiliser, Product pour les deux champs, dans ce scnario. Dans le champ Entity, saisissez le nom de lentit mtier dont les enregistrements doivent tre chargs. Dans cet exemple, saisissez ProductFamily. Cochez la case Generate ID afin de gnrer des valeurs dID pour les enregistrements charger. Appuyez sur F6 pour excuter le Job.
1623

tMDMBulkLoad
Connectez-vous linterface Web de Talend Master Data Management pour vrifier les nouveaux enregistrements de lentit mtier ProductFamily.
1624

tMDMDelete
tMDMDelete
Proprits du tMDMDelete
Le composant tMDMDelete supprime des enregistrements de donnes dentits spcifiques du hub MDM (rfrentiel XML). Ce composant efface des donnes matre du hub MDM. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Si vous modifiez le schma, il redevient automatiquement built-in. Cliquez sur le bouton Sync columns afin de rcuprer le schma du composant prcdent. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. URL Username et Password Version Saisissez lURL daccs au serveur MDM. Informations dauthentification de lutilisateur du serveur MDM. Saisissez le nom de la Version des donnes matre laquelle vous souhaitez vous connecter, en fonction de vos droits utilisateur. Laissez ce champ vide pour afficher la Version par dfaut des donnes matre. Saisissez le nom de lentit contenant les donnes que vous souhaitez effacer. Saisissez le nom du conteneur de donnes contenant les donnes que vous souhaitez effacer. Spcifiez le(s) champ(s) (dans lordre de la squence) composant la cl lorsque lentit possde une cl multiple.
Entity Data Container Keys
1625

tMDMDelete
Logical delete
Cochez cette case afin denvoyer les donnes matre dans la Corbeille, et renseignez le chemin daccs la Corbeille (Recycle bin path). Une fois dans la Corbeille, les donnes matre peuvent tre supprimes dfinitivement ou restaures. Si vous laissez la case dcoche, les donnes matre seront supprimes dfinitivement. Cochez cette case pour passer la ligne en erreur et terminer le processus afin dobtenir des lignes ne contenant aucune erreur. Si ncessaire, vous pouvez rcuprer les lignes en erreur en utilisant un lien de type Row > Rejects. Cochez cette case pour collecter les donnes de log au niveau du composant.
Die on error
Utilisez ce composant pour crire un fichier et sparer les champs laide dun sparateur spcifique.
Scnario : Supprimer des donnes matre dun hub MDM

Ce scnario dcrit un Job deux composants supprimant les enregistrements de donnes spcifis du rfrentiel XML MDM.
Glissez-dposez de la Palette dans lespace de modlisation graphique un composant tMDMInput et un composant tMDMDelete, de la famille Talend MDM. Connectez les deux composants laide dun lien Row > Main. Double-cliquez sur le composant tMDMInput afin dafficher sa vue Component et dfinir ses proprits.
1626

tMDMDelete
Dans la liste Property Type, slectionnez Built-in pour renseigner les champs manuellement. Si vous avez stock votre connexion MDM dans les mtadonnes du Repository, slectionnez Repository dans la liste, et les champs seront automatiquement remplis. Dans la liste Schema Type, slectionnez Built-in et cliquez sur le bouton [...] ct du champ Edit schema, afin douvrir une bote de dialogue dans laquelle vous pourrez dfinir la structure des donnes matre que vous souhaitez lire dans le hub MDM.
Les donnes matre sont collectes dans un schma compos de quatre colonnes de type String : Id, Name, City et State. Cliquez sur OK pour fermer la bote de dialogue et procder ltape suivante. Dans le champ URL, saisissez entre guillemets lURL du serveur MDM : "http://localhost:8080/talend/TalendPort". Dans les champs Username et Password, saisissez votre identifiant et votre mot de passe de connexion au serveur MDM.
1627

tMDMDelete
Dans le champ Version, saisissez entre guillemets le nom de la Version des donnes matre laquelle vous souhaitez accder. Laissez ce champ vide afin dafficher la Version des donnes matre par dfaut. Dans le champ Entity, saisissez entre guillemets le nom de lentit mtier contenant les enregistrements de donnes que vous souhaitez lire. Ici, travaillez avec lentit Agency. Dans le champ Data Container, saisissez entre guillemets le nom du conteneur de donnes contenant les donnes matre que vous voulez lire. Ici, utilisez le conteneur DStar.
La case Use multiple conditions est coche par dfaut.
Dans le tableau Operations, dfinissez les conditions de filtre des donnes matre que vous souhaitez supprimer : -cliquez sur le bouton [+] afin dajouter une nouvelle ligne. Dans la colonne Xpath, saisissez entre guillemets le chemin Xpath et la balise du noeud XML sur lequel vous souhaitez appliquer le filtre. Ici, travaillez avec lentit Agency, saisissez Agency/Id. Dans la colonne Function, slectionnez la fonction que vous souhaitez utiliser. Dans ce scnario, utilisez la fonction Starts With. Dans la colonne Value, saisissez la valeur de votre filtre. Ici, lobjectif est de filtrer les donnes matre dont lID commence par TA. Dans la vue Component, cliquez sur longlet Advanced settings afin de configurer les paramtres avancs.
Dans le champ Loop XPath query, saisissez entre guillemets la structure et le nom du noeud XML sur lequel excuter la boucle. Dans la zone Mapping et dans la colonne XPath query, saisissez entre guillemets le nom de la balise XML sur laquelle vous souhaitez collecter les donnes matre, ct de la colonne de sortie correspondante. Dans lespace de modlisation graphique, cliquez sur le composant tMDMDelete afin dafficher sa vue Component et dfinir ses proprits.
1628

tMDMDelete
Dans la liste Schema, slectionnez Built-in et cliquez sur le bouton [...] ct du champ Edit Schema, afin de dcrire la structure des donnes matre du hub MDM.
Cliquez sur le bouton [+], droite, afin dajouter une colonne de type String. Nommez-la xmlOutput. Cliquez sur OK. Dans le champ URL, saisissez lURL requise pour vous connecter au serveur MDM, par exemple : "http://localhost:8080/talend/TalendPort". Dans les champs Username et Password, saisissez les informations dauthentification requises afin de vous connecter au serveur. Dans le champ Version, saisissez entre guillemets le nom de la Version des donnes matre laquelle vous souhaitez accder. Laissez le champ vide si vous souhaitez accder la Version par dfaut. Dans le champ Entity, saisissez le nom de lentit mtier contenant les donnes matre que vous souhaitez supprimer. Ici, travaillez avec lentit Agency.
1629

tMDMDelete
Dans le champ Data Container, saisissez le nom du conteneur de donnes contenant les donness supprimer. Ici, utilisez le conteneur DStar. Dans le tableau Keys, cliquez sur le bouton [+] afin dajouter une nouvelle ligne. Dans la colonne Keys, slectionnez la colonne contenant la cl de lentit Agency. Ici, la cl de lentit Agency est dans le champ Id.
Si lentit possde des cls multiples, ajoutez autant de lignes que ncessaire pour les cls, et slectionnez-les dans lordre squentiel.
Cochez la case Logical delete si vous ne voulez pas supprimer dfinitivement les donnes matre. Elles seront envoyes dans la Corbeille. Une fois dans la Corbeille, les donnes matre peuvent tre supprimes dfinitivement, ou bien restaures. Si vous laissez cette case dcoche, les donnes matre seront supprimes dfinitivement. Remplissez le champ Recycle bin path. Ici, vous avez laiss le chemin daccs la Corbeille par dfaut, mais si votre chemin daccs la Corbeille est diffrent de celui par dfaut, spcifiez-le. Appuyez sur Ctrl+S pour sauvegarder votre Job, puis sur F6 pour lexcuter. Les donnes dont lID commence par TA ont t supprimes et envoyes dans la Corbeille MDM.
1630

tMDMInput
tMDMInput
Proprits du tMDMInput
Le composant tMDMInput lit les donnes matre du hub MDM (rfrentiel XML). Ce composant lit les donnes matre dans un hub MDM et rend possible le traitement de ces donnes. Property Type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Si vous modifiez le schma, il redevient automatiquement built-in. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. URL Username et Password Version Saisissez lURL daccs au serveur MDM. Saisissez les informations dauthentification de lutilisateur du serveur MDM. Saisissez le nom de la Version des donnes matre laquelle vous souhaitez vous connecter, en fonction de vos droits utilisateur. Laissez ce champ vide pour afficher la Version par dfaut des donnes matre. Saisissez le nom de lentit contenant les donnes que vous souhaitez effacer. Saisissez le nom du conteneur de donnes contenant les donnes que vous souhaitez effacer.
Entity Data Container
1631

tMDMInput
Use multiple conditions Cochez cette case pour filtrer les donnes matre laide de conditions. Xpath : saisissez, entre guillemets, le noeud XML sur lequel appliquer la condition. Function : slectionnez la condition utiliser. Value : saisissez, entre guillemets, la valeur souhaite. Predicate : slectionnez un prdicat lorsque vous utilisez plusieurs conditions. Si vous dcochez cette case, vous avez la possibilit de slectionner des ID particuliers devant tre affichs dans la colonne ID value du tableau IDS. Si vous dcochez la case Use multiple conditions, loption Batch Size de longlet Advanced settings ne sera plus disponible. Skip rows Limit Die on error Renseignez le nombre de lignes ignorer. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ou traite. Cochez cette case pour passer la ligne en erreur et terminer le processus afin dobtenir des lignes ne contenant aucune erreur. Si ncessaire, vous pouvez rcuprer les lignes en erreur en utilisant un lien de type Row > Rejects. Nombre de lignes dans chaque lot trait. Cette option napparat pas si vous avez dcoch la case Use multiple conditions dans longlet Basic settings. Loop XPath query Mapping Noeud de larborescence XML sur lequel est base la boucle. Column : reflte le schma tel quil est dfini dans lditeur Edit Schema. XPath query : Saisissez les champs extraire de la structure XML dentre. Get Nodes : Cochez cette case pour rcuprer les balises XML entournant les donnes avec celles-ci. Cochez cette case pour collecter les donnes de log au niveau du composant.
Advanced settings
Batch Size
Ce composant est utilis comme composant de dbut. Il ncessite un flux de sortie..
Scnario : Lire les donnes matre dun hub MDM

Ce scnario dcrit un Job deux composants qui lit les donnes matre dans un serveur MDM et les affiche dans la console de log.
1632

tMDMInput
A partir de la Palette, glissez les composants tMDMInput de la famille Talend MDM et tLogRow de la famille Logs & Errors dans lespace de modlisation. Reliez-les via un lien de type Row Main. Double-cliquez sur le composant tMDMInput pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
Dans la liste Property Type, slectionnez Built-In et renseignez les champs manuellement. Si vous avez stock les informations de connexion au MDM dans les mtadonnes du Repository, slectionnez Repository dans la liste et les champs suivants seront renseigns automatiquement. Dans la liste Schema, slectionnez Built-In et cliquez sur le bouton [...] ct du champ Edit schema pour dcrire la structure des donnes matre que vous souhaitez lire sur le serveur MDM.
1633

tMDMInput
Les donnes matre sont rcupres dans un schma trois colonnes de type String : ISO2Code, Name, Currency. Cliquez sur OK. Dans le champ URL, saisissez entre guillemets lURL de connexion au serveur MDM. Dans les champs Username et Password, saisissez lidentifiant et le mot de passe de connexion au serveur MDM. Dans le champ Version, saisissez entre guillemets le nom de la Version des donnes matre laquelle vous avez souhaitez accder. Laissez le champ vide pour afficher la Version par dfaut. Dans le champ Entity, saisissez entre guillemets le nom de lentit mtier contenant les donnes matre que vous souhaitez lire. Dans le champ Data Container, saisissez entre guillemets le nom du conteneur de donnes contenant les donnes matre que vous souhaitez lire. Dans la vue Component, cliquez sur longlet Advanced settings pour paramtrer les proprits avances du composant.
1634

tMDMInput
Dans le champ Loop XPath query, saisissez entre guillemets larborescence et le nom du noeud XML sur lequel effectuer la boucle. Dans le tableau Mapping, les colonnes du schma du composant apparaissent sous la colonne Column. Saisissez entre guillemets le nom de la balise XML dans laquelle rcuprer les donnes matre dans le champ XPath query correspondant la colonne du schma de sortie. Dans lespace de modlisation, double-cliquez sur le composant tLogRow pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits. Cliquez sur Edit schema et assurez-vous que le schma est rcupr du composant prcdent. Sinon, cliquez sur Sync Columns pour rcuprer le schma du composant. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
La liste des diffrents pays, ansi que leur code et devise est retourne dans la console de la vue Run.
1635

tMDMOutput
tMDMOutput
Proprits du tMDMOutput
Le composant tMDMOutput crit des donnes matre dans un hub MDM (rfrentiel XML). Ce composant crit des donnes matre sur le serveur MDM. Property Type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il devient automatiquement built-in. Cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. XML Field URL Username et Password Slectionnez le nom de la colonne dans laquelle vous souhaitez crire les donnes XML. Saisissez lURL daccs au serveur MDM. Saisissez les informations dauthentification de lutilisateur du serveur MDM. Cet utilisateur doit avoir le bon rle dans MDM, cest--dire quil puisse se connecter via un Job ou tout autre appel de service Web. Pour plus dinformations, consultez Scurit dans le Guide Administrateur de Talend Master Data Management. Saisissez le nom de la Version des donnes matre laquelle vous souhaitez vous connecter, en fonction de vos droits utilisateur. Laissez ce champ vide pour afficher la Version par dfaut des donnes matre.
Version
1636

tMDMOutput
Data Model Data Container Return Keys
Saisissez le nom du modle de donnes en comparaison duquel les donnes crire seront valides. Saisissez le nom du conteneur de donnes dans lequel vous souhaitez crire les donnes matre. Columns corresponding to IDs in order : dans lordre squentiel, dfinissez les colonnes de sortie qui stockeront les valeurs des cls retournes (cls primaires) des lments crer. Cochez cette case pour mettre jour les champs modifis. Si vous ne cochez pas cette case, la totalit des champs sera remplace par les champs modifis. Cochez cette case pour ajouter les actions effectues un rapport de modifications. Source Name : Saisissez, entre guillemets, le nom de lapplication partir de laquelle les modifications sont apportes. Enable verification by before saving transformer : Cochez cette case pour vrifier lenregistrement qui vient dtre ajout avant quil ne soit enregistr.
Is Update
Fire Create/Update event
1637

tMDMOutput
Use partial update
Cochez cette case si vous devez mettre jour des lments multi-occurences (attributs) dune entit existante partir du contenu dun flux XML dentre. Une fois la case coche, vous devez configurer les paramtres ci-dessous : - Pivot : saisissez le chemin XPath vers les sous-lments multi-occurences dans lesquels des donnes doivent tre ajoutes ou remplaces dans lentit de votre choix. Par exemple, vous souhaitez ajouter un sous-lment fils une entit existante, comme suit :
<Person> <Id>1</Id> <Addresses> <Address> <Type>office</Type> (...address elements are here....) </Address> <Address> <Type>home</Type> (...address elements are here....) </Address> <Addresses> </Person>
le chemin XPath saisi dans le champ Pivot doit tre comme suit : Person/Children/Child et la case Overwrite devrait tre dslectionne. Et, si vous devez remplacer un sous-lment fils dans une entit existante :
<Person> <Id>1</Id> <Addresses> <Address> <Type>office</Type> (...address elements are here....) </Address> <Address> <Type>home</Type> (...address elements are here....) </Address> <Addresses> </Person>
le chemin XPath saisi dans le champ Pivot doit tre comme suit : Person/Addresses/Adress la case Overwrite doit tre coche et la champ Key configur comme suit : Person/Addresses/Address/Type. Dans cet exemple, nous supposons que lentit MDM a seulement une adresse de type office, ainsi cette adresse de type office sera remplace et ladresse de type home sera ajoute. - Overwrite : cochez cette case si vous devez remplacer ou mettre jour les sous-lments originaux par les sous-lments dentre. Laissez cette case dcoche si vous souhaitez ajouter un sous-lment. - Key : saisissez le chemin XPath relatif au pivot qui permettra de mettre en correspondance le sous-lment du flux XML dentre avec le sous-lment de lentit. Si une cl nest pas fournie, tous les sous-lments de lentit ayant un XPath qui correspond celui du sous-lment du flux XML dentre seront remplacs. -Position : saisissez un chiffre pour indiquer la position aprs laquelle les nouveaux lments (ceux qui ne correspondent pas la cl) seront ajout. Si vous ne renseignez pas ce champ, les nouveau lments seront ajouts la fin. 1638 Composants Talend Open Studio

tMDMOutput
se
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Rejects. Cochez cette case pour commiter les donnes matre par lot. Rows to commit : saisissez le nombre de lignes par lot. Ouvrez linterface daide la cration de la structure XML des donnes matre crire. Slectionnez la colonne utiliser pour regrouper les donnes matre.
Advanced settings
Extended Output Configure Xml Tree Group by
Create empty element if Cette case est coche par dfaut. Si le contenu de la colonne needed Related Column de linterface permettant de crer la structure XML est nul, ou si aucune colonne nest associe au noeud XML, cette option crera une balise ouvrante et une balise fermante aux endroits prvus. Advanced separator (for number) Cochez cette case pour modifier les sparateurs utiliss par dfaut dans les nombres : - Thousands separator : saisissez entre guillemets le sparateur utiliser pour les milliers. - Decimal separator : saisissez entre guillemets le sparateur utiliser pour les dcimales. Slectionnez le mode de gnration que vous souhaitez utiliser en fonction de votre mmoire disponible : - Fast but memory-consuming (Dom4J), le plus rapide mais consommant de la mmoire. - Slow with no memory consumed, le plus lent ne consommant pas de mmoire. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour collecter les donnes de log au niveau du composant.
Generation mode
Encoding
Utilisez ce composant pour crire un fichier et sparer les champs laide dun sparateur spcifque.
Scnario : Ecrire des donnes matre dans un hub MDM

Ce scnario dcrit un Job deux composants qui gnre un enregistrement de donnes, transforme ces donnes en XML et les charge dans lentit mtier dfinie sur le serveur MDM .
1639

tMDMOutput
Dans cet exemple, lobjectif est de charger une nouvelle agence dans lentit mtier Agency. Cette nouvelle agence doit comprendre un identifiant, un nom et une ville. A partir de la Palette, glissez les composants tFixedFlowInput de la famille Misc, et tMDMOutput de la famille Talend MDM dans lespace de modlisation. Reliez-les via un lien de type Row > Main. Double-cliquez sur le composant tFixedFlowInput pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
Dans la liste Schema, slectionnez Built-In et cliquez sur le bouton [...] ct du champ Edit schema pour dcrire la structure des donnes matre que vous souhaitez crire dans le serveur MDM.
Ajoutez trois colonnes de type String en cliquant sur le bouton [+]. Nommez ces colonnes Id, Name et City. Cliquez sur OK pour valider vos modifications et passer ltape suivante. Dans le champ Number of rows, saisissez le nombre de lignes que vous souhaitez gnrer.
1640

tMDMOutput
Dans la zone Mode, slectionnez le mode Use Single Table pour ne gnrer quune seule table. Dans le tableau Values, saisissez entre guillemets, dans chaque champ Value, la valeur correspondant chaque colonne du schma. Dans lespace de modlisation, double-cliquez sur le composant tMDMOutput pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
Dans la liste Property Type, slectionnez Built-In et renseignez les champs manuellement. Si vous avez stock les informations de connexion au MDM dans les mtadonnes du Repository, slectionnez Repository dans la liste et les champs suivants seront renseigns automatiquement. Dans la liste Schema, slectionnez Built-In et cliquez sur le bouton [...] ct du champ Edit schema pour dcrire la structure des donnes matre que vous souhaitez charger sur le serveur MDM.
1641

tMDMOutput
Le composant tMDMOutput gnre un document XML, lcrit dans un champ de sortie et lenvoie au serveur MDM, afin que le schma de sortie ait toujours une colonne xml en lecture seule. Cliquez sur OK pour passer ltape suivante. La liste XML Field dans longlet Basic settings est automatiquement renseigne avec la colonne xml de sortie que vous venez de crer. Dans le champ URL, saisissez entre guillemets lURL de connexion au serveur MDM. Dans les champs Username et Password, saisissez lidentifiant et le mot de passe de connexion au serveur MDM. Dans le champ Version, saisissez entre guillemets le nom de la Version des donnes matre laquelle vous souhaitez accder. Laissez le champ vide pour accder la Version par dfaut. Dans le champ Data Model, saisissez entre guillemets le nom du modle de donnes par rapport auquel vous souhaitez valider les donnes matre que vous souhaitez crire. Dans le champ Data Container, saisissez entre guillemets le nom du conteneur de donnes dans lequel les donnes matre doivent tre crites. Dans la vue Component, cliquez sur longlet Advanced settings pour paramtrer les paramtres avancs du composant.
1642

tMDMOutput
Cochez la case Extended Output si vous souhaitez commiter les donnes matre par lot. Vous pouvez spcifier le nombre de lignes par lot dans le champ Rows to commit. Cliquez sur le bouton [...] du champ Configure Xml Tree pour ouvrir lditeur du composant.
Dans la zone Link target droite, cliquez dans le champ Xml Tree et remplacez rootTag par le nom de lentit mtier dans laquelle vous souhaitez insrer lenregistrement de donnes, Agency dans cet exemple. Dans la zone Linker source, slectionnez les trois colonnes de votre schma et glissez les sur le noeud Agency. La bote de dialogue [Selection] souvre.
1643

tMDMOutput
Slectionnez Create as sub-element of target node pour que vos trois colonnes correspondent trois sous-lments du noeud Agency en XML. Cliquez sur OK.
Dans la zone Link target cliquez-droit sur llment que vous souhaitez dfinir comme lment sur lequel effectuer une boucle, puis slectionnez Set as Loop Element dans le menu contextuel. Dans cet exemple, City est llment ditration. Cliquez sur OK pour valider vos changements et fermer lditeur. Enregistrez votre Job et appuyez sur F6 pour lexcuter. Le nouvel enregistrement de donnes est insr dans lentit mtier Agency, dans le conteneur de donnes DStar, sur le serveur MDM. Cet enregistrement de donnes contient, comme dfini dans le schma, lID de lagence, son nom et sa ville. La cl primaire de lenregistrement insr est galement gnre et retrouve.
1644

tMDMOutput
1645

tMDMReceive
tMDMReceive
Proprits du tMDMReceive
Le composant tMDMReceive reoit un enregistrement MDM provenant de dclencheurs MDM ou de processus MDM. Ce composant dcode un paramtre de contexte comprenant des donnes MDM XML et les transforme en schma plat. Property Type Peut tre Built-in ou Repository.
Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Notez que si vous modifiez le schma, il passera automatiquement en mode Built-In. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. XML Record Saisissez le paramtre de contexte vous permettant de rcuprer les dernires modifications apportes au serveur MDM. Pour plus dinformations propos de la cration et de lutilisation des paramtres de contexte, consultez Dfinir les variables partir de la vue Contexts dans le Guide Utilisateur Talend Open Studio. Si ncessaire, slectionnez dans la liste lexpression XPath de boucle, qui est la concatnation du prfixe et du chemin de la boucle. /item : slectionnez ce prfixe XPath lorsque le composant reoit lenregistrement dun processus, car les processus encapsulent lenregistrement dans un lment item uniquement. /exchange/item : slectionnez ce prfixe XPath lorsque le composant reoit lenregistrement dun dclencheur, car les dclencheurs encapsulent lenregistrement dans un lment item dans un lment exchange. Noeud de larborescence XML sur lequel est base la boucle.
XPath Prefix
Loop XPath query
1646

tMDMReceive
Mapping
Column : reflte le schma tel quil est dfini dans lditeur Edit Schema. XPath query : Saisissez les champs extraire de la structure XML dentre. Get Nodes : Cochez cette case pour ajouter les balises XML entournant les donnes rcuprer. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ni traite. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject. Cochez cette case pour collecter les donnes de log au niveau du composant.
Limit Die on error
Ce composant est un composant de sortie. Il ncessite un flux de sortie.
Scnario associ
1647

tMDMRouteRecord
tMDMRouteRecord
Proprits du tMDMRouteRecord
Fonction
Le composant tMDMRouteRecord soumet la cl primaire dun enregistrement stock dans votre hub MDM (Repository) lEvent Manager, afin que ce gestionnaire dclenche le ou les processus attendu(s) selon certaines conditions que vous devez dfinir dans les pages des processus et des dclencheurs. Pour plus dinformations concernant lEvent Manager et les processus MDM, consultez Termes importants dans Talend MDM Studio dans le Guide Administrateur de Talend Master Data Management. Ce composant permet lEvent Manager didentifier les modifications apportes vos donnes, pour que les actions corrles puissent tre dclenches. URL Username et Password Version Saisissez lURL daccs au serveur MDM. Informations dauthentification de lutilisateur du serveur MDM. Saisissez le nom de la Version des donnes matre laquelle vous souhaitez vous connecter, en fonction de vos droits utilisateur. Laissez ce champ vide pour afficher la Version par dfaut des donnes matre. Saisissez le nom de lentit contenant les donnes que vous souhaitez effacer. Saisissez le nom du conteneur de donnes contenant les donnes que vous souhaitez effacer. Saisissez le nom de lentit mtier contenant lenregistrement que vous souhaitez faire lire lEvent Manager. Spcifiez la (les) cl(s) primaire(s) de(s) lenregistrement(s) que vous souhaitez faire lire lEvent Manager. Cochez cette case pour collecter les donnes de log au niveau du composant. Number of Lines : indique le nombre de lignes traites. Disponible en tant que variable After. Retourne un entier. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job, page 146 du Guide Utilisateur de Talend Open Studio.
Entity Data Container Entity Name
IDS Advanced settings Global Variables tStatCatcher Statistics
1648

tMDMRouteRecord
Connections
Liens de sortie (dun composant un autre) : Row : Iterate. Trigger : Run If, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError. Liens dentre (dun composant un autre) : Row : Iterate. Trigger : Run If, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur de Talend Open Studio.
Utilisation
Ce composant est un composant de dbut. Il ncessite un flux de sortie.
Scnario : Router un enregistrement vers lEvent Manager

Dans ce scnario, le composant tMDMRouteRecord est utilis pour soumettre lEvent Manager la cl primaire dun enregistrement notifiant une mise jour, afin que lEvent Manager dclenche un processus informant lutilisateur de la mise jour effectue.
Talend MDM est sensible la casse, respectez donc les majuscules et les minuscules lorsque vous ralisez ce scnario.
Prrequis du scnario
Les prrequis pour la ralisation de ce scnario sont les suivants : Un conteneur de donnes contenant diffrents enregistrements utilisant un modle spcifique. Dans ce scnario, le conteneur de donnes est Product, et un enregistrement est inclus dans le conteneur, en suivant le modle nomm Product :
Cette capture dcran prsente lun des enregistrements produit stocks avec tous les attributs que vous pouvez voir.

tMDMRouteRecord
Pour plus dinformations concernant la cration dun conteneur de donnes ou dun modle de donnes, consultez le Guide Administrateur de Talend Master Data Management. Pour plus dinformations concernant la cration dun enregistrement et laccs ses attributs, consultez le Guide Utilisateur de lInterface Web Talend MDM. Un Job, utilis pour informer lutilisateur de la mise jour, dj dploy sur votre serveur MDM. Dans ce scnario, le Job est appel message, il nutilise que le composant tMsgBox. Double-cliquez sur le composant afin dafficher et de configurer ses Basic settings :
Dans le champ Title, saisissez Talend MDM. Dans le champ Message, saisissez le message qui apparatra : A record is updated. Pour plus dinformations concernant le composant tMsgBox, consultez la section tMsgBox, page 1438. Pour plus dinformations sur comment dployer un Job sur le serveur MDM, consultez le Guide Administrateur de Talend Master Data Management.
Router un enregistrement afin de dclencher le processus correspondant

Ce scnario vous explique comment dclencher un processus laide dun composant tMDMRouteRecord. Connectez-vous linterface Web Talend MDM et cliquez sur Browse Records. Pour plus dinformations concernant la connexion linterface Web Talend MDM et louverture de la vue Browse Records, consultez le Guide Utilisateur de lInterface Web Talend MDM. Dans le coin suprieur droit de la page Web, cliquez sur le bouton panneau Actions. afin dafficher le
Dans le panneau Actions de droite, slectionnez le conteneur de donnes requis, ainsi que le modle de donnes contenant le fichier mettre jour. Dans ce scnario, le conteneur de donnes et le modle de donnes sont tous les deux appels Product. Cliquez sur Save afin de sauvegarder le conteneur et le modle de donnes slectionns. Dans la vue Browse Records, slectionnez lentit souhaite. Dans cet exemple, slectionnez Product.
1650

tMDMRouteRecord
Cliquez sur Search pour ouvrir la liste des enregistrements dans la partie infrieure de la page Web.
Double-cliquez sur lun des enregistrements produit afin dafficher ses attributs dans une nouvelle vue ddie ce produit. Par exemple, ouvrez le produit Talend Mug ayant lId unique 231035938.
1651

tMDMRouteRecord
Dans cette vue, modifiez la valeur de lun des attributs. Par exemple, mettez jour ce produit. Rendez-le disponible en cochant la case Availability. Cliquez sur Save afin de valider la mise jour. Ouvrez votre Studio Talend MDM et accdez au hub MDM (vue MDM Server). Pour plus dinformations concernant le lancement du Studio Talend MDM et sa connexion au hub MDM, consultez la section Lancement de Talend MDM Studio dans le Guide Administrateur de Talend Master Data Management.
Sous le noeud Job Repository de la vue MDM Server, cliquez-droit sur le Job message. Dans le menu contextuel, slectionnez Generate Talend Job Caller Process. Le processus utilis pour appeler ce Job est gnr et saffiche dans le rpertoire Event Management > Process.
1652

tMDMRouteRecord
Sous le noeud Event Management, cliquez-droit sur Trigger. Dans le menu contextuel, slectionnez New. Dans lassistant New Trigger, nommez le dclencheur TriggerMessage.
Cliquez sur OK afin douvrir la vue du nouveau dclencheur dans lespace de travail de votre studio. Dans la vue du dclencheur, configurez le dclencheur afin quil lance le processus appelant le Job message une fois la mise jour effectue.
1653

tMDMRouteRecord
Dans le champ Description, saisissez Trigger that calls the Talend Job: message_0.1.war. Dans le champ Entity, slectionnez lentit mtier sur laquelle vous souhaitez dclencher le processus, ou saisissez son nom. Dans cet exemple, son nom est Update. Dans le champ Service JNDI Name, slectionnez callprocess dans la liste droulante. Dans le champ Service Parameters, compltez la dfinition des paramtres en saisissant la valeur : CallJob_message_0.1.war. Cette valeur est le nom du processus appeler, que vous pouvez trouver dans le dossier Event Management > Process dans la vue MDM server. Dans la zone Trigger xPath Expressions, cliquez sur le bouton afin dajouter une ligne XPath. sous le tableau,
Dans la ligne nouvellement ajoute, cliquez sur le bouton [...] pour ouvrir une bote de dialogue dans laquelle vous pouvez slectionner lentit ou llment sur laquelle/lequel vous souhaitez dfinir des conditions. Dans cet exemple, son nom est Update/OperationType.
1654

tMDMRouteRecord
Dans la colonne Value, saisissez une valeur pour cette ligne. Dans cet exemple, la valeur est UPDATE. Dans la colonne Condition Id, saisissez un identifiant unique pour la condition que vous souhaitez dfinir, par exemple C1. Dans la zone Conditions, saisissez la requte que vous souhaitez excuter sur les donnes en utilisant lID de la condition ID C1 dfini plus tt. Appuyez sur Ctrl+S pour sauvegarder le dclencheur. Dans la vue MDM server, double-cliquez sur Data container > system > UpdateReport pour ouvrir la vue Data Container Browser UpdateReport. Le rapport UpdateReport contient les traces compltes de toutes les actions de cration, de mise jour ou de suppression (Create, Update ou Delete) effectues sur les donnes matre.
1655

tMDMRouteRecord
A ct du champ Entity de cette vue, cliquez sur le bouton pour rechercher tous les enregistrements concernant les actions dans le rapport UpdateReport. Notez que lentit Update ne signifie pas ncessairement que laction enregistre est une mise jour, cest simplement le nom de lentit dfinie par le modle de donnes du rapport UpdateReport pouvant contenir diffrentes actions comme create, delete, et update. Le dernier enregistrement correspond aux modifications apportes lenregistrement produit au dbut du scnario. La cl primaire de cet enregistrement est genericUI.1283244014172. Cet enregistrement sera rout vers lEvent trigger. Dans la barre de menu du studio, cliquez sur Window > Perspective > Data Integration afin de crer le Job routant lenregistrement. Dans la perspective Data Integration, crez un Job et nommez-le RouteRecord. Pour ce faire, cliquez-droit sur Job Designs, dans la vue Repository. Dans le menu contextuel, slectionnez Create Job. Un assistant souvre. Dans le champ Name, saisissez RouteRecord, puis cliquez sur Finish. Dposez le composant tMDMRouteRecord de la Palette dans lespace de modlisation graphique. Double-cliquez sur ce composant afin douvrir sa vue Component.
1656

tMDMRouteRecord
Dans le champ URL, saisissez ladresse de votre serveur MDM, http://localhost:8080/talend/TalendPort, dans cet exemple. Dans les champs Username et Password, saisissez respectivement votre identifiant et votre mot de passe de connexion. Dans le champ Data Container saisissez le nom du conteneur de donnes contenant lenregistrement que vous souhaitez router vers lEvent Manager. Dans cet exemple, son nom est UpdateReport. Dans le champ Entity Name, saisissez le nom de lentit laquelle appartient lenregistrement que vous souhaitez router. Dans cet exemple, son nom est Update. Dans la zone IDS, cliquez sur le bouton [+] sous le tableau, afin dajouter une ligne. Dans cette nouvelle ligne, renseignez la cl primaire de lenregistrement devant tre rout vers lEvent manager, cest--dire genericUI.1283244014172, comme vous lavez vu dans le rapport Data Container Browser UpdateReport. Appuyez sur F6 pour excuter le Job. LEvent manager appelle le processus devant excuter le Job message et gnrer la bote de dialogue informant lutilisateur de la mise jour effectue.
Le composant tMDMRouteRecord est utilis pour soumettre lEvent Manager la cl primaire dun enregistrement notifiant une mise jour. LEvent Manager analyse le fichier et

tMDMRouteRecord
vrifie que les conditions dfinies dans la vue de configuration du dclencheur Triggers message sont remplies, puis appelle le processus lanant le Job Message. Ce Job informe lutilisateur de la mise jour effectue en faisant apparatre une fentre pop-up.
1658

tMDMSP
tMDMSP
Proprits du tMDMSP
Le composant tMDMSP appelle une procdure stocke du hub MDM. tMDMSP permet de centraliser des requtes multiples ou complexes dans une base de donnes et de les appeler plus facilement. Schema et Edit Schema Dans une procdure stocke, le schma est un paramtre dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement.Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. URL Username et Password Version Saisissez lURL du serveur MDM. Informations dauthentification sur lutilisateur de base de donnes. Saisissez le nom de la Version des donnes matre laquelle vous souhaitez vous connecter, en fonction de vos droits utilisateur. Laissez ce champ vide pour afficher la Version par dfaut des donnes matre. Saisissez le nom du conteneur de donnes contenant les donnes que vous souhaitez effacer. Saisissez le nom exact de la Procdure Stocke.
Data Container SP Name
Parameters (in order) Cliquez sur le bouton [+] et slectionnez les colonnes dentre (Input Columns) requises pour les procdures. Le schma SP peut contenir plus de colonnes quil ny a de paramtres utiliss dans la procdure.
1659

tMDMSP
Connections
Liens de sortie (dun composant lautre) : Row : Main Trigger : Run if, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError. Liens dentre (dun composant lautre) : Row : Main, Iterate; Trigger : Run if, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Utilisation
Ce composant est un composant intermdiaire. Il peut tre utilis comme composant de dbut mais aucun paramtre dentre nest requis pour la procdure appeler. N/A
Limitation
Scnario : Excuter une procdure stocke dans le hub MDM

Le but du Job suivant est de calculer le prix total de chaque produit enregistr dans votre interface Web MDM.
Ce Job va gnrer des paramtres pour lexcution dune procdure stocke dans le hub MDM, puis extraire les donnes souhaites du rsultat retourn au format XML et prsenter les donnes extraites dans le studio. Les produits dont le prix est traiter sont lists dans votre interface Web MDM.
1660

tMDMSP
La procdure stocke devant tre excute peut tre trouve dans le nud Stored Procedure de larborescence MDM Server et apparat comme suit :
Pour plus dinformations concernant la procdure stocke dans le serveur MDM, consultez la section Procdures stockes, page 184 dans le Guide Administrateur de Talend Master Data Management. Pour crer ce Job, procdez comme suit :

tMDMSP
Glissez-dposez les composants suivants utiliss dans cet exemple : tFixedFlowInput, tMDMSP, tExtractXMLField, tLogRow. Connectez les composants laide de liens Row > Main. Le composant tFixedFlowInput sert gnrer la gamme de prix vous intressant pour ce calcul. Dans cet exemple, dfinissez 10 comme minimum et 17 comme maximum afin de prendre en compte tous les produits. Double-cliquez sur le composant tFixedFlowInput afin douvrir sa vue Component. Dans la vue Component, cliquez sur le bouton [...] ct du champ Edit schema afin douvrir lditeur de schma de ce composant. Dans lditeur de schma, ajoutez les deux paramtres min et max utiliss pour dfinir la gamme de prix.
Cliquez sur OK afin de valider cette modification. Dans la table Values dans la zone Mode de la vue Component, les deux paramtres min et max que vous avez dfinis dans lditeur de schma du composant saffichent. Dans la colonne Value de la table Values, saisissez le nombre 10 pour le paramtre min et 17 pour le paramtre max.
Double-cliquez sur le composant tMDMSP afin douvrir sa vue Component.
1662

tMDMSP
Dans le champ URL de la vue Component, saisissez ladresse du serveur MDM, dans cet exemple : http://localhost:8080/talend/TalendPort. Dans les champs Username et Password, saisissez les donnes dauthentification, dans cet exemple : admin et talend respectivement. Dans les champs Data Container et Procedure Name, saisissez les noms exacts du conteneur de donnes Product et de la procdure stocke PriceAddition. Sous la table Parameters (in order), cliquez deux fois sur le bouton [+] afin dajouter deux lignes cette table. Dans la table Parameters (in order), cliquez sur chaque ligne ajoute et, dans la liste droulante, slectionnez le paramtre min pour lune et le paramtre max pour lautre. Double-cliquez sur le composant tExtractXMLField afin douvrir sa vue Component.
Dans la vue Component, cliquez sur le bouton [...] situ ct du champ Edit schema afin douvrir lditeur de schma du composant.
1663

tMDMSP
Dans lditeur de schma, ajoutez deux colonnes afin de dfinir la structure des donnes sortantes. Ces deux colonnes sont name et sum. Elles reprsentent respectivement le nom et le prix total de chaque type de produit enregistr dans linterface Web.
Cliquez sur OK afin de valider la configuration. Les deux colonnes saffichent dans la table Mapping de la vue Component. Dans le champ Loop XPath Query, saisissez le nud de larborescence XML sur lequel effectuer une boucle. Dans lexemple, le nud est /result comme vous pouvez lire dans le code de la procdure : return <result><Name>{$d}</Name><Sum>{sum($product/Price)}</Sum></r esult>. Dans le champ XPath Query de la table Mapping, saisissez le nom exact du nud sur lequel effectuer la boucle. Pour la colonne name, saisissez /result/Name, pour mapper les noms du produit. Pour la colonne sum, saisissez /result/Sum, pour extraire les prix totaux. Double-cliquez sur le composant tLogRow afin douvrir sa vue Component.
Synchronisez le schma avec celui du composant prcdant (en cliquant sur le bouton Sync columns).
1664

tMDMSP
Dans la zone Mode, slectionnez loption Table (print values in cells of a table) pour une meilleure lecture. Appuyez ensuite sur F6 afin dexcuter le Job. Les donnes sortantes saffichent dans la console de la vue Run.
La sortie liste les quatre sortes de produit enregistrs dans linterface Web MDM et le prix total pour chaque type de produit.
1665

tMDMViewSearch
tMDMViewSearch
Proprits du tMDMViewSearch
Fonction
Le composant tMDMViewSearch slectionne des enregistrements dun hub MDM (Repository XML) en appliquant les filtres que vous avez crs dans un but prcis. Les donnes rcupres ont une structure XML. Pour plus dinformations concernant la vue permettant de dfinir des critres de filtres, consultez la section Vues dans le Guide Administrateur de Talend Master Data Management. tMDMViewSearch permet de retrouver des enregistrements MDM dun hub MDM. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma soit local (built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement.Voir galement : Paramtrer un schma built-in du Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Jobs. Voir galement : Paramtrer un schma du Repository du Guide Utilisateur de Talend Open Studio. XML Field URL Username et Password Version Slectionnez le nom de la colonne dans laquelle vous souhaitez crire les donnes XML. Saisissez lURL du serveur MDM. Informations dauthentification sur lutilisateur de base de donnes. Saisissez le nom de la Version des donnes matre laquelle vous souhaitez vous connecter, en fonction de vos droits utilisateur. Laissez ce champ vide pour afficher la Version par dfaut des donnes matre. Saisissez le nom du conteneur de donnes contenant les donnes que vous souhaitez effacer. Saisissez le nom de la vue dont les filtres seront appliqus pour traiter les enregistrements.
Data Container View Name
1666

tMDMViewSearch
Operations
Remplissez ce tableau afin de crer une clause WHERE. Les paramtres dfinir sont : - XPath : dfinissez le chemin de lexpression afin de slectionner le noeud XML sur lequel appliquer les filtres. - Functions : slectionnez un oprateur dans la liste droulante, comme Contains, Starts with, Equals, etc. - Value : saisissez la valeur que vous souhaitez rcuprer. - Predicate : slectionnez le prdicat permettant de combiner les conditions de filtres de diffrentes manires. Le prdicat peut tre none, or, and, exactly, etc. Les paramtres sont sensibles la casse.
Order (One Row)
Remplissez ce tableau afin de choisir lordre de prsentation des enregistrements rcuprs. Les paramtres dfinir sont : - XPath : dfinissez le chemin de lexpression afin de slectionner le noeud XML sur lequel appliquer le tri. - Order : slectionnez lordre de prsentation, soit asc (ascendant) ou desc (descendant). Les paramtres sont sensibles la casse. Pour le moment, seule la premire ligne cre dans le tableau Order est valide.
Spell Threshold
Configuez cette option sur -1 afin de dsactiver le seuil. Ce seuil est utilis pour dcider du niveau de tolrance des erreurs orthographiques. Renseignez le nombre de lignes ignorer afin de spcifier partir de quelle ligne doit commencer le processus. Par exemple, si vous saisissez 8, le processus commencera la neuvime ligne. Saisissez le nombre maximal de lignes traiter. Si le champ Limit est paramtr sur 0, aucune ligne ne sera lue ou traite. Par dfaut, la valeur de ce champ est -1, ce qui signifie quaucune limite nest dfinie.
Skip Rows
Max Rows
Utilisez ce composant pour rcuprer des enregistrements spcifiques. Number of Lines : Indique le nombre de lignes traites. Disponible en tant que variable After. Retourne un entier. Pour plus dinformations concernant les variables, consultez Utiliser les variables dans un Job dans le Guide Utilisateur Talend Open Studio.
1667

tMDMViewSearch
Connections
Liens de sortie (dun composant un autre) : Row : Iterate Trigger : Run if, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError. Liens dentre (dun composant un autre) : Row : Iterate; Trigger : Run if, OnComponentOk, OnComponentError, OnSubjobOk, OnSubjobError. Pour plus dinformations concernant les connexions, consultez Types de connexions dans le Guide Utilisateur Talend Open Studio.
Limitation
N/A
Scnario : Rcuprer des enregistrements dun hub MDM hub via une vue existante
Ce scnario dcrit un Job comprenant deux composants rcuprant un enregistrement de donnes ayant une structure XML.
Dans cet exemple, vous allez slectionner les informations concernant le T-shirt de lentit Product via la vue Browse_items_Product cre dans Talend Open Studio. Chaque enregistrement de lentit contient les dtails dfinis comme critres de filtre : Id, Name, Description et Price (ID, Nom, Description et Prix). A partir de la Palette, dposez un composant tMDMViewSearch et un tLogRow dans lespace de modlisation graphique. Reliez les composants laide dun lien Row > Main. Double-cliquez sur le tMDMViewSearch afin douvrir sa vue Basic settings, dans longlet Component et de dfinir les proprits du composant.
1668

tMDMViewSearch
Dans la liste Schema, slectionnez Built-In puis cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir une bote de dialogue dans laquelle vous pouvez dfinir la structure des donnes XML que vous souhaitez crire.
Cliquez sur le bouton [+] pour ajouter une colonne de type String. Nommez-la Tshirt. Cliquez sur OK pour valider la modification et passer ltape suivante. Dans le champ XML Field, slectionnez Tshirt comme colonne dans laquelle vous souhaitez crire les donnes rcupres.
1669

tMDMViewSearch
Dans le champ URL, saisissez ladresse de votre serveur MDM et renseignez respectivement votre identifiant et votre mot de passe de connexion dans les champs Username et Password. Dans cet exemple, utilisez lURL par dfaut, puis saisissez admin comme identifiant et mot de passe. Dans le champ Data Container, saisissez le nom du conteneur de donnes : Product. Dans le champ View Name, saisissez le nom de la vue : Browse_item_Product. Sous le tableau Operations, cliquez sur le bouton [+] pour ajouter une ligne. Dans le tableau Operations, dfinissez la colonne XPath comme Product/Name, ce qui signifie que lopration de filtre sera effectue sur le noeud Name. Slectionnez ensuite Contains dans la colonne Function puis saisissez Tshirt dans la colonne Value. Sous le tableau Order (One Row), cliquez sur le bouton [+] afin dajouter une ligne. Dans le tableau Order (One Row), dfinissez la colonne XPath comme Product/Id et slectionnez lordre asc dans la colonne Order. Dans lespace de modlisation graphique, cliquez sur le tLogRow afin douvrir sa vue Basic settings et dfinir ses proprits.
A ct du bouton [...] utilis pour diter le schma, cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Appuyez sur F6 afin dexcuter le Job.
1670

tMDMViewSearch
Dans la console de la vue Run, vous pouvez voir les enregistrements Tshirt retourns, avec leur structure XML, tris en ordre ascendant.
1671

tMDMViewSearch
1672
Composants XML
Ce chapitre passe en revue les proprits des principaux composants prsents dans la famille XML de la Palette de Talend Open Studio. La famille XML regroupe les composants ddis aux tches lies au XML, notamment le parsing, la validation, la cration de structures XML, etc.
Composants XML
Proprits du tAdvancedFileOutputXML
Famille de composant File/Output ou XML
Fonction
Le composant tAdvancedFileOutputXML transmet des donnes vers un fichier de type XML et propose une interface de gestion des boucles et des Group by si ncessaire. Le tAdvancedFileOutputXML cre un fichier XML contenant les valeurs des donnes dfinies dans larborescence XML. File name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Configure XML tree Ouvre linterface daide la cration du fichier XML. Pour plus dinformations sur linterface, consultez Dfinir un arbre XML page 1676. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Sync columns Cliquez sur ce bouton pour synchroniser le schma de sortie avec celui dentre. La fonction Sync ne saffiche que si une connexion de type Row est lie au composant de sortie. Cochez cette option pour ajouter de nouvelles lignes la fin de votre fichier source XML.
Append the source xml file
Generate compact file Cochez cette case pour gnrer un fichier ne comprenant aucun espace vide ni aucun sparateur de ligne. Lensemble des lments se prsente alors sur une ligne unique, ce qui permet de rduire le poids du fichier.
1674
Composants XML
Include DTD or XSL
Cochez cette case pour ajouter la dclaration DOCTYPE indiquant le nom de llment racine et le chemin daccs et le nom du fichier DTD ou pour ajouter linstruction de traitement indiquant le type de feuille de style (telle que les XSL) utilise et son chemin daccs et nom. DTD : saisissez le nom de llment racine dans le champ Root Element et saisissez le chemin daccs et le nom du fichier DTD dans le champ File Name. XSL : saisissez le type de feuille de style dans le champ Type et saisissez le chemin daccs et le nom du fichier dans le champ File Name. Si le fichier XML de sortie est lourd, vous pouvez le scinder en plusieurs fichiers en dfinissant un certain nombre de lignes par fichier. Cette case est coche par dfaut. Cette option permet de crer le dossier contenant le fichier XML de sortie sil nexiste pas dj. Cette case est coche par dfaut. Si le contenu de la colonne Associated Column est nul ou si aucune colonne nest associe au noeud XML, cette option crera une balise ouvrante et une balise fermante aux endroits prvus. Cochez cette case pour gnrer lattribut de la balise XML pour la colonne dentre associe dont la valeur est null. Cochez cette case pour gnrer lattribut de la balise pour la colonne dentre associe non mappe. Si lun des lments XML est associ un espace de nommage, cette option crera le fichier XSD correspondant. Pour utiliser cette option, vous devez slectionner le mode de gnration Dom4J dans la liste Generation mode.
Advanced settings
Split output in several files Create directory only if not exists Create empty element if needed
Create attribute even if its value is NULL Create attribute even if it is unmapped Create associated XSD file
Advanced separator (for number)
Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Slectionnez le mode de gnration le plus rapide mais consommant de la mmoire (Fast but memory-consuming - Dom4J) ou le plus lent ne consommant pas de mmoire (Slow with no memory consumed) en fonction de votre mmoire disponible. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
Generation mode
Encoding
1675
Composants XML
Cochez cette case pour annuler la gnration du fichier si celui-ci est vide.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log du Job, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Limitation Utilisez ce composant pour crer un fichier XML partir des donnes transmises par dautres composants via une connexion de type Row. n/a
Dfinir un arbre XML

Double-cliquez sur le composant tAdvancedFileOutputXML pour ouvrir linterface ddie ou cliquez sur le bouton [...] du champ Configure Xml Tree de longlet Basic settings dans la vue Component.
Le champ Schema List de la zone Linker Source, gauche de linterface, contient toutes les colonnes du flux dentre ( condition que le flux dentre soit connect au composant tAdvancedFileOutputXML). A droite de linterface, dans la zone Linker Target, dfinissez la structure XML que vous souhaitez obtenir en sortie. Vous pouvez la crer manuellement ou tout simplement importer la structure XML. Puis importez les colonnes du schma dentre dans llment de larbre XML correspondant. Importer un arbre XML Le meilleur moyen de renseigner larbre XML est dimporter un fichier XML bien form.
1676
Composants XML
Renommez la balise racine qui saffiche par dfaut dans le panneau XML tree, en cliquant sur celle-ci. Dans la colonne XML Tree, cliquez-droit sur le champ root tag pour afficher le menu contextuel. Dans le menu, slectionnez Import XML tree. Slectionnez le fichier importer et cliquez sur OK.
Vous pouvez importer la structure XML dun fichier au format XML, XSD et DTD.
La colonne XML Tree est donc automatiquement renseigne avec les lments. Vous pouvez supprimer et ajouter des lments ou des sous lments larbre : Slectionnez llment adquat dans larbre. Cliquez-droit pour faire apparatre le menu contextuel. Slectionnez Delete pour supprimer la slection de larbre ou slectionnez loption adquate parmi les suivantes : Add sub-element, Add attribute, Add namespace pour enrichir larbre. Crer manuellement larbre XML Si vous ne possdez pas de structure XML dj dfinie, vous pouvez la crer manuellement. Dans la colonne XML Tree, cliquez une fois sur le champ root tag pour le renommer. Cliquez droit sur ce champ pour afficher le menu contextuel. Dans le menu, slectionnez Add sub-element pour crer le premier lment de la structure. Vous pouvez aussi ajouter un attribut ou un lment enfant nimporte quel lment de larbre ou supprimer nimporte quel lment de larbre. Slectionnez llment adquat dans larbre que vous venez de crer. Cliquez-droit gauche du nom de llment pour afficher le menu contextuel.
1677
Composants XML
Dans le menu, slectionnez loption adquate parmi les suivantes : Add sub-element, Add attribute, Add namespace ou Delete.
Mapping de donnes XML

Une fois votre arbre XML cr, vous pouvez alimenter chaque lment ou sous-lment XML avec les colonnes du flux dentre dans la colonne Related Column : Cliquez sur une des entres de la colonne Schema List. Glissez-la dans le sous-lment correspondant droite. Relchez-la pour que le mapping soit effectif.
Une flche bleue apparat pour illustrer ce mapping. Sil est disponible, utilisez le bouton Auto-Map situ en bas gauche de linterface, il permet deffectuer cette opration automatiquement. Vous pouvez dconnecter nimporte quel mapping de nimporte quel lment de larbre XML : Slectionnez llment de larbre XML que vous souhaitez dconnecter de sa source respective. Cliquez-droit gauche de son nom pour afficher le menu contextuel. Slectionnez Disconnect linker. La flche bleue disparat.
Dfinir le statut du noeud

Dfinir larbre XML et le transfert de donnes ne suffit pas. Vous devez aussi dfinir llement sur lequel la boucle est effectue et si ncessaire llment partir duquel le regroupement est effectu. Elment Boucle Llment Boucle permet de dfinir llment objet dune itration. Llment Boucle est gnralement un gnrateur de lignes. Pour dfinir un lment comme un lment Boucle : Slectionnez llment adquat dans larbre XML. Cliquez-droit gauche du nom de llment pour afficher le menu contextuel.
Composants XML
Slectionnez loption Set as Loop Element.
La colonne Node Status affiche le nouveau statut slectionn.

Il ne peut y avoir quun seul lment Boucle la fois.
Elment Group Llment Group est optionnel, il reprsente un lment constant sur lequel est effectue une fonction Groupby. Llment Group ne peut tre dfini que si un lment Boucle a t pralablement dfini. Lorsque vous utilisez un lment Group, les lignes doivent tre tries pour pouvoir tre regroupes par le noeud slectionn. Pour dfinir un lment comme lment Group : Slectionnez llment adquat dans larbre XML. Cliquez-droit gauche du nom de llment pour afficher le menu contextuel. Slectionnez loption Set as Group Element.
1679
Composants XML
La colonne Node Status affiche le nouveau statut slectionn et tout autre statut de regroupement est automatiquement dfini, si ncessaire. Une fois le mapping termin, cliquez sur OK pour valider les paramtres et continuez la configuration de votre Job.
Scnario : Crer un fichier XML laide dune boucle

Le scnario suivant dcrit la cration dun fichier XML partir dun fichier plat tri contenant une vidothque.
Dans la palette de composants, cliquez sur les composants tFileInputDelimited et tAdvancedFileOutputXML et dposez-les dans lespace de modlisation. Sinon, si vous avez dj cr une mtadonne contenant la description du fichier dentre dans le noeud Metadata du Repository, alors vous pouvez cliquer-dposer directement cette mtadonne dans lespace de modlisation pour paramtrer automatiquement le flux dentre. Cliquez-droit sur le composant dentre et reliez-le au composant tAdvancedFileOutputXML laide dune connexion de type Row Main. Slectionnez le composant tFileInputDelimited et paramtrez ses proprits dans la vue Component en bas de la fentre du Studio.
1680
Composants XML
Dans la liste droulante Property Type, slectionnez loption Repository si la description de votre fichier est stocke dans une mtadonne du Repository. Si vous cliquez-dposez le composant directement partir de la mtadonne, vous naurez pas besoin de modifier ses proprits. Sinon, slectionnez loption Built-In et renseignez manuellement les champs de longlet Basic settings. Le fichier dentre contient les colonnes suivantes, spares par des points-virgules : id, name, category, year, language, director et cast.
Dans cette exemple, le champ Cast regroupe diffrentes valeurs et id sincrmente lorsque lon change de film. Si ncessaire, dfinissez le schma du tFileDelimitedInput en fonction de la structure du fichier.
1681
Composants XML
Une fois que vous avez vrifi que le schma du fichier dentre correspond vos attentes, cliquez sur OK pour valider. Puis slectionnez le composant tAdvancedFileOutputXML et cliquez sur la vue Component pour paramtrer ses proprits, ainsi que le mapping dans longlet Basic settings. Notez que vous pouvez directement double-cliquer sur le composant pour ouvrir linterface de mapping.
Dans le champ File Name, slectionnez le fichier qui sera crit la fin du Job, sil existe dj ou saisissez le chemin daccs et le nom du fichier qui seront crs automatiquement pour la sortie. Par dfaut, le schma (description du fichier) est automatiquement propag partir du flux dentre. Mais vous pouvez le modifier si ncessaire. Puis cliquez sur le bouton [...] ou double-cliquez sur le composant tAdvancedFileOutputXML dans lespace de modlisation pour ouvrir lditeur de mapping. Les colonnes du schma du fichier dentre sont listes gauche de linterface. A droite de linterface, configurez larbre XML afin quil reflte la structure du fichier de sortie.
1682
Composants XML
Vous pouvez soit crer la structure noeud par noeud. Pour plus dinformations sur la cration manuelle de larbre XML, consultez Dfinir un arbre XML page 1676. Dans cet exemple, un modle XML est utilis pour renseigner automatiquement larbre XML. Cliquez-droit sur le champ root tag qui apparat par dfaut et slectionnez loption Import XML tree la fin des options du menu contextuel. Dans la fentre Ouvrir, slectionnez le fichier XML importer et cliquez sur OK pour valider limport.
Vous pouvez importer la structure XML dun fichier au format XML, XSD et DTD.
Puis cliquez-dposez chaque champ de la colonne Schema List vers son lment correspondant dans larbre XML de la colonne XML tree tel que dcrit dans Mapping de donnes XML, page 1678. Le mapping apparat sous la forme dune flche bleue entre la zone de gauche et celle de droite.
Enfin, dans la colonne Node Status, dfinissez le statut du noeud sur lequel la boucle est effectue. Dans cet exemple, llment Cast correspondant llment Boucle puisque les donnes de ce champ dans le fichier dentre ne sont jamais les mmes. Cliquez-droit sur llment Cast de larbre XML et slectionnez loption Set as loop element. Pour regrouper les donnes par film, llment Movie doit aussi tre dfini comme lment Group. Cliquez-droit sur le noeud parent Movie de larbre XML et slectionnez loption Set as group element. Le statut slectionn parat sur la ligne de llment correspondant dans la colonne Node Status. Cliquez sur OK pour valider la configuration.
Composants XML
Puis appuyez sur F6 pour excuter le Job.
Le fichier XML de sortie affiche la structure telle quelle a t dfinie.
1684
Composants XML
tDTDValidator
tDTDValidator
Proprits du tDTDValidator
Famille de composant XML
Fonction
Le composant tDTDValidator valide un fichier XML entrant en fonction dune DTD et envoie les informations de validation la sortie dfinie. Ce composant permet de vrifier les donnes et la qualit de la structure du fichier trait Schema type et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Le schma de ce composant est en lecture seule. Il contient les informations standard de validation de fichier. Chemin daccs au fichier DTD de rfrence. Chemin daccs au fichier XML valider. Saisissez un message afficher dans la console Run bas sur le rsultat de la comparaison.
DTD file XML file If XML is valid, display If XML is not valid detected, display Print to console Utilisation
Cochez cette case pour afficher le message de validation.
Ce composant peut tre utilis en standalone mais il est gnralement connect un composant de sortie pour rassembler les informations de validation. n/a
Limitation
Scnario : Valider un fichier XML

Ce scnario dcrit un Job permettant de valider plusieurs fichiers dun rpertoire et de transmettre les informations de validation des fichiers non valides dans un fichier dlimit.
Cliquez et dposez les composants suivants de la Palette : tFileList, tDTDValidator, tMap, tFileOutputDelimited. Connectez le tFileList et le tDTDValidator avec un lien Iterate et les composants restants avec des liens Row main.
Composants XML
tDTDValidator
Paramtrez les proprits du composant tFileList afin quil rcupre les fichiers XML du rpertoire.
Dans le champ Filemask, saisissez le masque *.xml entre guillemets simples en Perl et guillemets doubles en Java. Paramtrez le chemin daccs des fichiers XML vrifier. Dcochez la case Case Sensitive. Dans la vue Component du composant tDTDValidate, le schma est en lecture seule puisquil contient des informations de validation standard. Paramtrez les proprits du fichier DTD utiliser comme rfrence, dans le champ DTD file.
Dans le champ Xml file, appuyez sur Ctrl+Espace pour accder la liste des variables globales et slectionnez la variable permettant de rcuprer le chemin daccs des fichiers : $_globals{tFileList_1}{CURRENT_FILEPATH} (en Perl) Dans les divers messages afficher dans la console Run, utilisez JobName pour afficher le libell du Job. Rappelez aussi le nom du fichier grce la variable : $_globals{tFileList_1}{CURRENT_FILE}. Saisissez votre message en tenant compte du langage utilis pour le Job, Perl ou Java, notamment pour lutilisation du point ou du plus. Cochez la case Print to Console. Dans le composant tMap, glissez-dposez les informations de validation du schma standard que vous souhaitez passer au fichier de sortie.
1686
Composants XML
tDTDValidator
Une fois que le schma de sortie est dfini, ajoutez un filtre de condition pour ne slectionner que les informations lorsque le fichier XML nest pas valide. Saisissez dabord la valeur souhaite pour cette variable, loprateur en fonction du type de donnes filtres puis la variable devant correspondre cette condition, ici : 0 == $row1[validate] Puis (si cela nest pas dj effectu) connectez le tMap au tFileOutputDelimited via un lien main row. Nommez-le errorsOnly. Dans longlet Basic settings du composant tFileOutputDelimited, paramtrez le chemin daccs de destination du fichier dlimit, les sparateurs de champs et lencodage. Enregistrez le Job et appuyez sur F6 pour lexcuter.
Dans la console de la vue Run, les messages dfinis apparaissent pour chaque fichier invalide. Au mme moment, le fichier de sortie est aliment avec les informations de validation.
1687
Composants XML
tEDIFACTtoXML
tEDIFACTtoXML
Proprits du tEDIFACTtoXML
Famille de composant XML / EDIFACT
Fonction
Le composant tEDIFACTtoXML lit un message EDIFACT des Nations Unies (Echange de Donnes Informatises pour lAdministration, le Commerce et le Transport) et le transforme au format XML selon la version et la famille EDIFACT. Le tEDIFACTtoXML est utilis pour tranformer un fichier de message EDIFACT au format XML afin que les utilisateurs en aient une meilleure lisibilit et que la compatibilit avec les outils de traitement soit meilleure. Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma de ce composant est fixe et en lecture seule, avec une colonne : document. Chemin daccs au fichier de message EDIFACT transformer. Slectionnez dans la liste la version dEDIFACT du fichier dentre. Cochez cette case pour ignorer le retour chariot dans le fichier dentre. Cette case est dcoche par dfaut et stoppe le Job en cas derreur. Cela permet de terminer le traitement avec les lignes sans erreur, et ignorer les lignes en erreur. Cochez cette case pour arrter lexcution du Job en cas derreur.
Objectif
Basic settings
EDI filename EDI version Ignore new line Die on error
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log du Job, aussi bien au niveau du Job quau niveau de chaque composant. Ce composant doit tre li un composant de sortie afin de rassembler les rsultats de transformation. n/a
Scnario : Passer dEDIFACT XML

Ce scnario dcrit un Job simple qui lit un fichier de message EDIFACT Customs Cargo (CUSCAR) et le sauvegarde en tant que fichier XML.
1688
Composants XML
tEDIFACTtoXML
Dposez un composant tEDIFACTtoXML et un tFileOutputXML de la Palette dans lespace de modlisation graphique. Connectez le composant tEDIFACTtoXML au tFileOutputXML laide dun lien Row > Main. Double-cliquez sur le composant tEDIFACTtoXML afin dafficher sa vue Basic settings.
Saisissez dans le champ EDI filename le chemin daccs au fichier du message EDIFACT dentre ou parcourez votre systme. Dans ce scnario, le fichier dentre est 99a_cuscar.edi. Dans la liste EDI version, slectionnez la version dEDIFACT du fichier dentre, D99A dans cet exemple. Cochez la case Ignore new line afin dignorer les caractres de retour chariot dans le fichier dentre durant la transformation. Laissez les autres paramtres tels quils sont. Double-cliquez sur le composant tFileOutputXML afin dafficher sa vue Basic settings.
Dans le champ File Name, saisissez le chemin daccs au fichier XML de sortie que vous souhaitez gnrer ou parcourez votre systme. Dans cet exemple, le fichier XML de sortie est 99a_cuscar.xml. Laissez les autres paramtres tels quils sont.
1689
Composants XML
tEDIFACTtoXML
Sauvegardez votre Job et appuyez sur F6 pour lexcuter. Le fichier du message dentre EDIFACT CUSCAR est transform au format XML et le fichier XML de sortie est gnr comme dfini.
1690
Composants XML
tExtractXMLField
tExtractXMLField
Proprits du tExtractXMLField
Fonction Objectif
Le composant tExtractXMLField lit la structure XML contenue dans les champs dun fichier ou dune table et en extrait les donnes. Le tExtractXMLField lit la structure XML contenue dans les champs dun fichier ou dune table, rcupre les donnes contenues dans cette structure et les envoie au composant suivant via un lien Row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement.. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. XML field Nom du champ XML traiter. Voir galement : Dfinir les variables partir de la vue Component du Guide utilisateur de Talend Open Studio Noeud de larborescence XML sur lequel est bas la boucle. Column : reflte le schma tel quil est dfini dans lditeur Edit Schema. XPath Query : Saisissez les champs extraire de la structure Xml dentre. Get nodes : Cochez cette case pour rcuprer le contenu XML de tous les nuds courants spcifis dans le champ Xpath Query, ou cochez la case correspondant un nud spcifique pour ne rcuprer que le contenu du nud slectionn. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ou traite.
Basic settings
Loop XPath query Mapping
Limit
1691
Composants XML
tExtractXMLField
Die on error
Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject.
Advanced settings
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log du Job, aussi bien au niveau du Job quau niveau de chaque composant. Ce composant doit tre utilis en composant intermdiaire. Il ncessite donc un composant dentre et de sortie. Il permet d'extraire des donnes d'un champ dlimit l'aide d'un lien Row > Main, et permet de crer un flux de rejet avec un lien Row > Reject, filtrant les donnes dont le type ne correspond pas au type dfini. n/a
Utilisation
Limitation
Scnario 1 : Extraire les donnes XML dun champ dune table de base de donnes
Ce scnario est compos de trois composants et permet de lire la structure XML contenue dans les champs dune base de donnes et den extraire les donnes.
Glissez les composants tMysqlInput de la famille Database > Mysql, tExtractXMLField de la famille Xml et un composant tFileOutputDelimited de la famille File > Output de la Palette dans le Job designer. Reliez les composants entre eux via des connexions de type Main > Row. Double-cliquez sur le composant tMysqlInput pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
1692
Composants XML
tExtractXMLField
Si votre schma est dj stock sous le noeud Db Connections dans le Repository, slectionnez loption Repository dans le champ Schema Type puis choisissez les mtadonnes appropries partir de la liste. Si vous navez encore dfini aucun schma, slectionnez loption Built-in et renseignez manuellement les informations de connexion et la structure des donnes dans un schma. Pour plus dinformations sur les proprits du composant tMysqlInput, consultez tMysqlInput page 635. Dans le champ Table Name, saisissez le nom de la table dont les champs contiennent les donnes XML. Dans ce scnario, la table se nomme customerdetails et ne contient quune seule colonne. Cliquez sur le bouton Guess Query pour rcuprer la requte correspondant votre schma. Dans le Job designer, double-cliquez sur le composant tExtractXMLField pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
1693
Composants XML
tExtractXMLField
Dans la liste droulante Property type, slectionnez loption Repository si la description de votre fichier est stocke dans une mtadonne du Repository. Si vous cliquez-dposez le composant directement partir de la mtadonne, vous naurez pas besoin de modifier ses proprits. Sinon, slectionnez loption Built-in et renseignez manuellement les champs suivants. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] ct du champ Edit schema pour consulter le schma. Dans la liste Xml field, slectionnez la colonne dont vous souhaitez extraire le contenu XML. La colonne se nomme CustomerDetails et est lunique colonne de la table customerdetails. Dans le champ Loop XPath query, saisissez le noeud de larborescence sur lequel effectuer la boucle afin de rcuprer les donnes. La colonne Column du tableau Mapping sera automatiquement renseigne avec la description du fichier que vous avez configur. Dans la colonne Xpath query, saisissez entre guillemet le noeud du champ XML contenant les donnes que vous voulez extraire. Dans ce scnario, lobjectif est dextraire les noms des clients, saisissez donc CustomerName qui correspond llment XML contenant cette information. Dans le Job designer, double-cliquez sur le composant tFileOutputDelimited pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
Dans le champ File Name, indiquez le rpertoire et le nom du fichier de sortie. Pour ce scnario, appelez le fichier CustomerNames.csv. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] ct du champ Edit schema pour consulter le schma. Enregistrez le Job et appuyez sur F6 pour lexcuter.
1694
Composants XML
tExtractXMLField
Le Job retourne les noms des clients contenus sous le noeud CustomerName du champ CustomerDetails de la table.
Scnario 2 : Extraire les donnes valides et les donnes errones partir dun champ XML dans fichier dlimit
Ce scnario est compos de quatre composants et permet de lire la structure XML contenue dans les champs dun fichier dlimit, den extraire les donnes et de rejeter les donnes errones.
A partir de la Palette, glissez dans le Job designer les composants tFileInputDelimited de la famille File > Input, tExtractXMLField de la famille Xml, tFileOutputDelimited de la famille File > Output et tLogRow de la famille Logs & Errors. Reliez les composants entre eux comme indiqu sur le schma ci-dessus. Double-cliquez sur le composant tFileInputDelimited pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
1695
Composants XML
tExtractXMLField
Slectionnez loption Built-in partir de la liste droulante Schema et renseignez manuellement les informations concernant le fichier dlimit dans les champs correspondants. Cliquez sur le bouton [...] ct du champ Edit schema pour afficher la bote de dialogue permettant de dfinir la structure des donnes, comme prsent ci-dessus. Cliquez sur le bouton [+] pour ajouter autant de lignes que ncessaire la structure des donnes. Dans cet exemple, il ny a quune seule colonne dans le schma : xmlStr. Cliquez sur OK pour valider vos changements et fermer la bote de dialogue.
Si vous avez pralablement stock votre schma dans le rpertoire Metadata sous File delimited, slectionnez loption Repository dans la liste droulante Schema puis cliquez sur le bouton [...] ct du champ pour afficher la bote de dialogue [Repository Content] paritr de laquelle vous pouvez slectionner un schma pertinent. Cliquez sur Ok pour fermer la bote de dialogue et remplir les champs automatiquement avec les mtadonnes contenues dans le schma. Pour plus dinformations sur le stockage des schmas de mtadonnes dans le Repository, consultez les sections Configurer un schma File Delimited et Dposer des composants partir du rpertoire Metadata du Guide Utilisateur de Talend Open Studio.
A partir de la liste Property type, slectionnez : -Repository si vous avez dj stock les mtadonnes de votre fichier dentre dans le Repository, les champs suivants sont alors renseigns automatiquement avec les informations stockes, ou -Built-in si aucune mtadonne nest stocke pour votre fichier dentre ; vous devez alors renseigner manuellement les champs suivants. Dans cet exemple, cest le mode Built-in qui est utilis. Dans le champ File Name, renseignez le chemin daccs ou cliquez sur le bouton [...] pour parcourir vos dossiers jusquau fichier traiter. Dans cet exemple, il sagit du fichier CustomerDetails_Error. Ce fichier csv stock localement contient une suite de lignes simples au format XML, spares par un double retour chariot. Dans le champ Row Separator, renseignez le sparateur de lignes, ici le double retour chariot. Dans le champ Field Separator, renseignez le sparateur de champ, aucun ici. Dans cet exemple, il ny a pas den-tte (Header), de pied de page (Footer) ou de nombre limite de lignes traiter (Limit). Dans lespace graphique, double-cliquez sur le composant tExtractXMLField pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
1696
Composants XML
tExtractXMLField
A partir de la liste Property type, slectionnez : -Repository si vous avez dj stock les mtadonnes de votre fichier dentre dans le Repository, les champs suivants sont alors renseigns automatiquement avec les informations stockes, ou -Built-in si aucune mtadonne nest stocke pour votre fichier dentre ; vous devez alors renseigner manuellement les champs suivants. Dans cet exemple, cest le mode Built-in qui est utilis. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] ct du champ Edit schema pour consulter le schma ou le modifier. La colonne Column du tableau Mapping sera automatiquement renseigne avec lae schma dfini. Dans la liste Xml field, slectionnez la colonne dont vous souhaitez extraire le contenu XML. Dans cet exemple, la colonne se nomme xmlStr. Dans le champ Loop XPath query, saisissez le noeud de larborescence sur lequel effectuer la boucle afin de rcuprer les donnes. Dans la colonne Xpath query, saisissez entre guillemets le noeud du champ XML contenant les donnes que vous voulez extraire. Dans le Job designer, double-cliquez sur le composant tFileOutputDelimited pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
Choisissez le mode Built-In dans la liste droulante Property Type.
1697
Composants XML
tExtractXMLField
Dans le champ File Name, indiquez le rpertoire et le nom du fichier de sortie. Pour ce scnario, appelez le fichier CustomerNames_right.csv. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] ct du champ Edit schema pour consulter le schma ou le modifier. Dans le Job designer, double-cliquez sur le composant tLogRow pour paramtrer ses proprits dans longlet Basic settings de la vue Component. Cliquez sur le bouton Sync Columns pour rcuprer le schma du composant prcdent. Pour plus dinformations sur le composant tLogRow, consultez le chapitre tLogRow, page 1399. Enregistrez le Job et appuyez sur F6 pour lexcuter.
Le composant tExtractXMLField lit et extrait dans un fichier dlimit en sortie, CustomerNames_right dans cet exemple, les informations concernant les clients dont la structure XML est correcte, et affiche les lignes errones dans la console de log.
1698
Composants XML
tFileInputXML
tFileInputXML
Proprits du tFileInputXML
Fonction Objectif
Le composant tFileInputXML lit un fichier XML structur ou un flux de donnes et extrait les donnes ligne par ligne. Ce composant lit un fichier XML structur ou un flux de donnes ligne par ligne pour le scinder en champs et envoie les champs tel que dfinis dans le schma au composant suivant du Job via une connexion Row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Schema type et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. File name/Stream File name : Chemin daccs et nom du fichier, et/ou variable traiter. Stream : Flux de donnes traiter. Les donnes doivent pralablement tre mises en flux afin dtre rcupres par le tFileInputXML via la variable INPUT_STREAM disponible dans la liste dauto-compltion (Ctrl+Espace). Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Loop XPath query Noeud de larborescence sur lequel la boucle est base.
Basic settings
1699
Composants XML
tFileInputXML
Mapping
Column : Colonnes mapper. Elles refltent le schma dfini par le champ Schema type. XPath Query : Saisissez les champs extraire de lentre structure. Get nodes : Cochez cette case pour rcuprer le contenu XML de tous les nuds courants spcifis dans le champ Xpath Query, ou cochez la case correspondant un nud spcifique pour ne rcuprer que le contenu du nud slectionn. Loption Get Nodes fonctionne en mode DOM4j et SAX, cependant avec le mode SAX, les noms despace ne sont pas supports. Pour plus dinformations concernant les modes DOM4j et SAX, consultez les proprits de la liste Generation mode de longlet Advanced settings. Nombre maximum de lignes traiter. Si Limit = 0, aucune ligne nest lue ou traite. Si -1, toutes les lignes sont lues ou traites, qiuelque soit le nombre. Cette case est coche par dfaut et stoppe le Job en cas derreur. Dcochez cette case pour terminer le traitement avec les lignes sans erreurs, et ignorer les lignes en erreur. Vous pouvez rcuprer les lignes en erreur, si vous le souhaitez. Pour cela, utilisez un lien Row > Reject. Cochez cette option pour modifier les sparateurs utiliss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Cochez cette case pour ignorer les espaces de noms. Generate a temporary file : renseignez le chemin daccs et le nom du fichier temporaire XML. Cochez cette case pour sparer les valeurs des noeuds fils concatnes. Ce champ ne peut tre utilis que si vous avez slectionn le mode Xerces dans le champ Generation mode. Le champs Field separator apparat : Dfinissez le sparateur utiliser pour sparer les valeurs
Limit
Die on error
Advanced settings
Ignore the namespaces Use Separator for mode Xerces
Encoding
1700
Composants XML
tFileInputXML
Generation mode
Slectionnez dans la liste droulante le mode de gnration du fichier XML en fonction de la disponibilit de votre mmoire et de la rapidit souhaite. -Fast and memory-consuming (Dom4j) : plus rapide mais consommateur de mmoire, -Memory-consuming (Xerces) : consommateur de mmoire, -Less memory consumed (SAX) :moins consommateur de mmoire. Lorsque que vous utilisez loption Get Nodes du tableau Mapping de longlet Basic settings avec le mode de gnration SAX, les noms despace ne sont pas supports.
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log du Job, aussi bien au niveau du Job quau niveau de chaque composant. Utilisation Ce composant doit tre utilis en tant que composant dentre. Il permet de crer un flux de donnes XML laide dun lien Row > Main, ainsi que de crer un flux de rejet avec un lien Row > Reject filtrant les donnes dont le type ne correspond pas au type dfini. Pour un exemple dutilisation de ces deux liens, consultez le Scnario 2 : Extraire les donnes XML errones dans un flux de rejet, page 1703. n/a
Limitation
Scnario 1 : Extraire des adresses XML

Ce scnario trs basique est constitu de deux composants : un composant tFileInputXML qui extrait des donnes du fichier XML contenant des adresses et un composant tLogRow qui affiche le rsultat de cette opration dans la console Run via le composant tLogRow.
Slectionnez un composant tFileInputXML dans le dossier File de la Palette. Cliquez et dposez galement un composant tLogRow et connectez ces deux composants. Dans longlet Basic settings du composant tFileInputXML, dfinissez les proprits :
1701
Composants XML
tFileInputXML
Le fichier XML contenant les adresses a t pralablement dfini dans la zone Metadata, par consquent rcuprez ses proprits en slectionnant Repository dans Property type. De cette manire, les proprits sont automatiquement rcupres et le reste des champs est renseign ( lexception du Schma). Pour plus dinformations concernant lassistant de cration de mtadonnes, consultez du Guide utilisateur de Talend Open Studio. De la mme manire, slectionnez le schma appropri dans la liste de mtadonnes du Repository. Cliquez sur Edit schema si vous souhaitez modifier le schma charg. Dans le champ Filename, indiquez le fichier structur dentre. Dans le champ Loop XPath query, modifiez le noeud de boucle si ncessaire. Dans la table de Mapping, renseignez les champs extraire et afficher dans la sortie. Si le fichier est volumineux, dfinissez un nombre de ligne maximum traiter dans le champ Limit. Saisissez lencodage si ncessaire, puis double-cliquez sur tLogRow pour dfinir le caractre sparateur. Enfin, appuyez sur F6 ou cliquez sur le bouton Run dans la vue Run pour excuter le Job. Dans la console, les champs dfinis sont extraits du fichier XML structur et sont affichs.
1702
Composants XML
tFileInputXML
Scnario 2 : Extraire les donnes XML errones dans un flux de rejet

Ce scnario dcrit un Job trois composants qui permet de lire un fichier XML et : dune part, de retourner les donnes XML correctes dans un autre fichier XML, et dautre part, dafficher dans la console de log les donnes errones dont le type ne correspond pas au type dfini.
A partir de la Palette, glissez les composants tFileInputXML, tFileOutputXML et tLogRow dans lespace de modlisation. Cliquez-droit sur le composant tFileInputXML, slectionnez Row > Main dans le menu contextuel, et cliquez sur le composant tFileOutputXML pour crer le lien. Cliquez-droit sur le composant tFileInputXML, slectionnez Row > Reject dans le menu contextuel, et cliquez sur le composant tLogRow pour crer le lien de rejet. Double-cliquez sur le composant tFileInputXML pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
1703
Composants XML
tFileInputXML
Dans la liste Property Type, slectionnez Repository et cliquez sur le bouton [...] pour afficher la bote de dialogue [Repository Content] partir de laquelle vous pouvez slectionner la mtadonne relative votre fichier si vous lavez stock sous le noeud File xml du rpertoire Metadata du Repository. Les champs suivants seront renseigns automatiquement. Sinon, slectionnez le mode Built-in et renseignez ces champs manuellement. Pour plus dinformations sur le stockage des schmas de mtadonnes dans le Repository, consultez les sections Configurer un Schma File XML et Dposer des composants partir du rpertoire Metadata du Guide Utilisateur de Talend Open Studio. Dans le champ Schema Type, slectionnez Repository et cliquez sur le bouton [...] pour slectionner le schma dcrivant la structure de votre fichier si vous lavez stock dans le Repository. Sinon, cliquez sur le bouton [...] ct du champ Edit schema et dfinissez le schma manuellement.
Dans cet exemple, le schma comprend cinq colonnes : id, CustomerName, CustomerAddress, idState et id2. Cliquez sur le bouton [...] ct du champ Filename et indiquez le chemin daccs au fichier XML. Dans le champ Loop XPath query, saisissez, entre guillemets, le chemin du noeud sur lequel effectuer une boucle. Dans la table Mapping, la colonne Column est automatiquement renseigne avec les colonnes dfinies dans le schma. Dans la colonne XPath query, saisissez entre guillemets le noeud du fichier XML contenant les donnes que vous voulez extraire dans la colonne correspondante. Dans le champ Limit, saisissez le nombre de lignes traiter. Dans ce scnario, lobjectif est de traiter les 10 premires lignes. Double-cliquez sur le composant tFileOutputXML pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits.
1704
Composants XML
tFileInputXML
Cliquez sur le bouton [...] ct du champ File Name pour slectionner le rpertoire de destination du fichier et saisissez le nom du fichier. Dans ce scnario, appelez le fichier customer_data.xml. Dans le champ Row tag, saisissez entre guillemets le nom que vous souhaitez donner la balise contenant les donnes. Cliquez sur Edit schema et assurez-vous que le schma est rcupr du schma dentre. Si ncessaire, cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Double-cliquez sur le composant tLogRow pour afficher longlet Basic settings de la vue Component et paramtrer ses proprits. Cliquez sur Edit schema et assurez-vous que le schma est rcupr du schma dentre. Si ncessaire, cliquez sur Sync columns pour rcuprer le schma du composant prcdent. Dans la zone Mode, slectionnez loption Vertical. Enregistrez votre Job et appuyez sur F6 pour lexcuter.
1705
Composants XML
tFileInputXML
Le fichier customer_data.xml contenant les donnes correctes est cr et les donnes errones sont affiches dans la console de la vue Run.
1706
Composants XML
tFileOutputXML
tFileOutputXML
Proprits de tFileOutputXML
Le composant tFileOutputXML produit en sortie des donnes sous forme de fichier de type XML. Le tFileOutputXML crit dans un fichier XML des donnes spares selon un schma spcifi. File name Chemin daccs et nom du fichier de sortie, et/ou variable utiliser. Pour plus dinformations concernant lutilisation et la dfinition de variables, consultez la section Dfinir les variables partir de la vue Contexts du Guide utilisateur de Talend Open Studio. Root tag Row tag Column name as tag name Split output in files Schema type et Edit Schema Enveloppe les donnes et la structure entire du fichier de sortie. Enveloppe les donnes et la structure de chaque ligne. Cochez cette case pour rcuprer les libells de colonnes du schma dentre et les utiliser comme balise XML. Si le fichier XML en sortie et volumineux, vous pouvez scinder ce fichier en plusieurs parties. Un schma est une description de lignes, i.e., il dfinit le nombre de champ qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Sync columns Cliquez sur ce bouton pour synchroniser le schma de sortie avec le schma dentre. La fonction Sync ne saffiche que si une connexion de type Row est lie au composant de sortie. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
Encoding
1707
Composants XML
tFileOutputXML
Utilisez ce composant pour crire dans un fichier XML des donnes rcupres dautres composants laide dune connexion de type Row. n/a
Scnario : Utiliser un format de sortie XML

Un scnario utilisant le composant tFileOutputXML est dcrit dans le Scnario : Transformer un fichier positionnel en XML, page 1180.
1708
Composants XML
tWriteXMLField
tWriteXMLField
Proprits du tWriteXMLField
Le composant tWriteXMLField lit un fichier XML dentre, en extrait la structure et linsre dans les champs du fichier ou de la table de sortie. Le tWriteXMLField lit un fichier XML dentre, extrait la structure du fichier et linsre dans les champs du fichier ou de la table de sortie. Output Column Configure Xml Tree Slectionnez la colonne du composant de sortie dans laquelle vous souhaitez crire la structure XML. Ouvre linterface daide la cration de la structure XML crire dans un champ. Pour plus dinformations sur linterface, consultez Dfinir un arbre XML page 1676. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Paramtrer un schma built-in du Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis dans divers projets et Job designs. Voir galement : Paramtrer un schma du Repository du Guide utilisateur de Talend Open Studio. Sync columns Cliquez sur ce bouton pour synchroniser le schma de sortie avec celui dentre. La fonction Sync ne saffiche que si une connexion de type Row est lie au composant de sortie. Slectionnez la colonne utiliser pour regrouper les donnes. Cochez cette case si vous ne souhaitez pas inclure la dclaration XML. Cette case est coche par dfaut. Si le contenu de la colonne Related Column de linterface permettant de crer la structure XML est nul, ou si aucune colonne nest associe au noeud XML, cette option crera une balise ouvrante et une balise fermante aux endroits prvus.
Schema type et Edit Schema
Group by Advanced settings Remove the xml declaration Create empty element if needed
1709
Composants XML
tWriteXMLField
Create associated XSD file
Si lun des lments XML est associ un espace de nommage, cette option crera le fichier XSD correspondant. Pour utiliser cette option, vous devez slectionner le mode de gnration Dom4J dans la liste Generation mode. Cochez cette case pour modifier les sparateurs utiliss par dfaut dans les nombres. Thousands separator : saisissez entre guillemets le sparateur utiliser pour les milliers. Decimal separator : saisissez entre guillemets le sparateur utiliser pour les dcimales. Slectionnez le mode de gnration le plus rapide mais consommant de la mmoire (Fast but memory-consuming - Dom4J) ou le plus lent ne consommant pas de mmoire (Slow with no memory consumed) en fonction de votre mmoire disponible. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.
Generation mode
Encoding
tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Utilisation Limitation Ce composant doit tre utilis en composant intermdiaire. Il ncessite donc un composant dentre et de sortie. n/a
Scnario : Extraire la structure dun fichier XML et linsrer dans les champs dune base de donnes
Ce scnario est compos de trois composants et permet de lire un fichier XML, den extraire la structure puis de transmettre cette structure dans les champs dune table.
Glissez les composants tFileInputXml et tWriteXMLField de la famille Xml et un composant tMysqlOutput de la famille Database > Mysql de la Palette dans le Job designer. Reliez ces composants via des liens de type Row > Main. Double-cliquez sur le composant tFileInputXml pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
1710
Composants XML
tWriteXMLField
Dans la liste droulante Property type, slectionnez loption Repository si la description de votre fichier est stocke dans une mtadonne du Repository. Si vous cliquez-dposez le composant directement partir de la mtadonne, vous naurez pas besoin de modifier ses proprits. Sinon, slectionnez loption Built-in et renseignez manuellement les champs suivants. Pour plus dinformations sur les proprits du composant tFileInputXML, consultez tFileInputXML page 1699. Si vous avez slectionnez loption Built-in, cliquez sur le bouton [...] ct du champ Edit schema puis dans la bote de dialogue, dcrivez manuellement la structure de votre fichier. Dans le champ Look Xpath query, saisissez sur quel noeud du fichier la boucle doit tre effectue. Pour ce scnario, la boucle est effectue sur le noeud customer. La colonne Column du tableau Mapping sera automatiquement renseigne avec la description du fichier que vous avez configur. Dans la colonne Xpath query, saisissez entre guillemet le noeud du fichier XML contenant les donnes correspondant la colonne de gauche. Cliquez sur le composant tWriteXMLField dans le Job designer puis cliquez sur la vue Component pour lafficher et paramtrer les proprits du composant :
Cliquez sur le bouton [...] ct du champ Edit schema et, dans la bote de dialogue, ajoutez une ligne en cliquant sur le bouton (+).
1711
Composants XML
tWriteXMLField
Dans cette ligne, saisissez le nom de la colonne de votre flux de sortie que vous souhaitez renseigner avec la structure du fichier XML dans la zone de droite, CustomerDetails dans ce scnario. Dans la colonne Type de cette ligne, indiquez quelle est de type String et dans la colonne Length, indiquez quelle est de longueur 255. Cliquez sur Ok pour valider votre schma de sortie et retourner aux proprits du composant. Dans le champ Output Column, slectionnez la colonne dans laquelle vous souhaitez insrer le contenu XML. Cliquez sur le bouton [...] du champ Configure Xml Tree pour ouvrir linterface daide la cration de structures XML.
Dans la zone Link Target, cliquez sur le noeud rootTag et renommez-le CustomerDetails. Dans la zone Linker source, slectionnez CustomerName et CustomerAddress et glissez-les sur le noeud CustomerDetails. Une bote de dialogue souvre vous demandant quel type daction vous souhaitez effectuer : slectionnez Create as sub-element of target node afin de crer des sous-lments au noeud CustomerDetails. Cliquez-droit sur llment CustomerName et slectionnez loption Set As Loop Element dans le menu. Cliquez sur OK.
1712
Composants XML
tWriteXMLField
Dans le Job designer, double-cliquez sur le composant tMysqlOutput pour paramtrer ses proprits dans longlet Basic settings de la vue Component :
Si votre schma est dj stock sous le noeud Db Connections dans le Repository, slectionnez loption Repository dans le champ Schema Type puis choisissez les mtadonnes appropries partir de la liste. Si vous navez encore dfini aucun schma, slectionnez loption Built-in et renseignez manuellement les informations de connexion et la structure des donnes dans un schma. Pour plus dinformations sur les proprits du composant tMysqlOutput, consultez tMysqlOutput page 647. Dans le champ Table, saisissez le nom de la table dont les champs contiendront les donnes XML. Dans le champ Action on table, slectionnez lopration que vous souhaitez effectuer sur la table. Pour ce scnario, slectionnez Create table pour crer la table. Dans le champ Action on data, slectionnez lopration que vous souhaitez effectuer sur les donnes. Pour ce scnario, laissez loption Insert. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Vous pouvez cliquer sur le bouton [...] ct du champ Edit schema pour consulter le schma. Enregistrez le Job et appuyez sur F6 pour lexcuter.
1713
Composants XML
tWriteXMLField
Chaque champ de la colonne CustomerDetails est renseigne avec la structure XML du fichier de dpart : linstruction de traitement XML <?xml version=""1.0"" encoding=""ISO-8859-15""?>, le premier noeud sparant chaque client <CustomerDetails> et les informations sur les clients <CustomerAddress> et <CustomerName>.
1714
Composants XML
tXSDValidator
tXSDValidator
Proprits du tXSDValidator
Fonction
Le composant tXSDValidator valide un fichier XML entrant en fonction dun fichier XSD et envoie les informations de validation la sortie dfinie. Ce composant permet de vrifier les donnes et la qualit de la structure du fichier trait Mode Dans cette liste droulante, slectionnez : -File pour valider un fichier dentre, -Flow pour valider un flux dentre. Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Le schma de ce composant est en lecture seule. Il contient les informations standard de validation de fichier. Chemin daccs au fichier XSD de rfrence.
Mode File XSD file uniquement Mode File XML file uniquement Mode File If XML is valid, uniquement display If XML is not valid detected, display Mode File Print to console uniquement Mode Flow Allocate uniquement Advanced settings Utilisation tStatCatcher Statistics
Chemin daccs au fichier XML valider.
Saisissez un message afficher dans la console Run bas sur le rsultat de la comparaison.
Cochez cette case pour afficher le message de validation. Spcifiez la ou les colonne(s) valider ainsi que le chemin daccs au fichier XSD de rfrence. Cochez cette case pour collecter les donnes de log au niveau du composant.
Ce composant peut tre utilis en standalone mais il est gnralement connect un composant de sortie pour rassembler les informations de validation. n/a
Limitation
1715
Composants XML
tXSDValidator
Scnario : Valider des flux de donnes par rapport un fichier XSD

Ce scnario dcrit un Job en Java qui valide une colonne XML dans un fichier dentre par rapport un fichier XSD de rfrence et crit les informations de log concernant les lignes invalides de la colonne dans un fichier dlimit. Pour un exemple dutilisation du tXSDValidator validant un fichier XML, consultez le Scnario : Valider un fichier XML, page 1685. Dposez de la Palette dans lespace de modlisation graphique les composants tFileInputDelimited, tXSDValidator ainsi que deux tFileOutputDelimited.
Double-cliquez sur le composant tFileInputDelimited afin douvrir sa vue Component et dfinir ses proprits.
Dans la liste Property Type, slectionnez Built-In. Dans le champ File name/Stream, cliquez sur le bouton [...] afin de parcourir votre rpertoire jusquau fichier dentre. Dans le champ Header, dfinissez le nombre de lignes ignorer au dbut du fichier. Dans la liste Schema, slectionnez Built-In. Cliquez sur Edit Schema et modifiez le schma pour quil corresponde celui du fichier dentre. Dans ce scnario, le fichier dentre contient deux colonnes : ID et ShipmentInfo. La colonne ShipmentInfo est une colonne XML ncessitant dtre valide.
1716
Composants XML
tXSDValidator
Dans lespace de modlisation graphique, reliez le composant tFileInputDelimited au tXSDValidator laide dun lien Row > Main. Double-cliquez sur le composant tXSDValidator et configurez ses proprits.
Dans la liste Mode, slectionnez Flow Mode. Dans la liste Schema, slectionnez Built-In. Cliquez sur le bouton Sync columns pour rcuprer le schma du composant prcdent. Pour voir ou modifier le schma, cliquez sur le bouton [...]. Cliquez sur le bouton [+] sous le tableau Allocate afin dajouter une ligne. Le nom de la premire colonne du fichier dentre apparat automatiquement dans le champ Input Column. Cliquez dans le champ et slectionnez la colonne que vous souhaitez valider. Dans le champ XSD File, saisissez le chemin daccs votre fichier XSD de rfrence. Dans lespace de modlisation, reliez le composant tXSDValidator au tFileOutputDelimited laide dun lien Row > Main afin dcrire les informations concernant les lignes XML valides. Reliez le tXSDValidator au second tFileOutputDelimited laide dun lien Row > Rejects afin dcrire les informations concernat les lignes XML invalides.
1717
Composants XML
tXSDValidator
Double-cliquez sur les composants tFileOutputDelimited lun aprs lautre et configurez leurs proprits. Dans le champ Property Type, slectionnez Built-In. Dans le champ File Name, parcourez votre rpertoire jusquau fichier que vous souhaitez utiliser. Dans la liste Schema, slectionnez Built-In puis cliquez sur le bouton Sync columns afin de rcuprer le schma du composant prcdent.
Sauvegardez votre Job et appuyez sur F6 pour lexcuter.
Les fichiers de sortie contiennent les informations concernant les lignes XML valides et invalides de la colonne spcifie.
1718
Composants XML
tXSLT
tXSLT
Proprits du tXSLT
Le composant tXSLT tient compte dune feuille de style XSL pour transformer un fichier source XML et lenvoyer vers la sortie dfinie. Le tXSLT permet de transformer une structure de donnes en une autre structure. XML file XSL file Output file Chemin daccs au fichier XML transformer. Chemin daccs au fichier XSL de rfrence. Chemin daccs du fichier de sortie. Si le fichier nexiste pas, il sera cr. Le fichier de sortie peut tre nimporte quel fichier structur ou non tels que html, xml, txt ou mme pdf ou edifact en fonction de votre fichier xsl. Cliquez sur le bouton [+] pour ajouter de nouvelles lignes la liste Parameters et dfinir les paramtres de transformation du fichier XSLT. Pour chaque ligne, renseignez la cl dans la colonne name et sa valeur associe dans la colonne value.
Parameters
Ce composant peut tre utilis en standalone. n/a
Scnario : Transformer un fichier XML en HTML laide dune feuille de style XSL
Ce scnario dcrit un Job deux composants appliquant une feuille de style XSL un fichier XML et gnre un fichier HTML en sortie. Il permet galement de dfinir un paramtre de transformation pour la feuille de style XSL afin de changer la couleur de larrire plan de len-tte dans le document HTML cr en sortie. A partir de la Palette, cliquez et dposez un composant tXSLT et un tMsBox dans lespace graphique.
Double-cliquez sur le tXSLT pour ouvrir la vue Basic settings et paramtrer le composant.
1719
Composants XML
tXSLT
Dans le champ XML file, renseignez le chemin daccs ou parcourez vos dossiers jusquau fichier XML transformer. Dans cet exemple, il sagit dune liste de titres MP3 et leurs informations associes (nom de lartiste, maison de disque...).
Dans le champ XSL file de la vue Basic settings, renseignez le chemin daccs ou parcourez vos dossiers jusquau fichier XSL appropri. Dans le champ Output file, renseignez le chemin daccs ou parcourez vos dossiers jusquau fichier HTML. Dans cet exemple, lobjectif est de convertir les donnes XML en fichier HTML comprenant un tableau constitu dun en-tte suivi de la liste du nom des artistes ct du nom des chansons.
1720
Composants XML
tXSLT
Dans la zone Parameters de la vue Basic settings, cliquez sur le bouton [+] pour ajouter une ligne o dfinir le nom et la valeur du paramtre de transformation du fichier XSL. Dans cet exemple, le nom du paramtre de transformation utilis est bgcolor et sa valeur est green. Double-cliquez sur le tMsgBox pour afficher la vue Basic settings et paramtrer le composant.
1721
Composants XML
tXSLT
Enregistrez votre Job puis appuyez sur F6 pour lexcuter. Une bote de dialogue saffiche et vient confirmer que le fichier HTML est bien cr en sortie et quil est stock lendroit pralablement dfini.
Cliquez sur Ok pour fermer la bote de dialogue. Vous pouvez dsormais ouvrir le fichier HTML cr pour vrifier la transformation des donnes XML et la couleur darrire-plan de len-tte du tableau.
1722
A Alias ........................................................... 980 B Business tBonitaDeploy ........................................ 14 tBonitaInstantiateProcess ....................... 16 tCentricCRMInput ................................. 22 tCentricCRMOutput ............................... 23 tHL7Input ............................................... 24 tHL7Output ............................................ 29 tMarketoInput ........................................ 30 tMarketoOutput ...................................... 33 tMicrosoftCRMInput ............................. 40 tMicrosoftCRMOutput ........................... 48 tMSAXInput .......................................... 50 tMSAXOutput ........................................ 51 tOpenbravoERPInput ............................. 58 tOpenBravoERPOutput ......................... 60 tSageX3Input ......................................... 61 tSageX3Output ....................................... 66 tSalesforceBulkExec .............................. 71 tSalesforceConnection ........................... 73 tSalesforceGetDeleted ........................... 74 tSalesforceGetServerTimestamp ........... 78 tSalesforceGetUpdated .......................... 80 tSalesforceInput ..................................... 82 tSalesforceOutput ................................... 89 tSalesforceOutputBulk ........................... 93 tSalesforceOutputBulkExec ................... 99 tSAPCommit ........................................ 104 tSAPRollback ....................................... 122 tSugarCRMInput .................................. 123 tSugarCRMOutput ............................... 126 tVtigerCRMInput ................................. 127 tVtigerCRMOutput .............................. 129 Business Intelligence tDB2SCD ............................................. 139 tIGreenplumSCD ................................. 144 tInformixSCD ...................................... 146 tIngresSCD ........................................... 148 tMondrianInput .................................... 158 tMSSqlSCD ......................................... 162 tMysqlSCD .......................................... 164 tOracleSCD .......................................... 182
tPaloCheckElements .............................186 tPaloConnection ...................................189 tPaloCube .............................................190 tPaloCubeList .......................................194 tPaloDatabase .......................................198 tPaloDatabaseList .................................201 tPaloDimension ....................................205 tPaloDimensionList ..............................214 tPaloInputMulti .....................................218 tPaloOutput ...........................................224 tPaloOutputMulti ..................................226 tPaloRule ......................................235, 239 tParAccelSCD .......................................243 tSPSSInput ............................................255 tSPSSOutput .........................................259 tSPSSProperties ....................................262 tSPSSStructure .....................................263 tSybaseSCD ..........................................265 BusinessIntelligence PostgresPlusSCD ..................................245 PostgresqlSCD ......................................250 tBarChart ..............................................132 tLineChart .............................................150 C Component, Composant ..131, 293, 329, 1101, 1483, .........................................................1615 Contexte ....................................................1598 Custom Code tJava ......................................272, 273, 275 tJavaFlex ...............................279, 286, 287 tSetGlobalVar .......................................290 CustomCode tGroovy .................................................272 tGroovyFile ...........................................273 tJava ......................................................275 tJavaFlex ...............................................279 tJavaRow ..............................................286 tLibraryLoad .........................................287 D Data Quality tAddCRCRow .......................................294 tFuzzyMatch .........................................299 tIntervalMatch ......................................305
tParseAddress ....................................... 310 tParseName .......................................... 312 tReplaceList ......................................... 314 tSchemaComplianceCheck .................. 319 tUniqRow ............................................. 325 Data quality tAddCRCRow .............................. 294, 310 tFuzzyMatch ...................................... 1530 Database PostgresPlusOutput .............................. 797 tAccessBulkExec ................................. 330 tAccessCommit .................................... 333 tAccessConnection ............................... 334 tAccessInput ......................................... 339 tAccessOutput ...................................... 342 tAccessOutputBulk .............................. 347 tAccessOutputBulkExec ...................... 349 tAccessRollback ................................... 352 tAccessRow ......................................... 353 tAS400Close ........................................ 356 tAS400Commit .................................... 357 tAS400Connection ............................... 358 tAS400Input ......................................... 360 tAS400LastInsertId .............................. 363 tAS400Output ...................................... 364 tAS400Rollback ................................... 369 tAS400Row .......................................... 370 tDB2BulkExec ..................................... 378 tDB2Close ............................................ 381 tDB2Commit ........................................ 382 tDB2Connection .................................. 383 tDB2Input ............................................ 385 tDB2Output .......................................... 388 tDB2Rollback ...................................... 392 tDB2Row ............................................. 393 tDB2SCD ................................... 396, 1259 tDB2SCDELT .............................. 141, 397 tDB2SP ................................................ 398 tDBInput .................................... 400, 1149 tDBOutput ............................................ 405 tDBSQLRow ........................................ 410 tEXAInput ............................................ 414 tEXAOutput ......................................... 416 tEXARow ............................................. 419 tEXistConnection ................................. 421
tFirebirdClose .......................................437 tFirebirdCommit ...................................438 tFirebirdConnection ..............................439 tFirebirdInput ........................................441 tFirebirdOutput .....................................443 tFirebirdRollback ..................................447 tFirebirdRow .........................................448 tFixedFlowInput .................................1429 tGreenplumBulkExec ...........................451 tGreenplumClose ..................................454 tGreenplumCommit ..............................455 tGreenplumConnection .........................456 tGreenplumInput ...................................458 tGreenplumOutput ................................460 tGreenplumOutputBulk ........................464 tGreenplumOutputBulkExec ................466 tGreenplumRollback .............................469 tGreenplumRow ...................................470 tGreenplumSCD ...................................473 tHiveClose ............................................474 tHiveConnection ...................................475 tHiveRow ..............................................477 tHSQLDbInput .....................................480 tHSQLDbOutput ...................................483 tHSQLDbRow ......................................488 tInformixBulkExec ...............................491 tInformixClose ......................................495 tInformixCommit ..................................496 tInformixConnection ............................497 tInformixInput ......................................499 tInformixOutput ....................................501 tInformixOutputBulk ............................505 tInformixOutputBulkExec ....................507 tInformixRollback ................................511 tInformixRow .......................................512 tInformixSCD .......................................515 tInformixSP ..........................................516 tIngresClose ..........................................519 tIngresCommit ......................................520 tIngresConnection .................................521 tIngresInput ...........................................522 tIngresOutput ........................................524 tIngresRollback .....................................527 tIngresRow ...........................................528 tIngresSCD ...........................................530
ii
tInterbaseClose ..................................... 531 tInterbaseCommit ................................. 532 tInterbaseConnection ........................... 533 tInterbaseInput ..................................... 534 tInterbaseOutput ................................... 536 tInterbaseRollback ............................... 539 tInterbaseRow ...................................... 540 tJavaDBInput ....................................... 543 tJavaDBOutput ..................................... 545 tJavaDBRow ........................................ 548 tJDBCClose ......................................... 551 tJDBCColumnList ............................... 550 tJDBCCommit ..................................... 552 tJDBCConnection ................................ 553 tJDBCInput .......................................... 555 tJDBCOutput ....................................... 558 tJDBCRollback .................................... 562 tJDBCRow ........................................... 563 tJDBCSP .............................................. 566 tJDBCTableList ................................... 568 tLDAPAttributesInput ......................... 569 tLDAPInput ......................................... 572 tLDAPOutput ....................................... 576 tLDAPRenameEntry ............................ 581 tMaxDBInput ....................................... 583 tMaxDBOutput .................................... 585 tMaxDBRow ........................................ 588 tMSSqlBulkExec ................................. 590 tMSSqlClose ........................................ 593 tMSSqlCommit .................................... 595 tMSSqlConnection ............................... 596 tMSSqlInput ......................................... 598 tMSSqlLastInsertId .............................. 601 tMSSqlOutput .............................. 601, 602 tMSSqlOutputBulk .............................. 607 tMSSqlOutputBulkExec ...................... 609 tMSSqlRollback ................................... 612 tMSSqlRow .......................................... 613 tMSSqlSCD ......................................... 616 tMSSqlSP ............................................. 617 tMSSqlTableList .................................. 620 tMysqlBulkExec .......... 451, 621, 698, 762 tMysqlClose ......................................... 624 tMysqlColumnList ............................... 625 tMysqlCommit .... 356, 381, 382, 437, 438,
454, ..455, 474, 495, 496, 519, 520, 531, ..532, 550, 551, 552, 568, 593, 594, ..595, 620, 624, 625, 629, 693, 701, ..702, 730, 731, 761, 765, 766, 790, ..791, 815, 816, 842, 843, 862, 863, 893, 894, 924, 942, 943, 1034, 1329 tMysqlConnection 334, 358, 383, 421, 439, ..456, 475, 497, 521, 533, 553, 596, 630, ..703, 732, 767, 792, 817, 844, 864, ...........................895, 925, 944 tMysqlInput ..................................635, 946 tMysqlLastInsertId ...............................642 tMysqlOutput ................................647, 949 tMysqlOutputBulk ................................665 tMysqlOutputBulkExec ........................670 tMysqlRollback ...122, 352, 363, 369, 392, 447, ..469, 511, 527, 539, 612, 642, 674, ..719, 781, 806, 854, 884, 914, 935, .......................958, 1049, 1305 tMysqlRow ...................................676, 720 tMysqlSCD ...........................................686 tMysqlSCDELT ............................177, 687 tMysqlSP ..............................................688 tMysqlTableList ...................................693 tNetezzaBulkExec ................................698 tNetezzaClose .......................................701 tNetezzaCommit ...................................702 tNetezzaConnection ..............................703 tNetezzaInput ........................................705 tNetezzaNzLoad ...................................708 tNetezzaOutput .....................................715 tNetezzaRollback ..................................719 tNetezzaRow .........................................720 tOracleBulkExec ...................................723 tOracleClose .........................................730 tOracleCommit .....................................731 tOracleConnection ................................732 tOracleInput ..........................................734 tOracleOutput .......................................737 tOracleOutputBulk ...............................742 tOracleOutputBulkExec .......................744 tOracleRollback ....................................748 tOracleRow ...........................................749 tOracleSCD ...................................180, 752
iii
tOracleSCDELT ........................... 183, 753 tOracleSP ............................................. 754 tOracleTableList .................................. 761 tParAccelBulkExec .............................. 762 tParAccelClose ..................................... 765 tParAccelCommit ................................. 766 tParAccelConnection ........................... 767 tParAccelInput ..................................... 769 tParAccelOutput ................................... 772 tParAccelOutputBulk ........................... 776 tParAccelOutputBulkExec ................... 778 tParAccelRollback ............................... 781 tParAccelRow ...................................... 782 tParAccelSCD ...................................... 785 tPosgtresqlOutput ................................. 822 tPostgresPlusBulkExec ........................ 787 tPostgresPlusClose ............................... 790 tPostgresPlusCommit ........................... 791 tPostgresPlusConnection ..................... 792 tPostgresPlusInput ............................... 794 tPostgresPlusOutputBulk ..................... 802 tPostgresPlusOutputBulkExec ............. 804 tPostgresPlusRollback ......................... 806 tPostgresPlusRow ................................ 807 tPostgresPlusSCD ................................ 810 tPostgresPlusSCDELT ................. 247, 811 tPostgresqlBulkExec ............................ 812 tPostgresqlClose ................................... 815 tPostgresqlCommit ............................... 816 tPostgresqlConnection ......................... 817 tPostgresqlInput ................................... 819 tPostgresqlOutputBulk ......................... 826 tPostgresqlOutputBulkExec ................. 828 tPostgresqlRollback ............................. 831 tPostgresqlRow .................................... 832 tPostgresqlSCD .................................... 835 tPostgresqlSCDELT ..................... 252, 836 tSASInput ............................................. 837 tSASOutput .......................................... 839 tSQLiteClose ........................................ 842 tSQLiteCommit .................................... 843 tSQLiteConnection .............................. 844 tSQLiteInput ........................................ 846 tSQLiteOutput ...................................... 850 tSQLiteRollback .................................. 854
tSQLiteRow ..........................................855 tSybaseBulkExec ..................................859 tSybaseClose .........................................862 tSybaseCommit .....................................863 tSybaseConnection ...............................864 tSybaseInput .........................................865 tSybaseIQBulkExec ..............................868 tSybaseIQOutputBulkExec ...................871 tSybaseOutput .......................................874 tSybaseOutputBulk ...............................879 tSybaseOutputBulkExec .......................881 tSybaseRollback ...................................884 tSybaseRow ..........................................885 tSybaseSCD ..........................................888 tSybaseSCDELT ...........................267, 889 tSybaseSP .............................................890 tTeradataClose ......................................893 tTeradataCommit ..................................894 tTeradataConnection .............................895 tTeradataFastExport .............................897 tTeradataFastLoad ................................899 tTeradataFastLoadUtility ......................901 tTeradataInput .......................................903 tTeradataMultiLoad ..............................906 tTeradataOutput ....................................909 tTeradataRollback .................................914 tTeradataRow .......................................915 tTeradataTPump ...................................918 tVectorWiseCommit .............................924 tVectorWiseConnection .......................925 tVectorWiseInput .................................927 tVectorWiseOutput ...............................930 tVectorWiseRollback ...........................935 tVectorWiseRow ..................................936 tVerticaBulkExec .................................939 tVerticaClose ........................................942 tVerticaCommit ..........438, 924, 943, 1034 tVerticaConnection ...............................944 tVerticaInput .........................................946 tVerticaOutput ......................................949 tVerticaOutputBulk ..............................954 tVerticaOutputBulkExec ......................956 tVerticaRollback ...................................958 tVerticaRow ..........................................959 Database Utilities
iv
tCreateTable ......................................... 373 tParseRecordSet ................................... 786 Databases tEXistDelete ......................................... 423 tEXistGet ............................................. 425 tEXistList ............................................. 429 tEXistPut .............................................. 431 tEXistXQuery ...................................... 433 tEXistXUpdate ..................................... 435 DataQuality tIntervalMatch ...................................... 305 E ELT tELTJDBCInput ................................... 964 tELTJDBCMap .................................... 966 tELTJDBCOutput ................................ 968 tELTMSSqlInput ................................. 970 tELTMSSqlMap ................................... 972 tELTMSSqlOutput ............................... 974 tELTMysqlInput 964, 970, 976, 1008, 1014 tELTMysqlMap 966, 972, 978, 1010, 1016 tELTMysqlOutput ..... 968, 974, 990, 1012, 1018 tELTOracleInput .................................. 992 tELTOracleMap ................................... 994 tELTOracleOutput ............................. 1000 tELTPostgresqlInput .......................... 1008 tELTPostgresqlMap ........................... 1010 tELTPostgresqlOutput ....................... 1012 tELTSybaseInput ............................... 1014 tELTSybaseMap ................................ 1016 tELTSybaseOutput ............................. 1018 tELTTeradataInput ............................. 1020 tELTTeradataMap .............................. 1022 tELTTeradataOutput .......................... 1025 tSQLTemplateAggregate ................... 1027 tSQLTemplateCommit ....................... 1034 tSQLTemplateFilterColumns ............. 1036 tSQLTemplateFilterRows .................. 1038 tSQLTemplateMerge ......................... 1040 tSQLTemplateRollback ..................... 1049 ESB tESBConsumer ................................... 1052 EST
tESBProviderFault ..............................1062 tESBProviderRequest .........................1074 tESBProviderResponse .......................1087 F File tApacheLogInput ................................1103 tChangeFileEncoding .........................1106 tCreateTemporaryFile .........................1109 tExtractPositionalFields ......................1517 tFileArchive ........................................1114 tFileCompare ......................................1117 tFileCopy ............................................1121 tFileDelete ................................1124, 1127 tFileExist .............................................1127 tFileInputARFF ..................................1132 tFileInputDelimited .......1103, 1132, 1136, 1152, ........1159, 1164, 1238, 1240, 1625, ...................1631, 1636, 1648 tFileInputExcel ...................................1149 tFileInputFullRow ..............................1152 tFileInputJSON .........................1155, 1212 tFileInputLDIF ...................................1159 tFileInputMail .....................................1161 tFileInputPositional .......1172, 1178, 1183, 1220, .............................1222, 1232 tFileInputRegex ..................................1188 tFileInputXML ....1155, 1174, 1192, 1212, 1224, .........1688, 1691, 1699, 1709 tFileList 297, 298, 1109, 1193, 1266, 1446, .................................................1465 tFileOutputARFF ................................1199 tFileOutputDelimited ..........................1201 tFileOutputExcel .............1210, 1235, 1271 tFileOutputLDIF .................................1216 tFileOutputMSDelimited ....................1220 tFileOutputMSPositional ....................1222 tFileOutputPositional ..........................1230 tFileOutputXML .......................1234, 1707 tFileProperties .....................................1235 tFileRowCount ...................................1238 tFileTouch ...........................................1240 tFileUnarchive ................1114, 1241, 1243 tFTPFileProperties ..............................1271 tGPGDecrypt ......................................1243
tPivotToColumnsDelimited ............... 1247 I Internet tFileFetch ........................................... 1252 tFTPConnection ................................. 1260 tFTPDelete ............................... 1262, 1264 tFTPFileExist ..................................... 1264 tFTPFileList ....................................... 1266 tFTPGet .............................................. 1273 tFTPPut ....... 423, 425, 429, 431, 433, 435, 1260, .................. 1276, 1280, 1282 tFTPRename ...................................... 1280 tFTPTruncate ..................................... 1282 tHttpRequest ...................................... 1284 tJMSInput ........................................... 1287 tJMSOutput ........................................ 1289 tMicrosoftMQInput ............................ 1291 tMicrosoftMQOutput ......................... 1295 tMomCommit ..................................... 1296 tMomInput ......................................... 1297 tMomMessageIdList .......................... 1302 tMomOutput ....................................... 1303 tMomRollback ................................... 1305 tPOP ................................................... 1306 tREST ................................................. 1310 tRSSInput ........................................... 1314 tRSSOutput ........................................ 1317 tSCPClose .......................................... 1329 tSCPConnection ................................. 1330 tSCPDelete ......................................... 1331 tSCPFileExists ................................... 1332 tSCPFileList ............................. 1330, 1333 tSCPGet ............................................. 1334 tSCPPut .............................................. 1336 tSCPRename ...................................... 1337 tSCPTruncate ..................................... 1338 tSendMail ........................................... 1339 tSetKeyStore ...................................... 1344 tSOAP ................................................ 1357 tSocketInput ....................................... 1350 tSocketOutput .................................... 1355 tWebServiceInput .............................. 1361 tXMLRPCInput ................................. 1370
J Jointure Explicite ................................................980 Jointure explicite ........................................980 L Log&Error tDie .....................................................1388 tLogCatcher ........................................1395 tLogRow .............................................1399 Logs&Errors tAssert .................................................1374 tAssertCatcher ....................................1380 tChronometerStart ..............................1382 tChronometerStop ...............................1383 tFlowMeter .........................................1389 tFlowMeterCatcher .............................1390 tStatCatcher ........................................1400 tWarn ..................................................1403 M Misc tAddLocationFromIP ..........................1406 tAlfrescoOutput ........................................2 tBufferOutput ...........................1410, 1413 tContextDump ....................................1424 tContextLoad ......................................1425 tLoop .........................................1462, 1463 tMemorizeRows .................................1431 tMsgBox .............................................1438 tRowGenerator ...................................1440 MultiSchema tFileInputMSDelimited .......................1164 tFileInputMSPositional .......................1172 tFileInputMSXML ..............................1174 O Orchestration tFileList ...............................................1446 tFlowToIterate ....................................1447 tForeach ..............................................1452 tInfiniteLoop .......................................1455 tIterateToFlow ....................................1456 tLoop ...................................................1459 tPostjob ...............................................1462
vi
tPrejob ................................................ 1463 tReplicate ........................................... 1464 tRunJob .............................................. 1465 tSleep ................................................. 1470 tUnite ................................................. 1466 tWaitForFile ....................................... 1471 tWaitForSocket .................................. 1476 tWaitForSqlData ................................ 1478 P Processing tAggregateRow ........................ 1027, 1484 tAggregateSortedRow ........................ 1490 tConvertType ..................................... 1492 tDenormalize ...................................... 1497 tDenormalizeSortedRow .................... 1502 tEmptyToNull .................................... 1506 tExternalSortedRow ........................... 1510 tExtractDelimitedFields ..................... 1512 tExtractRegexFields ........................... 1519 tExtractXMLField .............................. 1523 tFilterColumns ................................... 1524 tFilterRow .......................................... 1525 tJoin .................................................... 1530 tMap ................................................... 1535 tNormalize ......................................... 1567 tPerl .................................................... 1570 tPivotToRows .................................... 1573 tReplace ............................................. 1577 tSampleRow ....................................... 1582 tSortRow ............................................ 1585 tXMLMap .......................................... 1589 Proprits du tDB2Close ... 381, 437, 454, 474 S StoreSQLQuery ......................................... 403 System tRunJob .............................................. 1596 tSetEnv ............................................... 1603 tSSH ................................................... 1607 tSystem ............................................... 1611 T Table Alias ..................................................... 980
Tables de jointures Jointures externes (+) ...........................996 Mots cl privs Oracle ..........................996 tAccessConnection Advanced settings .................................334 tAccessInput Advanced settings .................................340 tAccessOutput Advanced settings .................................345 Talend MDM tMDMBulkLoad .................................1616 tMDMDelete .......................................1625 tMDMInput .........................................1631 tMDMOutput ......................................1636 tMDMReceive ....................................1646 tMDMRouteRecord ............................1648 tMDMSP .............................................1659 tMDMViewSearch .............................1666 tAlfrescoOutput Advanced settings .....................................3 tAS400Connection Advanced settings .................................358 tAS400Input Advanced settings .........................361, 584 tAS400Output Advanced settings .................................367 tDB2Input Advanced settings ...387, 1426, 1429, 1440 tDB2Output Advanced settings .143, 249, 254, 380, 390 tDBInput Advanced settings .................................401 tDBOutput Advanced settings .................................407 tExaOutput Advanced settings .................................417 tFileInputEBCDIC ....................................1143 tFileInputExcel Advanced settings ...............................1150 tFileOutputEBCDIC .................................1207 tFirebirdInput Advanced settings .................415, 420, 441 tFirebirdOutput Advanced settings .................................445 tFTPFileList ..............................................1266
vii
tHSQLDBOutput Advanced settings tHSQLDbOutput Advanced settings tInformixOutput Advanced settings tIngresInput Advanced settings tIngresOutput Advanced settings tInterbaseOutput Advanced settings tJavaDBInput Advanced settings tJavaDBOutput Advanced settings tJDBCInput Advanced settings tJDBCOutput Advanced settings tMSSqlInput Advanced settings tMSSqlOutput Advanced settings tMysqlInput Advanced settings tMysqlOutput Advanced settings tNetezzaNzLoad Advanced settings tOracleInput Advanced settings tOracleOutput Advanced settings tPostegresqlInput Advanced settings
................................ 587 ........................ 486, 587 ................ 493, 500, 503 ................ 481, 489, 523 ................................ 526 ................................ 538 ................................ 544 ........................ 547, 560 ................................ 556 ................................ 560 ................................ 599 ................................ 605 ................................ 636 ................ 493, 500, 503 ................................ 709 ................................ 736 ................................ 740 ........ 459, 771, 796, 821
tPostegresqlOutput Advanced settings .463, 763, 774, 800, 824 tPostegrsqlOutput Advanced settings .463, 763, 774, 800, 824 tSASInput Advanced settings .................................838 tSASOutput Advanced settings .................................841 tSQLiteInput Advanced settings .................................847 tSQLiteOutput Advanced settings .................................852 tSybaseInput Advanced settings .................................867 tSybaseOutput Advanced settings .................................877 tTeradataInput Advanced settings .897, 899, 902, 907, 919 tTeradataOutput Advanced settings 904, 912, 916, 929, 933, ...................................................937 V Variable ....................................................1598 StoreSQLQuery ....................................403 X XML tAdvancedFileOutputXML .................1674 tDTDValidator ....................................1685 tEDIFACTtoXML ..............................1688 tExtractXMLField ..............................1691 tFileOutputMSXML ...........................1224 tWriteXMLField .................................1709 tXSDValidator ....................................1715 tXSLT .................................................1719
viii
ix

TalendOpenStudio Components RG 42a FR

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

TalendOpenStudio Components RG 42a FR

Uploaded by

Copyright:

Available Formats

Talend Open Studio Composants

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Talend Open Studio Composants Guide de rfrence ..................... i

Composants Business .................................. 1

Composants Talend Open Studio

Composants Business Intelligence ......... 131

Composants Talend Open Studio

Composants Custom Code .......................271

Composants Data Quality .......................293

Composants Talend Open Studio

Composants Databases ........................... 329

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Composants ELT .....................................963

Composants Talend Open Studio

Scnario associ .................................................1050

Composants ESB ...................................1051

Composants File .....................................1101

Composants Talend Open Studio

Composants Talend Open Studio

Composants Internet ............................. 1251

Composants Talend Open Studio

Composants Logs & Errors ...................1373

Composants Talend Open Studio

Proprits du tWarn ........................................... 1403 Scnarios associs ............................................. 1403

Composants Misc ................................... 1405

Composants Processing .........................1483

Composants Orchestration ................... 1445

Composants Talend Open Studio

Composants System ...............................1595

Composants Talend MDM ....................1615

Composants Talend Open Studio

Composants XML .................................. 1673

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

introduit un paragraphe apportant une information supplmentaire sur un point

Composants Talend Open Studio

Historique des versions

Composants Talend Open Studio

Objectif Basic settings

Composants Talend Open Studio

Define Document Type

Schema et Edit schema

Composants Talend Open Studio

Association Target Mapping

Composants Talend Open Studio

Composants Talend Open Studio

Composants Talend Open Studio

Dmatrialisation, tAlfrescoOutput et Gestion de Contenu

Composants Talend Open Studio

Scnario : Crer des documents sur un serveur Alfresco

Composants Talend Open Studio

Le schma dentre du fichier dlimit sera donc comme suit :

Composants Talend Open Studio