Professional Documents
Culture Documents
1 Spectra
1.1.1 Spectra
1.1.1.1 Overview
It has a number of worksheets, each providing a specific set of information that has been captured
on Invest One:
Tab called Security Distribution: provides holdings information on a portfolio for a specified
date.
Tab called Transaction analysis: provides transactional information on a portfolio for a
specified period
Tab called Fund trend: provides fund and fund class information for a specified date.
Tab called Exchange rates: provides the exchange rates between currencies for a specified
period.
Tab called Prices: provides the prices for specified securities for a specified period.
Tab called General Ledger: provides information contained in the Invest One Trial Balance
for a specified period.
1.1.1.2 Security Distribution
Security Distribution provides holdings information for a specified portfolio or a group of portfolios.
The extract can only be run for one day.
1.1.1.2.1 Functions
In the top left corner of Spectra you will see the below:
This is a once off setup by the Technology department and contains the server information (Host IP
and Port) and the user information (User Id and Operator). It is also used to navigate between the
test environment and the production environment. If you click on Connection setup the below box
comes up. You will notice that the information is the same as the green section above.
The Host IP for the production environment is 192.168.1.156
The Host IP for the test environment is 192.168.1.108
1.1.1.2.1.2 Clear
This function is used to delete information that might already be in Security Distribution and is not
required by the user.
1.1.1.2.1.3 Execute
This function is used to extract the portfolio holdings information from Invest One. It is normally done
after you cleared the information that may be in the Security Distribution sheet (see previous
section) and after inserting the required information in the “filters” (see section 1.1.1.2.2) and
“portfolio information requirements” section (see section 1.1.1.2.3).
1.1.1.2.1.4 Sort
This function is used to sort the information in the extract based on the user input.
1.1.1.2.1.5 Filter
1.1.1.2.1.6 Find
1.1.1.2.2.1 Item
In this field you will insert the applicable code for required data items (codes are covered in section
1.1.1.2.4).
CODE
DATA ITEM
1.1.1.2.2.2 Operand
1.1.1.2.2.3 Value
If you only want to know what the Sasol holdings are for a specified portfolio or all portfolios, you
can add this in the filter as below:
1.1.1.2.3.1 Account
In this section include the account number of the portfolio whose information you are looking for
1.1.1.2.3.2 View
Select Fund Account view. This is the only module we subscribe to.
Insert the date you want the information for. In Security distribution you can only request information
for one day.
If you select Y (for yes); only information on securities will generate. If you select N (for No); all
information for the portfolio will generate (including expenses, units, etc.).
1.1.1.2.3.5 Aggregate
From the example in 1.1.1.2.2.4 regarding Sasol: If you want to know the total holdings across all
portfolios only, and not per portfolio, change this to Y (for Yes). You will then extract the total for the
selected group of portfolios.
1.1.1.2.4 Codes
There is a lot of security level information that can be extracted from Spectra Security Distribution.
In order to do so you need to insert the relevant codes into Security Distribution. Data items, such
as Account name, are extracted by using the corresponding code, AD.
There is no set order in which the codes need to be inserted. Users will normally have their Security
Distributions setup differently based on the information required and the function being performed.
You also have the flexibility of moving codes around from a formatting perspective. If you have the
same code twice, the system will not generate any information, but it will let you know that there is a
duplication. All you need to do is to remove the duplicated code.
If you don’t know the code of the data item you are looking to extract, double click on any of the
codes in line 8. From the screen shot above, double click on “SN”.
A “Spectra items’ box will open:
The above shows the headings of the various data items that can be extracted from Spectra.
If you click on the “+” of any of the items, it will open up all the available information under this
heading.
You can now select the data item you want to extract by clicking on it and click “Ok”
1.1.1.2.5 Example: Extracting information from Spectra Security Distribution
For this example we will extract portfolio valuation information, per security for CBPF. The valuation
date is 30 March 2015:
Portfolio information: Insert the account number, and date. The information required is for a
valuation of the portfolio, CBPF, therefore we require all information – set Securities only and
Aggregate to N (No).
Filter: we want all information for the valuation, therefore the only filter item is “CV ! 0”. CV is the
code for Shares/ Par. What the filter means is that we will only extract information where the
shareholding is greater than nil (if the shareholding is nil, the valuation is nil as well. Therefore this
information is not required). If the portfolio held a share that was sold out, and the above filter is not
applied, the extract will include the share (it has no impact on the valuation, but by applying the filter
only relevant information is extracted).
Codes: Insert the codes for the information you want to extract. For the valuation we want to see
the security, the holding, the cost and the market value. We also want to see the price of the
security and for reasonability purposes we extract the prior day’s price and the movement from day
to day.
Extracting the information: Once the above has been filled in, click on clear and execute and the
Security Distribution will populate the information as shown in the screen shot above.
1.1.1.2.5.2 Extracting information for multiple accounts
For this example we will extract the Sasol holdings across all of our portfolios. The valuation date is
30 March 2015:
Portfolio information: Insert the account number (the group account number for all portfolios is
“9000”), and date. We want to see he information per portfolio – set Securities only and Aggregate
to N (No).
Filter: Insert “SN=SOL”. SN is the code for Security Number.
Codes: Insert the codes for the information you want to extract. For this extract we want the
holdings and market value for each portfolio.
Extracting the information: Once the above has been filled in, click on clear and execute and the
Security Distribution will populate the information as shown in the screen shot above.
1.1.1.3 Transaction analysis
In the top left corner of Spectra you will see the below:
This is a once off setup by the Technology department and contains the server information (Host IP
and Port) and the user information (User Id and Operator). It is also used to navigate between the
test environment and the production environment. If you click on Connection setup the below box
comes up. You will notice that the information is the same as the green section above.
The Host IP for the production environment is 192.168.1.156
The Host IP for the test environment is 192.168.1.108
1.1.1.3.1.2 Clear
This function is used to delete information that might already be in Security Distribution and is not
required by the user.
1.1.1.3.1.3 Execute
This function is used to extract the portfolio holdings information from Invest One. It is normally done
after you cleared the information that may be in the Security Distribution sheet (see previous
section) and after inserting the required information in the “filters” (see section 1.1.1.2.2) and
“portfolio information requirements” section (see section 1.1.1.2.3).
1.1.1.3.1.4 Sort
This function is used to sort the information in the extract based on the user input.
1.1.1.3.1.5 Filter
1.1.1.3.1.6 Find
1.1.1.3.2.1 Item
In this field you will insert the applicable code for required data items (codes are covered in section
1.1.1.2.4).
CODE
DATA ITEM
1.1.1.3.2.2 Operand
1.1.1.3.2.3 Value
If you only want to know what the transaction was executed for Sasol for a specified portfolio or all
portfolios, you can add this in the filter as below:
1.1.1.3.3.1 Account
In this section include the account number of the portfolio whose information you are looking for
1.1.1.3.3.2 View
Select Fund Account view. This is the only module we subscribe to.
Insert the date you want the information for. If it is for one day you can make the “from date” and the
“to date” the same; or insert the period you require if the required information is over this period.
1.1.1.3.3.4 Date type
Effective date/ Entry date – the date the transaction was processed
Trade date – the “trade date” of the transaction. This can be the same as the effective date for some
transactions.
Contractual/ Actual settle date – normally the same. This is the settlement date of the transaction.
Generated date – applicable to corporate actions. This is the date the system will generate the
transaction based on the inputs from the user.
1.1.1.3.3.5 Positions
No Positions – this will only extract transactions for the period requested
All Positions – this will extract all holdings for the requested portfolio/ group of portfolios. If there was
no transactions for a security a nil value will be displayed in all the fields (the data items requested –
see 1.1.1.3.4)
1.1.1.3.4 Codes
There is a lot of transactional information that can be extracted from Spectra Transaction Analysis.
In order to do so you need to insert the relevant codes into Transaction Analysis. Data items, such
as Account name, are extracted by using the corresponding code, AD.
There is no set order in which the codes need to be inserted. Users will normally have their
Transaction Analysis setup differently based on the information required and the function being
performed. You also have the flexibility of moving codes around from a formatting perspective. If
you have the same code twice, the system will not generate any information, but it will let you know
that there is a duplication. All you need to do is to remove the duplicated code.
Codes are normally placed in line 8 of the Security Distribution:
If you don’t know the code of the data item you are looking to extract, double click on any of the
codes in line 8. From the screen shot above, double click on “SN”.
The above shows the headings of the various data items that can be extracted from Spectra.
If you click on the “+” of any of the items, it will open up all the available information under this
heading.
You can now select the data item you want to extract by clicking on it and click “Ok”
1.1.1.3.5 Example: Extracting information from Spectra Transaction Analysis
For this example we will extract transactional information processed for CBPF on 30 March 2015:
Extracting the information: Once the above has been filled in, click on clear and execute and the
Security Distribution will populate the information as shown in the screen shot above.
1.1.1.3.5.2 Extracting information for multiple accounts
For this example we will extract the Sasol trades processed across all of our portfolios for the period
1 January 2015 to 30 March 2015:
Portfolio information: Insert the account number (the group account number for all portfolios is
“9000”), and date.
Filter: Insert “SN=SOL”. SN is the code for Security Number.
Codes: Insert the codes for the information you want to extract. For this extract we want the
holdings and market value for each portfolio.
Extracting the information: Once the above has been filled in, click on clear and execute and the
Security Distribution will populate the information as shown in the screen shot above.
1.1.1.4 Fund Trend
Fund trend provides Fund and Fund class information for a specified portfolio or a group of
portfolios. The extract can be run for one day or for a period.
1.1.1.4.1 Functions
In the top left corner of Spectra you will see the below:
This is a once off setup by the Technology department and contains the server information (Host IP
and Port) and the user information (User Id and Operator). It is also used to navigate between the
test environment and the production environment. If you click on Connection setup the below box
comes up. You will notice that the information is the same as the green section above.
The Host IP for the production environment is 192.168.1.156
The Host IP for the test environment is 192.168.1.108
1.1.1.4.1.2 Clear
This function is used to delete information that might already be in Security Distribution and is not
required by the user.
1.1.1.4.1.3 Execute
This function is used to extract the portfolio holdings information from Invest One. It is normally done
after you cleared the information that may be in the Security Distribution sheet (see previous
section) and after inserting the required information in the “filters” (see section 1.1.1.2.2) and
“portfolio information requirements” section (see section 1.1.1.2.3).
1.1.1.4.1.4 Sort
This function is used to sort the information in the extract based on the user input.
1.1.1.4.1.5 Filter
1.1.1.4.1.6 Find
1.1.1.4.2.1 Item
In this field you will insert the applicable code for required data items (codes are covered in section
1.1.1.2.4).
CODE
DATA ITEM
1.1.1.4.2.2 Operand
1.1.1.4.2.3 Value
1.1.1.4.3.1 Account
In this section include the account number of the portfolio whose information you are looking for
1.1.1.4.3.2 View
Select Fund Account view. This is the only module we subscribe to.
Where multiple classes are applicable: insert the class number or 99 if you want all classes.
Where multiple classes are not applicable: insert 0 or 99
Insert the date you want the information for. If it is for multiple periods insert the latest date. See the
next 2 section, Periods and Period types for multiple periods.
1.1.1.4.3.5 Periods
If for example you want information for the 15th of each month for the last year insert 12 in this field;
in the Request date field (1.1.1.4.3.4 above) insert the 15th of the last month and year you want
populated (example 15 March 2015). In the period type field ( see 1.1.1.4.3.6 below) select
“months”.
The information will populate for 15 April 2014, 15 May 2014, 15 June 2014, 15 July,…15 March
2015.
1.1.1.4.3.6 Period Type
Valuations/ Days – provide information per day where the input into the Periods field is greater than
1.
When information is requested for more than one day:
Where days are selected the information will extract from the latest to the earliest
date
Where valuations are selected the information will extract from the earliest to the
latest date
Months – provides information per month where the input into the Periods field is greater than 1.
Quarters – provides information per quarter where the input into the Periods field is greater than 1.
Years – provides information per year where the input into the Periods field is greater than 1.
All following – provides information per day following the date inserted in the request date field.
1.1.1.4.4 Codes
There is a lot of Fund level and Fund class level information that can be extracted from Spectra
Fund Trend. In order to do so you need to insert the relevant codes into Transaction Analysis. Data
items, such as Account name, are extracted by using the corresponding code, AD.
There is no set order in which the codes need to be inserted. Users will normally have their Fund
Trend setup differently based on the information required and the function being performed. You
also have the flexibility of moving codes around from a formatting perspective. If you have the same
code twice, the system will not generate any information, but it will let you know that there is a
duplication. All you need to do is to remove the duplicated code.
Codes are normally placed in line 8 of the Security Distribution:
If you don’t know the code of the data item you are looking to extract, double click on any of the
codes in line 8. From the screen shot above, double click on “DT”.
The above shows the headings of the various data items that can be extracted from Spectra.
If you click on the “+” of any of the items, it will open up all the available information under this
heading.
You can now select the data item you want to extract by clicking on it and click “Ok”
1.1.1.4.5 Example: Extracting information from Spectra Transaction Analysis
For this example we will extract portfolio valuation information, per class for CBPF. The valuation
date is 30 March 2015:
Portfolio information: Insert the account number, and date. For class of shares insert 99 as we
want all classes; or should you only require information for one class, insert the class number. For
“Periods” insert 1 and for “Period Type” select “valuations” or “days”.
Filter: we want all information for the valuation, therefore leave it blank.
Codes: Insert the codes for the information you want to extract.
Extracting the information: Once the above has been filled in, click on clear and execute and the
Security Distribution will populate the information as shown in the screen shot above.
1.1.1.4.5.2 Extracting information for multiple accounts
For this example we will extract the Fund AUM for all of the CIS portfolios for 30 March 2015:
Portfolio information: Insert the account number (9009 for the CIS group), and date. For class of
shares insert 0 (for total fund) as we want AUM per fund; or should you want AUM for a particular
class, insert the class number. For “Periods” insert 1 and for “Period Type” select “valuations” or
“days.
Filter: we want all information for the valuation, therefore leave it blank.
Codes: Insert the codes for the information you want to extract. For this extract we want the
holdings and market value for each portfolio.
Extracting the information: Once the above has been filled in, click on clear and execute and the
Security Distribution will populate the information as shown in the screen shot above.
1.1.1.4.5.3 Extracting information for multiple periods
For this example we will extract the Fund AUM for CBPF per quarter from 31 March 2014 to 31
March 2015 for Class C (zero fee class):
Portfolio information: Insert the account number for CBPF, and date (note that the latest date is
inserted, i.e. 31 March 2015). For class of shares insert 3 (Class C). For “Periods” insert 5 and for
“Period Type” select “quarters”.
Filter: we want all information for the valuation, therefore leave it blank.
Codes: Insert the codes for the information you want to extract. For this extract we want the
holdings and market value for each portfolio.
Extracting the information: Once the above has been filled in, click on clear and execute and the
Security Distribution will populate the information as shown in the screen shot above.
1.1.1.5 Exchange rates
From the Exchange rates tab, you can extract the exchange rates that has been uploaded onto
Invest One. The extract can be run for one day or for a period.
1.1.1.5.1 Functions
In the top left corner of Spectra you will see the below:
This is a once off setup by the Technology department and contains the server information (Host IP
and Port) and the user information (User Id and Operator). It is also used to navigate between the
test environment and the production environment. If you click on Connection setup the below box
comes up. You will notice that the information is the same as the green section above.
The Host IP for the production environment is 192.168.1.156
The Host IP for the test environment is 192.168.1.108
1.1.1.5.1.2 Clear
This function is used to delete information that might already be in Security Distribution and is not
required by the user.
1.1.1.5.1.3 Execute
This function is used to extract the portfolio holdings information from Invest One. It is normally done
after you cleared the information that may be in the Security Distribution sheet (see previous
section) and after inserting the required information in the “filters” (see section 1.1.1.2.2) and
“portfolio information requirements” section (see section 1.1.1.2.3).
1.1.1.5.1.4 Sort
This function is used to sort the information in the extract based on the user input.
1.1.1.5.1.5 Filter
1.1.1.5.1.6 Find
1.1.1.5.2.1 Item
In this field you will insert the applicable code for required data items (codes are covered in section
1.1.1.2.4).
CODE
DATA ITEM
1.1.1.5.2.2 Operand
1.1.1.5.2.3 Value
Insert the date for which you require the exchange rate. If you require the rates for a period insert
the latest date.
Insert the base currency. If you are querying rates for a South African portfolio the base currency
will be ZAR. If you are querying rates for a global portfolio the base currency will be USD or GBP
(OCVBF).
1.1.1.5.3.3 Currency
Insert the currency you want to see against the base currency.
Always “OA”. “OA” is short for Oasis. When uploading prices or exchange rates a source is
required. As we upload prices and exchange rates the source was setup as Oasis.
There is no set order in which the codes need to be inserted. Users will normally have their
exchange rates setup differently based on the information required and the function being
performed. You also have the flexibility of moving codes around from a formatting perspective. If
you have the same code twice, the system will not generate any information, but it will let you know
that there is a duplication. All you need to do is to remove the duplicated code.
If you don’t know the code of the data item you are looking to extract, double click on any of the
codes in line 8. From the screen shot above, double click on “DT”.
The above shows the headings of the various data items that can be extracted from Spectra.
If you click on the “+” of any of the items, it will open up all the available information under this
heading.
Example: click on the “+” next to Price Exchange Rates:
You can now select the data item you want to extract by clicking on it and click “Ok”
For this example we will extract exchange rates uploaded for CBPF on 30 March 2015:
Exchange rate information: Insert the date. Base currency is ZAR. For currency we insert “ALL” as
we want all the exchange rates uploaded on this day. If you want a specific currency, insert it here
(USD, etc.
Periods: Insert 1 (for one day) and we you require multiple days insert the number of days.
Codes: Insert the codes for the information you want to extract..
Extracting the information: Once the above has been filled in, click on clear and execute and the
Security Distribution will populate the information as shown in the screen shot above.
1.1.1.6 Prices
From the Prices tab, you can extract the prices that has been uploaded onto Invest One. The extract
can be run for one day or for a period.
1.1.1.6.1 Functions
In the top left corner of Spectra you will see the below:
This is a once off setup by the Technology department and contains the server information (Host IP
and Port) and the user information (User Id and Operator). It is also used to navigate between the
test environment and the production environment. If you click on Connection setup the below box
comes up. You will notice that the information is the same as the green section above.
The Host IP for the production environment is 192.168.1.156
The Host IP for the test environment is 192.168.1.108
1.1.1.6.1.2 Clear
This function is used to delete information that might already be in Security Distribution and is not
required by the user.
1.1.1.6.1.3 Execute
This function is used to extract the portfolio holdings information from Invest One. It is normally done
after you cleared the information that may be in the Security Distribution sheet (see previous
section) and after inserting the required information in the “filters” (see section 1.1.1.2.2) and
“portfolio information requirements” section (see section 1.1.1.2.3).
1.1.1.6.1.4 Sort
This function is used to sort the information in the extract based on the user input.
1.1.1.6.1.5 Filter
1.1.1.6.1.6 Find
1.1.1.6.2.1 Item
In this field you will insert the applicable code for required data items (codes are covered in section
1.1.1.2.4).
CODE
DATA ITEM
1.1.1.6.2.2 Operand
1.1.1.6.2.3 Value
Insert the date for which you require the prices. If you require the prices for a period insert the latest
date.
Insert the base currency. If you are querying rates for a South African portfolio the base currency
will be ZAR. If you are querying rates for a global portfolio the base currency will be USD or GBP
(OCVBF).
Always “OA”. “OA” is short for Oasis. When uploading prices or exchange rates a source is
required. As we upload prices and exchange rates the source was setup as Oasis.
Insert the account number if you want the information for a specific portfolio. Alternatively leave it
blank.
1.1.1.6.3.6 Periods
Days – provide information per day where the input into the Periods field is greater than 1.
Weeks – provides information per week where the input into the Periods field is greater than 1.
Months – provides information per month where the input into the Periods field is greater than 1.
Quarters – provides information per quarter where the input into the Periods field is greater than 1.
Years – provides information per year where the input into the Periods field is greater than 1.
All following – provides information per day following the date inserted in the request date field.
1.1.1.6.3.8 Security
Insert the security code whose price you are looking for. If it’s left bank no information will populate.
1.1.1.6.4 Codes
There is no set order in which the codes need to be inserted. Users will normally have their Prices
setup differently based on the information required and the function being performed. You also have
the flexibility of moving codes around from a formatting perspective. If you have the same code
twice, the system will not generate any information, but it will let you know that there is a duplication.
All you need to do is to remove the duplicated code.
Codes are normally placed in line 8 of the Security Distribution:
If you don’t know the code of the data item you are looking to extract, double click on any of the
codes in line 8. From the screen shot above, double click on “DT”.
The above shows the headings of the various data items that can be extracted from Spectra.
If you click on the “+” of any of the items, it will open up all the available information under this
heading.
Example: click on the “+” next to Price Exchange Rates:
You can now select the data item you want to extract by clicking on it and click “Ok”
1.1.1.6.5 Example: Extracting information from Spectra Prices
For this example we will extract the price of OCEFC for CBPF on 30 March 2015:
Price information: Insert the date. Rate source is “OA”. Rate Time is “16” and Rate type is “00”.
The account number for CBPF is “10002”
Periods: Insert 1 (for one day) and we you require multiple days insert the number of days.
Security: insert OCEFC (or the security whose price you want)
Codes: Insert the codes for the information you want to extract..
Extracting the information: Once the above has been filled in, click on clear and execute and the
Security Distribution will populate the information as shown in the screen shot above.
1.1.1.7 General ledger
The general ledger provides the same information that can be found in the Trial Balance. This
includes information on assets and liabilities, shareholders equity, and income and expenses for a
specified portfolio or group of portfolios and period. The extract can only be run for a period (not for
one day).
1.1.1.7.1 Functions
In the top left corner of Spectra you will see the below:
This is a once off setup by the Technology department and contains the server information (Host IP
and Port) and the user information (User Id and Operator). It is also used to navigate between the
test environment and the production environment. If you click on Connection setup the below box
comes up. You will notice that the information is the same as the green section above.
The Host IP for the production environment is 192.168.1.156
The Host IP for the test environment is 192.168.1.108
1.1.1.7.1.2 Clear
This function is used to delete information that might already be in Security Distribution and is not
required by the user.
1.1.1.7.1.3 Execute
This function is used to extract the portfolio holdings information from Invest One. It is normally done
after you cleared the information that may be in the Security Distribution sheet (see previous
section) and after inserting the required information in the “filters” (see section 1.1.1.2.2) and
“portfolio information requirements” section (see section 1.1.1.2.3).
1.1.1.7.1.4 Sort
This function is used to sort the information in the extract based on the user input.
1.1.1.7.1.5 Filter
1.1.1.7.1.6 Find
1.1.1.7.2.1 Item
In this field you will insert the applicable code for required data items (codes are covered in section
1.1.1.2.4).
CODE
DATA ITEM
1.1.1.7.2.2 Operand
1.1.1.7.2.3 Value
If you want information for all classes leave the filter blank. If you information at a total fund level
insert “CS=0”; for information for class 1 insert CS=1; etc.
Item Operand Value
Filter 1: = 4000
Filter 2: cs = 0
Filter 3: = 4000
Filter 4: ! 0
Filter 5: ! X001
1.1.1.7.3.1 Account
In this section include the account number of the portfolio whose information you are looking for
1.1.1.7.3.2 View
Select Fund Account view. This is the only module we subscribe to.
Insert the period you want the information for. If the dates are the same you will receive the below
error:
1.1.1.7.3.4 Securities Only
If you select Y (for yes); only information on securities will generate. If you select N (for No); all
information for the portfolio will generate (including expenses, units, etc.).
Always select “Summary only”/ “Both”. “Detail only” will return no data.
1.1.1.7.4 Codes
There is no set order in which the codes need to be inserted. Users will normally have their General
ledger setup differently based on the information required and the function being performed. You
also have the flexibility of moving codes around from a formatting perspective. If you have the same
code twice, the system will not generate any information, but it will let you know that there is
duplication. All you need to do is to remove the duplicated code.
If you don’t know the code of the data item you are looking to extract, double click on any of the
codes in line 8. From the screen shot above, double click on “AN”.
A “Spectra items’ box will open:
The above shows the headings of the various data items that can be extracted from Spectra.
If you click on the “+” of any of the items, it will open up all the available information under this
heading.
You can now select the data item you want to extract by clicking on it and click “Ok”
1.1.1.7.5 Example: Extracting information from Spectra Security Distribution
For this example we will extract expense information for CBPF for the period 30 March 2015 to 31
March 2015:
Extracting the information: Once the above has been filled in, click on clear and execute and the
Security Distribution will populate the information as shown in the screen shot above.