Подключение и настройка проекта

Добавление проекта в редактор

Добавление проекта

Для добавления проекта в редактор перейдем в меню File -> New -> Workflow Project.

Если в меню нет пункта Workflow Project, то можно выбрать пункт Project и в открывшемся окне выбрать нужный тип проекта:

Откроется окно создания нового проекта:

Чтобы добавить существующий проект в редактор, снимем галочку Use default location и в поле Location укажем путь до папки ..\Template\Projects\1. Template\Forms учебного проекта.

В поле Project name укажем имя проекта, которое будет отображаться в окне Navigator редактора Workflow Editor.

Поле Project type указывает редактору тип проекта, а именно схему, которую нужно использовать при работе с файлами проекта. Тип проекта можно будет переключить в процессе работы, через контекстное меню на кнопке Switch project type:

Жмем Finish, чтобы завершить добавление проекта в редактор.

В окне Project Explorer отображается наш проект, содержащий один файл стартовой формы:

Добавление серверного XML-файла

Добавим к проекту серверный XML-файл. Для этого просто перетащим его из окна Проводника на наш проект в окне Navigator. В открывшемся окне File Operation выбираем пункт Link to files а остальные настройки оставим по умолчанию. Жмем OK.

Теперь нам нужно привязать к проекту серверный XML-файл - это необходимо, чтобы редактор мог подсказывать имена SQL-запросов, описанных в этом файле, когда будем создавать загружающие соединения с данными в файлах форм, а так же имена команд, реализованных на стороне сервера.

Сделать это можно в свойствах проекта, для этого перейдем в меню Project -> Properties:

Свойства проекта можно открыть через контекстное меню, кликнув правой кнопкой мыши по имени проекта в окне Project Explorer, и выбрав пункт Properties.

И в открывшемся окне свойств проекта в левой части перейдем к секции Workflow Settings.

В правой части окна в блоке Forms так же есть настройка для задания типа проекта.

В блоке Workflows нажмем кнопку Add new workflow.

• File: - имя серверного XML-файла;

• Name: имя процесса, с которым связан серверный файл.

В открывшемся окне Workflow жмем кнопку Browse. В новом окне Files видим все файлы в проекте.

Выберем серверный XML-файл и жмем OK. В окне Workflow видим выбранный серверный файл и связанный с ним процесс.

Жмем OK.

В окне свойств проекта в таблице добавится серверный файл:

Жмем OK. Теперь серверный XML-файл привязан к проекту.

Обзор структуры кода

В этом разделе кратко рассмотрим основные элементы xml-кода для серверного файла и файлов форм. Подробное описание всех тэгов можно найти в справочнике по серверной части и десктопной части.

Form.xmlWorkflow Forms

StartWorkflow Engine

Серверный xml-файл

Краткий шаблон основных элементов серверной части:

<?xml version="1.0"?>
<Workflow Schema="">
  <SqlQueries>
    <SqlQuery Name="">
      <Text></Text>
    </SqlQuery>
  </SqlQueries>

  <AccessPoints>
    <AccessPoint Name="" />
  </AccessPoints>

  <Permissions>
    <Permission Name="">
      <AccessPoint Name="" />
      <SqlQuery Name="" />
    </Permission>
  </Permissions>
  
  <Roles>
    <Role Name="">
      <Permissions></Permissions>
    </Role>
  </Roles>

  <Groups>
    <Group Name="">
      <Roles></Roles>
    </Group>
  </Groups>
</Workflow>

Необязательный тэг <SqlQueries> - список тэгов <SqlQuery>, каждый из которых описывает SQL-запрос на получение или изменение данных, хранящихся в базе данных. Один тэг <SqlQuery> может содержать последовательность SQL-запросов, которые будут выполняться в рамках одной транзакции.

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

Необязательный тэг <AccessPoints> - список точек доступа, которые предоставляют пользователям доступ к элементам форм.

Необязательный тэг <Permissions> - список разрешений на выполнение запросов и команд, а так же точек доступа.

Необязательный тэг <Roles> - список ролей, представляющих наборы разрешений.

Необязательный тэг <Groups> - список групп пользователей с наборами ролей.

Xml-файл формы

Краткий шаблон основных элементов xml-файла форм десктопного приложения:

<?xml version="1.0"?>
<Form Name="" Width="" Height="" BackColor="" StartPosition="" StatusBar="">
  <Parameters>
    <Parameter Name=""></Parameter>
  </Parameters>

  <Appearance>
    <Colors>
      <Color Name="" Red="" Green="" Blue="" Alpha="" />
    </Colors>
    <FontStyles>
      <FontStyle Name="" Font="" Size="" />
    </FontStyles>
  </Appearance>

  <DataConnections></DataConnections>

  <Conditions>
    <Condition Name="" Type="" Assembly="Conditions" />
  </Conditions>

  <Commands>
    <Command Name="" Type="" Assembly="Commands" />
  </Commands>
  
  <Executions>
    <Execution>
      <ConditionExpression></ConditionExpression>
      <Commands></Commands>
    </Execution>
  </Executions>

  <MyObjects>
    <MyObject Name="" Type="" Assembly="BaseControls">
      <Top></Top>
      <Left></Left>
      <Height></Height>
      <Width></Width>
    </MyObject>
  </MyObjects>
</Form>

Корневым элементом файла является тэг <Form>, его атрибуты описывают основные свойства формы.

Необязательный тэг <Parameters> - список параметров формы, с помощью которых можно передавать данные между формами или хранить промежуточные расчеты на самой форме.

Необязательный тэг <Appearance> - список шрифтов и цветов для графических элементов формы.

Необязательный тэг <DataConnections> - список соединений с данными для загрузки данных с сервера или сохранения данных на сервере.

Необязательный тэг <Conditions> - список событийных условий (например, CellDoubleClickCondition или FormLoadedCondition) и условий сравнений (например, EqualCondition или IsNullOrEmptyCondition).

Необязательный тэг <Commands> - список команд, выполняемых на стороне клиента.

Необязательный тэг <Executions> - конструкции выполнения команд по

Необязательный тэг <MyObjects> - список объектов формы, таких как поля ввода (TextBox и NumericBox), таблицы (DatabaseTable) или переменных (Variable).

Чтобы отключить следование структуры кода в окне Outline за кодом в окне редактирования, можно кликнуть по кнопке View Menu и в контекстном меню отключим Link with Editor: