Alpha.Community

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

Восстановление данных из файла-среза

При восстановлении данных из файла-среза текущие значения сигналов Alpha.Server заменяются на значения сигналов из файла-среза.

Для восстановления данных из файла-среза в Alpha.Server:

  1. Выберите файл-срез для восстановления данных и запишите его имя без расширения в сигнал SnapShotName ветки Extractor:

  2. Восстановите данные из файла-среза в Alpha.Server: подайте команду, записав значение True в сигнал Extract ветки Extractor.

    Сразу после подачи команды значение сигнала автоматически возвращается в False.

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

При восстановлении данных из файла-среза в сигналы Alpha.Server текущее значение свойства TimeStamp каждого восстанавливаемого сигнала зависит от значения атрибута TimeStamp элемента Signal файла-среза:

  • если значение задано в формате DD.MM.YYYY HH:MM:SS, то в значение свойства TimeStamp сигнала записывается данное значение атрибута;
  • если значение не задано или равно пустому значению "", то в значение свойства TimeStamp сигнала записывается значение атрибута TimeStamp элемента SnapShot файла-среза;
  • если значение равно now, то в значение свойства TimeStamp сигнала записывается текущее время восстановления данных.

Атрибуту TimeStamp элемента SnapShot файла-среза можно задавать значение now, тогда значение данного атрибута принимает значение текущего времени восстановления. Количество восстановленных значений сигналов из файла-среза в текущие значения сигналов Alpha.Server отображается в сигнале ExtrSignalCount ветки Extractor.

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

Если файл-срез имеет сторонний формат, то предварительно создайте файл с xsl-правилами преобразования среза стороннего формата в срез исходного формата и разместите его в папке, путь до которой указан в настройках модуля Snapshot в параметре Каталог с шаблонами файлов-срезов. В файле укажите:

  • значение элемента name равным SnapShot (<xsl:element name="SnapShot">);
  • значение атрибута name равным TimeStamp (<xsl:attribute name="TimeStamp">).

Запишите имя файла без расширения в сигнал TransformRulesFileName ветки Extractor модуля Snapshot. При восстановлении данных из файла-среза стороннего формата преобразование выполняется автоматически по указанным xsl-правилам.

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

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:template match="/">
    <xsl:element name="SnapShot">
      <xsl:attribute name="TimeStamp">
        <xsl:value-of select="ResultSnapShot/ServerInfo/Generated/@at"/>
      </xsl:attribute>
      <Server>
        <xsl:attribute name="Name">
          <xsl:value-of select="ResultSnapShot/ServerInfo/Server/@name"/>
        </xsl:attribute>
      </Server>
      <xsl:if test="count(ResultSnapShot/Signal)!=0">
        <Data>
          <xsl:for-each select="ResultSnapShot/Signal">
            <xsl:if test="./Value != ''">
              <Signal>
                <xsl:attribute name="Tag">
                  <xsl:value-of select="@name"/>
                </xsl:attribute>
                <xsl:attribute name="Value">
                  <xsl:value-of select="./Value"/>
                </xsl:attribute>
                <xsl:attribute name="Quality">192</xsl:attribute>
              </Signal>
            </xsl:if>
          </xsl:for-each>
        </Data>
      </xsl:if>
    </xsl:element>
  </xsl:template>
</xsl:stylesheet>

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

<SnapShot TimeStamp="08.08.2017 02:45:59">
  <Server Name="Alpha.Server"/>
  <Data>
    <Signal Tag="LU1.Desc" Value="Линейный участок №1" Quality="192"/>
    <Signal Tag="LU1.SW1.Signal1.vqt_changemask" Value="7" Quality="192"/>
    <Signal Tag="LU1.SW1.Signal1.vqt_quality" Value="192" Quality="192"/>
    <Signal Tag="LU1.SW1.Signal1.vqt_value" Value="10" Quality="192"/>
    <Signal Tag="LU1.SW1.Signal2" Value="12.12" Quality="192"/>
    <Signal Tag="LU1.SW2.Signal1" Value="2" Quality="192"/>
    <Signal Tag="LU1.SW2.Signal2" Value="10.05" Quality="192"/>
    <Signal Tag="LU1.SW3.Signal1" Value="8" Quality="192"/>
    <Signal Tag="LU1.SW3.Signal2" Value="5.66" Quality="192"/>
  </Data>
</SnapShot>

Сообщения об ошибках

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

  • некорректно задано имя файла-среза, используемого для восстановления данных;
  • отсутствуют восстановленные сигналы из файла-среза – значение сигнала ExtrLastError ветки Extractor равно 0;
  • не указан файл с xsl-правилами преобразования при попытке восстановления данных из файла-среза стороннего формата.

При обнаружении ошибки выполнение операции восстановления прекращается. Модуль формирует сообщение об ошибке, которое записывается в журнал работы модуля и в сигнал ExtrLastError ветки Extractor.