Объекты системы Miracle (часть II)
Специализированные объекты
часть вторая

  CRC

Программирование компонента

Компонент CRC «cyclical redundancy check», служит для вычисления кода на основе контроля с помощью циклического избыточного кода. Возможно вычислить CRC для любого типа данных, строка, число, дата, блоб.
Компонент действует как фильтр, т.е. для получения кода CRC, надо «пропустить данные» через объект с помощью иного компонента.

События

  • Нет или невозможно получить данные для подсчета – событие, сигнализирующее о проблемы по подсчету CRC, так как по указанному источнику, нет данных, либо не установлена связь по данным.
  • Успешный подсчет CRC – событие, сигнализирующее о успешном расчете кода CRC.

Реакции

Реакции отсутствуют

Связь по данным
Источники

  • CRC – рассчитанный код CRC для типа данных строка, число, дата.
  • Блоб – данные в формате блоб (если были получены данные для расчета CRC в формате блоб)
  • CRC блоба – рассчитанный код CRC для типа данных блоб

Приемники

  • Данные – приемник для расчета CRC, данные в формате строка, число, дата.
  • Блоб - приемник для расчета CRC, данные в формате блоб.

  SMTP (отправка e-mail)

Программирование компонента

Компонент - SMTP “Simple Mail Transfer Protocol” (отправка e-mail), служит для организации отправки сообщений в формате e-mail. Настройка компонента может быть осуществлена как на уровне диалога структуры компонента, так и на уровне его программирования.
Возможно использовать диалоговый режим формирования структуры сообщения.
Структура компонента:

  • Адрес SMPT сервера – указание адреса почтового сервера, используемого для отправки e-mail
  • MIME заголовок – флаг включения/выключения в почтовое сообщение MIME заголовка. Многофункциональные расширения почты Internet (MIME - Multipurpose Internet Mail Extensions) MIME просто добавляет некоторые новые заголовки (в соответствии с RFC 822), которые сообщают получателю о структуре тела сообщения.
  • Адрес отправителя – указание адреса отправителя и(или) установка флага изменения данной настройки при «диалоговом режиме» настройки параметров отправки сообщения.
  • Имя отправителя – указание имени отправителя и(или) установка флага изменения данной настройки при «диалоговом режиме» настройки параметров отправки сообщения.
  • Адрес получателя – указание адреса получателя и(или) установка флага изменения данной настройки при «диалоговом режиме» настройки параметров отправки сообщения.
  • Имя получателя – указание имени получателя и(или) установка флага изменения данной настройки при «диалоговом режиме» настройки параметров отправки сообщения.
  • Тема сообщения – указание темы сообщения и(или) установка флага изменения данной настройки при «диалоговом режиме» настройки параметров отправки сообщения.

События

  • (4) DATA error – сообщение об ошибочной отправке содержимого почтового сообщения.
  • DATA ok - сообщение об успешной отправке содержимого почтового сообщения.
  • (1) HELO error - сообщение об ошибочном получении ответа от почтового сервера.
  • HELO ok - сообщение об успешном получении ответа от почтового сервера.
  • (2) MAIL error - сообщение об ошибочной идентификации автора сообщения (или отправителя).
  • MAIL ok - сообщение об успешной идентификации автора сообщения (или отправителя).
  • (3) RCPT error - сообщение об ошибочной идентификации получателя.
  • RCPT ok - сообщение об успешной идентификации получателя.
  • Выход по OK из диалога подготовки сообщений – сообщение о закрытие диалога формирования сообщения нажатием клавиши OK.
  • Выход по отмене из диалога подготовки сообщений – сообщение об отмене формирования в диалоге подготовки сообщений.
  • Не возможно установить соединение с SMPT сервером – сообщение о невозможности установить связь с почтовым сервером, указанным или заданным в настройках компонента.
  • Объект уже занят отправкой – сообщение, указывающее о попытке отправки нового сообщения не дождавшись завершения предыдущего сеанса отправки.
  • Ошибка TCP/IP – ошибка настройки протокола TCP/IP
  • Ошибка загрузки адреса SMTP сервера – ошибка загрузки адреса из указанного источника.
  • Ошибка загрузки адреса отправителя - ошибка загрузки адреса из указанного источника.
  • Ошибка загрузки адреса отправителя - ошибка загрузки адреса из указанного источника.
  • Ошибка загрузки адреса получателя - ошибка загрузки адреса из указанного источника.
  • Ошибка загрузки сообщения - ошибка загрузки сообщения из указанного источника.
  • Ошибка загрузки темы сообщения - ошибка загрузки темы сообщения из указанного источника.
  • Ошибка отправки сообщения (ошибка сервера) – ошибка отправки (общая)
  • Сессия закрыта – сообщения, указывающая на завершение сессии отправки сообщения.
  • Соединение прервано – сообщение о разрыве соединения в процессе передачи сообщения.
  • Успешная загрузка адреса SMPT сервера – удачная загрузка адреса из указанного источника.
  • Успешная загрузка адреса отправителя - удачная загрузка адреса из указанного источника.
  • Успешная загрузка адреса получателя - удачная загрузка адреса из указанного источника.
  • Успешная загрузка имени отправителя - удачная загрузка имени из указанного источника.
  • Успешная загрузка имени получателя - удачная загрузка имени из указанного источника.
  • Успешная загрузка темы сообщения - удачная загрузка темы сообщения из указанного источника.
  • Успешная отправка сообщения – сообщение об успешной отправке сообщения, но не завершения сеанса отправки данных.
  • Удачное подключение к SMTP серверу - сообщение об удачной установке соединение с SMTP сервером.

Реакции

  • Вызвать диалог подготовки сообщения – активизирует диалог формирования сообщения. В зависимости от настроек, возможно изменять адреса и имена отправителя и(или) получателя. (команда подготовки отправки)
  • Загрузить адрес SMTP сервера – команда активизирующая загрузку адреса из внешнего источника. (команда подготовки отправки)
  • Загрузить адрес отправителя – команда активизирующая загрузку адреса из внешнего источника. (команда подготовки отправки)
  • Загрузить адрес получателя – команда активизирующая загрузку адреса из внешнего источника. (команда подготовки отправки)
  • Загрузить имя отправителя – команда активизирующая загрузку имя отправителя из внешнего источника. (команда подготовки отправки)
  • Загрузить имя получателя – команда активизирующая загрузку имя отправителя из внешнего источника. (команда подготовки отправки)
  • Загрузить сообщение – команда активизирующая загрузку сообщения из внешнего источника. (команда подготовки отправки)
  • Загрузить тему сообщения – команда активизирующая загрузку темы сообщения из внешнего источника. (команда подготовки отправки)
  • Отправить сообщение – команда активизирующая процесс отправки сообщения.

Связь по данным
Источники

  • SMTP адрес – установленный адрес SMTP сервера
  • Адрес отправителя – установленный адрес
  • Адрес получателя – установленный адрес
  • Имя отправителя – установленное имя
  • Имя получателя – установленное имя
  • Тема сообщения – заданная тема
  • Сообщение – заданное сообщение
  • Сообщение об ошибке – описание ошибки, возникшее при передаче сообщения.

Приемники

  • SMTP адрес – адрес SMTP сервера используемый для отправки сообщения
  • Адрес отправителя – адрес, указываемый как адрес отправителя сообщения.
  • Адрес получателя –адрес, указываемый адрес получателя сообщения.
  • Имя отправителя – имя отправителя, указываемое в структуре письма.
  • Имя получателя – имя получателя, указываемое в структуре письма.
  • Тема сообщения – тема сообщения, указываемая в структуре письма.
  • Сообщение – сообщение для отправки
  • Идентификатор окна родителя – идентификатор окна, являющиеся «родителем» для окна диалога формирования сообщения.

  Аккумулятор

Программирование компонента

Компонент из класса – математические. Позволяет производить элементарные вычисления. Активизация процесса вычислений, возможно, организовать двумя методами, через команды компонента, через получения данных с вычислением.

События

  • Данные обнулились – сообщение, сигнализирующее об успешном обнулении компонента, т.е. привидение значения компонента в 0.
  • Данные сброшены – сообщение, сигнализирующее об успешном привидении значения компонента в начальное состояние, задаваемое через диалог настройки компонента.
  • Изменились данные – сообщение, сигнализирующее об изменение состояния значения компонента.
  • Ошибка загрузки данных – сообщение, сигнализирующее о не возможности присвоения нового значения компонента из указанного внешнего источника.

Реакции

  • Вычесть данные – команда, активизирующая изменение содержимого компонента путем вычитая из текущего состояния, значения «данные», получаемых по соответствующему информационному каналу.
  • Вычесть единицу - команда, активизирующая изменение содержимого компонента путем вычитая из текущего состояния, единицы.
  • Загрузить данные – команда инициализирующая содержимое компонента значением «данные», получаемых из внешнего источника.
  • Обнулить данные – команда, приводящая значение компонента в состояние 0.
  • Прибавить данные – команда, активизирующая изменение содержимого компонента путем сложения текущего состояния компонента, с значением «данные», получаемых по соответствующему информационному каналу.
  • Прибавить единицу - команда, активизирующая изменение содержимого компонента путем сложения текущего состояния компонента с единицей.
  • Сбросить данные – команда, инициализирующая состояние компонента в начальное (заданное) значение.

Связь по данным
Источники

  • Данные – текущее состояние значения компонента
  • Данные с прибавлением – результат значения с изменением значения компонента. Схема обработки: текущее значение+данные из внешнего источника.
  • Данные с вычитанием - результат значения с изменением значения компонента. Схема обработки: текущее значение-данные из внешнего источника.
  • Сумма с прибавлением - результат значения без изменения значения компонента. Схема обработки: текущее значение+данные из внешнего источника.
  • Разность с вычитанием - результат значения без изменения значения компонента. Схема обработки: текущее значение-данные из внешнего источника.
  • Сумма - аналогично, но значение аккумулятора не изменяется;
  • Разность - аналогично, но значение аккумулятора не изменяется;

Приемники

  • Данные – значение для изменения содержимого компонента.

  Арифметическая операция

Программирование компонента

Компонет для проведения элементарных математических операций. Результат может быть как целочисленным, так и с плавающей точкой.

События

  • Готово – событие, сигнализирующее об успешном расчете.
  • Ошибка – попытка деления на ноль – сигнализация об ошибке.
  • Ошибка получения данных – событие, сигнализирующее об не возможности загрузки значения из внешних источников.

Реакции

  • Вычесть – команда производящая вычисление по схеме Первое значение – Второе значение.
  • Перемножить - команда производящая вычисление по схеме Первое значение * Второе значение.
  • Разделить - команда производящая вычисление по схеме Первое значение / Второе значение.
  • Сложить - команда производящая вычисление по схеме Первое значение + Второе значение.

Связь по данным
Источники

  • Результат (целый) – результат расчета в виде целого числа.
  • Результат (плавающий) – результат расчета в виде числа с плавающей точкой.
  • Остаток от деления (целый) – результат расчета в виде целого числа, значения остатка от деления.
  • Целая часть (целый) – результат расчета в виде целой части числа.
  • Дробная часть (плавающий) – результат расчета в виде дробной части числа.

Приемники

  • Первое значение – участвующее в расчете
  • Второе значение – участвующее в расчете.

  Атом

Программирование компонента

Компонент, создающий «атом» на уровне системы Windows. Имя атома задается в момент настройки компонента.


Следует помнить, что два атома имеющих одно имя не могут работать одновременно.

Данный компонент может быть использован как глобальный флаг, доступен для других приложений. Атом может быть гарантированно уничтожен только тем приложением, которое его создало.

События

  • Атом отсутствует – сообщение, возникающее при активизации команд ориентированных на уже созданный атом.
  • Атом принудительно уничтожен – сообщение об успешном уничтожении атома программой его не создавшей.
  • Атом создан – успешной создание атома.
  • Атом существует - сообщение, возникающее при активизации команд ориентированных на уже созданный атом.
  • Атом уничтожен – успешное уничтожение атома, программой его создавшей.
  • Невозможно принудительно уничтожить атом – ошибка при попытке уничтожение атома программой, его не создавшей.
  • Ошибка создания. Атом уже существует - сообщение, возникающее при активизации команд ориентированных на уже созданный атом.
  • Ошибка уничтожения. Атом не существует - сообщение, возникающее при активизации команд ориентированных на уже созданный атом.
  • Ошибка уничтожения. Атом создал другой объект - сообщение, возникающее при активизации команд ориентированных на уже созданный атом.
  • Системная ошибка создания атома – ошибка при создании атом на уровне операционной системы.
  • Системная ошибка уничтожения атома - ошибка при уничтожении атом на уровне операционной системы.

Реакции

  • Принудительно уничтожить атом – команда на уничтожение атома созданного другим приложением.
  • Проверить наличие атома – проверка состояние атома.
  • Создание атома (если не занят) – создание атома.
  • Уничтожить атом (если сами создали) – уничтожение атома.

Связь по данным

Данный компонент не имеет связей по данным.

  Буфер обмена

Программирование компонента

Компонент, позволяющий организовывать обмен информацией через буфер обмена системы Windows. Возможен обмен только числовой и строчным типом данных.

События

  • Ошибка доступа к буферу обмена – сообщение о не возможности осуществить доступ к буферу обмена. Ошибка на уровне операционной системы.
  • Ошибка загрузки – сообщение, о не возможности инициализации буфера обмена данными из указанного источника.
  • Ошибка получения данных – сообщение об отсутствии данных в указанном источнике.
  • Успешная загрузка – сообщение об успешной инициализации буфера обмена.
  • Успешное получение данных – сообщение о наличии данных в источнике в момент инициализации буфера обмена.

Реакции

  • Загрузить – команда инициализации буфера обмена данными из указанного источника.

Связь по данным
Источники

  • Данные – содержимое буфера обмена.

Приемники

  • Данные – значение для инициализации буфера обмена.

  Взаимодействие с Web Server

Программирование компонента

Компонент, позволяющий организовывать взаимодействия с Web Сервером системы Miracle. Данный компонент является полной версией данного типа объектов.
  Объект предназначен для репрезентации виртуальных страниц на Miracle Web Server. Соединение с Web сервером производится в момент создания объекта, то есть запуска приложения, а рассоединение в момент выхода из приложения.
  В диалоге настройки задается адрес Web сервера, путь до имени виртуального файла, который будет представлять объект, идентификатор и набор из объектов, которые будут впоследствии обрабатываться.
  Кнопка выбора поддержки метода POST включает обработку объектов, но не отменяет возможность возникновения события о поступлении POST запроса, в случае посылки формы.
  Изменение значений объектов происходит в двух случаях. Во-первых при принудительном их задании командами загрузки значений. И во-вторых при обработке их методами POST или GET/par.
  Метод GET - прямой запрос страницы. Метод POST - запрос страницы с посылкой новых значений формы. Метод GET/par аналогичен методу POST, но значения формы задаются не в теле запроса, а в URL, например запросы такого вида: http://www.miracle.ru/miracle/login?Edit3=Guest&Edit5=guestpass
  В любом случае при приеме одного из запросов необходимо подать команду для посылки ответа Web серверу или перенаправления. Иначе приложение не только перестанет быть доступным на Web сервере, но и будет происходить бесконечное ожидание ответа на стороне Web клиента, до тех пор, пока не произойдет выход из приложения.
  Кнопка выбора публикации на Web сервере включает виртуальную страницу данного спецобъекта в список доступных на сервере приложений.
Кнопка #include включает на Web сервере дополнительную обработку страницы, включающую в себя замену всех встречающихся строк вида '<!--#include file=' на файлы, которые указаны за ней. Это несколько замедляет отдачу страницы Web сервером, но зато позволяет включать сформированные дополнительными средствами куски HTML кода.
Примечание. Имя файла для включения должно заканчиваться символами '-->'. Ограничение на размер передаваемой страницы на Web сервер - 32 килобайта. С помощью данных строк включения это ограничение также можно обойти. См.тж. спецобъект публикации на Web сервере.
  Нумерация объектов идет вне зависимоти от возможности их обрабатывать данные, то есть если идут последовательно объект ввода, объект текста и еще один объект ввода, то второй ввод будет иметь номер, отличающийся на два от первого.
Код, который формирует тот или иной объект, отображается слева внизу в диалоге наcтройки.
  Типы объектов:
  HTML Текст. Это объект, в котором задается весь основной текст странички. Первый объект всегда имеет такой тип, так как в нем задается все, что должно идти между автоматически формируемыми тегами <head> и <form>, также в нем задается тег <body>.

Внимание! Не следует использовать дополнительных тегов <form> и </form>, так как данный объект умеет обрабатывать только данные из одной формы и автоматически их формирует в начале и конце страницы.


  Ввод. Это объект однострочного ввода данных.
  Редактор. Объект многострочного ввода данных.
  Кнопка. Кнопки бывают трех типов - Посылка формы (основной тип), при нажатии на которую произойдет POST запрос. Очистка формы - возвращает все исходные значения объектам формы на момент ее загрузки. Третий тип - Посылка формы с событием производит кроме POST запроса еще событие по нажатию, что можно использовать в формах с несколькими кнопками.
  Радио. Предоставляет варианты выбора как в аналогичном объекте Windows.   Разделитель - это HTML код, который будет вставляться между каждой из радио кнопок. Выбранный в списке объект будет выбран в HTML коде. Связь по данным - номер выбранной кнопки в списке.
  Выбор. Кнопка выбора. Связь по данным - 0 или 1.
  Список. Аналогичен Windows. Имеет две связи по данным - номер выбранного в списке значения, а также сам список (при загрузке списка через связь по данным в качестве разделителей могут использоваться символы ^, которые будут автоматически заменятся на символы перевода строки).
Выпадающий список. Аналогичен комбинированному списку Windows. Список высотой 1.
  Невидимый. Объект для хранения различных значений.
  Внешний текст. Объект прямой передачи в связи по данным HTML кода.
Этот объект не формирует автоматически начало и конец страницы, но при его создании он добавляет их примеры, которые желательно не сильно изменять (особенно тэг <form>), так как работа объекта может быть нарушена.
  Внешний текст BLOB - для текста в виде BLOB (ограничение на общий размер тем не менее все равно пока остается)
Список из нескольких - можно выбирать несколько вариантов из списка, связи по данным тоже в виде списков
  Не ограничен размер передаваемой виртуальной страницы.

События

  • Значение идентификатор задано – сообщение об успешном присвоении идентификатора (не хранимой COOKIES). Область действия со страницы присвоения значения. Имя COOKIES задается на уровне настройки формы.
  • Название формы загружено – сообщение об успешной загрузке названия формы.
  • Начальные значения загружены – сообщение о успешном приведение значений объектов формы в начальное состояние.
  • Ошибка – запрос от Web сервера не поступал – сообщение, на попытку отправки ответа Web серверу.
  • Ошибка – невозможно подключиться к серверу – сообщение, о невозможности подключиться к WEB серверу по указанному адресу.
  • Ошибка – произошло отключение от сервера – сообщение о разрыве связи с Web сервером.
  • Ошибка загрузки адреса перенаправления – сообщение, о невозможности установки адреса перенаправления.
  • Ошибка загрузки значения идентификатора – сообщение, об ошибке загрузки значение идентификатора (COOKIES)
  • Ошибка загрузки названия формы – сообщение об ошибке загрузки названия формы.
  • Перенаправлено – сообщение об успешном перенаправлении с текущей web формы.
  • Поступил GET запрос от Web сервера -
  • Поступил GET/par запрос от Web сервера -
  • Поступил POST запрос от Web сервера –

Реакции

  • Вернуть начальные значения объектов – команда, активизирующая инициализацию объектов формы в начальное состояние.
  • Загрузить название формы – команда, активизирующая загрузку название формы.
  • Задать значение идентификатора – присвоение значения идентификатору (COOKIES), имя идентификатора задается в процессе проектирования Web формы.
  • Отправить ответ – ошибка – команда, создающая web-форму с текстом «ошибки». Как метод быстрого формирования web-форм, не содержащих управляющих элементов.
  • Отправить ответ Web сервера – команда, отправляющая web-форму как ответ на запрос поступающий от web сервера. Запрос может быть в виде POST/GET/GET param – запросов.
  • Перенаправить Web сервера – команда, перенаправляющая на другую Web страничку, по заданному адресу.

Связь по данным
Источники

  • Название формы – текущее название формы
  • Значение идентификатора – значение COOKIES
  • Значение POST – значение POST метода полученного от формы.

    Например: Edit2=%EC%EF%F0

  • Путь и имя файла – значение, указывающее путь и имя виртуального файла Web формы.
    Следует помнить, что все странички автоматически рассматриваются в корневом каталоге web сервера. Другие каталоги нужно указывать явно. Напрмер: dva/point-meet.htm

  • Адрес сервера – адрес доступа к web серверу системы.

    Например: camelot

  • HTTP: IP – IP адрес клиента от которого поступил запрос на web страничку.

    Например: 192.168.3.164

  • HTTP: DNS – DNS клиента от которого поступил запрос на web страничку.

    Например: GORSHKOV

  • HTTP: значение о типе броузера используемого клиентом.

    Например: User Agent - Mozilla/4.0 (compatible; MSIE 5.5; Windows 98; Win 9x 4.90)

  • HTTP: Host – Адрес HOST клиента от которого поступил запрос на web страничку.

    Например: 192.168.*.***

  • HTTP: Referer – полный адрес к станице от которой поступил запрос на web страничку.

    Например: http://192.168.*.***/dva/point-meet.htm

  • Транскодер из HTTP – строка прошедшая транскодировку из формата HTTP в формат строку, используемой в системе Miracle.
  • Элементы странички – например элемент ввода, может содержать введенное значение.

Приемники

  • Название формы – новое название формы
  • Адрес для перенаправления – адрес перенаправления
  • Значение идентификатора – значение COOKIES
  • Сообщение об ошибке – текст сообщения. Для формирования странички по команде «Отправить ответ - ошибка»
  • Транскодер из HTTP – данные в формате HTTP для транскодирования.

  Взаимодействие с Web Server - картинка

Программирование компонента

Компонент служит для размещения на Web сервере виртуальных картинок.
Данный объект поддерживает механизм предоставления графической информации из базы данных, хранимой в виде блоб-данных. Тип картинок:

  • Gif
  • Jpeg
  • Png
  • Bmp
  • Tiff
Следует помнить, что виртуальные картинки не кэшируются.

Настройка компонента включает в себя задание адреса web сервера, путь размещения виртуального файла на web сервере системы Miracle. А, так же указание типа файла.

События

  • Ошибка – запрос от Web сервера не поступал – сообщение, сигнализирующее о попытке отправки ответа web-серверу, без запроса на данные от него.
  • Ошибка – установлена связь по данным – сообщение о не возможности получения данных.
  • Ошибка – невозможно подключиться к серверу – сообщение о не возможности подключения к серверу по заданному адресу.
  • Ошибка – произошло отключение от сервера – сообщение о возникновении разрыва соединения с Web сервером системы Miracle.
  • Поступил запрос от Web сервера – сообщение от Web сервера на получение данных.

Реакции

  • Отправить ответ для Web сервера – команда, на отправку данных.

Связь по данным
Источники

  • Картинка – данные в формате блоб.

Приемники

  • Картинка – приемник для задачи данных в формате блоб. Непосредственно размещаемая картинка.
  • Тип картинки – указание на тип картинки.
    • Gif
    • Jpeg
    • Png
    • Bmp
    • Tiff

  Взаимодействие с Web Server - публикация

Программирование компонента

Компонент, позволяющий организовывать размещение файлов в каталогах Web сервера системы Miracle. Размещение производиться по заданным установкам, адреса Web сервера, пути и имени файла.
  Через данный компонент, возможно организовывать размещение файлов в директориях web сервера, без явного доступа к ним.

События

  • Имя файла успешно загружено – сообщение об успешной загрузке имени файла.
  • Ошибка – не установлена связь по данным – сообщение о проблемах при попытке загрузки информации.
  • Ошибка – невозможно подключиться к серверу – сообщение о не возможности установки соединения с web сервером системы.
  • Ошибка – неудачная отправка файла – сообщение о не удачной публикации файла на web сервере.
  • Ошибка загрузки имени файла – сообщение об ошибке установки имени файла.
  • Файл успешно опубликован – сообщение об успешной публикации заданного файла на Web сервере.

Реакции

  • Загрузить имя файла для публикации – команда, активизирующая инициализацию пути и имени файла для публикации на web сервер.
  • Публиковать на Web сервера – команда, активизирующая публикацию (размещение) заданного файла на Web сервере.

Связь по данным
Источники

  • Файл – информация в виде блоб о последнем размещенном файле.

Приемники

  • Файл – информация для размещения в формате блоб на web сервере.
  • Имя файл для публикации на сервере – путь и имя файла указывающие куда размещать «файл» на web сервере.

  Взаимодействие с Web Server (простая версия)

Программирование компонента

  Объект предназначен для репрезентации виртуальных страниц на Miracle Web Server. Соединение с Web сервером производится в момент создания объекта, то есть запуска приложения, а рассоединение в момент выхода из приложения.
  Данный компонент представляет упрощенную версию из данного типа объектов. Его работа аналогична компоненту – «Взаимодействие с Web сервером.», За исключением возможности вносить изминения в начальные и завершающие строки web формы.
  Компонент, в котором задается весь основной текст странички. Первый объект всегда имеет такой тип, так как в нем задается все, что должно идти между автоматически формируемыми тегами <head> и <form>, также в нем задается тег <body>.


Внимание! Не следует использовать дополнительных тегов <form> и </form>, так как данный объект умеет обрабатывать только данные из одной формы и автоматически их формирует в начале и конце страницы.

  Встроенный алгоритм

События

Реакции

  Доступ к WWW файлам

Программирование компонента

Компонент, позволяющий осуществлять доступ к файлам в InterNet.
  По сути данный компонент является мини-броузером.Служит для получения информации из Сети по протоколу HTTP.
  Настройка компонента позволяет задавать адрес в сети получаемого файла, адрес ссылки, имя получаемого файла.


Следует помнить, что в течение работы данного компонента, приложение его запустившее «не видит сообщений». Если не отключен индикатор получения файла, так же не доступны операции над окнами этого приложения.

События

  • (Дополнительная) Ошибка HTTP – дополнительная ошибка о работе компонента (появляется в связке с «основной» ошибкой)
  • (Дополнительная) Ошибка доступа к адресу - дополнительная ошибка о работе компонента (появляется в связке с «основной» ошибкой)
  • (Дополнительная) Ошибка загрузки файла - дополнительная ошибка о работе компонента (появляется в связке с «основной» ошибкой)
  • (Дополнительная) Ошибка записи в файл - дополнительная ошибка о работе компонента (появляется в связке с «основной» ошибкой)
  • (Дополнительная) Ошибка создания соединения - дополнительная ошибка о работе компонента (появляется в связке с «основной» ошибкой)
  • (Дополнительная) Ошибка создания файла - дополнительная ошибка о работе компонента (появляется в связке с «основной» ошибкой)
  • (Дополнительная) Ошибка формата адреса - дополнительная ошибка о работе компонента (появляется в связке с «основной» ошибкой)
  • Выбран адрес – сообщение об успешном задании адреса (URL) через диалоговое окно.
  • Выбран адрес ссылки - сообщение об успешном задании адреса ссылки (URL) через диалоговое окно.
  • Выбрано имя файла для сохранения – сообщение об успешном задании имени и пути для сохранения полученных результатов, через диалоговое окно.
  • Вызов перенаправлен – сообщение о перенаправлении с указанного адреса (URL).
  • Не выбран адрес – сообщение об отказе задания адреса (URL) в диалоговом окне.
  • Не выбран адрес ссылки - сообщение об отказе задания адреса ссылки (URL) в диалоговом окне.
  • Не выбрано имя файла для сохранения - сообщение об отказе задания имени файла для сохранения результата, в диалоговом окне.
  • Ошибка доступа к TCP/IP – сообщение об ошибке TCP/IP
  • Ошибка загрузки адреса – сообщение об ошибке инициализации адреса (URL) из внешнего источника.
  • Ошибка загрузки адреса ссылки - сообщение об ошибке инициализации адреса ссылки (URL) из внешнего источника.
  • Ошибка загрузки данных для передачи - сообщение об ошибке инициализации данных из внешнего источника, для передачи страничке, например пароли доступа и т.п.
  • Ошибка загрузки имени файла - сообщение об ошибке инициализации имени файла, для сохранения результатов, из внешнего источника.
  • Ошибка приема файла (Основная) – сообщение об ошибке получения файла по заданному URL
  • Успешная загрузка адреса – сообщение об успешной инициализации адреса.
  • Успешная загрузка адреса ссылки - сообщение об успешной инициализации адреса ссылки.
  • Успешная загрузка имени файла - сообщение об успешной инициализации имени файла для сохранения результатов.
  • Успешный прием файла – сообщение об успешном приеме файла по указанному URL.

Реакции

  • Включить показ процесса – команда, активизирующая отображение индикатора работы компонента.
  • Восстановить адрес – команда, восстанавливающая инициализационный адрес (URL), заданный в момент проектировки приложения.
  • Выбрать адрес – команда активизирующая диалог ввода адреса (URL)
  • Выбрать адрес ссылки - команда активизирующая диалог ввода адреса ссылки(URL)
  • Выбрать файл для сохранения - команда активизирующая диалог ввода пути и имени результирующего файла.
  • Загрузить адрес – команда, активизирующая инициализацию адреса, значением из внешнего источника.
  • Загрузить адрес ссылки - команда, активизирующая инициализацию адреса ссылки, значением из внешнего источника.
  • Загрузить имя файла - команда, активизирующая инициализацию имени результирующего файла, значением из внешнего источника.
  • Кэшировать файл (не удалять) – команда, указывающая компоненту не удалять «промежуточные» файла.
  • Не кэшировать файл (удалять) – команда, указывающая компоненту удалять «промежуточные» файла.
  • Отключить показ процесса – команда, указывающая компоненту на скрытие индикатора работы.
  • Очистить адрес ссылки – команда «сбрасывающая» значение – адрес ссылки.
  • Получить файл – команда, активизирующая процесс получения файла.
  • Послать данные и получить файл – команда активизирующая процесс подключения к странице и передачи ей информации.
  • Скопировать перенаправленный адрес в адрес – команда позволяющая осуществлять инициализацию адреса новым значением, из полученного адреса ссылки, образовавшегося в процесс перенаправлением страницы с первичного адреса (URL), на другой являющимся скрытым от пользователя.

Связь по данным
Источники

  • Адрес – текущий адрес (URL)
  • Имя файла – текущее значение пути и имени файла для сохранения результата.
  • Файл – полученная информация в блоб формате.
  • Этот компьютер – имя компьютера исполняемого компонент.
  • Адрес ссылки – установленный адрес (URL)
  • Код ошибки WWW – информация о характере ошибки.
  • Транскодер в HTTP формат – информация, преобразованная в формат HTTP. Работает без специальных команд, достаточно получить данные из источника.
  • Транскодер из WIN в КОИ8 - информация, преобразованная в формат КОИ8. Работает без специальных команд, достаточно получить данные из источника.
  • Транскодер из КОИ8 в WIN - информация, преобразованная в формат WIN. Работает без специальных команд, достаточно получить данные из источника.
  • Адрес перенаправления – текущее значение адреса перенаправления.

Приемники

  • Адрес – устанавливаемый адрес (URL)
  • Имя файла – устанавливаемое имя и путь результирующего файла.
  • Файл -
  • Адрес ссылки – устанавливаемый адрес ссылки.
  • Данные для передачи – информация для отправки странице.
  • Транскодер в HTTP формат – данные для преобразования в формат HTTP
  • Транскодер из WIN в КОИ8 – данные для преобразования в формат КОИ8
  • Транскодер из КОИ8 в WIN - данные для преобразования в формат WIN

  Доступ к базам данных через ODBC32

Программирование компонента

  Компонент, позволяющий организовать взаимодействия с информацией, хранимой в базах данных поддерживаемые Сервером управления системы Miracle.
  Доступ к базам данных осуществляется на основании настроек ODBC32. Следует помнить, что данные настройки должны быть описаны на каждом клиентском месте, где предполагается эксплуатировать приложение.
  Настройки компонента позволяют задавать источник данных (Name:User DNS), имя пользователя, пароль пользователя, и количество возвращаемых полей в таблице. При этом следует помнить, что если последовательность полей не задана, то возвращаемы поля будут нумероваться в их физической последовательности. Если список полей задан, но не смотря на количество полей в списке, порядок возвращаемых полей будет определять список. Но не их возвращаемое количество. Если количество полей превышает их физическое количество, то работа с «лишними» полями будет не доступна. Но общая работа с компонентом поддержана. В принципе через один компонент, можно организовывать работу (по переменно), более чем с одной таблицей в указанном «источнике».
  Последовательность команд для получения курсора:

  1. Подключиться (если не заданы источник данных ODBC, имя пользователя

    или

    пароль, они будут запрошены) (обязательно).

  2. Задать имя таблицы (обязательно).
  3. Если необходимо, задать список полей (через ','). В случае его отсутствия подразумевается *.
  4. необходимо, задать WHERE часть SQL предложения. По умолчанию - нет.
  5. необходимо, задать шаблон SQL предложения.
    Шаблон по умолчанию - SELECT %f FROM %t[ WHERE %w], где
    • %t - имя таблицы (2)
    • %f - список полей (3)
    • %w - WHERE часть (4)
  6. Создать курсор.

  Спецобъект пользуется единым буфером обмена с программой работы с ODBC, поэтому в зависимости от типа или результата выполнения той или иной команды, его содержимое будет различным. Тем не менее, для удобства работы со спецобъектом создано несколько источников и приемников данных.
  В случае возникновения какой - либо ошибки, в буфер обмена заносится ее текст (сформированный либо спецобъектом, либо программой обмена, либо непосредственно ODBC, либо драйвером ODBC).
  В случае успешного завершения операций хождения в буфер заносятся содержимое всех перечисленных в п.3 полей. Доступ к ним осуществляется через дополнительные связи по данным, количество которых задается в конфигурации спецобъекта.
  Операции добавления/изменения/удаления осуществляются через следующие шаблоны соответственно:

  • INSERT INTO %t[ (%f)] VALUES (%v)
  • UPDATE %t SET %1f=%1v[...,%nf=%nv] WHERE CURRENT OF %c
  • DELETE FROM %t WHERE CURRENT OF %c

    то есть удалять и добавлять записи можно и при неизвестном списке полей.

    • %c - имя курсора
    • %v - список значений полей (полученный через связи по данным)
    • %nf - имя поля по номеру
    • %nv - значение поля по номеру

  Через задание шаблона SQL предложения вы можете формировать самостоятельные SQL предложения, в которые будут подставляться необходимые переменные через % (для задания символа % в шаблоне задайте %%).
  Если вы хотите задать значение полей (%v), то воспользуйтесь командой 'Выполнить SQL предложение с записью'. Отличие ее от команды 'Выполнить SQL предложение (создать курсор)' в том, что будет произведен запрос по данным значений всех полей (как для команд 'Добавить' и 'Изменить') и будет использован оператор замены, а не курсора.
  Курсор становится недействительным после команд:
  'Задать имя таблицы' или 'Задать список полей'

События

  • SQL предложение выполнено (курсор создан) – сообщение об успешном подключение к базе данных, и создании курсора работы с таблицей.
  • SQL предложение с записью выполнено – сообщение об успешном выполнении заданного SQL предложения с записью.
  • WHERE часть SQL предложения задана – сообщение об успешной установке WHERE части предложения. Данная возможность является упрощенным вариантом работы с таблицей, против команды «Задать шаблон SQL предложения», требующей формирования всей структуры SQL предложения, а не только ее WHERE части.
  • Запись добавлена – сообщение об успешном создании новой записи.
  • Запись изменена – сообщение об успешной модификации записи.
  • Запись удалена – сообщение об успешном удалении записи.
  • Имя пользователя загружено – сообщение об успешной инициализации значения имени пользователя.
  • Имя таблицы задано – сообщение об успешной инициализации имени таблицы, в указанном источнике (базе данных).
  • Название источника данных загружено – сообщение об успешной инициализации имени источника.
  • Отключено – сообщение о завершении связи с установленным источником, и удалении созданного курсора.
  • Ошибка выполнения SQL предложения – сообщение об ошибке выполнения заданного SQL предложения.
  • Ошибка выполнения SQL предложения с записью – сообщение об ошибке выполнения SQL предложения с записью.
  • Ошибка добавления записи – сообщение об ошибке добавления новой записи.
  • Ошибка загрузки WHERE части SQL предложения – сообщение об ошибке инициализации WHERE части SQL предложения.
  • Ошибка загрузки имени пользователя – сообщение об ошибке инициализации имени пользователя.
  • Ошибка загрузки имени таблицы – сообщение об ошибке инициализации имени таблицы.
  • Ошибка загрузки источника данных – сообщение об ошибке инициализации названия источника данных.
  • Ошибка загрузки пароля пользователя – сообщение об ошибке инициализации пароля пользователя.
  • Ошибка загрузки списка полей – сообщение об ошибке инициализации списка полей таблицы.
  • Ошибка загрузки шаблона SQL предложения – сообщение об ошибке загрузки.
  • Ошибка изменения записи – сообщение об ошибки модификации записи.
  • Ошибка отключения – сообщение об ошибке отключения от указанного источника.
  • Ошибка перехода на запись вверх – сообщение о результате навигации по таблице.
  • Ошибка перехода первую запись - сообщение о результате навигации по таблице.
  • Ошибка перехода на последнюю запись - сообщение о результате навигации по таблице.
  • Ошибка подключения - сообщение о результате навигации по таблице.
  • Ошибка удаления записи - сообщение о результате навигации по таблице.
  • Ошибка установки взаимодействия с посредником – сообщение об ошибке работы драйвера ODBC32.
  • Пароль пользователя загружен – сообщение об успешной инициализации пароля пользователя.
  • Список полей задан - сообщение об успешной инициализации списка полей.
  • Стандартный шаблон SQL предложения загружен - сообщение об успешной инициализации стандартного шаблона SQL предложения.
  • Успешное подключение – сообщение об успешном подключении к таблице.
  • Успешный переход на запись вверх - сообщение о результате навигации по таблице.
  • Успешный переход на запись вниз - сообщение о результате навигации по таблице.
  • Успешный переход на первую запись - сообщение о результате навигации по таблице.
  • Успешный переход на последнюю запись - сообщение о результате навигации по таблице.
  • Шаблон SQL предложения задан – сообщение об успешной инициализации шаблона SQL предложения.

Реакции

  • Вернуть стандартный шаблон SQL предложения – команда, приводящая к инициализации шаблона SQL предложения стандартным (по умолчанию) предложением.
  • Выполнить SQL предложение (создать курсор) – команда, позволяющая осуществить подключение к таблице, т.е. создать «курсор», данная команда должна быть первой при активизации таблицы. А так же для выполнения выборки при задании WHERE части.
  • Выполнить SQL предложение с записью – команда, позволяющая исполнить SQL предложение.
  • Добавить – команда, позволяющая создавать новую запись.
  • Загрузить имя пользователя – команда, позволяющая инициализировать имя пользователя. Используется до создания курсора.
  • Загрузить название источника данных – команда, позволяющая инициализировать название «источника» данных. Используется до создания курсора.
  • Загрузить пароль пользователя – команда, позволяющая инициализировать пароль пользователя. Используется до создания курсора.
  • Задать WHERE часть SQL предложения – команда. Позволяющая инициализировать WHERE часть SQL предложения. Общая структура предложения будет состоять из «стандартного шаблона SQL предложения» и указанной WHERE части. При этом само слово “WHERE”, будет подготовлено автоматически, и не должно быть указываться в подготовленном выражении WHERE части.
  • Задать имя таблицы – команда, инициализирующая имя таблицы. Используется до создания курсора.
  • Задать список полей – команда, позволяющая указывать порядок полей и их количество при обращении к таблице. При этом следует помнить, что общее (доступное) количество полей определяется переменной – «количество полей» в настройках компонента. Используется до создания курсора.
  • Задать шаблон SQL предложения – команда, позволяющая инициализировать полное SQL предложение к открытому курсору.
  • Изменить – команда, позволяющая внести изменения в текущую запись.
  • Отключиться – команда, позволяющая осуществить отключение от «источника». Убить курсор.
  • Перейти на запись вверх – команда навигации по таблице.
  • Перейти на запись вниз - команда навигации по таблице.
  • Перейти на первую запись - команда навигации по таблице.
  • Перейти на последнюю запись - команда навигации по таблице.
  • Подключиться – команда позволяющая осуществить подключение к источнику. Но не создание курсора таблицы. Используется первой до создания курсора.
  • Удалить – команда, позволяющая удалять текущую запись.

Связь по данным
Источники

  • Источник данных – имя текущего источника
  • Имя пользователя – имя текущего пользователя
  • Пароль – текущий пароль
  • Буфер обмена (сообщение об ошибке) – строка с описанием ошибки. Данная переменная инициализируется только в случае возникновения ошибки при исполнении команд на SQL сервере.
  • Буфер обмена (SQL предложение) – текущее SQL предложение.
  • Буфер обмена (значение поля N) – количество источников зависит от указанного количества полей в настройках компонента. Порядок следования – если не задан список полей, от физической структуры таблицы. Либо от порядка полей указанных в списке.

Приемники

  • Источник данных – источник для инициализации имени источника данных.
  • Имя пользователя - источник для инициализации имени пользователя
  • Пароль - источник для инициализации пароля пользователя
  • Буфер обмена (запись имени таблицы) - источник для инициализации имени таблицы
  • Буфер обмена (запись списка полей) - источник для инициализации списка полей. (Список полей перечисляется через запятую, имена полей в двойных кавычках.
    Например: "IMA_ItemName","IMA_UnitMeasure","IMA_OnHandQty","IMA_ItemID","IMA_UserDef1")
  • Буфер обмена (запись шаблона SQL предложения) - источник для инициализации шаблона полного SQL предложения.
  • Буфер обмена (запись WHERE части SQL предложения) - источник для инициализации только WHERE части SQL предложения.
  • Буфер обмена (значение поля N) - источник для инициализации содержимого поля N.

  Клавиатура

Программирование компонента

Компонент, позволяющий использовать в рамках приложения работу функциональных клавиш. Каждая функциональная клавиша представлена собственным событием от F1 до F24.
В источнике по связям имеется три элемента, позволяющие идентифицировать состояние клавиш Shift, Ctrl, Alt. Следует помнить, что состояние этих источников меняется каждый раз при их нажатии.

События

Каждой функциональной клавише соответствует собственное событие от F1 до F24

Реакции

Нет

Связь по данным
Источники

  • Состояние клавиши SHIFT
  • Состояние клавиши ALT
  • Состояние клавиши CRTL

Приемники

Нет

  Консоль

События

Реакции

  Контейнер

Программирование компонента

  Компонент, позволяющий организовывать временное хранение информации в виде списка. В качестве хранимой информации может выступать данные в формате строки, числе, дата. Информацию из объекта можно получать как в виде данных текущей строки, так и в виде списка, данные через запятую, так и в виде блоб данных.

События

  • BLOB Ошибка загрузки списка – сообщение об ошибке инициализации контейнера списком в виде BLOB получаемого из внешнего источника.
  • BLOB Успешная загрузка списка – сообщение об успешной инициализации контейнера списком в виде BLOB.
  • FILE Ошибка загрузки списка – сообщение об ошибке инициализации списка из внешнего источника.
  • FILE Успешная загрузка списка - сообщение об успешной инициализации списка из внешнего источника.
  • Все элементы удалены – сообщение, об успешном удалении всех элементов в контейнере.
  • Невозможно загрузить список элементов полностью – сообщение, связанное с ограничением размера буфера обмена. (8Кб). Для формирования контейнера из внешнего источника большим объемом используйте механизм блоб – обмена.
  • Невозможно перейти на нужный элемент – сообщение, сигнализирующее о не возможности перейти на указанный элемент.
  • Невозможно сформировать BLOB – сообщение, сигнализирующее о не возможности подготовки списка в формате блоб.
  • Ошибка добавления элемента – сообщение, об ошибке создания нового элемента в контейнере.
  • Ошибка загрузки списка – сообщение об ошибке загрузки списка из внешнего источника.
  • Ошибка замены элемента – сообщение об ошибке во время замены содержимого текущего элемента.
  • Ошибка перехода вниз – сообщение навигации по списку контейнера.
  • Ошибка перехода на первый элемент - сообщение навигации по списку контейнера.
  • Ошибка перехода на последний элемент - сообщение навигации по списку контейнера.
  • Ошибка перехода вверх - сообщение навигации по списку контейнера.
  • Ошибка удаления элемента - сообщение навигации по списку контейнера.
  • Успешная загрузка списка – сообщение об успешной инициализации контейнера списком из внешнего источника.
  • Успешная замена элемента – сообщение об успешной модификации текущего элемента контейнера.
  • Успешное добавление элемента – сообщение об успешном создании нового элемента в контейнере. Порядок расположения в контейнер «следующий после последнего».
  • Успешное удаление элемента – сообщение об успешном удаление текущего элемента контейнера.
  • Успешный переход на нужный элемент – сообщение об успешном переходе на указанный элемент контейнера.
  • Успешный переход на первый элемент - сообщение навигации по списку контейнера.
  • Успешный переход на последний элемент - сообщение навигации по списку контейнера.
  • Успешный переход вверх - сообщение навигации по списку контейнера.
  • Успешный переход вниз - сообщение навигации по списку контейнера.
  • Элемент найден – сообщение об успешном переходе на элемент, найденный согласно условиям поиска.
  • Элемент не найден - сообщение об ошибке поиска элемента. Позиция в списке не изменяется.

Реакции

  • Добавить – команда, позволяющая создать новый элемент списка.
  • Загрузить список – команда, инициализации контейнера списком из внешнего источника. Данные должны быть в формате «список».
  • Загрузить список (blob) - команда, инициализации контейнера списком из внешнего источника в формате blob.
  • Загрузить список (file) - команда, инициализации контейнера списком из внешнего источника. Т.е. из указанного файла.
  • Заменить – команда, производящая замену содержимого текущего элемента контейнера.
  • Найти элемент – команда, активизирующая поиск элемента, по его содержимому, по схеме «включения» искомой строки поиска. Поиск ведется от текущей позиции, вниз.
  • Перейти на нужный элемент – команда, активизирующая переход на указанный номер элемента.
  • Перейти на один элемент вверх – команда навигации
  • Перейти на один элемент вниз - команда навигации
  • Перейти на первый элемент - команда навигации
  • Перейти на последний элемент - команда навигации
  • Удалить – команда активизирующая удаление текущего элемента.
  • Удалить все элементы – команда активизирующая удаление всех элементов в списке.

Связь по данным
Источники

  • Данные – текущее значение элемента.
  • Количество элементов – информация о текущем количестве элементов в списке.
  • Номер текущего элемента – информация о текущем номере элемента.
  • Все элементы в виде списка – информация в виде списка всех элементов.
  • Все элементы в виде списка (Blob) - информация в виде списка всех элементов в формате blob.
  • Все элементы в виде списка в обратном порядке (Blob) - информация в виде списка всех элементов в формате blob, при этом список формируется от последней записи к первой.
  • Все элементы в виде списка в обратном порядке - информация в виде списка всех элементов, при этом список формируется от последней записи к первой.

Приемники

  • Данные – значение для инициализации содержимого элемента.
  • Эталон поиска – значения для поиска по списку.
  • Номер текущего элемента – значение для перехода по номеру элемента.
  • Все элементы в виде списка – информация в виде списка, для инициализации контейнера новыми значениями.
  • Все элементы в виде списка (Blob) - информация в виде блоб, для инициализации контейнера новыми значениями.
  • Все элементы в виде списка (File) – значение, путь и имя файла являющимся источником инициализации контейнера.
  • Все элементы в виде списка в обратном порядке (Blob) - информация в виде блоб, для инициализации контейнера новыми значениями. При этом порядок элементов в контейнере будет «зеркальным» по отношению к исходному списку.

  Объект взаимодействия c 1C бухгалтерией

События

Реакции

  Объект доступа к DBF файлам

Программирование компонента

  Компонент, позволяющий организовывать взаимодействия с файлами в формате *.DBF.Путь и структура файла, полей используемые для работы, формируются в процессе настройки компонента. Флаг – «Игнорировать числовые подтипы», позволяет получать данные из полей типа число в независимости от подтипа числового поля. Например: поле, имеющее тип «число» может содержать данные в с «плавающей точкой», игнорирование числового подтипа, позволяет получать информацию в не искаженном виде.

События

  • DBF файл открыт – сообщение об успешном открытии указанного файла.
  • DBF файл не открыт – сообщение об ошибке открытия указанного файла.
  • DBF файл уже был открыт – сообщение о попытке открыть файл, который уже открыт.
  • Не задан путь к DBF файлу – сообщение о не возможности открыть файл, так как не задан путь к нему.
  • Отмена выбора базы данных – сообщение об отмене выбора базы данных (файла DBF) в диалоге выбора.
  • Ошибка загрузки пути к DBF файлу – сообщение об ошибки загрузки пути и имени к фалу DBF
  • Ошибка открытия DBF файла – сообщение об ошибке открытия файла. Это может быть вызвано тем, что данный файл уже открыт в другой задаче.
  • Ошибка перехода вверх – сообщение навигации по файлу.
  • Ошибка перехода вниз - сообщение навигации по файлу.
  • Ошибка перехода на первую запись - сообщение навигации по файлу.
  • Ошибка перехода на последнюю запись - сообщение навигации по файлу.
  • Произведен выбор базы данных – сообщение о выборе файла в диалоге.
  • Успешная загрузка пути к DBF файлу – сообщение об успешной загрузке пути и имени файла DBF.
  • Успешное открытие DBF файла – сообщение, об успешном открытии файла.
  • Успешный переход вверх - сообщение навигации по файлу.
  • Успешный переход вниз - сообщение навигации по файлу.
  • Успешный переход на первую запись - сообщение навигации по файлу.
  • Успешный переход на последнюю запись - сообщение навигации по файлу.

Реакции

  • Диалог выбора файла – команда, активизирующая диалог выбора файла DBF
  • Загрузить путь к DBF файлу – команда, инициализации пути доступа к файлу.
  • Закрыть DBF файл – команда закрытия файла.
  • Открыть DBF файл – команда открытия файла. Данная команда является ключевой для организации работы с файлом DBF.
  • Перейти на одну запись вверх – команда навигации.
  • Перейти на одну запись вниз - команда навигации.
  • Перейти на первую запись - команда навигации.
  • Перейти на последнюю запись - команда навигации.

Связь по данным
Источники

  • Путь к DBF файлу – текущий путь и имя файла DBF
  • Количество записей – количество записей в открытой базе данных.
  • Поле N – значение поля N

Приемники

  • Путь к DBF файлу – значения для инициализации пути доступа к базе данных.

  Ожидание очистки очереди сообщений

Программирование компонента

  Компонент, позволяющий получать отклик о полном прекращении событий. Следует помнить, что возможные события, таки как таймер, могут не дать компоненту отработать, так как в систем все время будут идти события.

События

  • Ожидание в процессе – сообщение о том, что объект уже находиться в состоянии ожидания очиски очереди сообщений в системе (приложении)
  • Очередь пуста – сообщение о полной очистке очереди сообщений в приложении.

Реакции

  • Начать ожидание – команда активизирующая ожидание очистки очереди.

Связь по данным
Источники

НЕТ

Приемники

НЕТ

  Работа с текстовым файлом

Программирование компонента

  Компонент, позволяющий организовывать работу с текстовым файлом. А именно производить поиск данных в файле, выборку информации, перемещение курсора по файлу. С целю извлечения необходимой информации.
  Поиск строки завершается на начале следующей строки. Подстроки - после нее. Поиск по шаблону - на начале найденной строки, соответствующей шаблону. Шаблон задается по правилам Paradox.
  Связь по данным - это информация, полученная, начиная с текущей позиции файла, до символа разделителя (если такая связь по данным существует), либо до истечения счетчика (аналогично). По умолчанию разделитель - конец строки, счетчик равен максимальному значению буфера передачи данных. Всегда доступны значения текущей строки и позиции в строке (колонки). По ним также можно позиционироваться.

Правила шаблона типа Paradox: 

Тип символа	Символ		Описание

Специальный	#		Цифра
		?		Буква (без учета регистра)
		&		Буква в верхнем регистре
		@		Любой символ
		!		Любой символ в верхнем регистре
Шаблон	;		Следующий символ взять 
напрямую (если он специальный или шаблонный)
		*		Счетчик символов (по умолчанию 
любое количество)
		[]		Набор символов
		{}		Группа операций
		,		Перечисление (выбор одной из)
		Все остальные	Взять напрямую

Примеры:

*?@	- подразумевает любое количество букв до не буквы, 
например для поиска подстрок типа "red" или "green", надо 
задать шаблон "*?@

*#@	- подразумевает любое количество цифр до не цифры, 
например для поиска подстрок типа a=123)+ или a=8374)+, надо 
задать шаблон a=*#@+

*@	- подразумевает любое количество любых символов, например,
 если окончание требуемой строки неизвестно.

Если требуется найти телефоны вида 70951234567 (Москва) или 
78124578901 (Питер), или 79026801234 (МТС), 
можно задать шаблон 7[095,812,902]*6#@

  Для проверки шаблонов можно воспользоваться визуальным объектом редактирования, в котором можно включить фильтрацию по шаблону типа Paradox.

События

  • Загружено имя файла – сообщение об успешной инициализации имени файла.
  • Колонка вне строки – сообщение об ошибке перемещение метки за границы строки.
  • Колонка найдена – сообщение об успешном поиске заданной колонки (позиции в строке),
  • Ошибка – неправильный шаблон – сообщение по ошибке в структуре шаблона.
  • Ошибка файл не открыт – сообщение о попытке работы с не открытым файлом.
  • Ошибка загрузки данных – сообщение об ошибке загрузки данных в компонент.
  • Ошибка открытия файла – сообщение об ошибке открытия указанного файла.
  • Ошибка удаления – сообщение об ошибке удаления указанного файл.
  • Ошибка удаления – файл открыт - сообщение об ошибке удаления указанного файл, так как указанный файл открыт.
  • Ошибка чтения файла – сообщение об ошибке чтения содержимого файла.
  • Подстрока найдена – сообщение об удачном поиске указанной подстроки.
  • Подстрока не найдена – сообщение об ошибке поиска указанной подстроки.
  • Строка найдена – сообщение об успешном поиске строки.
  • Строка не найдена – сообщение об ошибке поиска указанной строки.
  • Строка найдена по номеру – сообщение об успешном поиске строки по ее номеру.
  • Строка не найдена – сообщение об ошибке поиска указанной строки.
  • Счетчик строк превышен – сообщение, указывающее на попытку перехода на несуществующие строки.
  • Файл закрыт – сообщение, указывающее об успешном закрытии файла.
  • Файл открыт – сообщение, указывающее об успешном открытии файла.
  • Файл удален – сообщение, указывающее об успешном удалении файла.
  • Шаблон найден – сообщение, указывающее об успешном поиске строки по заданному шаблону.
  • Шаблон не найден – сообщение, указывающее об ошибке поиска по шаблону.

Реакции

  • Вернуть запомненную позицию – команда, активизирующая перемещении «метки» на запомненную позицию. Если позиция не задана, то метка ставиться в начало файла, т.е. на первую колонку, первой строки.
  • Встать на колонку – команда, активизирующая перемещения метку на заданную колонку в текущей строке.
  • Встать на начало – перемещение метки на позицию на первую колонку, первой строки.
  • Встать на строку – команда перемещения метки на указанную строку.
  • Загрузить имя файла – инициализации имени файла.
  • Закрыть файл – команда закрытия файла.
  • Запомнить позицию в файле – команда, позволяющая запомнить текущую позицию метки.
  • Найти по шаблону – активизация процесса поиска строки с текущей позиции по шаблону. Следует помнить что «шаблон» поиска применяется по отношению к строке и не может быть использован для писка подстроки.
  • Найти подстроку – активизация поиска подстроки с текущей позиции метки, с учетом регистра символов искомой подстроки.
  • Найти подстроку без учета регистра – активизация поиска подстроки с текущей позиции метки, без учета регистра символов.
  • Найти строку - активизация поиска по точному совпадению строк.
  • Найти строку без учета регистра - активизация поиска по точному совпадению строк, без учета регистра символов.
  • Открыть файл – команда, активизирующая процесс открытия файла.
  • Удалить файл (будьте внимательны!) – удаление указанного файла.

Связь по данным
Источники

  • Имя файла – текущее имя файла.
  • Информация – данные. От текущего положения метки до конца строки. Или до указанного разделителя, если он задан. Или определенное количество символов заданных значением счетчик.
  • Номер строки – текущий номер строки
  • Номер колонки – текущая колонка (позиция) в строке.

Приемники

  • Имя файла – источник для указания имени файла.
  • Строка – источник для указания строки для поиска
  • Подстрока - источник для указания подстроки для поиска
  • Шаблон - источник для указания шаблона для поиска
  • Номер строки – указание номера строки для поиска
  • Номер колонки - указание номера колонки для поиска
  • Разделитель – символ, указывающий окончание фрагмента данных передаваемых от текущего положения метки до разделителя.
  • Счетчик – количество символов, указывающий окончание фрагмента данных передаваемых от текущего положения метки

  Работа с файлами

Программирование компонента

  Компонент предназначен для преобразования связей по данным типа BLOB в файлы и наоборот. Возможно можно удалять файлы. Для проведения процедуры преобразования, достаточно открыть файл и получить его перекодированный вид из источника данных «файл».

События

  • Имя файла загружено – сообщение об успешной инициализации имени файла.
  • Ошибка загрузки имени файла – ошибка инициализации имени файла.
  • Ошибка записи файла – ошибка сохранения файла.
  • Ошибка удаления – сообщение об ошибке при удалении файла.
  • Ошибка чтения файла – сообщение об ошибке чтения указанного файла.
  • Файл записан – сообщение об успешном сохранении файла.
  • Файл удален – сообщение об успешном удалении фйла.

Реакции

  • Загрузить имя файла – команда, активизирующая установку имени файла.
  • Записать файл – команда, активизирующая процесс сохранения файла на диск.
  • Удалить файл (будьте внимательны!) – команда, активизирующая удаление файла.

Связь по данным
Источники

  • Имя файла – имя текущего файла
  • Файл – информация в виде BLOB.

Приемники

  • Имя файла – задание имени файла
  • Файл – информация в виде BLOB

  Синтезатор голоса

Программирование компонента

  Компонент, позволяющий синтезировать фразы на основании заданного текста. Для работы объекта необходимо на каждом рабочем месте иметь запущенную программу MIRVAGNT.EXE – располагаемой в каталоге <Miracle> и установленную поддержку синтезатора голоса MicrosoftSpeech, получить подробную информацию и получить ПО поддержки, можно по адресу: http://www.microsoft.com/speech/

  Возможно произносить фразы 3-мя голосам одновременно.

События

  • Отсутствует Miracle voice агент – сообщение о не запущенном агенте синтезатора голоса.
  • Ошибка загрузки данных – сообщение об ошибке инициализации строки для синтезатора.

Реакции

  • Произнести фразу голосом №1 – команда для произношения фразы голосом №1 (вид голоса задается установками программы Miracle voice агент)
  • Произнести фразу голосом №2 - команда для произношения фразы голосом №1 (вид голоса задается установками программы Miracle voice агент)
  • Произнести фразу голосом №3 - команда для произношения фразы голосом №1 (вид голоса задается установками программы Miracle voice агент)

Связь по данным
Источники

НЕТ

Приемники

  • Фраза – строка для синтеза.

  Сравнение с нулем

Программирование компонента

  Компонент, позволяющий производить анализ состояния объекта по трем значениям.

События

  • Ошибка загрузки данных – сообщение об ошибке загрузке данных.
  • Текущее значение «больше нуля» - сообщение о текущем состоянии компонента.
  • Текущее значение «меньше нуля» - сообщение о текущем состоянии компонента.
  • Текущее значение «ноль» - сообщение о текущем состоянии компонента.
  • Установленное значение «больше нуля» - сообщение о текущем состоянии компонента.
  • Установленное значение «меньше нуля» - сообщение о текущем состоянии компонента.
  • Установленное значение «ноль» - сообщение о текущем состоянии компонента.

Реакции

  • Загрузить данные – команда, активизирующая загрузку состояния компонента из внешнего источника.
  • Проверить текущее значение – активизировать проверку состояния компонента.
  • Установить значение «больше нуля» - команда, по переводу компонента в указанное состояние.
  • Установить значение «меньше нуля» - команда, по переводу компонента в указанное состояние.
  • Установит значение «ноль» - команда, по переводу компонента в указанное состояние.

Связь по данным
Источники

  • Значение – текущее значение компонента.

Приемники

  • Значение – источник для установки нового состояния компонента.

  Текстовый шаблон с поддержкой SQL

Программирование компонента

  Компонент, позволяющий формировать структуру теста на основании шаблона и переменной информации, получаемой из внешних источников.
  Например, необходимо выдавать сообщение в формате “Здравствуйте <имя>”.
Для этой цели формируем шаблон строки в режиме настройки компонента Здравствуйте :имя

Следует помнить, что шаблон автоматически будет пытаться подставить данные в метоимя ссылки на внешний источник, в нашем случае «:имя». Для обеспечения загрузки данных, необходимо организовать описание источника «имя» в описании внешних источников данных.

  Данный компонент обладает свойством, позволяющее использовать его для формирования фрагментов SQL предложений для передачи их в качестве условий запросов к объектам базы данных. Флаг «рассматривать как SQL» позволяет преобразовывать системные имена таблиц и полей в соответствующие описания при миграции приложения в другие Miracle – среды.
   Пример запроса организованного через данный компонент: T105C0.F1 LIKE '%:string%' or T105C0.F3 LIKE '%:string%', где метоимя “string” является ссылкой на внешний источник. Сформированный запрос, подаваемый в ОБД, может иметь уже следующий вид - T105C0.F1 LIKE '%соко%' or T105C0.F3 LIKE '%соко%'
  Размер шаблона (запроса) вводимого в диалоге настройки объекта максимум 1024 байта.
  Формируемый по шаблону ответ ограничен размером буфера обмена системы. По умолчанию это 4096 байт
  Для получения результат достоаточно произвести выборку данных из источника данных – шаблон.

  Для организации выборок в рамках которых необходимо удалить повторяющиеся строк с использованием функции (DISTINCT). Так как данная команда должна быть расположнена в служебной части SQL предложения, доступ к которой не предоставлен, но использовав данный компонент, возможно организовать выборку с учетом данной команды. Возможно список команд будет расширяться, о чем вы можете прочитать на сайте фирмы "И.В.А." www.miracle.ru.
  Правило формирования запроса для WHERE части с использованием функции DISTINCT. Служебное слово должно быть первым в предложении и размещенное в фигурные скобки. Пример:

{DISTINCT} 
T116C3.f3>(select sum(t115.f2) from t115, t116 where t115.F4LHT116=t116.IDH) or 
(select sum(t115.f2) from t115, t116 where t115.F4LHT116=t116.IDH) IS NULL

События

  • Не возможно создать шаблон полностью – сообщение об ошибке подготовки шаблона. Превышение размера.

Реакции

НЕТ

Связь по данным
Источники

  • Шаблон – подготовленная строка.

Приемники

  • «Указанные метоимена источников» - количество и названия имен определяется структурой компонента.

  Телетайп

Программирование компонента

  Компонент, позволяющий производить вывод текстового сообщения на монитор, без образования окна. Служит как элемент организации напоминаний при работе приложения в фоновом режиме.
  Структура компонента позволяет задавать строку вывода, точку вывода, указывать о необходимости звукового сопровождения вывода сообщения, а так же о потребности генерации событий при выводе сообщения.

События

  • Напечатана одна буква – сообщение доступно только при активном режиме «События»
  • Ошибка загрузки координат – сообщение, сигнализирующее об ошибке загрузке координат вывода.
  • Ошибка загрузки сообщения – сообщение, об ошибке загрузке текста сообщения.
  • Печать сообщения прервана – сообщение, сигнализирующее о прерывании процесса вывода сообщения.
  • Сообщение напечатано – сообщение, сигнализирующее об успешном выводе сообщения.

Реакции

  • Загрузить координаты – команда, инициализирующая новые координаты вывода сообщения.
  • Загрузить сообщение – команда инициализирующая новое сообщение для вывода.
  • Напечатать сообщение – команда, активизирующая вывод сообщения. Сообщение выводиться в режиме – по символу.
  • Перерисовать экран – команда, позволяющая перерисовать экран, с целью «убрать» выведенное сообщение.
  • Целиком вывести сообщение – команда позволяющая вывести сообщение в режиме – все сразу.

Связь по данным
Источники

  • Сообщение – текущее сообщение.
  • Координаты X – число с текущей координатой X
  • Координаты Y - число с текущей координатой Y

Приемники

  • Сообщение – значение, для инициализации строки вывода.
  • Координаты X – значение для инициализации координаты вывода - X
  • Координаты Y - значение для инициализации координаты вывода - Y

  Управление отладкой Генератора Приложений

Программирование компонента

  Компонент, служащий для управления окном отладки в Генераторе приложений системы Miracle. Так как «окно отладки» может мешать процессу работы приложения, либо необходимо получать только данные определенного характера, то организация данного механизма возможна через представленный компонент.
  Следует помнить, что наличие данного объекта не оказывает какого либо влияния при работе приложения вне «Генератора приложений».

События

  • Не найдено окно отладчика – сообщение, указывающее на то, что была предпринята команда по управлению окном отладки, без его открытия.
  • Отладчик уже запущен – сообщение,

Реакции

  • Включить фильтрацию – команда управлением режимом работы окна отладки.
  • Включить фильтрацию ошибок - команда управлением режимом работы окна отладки.
  • Выключить фильтрацию - команда управлением режимом работы окна отладки.
  • Выключить фильтрацию ошибок - команда управлением режимом работы окна отладки.
  • Закрыть окно отладки - команда управлением режимом работы окна отладки.
  • Заморозить окно отладки - команда управлением режимом работы окна отладки.
  • Открыть окно отладки - команда управлением режимом работы окна отладки.
  • Очистить окно отладки - команда управлением режимом работы окна отладки.
  • Показать окно отладки - команда управлением режимом работы окна отладки.
  • Разморозить окно отладки - команда управлением режимом работы окна отладки.
  • Скрыть окно отладчика - команда управлением режимом работы окна отладки.

Связь по данным
Источники

НЕТ

Приемники

НЕТ

  Файл формата .CSV

Программирование компонента

  Компонент, позволяющий получать информацию из файла в формате CSV. В процессе формирования структуры компонента, задается описания количества полей, из метоимена, а так же разделитель полей в файле.

События

  • Загружено новое имя файла – сообщение, об успешной загрузке нового имени файла.
  • Отказ от выбора файла – сообщение об отмене выбора файла в диалоге.
  • Ошибка загрузки имени файла – сообщение об ошибке инициализации нового имени файла.
  • Ошибка открытия файла – сообщение об ошибке открытия файла.
  • Ошибка перехода на одну запись вверх – сообщение навигации по структуре файла.
  • Ошибка перехода на одну запись вниз - сообщение навигации по структуре файла.
  • Ошибка перехода на первую запись - сообщение навигации по структуре файла.
  • Ошибка перехода на последнюю запись - сообщение навигации по структуре файла.
  • Успешный переход на одну запись вверх - сообщение навигации по структуре файла.
  • Успешный переход на одну запись вниз - сообщение навигации по структуре файла.
  • Успешный переход на первую запись - сообщение навигации по структуре файла.
  • Успешный переход на последнюю запись - сообщение навигации по структуре файла.
  • Файл закрыт – сообщение об успешном закрытии файла.

Реакции

  • Диалог выбора файла – команда, активизирующая диалог выбора файла.
  • Загрузить имя файла – команда, активизирующая загрузку новго имени файла.
  • Закрыть файл – команда активизирующая закрытие активного файла.
  • Перейти на одну запись вверх – команда навигации.
  • Перейти на одну запись вниз - команда навигации.
  • Перейти на первую запись – команда навигации.
  • Перейти на последнюю запись – команда навигации.

Связь по данным
Источники

  • Имя файла – текущее имя файла.
  • Процент от начала файла – число указывающее, в процентах, положение активной строки в структуре файла от его начала.
  • Колонка <метоимя> - данные из колонки в текущей строке.

Приемники

  • Имя файла – источник для задания имени файла.

  Форматированный вывод в файл

Программирование компонента

  Компонент, позволяющий организовывать формирование файла со сложной структурой. Полученный файл может быть создан как в кодировке DOS (OEM), так и в Windows (ANSI). В качестве оформления могут быть использованы элементы «псевдографики».
  Структура отчета основана на выводе информации по колонкам объединенные понятием «форматной строки». В отчете может быть несколько форматных строк, каждая из которых может содержать разное число колонок и описания разделителей.
Описание каждой колонки, включает в себя описание ширины (в символах), метод выравнивания, относительно начала колонки. Для задания ширины переменной величина, задайте размер – 0.
  Формирование отчета строиться на управлении выводом форматной строки и переменной части, выводимой в любом месте файла и не имеющей выраженной структуры.
  Следует помнить, что компонент не требует постоянного открытия файла. Каждая процедура по сохранению информации, производит открытие указанного файла, сохранение данных по схеме «в конец файла», и его закрытие.

События

  • Выбрано имя файла – сообщение, об успешном выборе (задании) имени файла.
  • Не задан выходной файл – сообщение, возникающее при попытке формирования файла, без указания его имени.
  • Нет данных для вывода форматной строки – сообщение о невозможности формирования форматной строки, так как нет информации.
  • Нет данных для переменной части – сообщение, о не возможности формирования переменной части.
  • Нет связи по данным для одной из колонок – сообщение, возникающее в процессе формирования форматной строки.
  • Нет связи по данным для переменной части – сообщение при формировании переменной части.
  • Отказ выбора – сообщение об отказе выбора (ввода) имени файла в диалоге.
  • Ошибка загрузки имени файла – сообщение об ошибке загрузки имени файла из внешнего источника.
  • Ошибка обнуления выходного файла – сообщение об ошибке обнулении указанного файла.
  • Ошибка сохранения переменной части – сообщение об ошибке сохранения переменной части.
  • Ошибка сохранения строки – сообщение об ошибке сохранения форматной строки.
  • Переменная часть сохранена – сообщение об успешном сохранении переменной части.
  • Строка сохранена – сообщение об успешном сохранении форматной строки.
  • Успешная загрузка имени файла – сообщение об успешной инициализации имени файла.
  • Успешное обнуление выходного файла – сообщение об успешном обнулении указанного файла.

Реакции

  • Выбрать файл для сохранения (диалог) – команда активизирующая диалог выбора (ввода) файла.
  • Вывести переменную часть – команда активизирующая сохранение переменной части в указанный файл.
  • Вывести форматную строку «метоимя» - команда, активизирующая вывод форматной строки «метоимя».
  • Загрузить имя файла – команда активизирующая инициализацию имени файла из внешнего источника.
  • Обнулить файл – команда, обнуления указанного файла.
  • Отчеркнуть форматом «метоимя» - команда формирующая отчеркивающую строку форматом заданной для форматной строки «метоимя».

Связь по данным
Источники

  • Имя файла – текущее имя файла.

Приемники

  • Имя файла – источник для задания имени файла.
  • Переменная часть – источник для задания переменной части.
  • «метоимя» (имя колонки) – источник для задания колонки для каждой части строки «метоимя»

Предыдущий раздел На начал документауции На оглавление Следующий раздел

©1995,1997,2000 НПФ ”И.В.А.”. Все права сохранены.
Название фирм и торговых марок используются только в качестве пояснения.