⚠ Dieser Adapter kann mit dem Blockly (Eigene Abfrage) das System sehr schnell zum Absturz bringen.
 ⚠ Daher bitte diese Beschreibung aufmerksam durchlesen.

Вернуться к файлу README

Краткое содержание

• imap.0.xxx.email.email_xx.attach_json
• imap.0.xxx.last_activity_json
• imap.0.xxx.quality
• imap.0.xxx.status
• Пример: JavaScript и Blockly

Настройки экземпляра

Вкладка «Создать конфигурацию экземпляра» IMAP

 ⚠ Die Instanz muss aktiviert sein!!!!

• Aktiv : Включить IMAP-соединение

• Host например, imap.gmail.com

• Posteingang Стандартный почтовый ящик (INBOX) - Ящик для мониторинга - Возможные варианты выбора см. в imap.0.xxx.remote.change_folder. Пример: INBOX.subfolder (точка в качестве разделителя)

• Port Стандарт 993

• Nutzername Имя пользователя - Экземпляр должен быть активирован!!!

• Passwort Пароль — экземпляр должен быть активирован!!! — Вход в Gmail — Аутентификация Outlook OAuth2

• max. Максимальное количество точек данных email_01...email_02... (1-99)

• max. HTML Максимальное количество писем в формате HTML. Должно быть больше максимального количества точек данных (1-99).

• TLS Использовать TLS-соединение — по умолчанию установлено значение true.

• Flaggen Флаг для IMAP-запроса. Возможные флаги:

ALL - alle – Alle Nachrichten.
ANSWERED - geantwortet – Nachrichten mit gesetzter Beantwortet-Flagge.
DELETED - gelöscht – Nachrichten mit gesetzter Gelöscht-Flagge.
DRAFT - Entwurf – Nachrichten mit gesetzter Entwurfsflagge.
FLAGGED - gekennzeichnet – Nachrichten mit gesetzter Flagge.
NEW - neu – Nachrichten, bei denen das Flag „Zuletzt verwendet“ gesetzt ist, aber nicht das Flag „Gesehen“.
SEEN - gesehen – Nachrichten, bei denen das Flag „Gesehen“ gesetzt ist.
RECENT - jüngste – Nachrichten, bei denen das Flag „Zuletzt verwendet“ gesetzt ist.
OLD - alt – Nachrichten, für die das Flag „Zuletzt verwendet“ nicht gesetzt ist. Dies entspricht funktional !RECENT (im Gegensatz zu „!NEW“).
UNANSWERED - unbeantwortet – Nachrichten, bei denen das Flag „Beantwortet“ nicht gesetzt ist.
UNDELETED - ungelöscht – Nachrichten, für die das Flag „Gelöscht“ nicht gesetzt ist.
UNDRAFT - kein Entwurf – Nachrichten, bei denen das Draft-Flag nicht gesetzt ist.
UNFLAGGED - ungekennzeichnet – Nachrichten, für die das Flag „Markiert“ nicht gesetzt ist.
UNSEEN - ungesehen – Nachrichten, bei denen das Flag „Gesehen“ nicht gesetzt ist.

• Symbol auswählen Значок папки (под вкладкой TAB)Symbole erstellen (загрузить)

• tls-Option По умолчанию установлено значение {"rejectUnauthorized": false}
• Auto-TLS Возможные варианты:always ,required иnever Стандарт никогда не соблюдается. Для получения дополнительной информации, пожалуйста, прочтите здесь .

• Att. Для заполнения поля HTML необходимо также загрузить вложения. Это потребляет много оперативной памяти! Поэтому используйте настройки по умолчанию.false
• Mailparser-Option Опция анализа почты (только на вкладке TAB)MAILPARSER-OPTIONEN создавать)
• Token : Сначала создайте токены здесь.

• max. MEMRSS-Limit: С момента запуска действия.
• Neu starten: Если достигается лимит MEMRSS, адаптер перезапускается. Однако проверка этого процесса выполняется только каждые 24 часа.

• Objekt-ID: Если будет достигнут лимит MEMRSS, выбранная точка данных будет...true Настройка выполнена. Необходимо выполнить сброс вручную. Однако проверка производится только каждые 24 часа.

• Senden: Сообщение отправляется при достижении лимита MEMRSS. Затем оно будет обновляться при каждом последующем обновлении.MEMRSS Сообщение было отправлено.
  • Instanzen: Пример: telegram.0, telegram.1, pushover.0
  • Instanzen Benutzer: Пример: Питер, Олаф, Томас

Символы вкладки «Конфигурация экземпляра» создают

• Symbolname: Назовите символ. Пожалуйста, не используйте повторяющиеся имена. В противном случае при запуске адаптера в журнале будет зафиксирована ошибка.
• Upload: Загрузите иконку.

Создать вкладку конфигурации экземпляра oauth2

• Name имя
• Kunden ID Идентификатор клиента
• Token Токен
• Mandanten-ID Идентификатор мандата

Вкладка «Конфигурация экземпляра» > «Параметры Mailparser» > «Создать»

• Name: Имя парсера почты. Пожалуйста, не используйте повторяющиеся имена. В противном случае при запуске адаптера в журнале будет зафиксирована ошибка. Подробное описание можно найти здесь .
• HTML in Text überspringen: Не генерирует обычный текст из HTML.
• Maximale HTML-Länge zum Parsen:Максимальный объем HTML-кода для анализа в байтах. Если этот лимит превышен, будут сгенерированы только данные заголовка.
• Bildlinks überspringen: Пропускает преобразование вложений CID в изображения по URL-адресу данных. Изображения не преобразуются в base64.enormen RAM Verbrauch сохраняет.
• Text in HTML überspringen: Не генерирует HTML из сообщений в обычном текстовом формате.
• Textlinks überspringen: Не включайте ссылки в текстовый контент.

Состояния (объекты)

Условияimap.0

Условияimap.0.benutzername

Условияimap.0.benutzername.email.email_xx

Условияimap.0.benutzername.infos

Условияimap.0.benutzername.remote

Название папки

Старые названия папок можно просмотреть в объекте imap.0.xxx.remote.change_folder.

Условияimap.0.benutzername.remote.copy

Условияimap.0.benutzername.remote.flag

Условияimap.0.benutzername.remote.html

Условияimap.0.benutzername.remote.move

Блоклис

Изменить IMAP-запрос Blockly

• Это позволяет вам задать эти точки данных .
• Возможные флаги можно найти в конфигурации экземпляра .
• Выберите IMAP-подключение или примените его ко всем подключениям.
• Допускается максимум 100 электронных писем.

Пользовательский запрос Blockly IMAP

• ВНИМАНИЕ! Сюда будут отправляться все данные, такие как вложения. Этот запрос может довести вашу оперативную память или процессор до предела. Создание некорректного критерия может привести к сбою ioBroker!!!
• Затем данные передаются в формате JSON.
• В результате ведения журнала создается очень большой файл. Поэтому записи в журнале следует удалять позже.
• Должна существовать переменная с именемresult быть сотворённым.
• Допускается максимум 100 электронных писем.
• Примеры

Запрос Blockly IMAP с настройками экземпляра

• Загрузите все данные из IMAP-соединения и обработайте их вручную. В качестве критерия поиска используется параметр экземпляра.
• ВНИМАНИЕ! Высокое потребление оперативной памяти.
• Затем данные передаются в формате JSON.
• В результате ведения журнала создается очень большой файл. Поэтому записи в журнале следует удалять позже.
• Должна существовать переменная с именемresult быть сотворённым.
• Примеры

Настройка флагов IMAP Blockly

• В электронном письме для указания флага можно использовать `setFlag=set`, `addFlag=add` или `delFlag=delete`.
• Выберите почтовый ящик.
• Выберите setFlag=set, addFlag=add или delFlag=delete.
• Выберите флаг.
• Возможные значения флагов можно найти в файле imap.0.xxx.status.

JSON-массив

Array JSON imap.0.xxx.email.email_xx.attach_json

[
    {
        "partID": "2",
        "id": "<image001.png@01D9C718.240FAD50>",
        "uid": 86,
        "size": "159762",
        "filename": "image001.png",
        "type": "inline",
        "encoding": "base64"
    },
    {
        "partID": "3",
        "id": "<image002.png@01D9C718.36F8AE30>",
        "uid": 86,
        "size": "1296247",
        "filename": "image002.png",
        "type": "inline",
        "encoding": "base64"
    }
]

Массив JSON imap.0.xxx.json

[
    {
        "id": 1,
        "date": "15.08.2023 15:39:17",
        "from": ["test@luckyskills.de"],
        "from_name": ["Tester"],
        "attach": 0,
        "attach_info": [],
        "to": ["github@luckyskills.de"],
        "to_name": ["Lucky-ESA"],
        "subject": "Test",
        "text": "Am 2023-08-10 12:17, schrieb test@luckyskills.de:\n>>> TEST\n",
        "html": false,
        "textAsHtml": "Am 2023-08-10 12:17, schrieb <a href=\"mailto:test@luckyskills.de\">test@luckyskills.de</a>:<br/>&gt;&gt;&gt; TEST</p>",
        "seqno": 74,
        "uid": 93,
        "size": 1077,
        "flag": "unseen"
    }
]

JSON imap.0.xxx.last_activity_json

{
    "modseq": "196",
    "flags": ["\\Seen"]
}

JSON imap.0.xxx.quality

{
    "message": "No Message"
}

Возможности

0: "0x00 - good",
1: "0x01 - general problem",
2: "0x02 - no connection problem",
16: "0x10 - substitute value from controller",
17: "0x11 - general problem by instance",
18: "0x12 - instance not connected",
32: "0x20 - substitute initial value",
64: "0x40 - substitute value from device or instance",
65: "0x41 - general problem by device",
66: "0x42 - device not connected",
68: "0x44 - device reports error",
128: "0x80 - substitute value from sensor",
129: "0x81 - general problem by sensor",
130: "0x82 - sensor not connected",
132: "0x84 - sensor reports error",

JSON imap.0.xxx.status

{
    "name": "INBOX",
    "flags": ["\\Answered", "\\Flagged", "\\Deleted", "\\Seen", "\\Draft"],
    "readOnly": false,
    "uidvalidity": 1667682367,
    "uidnext": 94,
    "permFlags": ["\\Answered", "\\Flagged", "\\Deleted", "\\Seen", "\\Draft"],
    "keywords": [],
    "newKeywords": true,
    "persistentUIDs": true,
    "nomodseq": false,
    "seq": 0,
    "time": 0,
    "reason": "",
    "user": "github_luckyskills_de",
    "messages": {
        "total": 74,
        "new": 0
    },
    "highestmodseq": "200"
}

Массив JSON imap.0.online_history

[
    {
        "client": "github_luckyskills_de",
        "time": 1692298599784,
        "status": "Online"
    },
    {
        "client": "github_luckyskills_de",
        "time": 1692298232899,
        "status": "Online"
    }
]

Changelog

WORK IN PROGRESS

• (Lucky-ESA) Admin 7.6.20 required

0.4.0 (2026-05-30)

• (copilot) Adapter requires node.js >= 22 now
• (Lucky-ESA) Description revised
• (Lucky-ESA) Admin 7.8.23 required
• (Lucky-ESA) JS-Controller 7.0.7 required
• (Lucky-ESA) Added meta object for attachments

0.3.0 (2024-12-07)

• (Lucky-ESA) Mailbox folder delete added
• (Lucky-ESA) Mailbox folder create added
• (Lucky-ESA) Change Mailbox Folder name added
• (Lucky-ESA) IMAP package changed
• (Lucky-ESA) Migration to ESLint9

0.2.2 (2024-11-07)

• (Lucky-ESA) New design for settings page added
• (Lucky-ESA) Crash if uid is empty for new emails

0.2.1 (2024-09-16)

• (Lucky-ESA) Update dependencies
• (Lucky-ESA) Changed Log info to debug
• (Lucky-ESA) Fixed blockly setFlag crash

0.2.0 (2024-06-15)

• (Lucky-ESA) Updated Blockly definitions
• (Lucky-ESA) JS-Controller >= 5.0.19 required
• (Lucky-ESA) Admin >=6.13.16 required

License

MIT License

Copyright (c) 2023-2026 Lucky-ESA github@luckyskills.de

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.