Create Links to Data
We recently introduced two ways for you to create a link to a piece of data within OnePlace (i.e. a workplace, discussion, project, task, file, list or note).
Internal Data Links
The first way is by creating internal links to data, using a special 'data linking' syntax. This syntax is: {data type:data id:label}
- data type — This denotes the type of data you want to link to. Supported data types are: workplace, discussion, project, task, file, list, note.
- data id — This is the id of the piece of data you want to link to. You can find out what a data item's id is by looking at its details. You can do this by clicking on the little gray triangle icon shown next to the title of the data item. This will expand the details for the data item, and the id will be shown in the upper left of the details.
- label — This is an optional value in the syntax. When specified, this value will appear as the label for the link that is created. When omitted, OnePlace will use the title of the data item you are linking to.
The data linking syntax can be hand-entered into the following areas within OnePlace:
- Team pulses
- Discussions
- Inbasket notes
Note that when you receive system notifications from OnePlace in your inbasket, the notification contains this data linking syntax, which allows you to easily jump to the data item referenced by the notification. You can see this by editing a system notification in your inbasket.
Examples
Check out {task:500} — Creates a link to task #500. The task's title will be used for the label of the link.
Click {note:125:here} to view this note — Creates a link to note #125. The word 'here' will be used for the label of the link.
External Data Links (Perma-links)
External data links are used outside of OnePlace (such as in an email) to refer to data within OnePlace. Another name for this type of link is a perma-link. When you click on an external link, or enter the url for one into your browser, OnePlace will display the request data, provided you are authorized to view this data (see the Security section below). If you are not signed into OnePlace at the time you click on the link, you will need to sign in first to prove your identity.
The format of the external data links is: https://www.oneplacehome.com/data type/data id
Supported data types are: workplace, discussion, project, task, file, list, note.
Examples
https://www.oneplacehome.com/task/500 — Links to task #500 within OnePlace.
https://www.oneplacehome.com/discussion/200 — Links to discussion #200 within OnePlace.
Creating Data Links
There are two different ways to create internal and external data links. The first way is to craft them by hand as explained above. A second way, which may be easier, is to let OnePlace create them for you via the Data Links dialog (shown below).
You can access this dialog for any item by clicking the small "link" icon next to the Id field in the details for the item (called out with the red arrow below).
Security
Anyone can create internal and external links and use whatever id they like. Because of this, OnePlace will check the permissions of any user who clicks on a data link to ensure that they are authorized to access this data. If the user is not authorized, an appropriate security warning is displayed, and the user is not shown the requested data.
When an external data link that is published outside of OnePlace is clicked on by anyone, that person will need to be authenticated by OnePlace first (i.e. provide the proper sign in credentials), and then authorized (as explained in the paragraph above), before OnePlace will grant them access to this data.