Добавить и изменить запись раздела

1. Создать и настроить проект консольного приложения C# 

1. Используя среду разработки Microsoft Visual Studio (версии не ниже 2017), создайте проект консольного приложения Visual C#.

   Работа в Microsoft Visual Studio подробно описана в статье Разработать C# код в пользовательском проекте.

2. Укажите в качестве названия проекта, например, DataServiceDeleteExample.
3. Свойству проекта Target framework установите значение ".NET Framework 4.7".
4. В секцию References проекта добавьте зависимости от библиотек:
   • System.Web.Extensions.dll — библиотека классов, входящая в .NET Framework.
   • Terrasoft.Core.dll — библиотека основных классов серверного ядра приложения. Находится по пути ...\Terrasoft.WebApp\bin\Terrasoft.Core.dll.
   • Terrasoft.Nui.ServiceModel.dll — библиотека классов служб приложения. Находится по пути ...\Terrasoft.WebApp\bin\Terrasoft.Nui.ServiceModel.dll.
   • Terrasoft.Common.dll — библиотека основных классов серверного ядра приложения. Находится по пути ...\Terrasoft.WebApp\bin\Terrasoft.Common.dll.
5. В файл исходного кода приложения добавьте директивы using.
   Добавление директив using

   using System;
   using System.Text;
   using System.IO;
   using System.Net;
   using System.Collections.Generic;
   using Terrasoft.Nui.ServiceModel.DataContract;
   using Terrasoft.Core.Entities;
   using System.Web.Script.Serialization;
   using Terrasoft.Common;
   

2. Добавить объявление полей и констант 

Добавление полей и констант в исходный код приложения необходимо выполнить для доступа к возможностям сервиса работы с данными DataService.

/* Основной URL приложения Creatio. Необходимо заменить на пользовательский. */
private const string baseUri = @"http://example.creatio.com";
/* Строка запроса к методу Login сервиса AuthService.svc. */
private const string authServiceUri = baseUri + @"/ServiceModel/AuthService.svc/Login";
/* Строка пути запроса BatchQuery. */
private const string batchQueryUri = baseUri + @"/0/DataService/json/reply/BatchQuery";
/* Cookie аутентификации Creatio. */
private static CookieContainer AuthCookie = new CookieContainer();

Здесь объявлены три строковых константных поля, с помощью которых формируются пути выполнения запросов на аутентификацию и запросов на чтение данных. Данные об аутентификации будут сохранены в поле AuthCookie.

3. Добавить метод, выполняющий аутентификацию 

Для доступа создаваемого приложения к сервису работы с данными DataService необходимо выполнить аутентификацию.

4. Реализовать запрос на добавление записи 

Поскольку объявленная ранее константа batchQueryUri содержит путь для отправки данных в формате JSON, то отправляемые данные необходимо предварительно сконфигурировать в виде строки, содержащей описание JSON-объекта. Для формирования содержимого единичных запросов удобно воспользоваться классами-контрактами данных, а затем сериализовать их в строку.

/* Запрос на добавление данных. */
var insertQuery = new InsertQuery()
{
    RootSchemaName = "Contact",
    ColumnValues = new ColumnValues()
    {
        Items = new Dictionary<string, ColumnExpression>()
        {
            {
                "Name",
                new ColumnExpression()
                {
                    ExpressionType = EntitySchemaQueryExpressionType.Parameter,
                    Parameter = new Parameter
                    {
                        Value = "Петров Петр Петрович",
                        DataValueType = DataValueType.Text
                    }
                }
            }
        }
    }
};

5. Реализовать запрос на изменение записи 

Измените значение колонки Рабочий телефон на "012 345 67 89" для всех записей раздела Контакты (Contacts), которые в колонке ФИО (Name) содержат значение "Петров Петр Петрович".

/* Запрос на обновление данных. */
var updateQuery = new UpdateQuery()
{
    RootSchemaName = "Contact",
    ColumnValues = new ColumnValues()
    {
        Items = new Dictionary<string, ColumnExpression>()
        {
            {
                "Phone",
                new ColumnExpression()
                {
                    ExpressionType = EntitySchemaQueryExpressionType.Parameter,
                    Parameter = new Parameter()
                    {
                        Value = "0123456789",
                        DataValueType = DataValueType.Text
                    }
                }
            }
        }
    },
    Filters = new Filters()
    {
        FilterType = Terrasoft.Nui.ServiceModel.DataContract.FilterType.FilterGroup,
        Items = new Dictionary<string, Filter>()
        {
            {
                "FilterByName",
                new Filter
                {
                    FilterType = Terrasoft.Nui.ServiceModel.DataContract.FilterType.CompareFilter,
                    ComparisonType = FilterComparisonType.Equal,
                    LeftExpression = new BaseExpression()
                    {
                        ExpressionType = EntitySchemaQueryExpressionType.SchemaColumn,
                        ColumnPath = "Name"
                    },
                    RightExpression = new BaseExpression()
                    {
                        ExpressionType = EntitySchemaQueryExpressionType.Parameter,
                        Parameter = new Parameter()
                        {
                            DataValueType = DataValueType.Text,
                            Value = "Петров Петр Петрович"
                        }
                    }
                }
            }
        }
    }
};

6. Реализовать пакетный запрос 

1. После сериализации созданных экземпляров классов запросов, в строки с JSON-объектами добавьте сведения о полном квалифицированном имени типа соответствующего контракта данных.
2. Сформируйте строку, содержащую пакетный запрос.
   Пакетный запрос

   /* Сериализация экземпляра класса запроса на добавление в JSON-строку. */
   var jsonInsert = new JavaScriptSerializer().Serialize(insertQuery);
   /* Вставка типа запроса в в JSON-строку. */
   jsonInsert = jsonInsert.Insert(1, @"""__type"": ""Terrasoft.Nui.ServiceModel.DataContract.InsertQuery"",");
   /* Сериализация экземпляра класса запроса на обновление в JSON-строку. */
   var jsonUpdate = new JavaScriptSerializer().Serialize(updateQuery);
   /* Вставка типа запроса в в JSON-строку. */
   jsonUpdate = jsonUpdate.Insert(1, @"""__type"": ""Terrasoft.Nui.ServiceModel.DataContract.UpdateQuery"",");
   /* Формирование пакетного запроса. */
   var json = @"{""items"": [" + jsonInsert + "," + jsonUpdate + "]}";
   

7. Реализовать пакетный запрос 

1. Создайте экземпляр класса HttpWebRequest.
2. Заполните свойства экземпляра.
3. Присоедините к запросу созданную ранее строку с JSON-объектом.
4. Выполните и обработайте результат запроса к сервису работы с данными DataService.
   Реализация POST-запроса

   /* Преобразование строки JSON-объекта в массив байтов. */
   byte[] jsonArray = Encoding.UTF8.GetBytes(json);
   /* Создание экземпляра HTTP-запроса. */
   var batchRequest = HttpWebRequest.Create(deleteQueryUri) as HttpWebRequest;
   /* Определение метода запроса. */
   batchRequest.Method = "POST";
   /* Определение типа содержимого запроса. */
   batchRequest.ContentType = "application/json";
   /* Добавление полученных ранее аутентификационных cookie в запрос на получение данных. */
   batchRequest.CookieContainer = AuthCookie;
   /* Установить свойство ContentLength запроса. */
   batchRequest.ContentLength = jsonArray.Length;
   
   /* Добавление токена BPMCSRF в запрос. */
   CookieCollection cookieCollection = AuthCookie.GetCookies(new Uri(authServiceUri));
   string csrfToken = cookieCollection["BPMCSRF"].Value;
   batchRequest.Headers.Add("BPMCSRF", csrfToken);
               
   /* Помещение в содержимое запроса JSON-объекта. */
   using (var requestStream = batchRequest.GetRequestStream())
   {
       requestStream.Write(jsonArray, 0, jsonArray.Length);
   }
   /* Выполнение HTTP-запроса и получение ответа от сервера. */
   using (var response = (HttpWebResponse)batchRequest.GetResponse())
   {
       /* Вывод ответа в консоль. */
       using (StreamReader reader = new StreamReader(response.GetResponseStream()))
       {
           Console.WriteLine(reader.ReadToEnd());
       }
   }
   /* Задержка выполнения приложения. */
   Console.ReadKey();