Дополнительная функциональность среды разработки

Настройка политики повторных вызовов

Увеличить

Увеличить

Пример type=xml
<?xml version="1.0" encoding="UTF-8" ?>
<xs:retryPolicyModels xmlns:xs="http://.........."
    businessFamily="dul_family">
      <xs:retryPolicyModel id="RetryPolicy" description="Политика Retry">
          <!-- id модели используется для связи с тасками, для которых она будет применима -->
          <xs:retryPolicies>
              <xs:retryPolicy description="Политика для TransportTimeoutException">
                  <xs:exceptions> <!--Список исключений, на которые нужно реагировать-->
                               <xs:exception>TransportTimeoutException
                      </xs:exception>
                      <xs:exception>TransportNoRouteException
                      </xs:exception>
                      <xs:exception>UnavailableServiceException
                      </xs:exception>
                      <xs:exception>TransportException
                      </xs:exception>
                      <xs:exception>CdmWrappedException
                      </xs:exception>
                  </xs:exceptions>
                  <xs:retryStrategy>
                      <xs:linear> <!-- задать количество повторных попыток и интервал -->
                          <xs:count>3</xs:count>
                          <xs:timeout>PT1M</xs:timeout>
                      </xs:linear>
                  </xs:retryStrategy>
              </xs:retryPolicy>
          </xs:retryPolicies>
      </xs:retryPolicyModel>
</xs:retryPolicyModels>

Валидация политики повторного вызова

Валидация модели

1. Правила описания процессов, накладываемые нотацией BPMN0.
2. Правила описания расширений, накладываемые средой исполнения (bpms-core-app).
3. Правила описания расширений, накладываемые движком среды исполнения (activity)
4. Правила валидации модели с точки зрения bpms-core-app и activity.

Нарушение этих правил при разработке модели приведет к невозможности использовать модель в среде исполнения!

Правила валидации модели с точки зрения bpms-core-app и activity

Валидация модели в СР

1. В структуре проекта выберите файл модели (или несколько моделей, или папку с файлами), перейдите в контекстное меню (нажать правую кнопку мыши) и выберите пункт "Validate":
   

   Увеличить

2. После завершения валидации, на экране появится сообщение, информирующее о количестве найденных ошибок (Errors) и/или предупреждений (Warnings), а также о времени выполнения валидации:
   

   Увеличить

   

   Увеличить

3. На вкладке "Markers" или "Problems" в нижней части экрана можно посмотреть результат проведенной валидации:
   

   Увеличить

   

   Увеличить

   Для удобства исправления ошибок в таблицах вкладок "Markers" и "Problems" есть:
   • колонка "Description" с описанием ошибки;
   • колонка "Resource" с именем файла модели;
   • колонка "Location", в которой содержится номер строки bpmn-файла, в которой зафиксирована данная ошибка валидации.
   

   Увеличить

4. Вкладки "Markers" и "Problems" могут содержать данные об ошибках и предупреждениях других или даже всех моделей из рабочей области. Поэтому, для просмотра данных валидации модели можно сделать одно из следующих действий:
   • Отсортировать модели по именам, нажав на название колонки "Resource" и найдя нужный файл:
     

     Увеличить

   • Выделить ненужные строки (или сразу группировку строк) и удалить их. Можно удалить все и затем повторить пункты 1 - 3, чтобы увидеть ошибки валидации только выбранной модели или моделей.
     

     Увеличить

Визуальное сравнение моделей

Доступно для версии среды разработки 1.10 и выше.

1. Диаграмма, которую хотим сравнить, должна быть открыта в графическом виде:
   

   Увеличить

   Если она открывается в виде файла xml, то нажмите на нее правой кнопкой мыши и в появившемся контекстном меню выберите Open With - Bpmn2 Diagram Editor:
   

   Увеличить

2. Перейдите в главном меню в Diagram - Compare Models:
   

   Увеличить

3. В открывшемся диалоговом окне в секции "Original model" нажмите пиктограмму "папка":
   

   Увеличить

   Выберите путь до модели, с которой необходимо произвести сравнение:
   

   Увеличить

   Можно, при необходимости, перевыбрать файл в секции "Modified model". Затем нажмите "ОК". Эти модели для сравнения так названы потому, что предполагается, что измененная модель может быть сохранена под другим именем и, не закрывая оригинальную модель, можно вызывать процедуру сравнения отредактированной модели с оригиналом.
4. В рабочей области появится вкладка "Models Compare" c визуальным сравнением обеих моделей:
   

   Увеличить

   Красным цветом выделены удаленные элементы, зеленым - добавленные, желтым - редактированные, а серым - не изменившиеся. Внизу будет вкладка "Sbt Models Compare", в которой представлено текстовое описание всех изменений:
   

   Увеличить

Все изменения, произведенные с моделями на вкладке "Models Compare", не будут сохранены!

Изменение моделей после сравнения не будет отображаться на вкладке "Models Compare". Для сравнения новых изменений нужно заново произвести процедуру сравнения и получить новую вкладку "Models Compare".

Настройка Business Family процесса

1. Перейдите в свойства процесса, нажав на пустую область модели и открыв вкладку "Properties".
2. Перейдите в раздел "Process" и заполнить в нем поле "Business Family":
   

   Увеличить

3. Сохраните модель. Значение сохраняется в xml в элементе bpmn2:process в атрибуте sbt:businessFamily:
   

   Увеличить

Настройка владельца процесса

1. Перейдите в свойства процесса (вкладка "Properties"), нажав на пустую область модели:
   

   Увеличить

2. Перейдите на вкладку "Process Owner":
   

   Увеличить

3. Укажите роль. Существует два способа указания роли:
   • Ручной ввод- самостоятельное описание процессной роли. Для ручного задания роли необходимо заполнить следующие поля:
     • Role Name - наименование роли;
     • Role Description - описание роли;
     • Role Code - код роли (на латинице).
   • Выбор из списка - выбор роли из файла ролевой модели. Файл ролевой модели подготавливает прикладная фабрика. Для выбора роли из файла ролевой модели необходимо нажать "Select Role":
     

     Увеличить

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

   Увеличить

   Для поиска ролей в списке можно использовать поле "Search Pattern". Это поле чувствительно к регистру. Нажмите кнопку "Select". Поля вкладки "Process Owner" будут заполнены автоматически:
   

   Увеличить

   Сохраните изменения в модели.
5. В случае, если файл ролевой модели еще не выбран, появится сообщение:
   

   Увеличить

   Нажмите "Yes". Откроется окно "Preferences", вкладка "SBT Config":
   

   Увеличить

   Навжмите "Change" напротив поля "Path to file with roles". Далее необходимо указать путь до xml-файла ролевой модели и нажать кнопку "Apply and Close". Если нужно изменить путь расположения файла ролевой модели, то можно открыть это окно с помощью главного меню: Window - Preferences - SBT Config. Далее проделать действия, описанные выше.
6. В случае, если используется коллаборация, откройте настройки процесса можно, выбрав его на вкладке "Outline": снова выполните шаги 3 и 4.
   

   Увеличить

   Для задания роли владельца процесса проделываем шаги 2, 3 и 4.

XML-представление

Обновление моделей

Обновление ID элементов

1. В списке файлов проекта вызовите контекстное меню на выбранной модели (нажать правую кнопку мыши, стоя на модели). Выберите "Sbt Modeler" и затем "Update Id":
   

   Увеличить

2. Если появится сообщение ниже, то необходимо нажать "ОК" и закрыть диаграмму с моделью, которую надо обновить:
   

   Увеличить

   Затем повторите пункт 1.
3. Появится предупреждение о том, что в модели будет выполнена замена ID:
   

   Увеличить

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

4. В случае успешного обновления будет получено сообщение о завершении операции. Нажмите "Ок". Подтвердите свое намерение нажатием кнопки "Yes".
   

   Увеличить

   Изменения в модели сохранятся автоматически.
5. Откроется вкладка "Compare" с сравнением модели до и после обновления. Старые и новые ID будут выделены в обоих окнах:
   

   Увеличить

Не забудьте обновить все зависимости, которые ссылаются на модель, проставив в них новые ID!

Обновление модели при обновлении версии СР

Обновление всех моделей в проекте

1. Вызовите контекстное меню на корневом каталоге проекта или на нужной папке (нажать правую кнопку мыши). Выберите в меню Sbt Modeler - Update All BPMN Models:
   

   Увеличить

2. Появится сообщение, что выбранные модели будут обновлены. Для подтверждения действия нажмите "Yes":
   

   Увеличить

3. После завершения обновления на экране отобразится список моделей, к которым была применена операция, с указанием результата:
   

   Увеличить

   Могут быть обновлены только модели для которых корректно указан namespace

Обновление одной модели

1. Вызовите контекстное меню на файле модели (нажать правую кнопку мыши). Выберите в меню Sbt Modeler - Update Model:
   

   Увеличить

2. Если выбранная модель открыта в графическом виде, то появится сообщение с просьбой закрыть ее:
   

   Увеличить

   Закройте диаграмму и повторите шаг 1.
3. Появится сообщение, что выбранная модель будет обновлена. Для подтверждения действия нажмите
   

   Увеличить

4. Может появиться сообщение о лишних тэгах в коде и вопрос, хотите ли вы их удалить:
   

   Увеличить

   Это связано с каким-то старым сбоем, в результате чего у элемента (в основном это элемент Pool) модели нет соответствующего графического элемента и поэтому он не отображается на диаграмме. Это нарушение приводит к появлению предупреждения при валидации модели (на вкладках "Markers" и "Problems"). Для того чтобы убрать это предупреждение, то необходимо нажать "Yes". Вне зависимости от выбора "Yes" или "No", обновление модели будет выполнено.
5. В случае успешного обновления вы получите сообщение о завершении операции. Нажмите "Ок".
   

   Увеличить

   Изменения в модели сохранятся автоматически.
6. Откроется вкладка "Compare" с сравнением модели до и после обновления. Изменения будут выделены в обоих окнах:
   

   Увеличить

Обновление модели при открытии

Увеличить

Увеличить

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

Работа с переменными и выражениями

Переменные

• Переменные могут быть добавлены в экземпляр процесса при старте/создании. Например, при RuntimeService:
  ProcessInstance startProcessInstanceByKey(String processDefinitionKey, Map<String, Object> variables)
• Переменные могут быть добавлены при выполнении процесса:

  Пример type=sh
  void setVariable(String executionId, String variableName, Object value);
  void setVariableLocal(String executionId, String variableName, Object value);
  void setVariables(String executionId, Map<String, ? extends Object> variables);
  void setVariablesLocal(String executionId, Map<String, ? extends Object> variables);
  

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

  Пример type=sh
  Map<String, Object> getVariables(String executionId);
  Map<String, Object> getVariablesLocal(String executionId);
  Map<String, Object> getVariables(String executionId, Collection<String> variableNames);
  Map<String, Object> getVariablesLocal(String executionId, Collection<String> variableNames);
  Object getVariable(String executionId, String variableName);
  <T> T getVariable(String executionId, String variableName, Class<T> variableClass);
  

• Переменные используются в Java Delegates, выражениях, execution- или task-listener'ах, скриптах и т.д. Простейшие методы использования:

  Пример type=sh
  execution.getVariables();
  execution.getVariables(Collection<String> variableNam es);
  execution.getVariable(String variableNam e);
  execution.setVariables(Map<String, object> variables);
  execution.setVariable(String variableNam e, Object value);
  

Выражения

• Пример использования для определения исходящих путей;

  sequenceFlow type=xml
  <sequenceFlow id="flow" sourceRef="theStart" targetRef="theTask">
     <conditionExpression xsi:type="tFormalExpression">
            <![CDATA[${order.price > 100 && order.price < 250}]]>
     </conditionExpression>
  </sequenceFlow>
  

  В данном случае, выражением, которое необходимо указать является:
  ${order.price > 100 && order.price < 250}
• Пример использования для автоматических задач:
  <serviceTask id="serviceTask" activiti:delegateExpression="$ {delegateExpressionBean}" />

  Пример2 type=xml
  <serviceTask id="javaService"
    name="My Java Service Task"
    activiti:expression="#{printer.printMessage(execution, myVar)}" />
  

• Пример использования в execution- и task-listener'ах:

  Пример type=xml
  <userTask id="secondTask">
     <extensionElements>
            <activiti:executionListener expression="${myPojo.myMethod(execution.event)}" event="end" />
     </extensionElements>
  </userTask>