Следующие параметры командной строки могут использоваться для чтения и записи значений элементов точек данных: 

Данный параметр командной строки используется для вывода значения элемента точки данных:

WCCOAascii -getdpname. -log +stderr

Данный параметр командной строки устанавливает значение элемента точки данных:

WCCOAascii -set dpname. value

ПРИМЕР

WCCOAascii -get ExampleDP_Arg1. -log +stderr

Исходное значение выводится на экран. 

ВНИМАНИЕ!

Если в режиме чтения (get) не указать параметры «-log +stderr», считываемое значение записывается в файл журнала «WCCOAascii1.log» в каталоге «<путь_проекта>/log».

WCCOAascii -set ExampleDP_Arg1.10

Исходное значение устанавливается равным 10.

ПРИМЕЧАНИЕ

Ошибки, возникающие при чтении и записи значений, записываются в файл «PVSS_II.log» в каталоге «<путь_проекта>/log».

-wait

Если менеджер ASCII запущен с параметром «-wait», он не закрывается после завершения обработки файла, указанного при запуске, и продолжает работать.

С помощью элемента внутренней точки данных «_AsciiManager.FileName» можно передать в работающий менеджер дополнительные файлы для выполнения их обработки. Для этого используется атрибут конфигурационного элемента «_original.._value».

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

ВНИМАНИЕ

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

ПРИМЕР

Передача данных о файле /users/parameterdata в запущенный менеджер ASCII:

-yes

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

-in <шаблон фильтра>

Параметр командной строки «-in» используется для импорта множества файлов, имена которых соответствуют указанному набору знаков подстановки.

ПРИМЕР

При использовании параметра «-in *.txt» импортируются все файлы с расширением «*txt».

-inactivateAlert

Если входной файл содержит данные, которые изменяют обработку алармов, данный файл необходимо импортировать с параметром командной строки «-inactivateAlert». Таким образом деактивируется обработка алармов, что необходимо для внесения изменений. По завершении импорта, значение атрибута «_active» во входном файле указывает, была ли обработка алармов снова активирована (значение «1») или осталась неактивной (значение «0»).

ПРИМЕЧАНИЕ

Данный параметр командной строки не оказывает влияния на обработку файлов ASCII в Форматах 3 и 4.

ВНИМАНИЕ

Если после изменения обработки алармов определенного элемента точки данных с помощью параметра «-inactivateAlert» необходимо снова активировать обработку алармов, убедитесь, что значение атрибута «_active» равно «1».

-noAlertConfigHist

При использовании этого параметра конфигурационные элементы аларма импортируются без увеличения истории в RAIMA.  Конфигурационные элементы аларма отправляются с меткой времени «0» и перезаписывают предыдущие значения данного конфигурационного элемента в истории.

Для этой же цели может использоваться запись в конфигурационном файле «noAlertConfigHist» (bool; по умолчанию = 0; раздел [ascii]). Параметр командной строки имеет приоритет перед значением записи в конфигурационном файле.

Если «noAlertConfgiHist» равен «0» или если не используется параметр «-noAlertConfigHist», менеджер ASCII выполняет обработку в стандартном режиме, то есть в истории конфигурации создаются новые конфигурационные элементы алармов.

Для считывания конфигурационных элементов и исходных значений из базы данных используются опции «P» и «O».   Обратный процесс выполняется с использованием файлов ASCII со следующей структурой:

Таблица начинается с ключевого слова «ElementName», после которого следует столбец с заголовком «TypeName». Столбец «DetailNo» может отсутствовать.  Отсутствие значений в этом столбце означает «Detail 0» (подробная информация отсутствует). Заголовком каждого из оставшихся столбцов является метка атрибута. Имя элемента и метка атрибута, как правило, объединяются для указания фактического имени атрибута. Возможно любое количество элементов в столбце «ElementName», а также любое количество столбцов с атрибутами. Таким образом, импорт приведенного ниже файла ASCII происходит корректно.

ПРИМЕР

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

Другие правила:

• Содержимое столбцов без заголовков не импортируется. 
• Колонки, заголовками которых являются комментарии (начинаются с символа «#»), не импортируются.
• Пустые конфигурационные элементы (без значения атрибута) типа «dyn_*» не импортируются за исключением исходного значения (_original.._value).
• Первые два столбца с информацией о пользователе и менеджере (имя и номер), ответственных за изменение конфигурационного элемента, не импортируются. Файлы ASCII, созданные при экспорте в КАСКАД версии ниже 3.11, не содержат такой информации, однако поддерживается их корректный импорт в «КАСКАД Цифра» версии 3.11 и выше.

Таким образом, следующий файл не приводит к каким-либо изменениям:

ПРИМЕЧАНИЕ

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

Создание точек данных с помощью менеджера ASCII может осуществляться двумя способами. 1) При записи атрибута элемента точки данных, которая еще не существует. При этом точка данных создается автоматически. 2) Точки данных также могут создаваться при помощи ключевого слова «DpName». При использовании данного метода менеджер ASCII пытается создать точку данных с указанным идентификатором, если таковой доступен. Если указанный идентификатор уже был присвоен, используется следующий доступный идентификатор и выводится соответствующее сообщение. Этот способ используется, как правило, для обновления проектов.

ПРИМЕЧАНИЕ

Процесс удаления точек данных с помощью менеджера ASCII описан в разделе «Шаблоны и списки точек данных, основы».

ПРИМЕР

При импорте такого файла ASCII происходит создание точек данных «Station_1» и «Station_2» с идентификаторами 4 и 5.

Рисунок 2: Точка данных «Station_1»

Ключевым словом для обозначения начала таблицы типов является «TypeName», которое должно присутствовать в первом столбце. Следующие строки должны содержать пары значений «Имя <знак табуляции> Тип». Имена могут быть любыми, а константы типа определяются системой (см. приложение «Номера типов данных»).

Следующая группа отделяется знаком табуляции.

ПРИМЕР

При импорте данной таблицы как ASCII- файла создается следующий тип точки данных.

Рисунок. Тип точки данных «Station»

Импорт файлов ASCII осуществляется с помощью команды «WCCOAascii -in имя_файла». Файлы должны находиться в соответствующем каталоге проекта. В противном случае в качестве параметра необходимо указывать полный путь к файлу.

С помощью импорта файлов ASCII возможно:

• создавать типы точек данных и точки данных,
• редактировать типы точек данных и конфигурации.

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

ПРИМЕЧАНИЕ

• Максимальное количество символов в строковом значении при импорте в формате ASCII составляет 1 Мбайт.
• Используемые в примерах файлы Excel должны иметь текстовый формат со знаком табуляции в качестве разделителя. Если для создания файлов ASCII используется другой редактор, например Wordpad, между столбцами также должен стоять разделитель (знак табуляции).
• Языковая структура в проекте, в который производится загрузка из файла ASCII, не обязана совпадать с языковой структурой в проекте, из которого был создан выходной файл ASCII . Применяется следующий алгоритм:
• • возможность использования текстa ASCII- файла с полным совпадением языка и страны (например, de_de может соответствовать только de_de, а не de_at);
  • если такой текст не найден, используется текст на совпадающем языке (de_de может соответствовать de_at или de_ch);
  • если такой текст не найден, используется en_us;
  • если такой текст не найден, используется de_at.

Поддерживается сочетание любых доступных фильтров. При одновременном использовании нескольких фильтров выполняется конъюнкция результатов работы отдельных фильтров (логическое «И»). В рамках одного типа фильтра выполняется дизъюнкция результатов (логическое «ИЛИ»).

ПРИМЕР

Для получения адресов всех периферийных устройств типов «Controller» (регулятор) и «Valve» (задвижка) по точкам данных, имена которых начинаются с «X», можно использовать следующую команду (в одну строку):

WCCOAascii -out regvent.adr -filterDpType Controller -filterDpType Valve -filterDp X*.; -filter P:_address

Результат будет экспортирован в файл «regvent.adr».

ВАЖНО!

При редактировании одноязычных выходных файлов в программе Excel, перед их сохранением в текстовом формате необходимо вручную удалять текстовые префиксы «lt:0» и «Lang:0». Например, «It:0Lang:0 «Malfunction»» необходимо заменить на «»Malfunction»».

-set

Параметр командной строки «-set» позволяет устанавливать атрибуты точек данных с помощью менеджера ASCII. Синтаксис командной строки:

ПРИМЕР

WCCOAascii -set DPNAME:_alert_hdl.._text»lt:1 LANG:0/»Текст аларма»/»

-get

Параметр командной строки «-get» позволяет считывать атрибуты точек данных с помощью менеджера ASCII. Синтаксис командной строки:

ПРИМЕР

WCCOAascii -get DPNAME:_alert_hdl.<i>._text»lt:1 LANG:0/»Текст аларма»/»

При чтении текста, в качестве <i> необходимо указывать номер диапазона аларма. При необходимости считать текущий текст аларма, в качестве атрибута необходимо использовать alert_hdl.._act_text. .