Alpha.Community

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

Формат шаблона файла-среза

В шаблоне файла-среза исходного формата должны присутствовать элементы:

  • SnapShotTemplate со следующими атрибутами:

    • Name – имя шаблона;
    • Description – описание шаблона файла-среза (необязательный атрибут);
  • блок Data со следующими атрибутами:

    • Signal со следующими атрибутами:

      • Tag – полное имя сигнала, используемое в Alpha.Server;
      • Description – описание сигнала (необязательный атрибут);
      • SaveVQT - опциональный атрибут, отключающий сохранение в файл-срез значения, качества и метки времени (VQT). Если сохранение отключено, то в файл-срез записывается только список свойств, перечисленных в дочерних для элемента Signal атрибутах Prop ID;
      • атрибуты Prop ID указывают свойства сигнала, значения которых должны попасть в файл-срез.
  • блок Exceptions - исключает из файла-среза указанные сигналы.

Атрибут Tag может содержать как полное имя сигнала, используемое в Alpha.Server, так и символы, частично заменяющие имя сигнала:

Символ Описание
? единичный символ
$ опциональный единичный символ
* строка любой длины

Если вышеуказанная структура не соблюдена, то шаблон рассматривается, как сторонний.

Примеры шаблонов файла-среза

Ниже приведены примеры исходного и стороннего шаблонов, по которым будет генерироваться файл-срез со следующими сигналами:

  • значение сигнала с тегом LU1.Desc и значение его свойства 101 (Description);
  • значения всех сигналов ветки LU1.SW1;
  • только свойство 100 (EUnit) всех сигналов ветки LU1.SW2;
  • значения всех сигналов ветки LU1.SW3;
  • исключены все сигналы, в тегах которых присутствует Signal3.

Шаблон файла-среза исходного формата

<?xml version="1.0" encoding="UTF-8" ?>
<SnapShotTemplate Name="MyTemplate">
  <Data Count="5">
    <Signal Tag="LU1.Desc">
      <Prop ID="101"/>
    </Signal>
    <Signal Tag="LU1.SW1.*" />
    <Signal Tag="LU1.SW2.*" SaveVQT="false">
      <Prop ID="100"/>
    </Signal>
    <Signal Tag="LU1.SW3.*" />
  </Data>
<Exceptions Count="1">
    <Signal Tag="*Signal3*"/>
</Exceptions>
</SnapShotTemplate>

Результат генерации файла-среза по этому шаблону.

Шаблон файла-среза стороннего формата

<Template Name="MyTemplate">
  <Tag Name="LU1.Desc"><Prop>101</Prop>
  </Tag>
  <Tag Name="LU1.SW1.*"/><Tag Name="LU1.SW2.*" SaveVQT="false"/><Tag Name="LU1.SW3.*"/><Tag Name="*Signal3*" Exception="true"/>
</Template>

Результат генерации файла-среза по этому шаблону.

В приведенном примере в шаблоне стороннего формата отсутствуют элементы структуры, необходимые для генерации файла-среза. Поэтому к нему применяется преобразование в исходный формат.

Преобразование

XSL-правила преобразования, использованные для получения шаблона исходного формата из шаблона стороннего формата для последующей генерации файла-среза:

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:template match="/">
    <xsl:element name="SnapShotTemplate">
      <xsl:attribute name="Name">
        <xsl:value-of select="Template/@Name"/>
      </xsl:attribute>
      <Data>
        <xsl:for-each select="Template/Tag">
          <xsl:if test="not(./@Exception='true')">
            <Signal>
              <xsl:attribute name="Tag">
                <xsl:value-of select="./@Name"/>
              </xsl:attribute>
              <xsl:if test="./@SaveVQT != ''">
                <xsl:attribute name="SaveVQT">
                  <xsl:value-of select="./@SaveVQT"/>
                </xsl:attribute>
              </xsl:if>
              <xsl:for-each select="./Prop">
                <xsl:element name="Prop">
                  <xsl:attribute name="ID">
                    <xsl:value-of select="."/>
                  </xsl:attribute>
                </xsl:element>
              </xsl:for-each>
            </Signal>
          </xsl:if>
        </xsl:for-each>
      </Data>
      <Exceptions>
        <xsl:for-each select="Template/Tag">
          <xsl:if test="./@Exception='true'">
            <Signal>
              <xsl:attribute name="Name">
                <xsl:value-of select="./@Name"/>
              </xsl:attribute>
            </Signal>
          </xsl:if>
        </xsl:for-each>
      </Exceptions>
    </xsl:element>
  </xsl:template>
</xsl:stylesheet>

Шаблон стороннего формата, преобразованный в исходный формат по xsl-правилам:

<SnapShotTemplate Name="MyTemplate">
  <Data>
    <Signal Tag="LU1.Desc"><Prop ID="101"/>
    </Signal>
    <Signal Tag="LU1.SW1.*"/><Signal Tag="LU1.SW2.*" SaveVQT="false">
      <Prop ID="100"/>
    </Signal>
    <Signal Tag="LU1.SW3.*"/>
  </Data>
  <Exceptions>
    <Signal Name="*Signal3*"/>
  </Exceptions>
</SnapShotTemplate>