Merge branch 'master' into feature/long-time-values

.github/workflows/style.yml

@@ -10,4 +10,4 @@ jobs:
     - name: Checkout module
       uses: actions/checkout@master
     - name: Check style
-      uses: symcon/action-style@master
+      uses: symcon/action-style@v3

.gitignore

@@ -1,2 +1,5 @@
-.idea
+.DS_Store
+.idea/
+.phpunit.*
 .php_cs.cache
+.php-cs-fixer.cache

CSVZipExport/README.md

@@ -1,86 +1,4 @@
 # CSVZipExport
-Dieses Modul bietet die Möglichkeit, die aggregierten Werte einer Variable als CSV-Datei in einem ZIP-Archiv zu exportieren. 
+[Link zur deutschen Dokumentation](https://www.symcon.de/de/service/dokumentation/modulreferenz/csv-zip-export/)
 
-### Inhaltsverzeichnis
-
-1. [Funktionsumfang](#1-funktionsumfang)
-2. [Voraussetzungen](#2-voraussetzungen)
-3. [Software-Installation](#3-software-installation)
-4. [Einrichten der Instanzen in IP-Symcon](#4-einrichten-der-instanzen-in-ip-symcon)
-5. [Statusvariablen und Profile](#5-statusvariablen-und-profile)
-6. [WebFront](#6-webfront)
-7. [PHP-Befehlsreferenz](#7-php-befehlsreferenz)
-
-### 1. Funktionsumfang
-
-* Exportieren von aggregierten Daten einer Variable
-* Daten in CSV-Datei ein einem ZIP-Archiv exportieren
-* Auflistung aller geloggten Variablen
-* Zeitraum der Aggregierung frei wählbar
-* Aggregierungsstufe kann ausgewählt werden
-* Zyklisches erstellen und versenden eines Archivs
-
-### 2. Voraussetzungen
-
-- IP-Symcon ab Version 5.5
-
-### 3. Software-Installation
-
-* Über den Module Store das 'CSVZipExport'-Modul installieren.
-* Alternativ über das Module Control folgende URL hinzufügen `https://github.com/symcon/CSVZipExport/`
-
-### 4. Einrichten der Instanzen in IP-Symcon
-
- Unter 'Instanz hinzufügen' ist das 'CSVZipExport'-Modul unter dem Hersteller '(Gerät)' aufgeführt.
-
-__Konfigurationsseite__:
-
-Name                         | Beschreibung
----------------------------- | ------------------
-Filter                       | Filtriert die Auswahl der geloggten Variablen
-Geloggte Variablen           | Auswahl der Variable welche exportiert werden soll
-Start der Aggregation        | Beginn des Aggregationszeitraums
-Ende der Aggregation         | Ende des Aggregationszeitraums
-Aggregationsstufe            | Stufe der Aggregation 
-Exportieren                  | Die aggregierten Daten der Variable werden exportiert
-Zyklisches senden aktivieren | Aktiviert die Versendung per E-Mail
-SMPT-Instanz                 | Auswahl der E-Mail-Instanz
-E-Mail Intervall             | Intervall in welchem die E-Mail versendet wird. Bei "Wöchtenlich" wird die E-Mail am Montag versendet und bei "Monatlich" wird die E-Mail jeweils am 1. des Monats versendet zum jeweilig gewählten Zeitpunkt
-Zeitpunkt der Mail           | Zeitpunkt zu welchem die E-Mail versendet werden soll 
-Jetzt Mail senden            | Sendet manuell eine Mail
-
-### 5. Statusvariablen und Profile
-
-Die Statusvariablen/Kategorien werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.
-
-#### Statusvariablen
-
-Es werden keine zusätzlichen Statusvariablen erstellt.
-
-#### Profile
-Es werden keine zusätzlichen Profile erstellt.
-
-### 6. WebFront
-
-Dieses Modul bietet keinerlei Funktion im Webfront.
-
-### 7. PHP-Befehlsreferenze
-`string CSV_Export(integer $InstanzID, integer $ArchiveVariable, integer $AggregationStage, integer $AggregationStart, integer $AggregationEnd);`
-Erzeugt ein Zip-Archiv basierend auf den gegebenen Parametern und liefert den relativen Pfad des Archivs als Rückgabewert.
-
-Beispiel:
-`CSV_Export(12345, 54321, 4, 2293574400, 3127161600);`
-
-
-`void CSV_SendMail(integer $InstanzID);`
-Senden durch eine SMTP Instanz eine Mail mit einer erzeugten Zip-Datei
-
-Beispiel:
-`CSV_SendMail(12345);`
-
-
-`void CSV_DeleteZip(integer $InstanzID);`
-Entfernt die generierte Datei.
-
-Beispiel:
-`CSV_DeleteZip(12345);`
+[Link to the english documentation](https://www.symcon.de/en/service/documentation/module-reference/csv-zip-export/)

CSVZipExport/form.json

@@ -25,6 +25,21 @@
             "width": "700px",
             "requiredLogging": 1
         },
+        {
+            "type": "Select",
+            "caption": "Decimal Separator",
+            "name": "DecimalSeparator",
+            "options": [
+                {
+                    "caption": "Comma",
+                    "value": ","
+                },
+                {
+                    "caption": "Dot",
+                    "value": "."
+                }
+            ]
+        },
         {
             "type": "SelectDateTime",
             "caption": "Aggregation Start",

CSVZipExport/locale.json

@@ -26,7 +26,11 @@
             "Summary of %s (%s to %s)": "Zusammenfassung von %s (%s bis %s)",
             "In the appendix you can find the created CSV-File.": "Im Anhang finden Sie die erstellte CSV-Datei.",
             "The selected SMTP-Instance doesn't exist": "Die ausgewählte SMTP-Instanz existiert nicht",
-            "Variable is not selected": "Variable ist nicht ausgewählt"
+            "Decimal Separator": "Dezimaltrennzeichen",
+            "Variable is not selected": "Variable ist nicht ausgewählt",
+            "https://www.symcon.de/en/service/documentation/module-reference/csv-zip-export/": "https://www.symcon.de/de/service/dokumentation/modulreferenz/csv-zip-export/",
+            "Dot": "Punkt",
+            "Comma": "Komma"
         }
     }
 }

CSVZipExport/module.json

@@ -10,5 +10,5 @@
     "childRequirements": [],
     "implemented": [],
     "prefix": "CSV",
-    "url": "https://github.com/symcon/CSVZipExport"
+    "url": "https://www.symcon.de/en/service/documentation/module-reference/csv-zip-export/"
 }

CSVZipExport/module.php

@@ -26,6 +26,7 @@ public function Create()
         $this->RegisterPropertyInteger('SMTPInstance', 0);
         $this->RegisterPropertyBoolean('IntervalStatus', false);
         $this->RegisterPropertyString('MailTime', '{"hour":12,"minute":0,"second":0}');
+        $this->RegisterPropertyString('DecimalSeparator', ',');
 
         //Timer
         $this->RegisterTimer('DeleteZipTimer', 0, 'CSV_DeleteZip($_IPS[\'TARGET\']);');
@@ -115,7 +116,8 @@ public function Export(int $ArchiveVariable, int $AggregationStage, string $Aggr
                 $loggedValues = AC_GetAggregatedValues($archiveControlID, $ArchiveVariable, $AggregationStage, $startTimeStamp, $endTimeStamp, $limit);
                 $loopAgain = count($loggedValues) == $limit;
                 for ($j = 0; $j < count($loggedValues); $j++) {
-                    $content .= date('d.m.Y H:i:s', $loggedValues[$j]['TimeStamp']) . ';' . $loggedValues[$j]['Avg'] . "\n";
+                    $value = is_numeric($loggedValues[$j]['Avg']) ? str_replace('.', $separator, '' . $loggedValues[$j]['Avg']) : $loggedValues[$j]['Avg'];
+                    $content .= date('d.m.Y H:i:s', $loggedValues[$j]['TimeStamp']) . ';' . $value . "\n";
                 }
             } else {
                 $loggedValues = AC_GetLoggedValues($archiveControlID, $ArchiveVariable, $startTimeStamp, $endTimeStamp, $limit);
@@ -128,7 +130,8 @@ public function Export(int $ArchiveVariable, int $AggregationStage, string $Aggr
                 }
 
                 for ($j = 0; $j < count($loggedValues); $j++) {
-                    $content .= date('d.m.Y H:i:s', $loggedValues[$j]['TimeStamp']) . ';' . $loggedValues[$j]['Value'] . "\n";
+                    $value = is_numeric($loggedValues[$j]['Value']) ? str_replace('.', $separator, '' . $loggedValues[$j]['Value']) : $loggedValues[$j]['Value'];
+                    $content .= date('d.m.Y H:i:s', $loggedValues[$j]['TimeStamp']) . ';' . $value . "\n";
                 }
             }
             file_put_contents($contentFile, $content, FILE_APPEND | LOCK_EX);
@@ -244,13 +247,13 @@ private function TransferTime($jsonTime, bool $start, bool $ignoreTime)
         $customTime = '';
         if ($ignoreTime) {
             switch ($start) {
-                    case true:
-                        $customTime = '00:00:00';
-                        break;
-                    case false:
-                        $customTime = '23:59:59';
-                        break;
-                }
+                case true:
+                    $customTime = '00:00:00';
+                    break;
+                case false:
+                    $customTime = '23:59:59';
+                    break;
+            }
         } else {
             $customTime = sprintf('%02d:%02d:%02d', $time['hour'], $time['minute'], $time['second']);
         }

README.md

@@ -8,6 +8,6 @@ _Das Modul „Smart Energy Box“ wurde in Kooperation zwischen der Symcon GmbH,
 
 Folgende Module beinhaltet das CSVZipExport Repository:
 
-- __CSVZipExport__ ([Dokumentation](CSVZipExport))
+- __CSVZipExport__ ([Dokumentation](https://www.symcon.de/de/service/dokumentation/modulreferenz/csv-zip-export))
 
 Dieses Modul bietet die Möglichkeit, die aggregierten Werte einer Variable als CSV-Datei in einem ZIP-Archiv zu exportieren.

library.json

@@ -6,7 +6,7 @@
     "compatibility": {
         "version": "5.0"
     },
-    "version": "1.2",
+    "version": "1.4",
     "build": 0,
     "date": 0
 }

tests/phpunit.xml

@@ -1,11 +1,12 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<phpunit>
-    <php>
-        <const name="PHPUNIT_TESTSUITE" value="true"/>
-    </php>
-    <filter>
-        <whitelist processUncoveredFilesFromWhitelist="true">
-            <directory suffix=".php">../CSVZipExport</directory>
-        </whitelist>
-    </filter>
-</phpunit>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.1/phpunit.xsd" cacheDirectory=".phpunit.cache">
+  <coverage/>
+  <php>
+    <const name="PHPUNIT_TESTSUITE" value="true"/>
+  </php>
+  <source>
+    <include>
+      <directory suffix=".php">../CSVZipExport</directory>
+    </include>
+  </source>
+</phpunit>