Язык HTML содержит так называемые теги, которые служат в качестве управляющих символов, используемых для форматирования разметки страницы, отправки запросов и многого другого. «КАСКАД Цифра»содержит ряд тегов, которые поясняются ниже.
«КАСКАД Цифра»интерпретирует и заменяет все строки (теги «КАСКАД Цифра»которые имеют следующую синтаксическую структуру:
<%[Запрос]%>
В выражении запроса могут содержаться только абсолютные имена точек данных, ключевые слова, сценарии и $-параметры.
ПРИМЕР
Самой простой формой запроса является (см. Пример HTML-ссылок):
<html>
<title> This is the simplest test </title>
Value: <%?»ExampleDP_Result.»%>
</html>
ПРИМЕЧАНИЕ
Вы должны быть знакомы с основами работы со ссылками и $-параметрами. В разделе для ссылок представлено больше информации по данной теме.
HTML-ссылки программы «КАСКАД Цифра»позволяют выполнять все запросы в «КАСКАД Цифра».
Простые запросы (текст и значения точек данных)
Сложные запросы (функции CTRL и сценарии
Простые запросы
- Составление и отображение текста (без префикса «?»). Квадратные скобки означают любой текст, который идет ниже
Описание | Результат | |
<%$Text%> | Отображает текст, заданный параметром. | Например, выдает «ExampleDP_Arg2» |
<%$Text + «[fixed text]»%> | Связывает и отображает текст, заданный параметром, а также постоянный текст. | Например, «ExampleDP_Arg2 имеет следующее значение» |
<%$P1 + $P2%> | Связываются и отображаются строки «$P1» и «$P2» | Например, «ExampleDP_Arg2 ExampleDP_Arg1» являются связанными и выводятся на экран |
<%»[T1]» + $Text+ «[T2]»%> | Связывает «T1» , «$Text» и «T2» | Например, «Точка данных ExampleDP_Arg2 имеет данное значение». |
Отобразите на HTML-странице имя $-параметра $dpe. До сих пор было только текущее содержимое и постоянный текст. Чтобы отобразить имя $-параметра, запрос в HTML-ссылке должен выглядеть следующим образом:
<%»data point element: «+$dpe%>
или
data point element: <%$dpe%>
или для фиксированных элементов точек данных
data point element: <%»dp1″%>
- Запрос значений элементов точек данных, времени и всех остальных атрибутов (с префиксом «?»). Опять-таки, квадратные скобки означают любой текст.
<% ? [Запрос] %> | Значение |
<%?$DPE.comment%> | Комментарий (элемента) точки данных | $-параметра |
<%?$DPE.alias%> | Псевдоним (элемента) точки данных | $-параметра |
<%?$DPE%> | Отформатированное значение с единицей элемента точки данных | $-параметра |
<%?$DPE.dateTime%> | Дата и метка времени элемента точки данных | $-параметра |
<%?$DPE.alertColor%> | Цвет аларма элемента точки данных для HTML | $-параметра |
<%?$DP+»[element]:config.[detail].attribute!»%> | Значение выбранного атрибута элемента точки данных | $-параметра |
<%?$DP+»[element]».<X>%> | <X> элемента точки данных | $-параметра (комбинация «X», например, комментарий, псевдоним, dateTime, alertColor; см. выше) |
<%?»DP.[element]:config.[detail].attribute»%> | Значение выбранного атрибута указанной точки данных |
<%?$DP+»[element]».<X>%> | <X> (комментарий, псевдоним и т.д.) точки данных (комбинация «X», см. выше) |
<%?$DP+$Element+»:config..attribute»%> | Значение составного параметра |
<%?»DP»+$Element+»:config..attribute»%> | Значение составного параметра |
<%?$DP+$Element.<X>%> | <X> (комментарий, псевдоним и т.д.) точки данных (комбинация «X», см. выше) |
ПРИМЕР
Выведите на экран текущее значение «.regratio» для точки данных в $-параметре на HTML-странице. Соответствующий запрос в HTML-ссылке выглядит следующим образом:
Значение: <<%?$dp+».regratio»%>>
с форматом и единицей или
Значение: <%?$dp+».regratio:_online.._value»%>
Без формата и единицы, и при этом отображается комментарий для точки данных:
Комментарий: <%?$dp+».regratio».comment%>
ПРИМЕР
Сделайте так, чтобы ячейка таблицы приняла цвет, как при обработке аларма элемента точки данных:
<table><tr>
<td bgcolor=»<%?$dpe.alertColor%>»>Cell contents</td>
</tr></table>
Сложные запросы
Также вы можете воспользоваться $-параметрами, переданными для ссылок в функциях, а также сценариями, которые вызываются на сервере при создании динамических страниц. Следующие дополнительные $-параметры передаются при любых условиях:
$-параметр | Описание |
$User | Имя пользователя (например, «operator» («оператор»)) |
$Ip | TCP-IP номер станции (например, «193.81.17.85») |
$LangId | Указатель языка (например, «1») |
- Выполните функции CTRL (префикс
ПРИМЕР
Сделайте так, чтобы ячейка таблицы, содержащая «Text» («Текст»), приняла цвет «_invalid». Соответствующий запрос в HTML-ссылке выглядит следующим образом:
- <table><tr>
<td bgcolor=»<%=http_color(«_invalid»)%>»>Text</td>
</tr></table>
- Выполните сценарий _(префикс «={«)
Выполняет сложный сценарий «КАСКАД Цифра», в котором известны указанные $-параметры и все функции из библиотеки proj_http.ctl.
<% ={ [Script] }%> | Описание |
={ [Script] } | Выполняет сложный сценарий и вставляет результат в HTML-страницу со ссылкой.Указанный сценарий должен заканчиваться «return(string);»и (полностью) взят в скобки {}. |
ПРИМЕР
Прочтите и вычтите текущие значения двух эллементо точек данных в $-параметрах «$dpe1» и «$dpe2», возвратите результат в виде HTML строки. Соответствующий сценарий в HTML-ссылке выглядит следующим образом:
<%={
string sHtml;
http_sub(sHtml);
return(sHtml);
}%>
Для этого в библиотеке CONTROLтребуется следующая функция:
void http_sub(string &html)
{
float f1, f2;
dpGet($dpe1+»:_online.._value», f1, $dpe2+»:_online.._value», f2);
sprintf(html, «%5.2f — %5.2f = <b>%5.2f</b>», f1, f2,(f1-f2));
}
ПРИМЕР
Отобразите изображение (светодиод) на HTML-странице в зависимости от наличия недействительного бита точки данных в $-параметре $dpe. Соответствующий сценарий в HTML-ссылке выглядит следующим образом:
<%$dpe%>: <img align=»middle» src=»/pictures/http/<%={string s;
http_bool(s, $dpe+»:_online.._bad», «led_invalid», «led_active»);
return(s);}%>.gif»>
<br>
Для этого в библиотеке требуется следующая функция:
void http_bool(string &sHtml, string sDpe,
string sImgOn, string sImgOff)
{
bool b;
dpGet(sDpe, b);
sHtml= ( b ? sImgOn : sImgOff );
}