Sunteți pe pagina 1din 1748

Talend Open Studio

Guide de rfrence des Composants

5.0_a

Talend Open Studio

Talend Open Studio : Guide de rfrence des Composants


Convient pour lutilisation de Talend Open Studio v5.0.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/

Table des matires


Prface .......................................... xxv
Informations gnrales ................ xxv Objectif .............................. xxv Public vis .......................... xxv Conventions typographiques ......................................... xxv Historique des versions ............... xxvi Remarques et Support ............... xxvi

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


tAlfrescoOutput ............................. 2 Proprits du tAlfrescoOutput ............................................. 2 Scnario : Crer des documents sur un serveur Alfresco ............................................. 7 tBonitaDeploy .............................. 12 Proprits du tBonitaDeploy ........................................... 12 Scnario associ .................... 13 tBonitaInstantiateProcess .............. 14 tBonitaInstantiateProcess Properties ............................. 14 Scnario : Excuter un processus Bonita via un Job Talend .................................... 15 tCentricCRMInput ....................... 20 Proprits du tCentricCRMInput ............................ 20 Scnario associ .................... 20 tCentricCRMOutput .................... 21 Proprits du tCentricCRMOutput .............................. 21 Scnario associ .................... 21 tHL7Input ................................... 22 Proprits du tHL7Input .......... 22 Scnario : Retrouver des informations concernant les patients et les vnements partir dun fichier HL7 ................ 23 tHL7Output ................................ 26 Proprits du tHL7Output ........ 26 Scnario associ .................... 26 tMarketoInput ............................. 27 Proprits du tMarketoInput ........................................... 27 Scnario associ .................... 29 tMarketoListOperation ................. 30 Proprits du tMarketoOutput ........................................... 30 Scnario : Ajouter un enregistrement de prospects dans une liste de la base de donnes Marketo ............................... 31 tMarketoOutput .......................... 35

Proprits du tMarketoOutput ........................................... 35 Scnario : Insrer et rcuprer des donnes dune base de donnes Marketo via un systme externe ......................... 37 tMicrosoftCRMInput ................... 41 Proprits du tMicrosoftCRMInput ............................ 41 Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques ........................................... 42 tMicrosoftCRMOutput ................. 49 Proprits du tMicrosoftCRMOutput .............................. 49 Scnario associ .................... 50 tMSAXInput ............................... 51 Proprits du tMSAXInput ....... 51 Scnario associ .................... 51 tMSAXOutput ............................. 52 Proprits du tMSAXOutput ........................................... 52 Scnario : Insrer des donnes dans une table dfinie sur le serveur Microsoft AX..... 54 Scnario 2 : Effacer des donnes dune table prcise sur le serveur MicrosoftAX. ............. 56 tOpenbravoERPInput ................... 59 Proprits du tOpenbravoERPInput .......................... 59 Scnario associ .................... 60 tOpenbravoERPOutput ................ 61 Proprits du tOpenbravoERPOutput ............................... 61 Scnario associ .................... 61 tSageX3Input .............................. 62 Proprits du tSageX3Input ...... 62 Scnario : Utiliser les cls des requtes pour extraire des donnes dun systme Sage X3 donn ............................. 63 tSageX3Output ............................ 67 Proprits du tSageX3Output ........................................... 67 Scnario : Utiliser un service Web Sage X3 pour insrer des donnes dans un systme Sage X3 donn ...................... 68 tSalesforceBulkExec ..................... 72 Proprits du tSalesforceBulkExec .................................. 72 Scnario associ .................... 73 tSalesforceConnection ................... 74

Guide de Rfrence des Composants Talend Open Studio

Talend Open Studio

Proprits du tSalesforceConnection ................................ 74 Scnario associ .................... 74 tSalesforceGetDeleted ................... 75 Proprits du tSalesforceGetDeleted ................................ 75 Scnario : Rcuprer les donnes supprimes du serveur Salesforce ............................ 76 tSalesforceGetServerTimestamp . 79 Proprits du tSalesforceGetServerTimestamp .............. 79 Scnario associ .................... 80 tSalesforceGetUpdated ................. 81 Proprits du tSalesforceGetUpdated .............................. 81 Scnario associ .................... 82 tSalesforceInput ........................... 83 Proprits du tSalesforceInput ...................................... 83 Scnario : Utiliser des requtes pour extraire des donnes dune base de donnes Salesforce ............................ 85 tSalesforceOutput ........................ 89 Proprits du tSalesforceOutput ...................................... 89 Scnario : Supprimer des donnes de lobjet Account ...... 91 tSalesforceOutputBulk .................. 93 Proprits du tSalesforceOutputBulk ............................... 93 Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com ........ 93 tSalesforceOutputBulkExec ........... 98 Proprits du tSalesforceOutputBulkExec ......................... 98 Scnario : Insrer des donnes de masse dans votre Salesforce.com ...................... 99 tSAPCommit ............................. 103 Proprits du tSAPCommit ..... 103 Scnario associ .................. 103 tSAPConnection ......................... 104 Proprits du tSAPConnection ................................... 104 Scnario associ .................. 104 tSAPInput ................................. 105 Proprits du tSAPInput ........ 105 Scnario 1 : Rcuprer les mtadonnes dun systme SAP .................................. 107 Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE ........... 113

tSAPOutput ............................... 119 Proprits du tSAPOutput ...... 119 Scnarios associs ................ 120 tSAPRollback ............................ 121 Proprits du tSAPRollback ... 121 Scnario associ .................. 121 tSugarCRMInput ....................... 122 Proprits du tSugarCRMInput .................................... 122 Scnario: Extraire les donnes dun compte partir de SugarCRM ......................... 122 tSugarCRMOutput ..................... 125 Proprits du tSugarCRMOutput ............................ 125 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 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 tJasperOutput ............................ 150 Proprits du tJasperOutput .... 150 Scnario : Gnrer un rapport avec un modle .jrxml ........... 151 tJasperOutputExec ..................... 153 Proprits du tJasperOutputExec ................................. 153 Scnario associ .................. 153

iv

Guide de Rfrence des Composants Talend Open Studio

Talend Open Studio

tLineChart ................................ 154 Proprits du tLineChart ........ 154 Scnario : Crer un graphique en lignes afin de faciliter lanalyse des tendances ......... 155 tMondrianInput ......................... 161 Proprits du tMondrianInput ......................................... 161 Scnario : Tables en jointure croise ............................... 162 tMSSqlSCD ............................... 165 Proprits du tMSSqlSCD ...... 165 Scnario associ .................. 166 tMysqlSCD ................................ 167 Proprits du tMysqlSCD ....... 167 Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 ........................... 171 tMysqlSCDELT ......................... 178 Proprits du tMysqlSCDELT ................................ 178 Scnario associ .................. 180 tOracleSCD ............................... 181 Proprits du tOracleSCD ...... 181 Scnario associ .................. 182 tOracleSCDELT ......................... 183 Proprits du tOracleSCDELT ................................ 183 Scnario associ .................. 185 tPaloCheckElements ................... 186 Proprits du tPaloCheckElements ................................ 186 Scnario associ .................. 188 tPaloConnection ......................... 189 Proprits du tPaloConnection ................................... 189 Scnario associ .................. 189 tPaloCube ................................. 190 Proprits du tPaloCube ........ 190 Scnario : Crer un cube dans une base de donnes existante ......................................... 192 tPaloCubeList ............................ 194 Proprits du tPaloCubeList ... 194 Dcouvrir le schma de sortie en lecture seule du tPaloCubeList ................................ 195 Scnario : Rcuprer des informations dtailles dun cube dune base de donnes dtermine .......................... 196 tPaloDatabase ............................ 198 Proprits du tPaloDatabase ... 198 Scnario : Crer une base de donnes .............................. 199 tPaloDatabaseList ....................... 201

Proprits du tPaloDatabaseList ................................... 201 Dcouvrir le schma de sortie en lecture seule du tPaloDatabaseList ............................. 202 Scnario : Rcuprer des informations dtailles concernant les bases de donnes dun serveur Palo donn ........ 203 tPaloDimension .......................... 205 Proprits du tPaloDimension ......................................... 205 Scnario : Crer une dimension avec des lments .......... 209 tPaloDimensionList ..................... 214 Proprits du tPaloDimensionList .............................. 214 Dcouvrir le schma de sortie en lecture seule du tPaloDimensionList ..................... 216 Scnario: Rcuprer des informations dtailles concernant les dimensions dune base de donnes dtermine.... 216 tPaloInputMulti ......................... 218 Proprits du tPaloInputMulti ......................................... 218 Scnario : Rcuprer des lments de dimensions dans un cube donn ......................... 220 tPaloOutput ............................... 223 Proprits du tPaloOutput ...... 223 Scnario associ .................. 224 tPaloOutputMulti ....................... 225 Proprits du tPaloOutputMulti ................................. 225 Scnario 1 : Ecrire des donnes dans un cube donn ........ 227 Scnario 2 : Refuser un flux de donnes dentre lorsque les lments crire nexistent pas dans un cube donn ................................ 229 tPaloRule .................................. 233 Proprits du tPaloRule ......... 233 Scnario : Crer une rgle dans un cube donn .............. 234 tPaloRuleList ............................. 237 Proprits du tPaloRuleList .... 237 Dcouvrir le schma de sortie en lecture seule du tPaloRuleList ................................... 238 Scnario : Rcuprer des informations dtailles concernant des rgles dun cube donn ................................ 239 tParAccelSCD ............................ 241

Guide de Rfrence des Composants Talend Open Studio

Talend Open Studio

Proprits du tParAccelSCD ......................................... 241 Scnario associ .................. 242 tPostgresPlusSCD ....................... 243 Proprits du tPostgresPlusSCD ............................ 243 Scnario associ .................. 244 tPostgresPlusSCDELT ................ 245 Proprits du tPostgresPlusSCDELT ...................... 245 Scnario associ .................. 247 tPostgresqlSCD .......................... 248 Proprits du tPostgresqlSCD ......................................... 248 Scnario associ .................. 249 tPostgresqlSCDELT ................... 250 Proprits du tPostgresqlSCDELT ................................ 250 Scnario associ .................. 252 tSPSSInput ................................ 253 Proprits du tSPSSInput ....... 253 Scnario : Afficher le contenu dun fichier SPSS ................. 253 tSPSSOutput ............................. 256 Proprits du tSPSSOutput ..... 256 Scnario : Ecrire des donnes dans un fichier .sav ............... 256 tSPSSProperties ......................... 259 Proprits du tSPSSProperties .................................... 259 Scnario associ .................. 259 tSPSSStructure .......................... 260 Proprits du tSPSSStructure ......................................... 260 Scnario associ .................. 260 tSybaseSCD ............................... 261 Proprits du tSybaseSCD ...... 261 Scnario associ .................. 262 tSybaseSCDELT ........................ 263 Proprits du tSybaseSCDELT ................................ 263 Scnario associ .................. 265

Composants Cloud ....................... 267


tAmazonMysqlClose ................... Proprits du tAmazonMysqlClose .............................. Scnario associ .................. tAmazonMysqlCommit ............... Proprits du tAmazonMysqlCommit ........................... Scnario associ .................. tAmazonMysqlConnection ........... Proprits du tAmazonMysqlConnection ....................... Scnario associ .................. tAmazonMysqlInput ................... 268 268 268 269 269 269 270 270 270 271

Proprits du tAmazonMysqlInput ............................... Scnarios associs ................ tAmazonMysqlOutput ................. Proprits du tAmazonMysqlOutput .............................. Scnarios associs ................ tAmazonMysqlRollback .............. Proprits du tAmazonMysqlRollback .......................... Scnario associ .................. tAmazonMysqlRow .................... Proprits du tAmazonMysqlRow ................................ Scnarios associs ................ tAmazonOracleClose .................. Proprits du tAmazonOracleClose ............................. Scnario associ .................. tAmazonOracleCommit ............... Proprits du tAmazonOracleCommit .......................... Scnario associ .................. tAmazonOracleConnection .......... Proprits du tAmazonOracleConnection ..................... Scnario associ .................. tAmazonOracleInput .................. Proprits du tAmazonOracleInput .............................. Scnarios associs ................ tAmazonOracleOutput ................ Proprits du tAmazonOracleOutput ........................... Scnarios associs ................ tAmazonOracleRollback ............. Proprits du tAmazonOracleRollback ......................... Scnario associ .................. tAmazonOracleRow .................... Proprits du tAmazonOracleRow .............................. Scnarios associs ................ tMarketoInput ........................... tMarketoListOperation ............... tMarketoOutput ......................... tSalesforceBulkExec ................... tSalesforceConnection ................. tSalesforceGetDeleted ................. tSalesforceGetServerTimestamp . 302 tSalesforceGetUpdated ................ tSalesforceInput ......................... tSalesforceOutput ....................... tSalesforceOutputBulk ................ tSalesforceOutputBulkExec ......... tSugarCRMInput ....................... tSugarCRMOutput .....................

271 272 273 273 277 278 278 278 279 279 281 282 282 282 283 283 283 284 284 285 286 286 287 288 288 291 292 292 292 293 293 295 296 297 298 299 300 301

303 304 305 306 307 308 309

vi

Guide de Rfrence des Composants Talend Open Studio

Talend Open Studio

Composants Custom Code .......... 311


tGroovy ..................................... 312 Proprits du tGroovy ........... 312 Scnarios associs ................ 312 tGroovyFile ............................... 313 Proprits du tGroovyFile ...... 313 Scnario : Appeler du code Groovy contenu dans un fichier .................................. 313 tJava ......................................... 315 Proprits du tJava ............... 315 Scnario : Imprimer le contenu dune variable ................. 315 tJavaFlex ................................... 318 Proprits du tJavaFlex ......... 318 Scnario 1 : Gnrer un flux de donnes ......................... 319 Scnario 2 : Traiter des lignes de donnes avec le tJavaFlex ......................................... 321 tJavaRow .................................. 324 Proprits du tJavaRow ......... 324 Scnario associ .................. 324 tLibraryLoad ............................. 325 Proprits du tLibraryLoad ..... 325 Scnario : Vrifier le format dune adresse e-mail ............. 325 tSetGlobalVar ............................ 327 Proprits du tSetGlobalVar ......................................... 327 Scnario : Afficher le contenu dune variable globale ........... 327

Scnario : Remplacement partir dun fichier de rfrence ................................. tSchemaComplianceCheck ........... Proprits du tSchemaComplianceCheck ...................... Scnario : Valider les dates en fonction dun schma ........ tUniqRow .................................. Proprits du tUniqRow ........ Scnario : Ddoublonner des donnes ..............................

344 347 347 348 353 353 354

Composants Databases ................ 357


tAccessBulkExec ........................ 358 Proprits du tAccessBulkExec ................................ 358 Scnarios associs ................ 360 tAccessCommit .......................... 361 Proprits du tAccessCommit ......................................... 361 Scnario associ .................. 361 tAccessConnection ...................... 362 Proprits du tAccessConnection ................................... 362 Scnario: Insrer des donnes dans des tables parent/enfant ......................................... 362 tAccessInput .............................. 366 Proprits du tAccessInput ..... 366 Scnarios associs ................ 367 tAccessOutput ............................ 368 Proprits du tAccessOutput ......................................... 368 Scnarios associs ................ 371 tAccessOutputBulk ..................... 372 Proprits du tAccessOutputBulk .................................. 372 Scnarios associs ................ 373 tAccessOutputBulkExec .............. 374 Proprits du tAccessOutputBulkExec ........................... 374 Scnarios associs ................ 376 tAccessRollback ......................... 377 Proprits du tAccessRollback .................................. 377 Scnario associ .................. 377 tAccessRow ............................... 378 Proprits du tAccessRow ...... 378 Scnarios associs ................ 380 tAS400Close .............................. 381 Proprits du tAS400Close ..... 381 Scnario associ .................. 381 tAS400Commit ........................... 382 Proprits du tAS400Commit ......................................... 382 Scnario associ .................. 382 tAS400Connection ...................... 383

Composants Data Quality ........... 329


tAddCRCRow ............................ 330 Proprits du tAddCRCRow ......................................... 330 Scnario : Ajouter une cl de substitution un fichier ......... 330 tChangeFileEncoding .................. 333 tExtractRegexFields .................... 334 tFuzzyMatch .............................. 335 Proprits du tFuzzyMatch ..... 335 Scnario 1 : Distance de Levenshtein de 0 pour les prnoms ................................. 336 Scnario 2 : Distance de Levenshtein de 1 ou 2 pour les prnoms ............................. 338 Scnario 3 : Distance mtaphonique pour les prnoms ..... 339 tIntervalMatch ........................... 340 Proprits du tIntervalMatch ......................................... 340 Scnario : Identifier le pays partir de lIP ....................... 340 tReplaceList ............................... 343 Proprits du tReplaceList ...... 343

Guide de Rfrence des Composants Talend Open Studio

vii

Talend Open Studio

Proprits du tAS400Connection ............... 383 Scnario associ .................. 384 tAS400Input .............................. 385 Proprits du tAS400Input ..... 385 Scnarios associs ................ 386 tAS400LastInsertId .................... 387 Proprits du tAS400LastInsertId .............. 387 Scnario associ .................. 387 tAS400Output ............................ 388 Proprits du tAS400Output ......................................... 388 Scnarios associs ................ 391 tAS400Rollback ......................... 392 Proprits du tAS400Rollback .................. 392 Scnario associ .................. 392 tAS400Row ................................ 393 Proprits du tAS400Row ...... 393 Scnarios associs ................ 395 tCreateTable .............................. 396 Proprits du tCreateTable ..... 396 Scnario : Crer une nouvelle table dans une base de donnes MySQL ....................... 399 tDB2BulkExec ........................... 401 Proprits du tDB2BulkExec ......................................... 401 Scnario associ .................. 403 tDB2Close ................................. 404 Proprits du tDB2Close ........ 404 Scnario associ .................. 404 tDB2Commit ............................. 405 Proprits du tDB2Commit .... 405 Scnario associ .................. 405 tDB2Connection ......................... 406 Proprits du tDB2Connection .................. 406 Scnarios associs ................ 407 tDB2Input ................................. 408 Proprits du tDB2Input ........ 408 Scnarios associs ................ 409 tDB2Output ............................... 410 Proprits du tDB2Output ...... 410 Scnarios associs ................ 413 tDB2Rollback ............................ 414 Proprits du tDB2Rollback ......................................... 414 Scnario associ .................. 414 tDB2Row ................................... 415 Proprits du tDB2Row ......... 415 Scnarios associs ................ 417 tDB2SCD .................................. 418 tDB2SCDELT ............................ 419 tDB2SP ..................................... 420 Proprits du tDB2SP ........... 420 Scnario associ .................. 421

tDBInput ................................... 422 Proprits du tDBInput .......... 422 Scnario 1 : Afficher les donnes slectionnes partir dune table ......................... 423 Scnario 2 : Utiliser la variable StoreSQLQuery ........... 424 tDBOutput ................................ 426 Proprits du tDBOutput ........ 426 Scnario : Afficher la base de donnes en sortie ................. 428 tDBSQLRow .............................. 430 Proprits du tDBSQLRow .... 430 Scnario : Rinitialiser lauto-incrmentation dune base de donnes ................... 431 tEXAInput ................................ 433 Proprits du tEXAInput ........ 433 Scnarios associs ................ 434 tEXAOutput .............................. 435 Proprits du tEXAOutput ..... 435 Scnarios associs ................ 437 tEXARow .................................. 438 Proprits du tEXARow ........ 438 Scnarios associs ................ 439 tEXistConnection ....................... 440 Proprits du tEXistConnection ................................... 440 Scnario associ .................. 440 tEXistDelete ............................... 441 Proprits du tEXistDelete ..... 441 Scnario associ .................. 442 tEXistGet .................................. 443 Proprits du tEXistGet ......... 443 Scnario : Rcuprer des ressources partir dun serveur distant de base de donnes eXist ................................. 444 tEXistList .................................. 447 Proprits du tEXistList ......... 447 Scnario associ .................. 448 tEXistPut .................................. 449 Proprits du tEXistPut ......... 449 Scnario associ .................. 450 tEXistXQuery ............................ 451 Proprits du tEXistXQuery ......................................... 451 Scnario associ .................. 452 tEXistXUpdate ........................... 453 Proprits du tEXistXUpdate ......................................... 453 Scnario associ .................. 454 tFirebirdClose ............................ 455 Proprits du tFirebirdClose ......................................... 455 Scnario associ .................. 455 tFirebirdCommit ........................ 456

viii

Guide de Rfrence des Composants Talend Open Studio

Talend Open Studio

Proprits du tFirebirdCommit .................................... 456 Scnario associ .................. 456 tFirebirdConnection ................... 457 Proprits du tFirebirdConnection ............................... 457 Scnario associ .................. 458 tFirebirdInput ........................... 459 Proprits du tFirebirdInput .... 459 Scnarios associs ................ 460 tFirebirdOutput ......................... 461 Proprits du tFirebirdOutput ......................................... 461 Scnarios associs ................ 463 tFirebirdRollback ....................... 464 Proprits du tFirebirdRollback .................................. 464 Scnario associ .................. 464 tFirebirdRow ............................. 465 Proprits du tFirebirdRow ..... 465 Scnarios associs ................ 467 tGreenplumBulkExec .................. 468 Proprits du tGreenplumBulkExec ........................... 468 Scnarios associs ................ 470 tGreenplumClose ....................... 471 Proprits du tGreenplumClose ................................. 471 Scnario associ .................. 471 tGreenplumCommit .................... 472 Proprits du tGreenplumCommit .............................. 472 Scnario associ .................. 472 tGreenplumConnection ............... 473 Proprits du tGreenplumConnection ......................... 473 Scnarios associs ................ 474 tGreenplumInput ....................... 475 Proprits du tGreenplumInput .................................... 475 Scnarios associs ................ 476 tGreenplumGPLoad ................... 477 Proprits du tGreenplumGPLoad ................................ 477 Scnario associ .................. 481 tGreenplumOutput ..................... 482 Proprits du tGreenplumOutput ............................. 482 Scnarios associs ................ 484 tGreenplumOutputBulk .............. 486 Proprits du tGreenplumOutputBulk ...................... 486 Scnarios associs ................ 487 tGreenplumOutputBulkExec ........ 488 Proprits du tGreenplumOutputBulkExec ................ 488 Scnarios associs ................ 489 tGreenplumRollback ................... 490

Proprits du tGreenplumRollback ............................ Scnario associ .................. tGreenplumRow ......................... Proprits du tGreenplumRow .................................. Scnarios associs ................ tGreenplumSCD ......................... tHiveClose ................................. Proprits du tHiveClose ....... Scnario associ .................. tHiveConnection ......................... Proprits du tHiveConnection ................................... Scnarios associs ................ tHiveRow .................................. Proprits du tHiveRow ......... Scnarios associs ................ tHSQLDbInput .......................... Proprits du tHSQLDbInput ......................................... Scnarios associs ................ tHSQLDbOutput ........................ Proprits du tHSQLDbOutput .................................... Scnarios associs ................ tHSQLDbRow ........................... Proprits du tHSQLDbRow ......................................... Scnarios associs ................ tInformixBulkExec ..................... Proprits du tInformixBulkExec ................................ Scnario associ .................. tInformixClose ........................... Proprits du tInformixClose ......................................... Scnario associ .................. tInformixCommit ....................... Proprits du tInformixCommit .................................... Scnario associ .................. tInformixConnection ................... Proprits du tInformixConnection ............................... Scnarios associs ................ tInformixInput ........................... Proprits du tInformixInput ......................................... Scnarios associs ................ tInformixOutput ........................ Proprits du tInformixOutput .................................... Scnarios associs ................ tInformixOutputBulk .................. Proprits du tInformixOutputBulk .............................. Scnarios associs ................

490 490 491 491 493 494 495 495 495 496 496 496 497 497 498 499 499 501 502 502 505 507 507 509 510 510 512 513 513 513 514 514 514 515 515 516 517 517 518 519 519 521 523 523 524

Guide de Rfrence des Composants Talend Open Studio

ix

Talend Open Studio

tInformixOutputBulkExec ........... 525 Proprits du tInformixOutputBulkExec ....................... 525 Scnarios associs ................ 527 tInformixRollback ...................... 528 Proprits du tInformixRollback .................................. 528 Scnario associ .................. 528 tInformixRow ............................ 529 Proprits du tInformixRow ... 529 Scnarios associs ................ 531 tInformixSCD ............................ 532 tInformixSP ............................... 533 Proprits du tInformixSP ...... 533 Scnarios associs ................ 535 tIngresClose ............................... 536 Proprits du tIngresClose ...... 536 Scnario associ .................. 536 tIngresCommit ........................... 537 Proprits du tIngresCommit ......................................... 537 Scnario associ .................. 537 tIngresConnection ...................... 538 Proprits du tIngresConnection ................................... 538 Scnario associ .................. 538 tIngresInput .............................. 539 Proprits du tIngresInput ...... 539 Scnarios associs ................ 540 tIngresOutput ............................ 541 Proprits du tIngresOutput .... 541 Scnarios associs ................ 543 tIngresRollback .......................... 544 Proprits du tIngresRollback ......................................... 544 Scnario associ .................. 544 tIngresRow ................................ 545 Proprits du tIngresRow ....... 545 Scnarios associs ................ 546 tIngresSCD ................................ 547 tInterbaseClose .......................... 548 Proprits du tInterbaseClose ......................................... 548 Scnario associ .................. 548 tInterbaseCommit ...................... 549 Proprits du tInterbaseCommit .................................... 549 Scnario associ .................. 549 tInterbaseConnection .................. 550 Proprits du tInterbaseConnection ............................... 550 Scnarios associs ................ 550 tInterbaseInput .......................... 551 Proprits du tInterbaseInput ......................................... 551 Scnarios associs ................ 552 tInterbaseOutput ........................ 553

Proprits du tInterbaseOutput .................................... 553 Scnarios associs ................ 555 tInterbaseRollback ..................... 556 Proprits du tInterbaseRollback .................................. 556 Scnario associ .................. 556 tInterbaseRow ........................... 557 Proprits du tInterbaseRow ......................................... 557 Scnarios associs ................ 559 tJavaDBInput ............................ 560 Proprits du tJavaDBInput .... 560 Scnarios associs ................ 561 tJavaDBOutput .......................... 562 Proprits du tJavaDBOutput ......................................... 562 Scnarios associs ................ 564 tJavaDBRow .............................. 565 Proprits du tJavaDBRow ..... 565 Scnarios associs ................ 566 tJDBCColumnList ...................... 567 Proprits du tJDBCColumnList ................................... 567 Scnario associ .................. 567 tJDBCClose ............................... 568 Proprits du tJDBCClose ...... 568 Scnario associ .................. 568 tJDBCCommit ........................... 569 Proprits du tJDBCCommit ......................................... 569 Scnario associ .................. 569 tJDBCConnection ....................... 570 Proprits du tJDBCConnection ................................... 570 Scnario associ .................. 571 tJDBCInput ............................... 572 Proprits du tJDBCInput ...... 572 Scnarios associs ................ 573 tJDBCOutput ............................ 575 Proprits du tJDBCOutput .... 575 Scnarios associs ................ 577 tJDBCRollback .......................... 579 Proprits du tJDBCRollback ......................................... 579 Scnario associ .................. 579 tJDBCRow ................................ 580 Proprits du tJDBCRow ....... 580 Scnarios associs ................ 582 tJDBCSP ................................... 583 Proprits du tJDBCSP ......... 583 Scnarios associs ................ 584 tJDBCTableList ......................... 585 Proprits du tJDBCTableList ................................... 585 Scnario associ .................. 585 tLDAPAttributesInput ................ 586

Guide de Rfrence des Composants Talend Open Studio

Talend Open Studio

Proprits du tLDAPAttributesInput .............................. 586 Scnario associ .................. 588 tLDAPConnection ...................... 589 Proprits du tLDAPConnection ................................... 589 Scnario associ .................. 590 tLDAPInput .............................. 591 Proprits du tLDAPInput ...... 591 Scnario : Afficher le contenu filtr dun annuaire LDAP ...... 593 tLDAPOutput ............................ 595 Proprits du tLDAPOutput .... 595 Scnario : Editer des donnes dans un annuaire LDAP ......... 597 tLDAPRenameEntry ................... 600 Proprits du tLDAPRenameEntry ............................. 600 Scnarios associs ................ 601 tMaxDBInput ............................ 602 Proprits du tMaxDBInput .... 602 Scnarios associs ................ 603 tMaxDBOutput .......................... 604 Proprits du tMaxDBOutput ......................................... 604 Scnarios associs ................ 606 tMaxDBRow .............................. 607 Proprits du tMaxDBRow ..... 607 Scnarios associs ................ 608 tMSSqlBulkExec ........................ 609 Proprits du tMSSqlBulkExec ................................ 609 Scnarios associs ................ 611 tMSSqlClose .............................. 612 Proprits du tMSSqlClose ..... 612 Scnario associ .................. 612 tMSSqlColumnList ..................... 613 Proprits du tMSSqlColumnList ............................ 613 Scnario associ .................. 613 tMSSqlCommit .......................... 614 Proprits du tMSSqlCommit ......................................... 614 Scnario associ .................. 614 tMSSqlConnection ...................... 615 Proprits du tMSSqlConnection ................................... 615 Scnario associ .................. 616 tMSSqlInput .............................. 617 Proprits du tMSSqlInput ..... 617 Scnarios associs ................ 618 tMSSqlLastInsertId .................... 619 Proprits du tMSSqlLastInsertId ................................. 619 Scnario associ .................. 619 tMSSqlOutput ........................... 620 Proprits du tMSSqlOutput ......................................... 620

Scnarios associs ................ 624 tMSSqlOutputBulk ..................... 625 Proprits du tMSSqlOutputBulk .................................. 625 Scnarios associs ................ 626 tMSSqlOutputBulkExec .............. 627 Proprits du tMSSqlOutputBulkExec ........................... 627 Scnarios associs ................ 629 tMSSqlRollback ......................... 630 Proprits du tMSSqlRollback .................................. 630 Scnario associ ................... 630 tMSSqlRow ............................... 631 Proprits du tMSSqlRow ...... 631 Scnarios associs ................ 633 tMSSqlSCD ............................... 634 tMSSqlSP .................................. 635 Proprits du tMSSqlSP ........ 635 Scnarios associs ................ 636 tMSSqlTableList ........................ 638 Proprits du tMSSqlTableList ................................... 638 Scnario associ .................. 638 tMysqlBulkExec ......................... 639 Proprits du tMysqlBulkExec ................................ 639 Scnarios associs ................ 641 tMysqlClose ............................... 642 Proprits du tMysqlClose ..... 642 Scnario associ .................. 642 tMysqlColumnList ...................... 643 Proprits du tMysqlColumnList ................................... 643 Scnario : Itrer une table de base de donnes et lister le nom des colonnes de la table ......................................... 643 tMysqlCommit ........................... 646 Proprits du tMysqlCommit ......................................... 646 Scnario associ .................. 646 tMysqlConnection ...................... 647 Proprits du tMysqlConnection ................................... 647 Scnario : Insrer des donnes dans des tables mre/ fille ................................... 647 tMysqlInput ............................... 651 Proprits du tMysqlInput ...... 651 Scnario : Ecrire des colonnes dune base de donnes MySQL dans un fichier de sortie ................................. 652 tMysqlLastInsertId ..................... 656 Proprits du tMysqlLastInsertId ................................. 656

Guide de Rfrence des Composants Talend Open Studio

xi

Talend Open Studio

Scnario : Rcuprer les ID des dernires entres ajoutes ......................................... 656 tMysqlOutput ............................ 661 Proprits du tMysqlOutput .... 661 Scnario 1 : Ajouter une colonne et modifier les donnes ......................................... 665 Scnario 2 : Effectuer des mises jour dans une base de donnes .............................. 669 Scnario 3 : Rcuprer les donnes errones laide dun lien Reject ................... 672 tMysqlOutputBulk ..................... 677 Proprits du tMysqlOutputBulk .................................. 677 Scnario : Insrer des donnes transformes dans une base MySQL ....................... 678 tMysqlOutputBulkExec ............... 681 Proprits du tMysqlOutputBulkExec ........................... 681 Scnario : Insrer des donnes dans une base MySQL.... 683 tMysqlRollback .......................... 685 Proprits du tMysqlRollback ......................................... 685 Scnario : Annuler linsertion de donnes dans des tables mre/fille ............................ 685 tMysqlRow ................................ 686 Proprits du tMysqlRow ....... 686 Scnario 1 : Supprimer et regnrer un index de table MySQL .............................. 688 Scnario 2 : Utiliser linstance PreparedStatement pour faire une requte sur des donnes .............................. 689 tMysqlSCD ................................ 694 tMysqlSCDELT ......................... 695 tMysqlSP ................................... 696 Proprits du tMysqlSP ......... 696 Scnario : Trouver le libell State laide dune procdure stocke .............................. 697 tMysqlTableList ......................... 701 Proprits du tMysqlTableList ................................... 701 Scnario : Effectuer une opration ditration sur des tables et en effacer le contenu grce un modle SQL dfini par lutilisateur (SQL Template) ................................. 701 Scnario associ .................. 705 tNetezzaBulkExec ....................... 706

Proprits du tNetezzaBulkExec ................................ 706 Scnarios associs ................ 707 tNetezzaClose ............................. 709 Proprits du tNetezzaClose ......................................... 709 Scnario associ .................. 709 tNetezzaCommit ......................... 710 Proprits du tNetezzaCommit .................................... 710 Scnario associ .................. 710 tNetezzaConnection .................... 711 Proprits du tNetezzaConnection ............................... 711 Scnario associ .................. 711 tNetezzaInput ............................ 712 Proprits du tNetezzaInput .... 712 Scnarios associs ................ 713 tNetezzaNzLoad ......................... 714 Proprits du tNetezzaNzLoad .................................. 714 Scnario associ .................. 719 tNetezzaOutput .......................... 720 Proprits du tNetezzaOutput ......................................... 720 Scnarios associs ................ 723 tNetezzaRollback ........................ 724 Proprits du tNetezzaRollback .................................. 724 Scnario associ .................. 724 tNetezzaRow .............................. 725 Proprits du tNetezzaRow ..... 725 Scnario associ .................. 727 tOracleBulkExec ........................ 728 Proprits du tOracleBulkExec ................................ 728 Scnario : Supprimer et insrer des donnes dans une base Oracle ................................ 731 tOracleClose .............................. 734 Proprits du tOracleClose ..... 734 Scnario associ .................. 734 tOracleCommit .......................... 735 Proprits du tOracleCommit ......................................... 735 Scnario associ .................. 735 tOracleConnection ...................... 736 Proprits du tOracleConnection ................................... 736 Scnario associ .................. 737 tOracleInput .............................. 738 Proprits du tOracleInput ...... 738 Scnarios associs ................ 740 tOracleOutput ........................... 741 Proprits du tOracleOutput ... 741 Scnarios associs ................ 744 tOracleOutputBulk ..................... 746

xii

Guide de Rfrence des Composants Talend Open Studio

Talend Open Studio

Proprits du tOracleOutputBulk .................................. Scnarios associs ................ tOracleOutputBulkExec .............. Proprits du tOracleOutputBulkExec ........................... Scnarios associs ................ tOracleRollback ......................... Proprits du tOracleRollback .................................. Scnario associ .................. tOracleRow ............................... Proprits du tOracleRow ...... Scnario associ .................. tOracleSCD ............................... tOracleSCDELT ......................... tOracleSP .................................. Proprits du tOracleSP ......... Scnario : Vrifier le format de numros laide dune procdure stocke ................ tOracleTableList ........................ Proprits du tOracleTableList ................................... Scnario associ .................. tParAccelBulkExec ..................... Proprits du tParAccelBulkExec ................................ Scnarios associs ................ tParAccelClose ........................... Proprits du tParAccelClose ......................................... Scnario associ .................. tParAccelCommit ....................... Proprits du tParAccelCommit .................................... Scnario associ .................. tParAccelConnection .................. Proprits du tParAccelConnection ............................... Scnario associ .................. tParAccelInput ........................... Proprits du tParAccelInput ......................................... Scnarios associs ................ tParAccelOutput ........................ Proprits du tParAccelOutput .................................... Scnarios associs ................ tParAccelOutputBulk ................. Proprits du tParAccelOutputBulk .............................. Scnarios associs ................ tParAccelOutputBulkExec ........... Proprits du tParAccelOutputBulkExec ....................... Scnarios associs ................ tParAccelRollback ......................

746 747 748 748 751 753 753 753 754 754 756 757 758 759 759

762 766 766 766 767 767 769 770 770 770 771 771 771 772 772 773 774 774 775 776 776 778 780 780 781 782 782 783 785

Proprits du tParAccelRollback .................................. Scnario associ .................. tParAccelRow ............................ Proprits du tParAccelRow ......................................... Scnarios associs ................ tParAccelSCD ............................ tParseRecordSet ......................... Proprits du tParseRecordSet .............................. Scnario associ .................. tPostgresPlusBulkExec ................ Proprits du tPostgresPlusBulkExec ........................... Scnario associ .................. tPostgresPlusClose ...................... Proprits du tPostgresPlusClose ................................. Scnario associ .................. tPostgresPlusCommit .................. Proprits du tPostgresPlusCommit .............................. Scnario associ .................. tPostgresPlusConnection ............. Proprits du tPostgresPlusConnection ......................... Scnario associ .................. tPostgresPlusInput ..................... Proprits du tPostgresPlusInput ............................ Scnarios associs ................ tPostgresPlusOutput ................... Proprits du tPostgresPlusOutput .............................. Scnarios associs ................ tPostgresPlusOutputBulk ............ Proprits du tPostgresPlusOutputBulk ........................ Scnarios associs ................ tPostgresPlusOutputBulkExec ...... Proprits du tPostgresplusOutputBulkExec ................. Scnarios associs ................ tPostgresPlusRollback ................. Proprits du tPostgresPlusRollback ............................ Scnario associ .................. tPostgresPlusRow ....................... Proprits du tPostgresPlusRow .................................. Scnarios associs ................ tPostgresPlusSCD ....................... tPostgresPlusSCDELT ................ tPostgresqlBulkExec ................... Proprits du tPostgresqlBulkExec ................................ Scnarios associs ................

785 785 786 786 788 789 790 790 790 791 791 792 794 794 794 795 795 795 796 796 797 798 798 799 800 800 803 804 804 805 806 806 807 808 808 808 809 809 811 812 813 814 814 816

Guide de Rfrence des Composants Talend Open Studio

xiii

Talend Open Studio

tPostgresqlClose ......................... 817 Proprits du tPostgresqlClose ................................. 817 Scnario associ .................. 817 tPostgresqlCommit ..................... 818 Proprits du tPostgresqlCommit .............................. 818 Scnario associ .................. 818 tPostgresqlConnection ................. 819 Proprits du tPostgresqlConnection ............................... 819 Scnario associ .................. 820 tPostgresqlInput ......................... 821 Proprits du tPostgresqlInput .................................... 821 Scnarios associs ................ 822 tPostgresqlOutput ...................... 823 Proprits du tPostgresqlOutput .................................... 823 Scnarios associs ................ 826 tPostgresqlOutputBulk ................ 827 Proprits du tPostgresqlOutputBulk .............................. 827 Scnarios associs ............... 828 tPostgresqlOutputBulkExec ......... 829 Proprits du tPostgresqlOutputBulkExec ....................... 829 Scnarios associs ................ 830 tPostgresqlRollback .................... 832 Proprits du tPostgresqlRollback .................................. 832 Scnario associ .................. 832 tPostgresqlRow .......................... 833 Proprits du tPostgresqlRow ......................................... 833 Scnarios associs ................ 835 tPostgresqlSCD .......................... 836 tPostgresqlSCDELT ................... 837 tSASInput ................................. 838 Proprits du tSASInput ........ 838 Scnarios associs ................ 839 tSASOutput ............................... 840 Proprits du tSASOutput ...... 840 Scnarios associs ............... 842 tSQLiteClose ............................. 843 Proprits du tSQLiteClose .... 843 Scnario associ .................. 843 tSQLiteCommit .......................... 844 Proprits du tSQLiteCommit ......................................... 844 Scnario associ .................. 844 tSQLiteConnection ..................... 845 Proprits du tSQLiteConnection ............................... 845 Scnarios associs ................ 845 tSQLiteInput ............................. 846 Proprits du tSQLiteInput ..... 846

Scnario : Filtrer des donnes SQlite ................................ 847 tSQLiteOutput ........................... 850 Proprits du tSQLiteOutput ......................................... 850 Scnario associ .................. 852 tSQLiteRollback ......................... 853 Proprits du tSQLiteRollback .................................. 853 Scnario associ .................. 853 tSQLiteRow ............................... 854 Proprits du tSQLiteRow ...... 854 Scnario : Mettre jour des lignes SQLite ...................... 855 tSybaseBulkExec ........................ 858 Proprits du tSybaseBulkExec ................................ 858 Scnarios associs ................ 860 tSybaseClose .............................. 861 Proprits du tSybaseClose ..... 861 Scnario associ .................. 861 tSybaseCommit .......................... 862 Proprits du tSybaseCommit ......................................... 862 Scnario associ .................. 862 tSybaseConnection ..................... 863 Proprits du tSybaseConnection ................................... 863 Scnarios associs ................ 863 tSybaseInput .............................. 864 Proprits du tSybaseInput ..... 864 Scnario associ .................. 865 tSybaseIQBulkExec .................... 866 Proprits du tSybaseIQBulkExec ................................ 866 Scnario associ .................. 867 tSybaseIQOutputBulkExec .......... 869 Proprits du tSybaseIQOutputBulkExec ....................... 869 Scnarios associs ................ 871 tSybaseOutput ........................... 872 tSybaseOutput Properties ....... 872 Scnario associ .................. 875 tSybaseOutputBulk ..................... 876 Proprits du tSybaseOutputBulk .................................. 876 Scnario associ .................. 877 tSybaseOutputBulkExec .............. 878 Proprits du tSybaseOutputBulkExec ........................... 878 Scnarios associs ................ 880 tSybaseRollback ......................... 881 Proprits du tSybaseRollback .................................. 881 Scnario associ .................. 881 tSybaseRow ............................... 882 Proprits du tSybaseRow ...... 882 Scnario associ .................. 884

xiv

Guide de Rfrence des Composants Talend Open Studio

Talend Open Studio

tSybaseSCD ............................... 885 tSybaseSCDELT ........................ 886 tSybaseSP .................................. 887 Proprits du tSybaseSP ........ 887 Scnario associ .................. 888 tTeradataClose ........................... 890 Proprits du tTeradataClose ......................................... 890 Scnario associ .................. 890 tTeradataCommit ....................... 891 Proprits du tTeradataCommit .................................... 891 Scnario associ .................. 891 tTeradataConnection .................. 892 Proprits du tTeradataConnection ............................... 892 Scnario associ .................. 893 tTeradataFastExport .................. 894 Proprits du tTeradataFastExport .............................. 894 Scnario associ .................. 895 tTeradataFastLoad ..................... 896 Proprits du tTeradataFastLoad .................................. 896 Scnario associ .................. 897 tTeradataFastLoadUtility ............ 898 Proprits du tTeradataFastLoadUtility ......................... 898 Scnario associ .................. 899 tTeradataInput .......................... 900 Proprits du tTeradataInput ......................................... 900 Scnario associ .................. 901 tTeradataMultiLoad ................... 902 Proprits du tTeradataMultiLoad .................................. 902 Scnario associ .................. 903 tTeradataOutput ........................ 904 Proprits du tTeradataOutput .................................... 904 Scnario associ ................. 907 tTeradataRollback ...................... 908 Proprits du tTeradataRollback .................................. 908 Scnario associ .................. 908 tTeradataRow ............................ 909 Proprits du tTeradataRow .... 909 Scnario associ .................. 911 tTeradataTPump ........................ 912 Proprits du tTeradataTPump ................................. 912 Scnario : Insrer des donnes dans une table dune base de donnes Teradata ....... 913 tVectorWiseCommit ................... 917 Proprits du tVectorWiseCommit .............................. 917 Scnario associ .................. 917

tVectorWiseConnection ............... 918 Proprits du tVectorWiseConnection ......................... 918 Scnario associ .................. 919 tVectorWiseInput ....................... 920 Proprits du tVectorWiseInput .................................... 920 Scnario associ .................. 921 tVectorWiseOutput ..................... 922 Proprits du tVectorWiseOutput ............................ 922 Scnario associ .................. 925 tVectorWiseRollback .................. 926 Proprits du tVectorWiseRollback ............................ 926 Scnario associ .................. 926 tVectorWiseRow ........................ 927 Proprits du tVectorWiseRow .................................. 927 Scnario associ .................. 929 tVerticaBulkExec ....................... 930 Proprits du tVerticaBulkExec ................................ 930 Scnarios associs ................ 932 tVerticaClose ............................. 933 Proprits du tVerticaClose .... 933 Scnario associ .................. 933 tVerticaCommit ......................... 934 Proprits du tVerticaCommit ......................................... 934 Scnario associ .................. 934 tVerticaConnection ..................... 935 Proprits du tVerticaConnection ............................... 935 Scnario associ .................. 936 tVerticaInput ............................. 937 Proprits du tVerticaInput ..... 937 Scnarios associs ................ 938 tVerticaOutput ........................... 939 Proprits du tVerticaOutput ......................................... 939 Scnarios associs ................ 943 tVerticaOutputBulk .................... 944 Proprits du tVerticaOutputBulk .................................. 944 Scnarios associs ................ 945 tVerticaOutputBulkExec ............. 946 Proprits du tVerticaOutputBulkExec ........................... 946 Scnarios associs ................ 947 tVerticaRollback ........................ 948 Proprits du tVerticaRollback .................................. 948 Scnario associ .................. 948 tVerticaRow .............................. 949 Proprits du tVerticaRow ..... 949 Scnario associ .................. 951

Guide de Rfrence des Composants Talend Open Studio

xv

Talend Open Studio

Composants ELT ......................... 953


tCombinedSQLAggregate ............ Proprits du tCombinedSQLAggregate ......................... Scnario : Filtrer et agrger des colonnes dune table directement sur le SGBD .......... tCombinedSQLFilter .................. Proprits du tCombinedSQLFilter ............................. Scnario associ .................. tCombinedSQLInput .................. Proprits du tCombinedSQLInput ............................. Scnario associ .................. tCombinedSQLOutput ................ Proprits du tCombinedSQLOutput ............................. Scnario associ .................. tELTJDBCInput ........................ Proprits de tELTJDBCInput .................................... Scnarios associs ................ tELTJDBCMap ......................... Proprits de tELTJDBCMap ......................................... Scnarios associs ................ tELTJDBCOutput ...................... Proprits de tELTJDBCOutput .................................... Scnarios associs ................ tELTMSSqlInput ....................... Proprits de tELTMSSqlInput .................................... Scnarios associs ................ tELTMSSqlMap ......................... Proprits de tELTMSSqlMap .................................. Scnarios associs ................ tELTMSSqlOutput ..................... Proprits de tELTMSSqlOutput .............................. Scnarios associs ................ tELTMysqlInput ........................ Proprits de tELTMysqlInput .................................... Scnarios associs ................ tELTMysqlMap ......................... Proprits de tELTMysqlMap ......................................... Scnario 1 : Agrger les colonnes dune table et appliquer un filtre ....................... Scnario 2 : ELT utilisant une table Alias .......................... tELTMysqlOutput ...................... 954 954

955 960 960 961 962 962 963 964 964 965 966 966 966 968 968 969 970 970 971 972 972 972 974 974 975 976 976 977 978 978 978 980 980

982 986 991

Proprits de tELTMysqlOutput .................................... 991 Scnarios associs ................ 992 tELTOracleInput ....................... 993 Proprits de tELTOracleInput .................................... 993 Scnario associ .................. 993 tELTOracleMap ......................... 994 Proprits de tELTOracleMap .................................. 994 Scnario : Mettre jour les lignes dune base Oracle ........ 996 tELTOracleOutput ..................... 999 Proprits de tELTOracleOutput ........................... 999 Scnario : Utiliser la fonction MERGE dOracle pour mettre jour et insrer simultanment des donnes .......... 1000 tELTPostgresqlInput ................. 1005 Proprits de tELTPostgresqlInput ............................. 1005 Scnarios associs .............. 1005 tELTPostgresqlMap .................. 1007 Proprits de tELTPostgresqlMap .............................. 1007 Scnarios associs .............. 1008 tELTPostgresqlOutput .............. 1009 Proprits de tELTPostgresqlOutput ............................. 1009 Scnarios associs .............. 1010 tELTSybaseInput ..................... 1011 Proprits de tELTSybaseInput .................................. 1011 Scnarios associs .............. 1011 tELTSybaseMap ....................... 1013 Proprits de tELTSybaseMap ................................. 1013 Scnarios associs .............. 1014 tELTSybaseOutput ................... 1015 Proprits de tELTSybaseOutput ........................... 1015 Scnarios associs .............. 1016 tELTTeradataInput .................. 1017 Proprits de tELTTeradataInput ............................. 1017 Scnarios associs .............. 1017 tELTTeradataMap ................... 1019 Proprits de tELTTeradataMap ................................. 1019 Scnarios associs .............. 1021 tELTTeradataOutput ................ 1022 Proprits de tELTTeradataOutput ........................... 1022 Scnarios associs .............. 1023 tSQLTemplateAggregate ........... 1024 Proprits du tSQLTemplateAggregate ....................... 1024

xvi

Guide de Rfrence des Composants Talend Open Studio

Talend Open Studio

Scnario : Filtrer et agrger les colonnes dune table directement dans le SGBD ...... tSQLTemplateCommit .............. Proprits du tSQLTemplateCommit ............................ Scnario associ ................. tSQLTemplateFilterColumns ..... Proprits du tSQLTemplateFilterColumns .................... Scnario associ ................. tSQLTemplateFilterRows .......... Proprits du tSQLTemplateFilterRows ........................ Scnario associ ................. tSQLTemplateMerge ................. Proprits du tSQLTemplateMerge .............................. Scnario : Effectuer des oprations de MERGE directement dans le SGBD ............ tSQLTemplateRollback ............. Proprits du tSQLTemplateRollback ........................... Scnario associ ................. tESBConsumer ......................... Proprits du tESBConsumer ........................................ Scnario : Retourner une adresse e-mail valide ........... tESBProviderFault ................... Proprits du tESBProviderFault ................................ Scnario : Retourner un message Fault ......................... tESBProviderRequest ................ Proprits du tESBProviderRequest ............................ Scnario : Envoi dun message via un service sans attente de rponse ................. tESBProviderResponse .............. Proprits du tESBProviderResponse .......................... Scnario : Retourner une rponse Hello world ........... tRESTRequest .......................... Proprits du tRESTRequest ........................................ Scnario : Envoi d'un message avec une rponse dans un service REST ................ tRESTResponse ........................ Proprits du tRESTResponse ............................... Scnario associ .................

Composants File ......................... 1097


1026 1030 1030 1031 1032 1032 1033 1034 1034 1035 1036 1036 tAdvancedFileOutputXML ........ 1098 tApacheLogInput ...................... 1099 Proprits du tApacheLogInput .................................. 1099 Scnario : Lire un fichier de log daccs Apache ............. 1100 tChangeFileEncoding ................ 1102 tChangeFileEncoding Properties .................................. 1102 Scnario: Transformer lencodage des caractres dun fichier ....................... 1102 tCreateTemporaryFile ............... 1104 Proprits du tCreateTemporaryFile ............................ 1104 Scnario : Crer un fichier temporaire et y crire des donnes ............................ 1105 tFileArchive ............................. 1109 Proprits du tFileArchive .... 1109 Scnario : Zipper des fichiers laide dun tFileArchive ..... 1110 tFileCompare ........................... 1112 Proprits du tFileCompare ... 1112 Scnario : Comparer des fichiers dzipps .................. 1113 tFileCopy ................................. 1115 Proprits du tFileCopy ....... 1115 Scnario : Rcuprer un fichier de la corbeille ............ 1116 tFileDelete ............................... 1118 Proprits du tFileDelete ...... 1118 Scnario : Supprimer des fichiers ............................... 1119 tFileExist ................................. 1121 Proprits du tFileExist ........ 1121 Scnario : Vrifier lexistence dun fichier et le crer sil nexiste pas ....................... 1122 tFileInputARFF ........................ 1126 Proprits du tFileInputARFF ........................................ 1126 Scnario : Afficher le contenu dun fichier ARFF .............. 1127 tFileInputDelimited ................... 1130 Proprits du tFileInputDelimited ............................... 1130 Scnario 1 : Afficher le contenu dun fichier dlimit ........................................ 1132 Scnario 2 : Lire les donnes dun fichier distant en mode stream .............................. 1133 tFileInputEBCDIC .................... 1137 Proprits du tFileInputEBCDIC .......................... 1137

1038 1044 1044 1045 1048 1048 1050 1057 1057 1057 1069 1069

Composants ESB ....................... 1047

1070 1080 1080 1080 1091 1091

1091 1096 1096 1096

Guide de Rfrence des Composants Talend Open Studio

xvii

Talend Open Studio

Scnario : Extraire les donnes dun fichier EBCDIC et alimenter une base de donnes ................................. 1137 tFileInputExcel ......................... 1143 Proprits du tFileInputExcel ........................................ 1143 Scnario associ ................. 1145 tFileInputFullRow .................... 1146 Proprits du tFileInputFullRow ................................ 1146 Scnario : Lire des lignes compltes dans un fichier dlimit ............................... 1147 tFileInputJSON ........................ 1149 Proprits du tFileInputJSON ........................................ 1149 Scnario : Extraire les donnes des champs dun fichier au format JSON ................. 1150 tFileInputLDIF ......................... 1152 Proprits du tFileInputLDIF ........................................ 1152 Scnario associ ................. 1153 tFileInputMail .......................... 1154 Proprits du tFileInputMail ........................................ 1154 Scnario : Extraire des champs cls dun email ........ 1155 tFileInputMSDelimited .............. 1157 Proprits du tFileInputMSDelimited .......................... 1157 Scnario : Lecture dun fichier dlimit multi structure ........................................ 1159 tFileInputMSPositional .............. 1164 Proprits du tFileInputMSPositional .......................... 1164 Scnario associ ................. 1165 tFileInputMSXML .................... 1166 Proprits du tFileInputMSXML ...................... 1166 Scnario : Lecture dun fichier XML multi structur .... 1167 tFileInputPositional ................... 1170 Proprits du tFileInputPositional ............................... 1170 Scnario : Transformer un fichier positionnel en fichier XML ............................... 1172 tFileInputProperties .................. 1177 Proprits du tFileInputProperties .............................. 1177 Scnario : Lire et mapper la cl et les valeurs de fichiers properties et alimenter un glossaire ........................... 1178 tFileInputRegex ........................ 1181

Proprits du tFileInputRegex ........................................ Scnario : Transformer en fichier Regex en Positional ..... tFileInputXML ......................... tFileList ................................... Proprits du tFileList ......... Scnario : Itration sur un rpertoire ............................ tFileOutputARFF ..................... Proprits du tFileOutputARFF .............................. Scnario associ ................. tFileOutputDelimited ................ Proprits du tFileOutputDelimited ............................. Scnario : Ecrire des donnes dans un fichier dlimit ........ Scnario : Utiliser un flux de sortie pour sauvegarder des donnes dans un fichier local ........................................ tFileOutputEBCDIC ................. Proprits du tFileOutputEBCDIC .......................... Scnario : Crer un fichier EBCDIC partir de deux fichiers dlimits .................. tFileOutputExcel ...................... Proprits du tFileOutputExcel ................................... Scnario associ ................. tFileOutputJSON ...................... Propits du tFileOutputJSON ............................... Scnario : Ecrire un fichier JSON structur .................. tFileOutputLDIF ...................... Proprits du tFileOutputLDIF ........................... Scnario : Ecrire des donnes dans un fichier LDIF ........... tFileOutputMSDelimited ........... Proprits du tFileOutputMSDelimited .......................... Scnario associ ................. tFileOutputMSPositional ........... Proprits du tFileOutputMSPositional .......................... Scnario associ ................. tFileOutputMSXML ................. Proprits du tFileOutputMSXML ...................... Scnario associ ................. tFileOutputPositional ................ Proprits du tFileOutputPositional ............................. Scnario associ : ...............

1181 1182 1185 1186 1186 1188 1191 1191 1192 1193 1193 1195

1199 1201 1201

1201 1204 1204 1206 1207 1207 1207 1211 1211 1212 1214 1214 1215 1216 1216 1217 1218 1218 1223 1224 1224 1226

xviii

Guide de Rfrence des Composants Talend Open Studio

Talend Open Studio

tFileOutputProperties ............... 1227 Proprits du tFileOutputProperties .............................. 1227 Scnario associ ................. 1228 tFileOutputXML ...................... 1229 tFileProperties .......................... 1230 Proprits du tFileProperties ........................................ 1230 Scnario : Afficher les proprits dun fichier trait ...... 1231 tFileRowCount ......................... 1233 Proprits du tFileRowCount ........................................ 1233 Scnario associ : ............... 1234 tFileTouch ............................... 1235 Proprits du tFileTouch ...... 1235 Scnario associ : ............... 1235 tFileUnarchive .......................... 1236 Proprits du tFileUnarchive ........................................ 1236 Scnario associ ................. 1237 tGPGDecrypt ........................... 1238 Proprits du tGPGDecrypt ... 1238 Scnario : Dcrypter un fichier crypt GnuPG et afficher son contenu ................ 1238 tNamedPipeClose ...................... 1241 Proprits du tNamedPipeClose ............................... 1241 Scnario associ ................. 1241 tNamedPipeOpen ...................... 1242 Proprits du tNamedPipeOpen .................................. 1242 Scnario associ ................. 1242 tNamedPipeOutput ................... 1243 Proprits du tNamedPipeOutput .......................... 1243 Scnario : Ecrire et charger des donnes via un tube nomm ................................... 1244 tPivotToColumnsDelimited ........ 1249 Proprits du tPivotToColumnsDelimited .................. 1249 Scnario : Utiliser une colonne pivot pour agrger des donnes ............................ 1249

Composants Internet ................. 1253


tFileFetch ................................ Proprits du tFileFetch ....... Scnario 1 : Rcuprer des donnes partir dun protocole HTTP ........................ Scnario 2 : Rutiliser un cookie stock pour rcuprer des fichiers via un protocole HTTP .............................. Scnario associ ................. 1254 1254

1256

1257 1259

tFileInputJSON ........................ 1260 tFTPConnection ....................... 1261 Proprits du tFTPConnection .................................. 1261 Scnarios associs .............. 1262 tFTPDelete ............................... 1263 Proprits du tFTPDelete ..... 1263 Scnarios associs .............. 1264 tFTPFileExist ........................... 1265 Proprits du tFTPFileExist .. 1265 Scnarios associs .............. 1266 tFTPFileList ............................. 1267 Proprits du tFTPFileList .... 1267 Scnario : Itration sur un rpertoire distant ................... 1268 tFTPFileProperties ................... 1271 Proprits du tFTPFileProperties .............................. 1271 Scnario associ ................. 1272 tFTPGet .................................. 1273 Proprits du tFTPGet ......... 1273 Scnario associ ................. 1274 tFTPPut .................................. 1275 Proprits du tFTPPut ......... 1275 Scnario : Copier des fichiers sur un serveur FTP distant .... 1276 tFTPRename ............................ 1279 Proprits du tFTPRename ... 1279 Scnario associ ................. 1280 tFTPTruncate .......................... 1281 Proprits du tFTPTruncate .. 1281 Scnario associ ................. 1282 tHttpRequest ............................ 1283 Proprits du tHttpRequest ... 1283 Scnario : Envoyer une requte HTTP au serveur et sauvegarder localement les rponses HTTP obtenues ...... 1284 tJMSInput ............................... 1286 Proprits du tJMSInput ....... 1286 Scnario associ : ............... 1287 tJMSOutput ............................. 1288 Proprits du tJMSOutput ..... 1288 Scnario associ : ............... 1289 tMicrosoftMQInput .................. 1290 Proprits du tMicrosoftMQInput ............................. 1290 Scnario : Ecrire et rcuprer des messages dans une file dattente de message Microsoft .................................. 1291 tMicrosoftMQOutput ................ 1294 Proprits du tMicrosoftMQOutput ........................... 1294 Scnario associ ................. 1295 tMomCommit ........................... 1296 Proprits du tMomCommit .. 1296 Scnario associ ................. 1296

Guide de Rfrence des Composants Talend Open Studio

xix

Talend Open Studio

tMomInput .............................. 1297 Proprits du tMomInput ...... 1297 Scnario : Communication asynchrone via un serveur MOM .............................. 1300 tMomMessageIdList .................. 1303 Proprits du tMomMessageIdList ............................ 1303 Scnario associ ................. 1303 tMomOutput ............................ 1304 Proprits du tMomOutput ... 1304 Scnario associ ................. 1305 tMomRollback ......................... 1306 Proprits du tMomRollback ........................................ 1306 Scnario associ ................. 1306 tPOP ....................................... 1307 Proprits du tPOP ............. 1307 Scnario : Rcuprer une slection de-mails partir dun compte de messagerie .......... 1309 tREST ..................................... 1311 Proprits du tREST ........... 1311 Scnario : Crer et rcuprer des donnes en invoquant un service Web REST ............. 1312 tRSSInput ................................ 1315 Proprits du tRSSInput ....... 1315 Scnario : Rcuprer les billets frquemment mis jour sur un blog ................. 1315 tRSSOutput ............................. 1318 Proprits du tRSSOutput ..... 1318 Scnario 1 : Crer un flux RSS et stocker les fichiers sur un serveur FTP .................. 1319 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 ............................ 1349 Proprits du tSocketInput .... 1349 Scnario : Transfrer des donnes vers un port dcoute ........................................ 1350 tSocketOutput .......................... 1353 Proprits du tSocketOutput ........................................ 1353 Scnario associ ................. 1354 tSOAP ..................................... 1355 Proprits du tSOAP ........... 1355 Scnario : Extraire des informations mto en utilisant un Service Web ...................... 1356 tWebServiceInput ..................... 1359 Proprits du tWebServiceInput .................................. 1359 Scnario 1 : Extraire des images laide dun Webservice ................................. 1361 Scnario 2 : Lire des donnes publies dans un service Web, en utilisant les fonctions avances du tWebServiceInput ............................. 1362 tXMLRPCInput ....................... 1367 Proprits du tXMLRPCInput ........................................ 1367 Scnario : Chercher le nom dun Etat via une mthode XMLRPC ......................... 1368

Composants Logs & Errors ...... 1371


tAssert ..................................... 1372 Proprits du tAssert ........... 1372

xx

Guide de Rfrence des Composants Talend Open Studio

Talend Open Studio

Scnario : Paramtrer une condition assertive pour lexcution dun Job ............ tAssertCatcher ......................... Proprits du tAssertCatcher ........................................ Scnario associ ................. tChronometerStart ................... Proprits du tChronometerStart .................................. Scnario associ ................. tChronometerStop .................... Proprits du tChronometerStop .................................. Scnario : Mesurer la dure de traitement dun sous-Job ou dune partie dun sous-Job ........................................ tDie ......................................... Proprits du tDie ............... Scnarios associs .............. tFlowMeter .............................. Proprits du tFlowMeter ..... Scnario associ ................. tFlowMeterCatcher ................... Proprits du tFlowMeterCatcher ................................. Scnario : Mesurer le flux dun Job ........................... tLogCatcher ............................. Proprits du tLogCatcher .... Scnario 1 : Avertissement & log lors de la cration dentres ........................... Scnario 2 : Monitorer & arrter un Job ....................... tLogRow .................................. Proprits du tLogRow ........ Scnarios associs .............. tStatCatcher ............................. Proprits du tStatCatcher .... Scnario : Afficher les statistiques du Job ..................... tWarn ..................................... Proprits du tWarn ............ Scnarios associs .............. tAddLocationFromIP ................ Proprits du tAddLocationFromIP ............................. Scnario : Identifier la localisation gographique dune adresse IP ......................... tBufferInput ............................. Proprits du tBufferInput .... Scnario : Rcuprer les donnes mises en tampon ..........

1372 1378 1378 1379 1380 1380 1380 1381 1381

1381 1385 1385 1385 1386 1386 1386 1387 1387 1388 1392 1392

1392 1394 1396 1396 1396 1397 1397 1397 1400 1400 1400 1402 1402

tBufferOutput .......................... 1408 Proprits du tBufferOutput .. 1408 Scnario 1 : Mettre des donnes en tampon .................. 1408 Scnario 2 : Mettre les donnes de sortie en mmoire tampon du serveur dapplication Web .............. 1410 Scnario 3 : Appeler un Job contenant des variables de contexte partir de votre navigateur Web ..................... 1413 Scnario 4 : Appeler un Job export en tant que service Web dans un autre Job ......... 1415 tContextDump .......................... 1418 Proprits du tContextDump ........................................ 1418 Scnario associ ................. 1418 tContextLoad ........................... 1419 Proprits du tContextLoad ... 1419 Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL ..................... 1420 tFixedFlowInput ....................... 1423 Proprits du tFixedFlowInput .................................. 1423 Scnarios associs .............. 1423 tMemorizeRows ........................ 1425 Proprits du tMemorizeRows ............................... 1425 Scnario : Compter le nombre doccurrences de diffrents ges ................................. 1426 tMsgBox .................................. 1431 Proprits du tMsgBox ........ 1431 Scnario : Test de type Hello world! ............................. 1431 tRowGenerator ......................... 1433 Proprits du tRowGenerator ........................................ 1433 Scnario : Gnration alatoire de fichiers de test ......... 1434

Composants Orchestration ....... 1437


tFileList ................................... tFlowToIterate ......................... Proprits du tFlowToIterate ........................................ Scnario : Transformer un flux de donnes en liste ........ tForeach .................................. Proprits du tForeach ......... Scnario : Faire une boucle sur une liste et rcuprer les valeurs ............................. tInfiniteLoop ............................ 1438 1439 1439 1439 1443 1443

Composants Misc ....................... 1401

1403 1405 1405 1405

1443 1446

Guide de Rfrence des Composants Talend Open Studio

xxi

Talend Open Studio

Proprits du tInfiniteLoop ... 1446 Scnario associ ................. 1446 tIterateToFlow ......................... 1447 Proprits du tIterateToFlow ........................................ 1447 Scnario : Transformer une liste de fichiers en flux de donnes ............................ 1448 tLoop ...................................... 1450 Proprits du tLoop ............ 1450 Scnario : Excuter un Job partir dune boucle .............. 1451 tPostjob ................................... 1453 Proprits du tPostjob .......... 1453 Scnario associ ................. 1453 tPrejob .................................... 1454 Proprits du tPrejob ........... 1454 Scnario associ ................. 1454 tReplicate ................................ 1455 Proprits du tReplicate ....... 1455 Scnario associ ................. 1455 tRunJob .................................. 1456 tUnite ...................................... 1457 Proprits du tUnite ............ 1457 Scnario : Itration sur des fichiers et fusion de contenu .... 1458 tSleep ...................................... 1461 Proprits du tSleep ............ 1461 Scnario associ ................. 1461 tWaitForFile ............................ 1462 Proprits du tWaitForFile .... 1462 Scnario : Attendre la suppression dun fichier ........... 1464 tWaitForSocket ........................ 1466 Proprits du tWaitForSocket ........................................ 1466 Scnario associ ................. 1467 tWaitForSqlData ...................... 1468 Proprit du tWaitForSqlData ........................................ 1468 Scnario : Attendre lajout de lignes dans une table ........... 1469

Composants Processing ............. 1473


tAggregateRow ......................... 1474 Proprits du tAggregateRow ........................................ 1474 Scnario : Agrger des valeurs et trier des donnes ...... 1476 tAggregateSortedRow ............... 1479 Proprits du tAggregateSortedRow ............................ 1479 Scnario associ ................. 1480 tConvertType ........................... 1481 Proprits du tConvertType .. 1481 Scnario : Convertir des types de donnes Java ................. 1482 tDenormalize ............................ 1486

Proprits du tDenormalize ... 1486 Scnario 1 : Dnormaliser une colonne ....................... 1486 Scnario 2 : Dnormaliser plusieurs colonnes .............. 1488 tDenormalizeSortedRow ............ 1491 Proprits du tDenormalizeSortedRow ..................... 1491 Scnario : Regrouper des lignes tries ....................... 1491 tExternalSortRow ..................... 1495 Proprits du tExternalSortRow ................................ 1495 Scnario associ ................. 1496 tExtractDelimitedFields ............. 1497 Proprits du tExtractDelimitedFields ........................... 1497 Scnario : Extraire des champs partir dun fichier dlimit par des virgules ...... 1498 tExtractPositionalFields ............. 1501 Proprits du tExtractPositionalFields ........................... 1501 Scnario associ ................. 1502 tExtractRegexFields .................. 1503 Proprits du tExtractRegexFields ............................... 1503 Scnario : Extraire des noms, des domaines et domaines de premier niveau partir dadresses e-mail ................ 1504 tExtractXMLField .................... 1507 tFilterColumns ......................... 1508 Proprits du tFilterColumns ........................................ 1508 Scnario associ ................. 1508 tFilterRow ............................... 1509 Proprits du tFilterRow ...... 1509 Scnario : Filtrer une liste de noms et faire une recherche dans la liste ....................... 1510 tJoin ....................................... 1513 Proprits du tJoin .............. 1513 Scnario : Faire une correspondance exacte entre deux colonnes et crire les donnes rejetes ............................. 1513 tMap ....................................... 1518 Proprits du tMap ............. 1518 Scnario 1 : Mapping simple de donnes avec filtre et jointure explicite ..................... 1518 Scnario 2 : Mapping de donnes avec rejet Inner join ...... 1522 Scnario 3 : Mapping de jointure en cascade .................. 1526

xxii

Guide de Rfrence des Composants Talend Open Studio

Talend Open Studio

Scnario 4 : Mapping avanc avec filtres, jointures explicites et rejet Inner join ......... 1527 Scnario 5 : Mapping avanc avec filtres et diffrents rejets ........................................ 1531 Scnario 6 : Mapping avanc avec rechargement de la base de rfrence chaque ligne ... 1534 Scnario 7 : Mapping avec des tables de sortie .............. 1540 tNormalize ............................... 1545 Proprits du tNormalize ...... 1545 Scnario : Normaliser des donnes ............................ 1545 tReplace .................................. 1548 Proprits du tReplace ......... 1548 Scnario : Remplacement mutliple et filtrage de colonnes .............................. 1549 tSampleRow ............................. 1552 Proprits du tSampleRow .... 1552 Scnario : Filtrer des lignes et des groupes de lignes .......... 1552 tSortRow ................................. 1555 Proprits du tSortRow ........ 1555 Scnario : Trier des donnes ........................................ 1556 tSplitRow ................................. 1558 Proprits du tSplitRow ....... 1558 Scnario 1 : Sparer une ligne en plusieurs lignes .............. 1558 tWriteJsonField ........................ 1562 Proprits du tWriteJsonField ........................................ 1562 Scnario associ ................. 1562 tXMLMap ............................... 1564 Proprits du tXMLMap ...... 1564 Scnario 1 : Mapper et transformer des donnes de source XML ............................... 1565 Scnario 2 : Crer un flux Lookup pour effectuer une jointure sur des donnes complmentaires XML .............. 1570 Scnario 3 : Mapper des donnes laide dun filtre ........ 1574 Scnario 4 : Capturer les donnes rejetes par le flux Lookup et le filtre .................... 1577 Scnario 5 : Mapper des donnes laide dun lment group ............................ 1580 Classer les donnes de sortie avec l'lment "aggregate" .... 1584

Proprits du tRunJob ......... Scnario : Excuter un Job fils .................................. tSetEnv ................................... Proprits du tSetEnv .......... Scnario : Modifier une variable lors de lexcution dun Job .................................. tSSH ....................................... Proprits du tSSH ............. Scnario : Accder aux informations du systme distant via SSH ............................ tSystem ................................... Proprits du tSystem .......... Scnario : Echo Hello World! ............................

1588 1590 1594 1594

1594 1597 1597

1599 1601 1601 1603

Composants Talend MDM ........ 1605


tMDMBulkLoad ....................... 1606 Proprits du tMDMBulkLoad ................................ 1606 Scnario : Charger des enregistrements dans une entit mtier .............................. 1609 tMDMClose ............................. 1614 Proprits du tMDMClose .... 1614 Scnario associ ................. 1614 tMDMConnection ..................... 1615 Proprits du tMDMConnection .................................. 1615 Scnario associ ................. 1615 tMDMDelete ............................ 1616 Proprits du tMDMDelete ... 1616 Scnario : Supprimer des donnes matre d'un hub MDM .............................. 1617 tMDMInput ............................. 1623 Proprits du tMDMInput ..... 1623 Scnario : Lire les donnes matre dun hub MDM ......... 1624 tMDMOutput ........................... 1628 Proprits du tMDMOutput .. 1628 Scnario : Ecrire des donnes matre dans un hub MDM ..... 1631 tMDMReceive .......................... 1637 Proprits du tMDMReceive ........................................ 1637 Scnario associ ................. 1638 tMDMRouteRecord .................. 1639 Proprits du tMDMRouteRecord ............................. 1639 Scnario : Router un enregistrement vers lEvent Manager ........................................ 1640 tMDMSP ................................. 1649 Proprits du tMDMSP ........ 1649

Composants System ................... 1587


tRunJob .................................. 1588

Guide de Rfrence des Composants Talend Open Studio

xxiii

Talend Open Studio

Scnario : Excuter une procdure stocke dans le hub MDM .............................. tMDMTriggerInput .................. Proprits du tMDMTriggerInput ............................ Scnario associ ................. tMDMTriggerOutput ................ Proprits du tMDMTriggerOutput ............................ Scnario associ ................. tMDMViewSearch .................... Proprits du tMDMViewSearch ....................... Scnario : Rcuprer des enregistrements dun hub MDM hub via une vue existante ..... tHashInput .............................. Proprits du tHashInput ...... Scnario : Lire des donnes directement dans la mmoire cache afin d'y accder rapidement ................................ tHashOutput ............................ Proprits du tHashOutput .... Scnario associ .................

1650 1655 1655 1656 1657 1657 1658 1659 1659

1661 1666 1666

Composants Technical ............... 1665

1666 1671 1671 1672

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


tAdvancedFileOutputXML ........ 1674 Proprits du tAdvancedFileOutputXML .................... 1674 Scnario : Crer un fichier XML laide dune boucle ... 1681 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 .... 1694 tFileInputXML ......................... 1698 Proprits du tFileInputXML ........................................ 1698

Scnario 1 : Extraire des adresses XML ................... 1700 Scnario 2 : Extraire les donnes XML errones dans un flux de rejet ...................... 1701 tFileOutputXML ...................... 1705 Proprits de tFileOutputXML ........................... 1705 Scnario associ ................. 1707 tWriteXMLField ....................... 1708 Proprits du tWriteXMLField ................................ 1708 Scnario : Extraire la structure dun fichier XML et linsrer dans les champs dune base de donnes ......... 1709 tXMLMap ............................... 1713 tXSDValidator ......................... 1714 Proprits du tXSDValidator ........................................ 1714 Scnario : Valider des flux de donnes par rapport un fichier XSD ........................ 1714 tXSLT ..................................... 1718 Proprits du tXSLT ........... 1718 Scnario : Transformer un fichier XML en HTML laide dune feuille de style XSL .... 1718

xxiv

Guide de Rfrence des Composants Talend Open Studio

Prface
Informations gnrales
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 5.0.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. Licne 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.

Guide de Rfrence des Composants Talend Open Studio

Historique des versions

Historique des versions


Le tableau ci-dessous liste les modifications apportes au Guide de Rfrence de Talend Open Studio. Version v4.2_a Date 28/04/2011 Historique 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.2_b 11/07/2011 Les mises jour du Guide de Rfrence Talend Open Studio comprennent : - Ajout de composants dans Databases, Data Quality, et ELT. - Ajout dun scnario pour le composant tMysqlInput. v5.0a 21/11/2011 Les mises jour du Guide de Rfrence Talend Open Studio comprennent : - Restructuration post-migration. - Mise jour de la documentation pour reflter le nouveau nom des produits. Pour plus dinformations, consultez le site web de Talend. - Ajout des familles Cloud, DotNET et Technical. - Nouveaux composants dans les familles Business Intelligence, Cloud, Data Quality, DotNET, ESB Processing, Technical, notamment : tHashInput, tHashOutput, tJasperOutput, tSplitRow, tRESTRequest... - Modifications dans les paramtres et les scnarios de nombreux composants afin de reflter les changements de l'interface.

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

xxvi

Guide de Rfrence des Composants Talend Open Studio

Composants Business
Ce chapitre 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 spcifiques, tels que la lecture et lcriture de base de donnes de type CRM ou ERP et la lecture et lcriture de systme SAP.

Guide de Rfrence des Composants Talend Open Studio

tAlfrescoOutput

tAlfrescoOutput

Proprits du tAlfrescoOutput
Famille du composant Fonction Objectif Basic settings Business 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. Container Mode 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. Define Document Type Cliquez sur les trois points [...] pour afficher lditeur tAlfrescoOutput. Cet diteur vous permet :

Guide de Rfrence des Composants Talend Open Studio

Proprits du tAlfrescoOutput

- 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. Property Mapping 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. 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 effectuer des changements sur le schma. Notez que le schma devient automatiquement local (Built-in) lorsque vous effectuez des changements. Result Log File Name Advanced settings Permet de parcourir le fichier dans lequel vous voulez enregistrer les logs lis lexcution du Job.

Configure Target Loca- Permet de configurer le type par dfaut des conteneurs. tion Container 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. Configure Permissions 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. Encoding Slectionnez le type dencodage partir de la liste ou choisissez loption Custom pour le dfinir manuellement. Ce champ doit obligatoirement tre renseign. Target 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.

Association Mapping

Guide de Rfrence des Composants Talend Open Studio

Proprits du tAlfrescoOutput

-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 correspondant. -Cliquez sur OK pour fermer lditeur et afficher lassociation ainsi cre dans la liste Association Target Mapping. tStatCatcher Statistics Utilisation Cochez cette case pour collecter les donnes de log au niveau du composant.

Ce composant est gnralement utilis en tant que composant de sortie et requiert un composant de dbut.

Limitation/Conditions pra- Pour pouvoir utiliser le composant tAlfrescoOutput, il est ncessaire dinstaller lables certaines ressources utiles. Pour plus dinformations, consultez la section intitule 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. Pour installer le module Talend Alfresco :

Guide de Rfrence des Composants Talend Open Studio

Proprits du tAlfrescoOutput

A partir du fichier talendalfresco_20081014.zip, dans le dossier talendalfresco_20081014\alfresco, recherchez les fichiers JAR suivants : staxapi-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:\alfresco\tomcat\webapps\alfresco\WEB-INF\lib Ajoutez le filtre didentification des commandes au fichier web.xml situ au chemin daccs C: \alfresco\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.

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

Guide de Rfrence des Composants Talend Open Studio

Proprits du tAlfrescoOutput

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

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer des documents sur un serveur Alfresco

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

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer des documents sur un serveur Alfresco

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

Dans lditeur graphique, double-cliquez sur le composant tAlfrescoOutput pour en afficher les paramtres de base (Basic settings).

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer des documents sur un serveur Alfresco

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

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer des documents sur un serveur Alfresco

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

10

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer des documents sur un serveur Alfresco

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.

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

Guide de Rfrence des Composants Talend Open Studio

11

tBonitaDeploy

tBonitaDeploy

Proprits du tBonitaDeploy
Famille de composant Fonction Business/Bonita 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 version Slectionnez un numro de version pour le moteur Bonita Runtime.

Objectif Basic settings

Bonita Runtime Envi- Parcourez votre rpertoire, ou saisissez le chemin ronment File daccs au fichier denvironnement Bonita Runtime. Bonita Runtime Jass Parcourez votre rpertoire, ou saisissez le chemin File daccs au fichier jass Bonita Runtime. Bonita Runtime logging Parcourez votre rpertoire, ou saisissez le chemin file daccs au fichier de log Bonita Runtime. Login Module Business Archive Saisissez le nom du module de login au moteur Bonita Runtime dfini dans le fichier Bonita Runtime jaas. 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. Cochez cette case pour collecter les mtadonnes de traitement du Job au niveau du Job ainsi quau niveau de chaque composant. 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 le Guide utilisateur Talend Open Studio.

User name Password Die on error

Advanced settings

tStatCatcher Statistics

Utilisation Connections

Ce composant est gnralement utilis en standalone.

12

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

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 le Guide utilisateur Talend Open Studio.

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.

Guide de Rfrence des Composants Talend Open Studio

13

tBonitaInstantiateProcess

tBonitaInstantiateProcess

tBonitaInstantiateProcess Properties
Famille de composant Fonction Objectif Basic settings Business/Bonita 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. Bonita Runtime Envi- Parcourez votre rpertoire, ou saisissez le chemin ronment File daccs au fichier denvironnement Bonita Runtime. Bonita Runtime Jass Parcourez votre rpertoire, ou saisissez le chemin File daccs au fichier jass Bonita Runtime. Bonita Runtime logging Parcourez votre rpertoire, ou saisissez le chemin file daccs au fichier de log Bonita Runtime. Use Process ID Cette case nest pas coche par dfaut, pour activer les champs process name (nom du processus)et process version (version du processus), afin que vous puissiez saisir les informations correspondantes du processus spcifique que vous souhaitez instancier. Ces informations seront utilises 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. User name Password Die on error 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.

14

Guide de Rfrence des Composants Talend Open Studio

Scnario : Excuter un processus Bonita via un Job Talend

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.

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

Guide de Rfrence des Composants Talend Open Studio

15

Scnario : Excuter un processus Bonita via un Job Talend

Un tFixedFlowInput : ce composant gnre le schma utilis comme paramtre dexcution du processus dploy. 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.

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.

16

Guide de Rfrence des Composants Talend Open Studio

Scnario : Excuter un processus Bonita via un Job Talend

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

Guide de Rfrence des Composants Talend Open Studio

17

Scnario : Excuter un processus Bonita via un Job Talend

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

18

Guide de Rfrence des Composants Talend Open Studio

Scnario : Excuter un processus Bonita via un Job Talend

Le processus est dploy dans le moteur Bonita Runtime et une instance est cre pour les requtes concernant le personnel.

Guide de Rfrence des Composants Talend Open Studio

19

tCentricCRMInput

tCentricCRMInput

Proprits du tCentricCRMInput
Famille du composant Fonction Objectif Basic settings Business/CentricCRM 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 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.

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. Query condition Advanced settings tStatCatcher Statistics Saisissez la requte permettant de slectionner les donnes extraire. Cochez cette case pour collecter les mtadonnes de traitement du Job au niveau du Job ainsi quau niveau de chaque composant.

Utilisation Limitation

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.

20

Guide de Rfrence des Composants Talend Open Studio

tCentricCRMOutput

tCentricCRMOutput

Proprits du tCentricCRMOutput
Famille du composant Fonction Objectif Basic settings Business/CentricCRM 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. 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. 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.

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.

Guide de Rfrence des Composants Talend Open Studio

21

tHL7Input

tHL7Input

Proprits du tHL7Input
Famille de composant Fonction Objectif Business > Healthcare / Unstructured > HL7 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 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. 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. Not Validate HL7 Mes- Cochez cette case si vous ne souhaitez pas valider les sage messages HL7. Advanced settings Advanced separator Cochez cette option pour modifier les sparateurs utili(for numbers) ss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux. Encoding Slectionnez le type dencodage partir de la liste ou choisissez loption Custom pour le dfinir manuellement. Ce champ doit obligatoirement tre renseign.

Basic settings

Segment Lists

22

Guide de Rfrence des Composants Talend Open Studio

Scnario : Retrouver des informations concernant les patients et les vnements partir dun fichier HL7

tStatCatcher Statistics Utilisation Limitation

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

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.

Guide de Rfrence des Composants Talend Open Studio

23

Scnario : Retrouver des informations concernant les patients et les vnements partir dun fichier HL7

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.

24

Guide de Rfrence des Composants Talend Open Studio

Scnario : Retrouver des informations concernant les patients et les vnements partir dun fichier HL7

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.

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.

Guide de Rfrence des Composants Talend Open Studio

25

tHL7Output

tHL7Output

Proprits du tHL7Output
Famille de composant Fonction Objectif Basic settings Business > Healthcare / Unstructured > HL7 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 nud o stocker les donnes de la ligne parente. Parent row : Flux de donnes source. File Stream Name/Output 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.

Configure HL7 Tree HL7 version Advanced settings

Create directory only if Cette case est coche par dfaut. Cette option permet de not exists crer le dossier contenant le fichier de sortie sil nexiste pas dj. Encoding Slectionnez le type dencodage partir de la liste ou choisissez loption Custom pour le dfinir manuellement. Ce champ doit obligatoirement tre renseign. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics 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 le composant tHL7Input.

26

Guide de Rfrence des Composants Talend Open Studio

tMarketoInput

tMarketoInput

Proprits du tMarketoInput
Famille de composant Fonction Objectif Basic settings Business/Cloud 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. 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.

Guide de Rfrence des Composants Talend Open Studio

27

Proprits du tMarketoInput

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

28

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

Batch Size

Limite maximale du nombre des donnes de prospects rcuprer par lot. Ce champ est disponible uniquement si vous avez slectionn lopration syncMultipleLeads.

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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

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

Guide de Rfrence des Composants Talend Open Studio

29

tMarketoListOperation

tMarketoListOperation

Proprits du tMarketoOutput
Famille de composant Fonction Business/Cloud Le composant tMarketoListOperation ajoute/supprime un ou plusieurs prospect(s) dans une liste de la base de donnes Marketo. Il vrifie galement si un ou plusieurs prospect(s) existe(nt) dans cette liste. Ce composant vous permet dajouter ou de supprimer un ou plusieurs prospect(s) dans une liste de la base de donnes Marketo. Vous pouvez galement vrifier lexistence dun ou plusieurs prospect(s) dans la liste. 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 deffectuer un ajout/une suppression dun ou plusieurs prospect(s) dans une liste dune base de donnes Marketo. Vous pouvez galement vrifier lexistence dun ou plusieurs prospect(s) dans une liste de la base de donnes Marketo.

Objectif

Basic settings

30

Guide de Rfrence des Composants Talend Open Studio

Scnario : Ajouter un enregistrement de prospects dans une liste de la base de donnes Marketo

addTo : Cette option ajoute un ou plusieurs prospect(s) dans une liste de la base de donnes Marketo. isMemberOf : Cette option recherche dans la base de donnes si le(s) prospect(s) spcifique(s) existe(nt) dans la base de donnes. removeFrom : cette opration supprime un ou plusieurs prospect(s) dune liste dans la base de donnes Marketo. Add or remove multiple Cochez cette case afin dajouter ou de supprimer pluleads sieurs prospect(s) dune liste dans la base de donnes Marketo. Cette case est disponible uniquement si vous avez slectionn addTo ou removeFrom 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. Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

Ce composant est gnralement utilis en tant que composant intermdiaire. Un composant dentre et un composant de sortie sont ncessaires. n/a

Scnario : Ajouter un enregistrement de prospects dans une liste de la base de donnes Marketo
Le scnario suivant dcrit un Job a trois composants qui ajoute un enregistrement de prospects dans une liste de la base de donnes Marketo.

Dposez les composants tMarketoListOperation, tFixedFlowInput et tLogRow de la Palette dans lespace de modlisation graphique. Connectez le tFixedFlowInput au tMarketoListOperation laide dun lien Row > Main. Connectez le tMarketoListOperation au tLogRow laide dun lien Row > Main.

Guide de Rfrence des Composants Talend Open Studio

31

Scnario : Ajouter un enregistrement de prospects dans une liste de la base de donnes Marketo

Double-cliquez sur le composant tFixedFlowInput afin de dfinir ses proprits dans sa vue Basic settings.

Cliquez sur le bouton [...] ct du champ Edit schema pour dfinir manuellement le schma.

Cliquez sur le bouton [+] afin dajouter quatre colonnes : ListKeyType, ListKeyValue, LeadKeyType et LeadKeyValue. Laissez leurs paramtres par dfaut. Cliquez sur OK pour sauvegarder la configuration. Dans la zone Mode, slectionnez Use Inline Table. Cliquez sur le bouton [+] pour ajouter une ligne, puis remplissez-la avec les valeurs respectives. Dans cet exemple, ces valeurs sont : MKTOLISTNAME pour ListKeyType, bchenTestList pour ListKeyValue, IDNUM pour LeadKeyType et 308408 pour LeadKeyValue. Double-cliquez sur le composant tMarketoListOperation pour dfinir ses proprits dans la vue Basic settings.

32

Guide de Rfrence des Composants Talend Open Studio

Scnario : Ajouter un enregistrement de prospects dans une liste de la base de donnes Marketo

Cliquez sur le bouton Sync columns afin de rcuprer le schma dfini dans le tFixedFlowInput. Saisissez 1 dans le champ Number of rows. Dans le champ Endpoint address, saisissez lURL du serveur Web Marketo. Dans cet exemple, saisissez https://na-c.marketo.com/soap/mktows/1_5. Notez que lURL utilise dans ce scnario a pour but la dmonstration uniquement. Dans le champ Secret key, saisissez le code dauthentification crypt fourni par Marketo. Dans cet exemple, le code est 464407637703554044DD11AA2211998. Saisissez lID de lutilisateur dans le champ Client Access ID. Dans cet exemple, lID est mktodemo41_785133934D1A219. Dans la liste Operation, slectionnez addTo. Saisissez la limite avant suspension de la requte dans le champ Timeout. Dans cet exemple, utilisez le dlai par dfaut : 60000. Double-cliquez sur le composant tLogRow afin de configurer ses proprits dans la vue Basic settings.

Cliquez sur le bouton Sync columns pour rcuprer le schma dfini dans le composant tMarketoListOperation. Dans la zone Mode, slectionnez Table. Sauvegardez votre Job et appuyez sur F6 pour lexcuter.

Guide de Rfrence des Composants Talend Open Studio

33

Scnario : Ajouter un enregistrement de prospects dans une liste de la base de donnes Marketo

Lajout dun enregistrement de prospects dans une liste de la base de donnes Marketo est affich dans la console de la vue Run.

34

Guide de Rfrence des Composants Talend Open Studio

tMarketoOutput

tMarketoOutput

Proprits du tMarketoOutput
Famille de composant Fonction Objectif Basic settings Business/Cloud 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.

Guide de Rfrence des Composants Talend Open Studio

35

Proprits du tMarketoOutput

syncMultipleLeads : Cette option sollicite une opration dinsertion ou de mise jour pour plusieurs enregistrements de prospects regroups par lots. 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 re- Cochez cette case afin de ddoublonner et de mettre cord on email address 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 email. 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

Ce composant est gnralement utilis en tant que composant de sortie. Un composant dentre est ncessaire. n/a

36

Guide de Rfrence des Composants Talend Open Studio

Scnario : Insrer et rcuprer des donnes dune base de donnes Marketo via un systme externe

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.

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.

Guide de Rfrence des Composants Talend Open Studio

37

Scnario : Insrer et rcuprer des donnes dune base de donnes Marketo via un systme externe

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.

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.

38

Guide de Rfrence des Composants Talend Open Studio

Scnario : Insrer et rcuprer des donnes dune base de donnes Marketo via un systme externe

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.

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.

Guide de Rfrence des Composants Talend Open Studio

39

Scnario : Insrer et rcuprer des donnes dune base de donnes Marketo via un systme externe

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.

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

40

Guide de Rfrence des Composants Talend Open Studio

tMicrosoftCRMInput

tMicrosoftCRMInput

Proprits du tMicrosoftCRMInput
Famille de composant Fonction Objectif Basic settings Business 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 URL Webservice 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.

Organizename

Username et Password Saisissez les informations dauthentification de lutilisateur au service Web. Domain Host Port Time out (seconds) Entity 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.

Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Si vous effectuez des modifications, le schma passera automatiquement en built-in. Pour ce composant, le schma correspond lentit slectionne. Logical operators used Si vous souhaitez combiner le filtrage simple et le mode to combine conditions avanc, slectionnez loprateur permettant de combiner les deux modes. Conditions Les conditions sont excutes les unes aprs les autres pour chaque ligne.

Guide de Rfrence des Composants Talend Open Studio

41

Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques 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.

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.

42

Guide de Rfrence des Composants Talend Open Studio

Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques 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 nud 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.

Guide de Rfrence des Composants Talend Open Studio

43

Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques

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

44

Guide de Rfrence des Composants Talend Open Studio

Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques 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.

Guide de Rfrence des Composants Talend Open Studio

45

Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques

Slectionnez le mode Repository partir de la liste droulante Property Type si vous avez stock les paramtres du fichier dentre sous le nud 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 du 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. 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.

46

Guide de Rfrence des Composants Talend Open Studio

Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques

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.

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.

Guide de Rfrence des Composants Talend Open Studio

47

Scnario : Ecrire des donnes dans une base de donnes Microsoft CRM et attribuer des conditions aux colonnes pour extraire des lignes spcifiques 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.

48

Guide de Rfrence des Composants Talend Open Studio

tMicrosoftCRMOutput

tMicrosoftCRMOutput

Proprits du tMicrosoftCRMOutput
Famille de composant Fonction Objectif Basic settings Business 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. Authentication Type Microsoft URL Slectionnez le type d'authentification dans la liste, ON_PREMISE ou ONLINE.

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

Organizename

Username et Password Saisissez les informations dauthentification de lutilisateur au service Web. Domain Host Port Action 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. Time out (seconds) Entity Nombre de secondes dcoute du port avant sa fermeture. Slectionnez lentit adquate partir de la liste droulante.

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.

Guide de Rfrence des Composants Talend Open Studio

49

Scnario associ

Lookup Type Mapping Ajoutez autant de lignes que ncessaire afin d'tablir le mapping entre les tables source et cible. Slectionnez un objet de rfrence dans la liste droulante Input column et saisissez le mot-cl des tables source dans le champ Type. Advanced settings Reuse Http Client tStatCatcher Statistics Usage Limitation Cochez cette case afin de conserver la connexion courante ou dcochez la case afin de librer la connexion. 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 composant tMicrosoftCRMInput.

50

Guide de Rfrence des Composants Talend Open Studio

tMSAXInput

tMSAXInput

Proprits du tMSAXInput
Famille de composant Fonction Objectif Basic settings 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 Adresse IP du serveur. Saisissez le nom de domaine sur lequel est hberg le serveur MicrosoftAX.

Username et Password Saisissez les informations dauthentification de lutilisateur. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Si vous effectuez des modifications, le schma passera automatiquement en built-in. Table Name Query Nom de la table lire. Saisissez votre requte SQL en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

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.

Guide de Rfrence des Composants Talend Open Studio

51

tMSAXOutput

tMSAXOutput

Proprits du tMSAXOutput
Famille de composant Fonction Objectif Basic settings 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 Adresse IP du serveur. Saisissez le nom de domaine sur lequel est hberg le serveur MicrosoftAX.

Username et Password Saisissez les informations dauthentification de lutilisateur. Table Name Action on data 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.

52

Guide de Rfrence des Composants Talend Open Studio

Proprits du tMSAXOutput

Cliquez sur Edit Schema pour modifier le schma. Si vous effectuez des modifications, le schma passera automatiquement en built-in. 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. Advanced settings Utilisation Limitation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Additional columns

Ce composant est gnralement utilis en tant que composant de sortie. Un composant de dbut est ncessaire. n/a

Guide de Rfrence des Composants Talend Open Studio

53

Scnario : Insrer des donnes dans une table dfinie sur le serveur Microsoft AX

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

54

Guide de Rfrence des Composants Talend Open Studio

Scnario : Insrer des donnes dans une table dfinie sur le serveur Microsoft AX

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

Guide de Rfrence des Composants Talend Open Studio

55

Scnario 2 : Effacer des donnes dune table prcise sur le serveur MicrosoftAX.

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

56

Guide de Rfrence des Composants Talend Open Studio

Scnario 2 : Effacer des donnes dune table prcise sur le serveur MicrosoftAX.

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.

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.

Guide de Rfrence des Composants Talend Open Studio

57

Scnario 2 : Effacer des donnes dune table prcise sur le serveur MicrosoftAX.

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.

58

Guide de Rfrence des Composants Talend Open Studio

tOpenbravoERPInput

tOpenbravoERPInput

Proprits du tOpenbravoERPInput
Famille de composant Fonction Objectif Basic settings Business 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 Saisissez lURL du service Web permettant de se WebService URL connecter la base de donnes OpenbravoERP. Username et Password Saisissez les informations dauthentification de lutilisateur au service Web. Entity Slectionnez lentit adquate partir de la liste droulante.

Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Cliquez sur Edit Schema pour modifier le schma. Si vous effectuez des modifications, le schma passera automatiquement en built-in. Pour ce composant, le schma correspond lentit slectionne. WHERE Clause Order by 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). First result Max result Advanced settings Saisissez le numro de la ligne que vous souhaitez rcuprer en premier. Saisissez le nombre maximal de rsultats que vous souhaitez rcuprer.

Advanced separator Cochez cette option pour modifier les sparateurs utili(for numbers) ss pour les nombres : Thousands separator : dfinissez le sparateur utilis pour les milliers. Decimal separator : dfinissez le sparateur utilis pour les dcimaux.

Guide de Rfrence des Composants Talend Open Studio

59

Scnario associ

tStatCatcher Statistics Utilisation Limitation

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
Pour un scnario associ, consultez le composant tMicrosoftCRMInput.

60

Guide de Rfrence des Composants Talend Open Studio

tOpenbravoERPOutput

tOpenbravoERPOutput

Proprits du tOpenbravoERPOutput
Famille de composant Fonction Objectif Basic settings Business 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 Web- Saisissez lURL du service Web permettant de se service URL connecter la base de donnes OpenbravoERP. Username et Password Saisissez les informations dauthentification de lutilisateur au service Web. Action on data 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.

Use existing data file Entity

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

Guide de Rfrence des Composants Talend Open Studio

61

tSageX3Input

tSageX3Input

Proprits du tSageX3Input
Famille de com- Business/Sage posant 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. Endpoint dress Username Password Language Pool alias ad- Saisissez ladresse du Service Web fourni par le serveur Web Sage X3 donn. et 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.on=on; Si vous devez utiliser plusieurs chanes de caractres, sparez-les avec un &, par exemple, RequestConfigDebug=adxwss.trace.on=on&adxwss.trace.size=16384; Un outil tiers est ncessaire pour rcuprer ce type dinformations. 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.

Request config

62

Guide de Rfrence des Composants Talend Open Studio

Scnario : Utiliser les cls des requtes pour extraire des donnes dun systme Sage X3 donn

Mapping

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.

Query condition 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. Limit Advanced settings tStatCatcher Statistics Utilisation Limitation n/a Saisissez un chiffre ou un nombre indiquant le maximum de lignes de donnes extraire. 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.

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.

Guide de Rfrence des Composants Talend Open Studio

63

Scnario : Utiliser les cls des requtes pour extraire des donnes dun systme Sage X3 donn

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

Dans cet diteur, cliquez douze fois sur le bouton [+] pour ajouter 12 lignes la table.

64

Guide de Rfrence des Composants Talend Open Studio

Scnario : Utiliser les cls des requtes pour extraire des donnes dun systme Sage X3 donn

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 :

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.

Guide de Rfrence des Composants Talend Open Studio

65

Scnario : Utiliser les cls des requtes pour extraire des donnes dun systme Sage X3 donn

Appuyez sur F6 pour excuter le Job. Les rsultats sont affichs dans la vue Run :

66

Guide de Rfrence des Composants Talend Open Studio

tSageX3Output

tSageX3Output

Proprits du tSageX3Output
Famille de com- Business/Sage posant 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. Endpoint dress Username Password Language Pool alias ad- Saisissez ladresse du Service Web fourni par le serveur Web Sage X3 donn. et 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.

Objectif Basic settings

Request config 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.on=on; Si vous devez utiliser plusieurs chanes de caractres, sparez-les avec un &, par exemple,

RequestConfigDebug=adxwss.trace.on=on&adxwss.trace.size=163 Un outil tiers est ncessaire pour rcuprer ce type dinformations. 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.

Guide de Rfrence des Composants Talend Open Studio

67

Scnario : Utiliser un service Web Sage X3 pour insrer des donnes dans un systme Sage X3 donn

Action

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.

Mapping

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.

Advanced tings Utilisation Limitation

set- tStatCatcher Statistics

Cochez cette case pour collecter les donnes de log au niveau du Job ainsi quau niveau de chaque composant.

Ce composant est gnralement utilis comme composant de sortie et requiert un composant dentre. n/a

Scnario : Utiliser un service Web Sage X3 pour insrer des donnes dans un systme Sage X3 donn
Ce scnario dcrit un Job deux composants, utilis pour gnrer une ligne de donnes et insrer ces donnes dans un systme Sage X3 donn. Vous pouvez trouver les donnes utilises dans ce scnario dans lexemple fourni par Sage X3. Le service Web Sage X3 est utilis pour accder un objet.

Dposez un composant tFixedFlowInput et un tSageX3Output de la Palette dans lespace de modlisation graphique. 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.

68

Guide de Rfrence des Composants Talend Open Studio

Scnario : Utiliser un service Web Sage X3 pour insrer des donnes dans un systme Sage X3 donn

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

Guide de Rfrence des Composants Talend Open Studio

69

Scnario : Utiliser un service Web Sage X3 pour insrer des donnes dans un systme Sage X3 donn

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.

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.

70

Guide de Rfrence des Composants Talend Open Studio

Scnario : Utiliser un service Web Sage X3 pour insrer des donnes dans un systme Sage X3 donn

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

Guide de Rfrence des Composants Talend Open Studio

71

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 Fonction Objectif Business/Cloud 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 connec- Cochez cette case pour utiliser une connexion tablie tion 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 le composant tSalesforceConnection. 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 dinformations 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. Salesforce Version Bulk file path Action 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.

Basic settings

72

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

Update : mettre jour des donnes. Upsert : mettre jour et insrer des donnes. 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. 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. Advanced settings Rows to commit Bytes to commit Use Socks Proxy 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics 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 le composant tSalesforceOutputBulk.

Guide de Rfrence des Composants Talend Open Studio

73

tSalesforceConnection

tSalesforceConnection

Proprits du tSalesforceConnection
Famille de composant Fonction Objectif Basic settings Business/Cloud 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 Saisissez les informations dauthentification de lutilisateur au service Web. Timeout (milliseconds) Saisissez le dlai avant suspension de la requte sur Salesforce.com. For salesforce component bulk 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 les composants tSalesforceBulkExec, tSalesforceOutputBulk et tSalesforceOutputBulkExec. Use Soap Compression Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance. Use Socks Proxy 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. Dfinissez l'ID de l'utilisateur rel afin de diffrencier ceux qui utilisent le mme compte et le mme mot de passe pour accder au site Web Salesforce. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings

Client ID

tStatCatcher Statistics Utilisation Limitation

Ce composant est gnralement utilis avec les composants Salesforce. n/a

Scnario associ
Pour plus dinformations relatives au fonctionnement du composant tSalesforceConnection, consultez le composant tMysqlConnection.

74

Guide de Rfrence des Composants Talend Open Studio

tSalesforceGetDeleted

tSalesforceGetDeleted

Proprits du tSalesforceGetDeleted
Famille de composant Fonction Objectif Basic settings Business/Cloud 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 connec- Cochez cette case pour utiliser une connexion tablie tion 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 le composant tSalesforceConnection. 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 dinformations 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. Timeout (milliseconds) Saisissez le dlai avant suspension de la requte sur Salesforce.com. 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. 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.

Guide de Rfrence des Composants Talend Open Studio

75

Scnario : Rcuprer les donnes supprimes du serveur Salesforce

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

Advanced settings

Use Soap Compression Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance. Client ID Dfinissez l'ID de l'utilisateur rel afin de diffrencier ceux qui utilisent le mme compte et le mme mot de passe pour accder au site Web Salesforce. Cochez cette case pour collecter les donnes de log au niveau du composant.

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

76

Guide de Rfrence des Composants Talend Open Studio

Scnario : Rcuprer les donnes supprimes du serveur Salesforce

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.

Guide de Rfrence des Composants Talend Open Studio

77

Scnario : Rcuprer les donnes supprimes du serveur Salesforce

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

78

Guide de Rfrence des Composants Talend Open Studio

tSalesforceGetServerTimestamp

tSalesforceGetServerTimestamp

Proprits du tSalesforceGetServerTimestamp
Famille de composant Fonction Objectif Basic settings Business/Cloud 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 connec- Cochez cette case pour utiliser une connexion tablie tion 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 le composant tSalesforceConnection. 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 dinformations 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. Timeout (milliseconds) Saisissez le dlai avant suspension de la requte sur Salesforce.com. 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.

Guide de Rfrence des Composants Talend Open Studio

79

Scnario associ

Advanced settings

Use Socks Proxy

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 Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance. Client ID Dfinissez l'ID de l'utilisateur rel afin de diffrencier ceux qui utilisent le mme compte et le mme mot de passe pour accder au site Web Salesforce. Cochez cette case pour collecter les donnes de log au niveau du composant.

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

80

Guide de Rfrence des Composants Talend Open Studio

tSalesforceGetUpdated

tSalesforceGetUpdated

Proprits du tSalesforceGetUpdated
Famille de composant Fonction Objectif Basic settings Business/Cloud 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 connec- Cochez cette case pour utiliser une connexion tablie tion 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 le composant tSalesforceConnection. 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 dinformations 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. Timeout (milliseconds) Saisissez le dlai avant suspension de la requte sur Salesforce.com. Module Slectionnez lobjet adquat dans la liste. Custom Object : cette option fait apparatre le champ Custom Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. 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.

Guide de Rfrence des Composants Talend Open Studio

81

Scnario associ

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

Advanced settings

Use Soap Compression Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance. Client ID Dfinissez l'ID de l'utilisateur rel afin de diffrencier ceux qui utilisent le mme compte et le mme mot de passe pour accder au site Web Salesforce. Cochez cette case pour collecter les donnes de log au niveau du composant.

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

82

Guide de Rfrence des Composants Talend Open Studio

tSalesforceInput

tSalesforceInput

Proprits du tSalesforceInput
Famille de Business/Cloud composant 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 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 intitule Proprits du tSalesforceConnection . 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 dinformations concernant longlet Dynamic settings, consultez le Guide Utilisateur de votre Studio. Salesforce Webservice URL Username et Password Timeout (milliseconds) Module Saisissez lURL du service Web permettant de se connecter la base de donnes Salesforce. 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.

Guide de Rfrence des Composants Talend Open Studio

83

Proprits du tSalesforceInput

Use Custom Object : cette option fait apparatre le champ Costum Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. 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. 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_NameofLinked Module_NameofColumnofInterest. Query condition Saisissez la requte permettant de slectionner les donnes extraire. Exemple : account_name= Talend

Manual input of SOQL query Cochez cette case pour saisir manuellement la requte Salesforce que vous souhaitez effectuer dans le champ Query. Query all records (include Cochez cette case pour interroger tous les enregistrements, y deleted records) compris les enregistrements supprims. Advanced set- Batch Size tings Use Socks Proxy 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. (for Caractre, chane ou expression rgulire utilis pour normaliser les donnes collectes laide de requtes effectues sur les relations hirarchiques entre les diffrents objets Salesforce.

Normalize delimited child relationship)

Column name delimiter (for Caractre, chane ou expression rgulire utilis pour sparer le child relationship) nom de lobjet parent du nom de lobjet fils lorsque vous effectuez une requte sur les relations hirarchiques entre les diffrents objets Salesforce. 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 Client ID Cochez cette case pour collecter les donnes de log au niveau du composant. Dfinissez l'ID de l'utilisateur rel afin de diffrencier ceux qui utilisent le mme compte et le mme mot de passe pour accder au site Web Salesforce.

Utilisation Limitation

Ce composant est gnralement utilis en tant que composant de dbut. Un composant de sortie est ncessaire. n/a

84

Guide de Rfrence des Composants Talend Open Studio

Scnario : Utiliser des requtes pour extraire des donnes dune base de donnes Salesforce

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.

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.

Guide de Rfrence des Composants Talend Open Studio

85

Scnario : Utiliser des requtes pour extraire des donnes dune base de donnes Salesforce

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.

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.

86

Guide de Rfrence des Composants Talend Open Studio

Scnario : Utiliser des requtes pour extraire des donnes dune base de donnes Salesforce

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

Guide de Rfrence des Composants Talend Open Studio

87

Scnario : Utiliser des requtes pour extraire des donnes dune base de donnes Salesforce

88

Guide de Rfrence des Composants Talend Open Studio

tSalesforceOutput

tSalesforceOutput

Proprits du tSalesforceOutput
Famille de composant Fonction Objectif Basic settings Business/Cloud 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 Guide utilisateur de Talend Open Studio. Use an existing connec- Cochez cette case pour utiliser une connexion tablie tion 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 intitule Proprits du tSalesforceConnection . 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 dinformations 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.

Guide de Rfrence des Composants Talend Open Studio

89

Proprits du tSalesforceOutput

Timeout (milliseconds) Saisissez le dlai avant suspension de la requte sur Salesforce.com. Action 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. 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. 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. Advanced settings Extended Output 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.

Die on error

Error logging file

Use Socks Proxy

Use Soap Compression Cochez cette case pour activer la compression SOAP. La compression des messages SOAP permet un gain de performance. 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.

90

Guide de Rfrence des Composants Talend Open Studio

Scnario : Supprimer des donnes de lobjet Account

Cette option est disponible uniquement si vous avez slectionn laction Insert, mais non en mode batch, cest--dire sans loption Extended Output. tStatCatcher Statistics Client ID Cochez cette case pour collecter les donnes de log au niveau du composant. Dfinissez l'ID de l'utilisateur rel afin de diffrencier ceux qui utilisent le mme compte et le mme mot de passe pour accder au site Web Salesforce.

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 :

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. Pour plus dinformations concernant la cration de mtadonnes Salesforce, consultez le Guide utilisateur de Talend Open Studio. Dans le champ Salesforce WebService URL, laissez lURL du service Web Salesforce par dfaut ou saisissez lURL laquelle vous souhaitez accder.

Guide de Rfrence des Composants Talend Open Studio

91

Scnario : Supprimer des donnes de lobjet Account

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

Guide de Rfrence des Composants Talend Open Studio

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 Fonction Objectif Basic settings Business/Cloud 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 Parcourez le rpertoire o stocker les fichiers gnrs. Cochez cette case afin dcrire la suite des donnes existantes. Sinon, les donnes seront crases.

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

Guide de Rfrence des Composants Talend Open Studio

93

Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com

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.

Dans la liste Property Type, slectionnez Repository si vous avez dj stock votre connexion Salesforce sous le nud Metadata dans la vue Repository. Les proprits sont automatiquement remplies. Si vous navez pas

94

Guide de Rfrence des Composants Talend Open Studio

Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com

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 concernant la cration des mtadonnes de fichier dlimit, consultez le Guide utilisateur de Talend Open Studio. A ct du champ File name/Stream, cliquez sur le bouton fichier, dans cet exemple sforcebulk.txt. afin de parcourir votre rpertoire jusqu votre

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.

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.

Guide de Rfrence des Composants Talend Open Studio

95

Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com

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

96

Guide de Rfrence des Composants Talend Open Studio

Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com

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.

Guide de Rfrence des Composants Talend Open Studio

97

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 Fonction Objectif Business/Cloud 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 connec- Cochez cette case pour utiliser une connexion tablie tion 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 intitule Proprits du tSalesforceConnection . 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 dinformations 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. Salesforce Version Bulk file path Action 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.

Basic settings

98

Guide de Rfrence des Composants Talend Open Studio

Scnario : Insrer des donnes de masse dans votre Salesforce.com

Update : mettre les donnes jour. Upsert : mettre jour et insrer les donnes. Module Slectionnez lobjet adquat dans la liste. Custom Object : cette option fait apparatre le champ Custom Module Name dans lequel vous pouvez saisir lobjet auquel vous souhaitez vous connecter. 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. Advanced settings Rows to commit Bytes to commit Use Socks Proxy 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

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

Guide de Rfrence des Composants Talend Open Studio

99

Scnario : Insrer des donnes de masse dans votre Salesforce.com

Avant de raliser ce Job, vous devez prparer votre fichier dentre, contenant les donnes devant tre traites par le Job. Dans 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 nud Metadata de la vue Repository. Les proprits sont automatiquement renseignes. Si vous navez pas dfini la connexion au serveur localement dans le Repository, remplissez les champs manuellement, aprs avoir slectionn Built-in dans la liste Property Type. Pour plus dinformations concernant la cration des mtadonnes de fichier dlimit, consultez le Guide utilisateur de Talend Open Studio. A ct du champ File name/Stream, cliquez sur le bouton exemple sforcebulk.txt. afin de slectionner votre fichier dentre, par

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.

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.

100

Guide de Rfrence des Composants Talend Open Studio

Scnario : Insrer des donnes de masse dans votre Salesforce.com

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.

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.

Guide de Rfrence des Composants Talend Open Studio

101

Scnario : Insrer des donnes de masse dans votre Salesforce.com

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 la section intitule Scnario : Insrer des donnes de masse transformes dans votre Salesforce.com .

102

Guide de Rfrence des Composants Talend Open Studio

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 Fonction Objectif Business/SAP 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 ponent list Com- 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 composant 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. Advanced settings Utilisation Limitation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Basic settings

Release Connection

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 la section intitule tMysqlConnection .

Guide de Rfrence des Composants Talend Open Studio

103

tSAPConnection

tSAPConnection

Proprits du tSAPConnection
Famille de composant Fonction Objectif Basic settings Business 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 configura- Client type : Saisissez votre code de connexion SAP tion 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 la section intitule Scnario 1 : Rcuprer les mtadonnes dun systme SAP .

104

Guide de Rfrence des Composants Talend Open Studio

tSAPInput

tSAPInput

Proprits du tSAPInput
Famille de composant Fonction Objectif Basic settings Business 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 Guide utilisateur de Talend Open Studio. Use an existing connec- Cochez la case et cliquez sur le composant de tion 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 dinformations concernant longlet Dynamic settings, consultez le Guide Utilisateur de votre Studio. Connection configura- Client : Saisissez votre code de connexion SAP habition tuel. Userid : Saisissez lidentifiant de connexion utilisateur. Password : Saisissez le mot de passe. Language : Spcifiez la langue.

Guide de Rfrence des Composants Talend Open Studio

105

Proprits du tSAPInput

Host name : Saisissez ladresse IP du systme SAP. System number : Saisissez le numro du systme. 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.

106

Guide de Rfrence des Composants Talend Open Studio

Scnario 1 : Rcuprer les mtadonnes dun systme SAP

Pour plus dinformations concernant les connexions, consultez 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics 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 Enterprise. Si vous tes utilisateur de Talend Open Studio ou Talend Integration Express, 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.

Guide de Rfrence des Composants Talend Open Studio

107

Scnario 1 : Rcuprer les mtadonnes dun systme SAP

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

108

Guide de Rfrence des Composants Talend Open Studio

Scnario 1 : Rcuprer les mtadonnes dun systme SAP

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

Guide de Rfrence des Composants Talend Open Studio

109

Scnario 1 : Rcuprer les mtadonnes dun systme SAP

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

110

Guide de Rfrence des Composants Talend Open Studio

Scnario 1 : Rcuprer les mtadonnes dun systme SAP

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.

Guide de Rfrence des Composants Talend Open Studio

111

Scnario 1 : Rcuprer les mtadonnes dun systme SAP

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 la section intitule tLogRow Enregistrez le Job et appuyez sur F6 pour lexcuter.

112

Guide de Rfrence des Composants Talend Open Studio

Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE

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 Enterprise. Si vous tes utilisateur de Talend Open Studio ou Talend Integration Express, 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.

Guide de Rfrence des Composants Talend Open Studio

113

Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE

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.

114

Guide de Rfrence des Composants Talend Open Studio

Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE

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

Guide de Rfrence des Composants Talend Open Studio

115

Scnario 2 : Lire les donnes des 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.

Dans lespace de modlisation, double-cliquez sur tSAPInput pour afficher ses proprits dans la vue Component.

116

Guide de Rfrence des Composants Talend Open Studio

Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE

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.

Dans lespace de modlisation, slectionnez les composants tLogRow et cliquez sur la vue Component pour paramtrer leurs proprits. Pour plus dinformations, consultez la section intitule tLogRow Enregistrez votre Job et appuyez sur F6 pour lexcuter.

Guide de Rfrence des Composants Talend Open Studio

117

Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE

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.

118

Guide de Rfrence des Composants Talend Open Studio

tSAPOutput

tSAPOutput

Proprits du tSAPOutput
Famille de composant Fonction Objectif Basic settings Business 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 Guide utilisateur de Talend Open Studio. Use an existing connec- Cochez la case et cliquez sur le composant de tion 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 dinformations concernant longlet Dynamic settings, consultez le Guide utilisateur de votre Studio. Connection configura- Client type : Saisissez votre code de connexion SAP tion 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.

Guide de Rfrence des Composants Talend Open Studio

119

Scnarios associs

System number : Saisissez le numro du systme. 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. FunName Mapping Advanced settings Release Connection 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics 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 la section intitule Scnario 1 : Rcuprer les mtadonnes dun systme SAP et la section intitule Scnario 2 : Lire les donnes des diffrents schmas de la fonction RFC_READ_TABLE .

120

Guide de Rfrence des Composants Talend Open Studio

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 Function Purpose Basic settings Business/SAP tSAPRollback annule la transaction dans le SAP connect. tSAPRollback vite le commit de transaction involontaire. SAPConnection ponent list Com- 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 composant a excut sa tche. Cochez cette case pour collecter les donnes de log au niveau du composant.

Release Connection

Advanced settings Usage Limitation

tStatCatcher Statistics

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 la section intitule Scnario : Annuler linsertion de donnes dans des tables mre/fille du composant tMysqlRollback.

Guide de Rfrence des Composants Talend Open Studio

121

tSugarCRMInput

tSugarCRMInput

Proprits du tSugarCRMInput
Famille du composant Fonction Objectif Basic settings Business/Cloud 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 Saisissez lURL du service Web permettant de se URL connecter la base de donnes SugarCRM. Username et Password Saisissez les informations dauthentification de lutilisateur au service Web. Module 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. 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. Query condition Advanced settings Utilisation Limitation tStatCatcher Statistics Saisissez la requte permettant de slectionner les donnes extraire. Exemple : account_name= Talend 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.

122

Guide de Rfrence des Composants Talend Open Studio

Scnario: Extraire les donnes dun compte partir de SugarCRM

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.

Guide de Rfrence des Composants Talend Open Studio

123

Scnario: Extraire les donnes dun compte partir de SugarCRM

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

124

Guide de Rfrence des Composants Talend Open Studio

tSugarCRMOutput

tSugarCRMOutput

Proprits du tSugarCRMOutput
Famille du composant Fonction Objectif Basic settings Business/Cloud 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 Saisissez lURL du service Web permettant de se URL connecter la base de donnes SugarCRM. Username et Password Saisissez les informations dauthentification de lutilisateur au service Web. Module 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. Action Vous pouvez effectuer lune des oprations suivantes sur les donnes du module SugarCRM : Insert : insrer les donnes. Update : mettre les donnes jour. 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. 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

Guide de Rfrence des Composants Talend Open Studio

125

Scnario associ

Scnario associ
Aucun scnario nest disponible pour ce composant.

126

Guide de Rfrence des Composants Talend Open Studio

tVtigerCRMInput

tVtigerCRMInput

Proprits du tVtigerCRMInput
Famille du composant 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 Saisissez ladresse IP du serveur VtigerCRM. Saisissez le numro de port daccs au serveur. Saisissez le chemin daccs au serveur Business/tVtigerCRM 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.

Username et Password Saisissez les informations dauthentification de lutilisateur au service Web. Version Module Method Renseignez la version de VtigerCRM 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 VtigerCRM slectionn.

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. Vtiger 5.1 Endpoint Username Access key Action 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. Module Slectionnez le module adquat dans la liste. 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 com-

Guide de Rfrence des Composants Talend Open Studio

127

Scnario associ

posant 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. Query condition Saisissez la requte permettant de slectionner les donnes extraire.

Manual input of SQL Cochez cette case pour saisir manuellement la requte query que vous souhaitez effectuer dans le champ 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

Guide de Rfrence des Composants Talend Open Studio

tVtigerCRMOutput

tVtigerCRMOutput

Proprits du tVtigerCRMOutput
Famille du composant 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 Saisissez ladresse IP du serveur VtigerCRM. Saisissez le numro de port daccs au serveur. Saisissez le chemin daccs au serveur. Business/VtigerCRM 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 VtigerCRM.

Username et Password Saisissez les informations dauthentification de lutilisateur au service Web. Version Module Method Renseignez la version de VtigerCRM 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 VtigerCRM slectionn.

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. Vtiger 5.1 Endpoint Username Access key Action 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 VtigerCRM : Insert : insrer les donnes. Update : mettre les donnes jour. Module Slectionnez le module adquat dans la liste. 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 com-

Guide de Rfrence des Composants Talend Open Studio

129

Scnario associ

posant 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. 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

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

Guide de Rfrence des 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.

Guide de Rfrence des Composants Talend Open Studio

tBarChart

tBarChart

Proprits du tBarChart
Famille du composant Fonction Objectif Basic settings Business gence/Charts Intelli-

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 le Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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. Nom et chemin daccs du fichier image de sortie. 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.

Generated image path Chart title Include legend

3Dimensions

Image width et Image Saisissez la largeur et la hauteur du fichier image, expriheight mes en pixels.

132

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer un diagramme en barres partir de donnes dentre

Category axis name et Saisissez le nom de laxe category et le nom de laxe value. Value axis name 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Plot orientation Advanced settings Utilisation tStatCatcher Statistics

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 le Guide utilisateur Talend Open Studio ainsi que la section intitule tMap .

Guide de Rfrence des Composants Talend Open Studio

133

Scnario : Crer un diagramme en barres partir de donnes dentre

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.

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

134

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer un diagramme en barres partir de donnes dentre

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.

Guide de Rfrence des Composants Talend Open Studio

135

Scnario : Crer un diagramme en barres partir de donnes dentre

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

136

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer un diagramme en barres partir de donnes dentre

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.

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.

Guide de Rfrence des Composants Talend Open Studio

137

Scnario : Crer un diagramme en barres partir de donnes dentre

138

Guide de Rfrence des Composants Talend Open Studio

tDB2SCD

tDB2SCD

Proprits du tDB2SCD
Famille du composant Fonction Objectif 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. 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 Adresse IP du serveur de base de donnes.

Basic settings

Guide de Rfrence des Composants Talend Open Studio

139

Scnario associ

Port Database Table 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.

Username et Password Informations dauthentification de lutilisateur de la base de donnes. Table Nom de la table crer. Vous ne pouvez crer quune seule table la fois.

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 le Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide Utilisateur Talend Open Studio. SCD Editor Lditeur SCD Editor permet de construire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section intitule Mthodologie de gestion du SCD . Use memory Mode Die on error saving 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. Cochez cette case pour collecter les donnes de log au niveau du composant. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

Advanced settings

tStatCatcher Statistics Debug mode

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 la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

140

Guide de Rfrence des Composants Talend Open Studio

tDB2SCDELT

tDB2SCDELT

Proprits du tDB2SCDELT
Famille du composant Fonction Objectif 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 connec- Cochez cette case lorsque vous utilisez le composant tion 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, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Basic settings

Username et Password Informations dauthentification de lutilisateur de base de donnes. Source table Nom de la table contenant les donnes filtrer.

Guide de Rfrence des Composants Talend Open Studio

141

Proprits du tDB2SCDELT

Table Action on 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.

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 : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide Utilisateur de Talend Open Studio. 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 intitule Cls SCD . Source Keys Use SCD Type 1 fields Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes. 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. 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.

Use SCD Type 2 fields

142

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

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 tStatCatcher Statistics Utilisation Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. 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 et une connexion de type Row Main.

Scnario associ
Pour un scnario associ, consultez la section intitule tFileInputJSON , ainsi que la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

Guide de Rfrence des Composants Talend Open Studio

143

tGreenplumSCD

tGreenplumSCD

Proprits du tGreenplumSCD
Famille du composant Fonction Objectif Databases/Business Intelligence/Greenplum 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 connec- Cochez cette case lorsque vous utilisez un tGreenplumtion Connection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes.

Basic settings

Username et Password Informations dauthentification de lutilisateur de la base de donnes.

144

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

Table

Nom de la table crer. Vous ne pouvez crer quune seule table la fois.

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 : Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : 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 intitule Mthodologie de gestion du SCD . Use memory Mode Die on error saving 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. Cochez cette case pour collecter les donnes de log au niveau du composant. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

Advanced settings

tStatCatcher Statistics Debug mode

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 la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

Guide de Rfrence des Composants Talend Open Studio

145

tInformixSCD

tInformixSCD

Proprits du tInformixSCD
Component family Fonction Objectif 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. 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.

Basic settings

146

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

Username et Password Informations dauthentification de lutilisateur de la base de donnes. Instance Table 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.

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 : Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : 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 intitule Mthodologie de gestion du SCD . Use memory Mode Use Transaction Die on error saving 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. Cochez cette case pour collecter les donnes de log au niveau du composant. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

Advanced settings

tStatCatcher Statistics Debug mode

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 la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 du composant tMysqlSCD.

Guide de Rfrence des Composants Talend Open Studio

147

tIngresSCD

tIngresSCD

Proprits du tIngresSCD
Component family Fonction Objectif 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. 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 Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Basic settings

Username et Password Informations dauthentification de lutilisateur de la base de donnes.

148

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

Table

Nom de la table crer. Vous ne pouvez crer quune seule table la fois.

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 le Guide utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide utilisateur Talend Open Studio. SCD Editor Lditeur SCD Editor permet de construire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section intitule Mthodologie de gestion du SCD . Use memory Mode Die on error saving 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. Cochez cette case pour collecter les donnes de log au niveau du composant. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

Advanced settings

tStatCatcher Statistics Debug mode

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 la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 du composant tMysqlSCD.

Guide de Rfrence des Composants Talend Open Studio

149

tJasperOutput

tJasperOutput

Proprits du tJasperOutput
Ce composant est troitement li l'outil de reporting de Jaspersoft, iReport. Il lit et traite des donnes d'un flux d'entre afin de crer un rapport l'aide d'un modle de rapport JRXML dfini dans iReport. Famille de composant Fonction Objectif Basic settings Business gence/Jasper Intelli-

Le composant tJasperOutput lit et traite des donnes d'un flux d'entre afin de crer un rapport l'aide d'un modle de rapport JRXML dfini dans iReport. Ce composant vous permet d'utiliser l'outil iReport de Jaspersoft afin de crer un rapport dans des formats riches. Jrxml file Temp path Destination path File name/Stream Report type Fichier du modle de rapport cr dans iReport. Chemin d'accs aux fichiers temporaires. Chemin d'accs au fichier final du rapport. Nom du rapport final. Type du fichier du rapport final.

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 le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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. Editez la commande pour fournir le chemin d'accs au fichier d'excution de iReport, par exemple en remplaant __IREPORT_PATH__\ par E:\Program Files\Jaspersoft\iReport-4.1.1\bin\, ou en saisissant le chemin d'accs complet au fichier d'excution, par exemple "E:\Program Files\Jaspersoft\iReport-4.1.1\bin\iReport.exe". Cliquez sur ce bouton pour lancer iReport. Cochez cette case pour collecter les donnes de log au niveau du composant.

iReport

Launch Advanced settings Utilisation tStatCatcher Statistics

Ce composant est troitement li l'outil de reporting de Jaspersoft, iReport. Il lit et traite des donnes d'un flux d'entre afin de crer un rapport l'aide d'un modle de rapport JRXML dfini dans iReport.

150

Guide de Rfrence des Composants Talend Open Studio

Scnario : Gnrer un rapport avec un modle .jrxml

Limitation

n/a

Scnario : Gnrer un rapport avec un modle .jrxml


Le Job suivant lit des donnes d'un fichier .csv et cre un rapport .pdf bas sur un modle de rapport .jrxml existant. Notez que le fichier de modle doit avoir t cr via l'outil iReport de Jaspersoft partir d'un fichier partageant le mme schma avec le fichier source .csv du Job. 1. Glissez-dposez les composants suivants de la Palette dans l'espace de modlisation graphique : tFileInputDelimited et tJasperOutput. 2. Reliez le tFileInputDelimited au tJasperOutput l'aide d'un lien Row.

3. Double-cliquez sur le composant tFileInputDelimited afin d'afficher sa vue Basic settings.

4. Slectionnez Built-In dans la liste droulante Property Type. Vous pouvez slectionner Repository dans la liste Property Type afin de renseigner automatiquement les champs correspondants si la mtadonne a t stocke localement dans le Repository. Pour plus d'informations concernant les mtadonnes Metadata, consultez le Guide utilisateur de Talend Open Studio. 5. Renseignez le champ File name/Stream en saisissant le chemin d'accs et le nom du fichier source, par exemple "C:/Documents and Settings/Andy ZHANG/nom.csv". 6. Laissez les paramtres par dfaut pour les champs Row Separator et Field Separator. Cependant, si ncessaire, vous pouvez les modifier selon vos besoins. 7. Saisissez 1 dans le champ Header et 0 dans le champ Footer. Laissez le champ Limit vide. Cependant, si ncessaire, vous pouvez les modifier selon vos besoins. 8. Slectionnez Built-In dans la liste droulante Schema puis cliquez sur Edit schema afin de dfinir la structure des donnes du fichier d'entre. Dans ce cas, le fichier d'entre contient deux colonnes : Nom et Prenom.

Guide de Rfrence des Composants Talend Open Studio

151

Scnario : Gnrer un rapport avec un modle .jrxml

9. Double-cliquez sur le tJasperOutput pour afficher sa vue Basic settings et configurer ses proprits.

10.Saisissez le chemin d'accs complet au fichier de modle du rapport cr via l'outil iReport de Jaspersoft dans le champ Jrxml file. Vous pouvez galement cliquer sur le bouton [...] afin de parcourir votre systme. Le schma du fichier utilis pour crer un modle .jrxml via iReport, doit tre le mme que celui du fichier source utilis pour crer le rapport. 11.Dans le champ Temp path, saisissez le chemin d'accs aux fichiers temporaires gnrs durant l'excution du Job. Vous pouvez galement cliquez sur le bouton [...] afin de parcourir votre systme. 12.Saisissez le chemin d'accs au rapport final gnr durant l'excution du Job, dans le champ Destination path. Vous pouvez galement cliquer sur le bouton [...] afin de parcourir votre systme. 13.Saisissez le nom du rapport final gnr durant l'excution du Job, dans le champ File name/Stream. 14.Dans le champ Report type, slectionnez le format du rapport final. 15.Cliquez sur Sync columns afin de rcuprer le schma du composant prcdent. 16.Saisissez le chemin d'accs au fichier d'excution de iReport dans le champ iReport, en remplaant par exemple __IREPORT_PATH__\ par E:\Program Files\Jaspersoft\iReport-4.1.1\bin\. Vous pouvez cliquer sur le bouton Launch afin de lancer iReport. Cette tape n'est pas obligatoire. Cependant, elle vous permet d'accder l'outil iReport pour effectuer les oprations ncessaires, comme la cration d'un modle de rapport, etc. 17.Sauvegardez le Job et appuyez sur F6 pour l'excuter. Le fichier out.pdf est cr l'emplacement spcifi dans le champ Destination path.

152

Guide de Rfrence des Composants Talend Open Studio

tJasperOutputExec

tJasperOutputExec

Proprits du tJasperOutputExec
Ce composant est troitement li l'outil de reporting de Jaspersoft, iReport. Il lit et traite des donnes d'un fichier afin de crer un rapport l'aide d'un modle de rapport .jrxml dfini via iReport. Ce composant permet un gain de performance, car il est la combinaison d'un composant d'entre et d'un composant tJasperOutput. L'utilisation de ces deux composants spars permet de transformer les donnes avant de les utiliser pour gnrer un rapport, avec des sources riches et varies en entre. Famille de composant Fonction Objectif Business gence/Jasper Intelli-

Le composant tJasperOutputExec lit et traite des donnes partir d'un fichier source pour crer un rapport l'aide d'un modle de rapport .jrxml dfini via iReport. Ce composant vous permet d'utiliser l'outil iReport de Jaspersoft afin de crer un rapport dans des formats riches. Il permet un gain de performance, puisqu'il est la combinaison d'un composant d'entre et du composant de sortie tJasperOutput. Jrxml file Source file Record delimiter Destination path Use Default Name Output Name Fichier du modle de rapport cr dans iReport Nom du fichier source. Saisissez votre dlimiteur d'enregistrements. Chemin d'accs au fichier final du rapport.

Basic settings

Output Cochez cette case pour utiliser le nom par dfaut du rapport gnr, c'est--dire le nom du fichier source. Nom du rapport final. Ce champ n'apparat pas si la case Use Default Output Name est coche.

Report type iReport

Type du fichier du rapport final. Editez la commande pour fournir le chemin d'accs au fichier d'excution de iReport, par exemple en remplaant __IREPORT_PATH__\ par E:\Program Files\Jaspersoft\iReport-4.1.1\bin\, ou en saisissant le chemin d'accs complet au fichier d'excution, par exemple "E:\Program Files\Jaspersoft\iReport-4.1.1\bin\iReport.exe". Cliquez sur ce bouton pour lancer iReport.

Launch Advanced settings Utilisation

tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Ce composant est troitement li l'outil de reporting de Jaspersoft, iReport. Il lit et traite des donnes partir d'un fichier source pour crer un rapport l'aide d'un modle de rapport .jrxml dfini via iReport. n/a

Limitation

Scnario associ
Pour un scnario associ, consultez la section intitule Scnario : Gnrer un rapport avec un modle .jrxml .

Guide de Rfrence des Composants Talend Open Studio

153

tLineChart

tLineChart

Proprits du tLineChart
Famille du composant Fonction Objectif Basic settings Business gence/Charts Intelli-

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 le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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. Nom et chemin daccs du fichier image de sortie. Saisissez le titre du graphique en lignes gnrer.

Generated image path Chart title

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.

Image width et Image Saisissez la largeur et la hauteur du fichier image, expriheight mes en pixels. Moving average Cochez cette case afin dafficher la moyenne mobile de chaque srie dans votre graphique en lignes. Lorsque cette

154

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer un graphique en lignes afin de faciliter lanalyse des tendances

case est coche, le champ Period apparat et vous pouvez dfinir la priode dans laquelle apparat la moyenne mobile. Lower bound and Upper Dfinissez quelles sont les plus hautes et les plus basses bound valeurs qui seront affiches sur laxe range. Chart background et Choisissez dans la liste la couleur de fond du graphique Plot background ainsi que la couleur de fond du plan du graphique (zone de lorientation). 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 le Guide Utilisateur Talend Open Studio ainsi que le composant la section intitule tMap .

Guide de Rfrence des Composants Talend Open Studio

155

Scnario : Crer un graphique en lignes afin de faciliter lanalyse des tendances

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.

156

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer un graphique en lignes afin de faciliter lanalyse des tendances

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

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

Guide de Rfrence des Composants Talend Open Studio

157

Scnario : Crer un graphique en lignes afin de faciliter lanalyse des tendances

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

158

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer un graphique en lignes afin de faciliter lanalyse des tendances

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.

Guide de Rfrence des Composants Talend Open Studio

159

Scnario : Crer un graphique en lignes afin de faciliter lanalyse des tendances

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.

160

Guide de Rfrence des Composants Talend Open Studio

tMondrianInput

tMondrianInput

Proprits du tMondrianInput
Famille du composant Fonction Objectif 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 Chemin daccs et nom du fichier contenant les donnes. Username et Password Informations dauthentification de lutilisateur de la base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : le 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. Slectionnez le type dencodage partir de la liste ou choisissez loption Custom pour le dfinir manuellement. Ce champ doit obligatoirement tre renseign. Cochez cette case pour collecter les donnes de log au niveau du composant.

Basic settings

Encoding

Advanced settings Utilisation

tStatCatcher Statistics

Ce composant couvre toutes les possibilits des requtes MDX pour des groupes de donnes multidimensionnels.

Guide de Rfrence des Composants Talend Open Studio

161

Scnario : Tables en jointure croise

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.

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

162

Guide de Rfrence des Composants Talend Open Studio

Scnario : Tables en jointure croise

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 :

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

Guide de Rfrence des Composants Talend Open Studio

163

Scnario : Tables en jointure croise

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

164

Guide de Rfrence des Composants Talend Open Studio

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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. 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

Guide de Rfrence des Composants Talend Open Studio

165

Scnario associ

Username et Password Informations dauthentification de lutilisateur de la base de donnes. Table Nom de la table crer. Vous ne pouvez crer quune seule table la fois.

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 : Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : 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 intitule Cls SCD . Use memory Mode Die on error saving 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.

Advanced settings

Additional JDBC para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. tStatCatcher Statistics Debug mode Cochez cette case pour collecter les donnes de log au niveau du composant. 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 la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

166

Guide de Rfrence des Composants Talend Open Studio

tMysqlSCD

tMysqlSCD

Proprits du tMysqlSCD
Famille de composant Fonction Objectif 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. 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.

Basic settings

Guide de Rfrence des Composants Talend Open Studio

167

Proprits du tMysqlSCD

Username et Password Informations dauthentification de lutilisateur de la base de donnes. Table Action on table Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : 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. 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 : Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide utilisateur de Talend Open Studio. SCD Editor Lditeur SCD Editor permet de construire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section intitule Mthodologie de gestion du SCD . Use memory mode Die on error saving 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.

Advanced settings

Additional JDBC Para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. tStatCatcher Statistics Debug mode Cochez cette case pour collecter les donnes de log au niveau du composant. 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.

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

168

Guide de Rfrence des Composants Talend Open Studio

Proprits du tMysqlSCD

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

Guide de Rfrence des Composants Talend Open Studio

169

Proprits du tMysqlSCD

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 dautocompltion 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 : partir du champ complement, vous pouvez saisir le nom de la squence de la base de donnes (DB Sequence) existante qui va incrmenter automatiquement la colonne indique dans le champ name. 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. 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.

170

Guide de Rfrence des Composants Talend Open Studio

Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3
Ce scnario 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.

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.

Guide de Rfrence des Composants Talend Open Studio

171

Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

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

172

Guide de Rfrence des Composants Talend Open Studio

Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

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

Guide de Rfrence des Composants Talend Open Studio

173

Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

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 [...] ct du champ SCD Editor pour ouvrir lditeur SCD editor et construire le flux de donnes en sortie du SCD.

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. 174 Guide de Rfrence des Composants Talend Open Studio

Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

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. Pour plus dinformations sur les types de SCD, consultez la section intitule Mthodologie de gestion du SCD

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.

Guide de Rfrence des Composants Talend Open Studio

175

Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

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. Adam sest mari, a dmnag Belmont au 2505 Alisson ct. et travaille chez Scoop. Martin travaille dsormais chez Phillips and Brothers.

176

Guide de Rfrence des Composants Talend Open Studio

Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3

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.

Guide de Rfrence des Composants Talend Open Studio

177

tMysqlSCDELT

tMysqlSCDELT

Proprits du tMysqlSCDELT
Famille du composant Fonction Objectif 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 Slectionnez la version de Mysql que vous utilisez. Use an existing connec- Cochez cette case lorsque vous utilisez le composant tion tMysqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Basic settings

Username et Password Informations dauthentification de lutilisateur de base de donnes.

178

Guide de Rfrence des Composants Talend Open Studio

Proprits du tMysqlSCDELT

Source table Table Action on 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.

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 le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide utilisateur de Talend Open Studio. Source Keys Use SCD Type 1 fields Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes. 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. 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.

Use SCD Type 2 fields

Guide de Rfrence des Composants Talend Open Studio

179

Scnario associ

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 tStatCatcher Statistics Utilisation Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. 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 et une connexion de type Row Main.

Scnario associ
Pour un scnario associ, consultez la section intitule tMysqlSCD , ainsi que la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

180

Guide de Rfrence des Composants Talend Open Studio

tOracleSCD

tOracleSCD

Proprits du tOracleSCD
Famille de composant Fonction Objectif 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. 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.

Basic settings

Guide de Rfrence des Composants Talend Open Studio

181

Scnario associ

Database Schema

Nom de la base de donnes. Nom du schma de la base de donnes.

Username et Password Informations dauthentification de lutilisateur de la base de donnes. Table Action on table Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : 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. 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 le Guide utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide utilisateur Talend Open Studio. SCD Editor Lditeur SCD Editor permet de construire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section intitule Mthodologie de gestion du SCD . Use memory Mode Die on error saving 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.

Advanced settings

Additional JDBC para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. tStatCatcher Statistics Debug mode Cochez cette case pour collecter les donnes de log au niveau du composant. 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 la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

182

Guide de Rfrence des Composants Talend Open Studio

tOracleSCDELT

tOracleSCDELT

Proprits du tOracleSCDELT
Famille du composant Fonction Objectif 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 connec- Cochez cette case lorsque vous utilisez le composant tOtion racleConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Connection type DB Version Host Port Database 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.

Basic settings

Guide de Rfrence des Composants Talend Open Studio

183

Proprits du tOracleSCDELT

Username et Password Informations dauthentification de lutilisateur de base de donnes. Source table Table Action on 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. 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 le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide utilisateur de Talend Open Studio. 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 intitule Cls SCD . Source Keys Use SCD Type 1 fields Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes. 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. 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 s-

Use SCD Type 2 fields

184

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

lectionner 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 para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Debug mode Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

tStat Catcher 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 la section intitule tOracleSCD , ainsi que la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

Guide de Rfrence des Composants Talend Open Studio

185

tPaloCheckElements

tPaloCheckElements

Proprits du tPaloCheckElements
Famille de composant Fonction Objectif 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Connection configuration Indisponible lors de lutilisation dune connexion existante Server Port Database Cube Saisissez le numro du port dcoute du serveur Palo. Saisissez le nom de la base de donnes dans laquelle crire les donnes. Saisissez le nom du cube dans lequel les donnes doivent tre crites. Username et Password Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.

Basic settings

186

Guide de Rfrence des Composants Talend Open Studio

Proprits du tPaloCheckElements

On element error

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.

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 le Guide utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide utilisateur Talend Open Studio. Un tableau vous permet de dfinir les lments vrifier. - Column : affiche la (les) colonne(s) du schma dentre. Cette colonne est automatiquement remplie une fois quun schma dentre est saisi ou cr. - Element type : slectionnez le type dlment de la colonne dentre. Seule une colonne peut tre dfinie en tant que Measure. - Default : saisissez la valeur par dfaut qui sera utilise si loption Use default a t slectionne dans le champ On element error . Advanced settings Utilisation Connections tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. 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 le Guide utilisateur Talend Open Studio. Limitation Ce composant fonctionne uniquement avec des cubes Palo de type Normal.

Ce composant requiert un composant dentre.

Guide de Rfrence des Composants Talend Open Studio

187

Scnario associ

Scnario associ
Pour un scnario associ, consultez la section intitule Scnario 2 : Refuser un flux de donnes dentre lorsque les lments crire nexistent pas dans un cube donn .

188

Guide de Rfrence des Composants Talend Open Studio

tPaloConnection

tPaloConnection

Proprits du tPaloConnection
Famille de composant Fonction 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 Advanced settings Utilisation Connections tStatCatcher Statistics Saisissez le nom de lhte ou ladresse IP du serveur hte. Saisissez le numro du port dcoute du serveur Palo. Cochez cette case pour collecter les donnes de log au niveau du composant.

Objectif Basic settings

Username et Password Informations dauthentification de lutilisateur de Palo.

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 le Guide utilisateur Talend Open Studio.

Limitation

n/a

Scnario associ
Pour un scnario associ, consultez la section intitule Scnario : Crer une dimension avec des lments .

Guide de Rfrence des Composants Talend Open Studio

189

tPaloCube

tPaloCube

Proprits du tPaloCube
Famille de composant Fonction Objectif Basic settings 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Database Cube Saisissez le numro du port dcoute du serveur 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. Username et Password Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.

190

Guide de Rfrence des Composants Talend Open Studio

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

Action on cube

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.

Dimension list

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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Global Variables

tStatCatcher Statistics

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

Guide de Rfrence des Composants Talend Open Studio

191

Scnario : Crer un cube dans une base de donnes existante

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

192

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer un cube dans une base de donnes existante

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.

Guide de Rfrence des Composants Talend Open Studio

193

tPaloCubeList

tPaloCubeList

Proprits du tPaloCubeList
Famille de composant Fonction Objectif Basic settings 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Database Advanced settings tStatCatcher Statistics Saisissez le numro du port dcoute du serveur Palo. Saisissez le nom de la base de donnes contenant les cubes dont vous souhaitez rcuprer les informations. Cochez cette case pour collecter les donnes de log au niveau du composant. Username et Password Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.

194

Guide de Rfrence des Composants Talend Open Studio

Dcouvrir le schma de sortie en lecture seule du tPaloCubeList

Utilisation Global Variables

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 le 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 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 Type int string int long long int Description ID interne du cube. Nom du cube. Nombre de dimensions dans le cube. Nombre de cellules lintrieur du cube. Nombre de cellules remplies dans le cube. Statut du cube. Il peut tre :

Guide de Rfrence des Composants Talend Open Studio

195

Scnario : Rcuprer des informations dtailles dun cube dune base de donnes dtermine

Colonne

Type

Description - 0 : non charg - 1 : charg - 2 : chang

Cube_type

int

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.

196

Guide de Rfrence des Composants Talend Open Studio

Scnario : Rcuprer des informations dtailles dun cube dune base de donnes dtermine

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. 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 la section intitule Dcouvrir le schma de sortie en lecture seule du tPaloCubeList .

Guide de Rfrence des Composants Talend Open Studio

197

tPaloDatabase

tPaloDatabase

Proprits du tPaloDatabase
Famille de composant Fonction Objectif Basic settings 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Database Action on database Saisissez le numro du port dcoute du serveur Palo. Saisissez le nom de la base de donnes dans laquelle lopration doit seffectuer. Slectionnez lopration que vous souhaitez effectuer sur le base de donnes: Username et Password Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.

198

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer une 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 le 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 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 : Dposez un composant tPaloDatabase de la Palette dans lespace de modlisation graphique. Double-cliquez sur le composant tPaloDatabase afin douvrir sa vue Component.

Guide de Rfrence des Composants Talend Open Studio

199

Scnario : Crer une base de donnes

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

Guide de Rfrence des Composants Talend Open Studio

tPaloDatabaseList

tPaloDatabaseList

Proprits du tPaloDatabaseList
Famille de composant Fonction Objectif 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Advanced settings tStatCatcher Statistics Saisissez le numro du port dcoute du serveur Palo. Cochez cette case pour collecter les donnes de log au niveau du composant. Username et Password Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.

Basic settings

Guide de Rfrence des Composants Talend Open Studio

201

Dcouvrir le schma de sortie en lecture seule du 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 le 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 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 Type long string int int int 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

202

Guide de Rfrence des Composants Talend Open Studio

Scnario : Rcuprer des informations dtailles concernant les bases de donnes dun serveur Palo donn

Base de donnes Database_types

Type int

Description - 2 = change Type de la base de donnes. - 0 = normal - 1 = system - 3 = user info

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.

Guide de Rfrence des Composants Talend Open Studio

203

Scnario : Rcuprer des informations dtailles concernant les bases de donnes dun serveur Palo donn

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.

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

204

Guide de Rfrence des Composants Talend Open Studio

tPaloDimension

tPaloDimension

Proprits du tPaloDimension
Famille de composant Fonction Objectif Basic settings 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Database Dimension Saisissez le numro du port dcoute du serveur 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. Username et Password Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.

Guide de Rfrence des Composants Talend Open Studio

205

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

Create dimension ele- Cochez cette case pour activer les champs de gestion des ments dimensions et crer des lments de dimension , et crer cette dimension. Les champs ci-des- Dimension type sous sont disponibles uniquement quand la case Create dimenDisponible unision elements est coquement che. lorsque laction effectuer sur la dimension est None. Commit size Slectionnez le type de dimension crer. Le type peut tre : - Normal - User info - System - Attribute Saisissez le nombre dlments qui seront crs avant de les sauvegarder dans la dimension.

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 : Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide utilisateur Talend Open Studio. Consolidation None - Slectionnez ce bouton pour dplacer directement les lments entrants dans la dimension donne. Avec cette option, vous ne dfinissez aucune consolidation ou hiCette option ac- rarchie. tive 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 colonne slectionne seront prises en compte lors du traitement dlments de dimension. type

206

Guide de Rfrence des Composants Talend Open Studio

Proprits du 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. Consolidation Normal - Slectionnez ce bouton pour crer des lments et les consolider dans la dimension donne. Cette consolidation structure les lments crs diffrents niveaux. Cette option 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 colonne 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. Consolidation type Self-referenced - Slectionnez ce bouton pour crer des lments et les structurer partir dune relation parent-enfant. Le flux dentre est responsable du regroupement de la consolidation. type

Guide de Rfrence des Composants Talend Open Studio

207

Proprits du tPaloDimension

Cette option active les champs des paramtres correspondants devant tre renseigns. Elements 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. 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 colonne 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 le 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.

208

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer une dimension avec des lments

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

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.

Guide de Rfrence des Composants Talend Open Studio

209

Scnario : Crer une dimension avec des lments

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.

210

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer une dimension avec des lments

Double-cliquez sur le tMap afin douvrir son diteur.

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.

Guide de Rfrence des Composants Talend Open Studio

211

Scnario : Crer une dimension avec des lments

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

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer une dimension avec des lments

Guide de Rfrence des Composants Talend Open Studio

213

tPaloDimensionList

tPaloDimensionList

Proprits du tPaloDimensionList
Famille de composant Fonction Objectif 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Database Saisissez le numro du port dcoute du serveur Palo. Saisissez le nom de la base de donnes dans laquelle se trouvent les dimensions qui vous intressent. Username et Password Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.

Basic settings

214

Guide de Rfrence des Composants Talend Open Studio

Proprits du tPaloDimensionList

Retrieve cube dimen- Cochez cette case pour rcuprer les informations des disions mensions dun cube existant. Cube Disponible lorsque vous cochez la case Retrieve cube dimensions. 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 : Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : 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. Saisissez le nom du cube duquel les informations concernant les dimensions sont rcupres.

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 le 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 le Guide Utilisateur Talend Open Studio.

Limitation

Le schma de sortie est fixe et en lecture seule.

Guide de Rfrence des Composants Talend Open Studio

215

Dcouvrir le schma de sortie en lecture seule du 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

Type long string string string int int int int int

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

Guide de Rfrence des Composants Talend Open Studio

Scnario: Rcuprer des informations dtailles concernant les dimensions dune base de donnes dtermine

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 intitule Dcouvrir le schma de sortie en lecture seule du tPaloDimensionList .

Guide de Rfrence des Composants Talend Open Studio

217

tPaloInputMulti

tPaloInputMulti

Proprits du tPaloInputMulti
Famille de composant Fonction Objectif Basic settings 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Database Cube Saisissez le numro du port dcoute du serveur Palo. Saisissez le nom de la base de donnes dans laquelle se trouvent les lments qui vous intressent. Saisissez le nom du cube dans lequel les lments de dimension rcuprer sont stocks. Username et Password Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.

218

Guide de Rfrence des Composants Talend Open Studio

Proprits du tPaloInputMulti

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.

Commit size

Saisissez le nombre de lignes de chaque lot rcuprer.

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. 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 : Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide utilisateur Talend Open Studio. 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 Connections tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Liens de sortie (dun composant un autre) : Row : Main Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Liens dentre (dun composant un autre) : Row : Iterate.

Ce composant requiert un composant de sortie.

Guide de Rfrence des Composants Talend Open Studio

219

Scnario : Rcuprer des lments de dimensions dans un cube donn

Trigger : Run if, On Subjob Ok, On Subjob Error, On Component Ok, On Component Error. Pour plus dinformations concernant les connexions, consultez 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

Guide de Rfrence des Composants Talend Open Studio

Scnario : Rcuprer des lments de dimensions dans un cube donn

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.

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.

Guide de Rfrence des Composants Talend Open Studio

221

Scnario : Rcuprer des lments de dimensions dans un cube donn

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.

222

Guide de Rfrence des Composants Talend Open Studio

tPaloOutput

tPaloOutput

Proprits du tPaloOutput
Famille de composant Fonction Objectif Basic settings 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Database Cube Saisissez le numro du port dcoute du serveur Palo. Saisissez le nom de la base de donnes dans laquelle se trouve le cube qui vous intresse. Saisissez le nom du cube dans lequel les donnes entrantes sont crites. Username et Password Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.

Guide de Rfrence des Composants Talend Open Studio

223

Scnario associ

Commit size

Saisissez le nombre de lignes de chaque lot devant tre crit dans le cube.

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 le Guide utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide utilisateur Talend Open Studio. Column as Measure Slectionnez la colonne du flux dentre contenant les valeurs Measure ou Text.

Create element if not Cochez cette case afin de crer llment traiter sil exist nexiste pas. Save cube at process Cochez cette case afin de sauvegarder le cube dans lequel end vous avez crit les donnes la fin du processus. Advanced settings Utilisation Global variable tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant. Number of lines : Indique le nombre de lignes traites. Disponible en tant que variable After. Retourne un entier. Connections 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 le Guide utilisateur Talend Open Studio. Limitation Ce composant ne peut crire quune seule ligne de donnes dans un cube.

Ce composant requiert un composant dentre.

Scnario associ
Pour un scnario associ, consultez la section intitule Scnario 1 : Ecrire des donnes dans un cube donn .

224

Guide de Rfrence des Composants Talend Open Studio

tPaloOutputMulti

tPaloOutputMulti

Proprits du tPaloOutputMulti
Famille de composant Fonction Objectif Basic settings 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Database Cube Saisissez le numro du port dcoute du serveur Palo. Saisissez le nom de la base de donnes dans laquelle se trouve le cube qui vous intresse. Saisissez le nom du cube dans lequel les donnes entrantes sont crites. Username et Password Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.

Guide de Rfrence des Composants Talend Open Studio

225

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

Commit size

Saisissez le nombre de lignes de chaque lot devant tre crit dans le cube.

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 : Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide Utilisateur Talend Open Studio. 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. Add values 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. Cochez cette case pour collecter les donnes de log au niveau du composant. Liens de sortie (dun composant un autre) : Row : Main

Use eventprocessor Die on error

Advanced settings Utilisation Connections

tStatCatcher Statistics

Ce composant requiert un composant de dbut.

226

Guide de Rfrence des Composants Talend Open Studio

Scnario 1 : Ecrire des donnes dans un cube donn

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

Guide de Rfrence des Composants Talend Open Studio

227

Scnario 1 : Ecrire des donnes dans un cube donn

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

228

Guide de Rfrence des Composants Talend Open Studio

Scnario 2 : Refuser un flux de donnes dentre lorsque les lments crire nexistent pas dans un cube donn 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 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.

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.

Guide de Rfrence des Composants Talend Open Studio

229

Scnario 2 : Refuser un flux de donnes dentre lorsque les lments crire nexistent pas dans un cube donn Double-cliquez sur le tFixedFlowInput afin douvrir sa vue Component.

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

230

Guide de Rfrence des Composants Talend Open Studio

Scnario 2 : Refuser un flux de donnes dentre lorsque les lments crire nexistent pas dans un cube donn

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.

Guide de Rfrence des Composants Talend Open Studio

231

Scnario 2 : Refuser un flux de donnes dentre lorsque les lments crire nexistent pas dans un cube donn

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

232

Guide de Rfrence des Composants Talend Open Studio

tPaloRule

tPaloRule

Proprits du tPaloRule
Famille de composant Fonction Objectif Basic settings 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Database Cube Cube rules Saisissez le numro du port dcoute du serveur 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. Remplissez ce tableau afin deffectuer diffrentes actions sur les rgles spcifiques : Username et Password Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.

Guide de Rfrence des Composants Talend Open Studio

233

Scnario : Crer une rgle dans un cube donn

- 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 le Guide Utilisateur Talend Open Studio.

Limitation

La mise jour et la suppression 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 : Dposez un composant tPaloRule de la Palette dans lespace de modlisation graphique. Double-cliquez sur le composant tPaloRule afin douvrir sa vue Component.

234

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer une rgle dans un cube donn

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

Guide de Rfrence des Composants Talend Open Studio

235

Scnario : Crer une rgle dans un cube donn

236

Guide de Rfrence des Composants Talend Open Studio

tPaloRuleList

tPaloRuleList

Proprits du tPaloRuleList
Famille de composant Fonction Objectif Basic settings 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Connection configuration Indisponible lors de lutilisation dune connexion existante. Server Port Database Cube Saisissez le numro du port dcoute du serveur Palo. Saisissez le nom de la base de donnes dans laquelle se trouve le cube qui vous intresse. Saisissez le nom du cube dans lequel les informations de rgles doivent tre retrouves. Username et Password Informations dauthentification de lutilisateur de Palo. Host Name Saisissez le nom de lhte ou ladresse IP du serveur hte.

Guide de Rfrence des Composants Talend Open Studio

237

Dcouvrir le schma de sortie en lecture seule du tPaloRuleList

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 le Guide utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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 le 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 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 composanttPaloRuleList. Base de donnes rule_identifier Type long Description Identifiant interne de la rgle.

238

Guide de Rfrence des Composants Talend Open Studio

Scnario : Rcuprer des informations dtailles concernant des rgles dun cube donn

Base de donnes rule_definition Dimension_attribute_cube rule_extern_id rule_comment rule_activated

Type string string string string boolean

Description Nom de la dimension. 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.

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

Guide de Rfrence des Composants Talend Open Studio

239

Scnario : Rcuprer des informations dtailles concernant des rgles dun cube donn

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 cubeOrders sont rcupres et affiches dans la console de la vue Run.

Pour plus dinformations concernant le schma de sortie, consultez la section intitule Dcouvrir le schma de sortie en lecture seule du tPaloRuleList .

240

Guide de Rfrence des Composants Talend Open Studio

tParAccelSCD

tParAccelSCD

Proprits du tParAccelSCD
Famille du composant Fonction Objectif 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 connec- Cochez cette case si vous utilisez un tParAccelConnection tion. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide utilisateur de votre Studio. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma de la base de donnes.

Basic settings

Username et Password Informations dauthentification de lutilisateur de la base de donnes.

Guide de Rfrence des Composants Talend Open Studio

241

Scnario associ

Table

Nom de la table crer. Vous ne pouvez crer quune seule table la fois.

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 : Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide Utilisateur Talend Open Studio. SCD Editor Lditeur SCD Editor permet de construire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section intitule Mthodologie de gestion du SCD . Use memory Mode Die on error saving 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. Cochez cette case pour collecter les donnes de log au niveau du composant. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

Advanced settings

tStatCatcher Statistics Debug mode

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 la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

242

Guide de Rfrence des Composants Talend Open Studio

tPostgresPlusSCD

tPostgresPlusSCD

Proprits du tPostgresPlusSCD
Famille de composant Databases/Business Intelligence/Postgresplus 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. 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

Guide de Rfrence des Composants Talend Open Studio

243

Scnario associ

Username et Password Informations dauthentification de lutilisateur de la base de donnes. Table Nom de la table crer. Vous ne pouvez crer quune seule table la fois.

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 : Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide Utilisateur Talend Open Studio. SCD Editor Lditeur SCD Editor permet de construire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section intitule Mthodologie de gestion du SCD . Use memory Mode Advanced settings saving Cochez cette case pour amliorer les performances du systme. Cochez cette case pour collecter les donnes de log au niveau du composant. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

tStatCatcher Statistics Debug mode

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 la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

244

Guide de Rfrence des Composants Talend Open Studio

tPostgresPlusSCDELT

tPostgresPlusSCDELT

Proprits du tPostgresPlusSCDELT
Famille du composant Fonction Objectif Databases/Business Intelligence/PostgresPlus 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 connec- Cochez cette case lorsque vous utilisez le composant tion tPostgresPlusConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide utilisateur de votre Studio. Host Port Database Schema Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes. Nom du schma.

Basic settings

Username et Password Informations dauthentification de lutilisateur de base de donnes.

Guide de Rfrence des Composants Talend Open Studio

245

Proprits du tPostgresPlusSCDELT

Source table Table Action on 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.

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 : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide Utilisateur de Talend Open Studio. 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 intitule Cls SCD . Source Keys Use SCD Type 1 fields Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes. 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. 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.

Use SCD Type 2 fields

246

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

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 tStatCatcher Statistics Utilisation Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. 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 et une connexion de type Row Main.

Scnario associ
Pour un scnario associ, consultez la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

Guide de Rfrence des Composants Talend Open Studio

247

tPostgresqlSCD

tPostgresqlSCD

Proprits du tPostgresqlSCD
Famille de composant Databases/Business Intelligence/Postgresql 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 Peut tre Built-in ou Repository. Use an existing connec- Cochez la case et cliquez sur le composant de connexion tion 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. 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

248

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

Username et Password Informations dauthentification de lutilisateur de la base de donnes. Table Nom de la table crer. Vous ne pouvez crer quune seule table la fois.

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 : Guide Utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : 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 intitule Mthodologie de gestion du SCD . Use memory Mode Die on error saving 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. Cochez cette case pour collecter les donnes de log au niveau du composant. Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

Advanced settings

tStatCatcher Statistics Debug mode

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 la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

Guide de Rfrence des Composants Talend Open Studio

249

tPostgresqlSCDELT

tPostgresqlSCDELT

Proprits du tPostgresqlSCDELT
Famille du composant Fonction Objectif Databases/Business Intelligence/Postgresql 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 connec- Cochez cette case lorsque vous utilisez le composant tion tPostgresqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide utilisateur de votre Studio. Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Basic settings

Username et Password Informations dauthentification de lutilisateur de base de donnes. Source table Nom de la table contenant les donnes filtrer.

250

Guide de Rfrence des Composants Talend Open Studio

Proprits du tPostgresqlSCDELT

Table Action on 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.

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 : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide Utilisateur de Talend Open Studio. 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 intitule Cls SCD . Source Keys Use SCD Type 1 fields Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes. 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. 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.

Use SCD Type 2 fields

Guide de Rfrence des Composants Talend Open Studio

251

Scnario associ

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 tStatCatcher Statistics Utilisation Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. 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 et une connexion de type Row Main.

Scnario associ
Pour un scnario associ, consultez la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

252

Guide de Rfrence des Composants Talend Open Studio

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 Fonction Objectif Basic settings Business Intelligence Le composant tSPSSInput lit les donnes de fichiers SPSS (.sav). Le tSPSSInput envoie des donnes SPSS pour les crire, dans un autre fichier par exemple. Sync schema Cliquez sur ce bouton pour synchroniser le schma avec les colonnes du fichier SPSS dentre.

Schema et Edit Schema 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. File name Translate labels 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. 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.

Guide de Rfrence des Composants Talend Open Studio

253

Scnario : Afficher le contenu dun fichier SPSS

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.

Cliquez sur le bouton OK pour fermer la bote de dialogue. Sauvegardez votre Job, et appuyez sur F6 afin de lexcuter.

254

Guide de Rfrence des Composants Talend Open Studio

Scnario : Afficher le contenu dun fichier SPSS

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.

Guide de Rfrence des Composants Talend Open Studio

255

tSPSSOutput

tSPSSOutput

Avant de pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous 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 Fonction Objectif Basic settings Business Intelligence 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 Cliquez sur ce bouton pour synchroniser le schma avec les colonnes du fichier SPSS dentre.

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 : 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 : 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. Cliquez-droit sur le tRowGenerator, et connectez-le au tSPSSOutput, laide dun lien Row Main.

256

Guide de Rfrence des Composants Talend Open Studio

Scnario : Ecrire des donnes dans un fichier .sav

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

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.

Guide de Rfrence des Composants Talend Open Studio

257

Scnario : Ecrire des donnes dans un fichier .sav

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.

258

Guide de Rfrence des Composants Talend Open Studio

tSPSSProperties

tSPSSProperties

Pour pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous 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 Fonction Objectif Basic settings Business Intelligence 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 : 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 : Guide Utilisateur de Talend Open Studio. Filename Advanced settings Utilisation tStatCatcher Statistics Nom ou chemin daccs au fichier SPSS traiter. 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 : la section intitule Scnario : Lire les donnes matre dun hub MDM la section intitule Scnario : Ecrire des donnes dans un fichier .sav

Guide de Rfrence des Composants Talend Open Studio

259

tSPSSStructure

tSPSSStructure

Avant de pouvoir utiliser toutes les fonctionnalits des composants SPSS, assurez-vous 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 Fonction Purpose Business Intelligence 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 : 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 : Guide Utilisateur de Talend Open Studio. Filename Advanced settings Utilisation tStatCatcher Statistics Nom ou chemin daccs au fichier SPSS traiter. Cochez cette case pour collecter les donnes de log au niveau du composant.

Basic settings

Ce composant est utilis comme composant de dbut. Il requiert un composant de sortie.

Scnario associ
Pour des scnarios associs, consultez : la section intitule Scnario : Lire les donnes matre dun hub MDM la section intitule Scnario : Ecrire des donnes dans un fichier .sav

260

Guide de Rfrence des Composants Talend Open Studio

tSybaseSCD

tSybaseSCD

Proprits du tSybaseSCD
Famille du composant Fonction Objectif 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 connec- Cochez la case et cliquez sur le composant de connexion tion 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. Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Basic settings

Username et Password Informations dauthentification de lutilisateur de la base de donnes.

Guide de Rfrence des Composants Talend Open Studio

261

Scnario associ

Table

Nom de la table crer. Vous ne pouvez crer quune seule table la fois.

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 le Guide utilisateur Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide utilisateur Talend Open Studio. SCD Editor Lditeur SCD Editor permet de construire et de configurer les donnes du flux de sortie vers la table Slowly Changing Dimension. Pour plus dinformations, consultez la section intitule Mthodologie de gestion du SCD . Use memory Mode Die on error saving 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.

Advanced settings

Additional JDBC para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. tStatCatcher Statistics Debug mode Cochez cette case pour collecter les donnes de log au niveau du composant. 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 la section intitule Scnario : Traquer des modifications avec les Slowly Changing Dimensions de type 0 3 .

262

Guide de Rfrence des Composants Talend Open Studio

tSybaseSCDELT

tSybaseSCDELT

Proprits du tSybaseSCDELT
Famille du composant Fonction Objectif 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 connec- Cochez cette case lorsque vous utilisez le composant tSytion baseConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Basic settings

Username et Password Informations dauthentification de lutilisateur de base de donnes. Source table Nom de la table contenant les donnes filtrer.

Guide de Rfrence des Composants Talend Open Studio

263

Proprits du tSybaseSCDELT

Table Action on 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.

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 : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide utilisateur de Talend Open Studio. 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 intitule Cls SCD . Source Key Use SCD Type 1 fields Slectionnez une colonne ou plus utiliser en tant que cl(s) pour assurer lunicit des donnes entrantes. 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. 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 slec-

Use SCD Type 2 fields

264

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

tionner 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 para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option n'est pas disponible lorsque vous utilisez l'option Use an existing connection dans les Basic settings. Debug mode tStatCatcher Statistics Utilisation Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. 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 et une connexion de type Row Main.

Scnario associ
Pour un scnario associ, consultez la section intitule tMysqlSCD .

Guide de Rfrence des Composants Talend Open Studio

265

Guide de Rfrence des Composants Talend Open Studio

Composants Cloud
Ce chapitre passe en revue les principaux composants prsents dans la famille Cloud de la Palette de Talend Open Studio. Les bases de donnes, les services de donnes et les applications bases SaaS (CRM, HR, ERP, etc.) hbergs dans des clouds privs et publics se multiplient, accompagns dapplications et de bases de donnes sur site qui constituent le fondement de linformatique dentreprise La famille Cloud 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.

Guide de Rfrence des Composants Talend Open Studio

tAmazonMysqlClose

tAmazonMysqlClose

Proprits du tAmazonMysqlClose
Fonction Objectif Basic settings Le composant tAmazonMysqlClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tAmazonMysqlConnection dans la liste. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

Ce composant doit tre utilis avec des composants AmazonMysql, notamment avec le tAmazonMysqlCommit et le tAmazonMysqlConnection. n/a

Scnario associ
Ce composant est troitement li aux composants tAmazonMysqlConnection et tAmazonMysqlRollback. Il est gnralement utilis avec un composant tAmazonMysqlConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tAmazonMysqlClose, consultez la section intitule tMysqlConnection

268

Guide de Rfrence des Composants Talend Open Studio

tAmazonMysqlCommit

tAmazonMysqlCommit

Proprits du tAmazonMysqlCommit
Ce composant est troitement li aux composants tAmazonMysqlConnection et tAmazonMysqlRollback. Ils sont gnralement utiliss ensemble lors de transactions. Famille de composant Fonction Objectif Cloud/ AmazonRDS/MySQL Le composant AmazontMysqlCommit 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 tAmazonMysqlConnection 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 tAmazonMysqlCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Basic settings

Close connection

Ce composant est gnralement utilis avec des composants AmazonMysql et notamment avec les composants tAmazonMysqlConnection et tAmazonMysqlRollback. n/a

Limitation

Scnario associ
Ce composant est troitement li aux composants tAmazonMysqlConnection et tAmazonMysqlRollback. Ils sont gnralement utiliss avec un composant tAmazonMysqlConnection car il permet douvrir une connexion pour la transaction en cours. Pour plus dinformations relatives au fonctionnement du composant tAmazonMysqlCommit, consultez la section intitule tMysqlConnection .

Guide de Rfrence des Composants Talend Open Studio

269

tAmazonMysqlConnection

tAmazonMysqlConnection

Proprits du tAmazonMysqlConnection
Ce composant est troitement li aux composants tAmazonMysqlCommit et tAmazonMysqlRollback. Ils sont gnralement utiliss avec un composant tAmazonMysqlConnection car il permet douvrir une connexion pour la transaction en cours. Famille de composant Fonction Objectif Basic settings Cloud/ AmazonRDS/MySQL Le composant tAmazonMysqlConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction. Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version Host Port Database MySQL 5 est disponible. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Additional JDBC para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Username et Password Informations dauthentification de lutilisateur de base de donnes. Use or register a shared Cochez cette case pour partager votre connexion ou rcuDB Connection prer 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. Utilisation Limitation Ce composant est gnralement utilis avec des composants AmazonMysql, notamment les composants tAmazonMysqlCommit and tAmazonMysqlRollback. n/a

Scnario associ
Pour un scnario associ, consultez la section intitule Scnario : Insrer des donnes dans des tables mre/fille .

270

Guide de Rfrence des Composants Talend Open Studio

tAmazonMysqlInput

tAmazonMysqlInput

Proprits du tAmazonMysqlInput
Famille de compo- Cloud/ sant AmazonRDS/MySQL Fonction Objectif Le composant tAmazonMysqlInput lit une base de donnes et en extrait des champs laide de requtes. Le tAmazonMysqlInput 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. DB Version MySQL 5 est disponible. Use an existing Cochez cette case lorsque vous utilisez le composant tAmazonMysconnection qlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide utilisateur de Talend Open Studio. Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Basic settings

Username et Pass- Informations dauthentification de lutilisateur de base de donnes. word

Guide de Rfrence des Composants Talend Open Studio

271

Scnarios associs

Schema Schema

et

Edit Un schma est une description de lignes, i.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 le Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide utilisateur de Talend Open Studio.

Table Name

Nom de la table lire.

Query type et Query Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Advanced settings Additional parameters JDBC Spcifiez des informations supplmentaires de connexion la base de donnes cre. Cette option est disponible lorsque la case Use an existing connection est dcoche dans les Basic settings. Lorsque vous devez traiter des donnes au format date/heure 0000-00-00 00:00:00 utilisant ce composant, dfinissez les paramtres comme suit : noDatetimeStringSync=true&zeroDateTimeBehavior=convertToNull. Enable stream Cochez cette case pour dterminer avec quelles lignes vous souhaitez travailler. Cette option permet damliorer les performances.

Trim all the String/ Cochez cette case pour supprimer les espaces en dbut et en fin de Char columns champ dans toutes les colonnes contenant des chanes de caractres. Trim column Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes. Dcochez Trim all the String/Char columns pour activer le tableau Trim column. tStatCatcher Statis- Cochez cette case pour collecter les donnes de log au niveau du tics composant. Usage Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes MySQL.

Scnarios associs
Pour des scnarios associs, consultez la section intitule tMysqlInput .

272

Guide de Rfrence des Composants Talend Open Studio

tAmazonMysqlOutput

tAmazonMysqlOutput

Proprits du tAmazonMysqlOutput
Famille de composant Fonction Objectif Basic settings Cloud/ AmazonRDS/MySQL Le composant tAmazonMysqlOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tAmazonMysqlOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version MySQL 5 est disponible. Use an existing connec- Cochez cette case lorsque vous utilisez le composant tAtion mazonMysqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide utilisateur de Talend Open Studio. Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Username et Password Informations dauthentification de lutilisateur de base de donnes

Guide de Rfrence des Composants Talend Open Studio

273

Proprits du tAmazonMysqlOutput

Table Action on table

Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : Default : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. Truncate table : supprimer rapidement le contenu de la table, mais sans possibilit de Rollback.

Action on data

Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre. Insert or update on duplicate key or unique index : Ajouter des entres si la valeur insre n'existe pas ou mettre jour les entres si la valeur insre existe dj et quun risque de violation dune cl unique se prsente. Insert ignore : Ajouter uniquement de nouvelles lignes afin dempcher les erreurs de doublons de cls. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete . Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour cela, cochez la case Use field options et slectionnez la case Key in update correspondant

274

Guide de Rfrence des Composants Talend Open Studio

Proprits du tAmazonMysqlOutput

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 le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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.

Advanced settings

Additional JDBC para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option est disponible lorsque la case Use an existing connection est dcoche dans les Basic settings. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Extend Insert Cochez cette case pour insrer un ensemble de lignes dfinies au lieu dinsrer les lignes une par une. Cette option permet un important gain de performance. Number of rows per insert : saisissez le nombre de lignes insrer en un bloc. Notez que si vous slectionnez un nombre important de lignes, cela peut augmenter la quantit de mmoire utilise et donc diminuer les performances. Cette option nest pas compatible avec le lien Reject. Vous devez donc la dcocher si vous utilisez un lien Reject en sortie du composant. Si vous utilisez ce composant avec un tMysqlLastInsertID , soyez sr de dcocher la case Extend Insert dans la vue Advanced Settings . Extend Insert permet le chargement par lots, cependant, si la case est coche, seul l'ID de la dernire ligne du dernier lot sera retourn. 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 In-

Guide de Rfrence des Composants Talend Open Studio

275

Proprits du tAmazonMysqlOutput

sert Query ou Delete dans le champ Action on data. 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 tAmazonMysqlOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier. Use field options Use Hint Options Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case pour activer la zone de configuration des indicateurs (ou Hints) permettant doptimiser lexcution dune requte. Dans cette zone, les paramtres sont : - HINT : spcifiez lindicateur dont vous avez besoin, en utilisant la syntaxe /*+ */ - POSITION : spcifiez la place de lindicateur dans une instruction SQL. - SQL STMT : slectionnez linstruction SQL que vous souhaitez utiliser. Enable debug mode Cochez cette case pour afficher chaque tape du processus dcriture dans la base de donnes.

Additional Columns

Use duplicate key up- Met jour les valeurs des colonnes spcifies en cas de date mode insert doublon de la cl primaire. Column : Saisissez entre guillemets le nom de la colonne mettre jour. Value : Saisissez lopration que vous souhaitez effectuer sur la colonne. Pour utiliser cette option, vous devez pralablement slectionner le mode Insert dans la liste Action on data de la vue Basic settings. tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

276

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

Utilisation

Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Ce composant doit tre utilis en tant que composant de sortie. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes MySQL. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation du tAmazonMysqlOutput, consultez la section intitule Scnario 3 : Rcuprer les donnes errones laide dun lien Reject .

Scnarios associs
Pour des scnarios associs, consultez la section intitule tMysqlSCD .

Guide de Rfrence des Composants Talend Open Studio

277

tAmazonMysqlRollback

tAmazonMysqlRollback

Proprits du tAmazonMysqlRollback
Ce composant est troitement li aux composants tAmazonMysqlCommit et tAmazonMysqlConnection. Ils sont gnralement utiliss ensemble lors dune transaction. Famille de composant Fonction Objectif Basic settings Cloud/ AmazonRDS/Mysql Le composant tAmazonMysqlRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Close connection Advanced settings Utilisation tStatCatcher Statistics Slectionnez le composant tAmazonMysqlConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Cochez cette case pour collecter les donnes de log au niveau du composant.

Ce composant est gnralement utilis avec dautres composants AmazonMySQL, notamment les composants tAmazonMysqlConnection et tAmazonMysqlCommit. n/a

Limitation

Scnario associ
Pour un scnario associ, consultez la section intitule Scnario : Annuler linsertion de donnes dans des tables mre/fille .

278

Guide de Rfrence des Composants Talend Open Studio

tAmazonMysqlRow

tAmazonMysqlRow

Proprits du tAmazonMysqlRow
Famille de composant Fonction Cloud/Amazon/MySQL Le composant tAmazonMysqlRow 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, le tAmazonMysqlRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. DB Version MySQL 5 est disponible. Use an existing connec- Cochez cette case lorsque vous utilisez le composant tAtion mazonMysqlConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide utilisateur de votre Studio. Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Objectif

Basic settings

Guide de Rfrence des Composants Talend Open Studio

279

Proprits du tAmazonMysqlRow

Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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. 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.

Query

Die on error

Advanced settings

Additional JDBC para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option est disponible lorsque la case Use an existing connection est dcoche dans les Basic settings. Propagate QUERYs re- Cochez cette case pour insrer les rsultats de la requte cordset dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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.

280

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

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. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics Utilisation

Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL.

Scnarios associs
Pour des scnarios associs, consultez la section intitule tMysqlRow

Guide de Rfrence des Composants Talend Open Studio

281

tAmazonOracleClose

tAmazonOracleClose

Proprits du tAmazonOracleClose
Fonction Objectif Basic settings Le composant tAmazonOracleClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes AmazonOracle. Component list Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tAmazonOracleConnection dans la liste. Cochez cette case pour collecter les donnes de log au niveau du composant.

Advanced settings Utilisation Limitation

tStatCatcher Statistics

Ce composant est gnralement utilis avec d'autres composants AmazonOracle, notamment tAmazonOracleConnection et tAmazonOracleCommit. n/a

Scnario associ
Ce composant est troitement li aux composants tAmazonOracleConnection et tAmazonOracleRollback. Il est gnralement utilis avec un composant tAmazonOracleConnection car il permet de fermer une connexion pour la transaction en cours. Pour un scnario associ au composant tAmazonOracleClose, consultez la section intitule tMysqlConnection .

282

Guide de Rfrence des Composants Talend Open Studio

tAmazonOracleCommit

tAmazonOracleCommit

Proprits du tAmazonOracleCommit
Ce composant est troitement li aux composants tAmazonOracleConnection et tAmazonOracleRollback. Ils sont gnralement utiliss ensemble lors de transactions. Famille de composant Fonction Objectif Cloud/ AmazonRDS/Oracle Le composant tAmazonOracleCommit 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 tAmazonOracleConnection dans la liste. Cette option est coche par dfaut. Elle permet de fermer la connexion la base de donnes une fois le commit effectu. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Si vous utilisez un lien de type Row > Main pour relier le tOracleCommit votre Job, vos donnes seront commites ligne par ligne. Dans ce cas, ne cochez pas la case Close connection car la connexion sera ferme avant la fin du commit de votre premire ligne. Advanced settings Utilisation Limitation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Basic settings

Close Connection

Ce composant est gnralement utilis avec des composants AmazonOracle et notamment tAmazonOracleConnection et tAmazonOracleRollback. n/a

Scnario associ
Ce composant est troitement li aux composants tAmazonOracleConnection et tAmazonOracleRollback. Ils sont gnralement utiliss avec un composant tAmazonOracleConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tAmazonOracleCommit, consultez la section intitule tMysqlConnection .

Guide de Rfrence des Composants Talend Open Studio

283

tAmazonOracleConnection

tAmazonOracleConnection

Proprits du tAmazonOracleConnection
Ce composant est troitement li aux composants tAmazonOracleCommit et tAmazonOracleRollback. Ils sont gnralement utiliss avec un composant tOracleConnection car il permet douvrir une connexion pour la transaction en cours. Famille de composant Fonction Objectif Basic settings Cloud/ AmazonRDS/Oracle Le composant tAmazonOracleConnection ouvre une connexion vers une base de donnes afin deffectuer une transaction Ce composant permet de commiter les donnes dun Job entier en une seule transaction vers une base de donnes de sortie. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Connection type Liste droulante des pilotes disponibles : Oracle SID : Slectionnez ce type de connexion pour identifier exclusivement une base de donnes spcifique sur un systme. DB Version Use tns file Oracle 11-5 est disponible. Cochez cette case pour utiliser les mtadonnes dun contexte contenu dans un fichier tns. Un mme fichier Tns peut contenir plusieurs contextes. TNS File : Renseignez manuellement le chemin daccs ou cliquez sur le bouton [...] pour parcourir vos dossiers jusquau fichier Tns utiliser. Select a DB Connection in Tns File : Cliquez sur le bouton [...] pour afficher tous les contextes du fichier Tns et slectionner celui utiliser. Host Port Database Schema 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

Username et Password Informations dauthentification de lutilisateur de base de donnes. Additional JDBC para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre.

284

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

Dans ce champ, vous pouvez paramtrer le type dencodage. Use or register a shared Cochez cette case pour partager votre connexion ou rcuDB Connection prer 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. Usage Limitation Ce composant est gnralement utilis avec des composants AmazonOracle, notamment les composants tAmazonOracleCommit et tAmazonOracleRollback. n/a

Scnario associ
Ce composant est troitement li aux composants tAmazonOracleCommit et tAmazonOracleRollback. Ils sont gnralement utiliss avec un composant tAmazonOracleConnection car il permet douvrir une connexion pour la transaction en cours. Pour un scnario associ au composant tAmazonOracleConnection, consultez la section intitule tMysqlConnection .

Guide de Rfrence des Composants Talend Open Studio

285

tAmazonOracleInput

tAmazonOracleInput

Proprits du tAmazonOracleInput
Famille de composant Fonction Objectif Cloud/ AmazonRDS/Oracle Le composant tAmazonOracleInput lit une base de donnes et en extrait des champs laide de requtes. Le tAmazonOracleInput excute une requte de base de donnes dans laquelle lordre doit strictement correspondre lordre dfini dans le schma. Puis la liste des champs est transmise au composant via une connexion Main Row. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionne le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Connection type Liste droulante des pilotes disponibles : Oracle SID : Slectionnez ce type de connexion pour identifier exclusivement une base de donnes spcifique sur in systme. DB Version Slectionnez la version dOracle que vous utilisez. Use an existing connec- Cochez cette case lorsque vous utilisez un composant tAtion mazonOracleConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide utilisateur de votre Studio.

Basic settings

286

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

Host Port Database Oracle 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 Oracle.

Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in: Le schma sera cr et conserv pour ce composant seulement. Voir galement le Guide utilisateur de Talend Open Studio. Repository: Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide utilisateur de Talend Open Studio. Table name Query type and Query Nom de la table de base de donnes. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma. Cochez cette case pour collecter les donnes de log au niveau du composant. Cochez cette case et dfinissez le nombre de lignes avec lesquelles vous souhaitez travailler en une fois. Cette option permet doptimiser les performances.

Advanced settings

tStatCatcher Statistics Use cursor

Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et columns en fin de champ dans toutes les colonnes contenant des chanes de caractres. Trim column Usage Supprimer les espaces en dbut et en fin de champ dans les colonnes slectionnes.

Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes AmazonOracle.

Scnarios associs
Pour des scnarios associs, consultez : Le premier scnario du composant tDBInput, la section intitule Scnario 1 : Afficher les donnes slectionnes partir dune table . Le second scnario du composant tDBInput, la section intitule Scnario 2 : Utiliser la variable StoreSQLQuery . Le scnario du composant tContextLoad, la section intitule Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL .

Guide de Rfrence des Composants Talend Open Studio

287

tAmazonOracleOutput

tAmazonOracleOutput

Proprits du tAmazonOracleOutput
Famille de composant Fonction Objectif Basic settings Cloud/ AmazonRDS/Oracle Le composant tAmazonOracleOutput crit, met jour, modifie ou supprime les donnes dune base de donnes. Le tAmazonOracleOutput excute laction dfinie sur la table et/ou sur les donnes dune table, en fonction du flux entrant provenant du composant prcdent. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connec- Cochez cette case lorsque vous utilisez le composant tAtion mazonOracleConnection. Lorsque vous la dcochez, une case (coche par dfaut, suivie dun champ) apparat dans les Advanced settings, Batch Size, qui vous permet de saisir le nombre de lignes dans chaque lot de traitement de donnes. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide utilisateur de votre Studio Connection type Liste droulante des pilotes disponibles :

288

Guide de Rfrence des Composants Talend Open Studio

Proprits du tAmazonOracleOutput

Oracle SID : Slectionnez ce type de connexion pour identifier exclusivement une base de donnes spcifique sur un systme. DB Version Host Port Database 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.

Username et Password Informations dauthentification de lutilisateur de la base de donnes. Oracle schema Table Action on table Nom du schma Oracle. Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : Default : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Drop a table if exists and create : supprimer la table si elle existe dj, puis en crer une nouvelle. Clear a table : supprimer le contenu de la table. 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 correspondant au flux dentre. Il est ncessaire de spcifier au minimum une colonne comme cl primaire sur laquelle baser les oprations Update et Delete . Pour cela, cliquez sur le bouton [...] ct du champ Edit Schema et cochez la ou les case(s) correspondant la ou aux colonne(s) que vous souhaitez dfinir comme cl(s) primaire(s). Pour une utilisation avance, cliquez sur longlet Advanced settings pour dfinir simultanment les cls primaires sur lesquelles baser les oprations de mise jour (Update) et de suppression (Delete). Pour

Guide de Rfrence des Composants Talend Open Studio

289

Proprits du tAmazonOracleOutput

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 le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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.

Advanced settings

Additional JDBC para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option est disponible lorsque la case Use an existing connection est dcoche dans les Basic settings. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Override any exis- Cochez cette case pour craser les ting NLS_LANG envi- d'environnement NLS_LANG dj dfinies. ronment variable Commit every variables

Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cochez cette case pour collecter les donnes de log au niveau du composant. Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence.

tStatCatcher Statistics Additional Columns

290

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

Reference column : Saisissez une colonne de rfrence que le composant tOracleOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier. Use field options Use Hint Options Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes. Cochez cette case afin d'activer la configuration de la zone des Hints, vous permettant ainsi d'optimiser l'excution d'une requte. Dans cette zone, les paramtres sont : - HINT : spcifiez l'hint dont vous avez besoin, l'aide de la syntaxe /*+ */. -POSITION : spcifiez o mettre l'hint dans une instruction SQL. - SQL STMT : slectionnez l'instruction SQL que vous souhaitez utiliser. Convert columns and Cochez cette case pour passer les noms de colonnes et de table to uppercase tables en majuscule. Enable debug mode Use Batch Size Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes. Nombre de lignes dans chaque lot de traitement de donnes. Si cette case napparat pas, vrifiez que la case Use an existing connection dans les Basic settings est dcoche. Support null in SQL Cochez cette case pour prendre en compte les valeurs Null WHERE statement lors dune instruction WHERE. Utilisation Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. Ce composant doit tre utilis en tant que composant de sortie. Il permet de faire des actions sur une table ou les donnes dune table dune base de donnes AmazonOracle. Il permet aussi de crer un flux de rejet avec un lien Row > Reject filtrant les donnes en erreur. Pour un exemple dutilisation, consultez la section intitule Scnario 3 : Rcuprer les donnes errones laide dun lien Reject du composant tMysqlOutput.

Scnarios associs
Pour des scnarios associs au composant tAmazonOracleOutput, consultez : tDBOutput : la section intitule Scnario : Afficher la base de donnes en sortie tMysqlOutput : la section intitule Scnario 1 : Ajouter une colonne et modifier les donnes .

Guide de Rfrence des Composants Talend Open Studio

291

tAmazonOracleRollback

tAmazonOracleRollback

Proprits du tAmazonOracleRollback
Ce composant est troitement li aux composants tAmazonOracleCommit et tAmazonOracleConnection. Ils sont gnralement utiliss ensemble lors dune transaction. Famille de composant Fonction Objectif Basic settings Cloud/ AmazonRDS/Oracle Le composant tAmazonOracleRollback annule la transaction dans une base de donnes connecte. Ce composant vite le commit de transaction involontaire. Component list Close Connection Advanced settings Utilisation tStatCatcher Statistics Slectionnez le composant AmazontOracleConnection dans la liste sil y a plus dune connexion dans votre Job. Dcochez cette case pour continuer utiliser la connexion une fois que le composant a excut sa tche. Cochez cette case pour collecter les donnes de log au niveau du composant.

Ce composant est gnralement utilis avec dautres composants AmazonOracle, notamment les composants tAmazonOracleConnection et tAmazonOracleCommit. n/a

Limitation

Scnario associ
Ce composant est troitement li aux composants tAmazonOracleConnection et tAmazonOracleCommit. Ils sont gnralement utiliss ensemble lors dune transaction. Pour un scnario associ au composant tAmazonOracleRollback, consultez la section intitule tMysqlRollback .

292

Guide de Rfrence des Composants Talend Open Studio

tAmazonOracleRow

tAmazonOracleRow

Proprits du tAmazonOracleRow
Famille de composant Fonction Cloud/ AmazonRDS/Oracle Le composant tAmazonOracleRow 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, le tAmazonOracleRow agit sur la structure mme de la base de donnes ou sur les donnes (mais sans les manipuler). Le SQLBuilder peut vous aider rapidement et aisment crire vos requtes. Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Use an existing connec- Cochez cette case lorsque vous utilisez le composant tAtion mazonOracleConnection. Lorsquun Job contient un Job parent et un Job enfant, la liste Component List prsente uniquement les composants de connexion du Job du mme niveau. Si vous souhaitez utiliser une connexion existant dans un autre niveau, vrifiez que les composants de connexion disponibles partagent la mme connexion. Pour plus dinformations concernant le partage dune connexion travers diffrents niveaux de Jobs, consultez Use or register a shared DB connection dans tous les composants de base de donnes que vous utilisez. Sinon, vous pouvez galement dsactiver le composant de connexion et utiliser les Dynamic settings du composant, afin de paramtrer manuellement la connexion. Dans ce cas, vrifiez que le nom de la connexion est unique et distinct tout au long des deux niveaux de Jobs. Pour plus dinformations concernant les paramtres dynamiques (Dynamic settings), consultez le Guide utilisateur de votre Studio. Connection type Host Port Database Liste droulante des pilotes disponibles. Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Objectif

Basic settings

Guide de Rfrence des Composants Talend Open Studio

293

Proprits du tAmazonOracleRow

Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide utilisateur de Talend Open Studio. Query type Peut tre Built-in ou Repository. Built-in : Saisissez manuellement votre requte ou construisez-la laide de SQLBuilder. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement. 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.

Die on error

Advanced settings

Propagate QUERYs re- Cochez cette case pour insrer les rsultats de la requte cordset dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics

294

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

Utilisation

Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL.

Scnarios associs
Pour des scnarios associs, consultez : tDBSQLRow: la section intitule Scnario : Rinitialiser lauto-incrmentation dune base de donnes . tMySQLRow: la section intitule Scnario 1 : Supprimer et re-gnrer un index de table MySQL .

Guide de Rfrence des Composants Talend Open Studio

295

tMarketoInput

tMarketoInput

Le composant tMarketoInput appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tMarketoInput .

296

Guide de Rfrence des Composants Talend Open Studio

tMarketoListOperation

tMarketoListOperation

Le composant tMarketoListOperation appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tMarketoListOperation .

Guide de Rfrence des Composants Talend Open Studio

297

tMarketoOutput

tMarketoOutput

Le composant tMarketoOutput appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tMarketoOutput .

298

Guide de Rfrence des Composants Talend Open Studio

tSalesforceBulkExec

tSalesforceBulkExec

Le composant tSalesforceBulkExec appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tSalesforceBulkExec .

Guide de Rfrence des Composants Talend Open Studio

299

tSalesforceConnection

tSalesforceConnection

Le composant tSalesforceConnection appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tSalesforceConnection .

300

Guide de Rfrence des Composants Talend Open Studio

tSalesforceGetDeleted

tSalesforceGetDeleted

Le composant tSalesforceGetDeleted appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tSalesforceGetDeleted .

Guide de Rfrence des Composants Talend Open Studio

301

tSalesforceGetServerTimestamp

tSalesforceGetServerTimestamp

Le composant tSalesforceGetServerTimestamp appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tSalesforceGetServerTimestamp .

302

Guide de Rfrence des Composants Talend Open Studio

tSalesforceGetUpdated

tSalesforceGetUpdated

Le composant tSalesforceGetUpdated appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tSalesforceGetUpdated .

Guide de Rfrence des Composants Talend Open Studio

303

tSalesforceInput

tSalesforceInput

Le composant tSalesforceInput appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tSalesforceInput .

304

Guide de Rfrence des Composants Talend Open Studio

tSalesforceOutput

tSalesforceOutput

Le composant tSalesforceOutput appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tSalesforceOutput .

Guide de Rfrence des Composants Talend Open Studio

305

tSalesforceOutputBulk

tSalesforceOutputBulk

Le composant tSalesforceOutputBulk appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tSalesforceOutputBulk .

306

Guide de Rfrence des Composants Talend Open Studio

tSalesforceOutputBulkExec

tSalesforceOutputBulkExec

Le composant tSalesforceOutputBulkExec appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tSalesforceOutputBulkExec .

Guide de Rfrence des Composants Talend Open Studio

307

tSugarCRMInput

tSugarCRMInput

Le composant tSugarCRMInput appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tSugarCRMInput .

308

Guide de Rfrence des Composants Talend Open Studio

tSugarCRMOutput

tSugarCRMOutput

Le composant tSugarCRMOutput appartient deux familles diffrentes : Business et Cloud. Pour plus dinformations, consultez la section intitule tSugarCRMOutput .

Guide de Rfrence des Composants Talend Open Studio

309

Guide de Rfrence des 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.

Guide de Rfrence des Composants Talend Open Studio

tGroovy

tGroovy

Proprits du tGroovy
Famille de composant Fonction Objectif Basic settings Custom Code Le tGroovy permet de saisir du code personnalis afin de lintgrer dans le programme Talend. Ce code est excut une seule fois. Le tGroovy permet dtendre les fonctionnalits du Job Talend grce au langage Groovy, qui est une syntaxe simplifie du Java.. Groovy Script Variables Saisissez le code Groovy que vous souhaitez excuter. Ce tableau comprend deux colonnes : Name : nom de la variable appele dans le code. Value : valeur associe cette variable. Advanced settings Utilisation Limitation 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 sous-job un seul composant. Il est ncessaire de connatre le langage Groovy.

Scnarios associs
Pour un scnario utilisant du Code Groovy, consultez la section intitule Scnario : Appeler du code Groovy contenu dans un fichier . Pour un exemple dutilisation proche dans le mode de fonctionnement, consultez la section intitule Scnario : Imprimer le contenu dune variable du composant tJava.

312

Guide de Rfrence des Composants Talend Open Studio

tGroovyFile

tGroovyFile

Proprits du tGroovyFile
Famille de composant Fonction Objectif Basic settings Custom Code 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. Advanced settings Utilisation Limitation 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 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.

Guide de Rfrence des Composants Talend Open Studio

313

Scnario : Appeler du code Groovy contenu dans un fichier

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.

314

Guide de Rfrence des Composants Talend Open Studio

tJava

tJava

Proprits du tJava
Famille de composant Fonction Objectif Basic settings Custom Code 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/]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.

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.

Guide de Rfrence des Composants Talend Open Studio

315

Scnario : Imprimer le contenu dune variable

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.

316

Guide de Rfrence des Composants Talend Open Studio

Scnario : Imprimer le contenu dune variable

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.

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

Guide de Rfrence des Composants Talend Open Studio

317

tJavaFlex

tJavaFlex

Proprits du tJavaFlex
Famille de composant Fonction Custom Code 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 : 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 : Guide Utilisateur de Talend Open Studio. Data Auto Propagate Start code Main code End code Advanced settings Import Cochez cette case pour propager automatiquement les donnes au composant suivant. 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

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

318

Guide de Rfrence des Composants Talend Open Studio

Scnario 1 : Gnrer un flux de donnes

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.

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.

Guide de Rfrence des Composants Talend Open Studio

319

Scnario 1 : Gnrer un flux de donnes

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.

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.

320

Guide de Rfrence des Composants Talend Open Studio

Scnario 2 : Traiter des lignes de donnes avec le tJavaFlex

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.

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.

Guide de Rfrence des Composants Talend Open Studio

321

Scnario 2 : Traiter des lignes de donnes avec le tJavaFlex

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;

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.

322

Guide de Rfrence des Composants Talend Open Studio

Scnario 2 : Traiter des lignes de donnes avec le tJavaFlex

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.

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

Guide de Rfrence des Composants Talend Open Studio

323

tJavaRow

tJavaRow

Proprits du tJavaRow
Famille de composant Fonction Custom Code 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 : 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 : Guide utilisateur de Talend Open Studio. Code Advanced settings Import 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

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.

324

Guide de Rfrence des Composants Talend Open Studio

tLibraryLoad

tLibraryLoad

Proprits du tLibraryLoad
Famille de composant Fonction Objectif Basic settings Custom Code 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

Ce composant peut tre utilis en standalone, mais il est plus logique de lutiliser dans un Job. n/a

Limitation

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. Reliez le tLibraryLoad au tJava laide dun lien Trigger > OnSubjobOk.

Guide de Rfrence des Composants Talend Open Studio

325

Scnario : Vrifier le format dune adresse e-mail

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.

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

326

Guide de Rfrence des Composants Talend Open Studio

tSetGlobalVar

tSetGlobalVar

Proprits du tSetGlobalVar
Famille de composant Fonction Objectif Basic settings Custom Code 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. Advanced settings Utilisation Limitation 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 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.

Guide de Rfrence des Composants Talend Open Studio

327

Scnario : Afficher le contenu dune variable globale

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.

328

Guide de Rfrence des 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.

Guide de Rfrence des Composants Talend Open Studio

tAddCRCRow

tAddCRCRow

Proprits du tAddCRCRow
Famille de composant Fonction Objectif Basic settings Data Quality Ce composant calcule une cl de substitution base sur une ou plusieurs colonne(s) et lajoute au schma dfini. Fournir un ID unique afin damliorer la qualit des donnes traites. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement le 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 le 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. Connectez-les en utilisant un lien de type Main row.

330

Guide de Rfrence des Composants Talend Open Studio

Scnario : Ajouter une cl de substitution un fichier

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

Guide de Rfrence des Composants Talend Open Studio

331

Scnario : Ajouter une cl de substitution un fichier

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

332

Guide de Rfrence des Composants Talend Open Studio

tChangeFileEncoding

tChangeFileEncoding

Le tChangeFileEncoding appartient deux familles : Data Quality et File. Pour plus dinformations concernant le composant tChangeFileEncoding, consultez la section intitule tChangeFileEncoding .

Guide de Rfrence des Composants Talend Open Studio

333

tExtractRegexFields

tExtractRegexFields

Le tExtractRegexFields appartient deux familles : Data Quality et Processing. Pour plus dinformations concernant le composant tExtractRegexFields, consultez la section intitule tExtractRegexFields .

334

Guide de Rfrence des Composants Talend Open Studio

tFuzzyMatch

tFuzzyMatch

Proprits du tFuzzyMatch
Famille de composant Fonction Data Quality 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 le 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 le 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. 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.

Objectif Basic settings

Guide de Rfrence des Composants Talend Open Studio

335

Scnario 1 : Distance de Levenshtein de 0 pour les prnoms

Max distance

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

Matching column

Unique matching

Matching item separa- Si plusieurs correspondances sont disponibles, elles setor ront toutes affiches sauf si la case Unique match est coche. Dfinissez le dlimiteur entre chaque correspondance. Utilisation Ce composant nest pas un composant de dbut (fond vert) et il ncessite deux composants dentre et un composant de sortie.

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

336

Guide de Rfrence des Composants Talend Open Studio

Scnario 1 : Distance de Levenshtein de 0 pour les prnoms

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.

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.

Guide de Rfrence des Composants Talend Open Studio

337

Scnario 2 : Distance de Levenshtein de 1 ou 2 pour les prnoms

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 la section intitule Scnario 2 : Distance de Levenshtein de 1 ou 2 pour les prnoms

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.

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. Enregistrez votre nouveau Job et appuyez sur F6 pour lexcuter.

338

Guide de Rfrence des Composants Talend Open Studio

Scnario 3 : Distance mtaphonique pour les prnoms

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. Enregistrez le Job et appuyez sur F6. La valeur phontique est affiche avec les correspondances possibles.

Guide de Rfrence des Composants Talend Open Studio

339

tIntervalMatch

tIntervalMatch

Proprits du tIntervalMatch
Famille de composant Fonction Data Quality Le composant tIntervalMatch permet dtablir une jointure entre un flux principal et un flux de rfrence (Java). 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 le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le Guide utilisateur de Talend Open Studio. Search column Slectionnez la colonne du flux principal contenant les valeurs qui doivent tre mises en correspondance avec lintervalle de valeurs. Slectionnez la colonne du flux lookup contenant les valeurs qui doivent tre retournes quand la jointure est ok.

Objectif Basic settings

Column (LOOKUP)

Lookup Column min/ Slectionnez la colonne contenant la valeur minimale de bounds strictly (min) lintervalle. Cochez la case si la limite est stricte. Lookup Column max/ Slectionnez la colonne contenant la valeur maximale de bounds strictly (max) lintervalle. Cochez la case si la limite est stricte 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 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

Scnario : Identifier le pays partir de lIP


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, et contient une liste classe dintervalles dIP

340

Guide de Rfrence des Composants Talend Open Studio

Scnario : Identifier le pays partir de lIP

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.

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. Configurez la colonne Type en String pour la colonne Document et en Integer pour la colonne IP. Configurez maintenant les proprits du deuxime tFileInputDelimited.

Noubliez pas de dfinir le Type des donnes. Propagez le schma du flux principal entrant au composant tIntervalMatch.

Guide de Rfrence des Composants Talend Open Studio

341

Scnario : Identifier le pays partir de lIP

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.

Configurez les autres proprits du tIntervalMatch, notamment les colonnes min et max correspondant aux limites de lintervalle.

Dans le champ Column Lookup, slectionnez la colonne dans laquelle les valeurs devront tre retournes. Dans le champ Search column, slectionnez la colonne du flux principal contenant les valeurs qui devront correspondre aux valeurs de lintervalle. Le composant tLogRow ne requiert pas de configuration particulire pour ce Job. Le rsultat suivant s'affiche:

Seules les valeurs demandes retournes (pays) sont affiches.

342

Guide de Rfrence des Composants Talend Open Studio

tReplaceList

tReplaceList

Proprits du tReplaceList
Famille de composant Fonction Objectif Basic settings Data Quality 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 le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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 co- Saisissez le numro de la colonne dans laquelle les valumn leurs 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.

Guide de Rfrence des Composants Talend Open Studio

343

Scnario : Remplacement partir dun fichier de rfrence

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

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.

344

Guide de Rfrence des Composants Talend Open Studio

Scnario : Remplacement partir dun fichier de rfrence

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.

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.

Guide de Rfrence des Composants Talend Open Studio

345

Scnario : Remplacement partir dun fichier de rfrence

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.

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.

346

Guide de Rfrence des Composants Talend Open Studio

tSchemaComplianceCheck

tSchemaComplianceCheck

Proprits du tSchemaComplianceCheck
Famille de composant Data Quality Fonction 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 Un schma est une description de lignes, i.e., il dfinit le schema 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 le 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 le Guide utilisateur Talend Open Studio. Check all columns from Cochez cette option si vous souhaitez effectuer la vrificaschema tion sur toutes les colonnes du schma de base. Custom defined 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. Dfinissez dans ce tableau quelles sont les vrifications effectuer, et sur quelles colonnes. Column :: Affiche les noms des colonnes. Type : slectionnez les proprits que les donnes doivent avoir. Cette validation est obligatoire pour toutes les colonnes. Pour effectuer cette vrification sur toutes les colonnes, cochez la case den-tte du tableau. 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 dfi-

Objectif Basic settings

Checked Columns

Guide de Rfrence des Composants Talend Open Studio

347

Scnario : Valider les dates en fonction dun schma

nir toutes les colonnes comme nullables, cochez la case dentte 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. Trim the excess content of column when length checking chosen and the length is greater than defined length 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.

Use another schema for Dfinissez un schma de rfrence en donnant aux donnes compliance check 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. Advanced settings Use Fastest Date Check 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 le Guide utilisateur Talend Open Studio. Treat all empty string as Cochez cette case afin de traiter tous les champs vides de NULL 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.. tStatCatcher Statistics Utilisation Cochez cette case pour collecter les donnes de log au niveau du composant.

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 le Guide utilisateur de Talend Open Studio.

Scnario : Valider les dates en fonction dun schma


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.

348

Guide de Rfrence des Composants Talend Open Studio

Scnario : Valider les dates en fonction dun schma

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

Guide de Rfrence des Composants Talend Open Studio

349

Scnario : Valider les dates en fonction dun schma

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.

Laissez le champ Type aussi permissif que possible. 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.

350

Guide de Rfrence des Composants Talend Open Studio

Scnario : Valider les dates en fonction dun schma

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

Guide de Rfrence des Composants Talend Open Studio

351

Scnario : Valider les dates en fonction dun schma

352

Guide de Rfrence des Composants Talend Open Studio

tUniqRow

tUniqRow

Proprits du tUniqRow
Famille de composant Fonction Objectif Basic settings Data Quality 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 le 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 le 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. Advanced settings Only once each duplica- Cochez cette case si vous souhaitez envoyer uniquement ted key les premires entres en doublon des colonnes dfinies comme cl(s) vers le flux de sortie des doublons. Use of disk (suitable for Cochez cette case pour permettre la gnration de fiprocessing large row chiers temporaires sur le disque dur lors du traitement de set) 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 :

Guide de Rfrence des Composants Talend Open Studio

353

Scnario : Ddoublonner des donnes

- 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 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 est un composant intermdiaire puisquil sert traiter un flux de donnes. Ainsi, il ncessite un composant dentre et un composant de sortie. n/a

Scnario : Ddoublonner des donnes


Ce scnario 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. Double-cliquez sur le composant tFileInputDelimited afin dafficher longlet Basic settings de sa vue Component.

354

Guide de Rfrence des Composants Talend Open Studio

Scnario : Ddoublonner des donnes

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.

Guide de Rfrence des Composants Talend Open Studio

355

Scnario : Ddoublonner des donnes

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.

356

Guide de Rfrence des 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.

Guide de Rfrence des Composants Talend Open Studio

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 tAccessBulkExec 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 connec- Cochez cette case et slectionnez le composant tAccesstion Connection 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.

358

Guide de Rfrence des Composants Talend Open Studio

Proprits du tAccessBulkExec

Username and Pass- Informations dauthentification de lutilisateur de base de word donnes. Action on table Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create 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. Table Nom de la table crire. Notez quune seule table peut tre crite la fois et la table doit exister pour que lopration Insert soit autorise. Nom du fichier traiter. Voir galement le Guide utilisateur de Talend Open Studio. Action on data Vous pouvez effectuer, sur les donnes de la table dfinie, lopration que vous souhaitez : Insert : ajoute de nouvelles entres la table. Schema et Edit Schema 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 : Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide Utilisateur Talend Open Studio. Advanced settings Additional JDBC para- Spcifiez des informations supplmentaires de connexion meters la base de donnes existante. Cette option est disponible lorsque la case Use an existing connection est dcoche dans les Basic settings. Include header tStatCatcher Statistics Usage Cochez cette case pour inclure len-tte des colonnes dans le fichier. Cochez cette case pour collecter les donnes de log au niveau du composant.

Local filename

Ce composant est gnralement utilis avec le composant tAccessOutputBulk. Ensemble, ils offrent un gain de performance important pour lalimentation dune base de donns Access.

Guide de Rfrence des Composants Talend Open Studio

359

Scnarios associs

Scnarios associs
Pour plus dinformations relatives au fonctionnement du composant tAccess BulkExec, consultez les scnarios suivants : la section intitule Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk. la section intitule Scnario : Insrer des donnes dans une base MySQL du composant tMysqlOutputBulkExec.

360

Guide de Rfrence des Composants Talend Open Studio

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 Fonction Objectif Databases/Access 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 Close connection 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. Advanced settings Utilisation Limitation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Basic settings

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 la section intitule Proprits du tMysqlConnection

Guide de Rfrence des Composants Talend Open Studio

361

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 Fonction Objectif Basic settings Databases/Access 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 Slectionnez la version dAccess que vous utilisez (Access 2003 ou versions suprieures. Nom de la base de donnes.

Username et Password Informations dauthentification de lutilisateur de base de donnes. Use or register a shared Cochez cette case pour partager votre connexion ou rcuDB Connection prer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant.. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Advanced settings Additional JDBC para- Ajoutez des informations de connexion supplmentaires meters ncessaires la connexion la base de donnes. tStatCatcher Statistics Utilisation Limitation 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 tAccessCommit et tAccessRollback. n/a

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.

362

Guide de Rfrence des Composants Talend Open Studio

Scnario: Insrer des donnes dans des tables parent/enfant

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. 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 dinformations concernant les Mtadonnes, consultez le Guide utilisateur Talend Open Studio . Dans longlet Basic settings du composant tFileInputDelimited, appuyez sur les touches Ctrl+Espace pour accder la liste des variables. Dfinissez le champ File Name avec la variable globale : tFileList_1.CURRENT_FILEPATH. Pour plus dinformations concernant lutilisation des variables, consultez le Guide Utilisateur Talend Open Studio .

Guide de Rfrence des Composants Talend Open Studio

363

Scnario: Insrer des donnes dans des tables parent/enfant

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. 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 dinformations concernant le composant tMap, consultez le 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. Dans longlet Basic settings des deux composants tAccessOutput, cochez la case Use an existing connection pour rcuprer les informations du composant tAccessConnection. Ignorez le champ Commit every 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.

364

Guide de Rfrence des Composants Talend Open Studio

Scnario: Insrer des donnes dans des tables parent/enfant

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.

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

Guide de Rfrence des Composants Talend Open Studio

365

tAccessInput

tAccessInput

Proprits du tAccessInput
Famille de composant Fonction Objectif Databases/Access 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 le Guide utilisateur de Talend Open Studio. Use an existing connec- Cochez cette case et slectionnez le composant tAccesstion Connection 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 dyna-

Basic settings

366

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

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

Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant (Repository). Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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.

Advanced settings

Additional JDBC para- Ajoutez des informations de connexion supplmentaires meters ncessaires la connexion la base de donnes. tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et columns en fin de champ dans toutes les colonnes contenant des chanes de caractres. Trim column Utilisation 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 dans : la section intitule Scnario 1 : Afficher les donnes slectionnes partir dune table . la section intitule Scnario 2 : Utiliser la variable StoreSQLQuery . Pour plus dinformations sur les contextes dynamiques dans le cadre dune utilisation de base de donnes, consultez la section intitule tContextLoad .

Guide de Rfrence des Composants Talend Open Studio

367

tAccessOutput

tAccessOutput

Proprits du tAccessOutput
Famille de composant Fonction Objectif Basic settings Databases/Access 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 Guide utilisateur de Talend Open Studio . Use an existing connec- Cochez cette case et slectionnez le composant tAccesstion Connection 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.

368

Guide de Rfrence des Composants Talend Open Studio

Proprits du tAccessOutput

DB Version Database

Slectionnez la version dAccess que vous utilisez. Nom de la base de donnes.

Username et Password Informations dauthentification de lutilisateur de base de donnes Table Action on table Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : 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. 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).

Guide de Rfrence des Composants Talend Open Studio

369

Proprits du tAccessOutput

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 : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : 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.

Advanced settings

Additional JDBC para- Ajoutez des informations de connexion supplmentaires meters ncessaires la connexion la base de donnes. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. 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 tAccessOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier. tStatCatcher Statistics Use field options Enable debug mode Cochez cette case pour collecter les donnes de log au niveau du composant. 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.

Additional Columns

Support null in SQL Cochez cette case pour prendre en compte les valeurs Null WHERE statement dune table de base de donnes.

370

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

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 la section intitule Scnario 3 : Rcuprer les donnes errones laide dun lien Reject du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ, consultez : la section intitule Scnario : Afficher la base de donnes en sortie du tDBOutput. la section intitule Scnario 1 : Ajouter une colonne et modifier les donnes du tMySQLOutput.

Guide de Rfrence des Composants Talend Open Studio

371

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 Fonction Objectif Basic settings Databases/Access 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 : Guide Utilisateur de Talend Open Studio. Create directory if not Cette case est coche par dfaut. Cette option permet de exists crer le dossier contenant le fichier de sortie sil nexiste pas dj. Append Cochez cette option pour ajouter des nouvelles lignes la fin du fichier.

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 ponctuellement pour ce composant seulement. Voir galement : 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 : Guide utilisateur de Talend Open Studio. Advanced settings Include header Encoding Cochez cette case pour inclure len-tte des colonnes dans le fichier. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes.

372

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

tStatCatcher Statistics Utilisation

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

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 : la section intitule Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk. la section intitule Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

Guide de Rfrence des Composants Talend Open Studio

373

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 Fonction Objectif Basic settings Databases/Access 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 connec- Cochez cette case et slectionnez le composant tAccesstion Connection 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.

Username et Password Informations dauthentification de lutilisateur de base de donnes.

374

Guide de Rfrence des Composants Talend Open Studio

Proprits du tAccessOutputBulkExec

Action on table

Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : None : neffectuer aucune opration de table. Drop and create the table : supprimer la table puis en crer une nouvelle. Create a table : crer une table qui nexiste pas encore. Create table if doesnt exist : crer la table si ncessaire. Clear a table : supprimer le contenu de la table.

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 le Guide utilisateur de Talend Open Studio.

File Name

Action on data

Vous pouvez effectuer, sur les donnes de la table dfinie, lopration que vous souhaitez : Insert : ajoute de nouvelles entres la table.

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 : Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide Utilisateur de Talend Open Studio. Create directory if not Cette case est coche par dfaut. Cette option permet de exists crer le dossier contenant le fichier de sortie sil nexiste pas dj. Append Advanced settings Cochez cette option pour ajouter des nouvelles lignes la fin du fichier.

Additional JDBC para- Ajoutez des informations de connexion supplmentaires meters ncessaires la connexion la base de donnes. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Include header Encoding Cochez cette case pour inclure len-tte des colonnes dans le fichier. Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes de base de donnes. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics

Guide de Rfrence des Composants Talend Open Studio

375

Scnarios associs

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 : la section intitule Scnario : Insrer des donnes transformes dans une base MySQL du composant tMysqlOutputBulk. la section intitule Scnario : Insrer des donnes dans une base MySQL du tMysqlOutputBulkExec.

376

Guide de Rfrence des Composants Talend Open Studio

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 Fonction Objectif Basic settings Databases/Access 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Close Connection Advanced settings Utilisation Limitation tStatCatcher Statistics

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 la section intitule Scnario : Annuler linsertion de donnes dans des tables mre/fille du composant tMysqlRollback.

Guide de Rfrence des Composants Talend Open Studio

377

tAccessRow

tAccessRow

Proprits du tAccessRow
Famille de composant Fonction Databases/Access 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 connec- Cochez cette case et slectionnez le composant tAccesstion Connection 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

Username et Password Informations dauthentification de lutilisateur de base de donnes

378

Guide de Rfrence des Composants Talend Open Studio

Proprits du tAccessRow

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 : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : 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.

Die on error

Advanced settings

Propagate QUERYs re- Cochez cette case pour insrer les rsultats de la requte cordset dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics

Guide de Rfrence des Composants Talend Open Studio

379

Scnarios associs

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 : la section intitule Scnario : Rinitialiser lauto-incrmentation dune base de donnes du tDBSQLRow. la section intitule Scnario 1 : Supprimer et re-gnrer un index de table MySQL du tMySQLRow.

380

Guide de Rfrence des Composants Talend Open Studio

tAS400Close

tAS400Close

Proprits du tAS400Close
Famille de composant Fonction Objectif Basic settings Advanced settings Utilisation Limitation Databases/AS400 Le composant tAS400Close ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes AS400. Component list tStatCatcher Statistics Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tAS400Connection dans la liste. 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, consultez la section intitule tMysqlConnection du composant tAS400Close.

Guide de Rfrence des Composants Talend Open Studio

381

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 Fonction Objectif Databases/AS400 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 Close connection 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. Advanced settings Utilisation Limitation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Basic settings

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 la section intitule Proprits du tMysqlCommit

382

Guide de Rfrence des Composants Talend Open Studio

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 Fonction Objectif Basic settings

Databases/AS400 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 Slectionnez la version dAS400 que vous utilisez. Adresse IP du serveur de base de donnes. Nom de la base de donnes. Nom du schma.

Username et Password Informations dauthentification de lutilisateur de base de donnes. Use or register a shared Cochez cette case pour partager votre connexion ou rcuDB Connection prer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant.. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Advanced settings Additional JDBC para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option est disponible lorsque la case Use an existing connection est dcoche dans les Basic settings. Auto commit Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics Utilisation Limitation

Ce composant est gnralement utilis avec des composants AS400 et notamment avec les composants tAS400Commit et tAS400Rollback. n/a

Guide de Rfrence des Composants Talend Open Studio

383

Scnario associ

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 la section intitule tMysqlConnection

384

Guide de Rfrence des Composants Talend Open Studio

tAS400Input

tAS400Input

Proprits du tAS400Input
Famille de composant Fonction Objectif Databases/AS400 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 connec- Cochez cette case et slectionnez le composant tion 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. 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.

Basic settings

Guide de Rfrence des Composants Talend Open Studio

385

Scnarios associs

Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le Guide Utilisateur de Talend Open Studio. DB Version Host Port Database 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.

Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : 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.

Advanced settings

Additional JDBC para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option est disponible lorsque la case Use an existing connection est dcoche dans les Basic settings. Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et columns en fin de champ dans toutes les colonnes contenant des chanes de caractres. Trim column tStatCatcher Statistics Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes. Cochez cette case pour collecter les donnes de log au niveau du composant.

Utilisation

Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL.

Scnarios associs
Pour un scnario associ, consultez les scnarios du composant tDBInput dans : la section intitule Scnario 1 : Afficher les donnes slectionnes partir dune table . la section intitule Scnario 2 : Utiliser la variable StoreSQLQuery . Consultez galement la section intitule Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL du composant tContextLoad.

386

Guide de Rfrence des Composants Talend Open Studio

tAS400LastInsertId

tAS400LastInsertId

Proprits du tAS400LastInsertId
Famille de composant Fonction Objectif Basic settings Databases/AS400 Le tAS400LastInsertId affiche les derniers ID ajouts une table partir dune connexion AS400 spcifie. Le composant tAS400LastInsertId 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 : Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide utilisateur de Talend Open Studio. Component list Advanced settings Utilisation Limitation tStatCatcher Statistics Slectionnez le composant tAS400Connection dans la liste sil y a plus dune connexion dans votre Job. 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 la section intitule Scnario : Rcuprer les ID des dernires entres ajoutes du composant tMysqlLastInsertId.

Guide de Rfrence des Composants Talend Open Studio

387

tAS400Output

tAS400Output

Proprits du tAS400Output
Famille de composant Fonction Objectif Basic settings Databases/AS400 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 Guide Utilisateur de Talend Open Studio . DB Version Slectionnez la version dAS400 que vous utilisez. Use an existing connec- Cochez cette case et slectionnez le composant tion 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 dyna-

388

Guide de Rfrence des Composants Talend Open Studio

Proprits du tAS400Output

miques (Dynamic settings), consultez le Guide utilisateur de votre Studio Host Port Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes.

Username et Password Informations dauthentification de lutilisateur de base de donnes. Table Action on table Nom de la table 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. 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 ma-

Guide de Rfrence des Composants Talend Open Studio

389

Proprits du tAS400Output

nire 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 : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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 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 para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option est disponible lorsque la case Use an existing connection est dcoche dans les Basic settings. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies. Additional Columns Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tAS400Output peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier. 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.

Advanced settings

Use commit control

390

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

tStatCatcher Statistics Utilisation

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

Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. 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 la section intitule Scnario 3 : Rcuprer les donnes errones laide dun lien Reject du composant tMysqlOutput.

Scnarios associs
Pour des scnarios associs, consultez : la section intitule Scnario : Afficher la base de donnes en sortie du composant tDBOutput la section intitule Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMySQLOutput.

Guide de Rfrence des Composants Talend Open Studio

391

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 Fonction Objectif Basic settings Databases/AS400 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Close Connection Advanced settings Utilisation Limitation tStatCatcher Statistics

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 la section intitule Scnario : Annuler linsertion de donnes dans des tables mre/fille du composant tMySQLRollback.

392

Guide de Rfrence des Composants Talend Open Studio

tAS400Row

tAS400Row

Proprits du tAS400Row
Famille de composant Fonction Databases/AS400 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 connec- Cochez cette case et slectionnez le composant tion 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 Database 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.

Objectif

Basic settings

Guide de Rfrence des Composants Talend Open Studio

393

Proprits du tAS400Row

Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : 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.

Die on error

Advanced settings

Additional JDBC Para- Spcifiez des informations supplmentaires de connexion meters la base de donnes cre. Cette option est disponible lorsque la case Use an existing connection est dcoche dans les Basic settings. Propagate QUERYs re- Cochez cette case pour insrer les rsultats de la requte cordset dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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.

394

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

Commit every

Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cochez cette case pour collecter les donnes de log lors du traitement du Job, aussi bien au niveau du Job quau niveau de chaque composant.

tStatCatcher Statistics

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 : la section intitule Scnario : Rinitialiser lauto-incrmentation dune base de donnes du composant tDBSQLRow. la section intitule Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMySQLRow.

Guide de Rfrence des Composants Talend Open Studio

395

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 Fonction Objectif Basic settings Databases Le tCreateTable cre, supprime ou supprime et recre une table spcifique. Ce composant 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. Mysql Temporary Table Cochez cette case pour enregistrer la table cre de manire temporaire.

MSSQLServer, MyS- Use an existing connec- Cochez cette case si vous utilisez un composant de QL, Oracle, PostgresPlus, tion connexion, par exemple : tMysqlConnection ou tOraclePostgresql, Teradata Connection, 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

396

Guide de Rfrence des Composants Talend Open Studio

Proprits du tCreateTable

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 Connection Type Liste droulante des pilotes disponibles: Oracle SID : Slectionnez ce type de connexion pour identifier exclusivement une base de donnes spcifique sur un systme. Service Oracle : Slectionnez ce type de connexion pour utiliser lalias TNS que vous fournissez lorsque vous vous connectez la base de donnes distante. Oracle OCI : Slectionnez ce type de connexion pour utiliser linterface dappel de la base de donnes Oracle (Oracle Call Interface) accompagne dun ensemble de logiciels API de langage C qui fournissent une interface cette base de donnes Oracle. WALLET : Slectionnez ce type de connexion pour stocker les informations didentification dans un portefeuille Oracle (Oracle wallet). Access Access File Nom du fichier traiter. Voir galement le Guide utilisateur de Talend Open Studio. Firebird Firebird File Nom du fichier traiter. Voir galement le Guide utilisateur de Talend Open Studio. Interbase Interbase File Nom du fichier traiter. Voir galement le Guide utilisateur de Talend Open Studio. SQLite SQLite File Nom du fichier traiter. Voir galement le Guide utilisateur de Talend Open Studio. Java Db HSQLDb HSQLDb AS400/Oracle Framework Type Running Mode Use TLS/SSL Sockets DB Version 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. Slectionnez dans la liste droulante la version correspondant la base de donne slectionne.

Guide de Rfrence des Composants Talend Open Studio

397

Proprits du tCreateTable

Teradata

Create

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.

Tous les types de bases de Host donnes, excepts Access, JavaDb, SQLite et ODBC Tous les types de bases Database Name de donnes, excepts Access, Firebird, HSQLDb, SQLite et ODBC JavaDb DB Root Path

Adresse IP du serveur de base de donnes.

Nom de la base de donnes.

Parcourez vos fichiers jusqu la racine de votre base de donnes. Numro du port dcoute du serveur de base de donnes.

Tous les types de bases Port de donnes, excepts Access, AS400, Firebird, Interbase, JavaDb, SQLite et ODBC HSQLDb Informix ODBC DB Alias DB Server ODBC Name

Nom de la base de donnes. Nom du serveur de base de donnes. Nom de la base de donnes.

UserName et Password Informations dauthentification de lutilisateur de base de donnes. Table name Saisissez le nom de la nouvelle table entre guillemets. 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 uniquement. Voir galement le 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 le 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.

AS400/ MSSQL Server Utilisation

Additional JDBC Para- Ajoutez des informations de connexion supplmentaires meters ncessaires la connexion la base de donnes. 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.

398

Guide de Rfrence des Composants Talend Open Studio

Scnario : Crer une nouvelle table dans une base de donnes MySQL

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 (pour plusd'informations, consultez la section intitule tMysqlConnection ). 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. Dans tous les cas (Built-in ou Repository), cliquez sur Edit Schema pour vrifier le type de donnes dans la colonne DB Type.

Guide de Rfrence des Composants Talend Open Studio

399

Scnario : Crer une nouvelle table dans une base de donnes MySQL

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.

400

Guide de Rfrence des Composants Talend Open Studio

tDB2BulkExec

tDB2BulkExec

Proprits du tDB2BulkExec
Famille de composant Fonction Objectif Basic settings Databases/DB2 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 connec- Cochez cette case et slectionnez le composant tJDBCtion Connection 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.

Username et Password Informations dauthentification sur lutilisateur de base de donnes.

Guide de Rfrence des Composants Talend Open Studio

401

Proprits du tDB2BulkExec

Table Action on table

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.

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 le 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 le Guide utilisateur de Talend Open Studio. Data file Nom du fichier traiter. Voir galement le Guide utilisateur de Talend Open Studio. 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 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.

402

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

Advanced settings

Field terminated by Date Format Time Format Timestamp Format Remove Load Pending Load options

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. Quand la case est coche, dbloque la table en tat Pending, aprs un chargement massif. 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 Utilisation

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

Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes DB2.

Scnario associ
Pour un scnario associ au composant tDB2BulkExec, consultez : la section intitule Scnario : Insrer des donnes transformes dans une base MySQL du tMysqlOutputBulkExec. la section intitule Scnario : Supprimer et insrer des donnes dans une base Oracle du tOracleBulkExec.

Guide de Rfrence des Composants Talend Open Studio

403

tDB2Close

tDB2Close

Proprits du tDB2Close
Famille de composant Fonction Objectif Basic settings Advanced settings Utilisation Limitation Databases/DB2 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 tStatCatcher Statistics Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tDB2Connection dans la liste. 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 la section intitule tMysqlConnection

404

Guide de Rfrence des Composants Talend Open Studio

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 Fonction Objectif Databases/DB2 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 Close connection 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. Advanced settings Utilisation Limitation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Basic settings

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 la section intitule tMysqlConnection

Guide de Rfrence des Composants Talend Open Studio

405

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 Fonction Objectif Basic settings Databases/DB2 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 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.

Username et Password Informations dauthentification de lutilisateur de base de donnes. Encoding Slectionnez lencodage partir de la liste ou slectionnez Custom et dfinissez-le manuellement. Ce champ est obligatoire pour la manipulation des donnes des bases de donnes.

Use or register a shared Cochez cette case pour partager votre connexion ou rcuDB Connection prer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Advanced settings Auto commit Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics Utilisation Limitation

Ce composant est gnralement utilis avec des composants DB2, notamment les composants tDB2Commit et tDB2Rollback. n/a

406

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

Scnarios associs
Pour un scnario associ au composant tDB2Connection, consultez la section intitule Scnario : Insrer des donnes dans des tables mre/fille .

Guide de Rfrence des Composants Talend Open Studio

407

tDB2Input

tDB2Input

Proprits du tDB2Input
Famille de composant Fonction Purpose Databases/DB2 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 le Guide utilisateur de Talend Open Studio. Use an existing connec- Cochez cette case lorsque vous utilisez un composant tion tDB2Input.

Basic settings

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

408

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

miques (Dynamic settings), consultez le Guide Utilisateur de votre Studio. Host Port Database Schema Adresse IP du serveur dannuaire DB2. Numro du port dcoute du serveur. Nom de la base de donnes. Nom du schma.

Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement le 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 le 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.

Advanced settings

Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et columns en fin de champ dans toutes les colonnes contenant des chanes de caractres. Trim column tStatCatcher Statistics Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes. Cochez cette case pour collecter les donnes de log au niveau du composant.

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 dans : la section intitule Scnario 1 : Afficher les donnes slectionnes partir dune table . la section intitule Scnario 2 : Utiliser la variable StoreSQLQuery . Consultez galement la section intitule Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL du composant tContextLoad.

Guide de Rfrence des Composants Talend Open Studio

409

tDB2Output

tDB2Output

Proprits du tDB2Output
Famille de composant Fonction Objectif Basic settings Databases/DB2 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 connec- Cochez cette case lorsque vous utilisez un composant tion 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 le Guide utilisateur de Talend Open Studio. Host Adresse IP du serveur de base de donnes.

410

Guide de Rfrence des Composants Talend Open Studio

Proprits du tDB2Output

Port Database

Numro du port dcoute du serveur. Nom de la base de donnes.

Username et Password Informations dauthentification de lutilisateur de base de donnes. Table Action on table Nom de la table 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. 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).

Guide de Rfrence des Composants Talend Open Studio

411

Proprits du tDB2Output

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 : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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 Cochez cette case pour personnaliser une requte, surtout lorsquil y a plusieurs actions sur les donnes.

Advanced settings

Commit every

Additional Columns

Convert columns and Cochez cette case pour mettre le nom des colonnes et celui table names to upper- de la table en majuscules. case Enable debug mode Cochez cette case pour afficher chaque tape du processus de dcriture dans la base de donnes.

Support null in SQL Cochez cette case pour prendre en compte les valeurs Null WHERE statement dune table de base de donnes. Assurez-vous que la case Nullable est bien coche pour les colonnes du schma correspondantes. 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.

412

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

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 Utilisation Cochez cette case pour collecter les donnes de log au niveau du composant.

Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. 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 la section intitule Scnario 3 : Rcuprer les donnes errones laide dun lien Reject du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ au composant tDB2Output, consultez : la section intitule Scnario : Afficher la base de donnes en sortie du tDBOutput. la section intitule Scnario 1 : Ajouter une colonne et modifier les donnes du tMySQLOutput.

Guide de Rfrence des Composants Talend Open Studio

413

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 Fonction Objectif Basic settings Databases/DB2 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Close Connection Advanced settings Utilisation Limitation tStatCatcher Statistics

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 la section intitule Scnario : Annuler linsertion de donnes dans des tables mre/fille du composant tMySQLRollback.

414

Guide de Rfrence des Composants Talend Open Studio

tDB2Row

tDB2Row

Proprits du tDB2Row
Famille de composant Fonction Databases/DB2 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 connec- Cochez cette case et slectionnez le composant tion 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 Database Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur. Nom de la base de donnes.

Objectif

Basic settings

Guide de Rfrence des Composants Talend Open Studio

415

Proprits du tDB2Row

Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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.

Die on error

Advanced settings

Propagate QUERYs re- Cochez cette case pour insrer les rsultats de la requte cordset dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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.

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.

416

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

tStatCatcher Statistics Utilisation

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

Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits de requtes SQL.

Scnarios associs
Pour un scnario associ au composant tDB2Row, consultez : la section intitule Scnario : Rinitialiser lauto-incrmentation dune base de donnes du composant tDBSQLRow. la section intitule Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMySQLRow.

Guide de Rfrence des Composants Talend Open Studio

417

tDB2SCD

tDB2SCD

Le composant tDB2SCD appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez la section intitule tDB2SCD .

418

Guide de Rfrence des Composants Talend Open Studio

tDB2SCDELT

tDB2SCDELT

Le composant tDB2SCDELT appartient deux familles diffrentes : Business Intelligence et Databases. Pour plus dinformations, consultez la section intitule tDB2SCDELT .

Guide de Rfrence des Composants Talend Open Studio

419

tDB2SP

tDB2SP

Proprits du tDB2SP
Famille de composant Fonction Objectif Basic settings Databases/DB2 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 connec- Cochez cette case et slectionnez le composant tion 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 Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes.

Username et Password Informations dauthentification sur lutilisateur de base de donnes. Schema et Edit Schema Dans une procdure stocke, le schma est un paramtre dentre.

420

Guide de Rfrence des Composants Talend Open Studio

Scnario associ

Un 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 le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et il est stock dans le Repository. Ainsi, il est rutilisable. Voir galement le Guide utilisateur de Talend Open Studio. SP Name Saisissez le nom exact de la Procdure Stocke (SP). Is Function / Return re- Cochez cette case, si une seule valeur doit tre retourne. sult in Slectionnez dans la liste la colonne du schma sur laquelle est base la valeur obtenir. Parameters Cliquez sur le bouton [+] et slectionnez dans le champ Schema Columns les diffrentes colonnes ncessaires la procdure. Notez que le schma de la SP peut contenir plus de colonnes quil ny a de paramtres utiliss dans la procdure. Slectionnez le Type de paramtre : IN : paramtre dentre (Input) OUT : paramtre de sortie (Output)/valeur retourne IN OUT : les paramtres dentre doivent tre retournes sous forme de valeur, mme aprs modifications via la procdure (fonction). RECORDSET : les paramtres dentre doivent tre retournes sous forme densemble de valeurs, au lieu dune valeur unique. Consultez la section intitule tPostgresPlusClose si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL. 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 la section intitule Scnario : Excuter une procdure stocke dans le hub MDM du composant tMysqlSP. Consultez galement la section intitule tPostgresPlusClose si vous voulez analyser un ensemble denregistrements dune table de donnes ou dune requte SQL.

Guide de Rfrence des Composants Talend Open Studio

421

tDBInput

tDBInput

Proprits du tDBInput
Famille de composant Fonction Objectif 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 Basic settings Property type Peut tre Built-in ou Repository Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier dans lequel sont stockes les proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de 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 Guide utilisateur de Talend Open Studio. Connection type Database Liste droulante des pilotes disponibles. Nom de la base de donnes

Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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.

422

Guide de Rfrence des Composants Talend Open Studio

Scnario 1 : Afficher les donnes slectionnes partir dune table

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.

Advanced settings

Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et columns en fin de champ dans toutes les colonnes contenant des chanes de caractres. Trim column tStatCatcher Statistics Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes. Cochez cette case pour collecter les donnes de log au niveau du composant.

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 :

Dans ce scnario, le champ Property Type est en mode Built-In.

Guide de Rfrence des Composants Talend Open Studio

423

Scnario 2 : Utiliser la variable StoreSQLQuery

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.

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.

424

Guide de Rfrence des Composants Talend Open Studio

Scnario 2 : Utiliser la variable StoreSQLQuery

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.

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 :

Guide de Rfrence des Composants Talend Open Studio

425

tDBOutput

tDBOutput

Proprits du tDBOutput
Famille de composant Fonction Objectif Databases 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. Basic settings Property type Peut tre Built-in ou Repository. Built-in : Proprits utilises ponctuellement. Repository : Slectionnez le fichier de proprits du composant. Les champs suivants sont alors pr-remplis laide des donnes collectes. Cliquez sur cette icne pour ouvrir lassistant de configuration de connexion la base de donnes et enregistrer les paramtres de connexion que vous avez dfinis dans la vue Basic settings du composant. Pour plus dinformations sur comment dfinir et stocker des paramtres de connexion de base de donnes, consultez le Guide utilisateur de Talend Open Studio. Connection type Database Liste des pilotes disponibles. Nom de la base de donnes.

Username et Password Informations dauthentification de lutilisateur de base de donnes. Table Action on data Nom de la table crire. Notez quune seule table peut tre crite la fois. Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne : Insert : Ajouter de nouvelles entres la table. Le Job sarrte lorsquil dtecte des doublons. Update : Mettre jour les entres existantes. Insert or update : Ajouter des entres ou mettre jour les entres existantes. Update or insert : Mettre jour les entres existantes ou en crer si elles nexistent pas. Delete : Supprimer les entres correspondantes au flux dentre.

426

Guide de Rfrence des Composants Talend Open Studio

Proprits du tDBOutput

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.

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 le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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.

Advanced settings

Commit every

Additional Columns

Guide de Rfrence des Composants Talend Open Studio

427

Scnario : Afficher la base de donnes en sortie

Reference column : Saisissez une colonne de rfrence que le composant tDBOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier. Use field options Enable debug mode tStatCatcher Statistics Utilisation 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 collecter les donnes de log au niveau du composant.

Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. 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 la section intitule Scnario 3 : Rcuprer les donnes errones laide dun lien Reject 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.

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

428

Guide de Rfrence des Composants Talend Open Studio

Scnario : Afficher la base de donnes en sortie

diffrentes variables de contexte. Pour plus dinformations sur la manire de crer et dutiliser les variables de contexte, consultez le Guide utilisateur de Talend Open Studio.

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 intitule Proprits du tUniqRow 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 : la section intitule Proprits du tMysqlOutput Proprits du tMysqlOutput, page 678

Guide de Rfrence des Composants Talend Open Studio

429

tDBSQLRow

tDBSQLRow

Proprits du tDBSQLRow
Famille de composant Fonction 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. Objectif 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. Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv ponctuellement pour ce composant seulement. Voir galement : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : 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. Repository : Slectionnez la requte approprie dans le Repository. Le champ Query est renseign automatiquement.

Basic settings

430

Guide de Rfrence des Composants Talend Open Studio

Scnario : Rinitialiser lauto-incrmentation dune base de donnes

Query

Saisissez votre requte en faisant particulirement attention lordre des champs afin quils correspondent la dfinition du schma.

Advanced settings

Propagate QUERYs re- Cochez cette case pour insrer les rsultats de la requte cordset dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

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

Guide de Rfrence des Composants Talend Open Studio

431

Scnario : Rinitialiser lauto-incrmentation dune base de donnes

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 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 lautoincrmentation 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. Enregistrez le Job et appuyez sur F6 pour lexcuter. Lauto-incrmentation de la base de donnes est rinitialise. Voir galement : la section intitule Proprits du tMysqlRow .

432

Guide de Rfrence des Composants Talend Open Studio

tEXAInput

tEXAInput

Proprits du tEXAInput
Famille de composant Fonction Objectif Databases/EXA 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 Guide Utilisateur de Talend Open Studio. Host name Port Schema name Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Saisissez le nom du schma.

Basic settings

Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : Guide Utilisateur de Talend Open Studio. Table Name Query type et Query Saisissez le nom de la table. Saisissez votre requte de base de donnes en faisant attention ce que lordre des champs corresponde celui dfini dans le schma.

Guide de Rfrence des Composants Talend Open Studio

433

Scnarios associs

Guess Query

Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query. Cliquez sur le bouton pour rcuprer le schma de la table.

Guess schema Advanced settings

Additional JDBC para- Ajoutez des informations de connexion supplmentaires meters ncessaires la connexion la base de donnes. Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et columns en fin de champ dans toutes les colonnes contenant des chanes de caractres. Trim column tStatCatcher Statistics Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes. Cochez cette case pour collecter les donnes de log au niveau du composant.

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 dans : la section intitule Scnario 1 : Afficher les donnes slectionnes partir dune table . la section intitule Scnario 2 : Utiliser la variable StoreSQLQuery .

434

Guide de Rfrence des Composants Talend Open Studio

tEXAOutput

tEXAOutput

Proprits du tEXAOutput
Famille de composant Fonction Objectif Basic settings Databases/EXA 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 Guide utilisateur de Talend Open Studio. Host Port Schema name Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Saisissez le nom du schma.

Username et Password Informations dauthentification de lutilisateur de base de donnes. Table Action on table Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : 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. Action on data Vous pouvez effectuer les oprations suivantes sur les donnes de la table slectionne :

Guide de Rfrence des Composants Talend Open Studio

435

Proprits du tEXAOutput

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 le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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

Additional JDBC para- Ajoutez des informations de connexion supplmentaires meters ncessaires la connexion la base de donnes. Vous pouvez appuyer sur Ctrl+Espace afin daccder une liste de variables globales prdfinies.

436

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

Additional Columns

Cette option nest pas disponible si vous venez de crer la table de donnes (que vous layez pralablement supprime ou non). Cette option vous permet deffectuer des actions sur les colonnes, lexclusion des actions dinsertion, de mise jour, de suppression ou qui ncessitent un prtraitement particulier. Name : Saisissez le nom de la colonne modifier ou insrer. SQL expression : Saisissez la dclaration SQL excuter pour modifier ou insrer les donnes dans les colonnes correspondantes. Position : Slectionnez Before, Replace ou After, en fonction de laction effectuer sur la colonne de rfrence. Reference column : Saisissez une colonne de rfrence que le composant tEXAOutput peut utiliser pour situer ou remplacer la nouvelle colonne ou celle modifier.

Use field options Enable debug mode tStatCatcher Statistics Utilisation

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 collecter les donnes de log au niveau du composant.

Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. 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 la section intitule Scnario 3 : Rcuprer les donnes errones laide dun lien Reject du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ, consultez : la section intitule Scnario : Afficher la base de donnes en sortie du composant tDBOutput. la section intitule Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

Guide de Rfrence des Composants Talend Open Studio

437

tEXARow

tEXARow

Proprits du tEXARow
Famille de composant Fonction Databases/EXA 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 Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Saisissez le nom du schma.

Objectif

Basic settings

Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in) soit distant dans le Repository. Built-in : Le schma est cr et conserv pour ce composant seulement. Voir galement : Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : 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. Guess Query Cliquez sur le bouton Guess Query pour gnrer la requte correspondant au schma de votre table dans le champ Query.

438

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

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.

Die on error

Advanced settings

Additional JDBC para- Ajoutez des informations de connexion supplmentaires meters ncessaires la connexion la base de donnes. Propagate QUERYs re- Cochez cette case pour insrer les rsultats de la requte cordset dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. Commit every Nombre de lignes inclure dans le lot avant de commencer lcriture dans la base. Cette option garantit la qualit de la transaction (cependant pas de rollback) et surtout une meilleure performance dexcution. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics 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 : la section intitule Scnario : Rinitialiser lauto-incrmentation dune base de donnes du composant tDBSQLRow. la section intitule Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMySQLRow.

Guide de Rfrence des Composants Talend Open Studio

439

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 Fonction Objectif Basic settings Databases/eXist Le tEXistConnection ouvre une connexion une base de donnes eXist afin deffectuer une transaction. Ouvrir une connexion une base de donnes eXist afin deffectuer une transaction. URI Collection Driver 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. Username et Password Informations dauthentification de lutilisateur de base de donnes. 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. Pour un scnario associ au tEXistConnection, consultez la section intitule Scnario : Insrer des donnes dans des tables mre/fille du composant tMysqlConnection.

440

Guide de Rfrence des Composants Talend Open Studio

tEXistDelete

tEXistDelete

Proprits du tEXistDelete
Famille de composant Fonction Objectif Basic settings Databases/eXist 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 connec- Cochez cette case et slectionnez le composant tEXisttion/Component List Connection 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. 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. Username et Password Informations dauthentification de lutilisateur de base de donnes. Target Type Slectionnez le type de cible :

Driver

Guide de Rfrence des Composants Talend Open Studio

441

Scnario associ

Resource(Ressource), Collection (Collection), ou All (Tous). 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. Advanced settings Utilisation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Ce composant est utilis en tant que sous-job ou comme composant de sortie. La base de donnes eXist est un systme de gestion de base de donnes open source, construit laide de la technologie XML. Elle stocke des donnes XML selon le modle de donnes XML et offre une fonction efficace de traitement de la requte XQuery, base sur lindex. Pour plus dinformations concernant XQuery, consultez : http://exist.sourceforge.net/xquery.html (en anglais). Pour plus dinformations concernant les extensions de XQuery Update, consultez : http://exist.sourceforge.net/update_ext.html n/a

Limitation

Scnario associ
Aucun scnario nest disponible pour ce composant.

442

Guide de Rfrence des Composants Talend Open Studio

tEXistGet

tEXistGet

Proprits du tEXistGet
Famille de composant Fonction Objectif Basic settings Databases/eXist 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 connec- Cochez cette case et slectionnez le composant tEXisttion/Component List Connection 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. 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. Username et Password Informations dauthentification de lutilisateur de base de donnes.

Driver

Guide de Rfrence des Composants Talend Open Studio

443

Scnario : Rcuprer des ressources partir dun serveur distant de base de donnes eXist

Local directory Files

Chemin daccs au fichier de destination. 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.

Advanced settings Utilisation

tStatCatcher Statistics

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

Ce composant est utilis en tant que sous-job ou comme composant de sortie. La base de donnes eXist est un systme de gestion de base de donnes open source, construit laide de la technologie XML. Elle stocke des donnes XML selon le modle de donnes XML et offre une fonction efficace de traitement de la requte XQuery, base sur lindex. Pour plus dinformations concernant XQuery, consultez : http://exist.sourceforge.net/xquery.html (en anglais). Pour plus dinformations concernant les extensions de XQuery Update, consultez : http:// exist.sourceforge.net/update_ext.html [http://exist.sourceforge.net/xquery.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.

444

Guide de Rfrence des Composants Talend Open Studio

Scnario : Rcuprer des ressources partir dun serveur distant de base de donnes eXist

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

Guide de Rfrence des Composants Talend Open Studio

445

Scnario : Rcuprer des ressources partir dun serveur distant de base de donnes eXist

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

446

Guide de Rfrence des Composants Talend Open Studio

tEXistList

tEXistList

Proprits du tEXistList
Famille de composant Fonction Objectif Basic settings Databases/eXist 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 connec- Cochez cette case et slectionnez le composant tEXisttion/Component List Connection 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. 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. Username et Password Informations dauthentification de lutilisateur de base de donnes.

Driver

Guide de Rfrence des Composants Talend Open Studio

447

Scnario associ

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.

Target Type

Slectionnez le type de cible : Resource(Ressource), Collection (Collection), ou All (Tous).

Advanced settings Utilisation

tStatCatcher Statistics

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

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 la section intitule Scnario : Itration sur un rpertoire distant .

448

Guide de Rfrence des Composants Talend Open Studio

tEXistPut

tEXistPut

Proprits du tEXistPut
Famille de composant Fonction Objectif Basic settings Databases/eXist 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 connec- Cochez cette case et slectionnez le composant tEXisttion/Component List Connection 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. 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. Username et Password Informations dauthentification de lutilisateur de base de donnes. Local directory Chemin daccs au fichier de destination.

Driver

Guide de Rfrence des Composants Talend Open Studio

449

Scnario associ

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.

Advanced settings Utilisation

tStatCatcher Statistics

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

Ce composant est utilis en tant que sous-job ou comme composant de sortie. La base de donnes eXist est un systme de gestion de base de donnes open source, construit laide de la technologie XML. Elle stocke des donnes XML selon le modle de donnes XML et offre une fonction efficace de traitement de la requte XQuery, base sur lindex. Pour plus dinformations concernant XQuery, consultez : http://exist.sourceforge.net/xquery.html (en anglais). Pour plus dinformations concernant les extensions de XQuery Update, consultez : http://exist.sourceforge.net/update_ext.html n/a

Limitation

Scnario associ
Aucun scnario nest disponible pour ce composant.

450

Guide de Rfrence des Composants Talend Open Studio

tEXistXQuery

tEXistXQuery

Proprits du tEXistXQuery
Famille de composant Fonction Objectif Basic settings Databases/eXist 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 connec- Cochez cette case et slectionnez le composant tEXisttion/Component List Connection 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. 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. Username et Password Informations dauthentification de lutilisateur de base de donnes.

Driver

Guide de Rfrence des Composants Talend Open Studio

451

Scnario associ

XQuery Input File Local Output Advanced settings Utilisation tStatCatcher Statistics

Parcourez votre rpertoire jusquau fichier local contenant la requte excuter. Parcourez votre rpertoire jusqu lemplacement o les rsultats de la requte doivent tre sauvegards. Cochez cette case pour collecter les donnes de log au niveau du composant.

Ce composant est utilis en tant que composant unique dun Job mais peut galement tre utilis dans un Job plus complexe. La base de donnes eXist est un systme de gestion de base de donnes open source, construit laide de la technologie XML. Elle stocke des donnes XML selon le modle de donnes XML et offre une fonction efficace de traitement de la requte XQuery, base sur lindex. Pour plus dinformations concernant XQuery, consultez : http://exist.sourceforge.net/ xquery.html (en anglais). Pour plus dinformations concernant les extensions de XQuery Update, consultez : http://exist.sourceforge.net/update_ext.html [http:// exist.sourceforge.net/xquery.html] n/a

Limitation

Scnario associ
Aucun scnario nest disponible pour ce composant.

452

Guide de Rfrence des Composants Talend Open Studio

tEXistXUpdate

tEXistXUpdate

Proprits du tEXistXUpdate
Famille de composant Fonction Objectif Basic settings Databases/eXist 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 connec- Cochez cette case et slectionnez le composant tEXisttion/Component List Connection 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. 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. Username et Password Informations dauthentification de lutilisateur de base de donnes.

Driver

Guide de Rfrence des Composants Talend Open Studio

453

Scnario associ

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.

454

Guide de Rfrence des Composants Talend Open Studio

tFirebirdClose

tFirebirdClose

Proprits du tFirebirdClose
Famille de composant Fonction Objectif Basic settings Advanced settings Utilisation Limitation Databases/Firebird Le composant tFirebirdClose ferme la connexion une base de donnes connecte. Ce composant permet de fermer une connexion la base de donnes Firebird. Component list tStatCatcher Statistics Sil y a plus dune connexion dans le Job en cours, slectionnez le composant tFirebirdConnection dans la liste. 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 la section intitule tMysqlConnection .

Guide de Rfrence des Composants Talend Open Studio

455

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 Fonction Objectif Databases/Firebird 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 Close connection 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. Advanced settings Utilisation Limitation tStatCatcher Statistics Cochez cette case pour collecter les donnes de log au niveau du composant.

Basic settings

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 la section intitule tVerticaConnection .

456

Guide de Rfrence des Composants Talend Open Studio

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 Fonction Objectif Basic settings

Databases/Firebird 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 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.

Username et Password Informations dauthentification de lutilisateur de base de donnes. Use or register a shared Cochez cette case pour partager votre connexion ou rcuDB Connection prer une connexion mise en partage dans un Job pre ou un Job fils. Cette option vous permet de partager une seule connexion une base de donnes dans plusieurs composants de connexion des bases de donnes, dans diffrents niveaux de Jobs, qui peuvent tre des Jobs parent ou enfant. Shared DB Connection Name : dfinissez ou saisissez le nom de la connexion partage. Advanced settings Auto commit Cochez cette case pour que, lorsquune dclaration est termine, la mthode commit soit appele automatiquement sur cette dclaration. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics Utilisation Limitation

Ce composant est gnralement utilis avec des composants Firebird, notamment les composants tFirebirdCommit et tFirebirdRollback. n/a

Guide de Rfrence des Composants Talend Open Studio

457

Scnario associ

Scnario associ
Pour un scnario associ au composant tFirebirdConnection, consultez la section intitule Scnario : Insrer des donnes dans des tables mre/fille .

458

Guide de Rfrence des Composants Talend Open Studio

tFirebirdInput

tFirebirdInput

Proprits du tFirebirdInput
Famille de composant Fonction Objectif Databases/Firebird 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 Adresse IP du serveur de base de donnes. Numro du port dcoute du serveur de base de donnes. Nom de la base de donnes

Basic settings

Username et Password Informations dauthentification de lutilisateur de base de donnes. Schema et Edit Schema Un schma est une description de lignes, i.e., il dfinit le nombre de champs qui sont traits et passs au composant suivant. Le schma est soit local (Built-in), soit distant dans le Repository. Built-in : Le schma sera cr et conserv pour ce composant seulement. Voir galement le Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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.

Advanced settings

Trim all the String/Char Cochez cette case pour supprimer les espaces en dbut et columns en fin de champ dans toutes les colonnes contenant des chanes de caractres. Trim column tStatCatcher Statistics Supprimez les espaces en dbut et en fin de champ dans les colonnes slectionnes. Cochez cette case pour collecter les donnes de log au niveau du composant.

Utilisation

Ce composant couvre toutes les possibilits de requte SQL dans les bases de donnes Firebird.

Guide de Rfrence des Composants Talend Open Studio

459

Scnarios associs

Scnarios associs
Pour un scnario associ, consultez les scnarios associs au composant gnrique tDBInput dans : la section intitule Scnario 1 : Afficher les donnes slectionnes partir dune table . la section intitule Scnario 2 : Utiliser la variable StoreSQLQuery . Consultez galement la section intitule Scnario : Utiliser un contexte dynamique lors dun insert dans une base de donnes MySQL du composant tContextLoad.

460

Guide de Rfrence des Composants Talend Open Studio

tFirebirdOutput

tFirebirdOutput

Proprits du tFirebirdOutput
Famille de composant Fonction Objectif Basic settings Databases/Firebird 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 Adresse IP du serveur de base de donnes. Numro de port dcoute du serveur. Nom de la base de donnes.

Username et Password Informations dauthentification de lutilisateur de base de donnes. Table Action on table Nom de la table crer. Vous ne pouvez crer quune seule table la fois. Vous pouvez effectuer lune des oprations suivantes sur les donnes de la table slectionne : 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. 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.

Guide de Rfrence des Composants Talend Open Studio

461

Proprits du tFirebirdOutput

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 : Guide utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement le 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.

Advanced settings

Commit every

Additional Columns

462

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

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

Support null in SQL Cochez cette case pour prendre en compte les valeurs Null WHERE statement dune table de base de donnes. Assurez-vous que la case Nullable est bien coche pour les colonnes du schma correspondantes. tStatCatcher Statistics Utilisation Cochez cette case pour collecter les donnes de log au niveau du composant.

Ce composant offre la flexibilit des requtes sur les bases de donnes et couvre toutes les possibilits des requtes SQL. 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 la section intitule Scnario 3 : Rcuprer les donnes errones laide dun lien Reject du composant tMysqlOutput.

Scnarios associs
Pour un scnario associ, consultez : la section intitule Scnario : Afficher la base de donnes en sortie du composant tDBOutput. la section intitule Scnario 1 : Ajouter une colonne et modifier les donnes du composant tMysqlOutput.

Guide de Rfrence des Composants Talend Open Studio

463

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 Fonction Objectif Basic settings Databases/Firebird 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

Close Connection Advanced settings Utilisation Limitation tStatCatcher Statistics

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 la section intitule Scnario : Annuler linsertion de donnes dans des tables mre/fille du composant tMysqlRollback.

464

Guide de Rfrence des Composants Talend Open Studio

tFirebirdRow

tFirebirdRow

Proprits du tFirebirdRow
Famille de composant Fonction Databases/Firebird 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 connec- Cochez cette case et slectionnez le composant tFirebirdtion Connection 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

Username et Password Informations dauthentification de lutilisateur de base de donnes.

Guide de Rfrence des Composants Talend Open Studio

465

Proprits du tFirebirdRow

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 : Guide Utilisateur de Talend Open Studio. Repository : Le schma existe dj et est stock dans le Repository. Ainsi, il peut tre rutilis. Voir galement : 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.

Die on error

Advanced settings

Propagate QUERYs re- Cochez cette case pour insrer les rsultats de la requte cordset dans une colonne du flux en cours. Slectionnez cette colonne dans la liste use column. 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. Cochez cette case pour collecter les donnes de log au niveau du composant.

tStatCatcher Statistics

466

Guide de Rfrence des Composants Talend Open Studio

Scnarios associs

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 : la section intitule Scnario : Rinitialiser lauto-incrmentation dune base de donnes du composant tDBSQLRow. la section intitule Scnario 1 : Supprimer et re-gnrer un index de table MySQL du composant tMySQLRow.

Guide de Rfrence des Composants Talend Open Studio

467

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 transf