-
Notifications
You must be signed in to change notification settings - Fork 0
/
51000-dashboard-advanced.rmd
84 lines (42 loc) · 5.12 KB
/
51000-dashboard-advanced.rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
# Dashboard (advanced){#xdashboard-a}
### Using and sharing a view{#xsharing_view}
Click on:
- A **row** to load the associated filters into the current file.
- **The blue View number** to open the view in an other tab.
- **`Share` icon**: Copy the link and filter to your clipboard, for pasting into a document or sending to someone. If you send someone a shortlink to a view, when they click on it they will be taken to the *same view of the current file* (providing you have given them View or Edit rights to the file).
- **`Edit` icon**: Edit the view - [see below](#xedit_view)
- **`Hide` icon**: Hide this row in future from this table. You may want to use this button to clear unused views from your table. If you already shared this link with someone, it will still work even though it is hidden.
### ⭐ Recommended views versus 🤵custom views
#### ⭐ Recommended views
When you first create or copy a file, Causal Map will create for you some recommended views. These are marked with a star.
- These recommended views are copies specific for the current file. You can edit them later, or hide them if you don't want them.
- Some recommended views might not be shown in the list if they would not be relevant to the current file -- for example if you do not use [hierarchical coding](#xsimplifying-with-hierarchical), views which are only relevant to zooming are not shown. Occasionally you might see them appear later as you add features to your file, for example if you add hierarchical coding.
- Occasionally you might see additional recommended views added to the list as we publish new ones.
#### 🤵 Custom views - create your own
You can create your own views for the current file at any time.
![image-20220623083918159](_assets/image-20220623083918159.png)
Set your map or table up the way you want it then put an (optional) title and press Save.
- A shortlink to this view will also be copied into your clipboard so you can paste it straight into a document or send it to someone else.
- If you put a title, the view will also appear in the list of views for the current file.
- If you don't put a title, it won't be listed, but the shortlink you created will always point to that same view.
## Complete views versus "Add-ons"
Complete views replace the existing view and all the filters, included for example analysis filters which change the map itself, for example show only the most frequent links, or zoom out to the top level of a hierarchy. If you are looking at the Advanced Editor, you will see that the entire contents of the editor are replaced.
"Add-on" views are added after any other existing filters and do not replace them. So you can use them for example to add a particular kind of formatting, like making all the links pink, or to add one instruction, like "remove all links mentioned only once".
![image-20220808114607154](_assets/image-20220808114607154.png){width=650}
Complete views belong with the current file and you can edit them, whereas Add-ons exist separately of individual files (actually, they belong to `example-file`) and you can't edit them (unless you are an admin).
## To edit the content (filter, tab etc) of an existing view:{#xedit_view}
Set up the content the way you want it in the app, so it looks exactly the way it should when someone in the future clicks on the link. Then go to the filter which you want to update and press the edit button:
![Edit view](_assets/image-20221112171418559.png)
In the modal dialog which opens, make sure you check this box. You can optionally change the title too.
![image-20220808120110607](_assets/image-20220808120110607.png){width=650}
If all you want to do is change the title, make sure the checkbox is **not** checked.
## Applying a view
🧪 Each view has a unique number. They are shown in the dashboard. When you view a map which has been downloaded as an SVG image you will see this unique number in the bottom left-hand corner.
![image-20220808114935730](_assets/image-20220808114935730.png)
You can paste or type this number into this box at the bottom of the dashboard and press the arrow and the view will be applied. If the view is for a different file to which you have access, the app will first take you to that file.
## For admins
Recommended views can only be added / edited by admins, and only from `example-file`.
When you create a recommended view it should be applicable to almost any file, so don't use filters which refer to particular factor labels etc.
Recommended views are then copied to every other file. Editors can then edit, rename etc that recommended filter in the other file. But that won't change the original filter in `example-file`. Editors can hide a recommended filter in any other file except `example-file`, and it won't come back.
Addons work a bit differently from complete views - they can also only be created within `example-file`, but they are not copied to other files. As admin, you can create your own addons just for individual files if you want, by not clicking "recommended" -- maybe useful if you have a lot of steps you want to repeat just within a particular file.
To "delete" an addon, edit it and delete the title.