Vous êtes sur la page 1sur 1760

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/

Composants Talend Open Studio

iii

iv

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

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

Composants Talend Open Studio

Composants Talend Open Studio

xxiii

xxiv

Composants Talend Open Studio

Composants Talend Open Studio

xxv

xxvi

Composants Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

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 Talend Open Studio

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 Talend Open Studio

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 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 Talend Open Studio

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 Talend Open Studio

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 Talend Open Studio

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 Talend Open Studio

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 Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

Composants Business
tAlfrescoOutput

Les deux documents sont crs sur Alfresco grce aux mtadonnes des schmas dentre.

Composants Talend Open Studio

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.

Objectif Basic settings

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 Talend Open Studio

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.

Composants Talend Open Studio

15

Composants Business
tBonitaInstantiateProcess

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 Talend Open Studio

Composants Business
tBonitaInstantiateProcess

Utilisation Connections

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.

Composants Talend Open Studio

17

Composants Business
tBonitaInstantiateProcess

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 Talend Open Studio

Composants Business
tBonitaInstantiateProcess

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.

Composants Talend Open Studio

19

Composants Business
tBonitaInstantiateProcess

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 Talend Open Studio

Composants Business
tBonitaInstantiateProcess

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.

Composants Talend Open Studio

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.

Fonction Objectif Basic settings

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
Aucun scnario nest disponible pour ce composant.

22

Composants Talend Open Studio

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.

Fonction Objectif Basic settings

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

Utilisation Limitation

Scnario associ
Aucun scnario nest disponible pour ce composant.

Composants Talend Open Studio

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 Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

Composants Business
tHL7Output

tHL7Output
Proprits du tHL7Output
Famille de composant Business

Fonction Objectif Basic settings

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.

Composants Talend Open Studio

29

Composants Business
tMarketoInput

tMarketoInput
Proprits du tMarketoInput
Famille de composant Business

Fonction Objectif Basic settings

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.

Schema et Edit schema

30

Composants Talend Open Studio

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 Talend Open Studio

Composants Business
tMarketoOutput

tMarketoOutput
Proprits du tMarketoOutput
Famille de composant Business

Fonction Objectif Basic settings

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.

Composants Talend Open Studio

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.

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 sortie. Un composant dentre est ncessaire. n/a

34

Composants Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

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.

Composants Talend Open Studio

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.
38 Composants Talend Open Studio

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.

Composants Talend Open Studio

39

Composants Business
tMicrosoftCRMInput

tMicrosoftCRMInput
Proprits du tMicrosoftCRMInput
Famille de composant Business

Fonction Objectif Basic settings

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 Talend Open Studio

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.

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. 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.

Composants Talend Open Studio

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 Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

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 Talend Open Studio

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.

Composants Talend Open Studio

47

Composants Business
tMicrosoftCRMOutput

tMicrosoftCRMOutput
Proprits du tMicrosoftCRMOutput
Famille de composant Business

Fonction Objectif Basic settings

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 Talend Open Studio

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.

Composants Talend Open Studio

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.

Fonction Objectif Basic settings

Table Name Query

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. Un composant de sortie est ncessaire. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

50

Composants Talend Open Studio

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.

Fonction Objectif Basic settings

Composants Talend Open Studio

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

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 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 Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

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.

Composants Talend Open Studio

57

Composants Business
tOpenbravoERPInput

tOpenbravoERPInput
Proprits du tOpenbravoERPInput
Famille de composant Business

Fonction Objectif Basic settings

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 Talend Open Studio

Composants Business
tOpenbravoERPInput

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.

Composants Talend Open Studio

59

Composants Business
tOpenbravoERPOutput

tOpenbravoERPOutput
Proprits du tOpenbravoERPOutput
Famille de composant Business

Fonction Objectif Basic settings

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

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

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.

60

Composants Talend Open Studio

Composants Business
tSageX3Input

tSageX3Input
Proprits du tSageX3Input
Famille de composant Business/Sage X3

Fonction Objectif Basic settings

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

Composants Talend Open Studio

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

Utilisation Limitation

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 Talend Open Studio

Composants Business
tSageX3Input

Dans la liste Schema, slectionnez Built-In. Cliquez sur le bouton [...] ct du champ Edit schema pour ouvrir lditeur du schma.

Composants Talend Open Studio

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 :
64 Composants Talend Open Studio

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 :

Composants Talend Open Studio

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.

Objectif Basic settings

Endpoint address Username et Password Language Pool alias

Request config

66

Composants Talend Open Studio

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

Utilisation Limitation

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.

Composants Talend Open Studio

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 Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

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
Famille de composant Business

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

Composants Talend Open Studio

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.

Schema et Edit Schema

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 Talend Open Studio

Composants Business
tSalesforceConnection

tSalesforceConnection

Proprits du tSalesforceConnection
Famille de composant Business

Fonction Objectif Basic settings

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

Advanced settings Utilisation Limitation

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.

Composants Talend Open Studio

73

Composants Business
tSalesforceGetDeleted

tSalesforceGetDeleted
Proprits du tSalesforceGetDeleted
Famille de composant Business

Fonction Objectif Basic settings

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.

Schema et Edit Schema

74

Composants Talend Open Studio

Composants Business
tSalesforceGetDeleted

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 :

Composants Talend Open Studio

75

Composants Business
tSalesforceGetDeleted

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 Talend Open Studio

Composants Business
tSalesforceGetDeleted

La console affiche les donnes supprimes rcupres par le composant tSalesforceGetDeleted sous forme de tableau.

Composants Talend Open Studio

77

Composants Business
tSalesforceGetServerTimestamp

tSalesforceGetServerTimestamp
Proprits du tSalesforceGetServerTimestamp
Famille de composant Business

Fonction Objectif Basic settings

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 Talend Open Studio

Composants Business
tSalesforceGetServerTimestamp

Use Soap Compression

Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance.

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 associ
Aucun scnario nest disponible pour ce composant.

Composants Talend Open Studio

79

Composants Business
tSalesforceGetUpdated

tSalesforceGetUpdated
Proprits du tSalesforceGetUpdated
Famille de composant Business

Fonction Objectif Basic settings

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.

Schema et Edit Schema

80

Composants Talend Open Studio

Composants Business
tSalesforceGetUpdated

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

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 associ
Aucun scnario nest disponible pour ce composant.

Composants Talend Open Studio

81

Composants Business
tSalesforceInput

tSalesforceInput
Proprits du tSalesforceInput
Famille de composant Business

Fonction Objectif Basic settings

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 Talend Open Studio

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.

Schema et Edit Schema

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)

Composants Talend Open Studio

83

Composants Business
tSalesforceInput

Use Soap Compression

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 Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

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 :

Composants Talend Open Studio

87

Composants Business
tSalesforceInput

88

Composants Talend Open Studio

Composants Business
tSalesforceOutput

tSalesforceOutput
Proprits du tSalesforceOutput
Famille de composant Business

Fonction Objectif Basic settings

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.

Composants Talend Open Studio

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

Schema et Edit Schema

Advanced settings

Extended Output

Die on error

Error logging file

Use Socks Proxy

Use Soap Compression

90

Composants Talend Open Studio

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.

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 : 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 :

Composants Talend Open Studio

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.
92 Composants Talend Open Studio

Composants Business
tSalesforceOutputBulk

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
Famille de composant Business

Fonction Objectif Basic settings

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.

Composants Talend Open Studio

93

Composants Business
tSalesforceOutputBulk

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 Talend Open Studio

Composants Business
tSalesforceOutputBulk

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.

Composants Talend Open Studio

95

Composants Business
tSalesforceOutputBulk

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 Talend Open Studio

Composants Business
tSalesforceOutputBulk

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.

Composants Talend Open Studio

97

Composants Business
tSalesforceOutputBulk

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 Talend Open Studio

Composants Business
tSalesforceOutputBulkExec

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
Famille de composant Business

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

Composants Talend Open Studio

99

Composants Business
tSalesforceOutputBulkExec

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.

Schema et Edit Schema

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 Talend Open Studio

Composants Business
tSalesforceOutputBulkExec

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.

Composants Talend Open Studio

101

Composants Business
tSalesforceOutputBulkExec

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 Talend Open Studio

Composants Business
tSalesforceOutputBulkExec

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.

Composants Talend Open Studio

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

Advanced settings Utilisation Limitation

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 Talend Open Studio

Composants Business
tSAPConnection

tSAPConnection
Proprits du tSAPConnection
Famille de composant Business

Fonction Objectif Basic settings

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.

Advanced settings Utilisation Limitation

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.

Composants Talend Open Studio

105

Composants Business
tSAPInput

tSAPInput
Proprits du tSAPInput
Famille de composant Business

Fonction Objectif Basic settings

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 Talend Open Studio

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.

Composants Talend Open Studio

107

Composants Business
tSAPInput

Utilisation Limitation

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 Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

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 Talend Open Studio 111

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 Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

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.

Composants Talend Open Studio

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 Talend Open Studio

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.

Composants Talend Open Studio

119

Composants Business
tSAPOutput

tSAPOutput
Proprits du tSAPOutput
Famille de composant Business

Fonction Objectif Basic settings

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 Talend Open Studio

Composants Business
tSAPOutput

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. 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.

Composants Talend Open Studio

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.

Advanced settings Usage Limitation

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 Talend Open Studio

Composants Business
tSugarCRMInput

tSugarCRMInput
Proprits du tSugarCRMInput
Famille du composant Business

Fonction Objectif Basic settings

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

Schema et Edit Schema

Query condition

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. Un composant de sortie est ncessaire. n/a

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.

Composants Talend Open Studio

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 Talend Open Studio

Composants Business
tSugarCRMInput

Les donnes filtres sont inscrites en sortie dans la feuille de calcul du fichier Excel spcifi.

Composants Talend Open Studio

125

Composants Business
tSugarCRMOutput

tSugarCRMOutput
Proprits du tSugarCRMOutput
Famille du composant Business

Fonction Objectif Basic settings

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

Schema et Edit schema

Advanced settings Utilisation 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

Scnario associ
Aucun scnario nest disponible pour ce composant.

126

Composants Talend Open Studio

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.

Schema et Edit Schema

Vtiger 5.1

Endpoint Username Access key Action

Module

Composants Talend Open Studio

127

Composants Business
tVtigerCRMInput

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.. 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

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 associ
Aucun scnario nest disponible pour ce composant.

128

Composants Talend Open Studio

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.

Schema et Edit Schema

Vtiger 5.1

Endpoint Username Access key Action

Module

Composants Talend Open Studio

129

Composants Business
tVtigerCRMOutput

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.. 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

Advanced settings Utilisation 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

Scnario associ
Aucun scnario nest disponible pour ce composant.

130

Composants Talend Open Studio

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.

Composants Business Intelligence


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

Objectif Basic settings

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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

133

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


tBarChart

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

Composants Talend Open Studio

135

Composants Business Intelligence


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.
136 Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

137

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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

Composants Talend Open Studio

139

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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

Composants Talend Open Studio

141

Composants Business Intelligence


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

Schema et Edit schema

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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

143

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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

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.

Composants Talend Open Studio

145

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

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. 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

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.

Usage

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 du composant tMysqlSCD.

Composants Talend Open Studio

147

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


tIngresSCD

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

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.

Usage

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 du composant tMysqlSCD.

Composants Talend Open Studio

149

Composants Business Intelligence


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

Objectif Basic settings

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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

151

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


tLineChart

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

Composants Talend Open Studio

153

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

155

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


tLineChart

Composants Talend Open Studio

157

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


tMondrianInput

Encoding

Slectionnez le type dencodage partir de la liste ou choisissez loption Custom pour le dfinir manuellement. Ce champ doit obligatoirement tre renseign.

Advanced settings Utilisation

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.

Composants Talend Open Studio

159

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

161

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Use memory saving Mode Die on error

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.

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.

Composants Talend Open Studio

163

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

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.

Use memory saving mode Die on error

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.

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

Composants Talend Open Studio

165

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

167

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

169

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

171

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

173

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

175

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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

Composants Talend Open Studio

177

Composants Business Intelligence


tMysqlSCDELT

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

Schema et Edit schema

Source Keys

Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes.

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.

178

Composants Talend Open Studio

Composants Business Intelligence


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.

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 tMysqlSCD, page 164, ainsi que le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168.

Composants Talend Open Studio

179

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

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 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.

Use memory saving Mode Die on error

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.

Ce composant est un composant de sortie. Par consquent, il requiert un composant et une connexion de type Row Main en entre.

Composants Talend Open Studio

181

Composants Business Intelligence


tOracleSCD

Scnario associ
Pour un scnario associ, consultez le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168.

182

Composants Talend Open Studio

Composants Business Intelligence


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

Composants Talend Open Studio

183

Composants Business Intelligence


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

Schema et Edit schema

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.

184

Composants Talend Open Studio

Composants Business Intelligence


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

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 tOracleSCD, page 180, ainsi que le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168.

Composants Talend Open Studio

185

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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 .

Schema et Edit Schema

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.

Composants Talend Open Studio

187

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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

Objectif Basic settings

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.

Composants Talend Open Studio

189

Composants Business Intelligence


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.

Fonction Objectif Basic settings

190

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

191

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

193

Composants Business Intelligence


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.

Fonction Objectif Basic settings

194

Composants Talend Open Studio

Composants Business Intelligence


tPaloCubeList

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 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

Composants Talend Open Studio

195

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

197

Composants Business Intelligence


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.

Fonction Objectif Basic settings

198

Composants Talend Open Studio

Composants Business Intelligence


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.

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 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 :

Composants Talend Open Studio

199

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Composants Talend Open Studio

201

Composants Business Intelligence


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

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 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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

203

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Fonction Objectif Basic settings

Composants Talend Open Studio

205

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

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 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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

209

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

211

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


tPaloDimension

Composants Talend Open Studio

213

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

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 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

Le schma de sortie est fixe et en lecture seule.

Composants Talend Open Studio

215

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

217

Composants Business Intelligence


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.

Fonction Objectif Basic settings

218

Composants Talend Open Studio

Composants Business Intelligence


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.

Advanced settings Utilisation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant requiert un composant de sortie.

Composants Talend Open Studio

219

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

221

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

223

Composants Business Intelligence


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.

Fonction Objectif Basic settings

224

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

225

Composants Business Intelligence


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.

Fonction Objectif Basic settings

226

Composants Talend Open Studio

Composants Business Intelligence


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

Advanced settings Utilisation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant requiert un composant de dbut.

Composants Talend Open Studio

227

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.
Composants Talend Open Studio 229

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

231

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

233

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Fonction Objectif Basic settings

Composants Talend Open Studio

235

Composants Business Intelligence


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.

Advanced settings Utilisation Connections

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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

237

Composants Business Intelligence


tPaloRule

238

Composants Talend Open Studio

Composants Business Intelligence


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.

Fonction Objectif Basic settings

Composants Talend Open Studio

239

Composants Business Intelligence


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.

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 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

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 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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

241

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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

Composants Talend Open Studio

243

Composants Business Intelligence


tParAccelSCD

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

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.

244

Composants Talend Open Studio

Composants Business Intelligence


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

Composants Talend Open Studio

245

Composants Business Intelligence


tPostgresPlusSCD

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, 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

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.

246

Composants Talend Open Studio

Composants Business Intelligence


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

Composants Talend Open Studio

247

Composants Business Intelligence


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

Schema et Edit schema

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.

248

Composants Talend Open Studio

Composants Business Intelligence


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.

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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168.

Composants Talend Open Studio

249

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


tPostgresqlSCD

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, 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.

Composants Talend Open Studio

251

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


tPostgresqlSCDELT

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

Schema et Edit schema

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.

Composants Talend Open Studio

253

Composants Business Intelligence


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.

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 le Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168.

254

Composants Talend Open Studio

Composants Business Intelligence


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

Fonction Objectif Basic settings

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

Advanced settings Utilisation

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.

Composants Talend Open Studio

255

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

257

Composants Business Intelligence


tSPSSInput

258

Composants Talend Open Studio

Composants Business Intelligence


tSPSSOutput

tSPSSOutput
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 tSPSSOutput
Famille du composant Business Intelligence

Fonction Objectif Basic settings

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.

Advanced settings Utilisation

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.

Composants Talend Open Studio

259

Composants Business Intelligence


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

Composants Talend Open Studio

Composants Business Intelligence


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.

Composants Talend Open Studio

261

Composants Business Intelligence


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
Famille du composant Business Intelligence

Fonction Objectif Basic settings

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.

Advanced settings Utilisation

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 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

Composants Talend Open Studio

Composants Business Intelligence


tSPSSStructure

tSPSSStructure
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 tSPSSStructure
Famille du composant Business Intelligence

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

Advanced settings Utilisation

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 associ
Pour des scnarios associs, consultez : Scnario : Afficher le contenu dun fichier SPSS, page 255

Composants Talend Open Studio

263

Composants Business Intelligence


tSPSSStructure

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

264

Composants Talend Open Studio

Composants Business Intelligence


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

Composants Talend Open Studio

265

Composants Business Intelligence


tSybaseSCD

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

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

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.

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.

266

Composants Talend Open Studio

Composants Business Intelligence


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

Composants Talend Open Studio

267

Composants Business Intelligence


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

Schema et Edit schema

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 Key

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.

268

Composants Talend Open Studio

Composants Business Intelligence


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

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 le composant tMysqlSCD, page 164 et son Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3, page 168.

Composants Talend Open Studio

269

Composants Business Intelligence


tSybaseSCDELT

270

Composants Talend Open Studio

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.

Composants Custom Code


tGroovy

tGroovy
Proprits du tGroovy
Famille de composant Custom Code

Fonction Objectif Basic settings

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.

Advanced settings Utilisation Limitation

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

Composants Talend Open Studio

Composants Custom Code


tGroovyFile

tGroovyFile
Proprits du tGroovyFile
Famille de composant Custom Code

Fonction Objectif Basic settings

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.

Advanced settings Utilisation Limitation

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.

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.

Composants Talend Open Studio

273

Composants Custom Code


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

Composants Talend Open Studio

Composants Custom Code


tJava

tJava
Proprits du tJava
Famille de composant Custom Code

Fonction Objectif Basic settings

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.

Composants Talend Open Studio

275

Composants Custom Code


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

Composants Talend Open Studio

Composants Custom Code


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.

Composants Talend Open Studio

277

Composants Custom Code


tJava

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

278

Composants Talend Open Studio

Composants Custom Code


tJavaFlex

tJavaFlex
Proprits du tJavaFlex
Famille de composant Custom Code

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.

Objectif Basic settings

Start code Main code End code Advanced settings Import

tStatCatcher Statistics

Composants Talend Open Studio

279

Composants Custom Code


tJavaFlex

Utilisation Limitation

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

Composants Talend Open Studio

Composants Custom Code


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.

Composants Talend Open Studio

281

Composants Custom Code


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

Composants Talend Open Studio

Composants Custom Code


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;

Composants Talend Open Studio

283

Composants Custom Code


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

Composants Talend Open Studio

Composants Custom Code


tJavaFlex

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

Composants Talend Open Studio

285

Composants Custom Code


tJavaRow

tJavaRow

Proprits du tJavaRow
Famille de composant Custom Code

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.

Objectif Basic settings

Advanced settings

Import

tStatCatcher Statistics Utilisation Limitation

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
Aucun scnario nest disponible pour ce composant.

286

Composants Talend Open Studio

Composants Custom Code


tLibraryLoad

tLibraryLoad

Proprits du tLibraryLoad
Famille de composant Custom Code

Fonction Objectif Basic settings

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

tStatCatcher Statistics Utilisation Limitation

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.
Composants Talend Open Studio 287

Composants Custom Code


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

Composants Talend Open Studio

Composants Custom Code


tLibraryLoad

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

Composants Talend Open Studio

289

Composants Custom Code


tSetGlobalVar

tSetGlobalVar
Proprits du tSetGlobalVar
Famille de composant Custom Code

Fonction Objectif Basic settings

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

tStatCatcher Statistics

Utilisation Limitation

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

Composants Talend Open Studio

Composants Custom Code


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.

Composants Talend Open Studio

291

Composants Custom Code


tSetGlobalVar

292

Composants Talend Open Studio

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.

Composants Data Quality


tAddCRCRow

tAddCRCRow
Proprits du tAddCRCRow
Famille de composant Data Quality

Fonction Objectif Basic settings

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

Utilisation Limitation

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

Composants Talend Open Studio

Composants Data Quality


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.
Composants Talend Open Studio 295

Composants Data Quality


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

Composants Talend Open Studio

Composants Data Quality


tChangeFileEncoding

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

Composants Talend Open Studio

297

Composants Data Quality


tExtractRegexFields

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

298

Composants Talend Open Studio

Composants Data Quality


tFuzzyMatch

tFuzzyMatch
Proprits du tFuzzyMatch
Famille de composant Data Quality

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

Composants Talend Open Studio

299

Composants Data Quality


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

Composants Talend Open Studio

Composants Data Quality


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.

Composants Talend Open Studio

301

Composants Data Quality


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

Composants Talend Open Studio

Composants Data Quality


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.

Composants Talend Open Studio

303

Composants Data Quality


tFuzzyMatch

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

304

Composants Talend Open Studio

Composants Data Quality


tIntervalMatch

tIntervalMatch
Proprits du tIntervalMatch
Famille de composant Data Quality

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.

Objectif Basic settings

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.

Utilisation Limitation

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..
Composants Talend Open Studio 305

Composants Data Quality


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

Composants Talend Open Studio

Composants Data Quality


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.

Composants Talend Open Studio

307

Composants Data Quality


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

Composants Talend Open Studio

Composants Data Quality


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).

Composants Talend Open Studio

309

Composants Data Quality


tParseAddress

tParseAddress
Proprits du tParseAddress
Famille de composant Data Quality

Fonction Objectif Basic settings

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

Ce composant est une tape intermdiaire. Cela requiert un flux entrant et une sortie. n/a

310

Composants Talend Open Studio

Composants Data Quality


tParseAddress

Scnario associ
Aucun scnario nest disponible pour ce composant.

Composants Talend Open Studio

311

Composants Data Quality


tParseName

tParseName
Proprits du tParseName
Famille de composant Data Quality

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

Composants Talend Open Studio

Composants Data Quality


tParseName

tStatCatcher Statistics Utilisation Limitation

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 une tape intermdiaire. Cela requiert un flux entrant et une sortie. n/a

Scnario associ
Aucun scnario nest disponible pour ce composant.

Composants Talend Open Studio

313

Composants Data Quality


tReplaceList

tReplaceList
Proprits du tReplaceList
Famille de composant Data Quality

Fonction Objectif Basic settings

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

Composants Talend Open Studio

Composants Data Quality


tReplaceList

Advanced settings

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

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.

Composants Talend Open Studio

315

Composants Data Quality


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

Composants Talend Open Studio

Composants Data Quality


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.

Composants Talend Open Studio

317

Composants Data Quality


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

Composants Talend Open Studio

Composants Data Quality


tSchemaComplianceCheck

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.

Objectif Basic settings

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.

Composants Talend Open Studio

319

Composants Data Quality


tSchemaComplianceCheck

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

tStatCatcher Statistics

320

Composants Talend Open Studio

Composants Data Quality


tSchemaComplianceCheck

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.

Composants Talend Open Studio

321

Composants Data Quality


tSchemaComplianceCheck

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

Composants Talend Open Studio

Composants Data Quality


tSchemaComplianceCheck

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.

Composants Talend Open Studio

323

Composants Data Quality


tSchemaComplianceCheck

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

Composants Talend Open Studio

Composants Data Quality


tUniqRow

tUniqRow
Proprits du tUniqRow
Famille de composant Data Quality

Fonction Objectif Basic settings

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

Composants Talend Open Studio

325

Composants Data Quality


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

Composants Talend Open Studio

Composants Data Quality


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.

Composants Talend Open Studio

327

Composants Data Quality


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 Talend Open Studio

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.

Composants Databases
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

Composants Talend Open Studio

Composants Databases
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

Schema et Edit Schema

Advanced settings

Additional JDBC parameters

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.

Composants Talend Open Studio

331

Composants Databases
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

Composants Talend Open Studio

Composants Databases
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

Advanced settings Utilisation Limitation

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

Composants Talend Open Studio

333

Composants Databases
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.
Famille de composant Databases/Access

Fonction Objectif Basic settings

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

Additional JDBC parameters

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

Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

335

Composants Databases
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

Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

337

Composants Databases
tAccessConnection

La table parent Table1 est utilise la fois pour gnrer la table Name et la table Birthday.

338

Composants Talend Open Studio

Composants Databases
tAccessInput

tAccessInput
Proprits du tAccessInput
Famille de composant Databases/Access

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

Composants Talend Open Studio

339

Composants Databases
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

Additional JDBC parameters

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

340

Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

341

Composants Databases
tAccessOutput

tAccessOutput
Proprits du tAccessOutput
Famille de composant Databases/Access

Fonction Objectif Basic settings

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

Composants Talend Open Studio

Composants Databases
tAccessOutput

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 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.

Composants Talend Open Studio

343

Composants Databases
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).

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 (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

Composants Talend Open Studio

Composants Databases
tAccessOutput

Advanced settings

Additional JDBC parameters

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.

Composants Talend Open Studio

345

Composants Databases
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

Composants Talend Open Studio

Composants Databases
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.
Famille de composant Databases/Access

Fonction Objectif Basic settings

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.

Composants Talend Open Studio

347

Composants Databases
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

Composants Talend Open Studio

Composants Databases
tAccessOutputBulkExec

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.
Famille de composant Databases/Access

Fonction Objectif Basic settings

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.

Composants Talend Open Studio

349

Composants Databases
tAccessOutputBulkExec

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

Schema et Edit schema

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

Composants Talend Open Studio

Composants Databases
tAccessOutputBulkExec

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 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.

Composants Talend Open Studio

351

Composants Databases
tAccessRollback

tAccessRollback
Proprits du tAccessRollback
Ce composant est troitement li aux composants tAccessConnection et tAccessCommit. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Access

Fonction Objectif Basic settings

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

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 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

Composants Talend Open Studio

Composants Databases
tAccessRow

tAccessRow
Proprits du tAccessRow
Famille de composant Databases/Access

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

Composants Talend Open Studio

353

Composants Databases
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

Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

355

Composants Databases
tAS400Close

tAS400Close
Proprits du tAS400Close
Famille de composant Databases/AS400

Fonction Objectif Basic settings

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.

Advanced settings Utilisation Limitation

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

Composants Talend Open Studio

Composants Databases
tAS400Commit

tAS400Commit
Proprits du tAS400Commit
Ce composant est troitement li aux composants tAS400Connection et tAS400Rollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/AS400

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

Advanced settings Utilisation Limitation

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

Composants Talend Open Studio

357

Composants Databases
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.
Famille de composant Databases/AS400

Fonction Objectif Basic settings

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

Additional JDBC parameters

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

Composants Talend Open Studio

Composants Databases
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

Composants Talend Open Studio

359

Composants Databases
tAS400Input

tAS400Input
Proprits du tAS400Input
Famille de composant Databases/AS400

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

Composants Talend Open Studio

Composants Databases
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

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 offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL.

Composants Talend Open Studio

361

Composants Databases
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

Composants Talend Open Studio

Composants Databases
tAS400LastInsertId

tAS400LastInsertId
Proprits du tAS400LastInsertId
Famille de composant Databases/AS400

Fonction Objectif Basic settings

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.

Advanced settings Utilisation Limitation

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.

Composants Talend Open Studio

363

Composants Databases
tAS400Output

tAS400Output
Proprits du tAS400Output
Famille de composant Databases/DB2

Fonction Objectif Basic settings

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

Composants Talend Open Studio

Composants Databases
tAS400Output

Use an existing connection

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.

Composants Talend Open Studio

365

Composants Databases
tAS400Output

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 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

Composants Talend Open Studio

Composants Databases
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.

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. 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.

Composants Talend Open Studio

367

Composants Databases
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

Composants Talend Open Studio

Composants Databases
tAS400Rollback

tAS400Rollback
Proprits du tAS400Rollback
Ce composant est troitement li aux composants tAS400Commit et tAS400Connection. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/AS400

Fonction Objectif Basic settings

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

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 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.

Composants Talend Open Studio

369

Composants Databases
tAS400Row

tAS400Row
Proprits du tAS400Row
Famille de composant Databases/AS400

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

Composants Talend Open Studio

Composants Databases
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.

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. 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

Additional JDBC Parameters

Propagate QUERYs recordset

Composants Talend Open Studio

371

Composants Databases
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

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 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

Composants Talend Open Studio

Composants Databases
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

Fonction Objectif Basic settings

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

Composants Talend Open Studio

373

Composants Databases
tCreateTable

MSSQLServer, MySQL, Oracle, PostgresPlus, Postgresql, Teradata

Use an existing connection

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

Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

375

Composants Databases
tCreateTable

AS400/ MSSQL Server

Additional JDBC Parameters

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

Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

377

Composants Databases
DB2BulkExec

DB2BulkExec
Proprits du tDB2BulkExec
Famille de composant Databases/DB2

Fonction Objectif Basic settings

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

Composants Talend Open Studio

Composants Databases
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.

Schema et Edit Schema

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

Composants Talend Open Studio

379

Composants Databases
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

Composants Talend Open Studio

Composants Databases
tDB2Close

tDB2Close
Proprits du tDB2Close
Famille de composant Databases/DB2

Fonction Objectif Basic settings

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.

Advanced settings Utilisation Limitation

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 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

Composants Talend Open Studio

381

Composants Databases
tDB2Commit

tDB2Commit
Proprits du tDB2Commit
Ce composant est troitement li aux composants tDB2Connection et tDB2Rollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/DB2

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

Advanced settings Utilisation Limitation

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

Composants Talend Open Studio

Composants Databases
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.
Famille de composant Databases/DB2

Fonction Objectif Basic settings

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

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Composants Talend Open Studio

383

Composants Databases
tDB2Connection

Utilisation Limitation

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

Composants Talend Open Studio

Composants Databases
tDB2Input

tDB2Input
Proprits du tDB2Input
Famille de composant Databases/DB2

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

Composants Talend Open Studio

385

Composants Databases
tDB2Input

Use an existing connection

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

Composants Talend Open Studio

Composants Databases
tDB2Input

Advanced settings

Trim all the String/Char columns Trim column

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
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.

Composants Talend Open Studio

387

Composants Databases
tDB2Output

tDB2Output
Proprits du tDB2Output
Famille de composant Databases/DB2

Fonction Objectif Basic settings

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

Composants Talend Open Studio

Composants Databases
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

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.

Composants Talend Open Studio

389

Composants Databases
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

Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

391

Composants Databases
tDB2Rollback

tDB2Rollback
Proprits du tDB2Rollback
Ce composant est troitement li aux composants tDB2Commit et tDB2Connection. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/DB2

Fonction Objectif Basic settings

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

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 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

Composants Talend Open Studio

Composants Databases
tDB2Row

tDB2Row
Proprits du tDB2Row
Famille de composant Databases/DB2

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

Composants Talend Open Studio

393

Composants Databases
tDB2Row

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.

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. 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

Composants Talend Open Studio

Composants Databases
tDB2Row

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.

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 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.

Composants Talend Open Studio

395

Composants Databases
tDB2SCD

tDB2SCD
Le composant tDB2SCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tDB2SCD, page 139.

396

Composants Talend Open Studio

Composants Databases
tDB2SCDELT

tDB2SCDELT
Le composant tDB2SCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez tDB2SCDELT, page 141.

Composants Talend Open Studio

397

Composants Databases
tDB2SP

tDB2SP
Proprits du tDB2SP
Famille de composant Databases/DB2

Fonction Objectif Basic settings

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

Composants Talend Open Studio

Composants Databases
tDB2SP

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 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

Advanced settings Utilisation Limitation

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.
Composants Talend Open Studio 399

Composants Databases
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

Composants Talend Open Studio

Composants Databases
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

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 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 :

Composants Talend Open Studio

401

Composants Databases
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

Composants Talend Open Studio

Composants Databases
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.
Composants Talend Open Studio 403

Composants Databases
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

Composants Talend Open Studio

Composants Databases
tDBOutput

tDBOutput
Proprits du tDBOutput
Famille de composant Databases

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

Composants Talend Open Studio

405

Composants Databases
tDBOutput

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).

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.

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 > Rejects.

406

Composants Talend Open Studio

Composants Databases
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

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 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.

Composants Talend Open Studio

407

Composants Databases
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

Composants Talend Open Studio

Composants Databases
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

Composants Talend Open Studio

409

Composants Databases
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

Username et Password Schema et Edit Schema

410

Composants Talend Open Studio

Composants Databases
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

Propagate QUERYs recordset Use PreparedStatement

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.

Composants Talend Open Studio

411

Composants Databases
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.
412 Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

413

Composants Databases
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

Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

415

Composants Databases
tEXAOutput

tEXAOutput
Proprits du tEXAOutput
Famille de composant Databases/EXA

Fonction Objectif Basic settings

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

Composants Talend Open Studio

Composants Databases
tEXAOutput

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 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

Composants Talend Open Studio

417

Composants Databases
tEXAOutput

Additional JDBC parameters

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

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 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 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

Composants Talend Open Studio

Composants Databases
tEXARow

tEXARow
Proprits du tEXARow
Famille de composant Databases/EXA

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

Composants Talend Open Studio

419

Composants Databases
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

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 composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678 du composant tMySQLRow.

420

Composants Talend Open Studio

Composants Databases
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

Fonction Objectif Basic settings

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.

Composants Talend Open Studio

421

Composants Databases
tEXistConnection

Pour un scnario associ au tEXistConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630, du composant tMysqlConnection.

422

Composants Talend Open Studio

Composants Databases
tEXistDelete

tEXistDelete
Proprits du tEXistDelete
Famille de composant Databases/eXist

Fonction Objectif Basic settings

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

Composants Talend Open Studio

423

Composants Databases
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.

Advanced settings Utilisation

tStatCatcher Statistics

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
Aucun scnario nest disponible pour ce composant.

424

Composants Talend Open Studio

Composants Databases
tEXistGet

tEXistGet
Proprits du tEXistGet
Famille de composant Databases/eXist

Fonction Objectif Basic settings

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.

Composants Talend Open Studio

425

Composants Databases
tEXistGet

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.

Advanced settings Utilisation

tStatCatcher Statistics

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 : 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

Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

427

Composants Databases
tEXistGet

Le fichier XML dictionary_en.xml est rcupr et tlcharg dans le rpertoire local dfini pralablement.

428

Composants Talend Open Studio

Composants Databases
tEXistList

tEXistList
Proprits du tEXistList
Famille de composant Databases/eXist

Fonction Objectif Basic settings

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

Composants Talend Open Studio

429

Composants Databases
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

Advanced settings Utilisation

tStatCatcher Statistics

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

Composants Talend Open Studio

Composants Databases
tEXistPut

tEXistPut
Proprits du tEXistPut
Famille de composant Databases/eXist

Fonction Objectif Basic settings

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

Composants Talend Open Studio

431

Composants Databases
tEXistPut

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.

Advanced settings Utilisation

tStatCatcher Statistics

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
Aucun scnario nest disponible pour ce composant.

432

Composants Talend Open Studio

Composants Databases
tEXistXQuery

tEXistXQuery
Proprits du tEXistXQuery
Famille de composant Databases/eXist

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

Username et Password

Composants Talend Open Studio

433

Composants Databases
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.

Advanced settings Utilisation

tStatCatcher Statistics

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
Aucun scnario nest disponible pour ce composant.

434

Composants Talend Open Studio

Composants Databases
tEXistXUpdate

tEXistXUpdate
Proprits du tEXistXUpdate
Famille de composant Databases/eXist

Fonction Objectif Basic settings

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

Username et Password

Composants Talend Open Studio

435

Composants Databases
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.

Advanced settings Utilisation

tStatCatcher Statistics

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
Aucun scnario nest disponible pour ce composant.

436

Composants Talend Open Studio

Composants Databases
tFirebirdClose

tFirebirdClose
Proprits du tFirebirdClose
Famille de composant Databases/Firebird

Fonction Objectif Basic settings

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.

Advanced settings Utilisation Limitation

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 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

Composants Talend Open Studio

437

Composants Databases
tFirebirdCommit

tFirebirdCommit
Proprits du tFirebirdCommit
Ce composant est troitement li aux composants tFirebirdConnection et tFirebirdRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Firebird

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

Advanced settings Utilisation Limitation

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

Composants Talend Open Studio

Composants Databases
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.
Famille de composant Databases/Firebird

Fonction Objectif Basic settings

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

Composants Talend Open Studio

439

Composants Databases
tFirebirdConnection

Scnario associ
Pour un scnario associ au composant tFirebirdConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.

440

Composants Talend Open Studio

Composants Databases
tFirebirdInput

tFirebirdInput
Proprits du tFirebirdInput
Famille de composant Databases/Firebird

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

Trim all the String/Char columns Trim column

Composants Talend Open Studio

441

Composants Databases
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

Composants Talend Open Studio

Composants Databases
tFirebirdOutput

tFirebirdOutput
Proprits du tFirebirdOutput
Famille de composant Databases/Firebird

Fonction Objectif Basic settings

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.

Composants Talend Open Studio

443

Composants Databases
tFirebirdOutput

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 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.

444

Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

445

Composants Databases
tFirebirdOutput

le Scnario 1 : Ajouter une colonne et modifier les donnes, page 651 du composant tMysqlOutput.

446

Composants Talend Open Studio

Composants Databases
tFirebirdRollback

tFirebirdRollback
Proprits du tFirebirdRollback
Ce composant est troitement li aux composants tFirebirdCommit et tFirebirdConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Firebird

Fonction Objectif Basic settings

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

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 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.

Composants Talend Open Studio

447

Composants Databases
tFirebirdRow

tFirebirdRow
Proprits du tFirebirdRow
Famille de composant Databases/Firebird

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

Composants Talend Open Studio

Composants Databases
tFirebirdRow

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

Composants Talend Open Studio

449

Composants Databases
tFirebirdRow

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 composant tDBSQLRow. le Scnario 1 : Supprimer et re-gnrer un index de table MySQL, page 678 du composant tMySQLRow.

450

Composants Talend Open Studio

Composants Databases
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

Composants Talend Open Studio

451

Composants Databases
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.

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

452

Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

453

Composants Databases
tGreenplumClose

tGreenplumClose
Proprits du tGreenplumClose
Famille de composant Databases/Greenplum

Fonction Objectif Basic settings

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.

Advanced settings Utilisation Limitation

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 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

Composants Talend Open Studio

Composants Databases
tGreenplumCommit

tGreenplumCommit

Proprits du tGreenplumCommit
Ce composant est troitement li aux composants tGreenplumConnection et tGreenplumRollback. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Greenplum

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

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 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.

Composants Talend Open Studio

455

Composants Databases
tGreenplumConnection

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.
Famille de composant Databases/Greenplum

Fonction Objectif Basic settings

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

Composants Talend Open Studio

Composants Databases
tGreenplumConnection

Scnarios associs
Pour un scnario associ au composant tGreenplumConnection, consultez le Scnario : Insrer des donnes dans des tables mre/fille, page 630.

Composants Talend Open Studio

457

Composants Databases
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

Composants Talend Open Studio

Composants Databases
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

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 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.

Composants Talend Open Studio

459

Composants Databases
tGreenplumOutput

tGreenplumOutput

Proprits du tGreenplumOutput
Famille de composant Databases/Greenplum

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

Composants Talend Open Studio

Composants Databases
tGreenplumOutput

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 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.

Composants Talend Open Studio

461

Composants Databases
tGreenplumOutput

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 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.

462

Composants Talend Open Studio

Composants Databases
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.

Composants Talend Open Studio

463

Composants Databases
tGreenplumOutputBulk

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.
Famille de composant Databases/Greenplum

Fonction Objectif Basic settings

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

Composants Talend Open Studio

Composants Databases
tGreenplumOutputBulk

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 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.

Composants Talend Open Studio

465

Composants Databases
tGreenplumOutputBulkExec

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.
Famille de composant Databases/Greenplum

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

Composants Talend Open Studio

Composants Databases
tGreenplumOutputBulkExec

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. 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.

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 tGreenplumOutputBulkExec, consultez : le Scnario : Insrer des donnes transformes dans une base MySQL, page 666 du composant tMysqlOutputBulk.

Composants Talend Open Studio

467

Composants Databases
tGreenplumOutputBulkExec

le Scnario : Insrer des donnes dans une base MySQL, page 672 du tMysqlOutputBulkExec.

468

Composants Talend Open Studio

Composants Databases
tGreenplumRollback

tGreenplumRollback
Proprits du tGreenplumRollback
Ce composant est troitement li aux composants tGreenplumCommit et tGreenplumConnection. Ils sont gnralement utiliss ensemble lors de transactions.
Famille de composant Databases/Greenplum

Fonction Objectif Basic settings

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

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 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.

Composants Talend