Include - Versionsgeschichte

Krikan: FHEM(R)

2017-01-24T15:44:13Z

FHEM(R)

← Nächstältere Version		Version vom 24. Januar 2017, 17:44 Uhr
Zeile 1:		Zeile 1:
	{{SEITENTITEL:include}}		{{SEITENTITEL:include}}
	{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Liest eine Konfigurations-Datei in ~~Fhem~~ ein		\|ModPurpose=Liest eine Konfigurations-Datei in FHEM ein
	\|ModType=cmd		\|ModType=cmd
	\|ModCmdRef=include		\|ModCmdRef=include
Zeile 10:		Zeile 10:
	== Allgemeines ==		== Allgemeines ==
	Der Befehl [[include]] gehört zu den FHEM-eigenen Befehlen. Mit ihm kann eine andere Datei eingelesen und ausgeführt werden. Ein typischer Anwendungsfall ist Verteilung bzw. Auslagerung von Plaintext-basierten FHEM-Konfigurationen auf mehrere Dateien. Bei Nutzung der neueren [[Konfiguration#Konfiguration_in_einer_SQL_Datenbank\|datenbankbasierten Konfiguration]] widerspricht die Verwendung dem Konzept und ist letztlich nicht möglich.		Der Befehl [[include]] gehört zu den FHEM-eigenen Befehlen. Mit ihm kann eine andere Datei eingelesen und ausgeführt werden. Ein typischer Anwendungsfall ist Verteilung bzw. Auslagerung von Plaintext-basierten FHEM-Konfigurationen auf mehrere Dateien. Bei Nutzung der neueren [[Konfiguration#Konfiguration_in_einer_SQL_Datenbank\|datenbankbasierten Konfiguration]] widerspricht die Verwendung dem Konzept und ist letztlich nicht möglich.
	{{Randnotiz\|RNTyp=r\|RNText='''Hinweis:''' Die Verwendung des Befehls [[include]] gehört zum '''"Expertenmodus"'''. Sie sollte nur bei detaillierter Kenntnis der Auswirkungen gewählt werden. Bei Verwendung von includes (wie generell bei direktem Bearbeiten der Konfigurationsdatei(en)) können Fehler auftreten, die allein auf der Reihenfolge der Abarbeitung von Definitionen beruhen. Bei alleiniger Bearbeitung der Konfiguration über die Benutzeroberfläche trägt ~~Fhem~~ selbst Sorge dafür, dass die erforderliche Reihenfolge eingehalten wird.}}		{{Randnotiz\|RNTyp=r\|RNText='''Hinweis:''' Die Verwendung des Befehls [[include]] gehört zum '''"Expertenmodus"'''. Sie sollte nur bei detaillierter Kenntnis der Auswirkungen gewählt werden. Bei Verwendung von includes (wie generell bei direktem Bearbeiten der Konfigurationsdatei(en)) können Fehler auftreten, die allein auf der Reihenfolge der Abarbeitung von Definitionen beruhen. Bei alleiniger Bearbeitung der Konfiguration über die Benutzeroberfläche trägt FHEM selbst Sorge dafür, dass die erforderliche Reihenfolge eingehalten wird.}}

	Wenn die [[Konfiguration]] von FHEM mit der Zeit wächst und man die Konfiguration unbedingt direkt mit dem integrierten oder einem externen Editor bearbeiten möchte, wird sie schnell zu unübersichtlich. Dann kann es sich anbieten, nicht mehr alle Konfigurationen in der einen fhem.cfg zu machen, sondern sie in verschiedene eigene Konfigurations-Dateien auszulagern. Diese werden dann in der "Haupt-Konfiguration" fhem.cfg mithilfe von <code>include</code> eingebunden.		Wenn die [[Konfiguration]] von FHEM mit der Zeit wächst und man die Konfiguration unbedingt direkt mit dem integrierten oder einem externen Editor bearbeiten möchte, wird sie schnell zu unübersichtlich. Dann kann es sich anbieten, nicht mehr alle Konfigurationen in der einen fhem.cfg zu machen, sondern sie in verschiedene eigene Konfigurations-Dateien auszulagern. Diese werden dann in der "Haupt-Konfiguration" fhem.cfg mithilfe von <code>include</code> eingebunden.
Zeile 17:		Zeile 17:
	* Sämtliche <code>attr global</code> Definitionen '''müssen''' in der fhem.cfg bleiben.		* Sämtliche <code>attr global</code> Definitionen '''müssen''' in der fhem.cfg bleiben.
	* Nur Konfigurationsdateien, die im Verzeichnis <code><installationsverzeichnis>/FHEM/</code> liegen, werden unter "Edit files" im Abschnitt "Own modules and helper files" zur Bearbeitung mit dem integrierten Editor aufgeführt. Ansonsten muss man auf diese Dateien per remote-Sitzung oder mit einem anderen Programm (SSH / FTP) zugreifen.		* Nur Konfigurationsdateien, die im Verzeichnis <code><installationsverzeichnis>/FHEM/</code> liegen, werden unter "Edit files" im Abschnitt "Own modules and helper files" zur Bearbeitung mit dem integrierten Editor aufgeführt. Ansonsten muss man auf diese Dateien per remote-Sitzung oder mit einem anderen Programm (SSH / FTP) zugreifen.
	* Um Änderungen in den "Teil-Konfigurationen" zu aktivieren, muss die "Haupt-Konfiguration" fhem.cfg neu eingelesen oder der ~~fhem~~ neu gestartet werden.		* Um Änderungen in den "Teil-Konfigurationen" zu aktivieren, muss die "Haupt-Konfiguration" fhem.cfg neu eingelesen oder der FHEM neu gestartet werden.
	[[Datei:Include_CFGFN.png\|mini\|374px\|right\|Name der Datei, in der das Objekt definiert ist]]		[[Datei:Include_CFGFN.png\|mini\|374px\|right\|Name der Datei, in der das Objekt definiert ist]]
	In den Details von Objekten, deren Definition in einer ''include'' Datei steht, findet sich bei den ''Internals'' unter '''CFGFN''' der Name der include-Datei (siehe Screenshot).		In den Details von Objekten, deren Definition in einer ''include'' Datei steht, findet sich bei den ''Internals'' unter '''CFGFN''' der Name der include-Datei (siehe Screenshot).
Zeile 43:		Zeile 43:

	#		#
	# ~~fhem~~ System configs		# FHEM System configs
	#		#

Ph1959de: Info über CFGFN eingefügt

2015-08-17T12:32:50Z

Info über CFGFN eingefügt

← Nächstältere Version		Version vom 17. August 2015, 14:32 Uhr
Zeile 18:		Zeile 18:
	* Nur Konfigurationsdateien, die im Verzeichnis <code><installationsverzeichnis>/FHEM/</code> liegen, werden unter "Edit files" im Abschnitt "Own modules and helper files" zur Bearbeitung mit dem integrierten Editor aufgeführt. Ansonsten muss man auf diese Dateien per remote-Sitzung oder mit einem anderen Programm (SSH / FTP) zugreifen.		* Nur Konfigurationsdateien, die im Verzeichnis <code><installationsverzeichnis>/FHEM/</code> liegen, werden unter "Edit files" im Abschnitt "Own modules and helper files" zur Bearbeitung mit dem integrierten Editor aufgeführt. Ansonsten muss man auf diese Dateien per remote-Sitzung oder mit einem anderen Programm (SSH / FTP) zugreifen.
	* Um Änderungen in den "Teil-Konfigurationen" zu aktivieren, muss die "Haupt-Konfiguration" fhem.cfg neu eingelesen oder der fhem neu gestartet werden.		* Um Änderungen in den "Teil-Konfigurationen" zu aktivieren, muss die "Haupt-Konfiguration" fhem.cfg neu eingelesen oder der fhem neu gestartet werden.
			[[Datei:Include_CFGFN.png\|mini\|374px\|right\|Name der Datei, in der das Objekt definiert ist]]
			In den Details von Objekten, deren Definition in einer ''include'' Datei steht, findet sich bei den ''Internals'' unter '''CFGFN''' der Name der include-Datei (siehe Screenshot).

	== Beispiel einer verteilten Konfiguration ==		== Beispiel einer verteilten Konfiguration ==

Ph1959de: (Als Vorschlag:) Hinweistext/Warnung auf "Randnotiz" umgestellt

2015-03-03T17:49:59Z

(Als Vorschlag:) Hinweistext/Warnung auf "Randnotiz" umgestellt

← Nächstältere Version		Version vom 3. März 2015, 19:49 Uhr
Zeile 9:		Zeile 9:

	== Allgemeines ==		== Allgemeines ==

	Der Befehl [[include]] gehört zu den FHEM-eigenen Befehlen. Mit ihm kann eine andere Datei eingelesen und ausgeführt werden. Ein typischer Anwendungsfall ist Verteilung bzw. Auslagerung von Plaintext-basierten FHEM-Konfigurationen auf mehrere Dateien. Bei Nutzung der neueren [[Konfiguration#Konfiguration_in_einer_SQL_Datenbank\|datenbankbasierten Konfiguration]] widerspricht die Verwendung dem Konzept und ist letztlich nicht möglich.		Der Befehl [[include]] gehört zu den FHEM-eigenen Befehlen. Mit ihm kann eine andere Datei eingelesen und ausgeführt werden. Ein typischer Anwendungsfall ist Verteilung bzw. Auslagerung von Plaintext-basierten FHEM-Konfigurationen auf mehrere Dateien. Bei Nutzung der neueren [[Konfiguration#Konfiguration_in_einer_SQL_Datenbank\|datenbankbasierten Konfiguration]] widerspricht die Verwendung dem Konzept und ist letztlich nicht möglich.
			{{Randnotiz\|RNTyp=r\|RNText='''Hinweis:''' Die Verwendung des Befehls [[include]] gehört zum '''"Expertenmodus"'''. Sie sollte nur bei detaillierter Kenntnis der Auswirkungen gewählt werden. Bei Verwendung von includes (wie generell bei direktem Bearbeiten der Konfigurationsdatei(en)) können Fehler auftreten, die allein auf der Reihenfolge der Abarbeitung von Definitionen beruhen. Bei alleiniger Bearbeitung der Konfiguration über die Benutzeroberfläche trägt Fhem selbst Sorge dafür, dass die erforderliche Reihenfolge eingehalten wird.}}

	~~<span style="color: red">~~		Wenn die [[Konfiguration]] von FHEM mit der Zeit wächst und man die Konfiguration unbedingt direkt mit dem integrierten oder einem externen Editor bearbeiten möchte, wird sie schnell zu unübersichtlich. Dann kann es sich anbieten, nicht mehr alle Konfigurationen in der einen fhem.cfg zu machen, sondern sie in verschiedene eigene Konfigurations-Dateien auszulagern. Diese werden dann in der "Haupt-Konfiguration" fhem.cfg mithilfe von <code>include</code> eingebunden.
	'''Hinweis:''' Die Verwendung des Befehls [[include]] gehört zum '''"Expertenmodus"'''. Sie sollte nur bei detaillierter Kenntnis der Auswirkungen gewählt werden. Bei Verwendung von includes (wie generell bei direktem Bearbeiten der Konfigurationsdatei(en)) können Fehler auftreten, die allein auf der Reihenfolge der Abarbeitung von Definitionen beruhen. Bei alleiniger Bearbeitung der Konfiguration über die Benutzeroberfläche trägt Fhem selbst Sorge dafür, dass die erforderliche Reihenfolge eingehalten wird.
	~~</span>~~

	Wenn die [[Konfiguration]] von FHEM mit der Zeit wächst und man die Konfiguration unbedingt direkt mit ~~Integriertem~~ oder einem externen Editor bearbeiten möchte, wird sie schnell zu unübersichtlich. Dann kann es sich anbieten nicht mehr alle Konfigurationen in der einen fhem.cfg zu machen, sondern sie in verschiedene eigene Konfigurations-Dateien auszulagern. Diese werden dann in der "Haupt-Konfiguration" fhem.cfg mithilfe von <code>include</code> eingebunden.

	Bei der Aufteilung der Konfiguration sind ein paar Punkte zu beachten:		Bei der Aufteilung der Konfiguration sind ein paar Punkte zu beachten:

	* Sämtliche <code>attr global</code> Definitionen '''müssen''' in der fhem.cfg bleiben.		* Sämtliche <code>attr global</code> Definitionen '''müssen''' in der fhem.cfg bleiben.
	* Nur Konfigurationsdateien, die im Verzeichnis <code><installationsverzeichnis>/FHEM/</code> liegen, werden unter "Edit files" ~~unter~~ "Own modules and helper files" zur Bearbeitung mit dem integrierten Editor aufgeführt. Ansonsten muss man auf diese Dateien per remote-Sitzung oder einem anderen Programm (SSH / FTP) zugreifen.		* Nur Konfigurationsdateien, die im Verzeichnis <code><installationsverzeichnis>/FHEM/</code> liegen, werden unter "Edit files" im Abschnitt "Own modules and helper files" zur Bearbeitung mit dem integrierten Editor aufgeführt. Ansonsten muss man auf diese Dateien per remote-Sitzung oder mit einem anderen Programm (SSH / FTP) zugreifen.
	* Um Änderungen in den "Teil-Konfigurationen" muss die "Haupt-Konfiguration" fhem.cfg neu eingelesen oder der fhem neu gestartet werden.		* Um Änderungen in den "Teil-Konfigurationen" zu aktivieren, muss die "Haupt-Konfiguration" fhem.cfg neu eingelesen oder der fhem neu gestartet werden.

	== Beispiel einer verteilten Konfiguration ==		== Beispiel einer verteilten Konfiguration ==

	Die folgende verteilte Konfiguration ist sicher schon etwas exzessiv, gibt aber einen guten Überblick über die Möglichkeiten:		Die folgende verteilte Konfiguration ist sicher schon etwas exzessiv, gibt aber einen guten Überblick über die Möglichkeiten:

Krikan: Konsolidierung mit Fhem_Command_Beispiele / Kommentare in fhem.cfg-Auszug an moriges Fhem-Update angepasst

2015-02-22T19:14:46Z

Konsolidierung mit Fhem_Command_Beispiele / Kommentare in fhem.cfg-Auszug an moriges Fhem-Update angepasst

← Nächstältere Version		Version vom 22. Februar 2015, 21:14 Uhr
Zeile 10:		Zeile 10:
	== Allgemeines ==		== Allgemeines ==

	Der Befehl [[include]] gehört zu den FHEM-eigenen Befehlen. Mit ihm kann eine andere Datei eingelesen und ausgeführt werden. Ein typischer Anwendungsfall ist Verteilung bzw. Auslagerung von FHEM-Konfigurationen auf mehrere Dateien.		Der Befehl [[include]] gehört zu den FHEM-eigenen Befehlen. Mit ihm kann eine andere Datei eingelesen und ausgeführt werden. Ein typischer Anwendungsfall ist Verteilung bzw. Auslagerung von Plaintext-basierten FHEM-Konfigurationen auf mehrere Dateien. Bei Nutzung der neueren [[Konfiguration#Konfiguration_in_einer_SQL_Datenbank\|datenbankbasierten Konfiguration]] widerspricht die Verwendung dem Konzept und ist letztlich nicht möglich.

	<span style="color: red">		<span style="color: red">
	'''Hinweis:''' Die Verwendung des Befehls [[include]] gehört zum '''"Expertenmodus"'''. Sie sollte nur bei detaillierter Kenntnis der Auswirkungen gewählt werden.		'''Hinweis:''' Die Verwendung des Befehls [[include]] gehört zum '''"Expertenmodus"'''. Sie sollte nur bei detaillierter Kenntnis der Auswirkungen gewählt werden. Bei Verwendung von includes (wie generell bei direktem Bearbeiten der Konfigurationsdatei(en)) können Fehler auftreten, die allein auf der Reihenfolge der Abarbeitung von Definitionen beruhen. Bei alleiniger Bearbeitung der Konfiguration über die Benutzeroberfläche trägt Fhem selbst Sorge dafür, dass die erforderliche Reihenfolge eingehalten wird.
	</span>		</span>

	Wenn die [[Konfiguration]] ~~des~~ FHEM mit der Zeit wächst, wird sie schnell unübersichtlich. Dann kann es sich anbieten nicht mehr alle Konfigurationen in der einen fhem.cfg zu machen, sondern sie in verschiedene eigene Konfigurations-Dateien auszulagern. Diese werden dann in der "Haupt-Konfiguration" fhem.cfg mithilfe von <code>include</code> eingebunden.		Wenn die [[Konfiguration]] von FHEM mit der Zeit wächst und man die Konfiguration unbedingt direkt mit Integriertem oder einem externen Editor bearbeiten möchte, wird sie schnell zu unübersichtlich. Dann kann es sich anbieten nicht mehr alle Konfigurationen in der einen fhem.cfg zu machen, sondern sie in verschiedene eigene Konfigurations-Dateien auszulagern. Diese werden dann in der "Haupt-Konfiguration" fhem.cfg mithilfe von <code>include</code> eingebunden.

	Bei der Aufteilung der Konfiguration sind ein paar Punkte zu beachten:		Bei der Aufteilung der Konfiguration sind ein paar Punkte zu beachten:
Zeile 46:		Zeile 46:
	attr global logfile ./log/fhem-%Y-w%W.log		attr global logfile ./log/fhem-%Y-w%W.log

	~~#####################################################~~#		#
	### fhem System configs		# fhem System configs
	~~#####################################################~~#		#

	include ./FHEM/fhem_1_interfaces.cfg		include ./FHEM/fhem_1_interfaces.cfg
Zeile 56:		Zeile 56:
	include ./FHEM/fhem_5_floorplans.cfg		include ./FHEM/fhem_5_floorplans.cfg

	~~#####################################################~~#		#
	### Haus		# Haus
	~~#####################################################~~#		#

	include ./FHEM/fhem_raeume.cfg		include ./FHEM/fhem_raeume.cfg
	include ./FHEM/fhem_remoteserver_balkon.cfg		include ./FHEM/fhem_remoteserver_balkon.cfg

	~~#####################################################~~#		#
	### Sonstiges		# Sonstiges
	~~#####################################################~~#		#

	include ./FHEM/fhem_systemstate.cfg		include ./FHEM/fhem_systemstate.cfg

Krikan: Infobox Modul eingefügt; Kategorie gelöscht, da diese automatisch durch Infobox-Vorlage ergänzt wird

2015-02-16T12:32:30Z

Infobox Modul eingefügt; Kategorie gelöscht, da diese automatisch durch Infobox-Vorlage ergänzt wird

← Nächstältere Version		Version vom 16. Februar 2015, 14:32 Uhr
Zeile 1:		Zeile 1:
			{{SEITENTITEL:include}}
			{{Infobox Modul
			\|ModPurpose=Liest eine Konfigurations-Datei in Fhem ein
			\|ModType=cmd
			\|ModCmdRef=include
			\|ModTechName=fhem.pl
			\|ModOwner=rudolfkoenig/Rudolfkoenig ({{Link2FU\|8\|Forum}}/[[Benutzer Diskussion:Rudolfkoenig\|Wiki]])
			}}

	== Allgemeines ==		== Allgemeines ==
Zeile 13:		Zeile 21:

	* Sämtliche <code>attr global</code> Definitionen '''müssen''' in der fhem.cfg bleiben.		* Sämtliche <code>attr global</code> Definitionen '''müssen''' in der fhem.cfg bleiben.
	* Nur Konfigurationsdateien, die im Verzeichnis <code><installationsverzeichnis>/FHEM/</code> liegen, werden unter "Edit files" zur Bearbeitung mit dem integrierten Editor aufgeführt.		* Nur Konfigurationsdateien, die im Verzeichnis <code><installationsverzeichnis>/FHEM/</code> liegen, werden unter "Edit files" unter "Own modules and helper files" zur Bearbeitung mit dem integrierten Editor aufgeführt. Ansonsten muss man auf diese Dateien per remote-Sitzung oder einem anderen Programm (SSH / FTP) zugreifen.
	* Um Änderungen in den "Teil-Konfigurationen" muss die "Haupt-Konfiguration" fhem.cfg neu eingelesen oder der fhem neu gestartet werden.		* Um Änderungen in den "Teil-Konfigurationen" muss die "Haupt-Konfiguration" fhem.cfg neu eingelesen oder der fhem neu gestartet werden.

Zeile 76:		Zeile 84:

	== Links ==		== Links ==
			* ...
	~~[[FHEM Command Beispiele#include]]~~

	~~[[Kategorie:FhemBefehl]]~~

Fabian: Kapitel "Auslagerung von Konfigurationen" im Artikel "Konfiguration" in eigenen Artikel "include" umgezogen.

2015-02-16T11:40:55Z

Kapitel "Auslagerung von Konfigurationen" im Artikel "Konfiguration" in eigenen Artikel "include" umgezogen.

Neue Seite

== Allgemeines ==

Der Befehl [[include]] gehört zu den FHEM-eigenen Befehlen. Mit ihm kann eine andere Datei eingelesen und ausgeführt werden. Ein typischer Anwendungsfall ist Verteilung bzw. Auslagerung von FHEM-Konfigurationen auf mehrere Dateien.

<span style="color: red">
'''Hinweis:''' Die Verwendung des Befehls [[include]] gehört zum '''"Expertenmodus"'''. Sie sollte nur bei detaillierter Kenntnis der Auswirkungen gewählt werden.
</span>

Wenn die [[Konfiguration]] des FHEM mit der Zeit wächst, wird sie schnell unübersichtlich. Dann kann es sich anbieten nicht mehr alle Konfigurationen in der einen fhem.cfg zu machen, sondern sie in verschiedene eigene Konfigurations-Dateien auszulagern. Diese werden dann in der "Haupt-Konfiguration" fhem.cfg mithilfe von <code>include</code> eingebunden.

Bei der Aufteilung der Konfiguration sind ein paar Punkte zu beachten:

* Sämtliche <code>attr global</code> Definitionen '''müssen''' in der fhem.cfg bleiben.
* Nur Konfigurationsdateien, die im Verzeichnis <code><installationsverzeichnis>/FHEM/</code> liegen, werden unter "Edit files" zur Bearbeitung mit dem integrierten Editor aufgeführt.
* Um Änderungen in den "Teil-Konfigurationen" muss die "Haupt-Konfiguration" fhem.cfg neu eingelesen oder der fhem neu gestartet werden.

== Beispiel einer verteilten Konfiguration ==

Die folgende verteilte Konfiguration ist sicher schon etwas exzessiv, gibt aber einen guten Überblick über die Möglichkeiten:

fhem.cfg (Haupt-Konfiguration):
<pre>
attr global userattr DbLogExclude devStateIcon devStateStyle fp_DG fp_OG fp_EG fp_Keller icon sortby webCmd widgetOverride
attr global autoload_undefined_devices 1
attr global modpath .
attr global motd Error messages while initializing
attr global sendStatistics manually
attr global statefile ./log/fhem.save
attr global updateInBackground 1
attr global verbose 3

# Geo-Koordinaten
attr global latitude 52.518611
attr global longitude 13.376111

# Zentrales Logging pro Kalenderwoche
attr global logfile ./log/fhem-%Y-w%W.log

######################################################
### fhem System configs
######################################################

include ./FHEM/fhem_1_interfaces.cfg
include ./FHEM/fhem_2_dashboard.cfg
include ./FHEM/fhem_3_logging.cfg
include ./FHEM/fhem_4_devices.cfg
include ./FHEM/fhem_5_floorplans.cfg

######################################################
### Haus
######################################################

include ./FHEM/fhem_raeume.cfg
include ./FHEM/fhem_remoteserver_balkon.cfg

######################################################
### Sonstiges
######################################################

include ./FHEM/fhem_systemstate.cfg
include ./FHEM/fhem_battery.cfg
include ./FHEM/fhem_wetter_dwd.cfg
include ./FHEM/fhem_wetter_yr.cfg
include ./FHEM/fhem_muell.cfg
include ./FHEM/fhem_internet.cfg
</pre>

Für jede dieser includes gibt es dann eine eigene Konfigurationsdatei nach dem üblichen Schema.

== Debugging einer verteilten Konfiguration ==

Eine einfache Methode zum Debuggen der Konfiguration geht wie folgt:
# Teil-Konfigurationen im internen oder externen Editor bearbeiten und abspeichern.
# Haupt-Konfiguration fhem.cfg im Online-Editor öffnen und wieder abspeichern. Etwaige Fehl-Konfigurationen werden direkt angezeigt.

== Links ==

[[FHEM Command Beispiele#include]]

[[Kategorie:FhemBefehl]]