OpenHAB
/
openhab-docs
mirror of https://github.com/openhab/openhab-docs.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update Things/Item config recommendation (#1055) 

* Update Things/Item config recommendation

Seems still some people manage to misread that.

* Update index.md

reworded GUI/files recommendation
as this is a source of problems to most OH users

* Apply suggestions from code review

Co-Authored-By: Jerome Luckenbach <github@luckenba.ch>

* Update index.md

some English-ification (sorry :))

* Added blockqute and newline

Signed-off-by: Jerome Luckenbach <github@luckenba.ch>
pull/1057/head
Markus Storm 2019-10-09 17:18:49 +02:00 committed by Jerome Luckenbach
parent 89503ba0de
commit 1dcfc03e38
1 changed files with 5 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
configuration/index.md
View File

@ -160,7 +160,11 @@ Please be aware that not every addon/binding of openHAB version 1.x has been upd
You can still run these but you need to use file configuration for them.
Things and Items can either be defined and managed in configuration files or handled by Paper UI in a [system-side database](/docs/administration/jsondb.html).
For Things and Items, both methods can be used **side-by-side**, e.g. a Thing can be discovered and created by Paper UI and the Items that link to that very same Thing (that Thing's Channels, actually) can be manually defined in a `.items` configuration file.
Both of the above described methods could be used parallel, e.g. a Thing can be discovered and created by Paper UI and the Items that link to that very same Thing (that Thing's Channels, actually) can be manually defined in a `.items` configuration file.
> While it's technically possible to use both methods in parallel, we recommend to choose only one of them to avoid confusion and a loss of overview of your openHAB environment.
> It would work to mix but you may easily forget about what is your "source of truth" when you reconfigure Things or Items at a later stage.
Configuration done in files will be used (and Things/Items become visible and even changeable in Paper UI) if no Thing/Item of the same name was already created in PaperUI, but you can NOT create a Thing or Item using files and then use Paper UI to **permanently** change it.
Configuration done in PaperUI will be used and permanently stored in the internal database if no Thing/Item of the same name already exists in files, but those additions or changes will not be copied back into any `.things` file.
openHAB settings as defined in `services/addons.cfg` and `services/runtime.cfg` will override any settings made in PaperUI's Configuration/System pane.