Разработка > Процесс разработки

Исходные коды можно передавать из одной среды разработки в другую, например, чтобы обновить элементы базовых решений на новую версию системы, передать разработанные решения в стороннюю компанию для дальнейшей модификации или отладить решение на сервере с операционной системой Linux. Вместе с исходными кодами передаются настройки по умолчанию для бизнес-процессов.

Предположим, в среде разработки Directum RX в новом решении создан модуль и с помощью перекрытия изменено несколько справочников базовых решений. Кроме того, в решении мог быть создан тип задачи, для которого настроена схема процесса по умолчанию. Чтобы передать разработку, создайте пакет разработки с исходными кодами и настройками по умолчанию. Для этого экспортируйте разработку:

1.В главном меню среды разработки Directum RX последовательно выберите пункты Сборка, Экспортировать разработку:

2.В открывшемся окне задайте настройки:

•Передать как базовые решения. Установите флажок, если необходимо, чтобы решения после импорта разработки добавились в среду разработки как базовые. Элементы базовых решений можно изменять только на слое в своем решении при помощи перекрытия;

•Передать как отладочный пакет. Установите флажок, если пакет разработки собирается для отладки решения. При публикации отладочного пакета в Directum RX в лог-файл веб-сервера записывается информация о номерах строк кода, в которых возникает ошибка. Кроме этого, к процессу отладки, запущенному на сервере, можно будет подключиться с другого компьютера;

•Включить в пакет исполняемые файлы. Установите флажок, если пакет разработки собирается для обновления продуктивной системы. Решения, импортированные из пакета, станут доступны для работы в клиентском приложении;

•Включить в пакет исходные коды. Установите флажок, если пакет разработки собирается для обмена разработкой. Решения, импортированные из пакета, станут доступны для изменения в среде разработки. Настройки по умолчанию для бизнес-процессов добавляются в пакет разработки всегда, даже если флажок не установлен.

Примечание. Если пакет разработки не является отладочным пакетом и в него помещены исполняемые файлы решения, то после успешного создания пакета разработки номер версии решения увеличится на 1.

3.Определите состав решений, которые нужно включить в пакет разработки. Установите рядом с ними флажки. Если выбранные решения зависят от других решений, установите флажки и для них.

ВАЖНО. Если в решении были перекрыты абстрактные типы сущностей, например «Входящий документ» (IncomingDocumentBase), обязательно включите в пакет разработки базовые решения.

4.При необходимости добавьте текстовое описание. Оно отображается при импорте пакета в среду разработки Directum RX.

5.Нажмите на кнопку Экспорт.

Важно. Если для выбранных решений или модулей настроены зависимости от модулей, которые не включены в пакет, появится предупреждение.

Выберите одно из действий:

Да. В пакет разработки добавятся исполняемые файлы решений и модулей, от которых зависят выбранные. Настройка создания пакета разработки продолжится.

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

6.В открывшемся окне выберите папку для сохранения пакета разработки и введите имя пакета. Нажмите на кнопку Сохранить. Начнется создание пакета разработки.

После успешного создания пакета разработки появится соответствующее сообщение. В результате создадутся:

•файл пакета разработки с расширением *.dat;

•XML-файл с именем пакета разработки, в котором содержится информация о пакете.

Невизуальный режим экспорта

Пакет разработки можно создать в невизуальном режиме, например с помощью командной строки, PowerShell или программы FAR Manager. Для этого:

1.Создайте XML-файл конфигурации пакета разработки.

Совет. При создании пакета разработки в визуальном режиме XML-файл генерируется автоматически. Можете использовать его, если ранее создавали пакет.

Структура файла:

<?xml version="1.0"?>
<DevelopmentPackageInfo 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<IsDebugPackage>{Передать как отладочный пакет}
</IsDebugPackage>
  <PackageModules>
    <PackageModuleItem>
      <Id>{Идентификатор экспортируемого решения}
      </Id>
      <Name>{Код компании.Имя решения}
      </Name>
      <Version>{Версия решения}</Version>
      <IncludeAssemblies>{Включить в пакет исполняемые файлы}
      </IncludeAssemblies>
      <IncludeSources>{Включить в пакет исходные коды}
      </IncludeSources>
      <IsSolution>{Является решением}
      </IsSolution>
      <IsPreviousLayerModule>{Передать как базовые решения}
      </IsPreviousLayerModule>
    </PackageModuleItem>
<!--Список модулей для экспорта -->
    <PackageModuleItem>
      <Id>{Идентификатор экспортируемого решения}
       </Id>
      <SolutionId>{Идентификатор экспортируемого модуля}
      </SolutionId>
      <Name>{Код компании.Имя модуля}
      </Name>
      <Version>{Версия модуля}</Version>
      <IncludeAssemblies>{Включить в пакет исполняемые файлы}
      </IncludeAssemblies>
      <IncludeSources>{Включить в пакет исходные коды}
      </IncludeSources>
      <IsSolution>{Является решением}
      </IsSolution>
      <IsPreviousLayerModule>{Передать как базовые решения}
      </IsPreviousLayerModule>
    </PackageModuleItem>
  </PackageModules>
…
</DevelopmentPackageInfo>

Пример:

<!--Экспорт решения, которое состоит из одного модуля -->
<?xml version="1.0"?>
<DevelopmentPackageInfo 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<IsDebugPackage>false</IsDebugPackage>
  <PackageModules>
    <PackageModuleItem>
      <Id>ccaf5fa7-4108-422d-bed4-1d4ea46488af</Id>
      <Name>DEV.RentSolution</Name>
      <Version>0.0.1.0</Version>
<IncludeAssemblies>true</IncludeAssemblies>
      <IncludeSources>false</IncludeSources>
      <IsSolution>true</IsSolution>
      <IsPreviousLayerModule>false
      </IsPreviousLayerModule>
    </PackageModuleItem>
<!--Данные модуля -->
    <PackageModuleItem>
      <Id>9dc3d9e2-9698-4643-ad95-d72cb55a2bb8</Id>
      <SolutionId>ccaf5fa7-4108-422d-bed4-1d4ea46488af</SolutionId>
      <Name>DEV.RentModule</Name>
      <Version>0.0.1.0</Version>
      <IncludeAssemblies>true
      </IncludeAssemblies>
      <IncludeSources>false
      </IncludeSources>
      <IsSolution>false
      </IsSolution>
      <IsPreviousLayerModule>false
      </IsPreviousLayerModule>
    </PackageModuleItem>
  </PackageModules>
</DevelopmentPackageInfo>

Примечание. Чтобы скопировать идентификатор решения или модуля, выделите его в дереве решений и в контекстном меню выберите пункт Скопировать идентификатор.

Если в решение входит несколько модулей, то добавьте секцию <PackageModuleItem> для каждого из них. При этом для решения и всех входящих в него модулей должны совпадать значения параметров Включить в пакет исполняемые файлы, Включить в пакет исходные коды, Передать как базовые решения.

2.С помощью командной строки откройте содержимое папки, в которой находится среда разработки Directum RX. Пример пути до папки: %PROGRAMFILES%\Directum Company\Sungero Development Studio.

3.Передайте параметры команды для утилиты DevelopmentStudio.exe в формате:

Start /w DevelopmentStudio.exe -c <configuration> -d <dev_package> --increment-version <true/false> –PassThru

/w – флаг командной строки, который позволяет не дожидаться завершения всех дочерних процессов и тем самым ускоряет процесс создания пакета. Аналог команды в PowerShell – $process.WaitForExit();

-c (или --configuration) <configuration> – путь к созданному XML-файлу конфигурации пакета разработки. Обязательный параметр;

-d (или --development-package) <dev_package> – путь к создаваемому файлу с пакетом разработки. Обязательный параметр;

--increment-version <true/false> – признак, который определяет нужно увеличивать номер версии модулей и решений или нет. Если выбрано значение:

•True – номер версии у всех модулей и решений увеличится;

•False – номер версии у всех модулей и решений не увеличится.

Если параметр в команде не используется, то номер версии увеличится только у тех модулей и решений, для которых в XML-файле параметр <IsDebugPackage> имеет значение False, а параметр <IncludeAssemblies> имеет значение True.

-v (или --set-version) <version> – номер версии, которую надо задать для решения и его модулей, входящих в пакет разработки. Номер версии изменяется у решений и модулей, для которых в XML-файле параметр <IsDebugPackage> имеет значение False, а параметр <IncludeAssemblies> имеет значение True.

Пример команды для cmd:

Start /w DevelopmentStudio.exe -c "C:\Package\Development_package.xml" -d "C:\Package\Development_package.dat" --increment-version “false”

Пример команды для PowerShell:

$process = $(Start-Process -FilePath DevelopmentStudio.exe -ArgumentList "-c ""C:\Package\Development_package.xml"" -d ""C:\Package\Development_package.dat"" --increment-version false" –PassThru)
$process.WaitForExit()

СМ. ТАКЖЕ