# Bild-Archiv

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/logiken/bildarchiv/

_Benötigt Symcon >= 4.2_

Das Modul kopiert bei Auslösung durch eine gewählte Variable ein Bild. Es ist einstellbar wieviele Bilder gespeichert werden sollen.

### Funktionsumfang
- Auswählbares Quellbild und auswählbare Auslöservariable
- Einstellbare Anzahl von Bildern, welche gespeichert werden sollen
- Wenn eine Auslöservariable ausgewählt ist wird ein Ereignis erstellt, welches auf die Aktualisierung dieser reagiert
- Das Ereignis kann bis auf die Auslöservariable vollständig personalisiert werden
- Bilder bekommen den Zeitpunkt des Auslösens als Namen
- Bilder werden chronologisch von alt -> neu in der Kategorie Bilder angezeigt
- Automatisches Löschen der ältesten Bilder, beim Erreichen der eingestellten maximalen Bilderanzahl

### Software-Installation
- Über den [Module Store](https://www.symcon.de/de/service/dokumentation/komponenten/verwaltungskonsole/module-store/) das Modul Bild-Archiv installieren.

### Einrichten der Instanzen in IP-Symcon
- Unter "Instanz hinzufügen" kann das 'Bild-Archiv'-Modul mithilfe des Schnellfilters gefunden werden.
  - Weitere Informationen zum Hinzufügen von Instanzen in der [Dokumentation der Instanzen](https://www.symcon.de/de/service/dokumentation/grundlagen/instanzen/#Instanz_erstellen)

#### Konfigurationsseite

| Name            | Beschreibung                                                             |
| --------------- | ------------------------------------------------------------------------ |
| Bild            | Quellbild, welches kopiert werden soll                                   |
| Anzahl          | Maximale Anzahl an Bildern, die gespeichert werden sollen                |
| Auslösevariable | Variable bei deren Änderung das Quellbild ins Archiv kopiert werden soll |

### Statusvariablen

Die Statusvariablen/Kategorien werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

#### Statusvariablen

| Name     | Typ       | Beschreibung                                                                       |
| -------- | --------- | ---------------------------------------------------------------------------------- |
| Bilder   | Kategorie | Hier werden die Quellbilder hineinkopiert                                          |
| AddImage | Ereignis  | Wird durch die Auslösevariable ausgelöst und stößt das Kopieren des Quellbildes an |

### Visualisierung
Über die Visualisierung werden die Medienobjekte als Liste angezeigt. Es ist keine weitere Steuerung oder gesonderte Darstellung integriert.

## BA_AddImage

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/logiken/bildarchiv/ba-addimage/

`bool BA_AddImage(int $InstanzID)`

_Benötigt Symcon >= 4.2_

**Parameter**

- `$InstanzID` (int): ID der Instanz

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

ID der Instanz

**Beispiel**

```text
BA_AddImage(12345);
```