# LogWriteCommand

## Шаблон LogWriteCommand <a href="#template_log_write_command" id="template_log_write_command"></a>

```xml
<Command Name="" Type="LogWriteCommand">
  <Severity Type="" />
  <EventQuery>
    <Text></Text>
  </EventQuery>
</Command>
```

## Описание LogWriteCommand <a href="#description_log_write_command" id="description_log_write_command"></a>

```xml
<Command Name="LogWriteCommandName" Type="LogWriteCommand">
  <!--Тэги, общие для всех команд-->
  <!--Тэги, специфичные для LogWriteCommand-->
</Command>
```

### Результат выполнения LogWriteCommand <a href="#result_log_write_command" id="result_log_write_command"></a>

Команда не имеет результата.

## Тэги, специфичные для LogWriteCommand <a href="#tags_log_write_command" id="tags_log_write_command"></a>

### Severity <a href="#severity" id="severity"></a>

Тип добавляемого в журнал события.

Необязательный тэг. Значение тэга `<Severity>`: не ожидается.

Если тэг `<Severity>` отсутствует, то для атрибута `Type` используется значение Information.

```xml
<Severity Type="Information" />
```

#### Атрибуты тэга `<Severity>` <a href="#attributes_tag_severity" id="attributes_tag_severity"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="505.3333333333333"></th></tr></thead><tbody><tr><td align="center">Type</td><td><p>Тип добавляемого в журнал события.</p><p></p><p>Обязательный атрибут. Ожидается название одного из <a href="#severity_type">типов добавляемого в журнал события</a>.</p></td></tr></tbody></table>

#### Типы добавляемого в журнал события <a href="#severity_type" id="severity_type"></a>

<table data-header-hidden><thead><tr><th align="center"></th><th width="505.3333333333333"></th></tr></thead><tbody><tr><td align="center">Error</td><td>Сообщение об ошибке</td></tr><tr><td align="center">FailureAudit</td><td>Событие аудита отказов</td></tr><tr><td align="center">Information</td><td>Информационное событие</td></tr><tr><td align="center">SuccessAudit</td><td>Событие аудита успехов</td></tr><tr><td align="center">Warning</td><td>Предупреждение</td></tr></tbody></table>

### EventQuery <a href="#event_query" id="event_query"></a>

Sql-запрос, возвращающий параметры события, добавляемого в журнал.

Обязательный тэг. Значение тэга `<EventQuery>`: тэг [`<Text>`](#event_query_text).

```xml
<EventQuery>
  <Text>
    SELECT
    event_id AS "EventId",
    message AS "Message"
  </Text>
</EventQuery>
```

#### Тэг `<Text>` <a href="#event_query_text" id="event_query_text"></a>

Содержит sql-запрос.

Обязательный тэг. Значение тэга `<Text>`: текст sql-запроса.

Sql-запрос должен возвращать список полей со следующими заголовками (алиасами):

1. EventId (необязательное поле) - целочисленный код события, добавляемого в журнал. Если поле EventId отсутствует, то используется значение 0.
2. Message - текст события.

Текст sql-запроса поддерживает переменные типа {Parameter}, заменяемые при его выполнении значениями передаваемых клиентом параметров с соответствующими названиями.