Post on 04-Mar-2015
Embed Size (px)
BLOOMBERG BASIC PORTFOLIO UPLOADER - BBU Upload File SpecificationDOCS 2050932
Table of Contents
ALPHA OVERVIEW BBU Overview BASIC UPLOAD Interactive and Scheduled Uploads (while logged in) File Description Data Requirements Step 1: Minimum Inputs Step 2: Set Your User Defaults Step 3: Begin Basic Upload Step 4: Upload your File Step 5: Click to Map Step 6: Spreadsheet Selection Step 7: File-level Mapping Step 8: Column Mapping Step 9: Map unknown security identifiers Step 10: Override Defaults Step 11: Check for Errors and Schedule Step 12: Schedule Basic Uploads MANAGING YOUR MAPPINGS___________ ___ BLOOMBERG SECURITY (FILE ENCRYPTION) FTP UPLOADS FREQUENTLY ASKED QUESTIONS (FAQs): Appendix 1: Column Mapping Definitions Appendix 2: Security Identifier Types Appendix 3: Ticker Formatting Equity Ticker US and Canadian Listed Equity and Equity Index Option Tickers Physical Index and Commodity Option Ticker Index and Commodity Future Ticker Cash Foreign Exchange Ticker Appendix 4: Additional Supporting Documentation
3 4 5 5 5 7 7 9 9 10 10 11 12 12 14 15 16 17 19 19 20 23 25 26 26 26 27 28 28 28 29
ALPHA OVERVIEWALPHA is Bloombergs Portfolio Analytics and Risk solution that offers an enhanced series of customizable tools for the desktop plus a new suit of products and services uniquely designed for a company-wide enterprise. In a world where your companys performance depends on the ability to manage complexity and consistently out-think the market, Bloomberg ALPHA Desktop, and ALPHA Enterprise support portfolio managers and senior management with a series of new and enhanced tools for portfolio analytics and risk. ALPHA Desktop is the single user version of ALPHA that is part of the BLOOMBERG PROFESSIONAL service. ALPHA Enterprise was built from the ground up, extending the capabilities of ALPHA Desktop to include Enterprise Management tools and sophisticated Enterprise reporting.
BBU OVERVIEWThe Bloomberg Uploader function (BBU) enables you to: Interactively upload portfolio data to the Bloomberg terminal from your desktop Schedule basic uploads of portfolio data from your desktop Schedule uploads of portfolio data via FTP over the internet or over a private leased line (see DOCS 2055407 for more information on FTP account setup)
The type of portfolio data BBU supports includes portfolio positions (current and historical), custom prices, custom benchmarks, and custom classifications. Input files can either conform to a specific format recognized by BBU, or users can take advantage of some basic mapping tools to instruct BBU on the layout and interpretation of their files. Once uploaded, portfolios can be viewed in any of the Bloomberg ALPHA functions for further definition and analysis. The remainder of this document will explain the process for uploading portfolio positions. Please see DOCS 2050935 for examples of uploading custom benchmarks, and DOCS 2050958 for examples of uploading custom classifications. ALPHA Desktop users can schedule the upload of a maximum of 50 portfolios per day (that is one scheduled upload file per portfolio, up to 50, or one file containing 50 portfolios). Any additional portfolios would have to be uploaded interactively. Users that need to schedule more than 50 portfolio uploads per day would need to subscribe to the ALPHA Enterprise service.
BASIC UPLOAD Interactive and Scheduled Uploads (while logged in)File DescriptionThe position file to be uploaded can be either a Microsoft Excel file (.xls or .xlsx) or an ASCII text file. Users typically set up a one-time mapping of the columns of data in their file so that BBU knows the delimiter to use as a data separator, which columns of data to import, and what those respective columns represent. If the portfolio name is not supplied, it defaults to the name of the uploaded file. One import file can contain positions for multiple portfolios. In addition, one import file can contain positions for multiple historical dates. You only need to load historical positions if you are interested in using ALPHAs performance-based analytics, such as HFA for historical fund analysis, or BBAT for return attribution. If you do choose to backfill history on a portfolio, note that you only need to upload those dates for which there is a change in your positions. ALPHA analytics will carry forward previously set positions if none are explicitly set on a given date. For those who maintain portfolios on an ongoing basis, todays positions can be added to an existing portfolio.
Data RequirementsThe minimum fields required to create a portfolio are the Portfolio Name, Base Currency and Asset Class Type (Balanced, Equity, Fixed Income or Fund of Funds), along with a listing of the positions: Security Identifier (e.g. Ticker, CUSIP, ISIN) and position size expressed as either a Weight (Fixed or Drifting) or Quantity (e.g. shares, par amount). Total Valuation for the portfolio is required when weights are entered. Optional position-level fields include: 1) (Additional) Security Identifier A position file can contain multiple Security Identifier columns. They will be read left to right and the first match against the Bloomberg database is the one used to load the position. This kind of waterfall logic is useful for mixed portfolios that might contain CUSIP for US holdings but ISIN for non-US, or Tickers for equity vs. CUSIP/ISIN for fixed income holdings. 2) Date The date associated with the position. The date format is driven by your User Defaults setting (see Step 2 below), and can be changed as part of the mapping process. If no date is supplied, the mapping rules will allow you to make a default assumption, typically set to Today (see Step 9 below for other options). 3) Market Price A client-supplied price to be used in valuing the position. 4) Exchange Bloomberg 2 character exchange code, defaults to composite exchange code of the owner of the portfolio. Alternatively, you can supply a custom exchange code string in this column and set up a mapping to the Bloomberg codes (an exchange code configuration screen will appear as part of the mapping process if you include this column).
5) Cost Price and Cost FX Rate The current day acquisition price and exchange rate. These are used to calculate intra-day performance in the PRT function. They are not used in performance-related functions that span a longer time period, such as BBAT and HFA.
In the following sections, we provide a step-by-step guide to the process of uploading your portfolios to the Bloomberg terminal. This includes setting some general user defaults, setting filespecific mapping instructions, and scheduling recurring uploads once the mapping rules are set.
Step 1: Review your portfolio positions file for minimum required inputsFigure 1 Sample Position File
With BBU, it is easy to upload a position file from an accounting package, custodian, or an Excel Spreadsheet. Figure 1 above shows a sample spreadsheet with holdings for two portfolios: Global Fund and Tech Fund. Global Fund contains positions for two dates, April 30, 2010 and May 28, 2010; the second portfolio, Tech Fund, has positions for June 1, 2010. For each of your holdings, you must supply these minimum fields: Security ID (e.g. CUSIP, ISIN, SEDOL, ticker) Quantity (e.g. original face amount for mortgage-related bonds, current face for nonmortgages, # shares for stocks), Portfolio Name (the upload file name becomes the portfolio name if not supplied)
Since this example includes historical positions, we also have a field indicating the Date of the position. (See Step 2 below for rules regarding Date formats.) Note that you do not have to provide column headings, or put the columns in any particular order. The column definitions will be identified by the mapping process. For global stock portfolios, if you supply ticker you must also provide the Exchange Code (see Appendix 3: Ticker Formatting). It is recommended that you use CUSIP, ISIN, or SEDOL rather than ticker as these are more accurate (e.g., COP is both the ISO currency code for the Columbian Peso and the equity ticker for ConocoPhillips. To distinguish the two, you need to supply the Bloomberg Yellow Key.) If you use CUSIP, ISIN, or SEDOL, you must include the check digit.
Step 2: Set Your User DefaultsFigure 2 Set Defaults
The first time you run BBU you must enter some default settings that will apply to each of your portfolio uploads. You can change these defaults at any time by clicking on the 3) User Defaults link at the top left of the screen. You can also override these defaults when setting up a specific file mapping. Doing so will not affect your default settings. The default setting choices are: Date Format - Choose the date format used in your position file:o o o MM/DD/YYYY or MM/DD/YY DD/MM/YYYY or DD/MM/YY YYYY/MM/DD or YYYYMMDD or YY/MM/DD
Number Format - Choose the number format used in your position file:o o nnn,nnn.dd nnn.nnn,dd
Currency - Choose the base currency of portfolio. Asset Class - Choose the asset class of the portfolio:o o o o Balanced Fixed Income Equity Fund of Funds
The Asset Class setting is used by ALPHA analytics and risk functions. Bypass Blank Quantity - Choose YES to bypass any holding with a blank quantity, or NO and produce an error for any holding with a blank quantity. Remember, uploads will fail with more than 2,000 errors, or when the file contains more than 50% errors. Divide cash and bond positions by 1000 - Choose YES to divide your cash and bond positions by 1,000 or NO to process your cash and bond positions exactly as they appear in the upload file. 8
Select 1) OK to save your defaults and continue the upload process.
Step 3: Begin Basic U