May 2014 QVX. Q-Table User Manual. Just dream IT, we do the rest.

Transcription

1 Q-Table User Manual QVX May 2014 Thank yu fr using ur prduct. This dcument is a detailed manul n hw t cnfigure and use Q-Table. Q-Table is used t cnnect with a SAP ERP database. It allws user t dwnlad tables adn save them n a lcal disk in a MS Access, MS Excel r SQL Server file. Befre the dwnlad a user defines bth fields that are t be dwnladed as well as filters set n them. Yu can als create relatinships between tables. The latest prgram versin and manual can be dwnladed at: QVX ul. Katwicka 39/ Pznań hepdesk@qvx.pl We wish yu a fruitful wrk, QVX Team

2 Table f cntents 1. Quick Start Installatin Dwnlading Data fr the First Time Defining SAP Cnnectins Defining target file/database Defining tables t dwnlad Dwnlading data Detailed User s Guide System requirements Q-Table Operating systems Framewrk.NET Micrsft Office Suite SAP Permissins Q-Table Interface Main Prgram Windw Ribbn Status Bar Cnnectins Windw Cnnectins with SAP Sectin Cnnectin with Database Sectin Tables Windw SAP Tables SAP Table Definitins Filters Lg Windw Settings Windw Parameters Servers Databases Inf/Supprt MiniLg

3 Request fr Client, User r Passwrd Cnfiguratin files Starting the dwnlad prcess Infrmatin fr advanced users Optimizatin f table dwnlading time The mst cmmn mistakes Installatin f missing cmpnents SAP.NET Cnnectr Framewrk.NET Micrsft Access Runtime Primary Interp Assembly Databases limitatins Micrsft Access Micrsft Excel SQL Server Cntact

4 1. Quick Start 1.1. Installatin 1. Dwnlad Q-Table frm Yu must dwnlad a Q-Table versin that is apprpriate fr yur MS Office versin. Q-Table prgram 4

5 2. Unpack the flder with Q-Table. After unpacking there will be tw files in the destinatin flder: QTable.exe applicatin file Sapnc_utils.dll additinal library fr SAP cnnectins; it has t be in the same flder as the prgram. Q-Table prgram This file has t be in the same flder as the Q-Table applicatin 3. Run Q-Table. Yu dn't need t install the sftware. It is ready t be used after unpacking. Nte: Q-Table writes license-related data and infrmatin abut last pened files in the registry. Additinally, it may create lg files in the default prgram s flder. Yu will need a licence number t activate Q-Table when yu run it fr the first time. 5

6 Enter the licence number and yur then cnfirm it by clicking OK. Yu shuld receive an with an activatin cde within a few minutes. If yu need a test licence, send an t helpdesk@qvx.pl. Licence name Yur address 4. The activatin cde has been sent t the address yu have entered. Open yur mailbx and cpy the activatin cde. If yu can t see the in yur inbx, check SPAM flder and if it is nt there cntact ur team. Yur activatin cde 5. Paste the cde int the windw and cnfirm it by clicking OK. 6

7 Space fr the activatin cde 6. Wait until the prgram starts. Befre the prgram starts, infrmatin abut the licence will be displayed Dwnlading Data fr the First Time Yu need t fllw three steps t dwnlad data: Define cnnectins t SAP systems. Define target dwnlad flder. Define which tables are t be dwnladed. 7

8 1.3. Defining SAP Cnnectins 1. G t the Cnnectins windw. Open Cnnectins windw 2. Click the Imprt frm SAP Lgn buttn in the SAP Cnnectins sectin. 8

9 Buttn fr imprting cnnectins t SAP frm an SAP file 3. Select the SAP Lgn.lnk file which is used t run SAP GUI r saplgn.ini file with a SAP cnnectins definitin. SAP Lgn.lnk file used fr running SAP 9

10 4. The prgram has laded all SAP cnnectins defined n a particular cmputer. 5. Nw select ne f the cnnectins and enter user name, passwrd and apprpriate client number. Next tick the cnnectin as active Defining Target File/Database If yu dn t want t dwnlad large amunts f data, yu can save the data in Excel r Access. We recmmend saving data in an MS SQL Server database if yu have large data files r dwnlad regularly. MS SQL Server Express is free t use fr databases smaller than 10 GB and saving t that database is significantly faster than t MS Office files. 1. Select the File radi buttn n the right side f the screen. Buttn indicating saving data t a file 10

11 2. Click the Select file buttn. Buttn fr chsing a particular file 3. Select Micrsft Access r Micrsft Excel applicatin file depending n where yu want t save the data. Database where yu want t save data Yu can find mre details abut cnnecting t varius types f databases in the Databases chapter. 11

12 1.5. Defining Tables t Dwnlad 1. G t the Tables windw. Open the Tables windw 2. Enter a table name. Space fr a table name 3. Press Enter t cnfirm the name and wait until its definitin is dwnladed. Yu will knw that it has been dne thrugh a gif that is n the left side f the table name and by seeing a table descriptin (as lng as it exists in the selected language English is set as default). Definitin dwnlad indicatr Table definitin dwnladed frm SAP 4. Expand a dwnladed definitin using the buttn which can be fund n the left frm table name. 5. Select additinal fields t dwnlad. 12

13 Additinal fields t dwnlad 6. Yu can use the buttn, which can be fund n the left frm the field name, t shw cells that allw yu t add filters t fields. 7. Add new filters by clicking an empty rw and select an peratr Yu can dwnlad many tables frm different systems in ne prgram run. The tables can als be linked tgether in such a way that data frm ne table are filters in anther table. See Creating relatinships chapter fr further details abut it Dwnlading Data 1. Start dwnlading and saving data with the Start buttn. 13

14 Start dwnlading and saving data 2. Nw yu need t wait until the dwnlading prcess is cmpleted. Yu can track dwnlad status in the Lg windw, which is autmatically displayed when the dwnlad prcess starts. Messages displayed during the dwnlad Number f dwnladed tables Number f dwnladed rws frm currently dwnladed table 3. Yu will receive an apprpriate message in the Lg and the MiniLg windws when the dwnlad is cmpleted. 4. Yu can see the dwnladed data in preselected file when the dwnlad is cmpleted. 14

15 2. Detailed User Manual 2.1. System Requirements Q-Table The Q-Table prgram desn t require installatin. It can be run just by dwnlading and unpacking the applicatin file t any available flder r launching it directly frm an external data strage device Operating Systems Q-Table is supprted by the fllwing perating systems: Windws XP 32 bit (installing SAP.net Cnnectr libraries is required), Windws 7 32 bit, Windws 7 64 bit, Windws 8 64 bit, Framewrk.NET.NET Framewrk 2.0 r better needs t be installed in rder t have Q-Table functining prperly Micrsft Office Suite Saving t Micrsft Excel files Yu must have Micrsft Excel 2003 r better installed t save t Micrsft Excel files. Yu need t take int cnsideratin limitatins f Micrsft Excel file when cpying data frm SAP t such files. Mrever, remember that in a situatin when there is n Micrsft Access installed and Micrsft Excel 2007 r better is used than a cpy f a file in *.xls frmat is created while saving t Micrsft Excel file. This means that such a file has all limitatins f Micrsft Excel 2003 versin. Fr example: the user has Micrsft Excel 2010 installed n his cmputer, but desn't have Micrsft Access. The user creates Data.xlsx file with a maximum capacity f rws and begins dwnlading data frm SAP. Q-Table creates a Data.xls file in the same flder as Data.xlsx file. As a result, the user can save nly rws. Yu can try t prevent this by installing Access Runtime 15

16 tl. Additinally, remember that lder versins f Micrsft Office suite dn t always install Primary Interp Assembly sftware which is required fr saving t Micrsft Excel files. Yu need t install it n yur wn if it is missing. Saving t Micrsft Access files Yu must have Micrsft Access 2003 r better installed t save t Micrsft Access files. Yu need t take int cnsideratin limitatins f Micrsft Access file when cpying data frm SAP t such files. Remember that sme versins f Micrsft Access dn t install Micrsft Access Runtime sftware which is required fr prper functining f Q-Table. Yu need t install it n yur wn if such is the case SAP Permissins T run the sftware fllwing SAP permissins are necessary: S_RFC Object ACTVT: 16, RFC_NAME: *, RFC_TYPE: FUGR. S_TABU_DIS Object ACTVT: 03, DICBERCLS: *. Object permissins can be additinally restricted: t a functinal grup with mdules fr reading tables (in the case f a S_RFC bject) t table grups (in the case f a S_TABU_DIS bject) 16

17 2.2. Q-Table Interface Main Prgram Windw At the tp f the windw yu can see a ribbn which functins as a menu. Yu will find currently displayed windw belw the ribbn. The currently displayed windw is highlighted in range n the ribbn. The status bar lcated at the bttm f the screen enables clearing the Lg table and expanding a windw called Mini Lg. There is status infrmatin n the right side f the status bar that displays peratins that the sftware is currently executing. Currently displayed windw Ribbn functining as a menu Status bar 17

18 Ribbn The ribbn allws executing fllwing peratins: Saving current cnfiguratin Saving current cnfiguratin t a new file Creating new cnfiguratin Opening saved cnfiguratin Displaying the Cnnectins windw Displaying the Tables windw Pausing data dwnlading and saving Starting data dwnlading and saving Stpping data dwnlading and saving Displaying the Settings windw Displaying the Lg windw Displaying the Inf/Supprt windw 18

19 Status Bar Shw/Hide the MiniLg windw Clear the cntent f the Lg table Current prgram status 19

20 Cnnectins Windw Sectin respnsible fr SAP cnnectins Sectin respnsible fr database cnnectins 20

21 SAP Cnnectins Sectin Imprt SAP cnnectins frm a *ini r SAP Lgn.lnk file SAP cnnectins definitins table Add new SAP cnnectins Advanced SAP cnnectins settings SAP Cnnectins Definitin Table This table is a simplified versin. Detailed versin can be fund in the Settings windw. The table cnsists f fllwing clumns: Name the name f a cnnectin; practical infrmatin fr a user Prefix cnnectin prefix that can be added t the table name created in a database User user name Passwrd passwrd fr a given user name Client client number. Active indicates whether a particular cnnectin is active, i.e. whether tables will be dwnladed via it. Test allws testing a cnnectin t check whether the data entered is crrect r whether the cnnectin can be established. See here if yu are nt sure what t enter in User, Passwrd r Client fields. 21

22 Cntext Menu Apart frm the visible ptins, SAP Cnnectins definitins table has a cntext menu which is pened by right-clicking any f the cnnectins. Cpy cpies t the clipbard the values frm selected cell. Paste pastes the values frm the clipbard t a selected cell. Edit - edits a selected cell. Clear value deletes values frm a selected cell. Delete Rw deletes the definitin f a selected cnnectin. Active Select sets a given cnnectin as active. Clear sets a given cnnectin as inactive. Test cnnectin tests a selected cnnectin. 22

23 Adding a New SAP Cnnectin After selecting Add new cnnectin, a new windw is pened that is used t add a new SAP cnnectin and test it. Fllwing values must be defined: Name the name f a SAP cnnectin; each cnnectin has t have a name Cnnectin Prefix (ptinal) a value, with n mre than three characters, that will be added t SAP table name befre it is saved in a selected database. If yu have a cuple f SAP cnnectins active, the prefixes cannt be the same. User (ptinal) a user name that is used t lg n thrugh SAP Lgn Passwrd (ptinal) a user passwrd that is used t lg n thrugh SAP Lgn Client client number Server server address that the user wants t cnnect with t establish a cnnectin with an SAP system. Sys (ptinal) - system number (instance). System ID (ptinal) data required t lg n t a grup f servers. Lgn Grup (ptinal) data required t lg n t a grup f servers. SAP Ruter. See here if yu dn t knw what t enter in any f the fields. 23

24 Database Cnnectin Sectin The user can define r select last used database in current cnfiguratin n the right side f the windw. New/last used database can be selected by clicking apprpriate radi buttn and selecting an active buttn. There is a buttn fr advanced database settings belw the buttns used fr editing active database. File radi-buttn Buttn fr selecting an external database Buttn fr selecting a file Advanced databasesettings External database radi-buttn Tables Windw The Tables windw is the main windw displayed after the prgram is launched. The whle area f the windw cnsists f a table with definitins f SAP tables with data. Such a definitin is dwnladed when SAP table name is entered. The sftware autmatically dwnlads definitins and all available descriptins in a user-defined language thrugh an active SAP cnnectin. Yu can set a dwnlad prefix which will be added t a table name created in a database. The panel n the right side f the prefix entering' windw has a cuple f additinal ptins. Dwnlad all clicking this buttn selects the dwnlad checkbx fr all tables and all their fields Cllapse all this ptin hides all filters and all expanded table definitins Delete all this buttn deletes all tables defined in current settings Check references this ptin checks whether there are any tables that have a parent table withut selecting any parent fields Shw all filters this ptin expands all table definitins with filters and shws the filters t 24

25 Cntext Menu Mrever, each table heading has a cntext menu that is pened by right-clicking a heading. Srt Ascending srts ascending by a selected clumn. Srt Descending srts descending by a selected clumn. Clear srting disables srting by a selected clumn. Grup by this clumn grups by a selected clumn. Gruping Remember there is a pssibility f gruping by selected clumns. Fr example, yu can grup by the Dwnlad clumn thanks t which a user will be able t display nly thse tables which have dwnlad checkbx selected r just thse tables which have dwnlad checkbx unselected. Clumn by which gruping is dne First value f a gruping clumn Secnd value f a gruping clumn Thanks t such gruping yu can display all tables that have a value defined in the gruping clumn by clicking buttn that is n the left side f the gruping rw. Yu need t click a white x buttn by the gruping clumn name t turn ff gruping. 25

26 Turning ff gruping SAP Tables Each SAP table is described with fllwing attributes: Table name it is the table name in the SAP system. Descriptin table descriptins dwnladed frm the SAP system Overwrite if this field is selected than if the target database t which we save data frm SAP has a table with the same name than it will be deleted and new data will be entered. In ther case, the data will be added t an existing ne Prefix up t 3 characters that are added befre a SAP table name in the database Dwnlad if this field is selected, the table will be dwnladed frm the SAP system Reference table a table t which current table will be linked during data dwnlading (Creating relatinships fr SAP tables). Refresh this buttn refreshes table definitins using an active SAP cnnectin Filtered thanks t this buttn yu can check whether there are sme filters set fr a selected table ( icn). Clicking it will display all filters set fr a table. If yu want t see the definitin f a selected table, click the SAP table name. icn lcated n the left side f the Cntext Menu SAP tables have an additinal cntext menu which is pened by right-clicking n ne f the values describing a SAP table. 26

27 Cpy cpies t the clipbard a selected value frm a selected cell. Paste pastes values frm the clipbard t a selected cell. Edit - edits a selected cell. Clear value deletes values frm a selected cell. Delete Rw deletes a selected table tgether with its definitins and filters. Shw/Hide definitin shws/hides a table definitin. Refresh definitin dwnlads a table definitin frm the SAP system again. Duplicate table duplicates a table tgether with its definitins and filters. Clear references - clears references between tables. Shw filters shws all filters set fr a table. Dwnlad Select selects the dwnlad checkbx fr a table. Clear unselects the dwnlad checkbx fr a table. Overwrite Select turns n table verwriting Clear adds rws t tables instead f verwriting The Dwnlad heading in the cntext menu fr SAP tables is extended by three additinal ptins. Dwnlad all selects the dwnlad checkbx fr all tables. 27

28 Dwnlad nthing unselects the dwnlad checkbx fr all tables. Reverse dwnlad selects the "dwnlad" checkbx fr all tables that had it unselected and unselects the "dwnlad" checkbx fr all tables that had it selected. The Refresh heading gives ne additinal ptin. Refresh all it refreshes the definitins f all tables defined in Q-Table. Creating Relatinships T link tables yu need t select a child table and expand the list f available parent tables which can be accessed by clicking the Reference table cell. After the list is expanded yu need t select which table is t becme a parent table and click it. Selected refrence table Reference Tables The ntin f reference tables is based n using relatins between SAP tables. Sme data frm different SAP tables are smehw linked with each ther. Q-Table helps in dwnlading apprpriate data n the basis f these relatins. The fllwing example illustrates such a situatin: 28

29 Let s assume we have tw tables: Clients and Emplyees. Every emplyee may, but desn't have t be a client. Such a case is shw in the pictures belw. The data frm the pictures are lcated in the SAP system. The user can dwnlad frm the Clients table nly the data abut clients wh are als emplyees. T dwnlad apprpriate data, the user creates tw SAP tables in Q-Table named Clients and Emplyees. Next the user defines the link between the Clients table and the Emplyees table. Then the user expands the definitin f the Clients table ( buttn). Fllwing that the user selects a field t which ne f the fields frm the Emplyees table is t be linked. 29

30 The user selects all the fields which are t be linked. Nw after starting the dwnlad, the whle Emplyees table will be dwnladed and saved in the target database plus the part f the Clients table which crrespnd t dwnladed Names and Surnames frm the Emplyees table. Yu can see the whle cntent f Clients table belw n the left, while n the right there is the cntent which has been dwnladed because f links. Additinally, yu can see the whle cntent f the Emplyees table under thse tw examples. 30

31 SAP Table Definitins Name f a SAP table which definitin we want t see All SAP table clumns with definitins Table definitin cntains the definitin f every clumn frm a SAP table. A clumn definitin has fllwing attributes: Field name it is a clumn name in the SAP system. Field descriptin clumn descriptin dwnladed frm the SAP system Primary key it infrms whether a particular clumn is in the primary key, s whether it has t be dwnladed r nt Dwnlad if this field is selected, the clumn will be dwnladed frm the SAP system. Type infrmatin abut the clumn type: C string f characters N - integer P fixed-pint number F flating-pint number D - date T - hur X string f character written in a hexadecimal system Length length (number f characters) f the value in a clumn Decimals the amunt f decimal pint spaces Reference field a clumn t which current clumn will be linked during data dwnlading (Creating relatinships fr SAP tables). Filtered thanks t this buttn yu can check whether there are sme filters set fr a selected clumn ( icn). Clicking it will display all filters set fr a clumn. Yu have t click the icn (t the left frm clumn name) t add filters t a selected clumn. 31

32 Cntext Menu SAP tables definitins have an additinal cntext menu which is pened by right-clicking ne f the values describing a SAP table clumn. Cpy cpies t the clipbard the values frm selected cell. Cpy filters cpies filters set n a selected field t the clipbard Paste filters pastes filters frm the clipbard sets filters frm the clipbard t a selected field Paste filter values pastes filters values frm the clipbard and by default sets the filter peratr as = Shw/Hide filters shws/hides filters set n a selected field Clear reference - clears references between tables. The Dwnlad heading in the cntext menu fr SAP tables definitins is extended by three additinal ptins. Dwnlad all selects the dwnlad checkbx fr all tables Dwnlad key nly dwnlads nly key fields (Primary Key) frm clumn with selected dwnlad checkbx Reverse dwnlad selects the "dwnlad" checkbx fr all tables that had it unselected and unselects the "dwnlad" checkbx fr all tables that had it selected. 32

33 Creating relatinships After defining a relatinship between tables yu may start defining relatinships between fields. It is dne analgically t creating relatinships between tables. Remember, that the list f available parent fields will be filled in nly by fields frm tables defined as parent tables and have the same type and are nt lnger than current field. First, yu must select which field will be a child field, and then expand the list f available parent fields by clicking a cell in the Reference field clumn. After selecting a parent field, yu must left-click it. Selected parent field Search fields by patterns 33

34 Many times tables have a lt f fields which makes finding ne particular field hard. T make this easy, Q-Table enables searching fr a field by ne f its characteristics. It is pssible thanks t filter cells: Searching a field by sme criteria is very simple. When yu click the ne f the fllwing search ptins fr a particular field: symbl, the user can select In text cells (Field name, Field descriptin, Type, Reference field): N filter turning ff the ptin f searching fr a particular field by a selected clumn Cntains searching by whether a given string f characters is included in a cell Des nt cntain searching by whether a given string f characters is nt included in a cell Starts with searching by whether the cell begins with a given string f characters Ends with searching by whether a cell ends with a given string f characters Equals searching by a value that has been entered Nt equal t searching by values that are different than entered nes Is null searching by null values Is nt null searching by nn-null values In binary cells (Primary key, Dwnlad): 34

35 N filter turning ff the ptin f searching fr a particular field by a selected clumn Equals searching by a value that has been entered Nt equal t searching by values that are different than entered nes Is null searching by null values Is nt null searching by nn-null values In number cells (Length, Decimals): N filter turning ff the ptin f searching fr a particular field by a selected clumn Equals searching by a value that has been entered Nt equal t searching by values that are different than entered nes Greater than searching by a number greater than the ne entered Less than searching by a number less than the ne entered Greater than r equal t searching by a number greater than r equal t the ne entered Less than r equal t searching by a number less than r equal t the ne entered Is null searching by null values Is nt null searching by nn-null values Between searching by numbers between entered range Nt between searching by numbers utside entered range After yu select a suitable search ptin, yu just need t enter a value t have nly thse fields displayed that meet yur criterin. 35

36 In the picture abve, nly fields frm BSEG table that include the characters MAN are displayed. Name in which SAP table user is interested in Filters set n a clumn Name in which clumn user is interested in Filters Each filter is described with the fllwing attributes: Operatr a filter peratr; yu can use ne f the peratrs belw: = all rws that include values in a given clumn which are equal t an entered value will be dwnladed <> all rws that include values in a given clumn which are different frm an entered value will be dwnladed Between all rws that include values in a given clumn which belng t an entered range will be dwnladed Nt Between all rws that include values in a given clumn which dn t belng t an entered range will be dwnladed Like all rws that cntain values crrespnding t an entered string will be dwnladed. Strings f characters cnsist f searched characters and * r % characters that signify any r nne characters. Fr example: a filter *lack* will find fields with such values as Blackburn, Blackwell, Lackmre, Schlack etc. Nt Like all rws that dn t cntain values crrespnding t an entered string will be dwnladed. Strings f characters cnsist f searched characters and * r % characters that signify any r nne characters. Fr example: a filter *lack* will find fields with such values as Blackburn, Blackwell, Lackmre, Schlack etc. < all rws that include values in a given clumn which are less than an entered value will be dwnladed <= all rws that include values in a given clumn which are less than r equal t an entered value will be dwnladed > all rws that include values in a given clumn which are greater than an entered value will be dwnladed >= all rws that include values in a given clumn which are greater than r equal t an entered value will be dwnladed Frm it is a basic value fr all single-argument peratrs and the first value fr dubleargument peratrs 36

37 T it is the secnd value fr duble-argument peratrs - it is nt taken int cnsideratin in the case f single-argument peratrs. Filter peratrs Operatrs >, >=, <, <=, =, Between, Like are linked by an OR peratr thus creating alternative cnditins. It means that such filters as >= 2, <= 4 fr ne number field will nt wrk as ne filter Between 2 and 4 because they will dwnlad values that are greater than r equal t 2 OR less than r equal t 4, s all real numbers. Operatrs <>, Nt Between, Nt Like are linked by an AND peratr thus creating cnjunctin cnditins. It means that setting filters "Nt Between 2 and 4", <> 5 will result in dwnlading 1, 4.5 and 6 but will nt dwnlad 2, 3 and 5. Filters between thse tw grups are cnnected in a fllwing way: Filters are gruped by a linking peratr (OR / AND) and each grup is linked with an AND peratr. Fr example: A user set fllwing filters fr the P field: Between 1 and 10, Nt between 2 and 3, Between 20 and 30, Nt between 4 and 6, The utcme is a filter that lks like this: (Between 1 and 10 OR Between 20 and 30) AND (Nt Between 2 and 3 AND Nt Between 4 and 6) Remember that filters are case sensitive! Cntext Menu Filters have an additinal cntext menu which is pened by right-clicking ne f the values describing a filter. 37

38 Cpy cpies the values frm a selected cell t the clipbard Paste pastes values frm the clipbard t a selected cell Edit... - edits the value f a selected cell Clear value deletes the value in a selected cell Delete Rw deletes a selected filter Cpy filter cpies a selected filter t the clipbard Paste filters pastes frm the filters clipbard Paste filters values pastes filters values frm the clipbard and sets = as a default peratr Lg Windw 38

39 39

40 Dwnlad Status Parent table prcessed / Number f dwnladed rws SAP Cnnectins SAP Tables being dwnladed Thanks t the tp part yu can see what the current data dwnlad/saving prcess status is. It is divided int three sectins represented by prgress bars. Starting frm the tp, the bars indicate: The number f SAP cnnectins frm which dwnlad has already been cmpleted. Yu can als find there infrmatin abut the cnnectin name via which data is being dwnladed. When nly ne SAP cnnectin is active, this bar is inactive. The number f dwnladed SAP tables. Yu can als find there infrmatin abut the name f a SAP table that is being dwnladed. When nly ne table is t be dwnladed, this bar is inactive. The percentage f rws read frm the parent table, while after the "/" symbl yu can see the number f rws dwnladed frm SAP table that is being dwnladed. When the table is nt a child table, then there is the "-" symbl befre the "/" symbl. 40

41 Messages The bttm part shws what happened in the sftware in a given timespan. Starting frm the left, table s clumns cntain fllwing data: Date shws when a particular messages was registered Message shws the cntents f messages send t the user by the sftware. Type shws message type. The fllwing types are pssible: Inf infrms abut an event that tk place when the sftware was running Warning warns abut a pssibility f an errr that may ccur sn due t varius reasns fr example, when sme Internet cnnectin errrs are detected. Messages als infrm abut the cnsequences f decisins he is making. Errr a message that is displayed as a result f varius factrs unrelated t the sftware. An errr may ccur, fr example, as a result f having n Internet cnnectin r incrrectly entered passwrd fr SAP cnnectin. Cntext Menu In additin, the Message table has cntext menu fr clumn headings. Srt Ascending srts ascending by a selected clumn. Srt Descending srts descending by a selected clumn. Clear srting disables srting by a selected clumn. Grup by this clumn grups by a selected clumn. Gruping rules are explained in the pint that describes tables. Mrever, cntext menu is available als fr each message. Cpy cpies t the clipbard the values frm a selected cell Delete Rw deletes a selected message 41

42 Settings Windw Settings windw cnsist f three grups. Buttn shwing advanced settings fr SAP Cnnectins Buttn shwing parameters Buttn shwing advanced settings fr Database cnnectins 42

43 Parameters Q-Table allws setting 10 parameters that can adjust prgram s functinality t ne s needs. Belw yu will find descriptins f each parameter: Rw cunt the number f rws which is dwnladed frm the SAP system during ne sessin. The recmmended value f the parameter shuld nt be lwer than and nt higher than The default value is Prgram status table the name f a table created in a database t which Q-Table will save data dwnladed frm SAP. This table will include current dwnlad status thanks t which yu can pause the dwnlad and then resume it at any mment. One status table can have many statuses fr varius settings stred in a *.qtbl file. Prefix a value with maximum 10 characters, which will be added t the beginning f the name f a SAP table befre it is saved in a target database Descriptin language a language in which SAP tables descriptins and their clumns will be searched and dwnladed If a descriptin in a selected language is nt fund, then the descriptin will nt be dwnladed at all. Functin mdule a mdule in a SAP system that is used fr dwnlading data. The recmmended default mdule is named Default, hwever, it isn t included in all SAP systems, s in case f prblems with dwnlading data change the mdule t RFC_READ_TABLE. Applicatin language a language in which all messages and ntices will be displayed in the prgram Save passwrd it is used t chse whether the passwrd is saved in cnfiguratin file (encrypted) r nt. Add descriptin - it is used t chse whether a descriptin is added t a SAP table name after it is saved in a target database Update duplicates - it is used t chse whether a rw is t be verwritten r skipped if the same exists in a database and identical ne is dwnladed again Link nulls - it is used t chse whether the prgram shuld link t null values frm a parent table Merge key fields it is used t chse whether a SAP table's clumns described as "Key" are t be merged int ne additinal clumn There is need fr this parameter because sme SAP tables have mre key clumns than the capacity f a target database. Create cmparisn it is used t chse whether the prgram shuld create a cmparisn f each dwnladed table frm different systems after the data dwnlad and saving prcess is cmpleted 43

44 Servers The grup Servers display all SAP cnnectins defined in current settings and detailed infrmatin abut each f them. Starting frm the left, the clumns are: Name the name f a SAP cnnectin. Each cnnectin has t have a name. Prefix A value with n mre than three characters that will be added t SAP table name befre it is saved in a selected database. If yu have a cuple f SAP cnnectins active, the prefixes cannt be the same. User a user name that is used t lg n thrugh SAP Lgn. Passwrd a user s passwrd that is used t lg n thrugh SAP Lgn. Client client number Server server address that the user wants t cnnect with t establish a cnnectin with a SAP system. Sys system number (instance) System ID data required t lg n t a grup f servers. Lgn Grup data required t lg n t a grup f servers. Ruter Active infrms whether a particular cnnectin is active (will it be used t dwnlad data) Test a buttn that allws testing the capability t establish a cnnectin with SAP Cntext Menu Each clumn heading (except fr Passwrd) has an additinal cntext menu available after right-clicking it. Srt Ascending srts ascending by a selected clumn. Srt Descending srts descending by a selected clumn. Clear srting disables srting by a selected clumn. Mrever, there is anther cntext menu available when yu right-click ne f the values describing a particular cnnectin. 44

45 Cpy cpies t the clipbard the values frm a selected cell Paste pastes values frm the clipbard t a selected cell Edit... - edits the value f a selected cell Clear value deletes values frm a selected cell. Delete Rw remves a selected cnnectin Active Select makes the selected cnnectin active Clear disables the selected cnnectin Test cnnectin tests a selected cnnectin What data must be entered t establish a cnnectin with SAP? Cnnectin name is name defined by the user that helps t identify it. User name, Passwrd and Client shuld be identical with the nes entered when lgging n SAP: Client User name Passwrd Yu can find ther data by clicking Edit in SAP Lgn: 45

46 Edit All yu need t d is t retrieve apprpriate values. System ID Sys Server SAP Ruter If yu lg n t a grup f servers, yu need change the Cnnectin type: Nw yu can retrieve data necessary t lg n t a grup f servers: System Id SAP Ruter Lgn Grup 46

47 Databases Select external database Database cnnectins definitins cnnectins Select database file Edit selected database This settings grup enables yu t manage databases defined by a user. Yu can find three buttns directly belw the buttn which expands this grup. Starting frm the left, their functins are: Chse file - this buttns allws t chse a new database frm user s cmputer. The fllwing database extensins are supprted by Q-Table: *.xls, *.xlsx, *.mdb, *.accdb, External database - this buttn allws t cnfigure a new database which is nt stred n the user s cmputer. Supprted databases are: SQL Server 2005 versin r newer, Edit - this buttn allws t edit a selected database Belw the buttns yu will see user-defined databases. Each database is described with fllwing attributes: Destinatin type f a database in which data will be saved. Available database types are: MS Excel files, Micrsft Access files, SQL Server, Database name the name f database that makes identifying it easier fr the user. If it is a file then the name cnsist f the filename and its extensin. In the case f SQL Server database, it is "Server_Name\Database_Name". Active indicates t which database the data will be saved; nly ne database can be active at a time. Test allws t test the capability t establish a cnnectin with the database Remember that yu can edit a selected database by duble-clicking the name f a database. Cntext Menu 47

48 The database cnnectin table has an additinal cntext menu that is expanded by right-click clumn headings. Srt Ascending srts ascending by a selected clumn. Srt Descending srts descending by a selected clumn. Clear srting disables srting by a selected clumn. Mrever, there is als a cntext menu fr the values that describe a database. Cpy cpies t the clipbard the values frm a selected cell Paste pastes values frm the clipbard t a selected cell Edit... - edits the value f a selected cell Clear value deletes values frm a selected cell Delete rw - deletes a selected database Active Select makes a selected database active Clear disables a selected database Test cnnectin tests cnnectin t a selected database Edit database edits a selected database Selecting a Micrsft Excel r Micrsft Access file If yu want t define a database as a Micrsft Excel r Micrsft Access file, yu just need t select a particular file in a given destinatin. 48

49 Cnfiguring a database Server name Refresh the list f servers Chse authenticatin methd Database name Expands advanced ptin bx Test cnnectin 49

50 In this windw yu can define cnnectins t a SQL Server database. Required data that need t be entered is: Server name a server name that can be entered as an IP address r a mre user-friendly name. Authenticatin methd yu can chse Windws authenticatin (fr servers wrking n the same machine as Q-Table) r username and passwrd authenticatin Database name it is a name f the database that is lcated n a previusly indicated server. If yu can cnnect with a server, yu can retrieve a list f all available databases simply by clicking the buttn "Find". Additinally, yu can test a cnnectin that has been defined by using the Test buttn. If yu are an advanced user, yu can mdify advanced ptins fr database cnnectin. Belw yu can find a list f advanced settings: Applicatin Name allws t save the name f applicatin that cnnected with a server in the database Cnnect Timeut - it is the maximum amunt f time that the applicatin will wait fr server's respnse Asynchrnus Prcessing indicates the pssibility t execute asynchrnus peratin Current Language indicates the language f server messages Cnnectin Lifetime cnnectin time limit; setting the value t 0 means that there is n limit Data Surce SQL Server s name r instance address Extended Prperties additinal parameters defined in the database Initial Catalg database name Integrated Security indicates whether Windws authenticatin (true) r username and passwrd authenticatin (false) is used. 50

51 Netwrk Library the name f a netwrk library used t establish a cnnectin with SQL Server instance Packet size the size (in bytes) f packages used t cmmunicate with a server Passwrd user s passwrd Persist Security Inf indicates whether Windws remembers (true) entered passwrd r nt (false) Encrypt indicates whether messages sent between the applicatin and the server are encrypted; it wrks nly when Trust Server Certificate is installed and a parameter is set User ID user name Wrkstatin ID the name f a wrkstatin n which the applicatin is running (mst cmmnly it s the user s cmputer) Replicatin setting this parameter means that the cnnectin will handle replicatin Cntext Cnnectin it enables each new cnnectin t be in the same cntext as the previus ne Enlist indicates whether a cnnectin supprts transactinability Failver Partner the name f server where there is a mirrr cpy (mirrring) Max Pl Size maximum number f interrgating cnnectins (pl) Min Pl Size minimum number f interrgating cnnectins (pl) Multiple Active Resultsets indicates whether Result Set cleaning is t be verlked by a server (true) r by client applicatin (false) Pling setting this parameter enables t re-establish a cnnectin faster if it is clsed r lst Transactin Binding indicates whether transactins shuld be explicitly defined (Explicit) r set default (Implicit) Trust Server Certificate tgether with the Encrypt parameter it allws encrypting messages sent between the server and the applicatin Type System Versin indicates SQL Server versin User Instance enables creating cnnectins as the administratr; yu need an authrizatin frm the server t set such a cnnectin. 51

52 Inf/Supprt Prgram versin Licence infrmatin User manual System infrmatin Cntact This windw gives sme valuable infrmatin if there are sme errrs cnnected with functining f the applicatin. Available infrmatin is: Versin indicates what prgram versin a user has User licence infrmatin abut the address t which the licence is linked Expiratin infrmatin when the licence expires User manual allws a user t pen the user manual in a brwser Cntact us infrmatin abut hw t cnnect this sftware develpers Available cntact methds are: Website System infrmatin infrmatin which are useful when cntacting sftware develpers In this sectin yu can check fllwing details abut the cmputer n which Q-Table is running: Micrsft Windws OS versin, Micrsft Excel versin, Micrsft Access versin, Prcessr versin MiniLg MiniLg is a small windw that is displayed when an event ccurs and thrugh MiniLg the prgram infrms the user abut it. 52

53 MiniLg The descriptin f this windw is identical as its full cunterpart in the Lg windw. 53

54 Request fr Client, User r Passwrd Name f a cnnectin fr which sme data is missing This windw is displayed when sme data fr SAP cnnectin is missing and the user starts the dwnlad prcess r requests dwnlading table definitins. The windw pps ut when fllwing data is missing: Client client number User a user name that is used t lg n thrugh SAP Lgn Passwrd a user passwrd that is used t lg n thrugh SAP Lgn Additinally, the user may chse the passwrd t be remembered in the cnfiguratin after the dwnlad prcess is finished r when the cnnectin is disabled (tables will nt be dwnladed via this cnnectin). See here if yu dn t knw what t enter int User, Passwrd r Client fields. 54

55 2.3. Cnfiguratin files Q-Table allws t save *.qtbl cnfiguratin file. Thanks t it, the user desn t have t define the whle cnfiguratin frm the beginning each time he turns n Q-Table. Instead, a user can lad cnfiguratin saved previusly. This slutin allws creating cnfiguratin n ne cmputer and then lading it and starting the dwnlad prcess n anther wrkstatin t which he/she desn't have a permanent access. Yu need t click ne f the buttns belw t save cnfiguratin: Yu can lad cnfiguratin using this buttn: The prgram allws using shrtcuts t access cnfiguratin: Ctrl + N create new cnfiguratin Ctrl + S save current cnfiguratin Ctrl + O pen previus cnfiguratin. 55

56 2.4. Starting the dwnlad prcess When the cnfiguratin is set, yu can start dwnlading data frm SAP and saving it in a database. Yu can start running the prgram by using keybard shrtcut F8 r clicking the buttn: Befre the prgram is started varius limitatins are checked which helps t avid errrs when the prgram is running. The issues which are checked are: Existing active SAP cnnectins there has t be at least ne active cnnectin Tables fr dwnlad there has t be at least ne table fr dwnlad Unifrmity f prefixes fr varius active cnnectins prefixes fr active cnnectins have t be identical Definitins f tables t be dwnladed each table that is t be dwnladed must have a definitin User name, passwrd and client number fr all active cnnectins The user will be asked t enter all missing data Pssibility t establish cnnectins with all active SAP cnnectins Existence f a defined database In the case, it is missing the user will be asked t select a database file. Pssibility t establish a cnnectin with a defined database Number f clumns in relatin t database limitatins Recrd length in relatin t database limitatins Existence f all necessary tables in a database, which are nt selected fr dwnlad Number f key fields in relatin t database limitatins Q-Table will suggest the user t set the Merge key fields parameter Existence f a current cpy f cnfiguratin file n the hard drive it is nt required, but recmmended as it allws resuming the dwnlad if sme errrs ccur If there is a current cpy f cnfiguratin file n the hard drive, the dwnlad may be paused by clicking this buttn: The dwnlad can als be stpped and any time withut the pssibility f being resumed by clicking this buttn: 56

57 2.5. Infrmatin fr Advanced Users Optimizatin f table dwnlading time In case f dwnlading big tables, the prgramme wrking time can be lng and last even several hurs. It is wrth cnsidering the fllwing methds fr shrtening this time. A functin mdule used t dwnlading tables frm SAP system can hld nly 512 characters in a rw. If this is exceeded, then the table has t be dwnladed in parts and merged, what cnsiderably extends the dwnlading time. If it is pssible, it is wrth selecting fields which ttal length des nt exceed 512 characters. If a table is very lng, it is wrth dwnlading it in many several parts and put them int ne table in a lcal database. In rder t speed up the prcess, ne shuld use filters in fields which are in the key r indexes. The reasn f shrtening the dwnlading time is a methd f wrking a functin mdule which, fr example, t dwnlad rws frm t firstly has t brwse thrugh the first millin what is time-cnsuming. Dividing a table with use f filters will lwer the number f rws which the mdule has t brwse Mst Cmmn Mistakes Nt indicating any cnnectin with a database and SAP system as active, A table title with a status includes fewer than 3 characters r a number n the ne f three first places, An attempt t verwrite a table already used by anther prcess, Nt indicating the field Overwrite and dwnlading a table with different clumns. The missing clumns will be added, hwever, the results can be different frm expected because rws with the dubled primary key will be skipped, The prgramme des nt guarantee data crrectness in a case when a table will be mdified during dwnlading. In a case when a table has a lng rw and its clumns have t be dwnladed in parts, there is a pssibility that data will nt match each ther after merging clumns int a whle. In this case rws which d nt include full infrmatin will be rejected and a user will be infrmed abut that, in case f chsing the filter Like r Nt Like, the lack f the symbl % r * in a place where there shuld be a characters string. Nt giving it in any place can cause dwnlading data different frm expected, The value f numeric fields is runded t a field size. If there is space fr 2 decimal places in a field, then the value 1,238 will be runded dwn t 1,23, Because f the implementatin errr, used functin mdule may nt dwnlad fields cntaining percentage values crrectly, 57

58 The prgramme can dwnlad incrrect data if numeric fields have space fr mre than 12 characters. 58

59 2.6. Installatin f Missing Cmpnents SAP.NET Cnnectr When using Windws XP, it is necessary t install libraries which are used by Q-Table prgramme. These are free libraries which installatin file can be dwnladed frm the website (attentin! Lgging in is necessary!): The licence fr libraries can be fund n the SAP website r the website given belw: Framewrk.NET 2.0 The sftware can be dwnladed fr free frm the website: On the website given abve there are als the installatin instructin and the full descriptin f the sftware Micrsft Access Runtime The sftware can be dwnladed fr free frm the website: Micrsft Office Micrsft Office Micrsft Office On the websites given abve there are als the installatin instructin and the full descriptin f the sftware Primary Interp Assembly Links t relevant versins f Micrsft Office: Micrsft Office Micrsft Office Micrsft Office

60 2.7. Databases limitatins Each database t which Q-Table prgram enables data frm SAP t be written has its limitatins. The mst imprtant which shuld be remembered during creating a cnfiguratin are presented belw Micrsft Access Micrsft Access File size 2 GB Table title length 64 characters Clumn title length 64 characters Number f clumns 255 Number f clumns in the primary key 10 Recrd length 2000 bytes Micrsft Excel Micrsft Excel 2003 Micrsft Excel 2003 Number f clumns 256 Number f rws Micrsft Excel Micrsft Excel Number f clumns Number f rws SQL Server SQL Server Primary key length Recrd length Number f clumns in the primary key 900 bytes 8060 bytes 16 60

61 2.8. Cntact Out f cncern fr ur clients satisfactin, we cnstantly try t imprve the quality f ur sftware. If yu have any cmments r dubts cncerning the given user's guide r prgramme functining, please cntact us at helpdesk@qvx.pl. In case f errrs in prgramme functining, please attach a cnfiguratin file in which the errr has ccurred and System infrmatin frm the Inf/Supprt tab. 61