Alpha.Community

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

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

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

Сгенерированный файл-срез в исходном формате содержит следующие элементы (все значения атрибутов представлены в строковом виде):

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

    • TimeStamp – дата и время генерации файла-среза;
    • Description – описание файла-среза, содержит значение служебного сигнала SnapShotDescription ветки Generator модуля Snapshot (необязательный атрибут);
    • TemplateName – имя шаблона файла-среза без расширения, содержит значение служебного сигнала TemplateName ветки Generator модуля Snapshot;
  • Server (необязательный элемент) со следующими атрибутами:

    • Name – имя экземпляра Alpha.Server, сгенерировавшего файл-срез;
    • ConfigVersion – версия конфигурации Alpha.Server;
    • ServerCompName – имя компьютера с установленным сервером, сгенерировавшего файл-срез;
  • Data со следующими атрибутами:

    • Count – количество сигналов, записанных в файл-срез;
    • Signal со следующими атрибутами:

      • Tag – полный тег сигнала конфигурации Alpha.Server;
      • Value – значение сигнала;
      • Quality – качество сигнала;
      • TimeStamp – метка времени сигнала (необязательный атрибут). Может принимать следующие значения:

        • DD.MM.YYYY HH:MM:SS (значение равно времени последней записи значения сигнала в Alpha.Server);
        • now (при восстановлении данных из файла-среза значение now заменяется на текущее время восстановления данных);
        • "" (при восстановлении данных из файла-среза пустое значение заменяется на значение атрибута TimeStamp элемента SnapShot).
      • PropID – значение свойства сигнала. Попадает в файл-срез, если в шаблоне для сигнала указан атрибут Prop ID="№ свойства".

Файл-срез исходного формата, сгенерированный по шаблону исходного формата.

<?xml version="1.0" encoding="UTF-8"?>
<SnapShot TimeStamp="08.08.2017 02:45:59" Description="" TemplateName="MyTemplate">
<Server Name="Alpha.Server" ConfigVersion="7346" ServerCompName="IVANOV"/>
<Data>

<!--TemplateName: 'LU1.Desc' Count: 1-->
  <Signal Tag="LU1.Desc" Value="Линейный участок №1" Quality="216" TimeStamp="08.08.2017 02:40:55">
    <Prop ID="101" Value="Описание линейного участка"/>
  </Signal>

<!--TemplateName: 'LU1.SW1.*' Count: 7-->
  <Signal Tag="LU1.SW1.Signal1"/>
  <Signal Tag="LU1.SW1.Signal1.vqt_changemask" Value="7" Quality="216" TimeStamp="08.08.2017 02:39:33"/>
  <Signal Tag="LU1.SW1.Signal1.vqt_quality" Value="192" Quality="216" TimeStamp="08.08.2017 02:34:09"/>
  <Signal Tag="LU1.SW1.Signal1.vqt_timestamp"/>
  <Signal Tag="LU1.SW1.Signal1.vqt_timestamp64"/>
  <Signal Tag="LU1.SW1.Signal1.vqt_value" Value="10" Quality="216" TimeStamp="08.08.2017 02:39:16"/>
  <Signal Tag="LU1.SW1.Signal2" Value="12.12" Quality="216" TimeStamp="08.08.2017 02:38:56"/>

<!--TemplateName: 'LU1.SW2.*' Count: 7-->
  <Signal Tag="LU1.SW2.Signal1">
    <Prop ID="100" Value="Бар"/>
  </Signal>
  <Signal Tag="LU1.SW2.Signal1.vqt_changemask"/>
  <Signal Tag="LU1.SW2.Signal1.vqt_quality"/>
  <Signal Tag="LU1.SW2.Signal1.vqt_timestamp"/>
  <Signal Tag="LU1.SW2.Signal1.vqt_timestamp64"/>
  <Signal Tag="LU1.SW2.Signal1.vqt_value""/>
  <Signal Tag="LU1.SW2.Signal2">
    <Prop ID="100" Value="МПа"/>
  </Signal>

<!--TemplateName: 'LU1.SW3.*' Count: 2-->
  <Signal Tag="LU1.SW3.Signal1" Value="8" Quality="216" TimeStamp="08.08.2017 02:40:31"/>
  <Signal Tag="LU1.SW3.Signal2" Value="5.66" Quality="216" TimeStamp="08.08.2017 02:40:37"/>

</Data>
</SnapShot>

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

Сгенерированный файл-срез

Файл-срез стороннего формата, сгенерированный по шаблону стороннего формата.

<ResultSnapShot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="Scheme.xsd">
  <ServerInfo>
    <Server name="Alpha.Server"/>
    <Generated at="08.08.2017 02:45:59"/>
  </ServerInfo>
  <Signal name="LU1.Desc">
    <Value>Линейный участок №1</Value>
    <Description>Описание линейного участка</Description>
  </Signal>
  <Signal name="LU1.SW1.Signal1"/>
  <Signal name="LU1.SW1.Signal1.vqt_changemask">
    <Value>7</Value>
  </Signal>
  <Signal name="LU1.SW1.Signal1.vqt_quality">
    <Value>192</Value>
  </Signal>
  <Signal name="LU1.SW1.Signal1.vqt_timestamp"/>
  <Signal name="LU1.SW1.Signal1.vqt_timestamp64"/>
  <Signal name="LU1.SW1.Signal1.vqt_value">
    <Value>10</Value>
  </Signal>
  <Signal name="LU1.SW1.Signal2">
    <Value>12.12</Value>
  </Signal>
  <Signal name="LU1.SW2.Signal1">
    <Value>2</Value>
  </Signal>
  <Signal name="LU1.SW2.Signal2">
    <Value>10.05</Value>
  </Signal>
  <Signal name="LU1.SW3.Signal1">
    <Value>8</Value>
  </Signal>
  <Signal name="LU1.SW3.Signal2">
    <Value>5.66</Value>
  </Signal>
</ResultSnapShot>

Правила преобразования

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

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:template match="/">
    <ResultSnapShot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="Scheme.xsd">
      <ServerInfo>
        <Server>
          <xsl:attribute name="name">
            <xsl:value-of select="SnapShot/Server/@Name"/>
          </xsl:attribute>
        </Server>
        <Generated>
          <xsl:attribute name="at">
            <xsl:value-of select="SnapShot/@TimeStamp"/>
          </xsl:attribute>
        </Generated>
      </ServerInfo>
      <xsl:for-each select="SnapShot/Data/Signal">
        <Signal>
          <xsl:attribute name="name">
            <xsl:value-of select="@Tag"/>
          </xsl:attribute>
          <xsl:if test="@Value != ''">
            <xsl:element name="Value">
              <xsl:value-of select="@Value"/>
            </xsl:element>
          </xsl:if>
          <xsl:for-each select="./Prop">
            <xsl:if test="@ID='101'">
              <xsl:element name="Description">
                <xsl:value-of select="@Value"/>
              </xsl:element>
            </xsl:if>
          </xsl:for-each>
        </Signal>
      </xsl:for-each>
    </ResultSnapShot>
  </xsl:template>
</xsl:stylesheet>

Проверка на соответствие

В ходе генерации файла-среза стороннего формата формат проходит проверку на соответствие заданной схеме. Файл с расширением *.xsd, содержащий схему, указывается в файле с xsl-правилами преобразования в параметре noNamespaceSchemaLocation. Файл может быть задан:

  • с указанием полного пути, например, xsi:noNamespaceSchemaLocation="C:\FSModule\Schemes\Scheme.xsd">. В этом случае файл со схемой может быть размещен в любой папке на диске;
  • без указания полного пути, например, xsi:noNamespaceSchemaLocation="Scheme.xsd". В этом случае файл со схемой должен быть размещен в папке, указанной в настройках модуля Snapshot в параметре Каталог файлов срезов.

Результат проверки не влияет на возможность последующего восстановления данных из файла-среза.

XSD-схема для проверки соответствия полученного стороннего файла-среза заданному формату:

<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="ResultSnapShot">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="ServerInfo">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="Server">
                <xs:complexType>
                  <xs:attribute name="name" type="xs:string" use="required"/>
                </xs:complexType>
              </xs:element>
              <xs:element name="Generated">
                <xs:complexType>
                  <xs:attribute name="at" type="xs:string" use="required"/>
                </xs:complexType>
              </xs:element>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element maxOccurs="unbounded" name="Signal">
          <xs:complexType>
            <xs:sequence minOccurs="0">
              <xs:element minOccurs="0" name="Value" type="xs:string"/>
              <xs:element minOccurs="0" name="Description" type="xs:string"/>
            </xs:sequence>
            <xs:attribute name="name" type="xs:string" use="required"/>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>