Skip to main content

Documents

The value of a topic can be a document, such as a PDF or an image. This can be used to store information such as instruction manuals, photos, 3D models and structured text. There are built-in viewers for JPG, PNG, PDF, MARKDOWN and GLTF.

Upload​

To upload a document create a new topic and enter a name such as asset.hvac.bosch.photo. Click on the Upload icon or select the Upload options from the menu. If you are running on a mobile device you can make a picture with the camera or select a photo from your library. If you are running on a computer you can select a file. After the file is uploaded to the server the value of the topic is set to the name of the file. Other topics can now also use this file by entering the same name in the value of the topic.

Update​

You can update documents for topics in two ways. One way is to change the document for a specific topic and the other way to update the current version of a document for all topics. For example, if you have three solar panels of 370 Watt they all link to the same document solar_370.png:

property.home.solarpanel_01.photo = solar_370.png 
property.home.solarpanel_02.photo = solar_370.png 
property.home.solarpanel_03.photo = solar_370.png

If you want to change the document for a specific topic you can open the topic details, click Upload and select a document with another name. In this case only the current topic will be affected. For example, if for some reason the first solar panel is replaced with a different brand you can open solarpanel_01.photo and upload a new image hyundai_390.png. The result is as follows: 

property.home.solarpanel_01.photo = hyunday_390.png 
property.home.solarpanel_02.photo = solar_370.png 
property.home.solarpanel_03.photo = solar_370.png

If you want to change the document for all topics you can upload a new image with the same name solar_370.png. The new version will replace the current document and all topics that link to this document will point to the new version.

Versions​

When a document is uploaded with a name that is already in the system a new version is created. This enables you to create a timeline where you can review changes in photos over time. For example, you can see a photo of a person by date or the condition of a roof over time. To manage document versions click on Documents in the side menu and enter a search term and press Enter. Click on an item in the list to open the image and version viewer.

To upload a new version of the document click Upload and select a document from your computer or image library. The document may have a different file name and is automatically renamed to the current document name. To view a different version of a document click on one of the versions listed below the image. You can Download the version that is currently displayed. To add comments select Edit from the menu, enter a comment and Save. When you upload a document the time is set to the current date. You can change the date and time of a document version manually, for example if you upload an image of a person or device from a few years ago.

Delete​

To delete a file and all versions select Delete from the menu. To delete all versions of a file except the latest select Purge. To delete multiple files enter a search term and click Enter. Select Delete from the list menu and confirm that all displayed files should be deleted.