Recorder Variables. Defining Variables

Transcription

1 Rcordr Variabls Dfining Variabls Simpl Typs Complx Typs List of Rsrvd Words Using Variabls Stting Action Paramtrs Parsing Lists and Tabls Gtting Valu from Lists and Tabls Using Indxs with Lists Using Indxs with Tabls Variabls Log Importing / Exporting Variabls RPA Rcordr variabls ar usd to stor initial or runtim valus that a Bot can: ntr from kyboard copy to/from clipboard st from a variabl dfind in Actions gt as an opration rsult (imag found or not tru or fals) compar in conditions (if ${my_variabl} > 5 ) gt as currnt list/tabl itm in For Each loop xport as rsults and pass thm to nxt procss stps in WorkFusion Srvr Dfining Variabls All th variabls ar dfind in th Rcordr Variabls panl by clicking th icon. To add a variabl, ntr th following valus: Nam, Typ, and Dfault Valu. Nam us alphabtic charactrs in lowr cas, numric symbols and th undrscor only. All othr charactrs, such as lttrs in uppr cas and spcial symbols, ar not supportd.

2 Attntion On ntring th charactrs that ar not supportd, thy ar highlightd with rd. Th ar som spcific words that cannot b usd as rcordr variabls nams. To viw thm, rfr to List of Rsrvd Words. Typ dfin th valu format that is ndd for corrct comparison (.g. in th If-Els action) and parsing (.g. pars clipboard contnt to a tabl). Simpl Typs Simpl variabl typs consist of on valu with a spcial format: Typ Exampl Valu Nots String John Do Txt should conform to th following pattrns: string lngth, alpha, numric, alpha-numric. Numbr Numbr should conform to th following pattrns: rang, intgr, dcimal. Boolan tru, fals Slction is mad in Dfault Valu.

3 DatTi m 2019-Jan-09 02:34: 57 (Europ/Minsk) Th valu is populatd with th currnt dat and tim automatically. To manually st up, click on Dfault Valu, slct th dat and tim you nd, and click OK. Attntion Th dat and tim formats for DatTim variabls ar dfind in th rgional sttings of th oprating systm. Scrt?.? A variabl of Scrt typ is ithr slctd from th list of Scrt Entris prviously addd in Scrts Vault or cratd dirctly in th Dfault Valu fild via Add Scrt Entry. Complx Typs Complx variabl typs consist of multipl valus, ach of String typ. Ths ar List and Tabl. Lists and tabls ar ndd whn you want to do th sam st of actions for all thir itms (rows or columns),.g., snd mail for ach prson in th mail list, input account numbr and amount for ach transaction in a tabl, tc. Typ Exampl Valus String Rprsntation No

4 List ['Hydrogn', 'Hlium', 'Lithium'] List shou conf to th follo patt lng char r st cont of ta A L va a ca h u to m n

5 Tabl [['Afghanistan ', 'Afghani', 'AFN'], ['Albania', 'L k', 'ALL'], ['Algria', 'Algrian Dinar', 'DZD']] Tabl shou conf to th follo patt rows colu char r st cont of ta A T b va a ca h a n m o m n b is r tr to th m m ry th t yo a ca to W rk u o S d Dfault Valu th variabl valu. Comparing and assigning valus of diffrnt typs may rsult in xcptions or fals rsults. For xampl, comparing String with Numbr. List of Rsrvd Words Th following rsrvd words cannot b usd as rcordr variabl nams, and thus turn rd if ntrd into th Nam fild. botexcutionconfig sys_xcution_finish_listnrs applicationcontxtpath applicationhost assignmnt automationappurl automationpassword applicationrsourcurl automationusr datastorproprtis xportrsult formbasdauthsssionttl hit_submission_data_itm includdconfigs itm machinworkrprfix ocrproprtis pluginsexcutionrcords poolablobjct prvdata rcordr_ rcordr_. rcordrimagsbuckt rlasdat rstformauthenabl s3accssky s3endpointurl s3kymap s3scrtky s3signrtyp slniumsrvr sysocrapiurl sourc tablaudbpassword tablaudburl tablaudbusr titl TOWER_BOT_ usrintrnalcrdntials wfbipassword wfbiurl wfbiusr workfusionaccssky workfusionscrtky

6 machinconfigtxt scurityprovidrmap Th words blow ar Groovy languag kywords that also cannot b usd as nams for rcordr variabls. Evn if you ar abl to dfin Groovy kywords as nams in WorkFusion Studio, a script will fail in cas you publish it to Control Towr. as assrt brak cas catch class const continu df dfault do ls num Using Variabls Stting Action Paramtrs turn xtnds fals finally for goto if implmnts import in instancof intrfac nw null packag supr switch this throw throws trait tru try whil Aftr you'v cratd and dfind variabls, you can us thm in action paramtrs ( Entr Kystroks, Clipboard, If-Els, Launch Application and othrs). Start typing a variabl nam and slct an appropriat itm or click Entr. RPA Rcordr automatically wraps th variabl nam with ${} symbols. If you dlt any of th wrapping symbols or modify th variabl nam to a non-xisting on, th whol xprssion will b tratd as a string. You can us th Rcordr variabls in th fr txt filds such as:

7 path to an application path to a fil

8 wb lmnt Attntion! Th autocomplt function is not availabl for fr txt filds, so you should tak car to ntr th variabl nam corrctly in th dfind format. Variabl syntax in action paramtrs ${variabl_nam} Whn running a rcording, Bot substituts all variabls with thir rspctiv valus and prforms comparisons, calculations, parsing, and othr oprations dfind in Actions Flow. Parsing Lists and Tabls Whn using variabls in actions that rquir typs convrsion (.g. Clipboard from List or Tabl to String and vic vrsa), you nd to prform th following actions.

9 1. Entr Row Sparator Entr Column Sparator. Entr Surrounding symbols for column data. Enabl/disabl Trimming that rfrs to rmoving lading and trailing spacs. To tst th convrsion, click Tst sttings and past your list or tabl contnt thr. 6. Entr othr sparators if ndd. Gtting Valu from Lists and Tabls A valu of ach list or tabl lmnt can b rtrivd using th lmnt's indx. Th indxs can b dfind xplicitly, as an Intgr: ${list_variabl[1]} ${tabl_variabl.gt(1,2)} or dclard as a Rcordr variabl of Numbr typ: ${list_variabl[indx]} ${tabl_variabl.gt(row_indx,column_indx)}, whr indx, row_indx and column_indx ar Rcordr variabls of Numbr typ.

10 Not Numbring of lmnts in th List variabls starts with 1. Numbring of rows and columns in th Tabl variabls starts with 1. Using Indxs with Lists Rcordr Variabls product_list List variabl Exprssion ${ product_list[ 5]} 5 numric constant (5th lmnt in th List) my_list List variabl ${ my_list[ countr]} countr Numbr variabl list_input List variabl ${ list_input[ itration as Intgr]} itration Numbr variabl Th sampl rcording blow dmonstrats how to gt valus from lmnts in a List variabl. W will crat a short rcording to go through th whol list, gt valus from all lmnts, and populat thm in Notpad (xcpt th last on). # Stp Actions 1 Crat Rcor dr variabl s. countr a Numbr variabl to itrat through th lmnts by indxs my_list a List variabl list_lmnt a String variabl to rciv a valu from a List lmnt list_siz a Numbr variabl to rciv a numbr of lmnts from th list lmnts_to_typ a Numbr variabl to rciv th numbr of list lmnts to populat in Notpad 2 Opn Notp ad. 3 Gt Siz of th list. Opn Notpad with th Launch Application action to past valus from th list. Us th Exprssion Valu action to gt th numbr of lmnts in th list Slct th List variabl ( my_list) to gt th numbr of lmnts. Us th Gt siz option in th Exprssion. Slct th Numbr variabl ( list_siz) to sav th rsult.

11 4 Dfin th numb r of lm nts to print (all xcpt th last on). In th Exprssion Valu action, dfin th numbr of lmnts to b printd to Notpad all lmnts minus Dfin th xprssion as ${list_siz} - 1, to prvnt printing th last lmnt. Slct th Numbr variabl ( lmnts_to_typ) to sav th rsult. 5 Crat a loop to itrat throug h th list. Us th Whil loop until th countr is lss than siz of th list: ${countr} < ${list_siz} Important not Itration starts from 1 as for any othr array.

12 6 Gt valu from lm nt. Crat a Constant Valu action. 1. Us th following construct to gt valu from a list lmnt: ${my_list[countr]}, whr a. my_list[1] an lmnt from th list with indx 1 b. countr Rcordr variabl dfining th indx of th lmnt 2. Slct th String variabl ( list_lmnt) to sav th rsult. 7 Past th valu to Notp ad. Us th Entr Kystroks action to past th valu from th String variabl ( list_lmnt_valu) to Notpad. 8 Conditi on to insrt th linf d charac tr.

13 Us th If-Els condition to prform th nstd action. 9 Insrt th linf d charac tr. 10 Incrm nt th count r. If th condition is tru, insrt th Entr charactr to Notpad with th Entr Kystroks action. Us th Exprssion Valu action to incrmnt th countr to Dfin th xprssion as ${countr}+1. Slct th Numbr variabl ( countr) to sav th incrmntd valu. Th rcording was mad with RPA Exprss You can download sampl rcording for furthr tsts. Using Indxs with Tabls WorkFusion RPA API has svral mthods that allow rtriving valus from rows, columns, and clls in a Tabl variabl using indxs.

14 It hlps to avoid using multipl For Each Loop actions to itrat through th whol tabl. Usrs can accss th valus in th rquird lmnts in th Tabl dirctly, thus making th script asir and fastr. Rcordr Variabls product_tabl Tabl variabl 3,4 numric constants (4th lmnt in th 3rd row in th Tabl) my_tabl Tabl variabl row_countr, column_countr Numbr variabls tabl_input Tabl variabl row_numbr Numbr variabl tabl_valus Tabl variabl column_numbr Numbr variabl Exprssion ${ product_tabl.gt( 3, 4)} Output: String ${ my_tabl.gt( row_countr,column_countr) } Output: String ${ tabl_input.gtrow( row_numbr)} Output: List ${ tabl_valus.gtcolumn( column_numbr)} Output: List A rcording blow shows how to gt two valus from a Tabl and typ txt with thm in Notpad. # Stp Actions 1 Crat Rcor dr variabl s. my_tabl a Tabl variabl row_indx, column_indx Numbr variabls usd to dfin th coordinats of th valu in th Tabl fruit, day String variabls to rciv a valu from Tabl lmnts 2 Opn Notp ad. 3 Gt lm nt's valu from th Tabl. Opn Notpad with th Launch Application action. Us th Constant Valu action to gt th valu of an lmnt in th Tabl. 1. Slct th String variabl ( fruit) to sav th valu of th targt lmnt. 2. Us th gt() mthod to gt th valu of th lmnt. 3. Dfin th row and column of th lmnt using Intgr valus: a. (1,2) row 1, column 2 4. Writ th xprssion to gt th lmnt valu in th St valu fild: ${my_tabl(1,2)}. 4 Gt anoth r lm nt's valu Us th Constant Valu action to gt th valu of anothr lmnt in th Tabl Slct th String variabl ( day) to sav th valu of th targt lmnt. Us th gt() mthod to gt th valu of th lmnt. Dfin th row and column of th lmnt using rcordr variabls of typ Numbr ( row_indx, column_indx). Writ th xprssion to gt th lmnt valu in th St valu fild: ${my_tabl( row_indx, column_indx)}.

15 from th Tabl. 5 Typ txt that contai ns both valus to Notp ad Us th Entr Kystroks action to typ txt containing valus in variabls ${fruit} and ${day} to Notpad. It is possibl to us xprssions dirctly in th Entr Kystroks action. Th rcording was mad with RPA Exprss You can download sampl rcording for furthr tsts. Variabls Log Upon xcution of a rcording or svral stps of th rcording, a log fil is cratd in th Rcording foldr.

16 Th log fil contains th valus of all Rcordr variabls aftr th last stp. Importing / Exporting Variabls Whn importing a bot stp from a businss procss to RPA Rcordr, all its input data is accssibl in Rcordr Variabls viw. All RPA Rcordr variabls ar xportd togthr with th rcording and ar availabl in th Control Towr businss procss.