Telekurs FinXL Quick User Guide

Transcription

1

2 Table of contents 1. Introduction The Telekurs FinXL menu The GetQuote function The GetHisto function The GetSnap function The CalcRate function The CalcBond function GetQuote Wizard GetHisto Wizard GetSnap Wizard CalcBond Wizard Most liquid parameter The "favorite" data fields and price attributes Securites search Fields search GetQuote macro Options / User preferences Additional tools Refresh tools DDE Conversion tools Entitlements and instruments limits /23

3 1. Introduction Telekurs FinXL is the new version of Telekurs id dynamic links solution. Fully integrated within Excel, it allows you to insert and edit real time data functions (GetQuote), historical data snapshots (GetHisto and GetSnap), interpolated rate calculations (CalcRate) and from version 1.2 onwards the new function CalcBond. They run exactly as native Excel functions. The pluses of Telekurs FinXL are : Excel integration using "add-in" technology, which makes FinXL functions true Excel functions. Automated market watch imitating Telekurs id lists. Possibility of historical data extraction. Specific yield-oriented calculation functions. Watch out! As in any Excel function, the length of the parameters string cannot exceed 250 characters. 2. The Telekurs FinXL menu Telekurs FinXL is available in your Excel application via a dedicated toolbar, a menu in the menubar and a right-click menu. Telekurs FinXL toolbar in Excel menubar: Telekurs FinXL menu : 3/23

4 You can also find all functions within Excel's "insert function" feature: 3. The GetQuote function GetQuote is Telekurs FinXL' 's core function, replacing Telekurs id DDE links. It can be automatically generated by GetQuote Wizard or directly typed in the selected cell, as if writing a standard Excel formula. It should respect a specific syntax : =GetQuote("SECURITIES";"FIELDS";"DISPLAY") SECURITIES : Security s identifiers may get typed in two modes : the complete syntax : code,agency,market. All codes are allowed, markets can be expressed in BK (numerical market codes) or in alphabetical code (i.e. ENX ). the quick syntax: code,market. In this case, GetQuote could return "unknown security" when the code is false or "incomplete identification" when the code exists in more than one agency. Use the wildcard 0 as market code value in order to request a security on its most liquid market place. NB: You may also use the syntax code. In this case, it will be interpreted this as query to get the information from your favorite market set in FinXL options/user preferences. It is possible to request several securities in the same GetQuote function. Security s identifiers will be separated by ";". You may also insert securities from Telekurs id: thanks to the copy/paste function or using a Drag & Drop, add one or several lines from a list. In these cases, a specific syntax will be automatically applied: "Valor code,ch,market code,currency code". 4/23

5 FIELDS : Fields codes separated by ";". DISPLAY: Optional parameters separated by ";". Three parameters are available: NAME = display field names on first row, INV = display fields in rows instead of columns; and the refresh parameter (RT (real time), 5S (5 seconds) ). As in any Excel function, the definition of parameters can be done outside the cell containing the formula itself, using cell references or Excel labelled ranges. NB: while using cell references, cell ranges or Excel labelled ranges should not be placed between double quotes. 3.1 GetQuote functions, examples Using explicit parameters: =GetQuote("350000,FR,ENX";"LAST";"1MN"): display the last price for CAC 40 index with a refresh every minute. Using external cell references : Cell ranges =GetQuote(A2:A10;B1:F1;"NAME"): create a table using A2:A10 cells as a list of securities, B1:F1 cells as fields, and displaying the field names in headers Excel labelled ranges =GetQuote(mysecurities;myfields): create a table using labelled ranges "mysecurities" and "myfields" 4. The GetHisto function GetHisto is a function getting historical quotes data. As with GetQuote, this function can be automatically generated by GetHisto Wizard or directly typed in the selected cell, as if writing a standard Excel formula. It should respect a specific syntax : =GetHisto("SECURITIES";"FIELDS";"PERIOD;"AUTOREFRESH";"DISPLAY") SECURITIES: Security s identifiers. Same syntax as with GetQuote function FIELDS: Fields codes separated by ";". PERIOD: Rolling period or a date range (separated by ";"). Recognizes any of the following syntaxes: Rolling period = "7D" or "1Y" or "3M" Period with a fixed start = "21/07/2006" Fixed period = "21/07/2006;22/07/2006" date format set in your regional settings option AUTOREFRESH: Automatic refresh of the data can be set: no parameter or "N" disables the automatic refresh. Changes of input parameters valuesof the function will take effect only if you reset this function in order to apply the change (for instance, a change of date). 5/23

6 "Y" makes refresh automatic for any change of any input parameter and also when opening the workbook. DISPLAY: Optional parameters separated by ";". Five parameters are available: VAR = group data by field instead of security ASC = sort by ascending dates PRICE = display quotes only RAW = display raw data (ignore capital events) ENDADJ = display data including only capital events that occurred during the resquested period. As in any Excel function, the definition of parameters can be done outside the cell containing the formula itself, using cell references or Excel labelled ranges. NB 1: while using cell references, cell ranges or Excel labelled ranges should not be placed between double quotes. NB 2: using a cell reference, which contains a volatile Excel function (such as "TODAY 1") should be avoided. We strongly recommend using FinXL function GetToday instead. 4.1 GetHisto functions, examples Using explicit parameters: =GetHisto("ABBN,SY,380";"VAL";"20D"): create a table displaying the valuation price for ABBN for the last 20 days =GetHisto("ABBN,SY,380";"VAL";"31/12/2005"): create a table displaying the valuation price for ABBN since 31/12/2005 Using cell references: =GetHisto(A2;B1:F1;"01/01/2010;31/12/2010"; ASC ): create a table using A2 cell as a security, B1:F1 cells as price fields from 01/01/2010 until 31/12/2010, and sorting by ascending dates 5. The GetSnap function GetSnap is a function retrieving last known quotes at a given date. As with the other FinXL functions, this function can be automatically generated by GetSnap Wizard or directly typed in the selected cell, as if writing a standard Excel formula. It should respect a specific syntax : =GetSnap("SECURITIES";"FIELD";"DATE";"AUTOREFRESH";"DISPLAY") SECURITIES: Security s identifiers. Same syntax as with GetQuote function FIELD: One pricing field of your choice. DATE: A date following the format set in your regional settings options. Today's date is not eligible. AUTOREFRESH: Automatic refresh of the data can be set: no parameter or "N" disables the automatic refresh. Any change of an entry parameter of the function must be followed by the use of a reset function in order to get this change applied (for instance, a change of date). "Y" makes refresh automatic for any change of an entry parameter and also when opening the workbook. 6/23

7 DISPLAY: Optional parameters separated by ";". Five parameters are available: INST = display security names NAME = display field names INV = display fields in rows instead of columns DATE = display date for last known quote RAW = display raw data (ignore capital events). As in any Excel function, the definition of parameters can be done outside the cell containing the formula itself, using cell references or Excel labelled ranges. NB 1: while using cell references, cell ranges or Excel labelled ranges should not be placed between double quotes. NB 2: using a cell reference, which contains a volatile Excel function (such as "TODAY 1") should be avoided. We strongly recommend using FinXL function GetToday instead GetSnap functions, examples Using explicit parameters: =GetSnap("ABBN,SY,380";"LAST";"31/12/2009"): display the last traded price for ABBN on the 31th December There will not be any automatic refresh and the price will be the only data displayed. Using cell references: =GetSnap(A2:A10;B1;C1; Y ;"NAME;INST"): create a table using A2:A10 cells as a list of securities, B1 cell as price field, C1 as the date. There will be an automatic refresh and the names of securities and fields will be displayed. 6. The CalcRate function CalcRate is a function available in Telekurs FinXL, which enables to calculate interpolated rates from a selection of benchmarks. As with the other FinXL functions, this function can be automatically generated by Excel's functions Wizard or directly typed in the selected cell, as if writing a standard Excel formula. It should respect a specific syntax: =CalcRate ("DATABASE";"INTERPOLATION DATE") DATABASE: This parameter shall contain cell ranges on two consecutive columns displaying maturity dates in the first one and theirassociated rates in the second one. These two columns shall be sorted from the nearest maturity to the furthest. INTERPOLATION DATE: a date following the format set in user s regional settings options or an identifier of a cell containing a date with the proper syntax. 7/23

8 INTERPOLATION DATE Interpolated rates calculated with CalcRate functions DATABASE: Column 1 : maturity date Column 2 : yields 7. The CalcBond function CalcBond is a new function available in Telekurs FinXL 1.2. It offers actuarial calculations on bonds. As with the other FinXL functions, this function can be automatically generated by CalcBond Wizard or directly typed in the selected cell, as if writing a standard Excel formula. It should respect a specific syntax : =CalcBond ("SECURITY";"FIELDS";"CALCULATION DATE"; TYPE ; VALUE ; CALCULATION FORMULA ; CALL OPTION DATE ; REDEMPTION PRICE ; "AUTOREFRESH";"DISPLAY") SECURITY: One security identifier. Same syntax as with GetQuote function FIELDS: Fields codes separated by ";". Eligible fields are limited to actuarial calculation data : Accrued interest Price Yield Basis point value Average life Duration Modified duration Convexity CALCULATION DATE: Date following the date format set in your regional settings options, used for the calculation (settlement date) TYPE: Parameter defining which type of quote is used for the actuarial calculation, either "PRICE" or "YIELD". 8/23

9 VALUE: Value of the quote to be used for the calculation, either price or yield, following the "###.#####" syntax. CALCULATION FORMULA: Parameter defining yield-to-maturity calculation formula: ICMA, CNO, MOOSMULLER or STREET. CALL OPTION DATE: Simulate a call option date following the format set in your regional settings options. This parameter is optional. REDEMPTION PRICE: Simulate a redemption price to be used for the calculation. This parameter is optional. AUTOREFRESH: Automatic refresh of the data can be set up: No parameter or "Y" makes refresh automatic for any change of an entry parameter or when opening the workbook. "N" disables the automatic refresh. Any change of an entry parameter of the function shall be followed by the use of CalcBond s refresh function in order to get refreshed calculations. DISPLAY: Optional parameters separated by ";". Three parameters are available : INST = display security names NAME = display field names INV = display fields in rows instead of columns. As in any Excel function, the definition of parameters can be done outside the cell containing the formula itself, using cell references or Excel labelled ranges. NB 1: while using cell references, cell ranges or Excel labelled ranges should not be placed between double quotes. NB 2: using a cell reference, which contains a volatile Excel function (such as "TODAY) should be avoided. We strongly recommend using FinXL function GetToday instead CalcBond functions, examples Using explicit parameters: =CalcBond("US125509BG36,XX,558";"YLD;DUR;MODDUR;CONV;ACCINTB"; "16/06/2011";"Price";" ";"ICMA";"";"";"Y"; NAME ) Using cell references: =CalcBond($B9;"PR";$Q$5;"Yield";J9;"ICMA";"";"";"Y") 9/23

10 8. GetQuote Wizard The GetQuote Wizard offers assistance to new users in creating a GetQuote function for a limited number of securities and fields. It is composed of three tabs. The Securities tab is used to select securities to use within the function. This information is MANDATORY, meaning at least one security has to be selected before the function can be inserted. The second tab, Fields, is used to specify the fields the function will display. This information is MANDATORY, meaning at least one field has to be selected before the function can be inserted. NB: a "favorite" filter allows you to set up a restricted list of favorite fields and attributes. You will find more easily your most frequently used fields if you add them in this list. 10/23

11 Finally, the third tab defines optional parameters controlling the display of field names, rotation of rows and columns and the reset parameters. 9. GetHisto Wizard The GetHisto Wizard offers assistance to new users in creating a GetHisto function for a limited number of securities and fields. It is composed of four tabs. The Securities tab is used to select securities. 11/23

12 This information is MANDATORY, meaning at least one security has to be selected before the function can be inserted. NB: the maximum number of securities allowed in this function is submitted to entitlement and depends on your TKiD package. The second tab, Fields, is used to specify fields the function will contain. This information is MANDATORY, meaning at least one field has to be selected before the function can be inserted. NB: a "favorite" function allows you to set up a restricted list of favorite fields and attributes Yyou will find more easily your most frequently used fields if you create this list.. The third tab, Period, defines the historical range required by the user. It allows to set the automatic update too. This information is MANDATORY. Default parameters are proposed when using the wizard 12/23

13 Finally, the fourth tab sets optional parameters used in displaying data - grouping by variable or security, sorting by dates and displaying data raw or event-adjusted, displaying quotes only. 10. GetSnap Wizard The GetSnap Wizard offers assistance to new users in creating a GetSnap function for a limited number of securities and fields. It is composed of three tabs. The Securities tab is used to select securities to use within the function. This information is MANDATORY, meaning at least one security has to be selected before the function can be inserted. 13/23

14 The second tab, Parameters, is used to specify the field the function will contain and the chosen date. It allows to set the automatic update as well. This information is MANDATORY, but default vaues lare provided (date = today). NB : a "favorite" function allows you to set up a restricted list of favorite fields in which you will find more easily the fields you need the most. Finally, the third tab defines optional parameters controlling the display of field names, dates and rotation of rows and columns. 14/23

15 11. CalcBond Wizard The CalcBond Wizard offers assistance to new users in creating a CalcBond function for a single security and for a limited number of fields. It is composed of four tabs. The Security tab is used to select the security to use within the function. This information is MANDATORY, meaning one security has to be selected before the function can be inserted. When a security is selected, some bond characteristics are displayed: 15/23

16 If the security is not analyzable within Calcbond, an error message is automatically displayed, informing the user about the error s type (invalid reference data, pricing quotation not supported, issue date unknown, ) The second tab, Fields, is used to specify the fields the function will display. This information is MANDATORY, meaning at least one field has to be selected before the function can be inserted. Besides actuarial calculation fields, the list contains all calculation inputs parameters. The third tab, Parameters, defines the calculation inputs parameters: settlement date simulated price/yield calculation formula for callable and index-linked bonds, additional parameters are available after clicking on Call options checkbox : simulation of a call option date and the associated redemption price. This tab allows setting the automatic update too. These informations are MANDATORY and filled-in by default. settlement date Today simulated price simulated yield calculation formula ICMA call option date bonds maturity date redemption price NB: This tab is enabled only if the security is analyzable by CalcBond 16/23

17 Finally, the fourth tab defines optional parameters controlling the display of field names, rotation of rows and columns. 12. Most liquid parameter This parameter enables you to use all the existing FinXL functions for any kind of instrument s code on its most liquid market place, without having to indicate the name or BC code of this market place The security s identifier will be written as: code,agency,0 or code,0 NB: We strongly recommend selecting LIQMAR (num) or LIQMARKET (alpha num.) in your fields selection in order to display the exact market place used to retrieve the results. 17/23

18 13. The "favorite" data fields and price attributes These settings are essential for you as they allows you to shorten the list of fields and attributes you have to sweep when looking for a field: 18/23

19 14. Securites search This tool, using the Telekurs id securities search, promptly inserts identifiers into a column. You can then add a Telekurs FinXL function using the range of pasted identifiers as cell reference. 15. Fields search This feature promptly pastes selected fields onto a row. You can then add a GetQuote function using the range of pasted identifiers as cell reference. 16. GetQuote macro This tool promptly inserts a GetQuote function in a cell using the column immediately to its left as a list of securities and the row immediately above as fields. Click on to insert a GetQuote function using cell references 17. Options / User preferences Dialog box setting default identification parameters and other Telekurs FinXL options. It allows you to choose your favorite language for the interface and the data as well. Securities may be simultaneously labelled in their home language and the user's favorite one (i.e. Chinese/English). You can also set your time zone (market time, your local time or other time zone) and the refresh frequency (if real time is not necessary, you can improve Excel s performance by choosing a filter). Other options include the choice of character "blank" or zero Telekurs FinXL will use if a field returns nothing (typically, last price for an unopened security. A separate check box determines if real time data functions are to be activated on opening the file that contains them. The screen also offers the choice of a favorite numbering agency and a market. Regarding the favorite agency, Telekurs FinXL will apply this choice in inserting identifiers in the sheet from a wizard. Regarding the favorite market, Telekurs FinXL will apply this choice in filling in the gaps in incomplete security s identifiers as code 19/23

20 18. Additional tools You can "deactivate" Telekurs FinXL or "reactivate" all functions easily thanks to a single click on (in Excel menubar / (in FinXL menu). The GetToday function allows you to automatically insert the date of the current day. Use this FinXL function instead of Excel function Today () for your date parameter definition. The Convertfields function workbook. allows you to change the language of all fields already in place in the NB : the return function converts all fields in English. From version 1.3 onwards, the Display list of fields tool of FinXL fields in a 6 columns table, where you can find: allows you to display automatically the list - Field mnemonic in English - Field description - FinXL function - Flag if it belongs to your favourite fields list - Short label regarding your FinXL local language interface set - Long label in User Preferences (French, Spanish, Italian, German) 20/23

21 Example: Display list of fields tool for a FinXL user set in French 19. Refresh tools From version 1.3 onwards Freeze Workbook button behaves like a toggle button, which allows you to freeze / unfreeze the updates of real-time data. When you click the Freeze Workbook button, it is highlighted to indicate that freezing updates has been applied. If the button is clicked again, it reverts to the normal appearance and the updates of realtime data come back. Please note: Freezing/unfreezing process applies for your whole workbook Freezing/unfreezing process has no effect on historical functions (GetHisto, GetSnap) and calculation function (CalcBond). Within freeze mode, you can update your real time links with refresh buttons (snapshot) 21/23

22 From version 1.3 onwards refreshing process has been simplified thanks to 2 dedicated icons: - The Refresh Workbook button allows you to force all the quotes data (GetQuote, GetSnap, GetHisto) and calculated data (CalcRate, CalcBond) available in your whole workbook. - The Refresh selected functions button allows you to select FinXL functions in your active Excel sheet for which quotes/calculated data you want to be forced. 20. DDE Conversion tools For users with Telekurs id DDE files, a converting tool is available within the Telekurs FinXL menu. This tool replaces every DDE link by a "one security / one field" GetQuote function even if they are part of a more complex formula or function. This operation has to be done manually by the user and it applies on the whole workbook. A report will be displayed, detailing the results of the conversion. NB1: This conversion does not apply to users' VB macros. NB2: For optimal Telekurs FinXL performance, we strongly recommend using table functions instead of stand-alone syntax. NB3: We strongly recommend saving your DDE workbooks before using the conversion tool. Do not hesitate to contact your product advisor or SIX Financial Information helpdesk if you require assistance. 21. Entitlements and instruments limits Each major Telekurs FinXL function (GetQuote, GetSnap, GetHisto, CalcRate and CalcBond) will be available according to the user's entitlements depending on your Telekurs id package. Limits on data requests are also included in the entitlements of every package. GetQuote: a maximum number of securities getting real time quotes at the same time is set depending on the user's product package. When reached, a message will be displayed : "maximum instruments number reached". Please erase some lines in order to get below this limit. GetHisto: a maximum number of securities getting historical data is set for the day of the request depending on your product package. When reached, a message will be displayed : "maximum instruments number reached". You have to wait for the following day to get historical data on other securities. GetSnap: a maximum number of securities getting historical prices is set for the day of the request depending on the user's product package. When reached, a message will be displayed : "maximum instruments number reached". You have to wait for the following day to get historical data on other securities. A maximum number of dates is also set for the day of the request. When reached, a similar message is displayed and you have to wait for the following day to get historical data on other dates. NB1: By default, the "automatic refresh" of GetSnap is set on "N", in order to let you force the refresh or change your dates or securities list before refreshing the data. Regarding this entitlement issue, it is strongly recommended not to activate the automatic refresh. NB2: Whenever you need to check your entitlements, a tool is available in the Telekurs FinXL connexion toolbar. Right click on the bar and click on "Entitlements" to reach the following window : 22/23

23 23/23