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

URL: components/Services/APINegotiations.asmx

Метод: CreateNegotiation

Запуск согласования форм данным методом не поддерживается.
При указании ссылки на маршрут согласования формы - запускается обычное согласование по шаблону маршрута без привязки формы.

Передаваемые параметры

Параметр	Описание
`ASPNETSessionId`*	Идентификатор сессии пользователя Системы
`parentId`	Идентификатор объекта, в котором необходимо создать согласование
`title`*	Название согласования
`description`	Содержание согласования
`templateId`()	Идентификатор шаблона согласования или согласования формы. При передаче в `templateId` идентификатора шаблона согласования формы будет создано обычное согласование с маршрутом из указанного шаблона
`routeType`	Тип маршрута согласования. Возможные значения: • Sequential – последовательное согласование. Значение по умолчанию; • Parallel – параллельное согласование; • SequentialParallel – последовательно-параллельное.
route()	Объект для передачи массива `Negotiators` c элементами `RouteNegotiatorWrapper`, каждый из которых содержит: • memberId - идентификатор согласующего; • period – срок ответа (число); • periodUnits – тип измерения срока ответа: часов (Hours) или дней (Days); • order – порядковый номер пользователя в списке согласующих. Определяет принадлежность пользователя к группе согласующих. Если порядковый номер у нескольких согласующих один и тот же, то это означает, что пользователи находятся в одной и той же группе (актуально для последовательно-параллельного маршрута согласования)
`fields`	Перечень значений пользовательских реквизитов объекта «Согласование»

* - параметры, обязательные для заполнения.

*(*) – одно из обязательно для заполнения. Либо указывается templateId, либо route.

<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:str="http://streamline/">
   <soapenv:Header/>
   <soapenv:Body>
      <str:CreateNegotiation>
         <str:dataContract>
            <str:ASPNETSessionId>string</str:ASPNETSessionId>
            <str:Title>string</str:Title>
            <str:Description>string</str:Description>
            <str:TemplateId>guid</str:TemplateId>
            <str:ParentId>guid</str:ParentId>
            <str:RouteType>string</str:RouteType>
            <str:Route>
               <str:Negotiators>
                  <str:RouteNegotiatorWrapper>
                     <str:MemberId>string</str:MemberId>
                     <str:Period>string</str:Period>
                     <str:PeriodUnits>string</str:PeriodUnits>
                     <str:Order>string</str:Order>
                  </str:RouteNegotiatorWrapper>
               </str:Negotiators>
            </str:Route>
            <str:Fields>
               <str:FieldWrapper>
                  <str:FieldName>string</str:FieldName>
                  <str:FieldId>string</str:FieldId>
                  <str:FieldVal>string</str:FieldVal>
                  <str:FieldType>string</str:FieldType>
               </str:FieldWrapper>
            </str:Fields>
         </str:dataContract>
      </str:CreateNegotiation>
   </soapenv:Body>
</soapenv:Envelope>

Возвращаемый параметр

Параметр	Описание
`NegotiationId`	Идентификатор созданного согласования

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