Portfolio Link Server Application. Telemet America, Inc.

Transcription

1 Portfolio Link Server Application Telemet America, Inc.

2 Table of Contents Telemet Portfolio Link - Server Application... 3 Portfolio Link Server Application Setup Steps... 3 Config.xml Modification:... 4 Text_File_Descriptor.ini Modification:... 4 **If your portfolio file contains holdings information**... 4 **If your portfolio file contains transactions information**... 6 Portfolio Link Server Application Diagram:... 8 Telemet Orion workstation Portfolio Link Setup... 8 Steps for Telemet Orion users to access portfolios: Page 2 of 11

3 Telemet Portfolio Link - Server Application The Telemet Portfolio Link (Portfolio Link) server application provides Telemet Orion users with access to portfolio positions (transactions or current holdings based) that are stored in a single delimited or fixed width text file. Various portfolio accounting programs, including Advent APX, allow the creation and export of a single portfolio text file. o If your transactions are in a separate file for each account, contact Telemet client services for the Linking Telemet Orion to a Portfolio Accounting System document. Items to note: The Portfolio Link application will need to be installed and run on a network computer that is accessible (viewable) from all computers that will utilize the Portfolio Link. The Portfolio Link application must have read access to the delimited (or fixed width) text file that stores the portfolio data. Portfolio Server Application advantage - By utilizing the Portfolio Link application server, the configuration process is simplified because only the Portfolio Link server will need the configuration settings. In addition, network traffic on a corporate LAN will be kept to a minimum because the Telemet Orion Workstation application retrieves pre-processed content from the Portfolio Link server. A table of contents referencing portfolio positions of a specific account is read, rather than reading the whole file over the network. Telemet Orion Workstation Information: Telemet Orion (version or newer) features a Portfolio Link add-in module, which includes the following Portfolio Link features: a. Ability to view individual portfolio accounts in Telemet custom price pages, and save accounts as Telemet Orion lists. b. Access miscellaneous reports, such as attribution, balance, impact, etc. utilizing portfolio positions. Portfolio Link Server Application Setup Steps 1) Export your portfolio positions file (either transactions or current holdings based) from your Portfolio Accounting system into a delimited or fixed width file, such as a CSV (Comma Separated Variable) file. 2) Create a folder on your network where you wish to install the Portfolio Link application server. o Telemet suggests placing the folder in a root drive (such as C:\). -The folder location must be viewable from all Telemet Orion workstations. 3) Copy the TelemetPortfolioLink.exe, Config.xml, and text_file_descriptor.ini files from the TelemetPortfolioLink.zip folder into the new folder you created. o If you have not already received the TelemetPortfolioLink.zip folder, which contains all files needed to setup a Portfolio Link Server Application, contact Telemet client services: Now the Portfolio Link files need to be modified to work with your portfolio positions file: Page 3 of 11

4 Config.xml Modification: When you open the config.xml file (using Notepad or Wordpad is suggested), you will see the following Portfolio Link configuration parameters: <configuration> <appsettings> <add key="rpc-server-port" value="8081"/> <add key="portfolio-file-path" value="e:\docs\baseline t3.csv"/> </appsettings> </configuration> The only parameters that need to be modified are: <add key="rpc-server-port" value="8081"/> & <add key="portfolio-file-path" value="c:\docs\transactions.csv"/> -The rpc-server-port value defines the TCP port number on which the Portfolio Link server is instructed to run requests from Telemet Orion. Port 8081 is the default port, however you can change this if you would like the Portfolio Link to use a different port. o Note: If using Microsoft Windows XP or Vista: the Windows Firewall must be modified to accept & run through the port you selected. -Value portfolio-file-path defines the path to the delimited text file that contains the portfolio position records (transactions or current holdings). 4) Change portfolio-file-path value to refer to your portfolio positions text file location. -Save and then close the config.xml file. Text_File_Descriptor.ini Modification: 5) Now modify the text_file_descriptor.ini file according to your portfolio positions file s structure instructions are below: **If your portfolio file contains holdings information** (if your file contains transactions, skip this section) Open the text_file_descriptor.ini.snapshot file (using Notepad or Wordpad is suggested) to see the following screen: Page 4 of 11

5 skip-first-rows Enter the row number that your holdings data starts on. file-type Is your holdings file delimited or fixed width? delimiter - choices: COMMA TAB SEMICOLON OTHER o If the delimiter is set to OTHER, then the Other field must be entered: Example: I am using character ~ as a delimiter delimiter=other other=~ Now enter the field position (column location) of the remaining fields: o Note: 1 = column 1, 2 = column 2, ect. manager the investment manager id account the account id security the security symbol shares the number of shares held cost the position s cost class the security type The class column is optional dictionary-security-type - maps differences in user-specific security types and Telemet-defined security types. -Save and then close the file. Page 5 of 11

6 **If your portfolio file contains transactions information** Open the text_file_descriptor.ini.transactions file (using Notepad or Wordpad is suggested) to see the following screen: skip-first-rows What row does the holdings information start on? file-type Delimited or Fixed Width? delimiter - choices: COMMA TAB SEMICOLON OTHER o If the delimiter is set to OTHER, then the Other field must be entered: Example: I am using character ~ as a delimiter delimiter=other other=~ Now enter the field position (column location) of the remaining fields: o Items to Note: o 0 = column 1, 1 = column 2, ect. o Date information must be in 1 of 4 formats: YYYY-MM-DD MM/DD/YY MM/DD/YYYY MMDDYY Page 6 of 11

7 o Not all fields listed are required. The table below shows which fields are required and which fields are optional: Required Fields Field Description Optional Fields Field Description Security Ticker symbol Manager Investment manager ID Code Transaction code Account Account ID Trade Trade date Class Security Type Shares Number of shares traded Settle Trade settle date Total dollar ($) Amount amount of the Lot # used for the Lot trade (shares X trade basis) Dictionary Security Type Maps differences in user-specific security types and Telemetdefined security types. Dictionary Transaction Code -Save and then close the file. Maps differences in user-specific trade codes and Telemet-defined security types. 6) Open a DOS command prompt console and change directory to the one where you installed the TelemetPortfolioLink.exe application. Run the following command: TelemetPortfolioLink.exe i. This command will register TelemetPortfolioLink.exe as a service under name Telemet Portfolio Link. 7) From the DOS command prompt console run the following command: TelemetPortfolioLink.exe s. This command will start the Portfolio Link service. o If needed, here are 2 commands to stop & remove the service: To stop the service: TelemetPortfolioLink.exe -e To remove the service: TelemetPortfolioLink -u Items of note: The Portfolio Link monitors the portfolio file for changes, and reloads it automatically any time a new file is detected. The Portfolio Link detects when a new portfolio text file is copied to specified the location (config.xml path), renames the existing portfolio text file (by appending extension - "LOCK.1" or "LOCK.2" - to the file name) re-indexes file, and generates new table of contents. The Portfolio Link must have Read/Write access to the portfolio text file, and the directory where the portfolio text file is located. The Portfolio Link allows retrieving content of multiple portfolio accounts. The new file must have the same format & file name as the original file. Page 7 of 11

8 Portfolio Link Server Application Diagram: Telemet Orion Workstations Retrieve table of contents once per session Retrieve account positions per user request Configuration Files & Accounts Table of Contents Portfolio Link Server Application Index Portfolio Accounts Text File Prepare Table of contents Serve Table of Contents to Orion workstation Serve account s positions to Orion workstation Read contents of Portfolio Accounts Text File Index whole file (on daily basis) Extract specified account positions per user request Portfolio Accounts Text file Network File Server Telemet Orion workstation Portfolio Link Setup Now that the Portfolio Link application server has been setup, the only steps remaining are to direct (point) all Telemet Orion workstations to the Portfolio Link Application server details of how this can be done are described below: Enabling the Portfolio Link Add in module for Custom Pricing Pages: From the Telemet Orion Manager Window select: Functions -> Add-Ins...: the following window will appear: Page 8 of 11

9 Right-click on PortfolioLink then choose Properties Position your mouse pointer over "PortfolioLink" and right-click once to get a Properties choice. Choose Properties to get the following Add in window: If a Portfolio Link is listed, right-click on the name ( TestLink in the example above) then choose Edit. If no Portfolio Link is listed, click New and the following window will open: -Name: Enter a name for your portfolio link - this name will be what Telemet Orion users click to choose their account(s). -Server: Replace host with the IP address or host name of a machine where you have installed the PortfolioLinkServer.exe file. Enter the port number used for the Portfolio Link. The default port is 8081, but you can change & use any port. If you do not use port 8081, the config.xml file must also be modified. o The Name & Server fields do not need parentheses. Click OK and then put a check in the "Portfolio Link" box to enable the "Portfolio Link" Add-In module. Page 9 of 11

10 Enabling the Portfolio Link Add in module for Portfolio Management features (Impact, Balance, Attribution, ect.): From the Telemet Orion Manager Window select: Functions -> Add-In console -> Portfolio Accounts the following window will appear: Click Data Storage Descriptors Click Data Storage Descriptors to get the following window: Now click Link, then enter the Portfolio Link Server information, and click Load as shown below: Page 10 of 11

11 Click Link, then input your Portfolio Link Server information, and then click Load All Portfolio Link setup steps are now complete. Steps for Telemet Orion users to access portfolios: To access portfolios from custom pages: Click Options - > "Account"-> Import Portfolio o Once account has been selected, the account can be saved as a Telemet ticker list by clicking Options -> Account -> Save as Ticker List To access portfolios from portfolio management features: From any portfolio management setup screen you will see a Text File choice, which will allow you to select your account(s). Page 11 of 11