Skip to content

Commit 00b578a

Browse files
committed
updating new.md for built-in PP data source
1 parent fff4b51 commit 00b578a

File tree

3 files changed

+26
-8
lines changed

3 files changed

+26
-8
lines changed
87.7 KB
Loading
-23 KB
Binary file not shown.

docs/en/reference/file/new.md

Lines changed: 26 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: File > New
33
---
4-
# File ❯ New
4+
# File > New
55

66
With the `File > New` menu you can create the different assets Portfolio Performance can manage.
77

@@ -15,21 +15,39 @@ The option `File > New > File` initiates a wizard for creating a new portfolio.
1515

1616
## Security
1717

18-
The menu option `File > New > Security` is self-explaining: it allows you to create a new security. This can also be done at other locations within the UI; for example as part of the portfolio creation wizard (see above), or with the little green icon next to Securities in the sidebar or in the `All Securities`view.
18+
The menu option `File > New > Security` is self-explaining: it allows you to create a new security. This can also be done at other locations within the UI; for example as part of the portfolio creation wizard (see above), or with the little green icon next to Securities in the sidebar :octicons-plus-circle-16:{.green} or in the `All Securities`view.
1919

2020
Figure: File > New > Security menu.{class=pp-figure}
2121

22-
![](./images/mnu-file-new-security.png)
22+
![](images/mnu-file-new-instrument.png)
2323

24-
You can either choose to create a new empty instrument (e.g. security) or to search for an existing one. You can type (part of) the security name in the search box. Choosing from the drop-down box `All`, you can search for shares or bonds or both. After clicking the Search button, the list below will be populated with possible target instruments. The following fields are displayed for each instrument and will be used upon selecting the security: `Name`, `Symbol`, `ISIN`, `WKN`, `Type`, `Exchange`, `Currency`, and `Source` (see [Basic concepts > Portfolio Performance terminology](../../concepts/portfolio-performance-terminology.md) for a definition of each term).
24+
You can either create a new empty instrument (bottom left) or search for an existing one.
25+
Type (part of) the security name in the search box (e.g. `NVI`) and click on `Search`.
26+
Note that the search term is case-insensitive. All instruments containing the search term will be returned (e.g. Veolia eNVIronment).
2527

26-
Once the correct security has been selected, proceed to the next step by clicking on the Apply button. Some information such as name, symbol and historical quotes will already be filled in, based on the selected data source. You should always check the info, especially the stock market. All the info can be changed; even the name. Alternatively, one may initiate the process with an empty security (see Figure 3) and manually input the required information.
28+
With the buttons `EUR`, `USD`, `Share`, `Cryptocurrency` or `Commodity`, you can narrow the search results to instruments in the specified currency or type. If multiple result pages are available (e.g. 1/20), you can flip through the results with the `>` or `<` buttons (see Figure 2).
2729

28-
Figure: Input panel for the creation of a security.{class=pp-figure}
30+
The following fields are displayed for each instrument:
2931

30-
![](./images/securities-master-data.svg)
32+
- name of the instrument, e;g. NVIDIA CORP
33+
- type (e.g. share, Exchange-Traded Product (ETP) such as Exchange-Traded Funds (ETF), or commodity such as energy or metals)
34+
- the currencies in which the instrument is traded
35+
- the ISIN number of the instrument
36+
- the providerof the historical prices (CoinGecko, Yahoo Finance, or the built-in Portfolio Performance data source)
3137

32-
While only the `name` is obligatory, there are several other fields that need attention. They are grouped into 5 sub panels, marked with a yellow line in Figure 3.
38+
See [Basic concepts > Portfolio Performance terminology](../../concepts/portfolio-performance-terminology.md) for a definition of each term.
39+
40+
After selecting an instrument, the `Next` button becomes available, allowing you to select the specific exchange (London Stock Exchange (LSE), Deutsche Börse (XETRA), NASDAQ, etc.). Clicking `Next` will show the historical prices of the last three months for verification. In case of a wrong selection, you can always go back one step. Clicking `Apply` will create the instrument with all available historical prices.
41+
42+
Some information, such as name, currency, symbol, and historical quotes, will already be filled in based on the selected data source. You should always verify this information, especially the stock exchange. All details can be changed — even the name.
43+
44+
Alternatively, you may start with an empty security (see Figure 3) and manually enter the required information.
45+
46+
Figure: Input panel for the creation of a security.{class=pp-figure}
47+
48+
![](./images/securities-master-data.svg)
49+
50+
While only the `name` is obligatory, there are several other fields that need attention. They are grouped into 5 sub panels, marked with a yellow line in Figure 3.
3351

3452
- ### **Security Master Data**
3553

0 commit comments

Comments
 (0)