Создание согласования

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Создание согласования ======
Метод: **CreateNegotiation**

<callout type="warning" icon="true">Запуск [[product/objects/users/object_agreement|согласования форм]] данным методом не поддерживается. \\
При указании ссылки на маршрут согласования формы - запускается обычное согласование по шаблону маршрута без привязки формы.</callout>
===== Передаваемые параметры =====
^Параметр^Описание^
|ASPNETSessionId*|Идентификатор сессии пользователя Системы|
|parentId|Идентификатор объекта, в котором необходимо создать согласование|
|title*|Название согласования|
|description|Содержание согласования|
|templateId*(*)|Идентификатор шаблона согласования или согласования формы. \\ При передаче в ''templateId'' идентификатора шаблона согласования формы будет создано обычное согласование с маршрутом из указанного шаблона.|
|routeType|Тип маршрута согласования. Возможные значения: \\ **Sequential** – последовательное согласование. Значение по умолчанию \\ **Parallel** – параллельное согласование \\ **SequentialParallel** – последовательно параллельное|
|route*(*)|Объект для передачи массива Negotiators c элементами RouteNegotiatorWrapper, каждый из которых содержит: \\ **memberId** - идентификатор согласующего \\ **period** – срок ответа (число) \\ **periodUnits** – тип измерения срока ответа: часов (Hours) или дней (Days) \\ **order** – порядковый номер пользователя в списке согласующих. \\ Определяет принадлежность пользователя к группе согласующих. \\ Если порядковый номер у нескольких согласующих один и тот же, то это означает, что пользователи находятся в одной и той же группе (актуально для последовательно-параллельного маршрута согласования)|
|fields|Перечень значений пользовательских реквизитов объекта «Согласование»|
* - параметры, обязательные для заполнения. \\
*(*) – одно из обязательно для заполнения. Либо указывается **templateId**, либо **route**.

<code xml>
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CreateNegotiation xmlns="http://streamline/">
      <dataContract>
        <ASPNETSessionId>string</ASPNETSessionId>
        <Title>string</Title>
        <Description>string</Description>
        <TemplateId>guid</TemplateId>
        <ParentId>guid</ParentId>
        <RouteType>string</RouteType>
        <Route>
          <Negotiators>
            <RouteNegotiatorWrapper xsi:nil="true" />
            <RouteNegotiatorWrapper xsi:nil="true" />
          </Negotiators>
        </Route>
        <Fields>
          <FieldWrapper>
            <FieldName>string</FieldName>
            <FieldId>string</FieldId>
            <FieldVal>string</FieldVal>
            <FieldType>string</FieldType>
          </FieldWrapper>
          <FieldWrapper>
            <FieldName>string</FieldName>
            <FieldId>string</FieldId>
            <FieldVal>string</FieldVal>
            <FieldType>string</FieldType>
          </FieldWrapper>
        </Fields>
      </dataContract>
    </CreateNegotiation>
  </soap:Body>
</soap:Envelope>
</code>

=====Возвращаемые параметры =====
^Параметр^Описание^
|NegotiationId|Идентификатор созданного согласования|

<code xml>
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <CreateNegotiationResponse xmlns="http://streamline/">
      <CreateNegotiationResult>string</CreateNegotiationResult>
    </CreateNegotiationResponse>
  </soap:Body>
</soap:Envelope>
</code>