Пользовательские задачи Oracle BPM 12c: роли и подразделения пользователей

Участником задачи могут быть:

• пользователь (user);
• группа пользователей (group);
• роль пользователей (app.role), в контексте Oracle BPM.

Взаимосвязь между участниками указана ниже:

Орг.единицы (Organization Unit) определяют структуру организации, например:

Важно отметить, что орг.единицы логически связанны только с ролями пользователей (т.е. не для группы пользователей и тем более не для пользователя).

Рассмотрим на примере как работает механизм орг.единиц:

В соответствии со схемой выше, в организации есть 3 бухгалтера по одному в каждом отделении и аналогично 3 инженера в каждом отделении.
Создадим две роли "Бухгалтер" и "Инженер" и три орг.подразделения и добавим в них соответствующих сотрудников. Таким образом получается:

Роль	Пользователь	Организационное подразделение
Бухгалтер	Иванова	Западносибирское отд.
	Сидирова	Уральское отделение
	Кузнецова	Дальневосточное отд.
Инженер	Петрова	Западносибирское отд.
	Алексеева	Уральское отделение
	Борисова	Дальневосточное отд.

Создадим простейший BPMN-процесс с одной задачей:

Но данная задача должна назначаться на роль "Бухгалтер" уральского подразделения, для этого добавляем перед назначением задачи добавим script-активность, в которой укажем необходимое орг.подразделение (Process / Predefined Variables / Organization Unit):

Если бы мы не указали орг.подразделение, то задача назначилась на всех участников роли "Бухгалтер", т.е. доступ был бы у 3-х сотредников. 

Так как мы указали орг.подразделение, то задача назначится на того сотрудника роли "Бухгалтер", который входит в указанное подразделение, т.е. Сидорову.

Данная функциональность позволяет сильно сократить количество ролей (без неё потребовалось бы 6 ролей вместо 2).

Пользовательские задачи Oracle BPM 12c: пример реализации ограничения перечня пользователей для операции "Делегирование"

По умолчанию задачу в Oracle BPM можно переназначить или делегировать на любого пользователя, роль и группу. Но можно ограничить этот перечень создав класс в BPM-проекте (в терминах JDeveloper), который реализует интерфейс oracle.bpel.services.workflow.task.IRestrictedAssignmentCallback.

Рассмотрим пример в котором нужно ограничить перечень пользователей для операции "Делегирование" следующим образом:

• Если исполнителем задачи является группа или роль, то делегировать можно только пользователям из состава этой группы или роли;
• Если исполнителем задачи является пользователь, то делегировать нельзя (пустой перечень доступных для делегирования пользователей).

Пример кода:

 import java.util.ArrayList;  
 import java.util.Collections;  
 import java.util.List;  
 import java.util.Map;  
   
 import oracle.bpel.services.workflow.IWorkflowConstants;  
 import oracle.bpel.services.workflow.task.IRestrictedAssignees;  
 import oracle.bpel.services.workflow.task.IRestrictedAssignmentCallback;  
 import oracle.bpel.services.workflow.task.impl.RestrictedAssignees;  
 import oracle.bpel.services.workflow.task.impl.TaskAssignee;  
 import oracle.bpel.services.workflow.task.model.Task;  
   
 import oracle.tip.pc.services.common.ServiceFactory;  
 import oracle.tip.pc.services.identity.BPMAppRole;  
 import oracle.tip.pc.services.identity.BPMAuthorizationService;  
 import oracle.tip.pc.services.identity.BPMGroup;  
 import oracle.tip.pc.services.identity.BPMIdentityService;  
 import oracle.tip.pc.services.identity.BPMUser;  
   
 import oracle.bpel.services.workflow.task.model.IdentityType;  
   
 public class RestrictedAssignmentCallbackImpl implements IRestrictedAssignmentCallback {  
   
   public IRestrictedAssignees getPermittedAssignees(Task task, Map map, String currentUser, String identityContext,  
                            String operation) {  
     List assignees = new ArrayList();  
     if (operation.equals(IRestrictedAssignmentCallback.OperationType.REASSIGN.toString())) {  
       //TODO реализовать логику для операции "Переназначение"  
     } else if (operation.equals(IRestrictedAssignmentCallback.OperationType.DELEGATE.toString())) {  
       try {  
         BPMIdentityService idenService = getIdentityServiceInstance(identityContext);  
         List<IdentityType> assigneesList = task.getSystemAttributes().getAssignees();  
         for (IdentityType assignee : assigneesList) {  
           if (IWorkflowConstants.IDENTITY_TYPE_GROUP.equals(assignee.getType())) {  
             List<BPMUser> usersInGroup =  
               idenService.getParticipantsToGroup(assignee.getDisplayName(), true);  
             for (BPMUser user : usersInGroup) {  
               assignees.add(new TaskAssignee(user.getName(), IWorkflowConstants.IDENTITY_TYPE_USER));  
             }  
           } else if (IWorkflowConstants.IDENTITY_TYPE_APPLICATION_ROLE.equals(assignee.getType())) {  
             List<BPMUser> usersInGroup =  
               idenService.getParticipantsToAppRole(assignee.getDisplayName(),  
                                  task.getApplicationContext(), false);  
             for (BPMUser user : usersInGroup) {  
               assignees.add(new TaskAssignee(user.getName(), IWorkflowConstants.IDENTITY_TYPE_USER));  
             }  
           } else if (IWorkflowConstants.IDENTITY_TYPE_USER.equals(assignee.getType())) {  
             // Пустой список  
             return new RestrictedAssignees(new ArrayList(), true);  
           }  
         }  
   
       } catch (Exception ex) {  
         ex.printStackTrace();  
       }  
     }   
   
     if (!assignees.isEmpty()) {  
       return new RestrictedAssignees(assignees, true);  
     }  
   
     return null;  
   }  
   
   public List<IRestrictedAssignmentCallback.OperationType> getRestrictedOperations(Task task, Map map,  
                                            String currentUser,  
                                            String identityContext) {  
     return Collections.emptyList();  
   }  
   
   private BPMAuthorizationService getAuthorizationService(String realmName) {  
     return ServiceFactory.getAuthorizationServiceInstance(realmName);  
   }  
   
   private BPMIdentityService getIdentityServiceInstance(String realmName) {  
     return ServiceFactory.getIdentityServiceInstance(realmName);  
   }  
 }  
   

Пользовательские задачи Oracle BPM 12c: Custom Escalation Java Function

Custom Escalation Java Function указывается в конфигурации задачи для указания по какой логике будет выполняться эскалация для пользователей и групп (для ролей не используется!).

Custom Escalation Java Function рассмотрим на примере:

 package oracle.bpel.services.workflow.assignment.dynamic;  
   
 import java.util.List;  
 import java.util.Map;  
   
 import oracle.bpel.services.workflow.task.model.Task;  
 import oracle.bpel.services.workflow.assignment.dynamic.DynamicAssignmentException;  
   
 import oracle.tip.pc.services.common.ServiceFactory;  
 import oracle.tip.pc.services.identity.BPMAuthorizationService;  
   
 import oracle.tip.pc.services.identity.BPMAppRole;  
 import oracle.tip.pc.services.identity.BPMAuthorizationService;  
 import oracle.tip.pc.services.identity.BPMGroup;  
 import oracle.tip.pc.services.identity.BPMIdentityService;  
 import oracle.tip.pc.services.identity.BPMUser;  
 /*  
  * Обеспечивает эскалацию на владельца задачи.  
  */  
 public class OwnerEscalation implements IDynamicTaskEscalationFunction {  
   public String defaultUser;  
   
   @Override  
   public String getTaskEscalationUser(Task task) throws DynamicAssignmentException {  
     String ownerRole = task.getOwnerRole();  
     String ownerGroup = task.getOwnerGroup();  
     String ownerUser = task.getOwnerUser();  
     if (ownerRole != null) {  
       try {  
         BPMAuthorizationService idenService = ServiceFactory.getIdentityServiceInstance();  
         List<BPMUser> usersInRole =  
           idenService.getParticipantsToAppRole(ownerRole, task.getApplicationContext(), false);  
         if (usersInRole.size() > 0) {  
           // Берём первого пользователя  
           return usersInRole.get(0).getName();  
         }  
       } catch (Exception ex) {  
         ex.printStackTrace();  
       }  
     } else if (ownerGroup != null) {  
       try {  
         BPMAuthorizationService idenService = ServiceFactory.getIdentityServiceInstance();  
         List<BPMUser> usersInGroup = idenService.getParticipantsToGroup(ownerGroup, true);  
         if (usersInGroup.size() > 0) {  
           // Берём первого пользователя  
           return usersInGroup.get(0).getName();  
         }  
       } catch (Exception ex) {  
         ex.printStackTrace();  
       }  
     } else if (ownerUser != null) {  
       return ownerUser;  
     }  
     return defaultUser;  
   }  
   
   @Override  
   public String getTaskEscalationUser(String string) throws DynamicAssignmentException {  
     return defaultUser;  
   }  
   
   @Override  
   public void setInitParams(Map map) throws DynamicAssignmentException {  
     // Добавляем параметр указывающий на какого пользователя проводить эскалацию,   
     // если владелец задачи (Owner) не указан  
     defaultUser=(String)map.get("DEFAULT_USER");  
   }  
   
   @Override  
   public String getFunctionName() {  
     return "OWNER_ESCALATION";  
   }  
   
   @Override  
   public String getDescription() {  
     return "Escalation to task owner";  
   }  
 }  
   

Логика данного примера:

Если у задачи определён владелец (Owner), то эскалация будет выполняться на владельца. Иначе, на пользователя указанного в конфигурации как DEFAULT_USER

Важно:

• Класс должен быть в пакете oracle.bpel.services.workflow.assignment.dynamic.

Установка:

1. Собрать JAR содержащий класс и положить его в директорию $MW_HOME\soa\soa\modules\oracle.soa.ext_11.1.1
2. Запустить ant в директории $MW_HOME\soa\soa\modules\oracle.soa.ext_11.1.1 (вероятно потребуется проинициализировать переменные окружения)
3. Перезагрузить soa-сервер для того, чтобы новый класс был доступен серверу (был в classpath).
4. Зарегистрировать Task Escalation Function:
1. Войти в EM (Enterprise Manager Fusion Middleware Control)
2. Перейти в soa-infra -> SOA Administration -> Workflow Properties
3. Перейти на закладку Task и добавить наш класс (Add function) следующим образом:
   

Альтернативный вариант: вместо указанных действий в п.1-2 можно положить скомпилированный класс в директорию $MW_HOME\soa\soa\modules\oracle.soa.ext_11.1.1\classes

Пользовательские задачи Oracle BPM 12c: новая функциональность таймеров

После авторизации в Oracle BPM Workspace 12c выбрав экземпляр любой задачи вы обнаружите, что у задач появились два новых действия:

• Начать работу (Start Task)
  
• Закончить работу (Stop Task)
  

Функциональность данных действий работает следующим образом:

После выполнения "Начать работу" включается таймер, а после выполнения "Закончить работу" таймер выключается и сохраняется длительность включённого таймера с нарастающим итогом

Особенности

• Функциональность "Начать работу" / "Закончить работу" не генерируют событий (EDN), поэтому значения можно узнать через API или в следующем (по времени) генерируемом событии.
• Если задача назначена на группу/роль, то выполнение "Начать работу" приводит так же к выполнению "Взять в работу".
• Если пользователь выполнил "Начать работу" и затем исполнил/завершил задачу (т.е. не была выполнена операция "Закончить работу"), то значение таймера длительности будет 0. 
• Таймер никак не связан с пользователями выполняющими действия. Последовательный пример: 

1. назначается задача на первого пользователя
2. первый пользователь выполняет "Начать работу"
3. первый пользователь переназначает на второго пользователя
4. второй пользователь выполняет "Закончить работу" и исполняет/завершает задача
В итоге: нет информации сколько времени с задачей работал первый пользователь, а сколько второй. Есть только информация сколько времени прошло с включения таймера (действия "Начать работу") до выключения таймера (действия "Закончить работу").

Недостатки

• Данная функциональность не документирована (ни в пользовательской документации, ни в Oracle Fusion Middleware Workflow Services Java API Reference for Oracle SOA Suite).
• Следствие первого пункта - доступна только из Oracle BPM Workspace 12c (как следствие, не доступна, если вы не используете его).
• Следствие первого пункта - данная функциональность может быть изменена вендором (пока не будет внесена в публичную документацию). 

Пользовательские задачи Oracle BPM 12c: эскалация

Под эскалацией в Oracle BPM 12c (и в 11g) подразумевается автоматическое переназначение исполнителя задачи на другую роль, группу или пользователя (обычно более высокого по иерархии).

Эскалация может производиться:

• автоматически по истечению указанного времени в конфигурации задачи
  
• пользователем выполнившим действие «Эскалировать» (Escalate), которое может быть доступно:
• Исполнителю задачи (Assignee)
• Владельцу задачи (Owner)
• Администратору (Admin)

Особенности:

• В зависимости от того на ком находится задача на момент эскалации:
• Если это группа или пользователь, то отрабатывает указанная custom escalation java function (если функция не указана, то задача завершится будет ошибкой)
• Если это роль, то выполняется эскалация на указанный в роли Escalation Path (может быть роль, группа, пользователь).
   
• Последующие эскалации:
  
  • Если в Escalation Path указана роль, то последующая эскалация будет выполнятся на Escalation Path данной роли. 
  • Если в Escalation Path указан пользователь или группа, то отрабатывает указанная custom escalation java function (если функция не указана, то задача завершится будет ошибкой).
• Для каждой задачи можно задать глубину автоматической эскалации, т.е. кол-во раз которое будет выполнятся эскалация. По истечению указанного количества задача становится просроченной (expired).

Декодирование xsd:base64Binary в xsd:string

Цель:

При использовании JMS Adapter для получения текстового сообщения в формате XML, для которого XSD не известна, используется опция "Native format translation is not required (Schema is Opaque)". В этом случае входящее сообщение будет содержать элемент типа xsd:base64Binary, содержащий закодированное в base64 полученное сообщение.

Решение:

Т.к. в Oracle SOA Suite 11g отсутствует XSLT или XPATH-функции, позволяющая декодировать base64, поэтому можно использовать активность "Java Embedding" для решения данной задачи.

Итак, в BPEL-процессе есть две переменные:

 <!-- входная переменная из JMS Adapter -->
 <variable name="encoded_Input" messageType="ns1:Consume_Message_msg"/>  
 <!-- переменная в которую декодируем base64 -->
 <variable name="decoded_Input" type="xsd:string"/>

Добавляем в BPEL-процесс активность "Java Embedding" содержащую следующий код:

 try {      
     oracle.xml.parser.v2.XMLElement input = (oracle.xml.parser.v2.XMLElement) getVariableData("encoded_Input", "opaque");
     String input_str = input.getTextContent();   
     oracle.soa.common.util.Base64Decoder decoder = new oracle.soa.common.util.Base64Decoder();        
     String decoded = null;       
     decoded = decoder.decode(input_str);   
     setVariableData("decoded_Input", decoded);      
 } catch (Exception e) {  
     addAuditTrailEntry("EXCEPTION OCCURRED: " + e.toString());  
 }  

Альтернативный вариант - создание собственной XSLT или XPATH-функции для декодирования base64.

Освоение Oracle BPM

Требуется:

Выполнить простейший tutorial с Oracle Technology Network. Далее выполнить tutorial по одной из следующих книг:

• Getting Started with Oracle BPM Suite 11gR1
• Oracle BPM Suite 11g Developer's Cookbook

Изучить "продвинутые" аспекты по книге: 

• Oracle BPM Suite 11g Advanced BPMN Topics

Полезные ссылки:

• Официальная документация:
• Modeling and Implementation Guide
• User's Guide
• User's Guide for Business Process Composer
• Раздел BPM на Oracle Learning Library
• BPM-блог Анатолия Белайчука
• + см. полезные ссылки из Второй части освоения SOA

Пятая часть освоения SOA

Требуется изучить:

• WS-Security (WSM), для этого достаточно запись вебинара;
• Direct Binding, для этого достаточно изучить это;
• Изучаем сенсоры, для этого используем следующие материалы:
• Раздел Developers Guide посвящённый BPEL Sensors;
• Раздел Developers Guide посвящённый Composite Sensors.
• Изучаем Oracle Business Process Monitoring (BAM), для этого используем следующие материалы:
• Статья “Введение в Oracle Business Activity Monitoring (BAM)”;
• Статья “Разработка системы мониторинга на базе Oracle BAM”;
• (опционально) Раздел Developers Guide посвящённый Oracle BAM;
• (опционально) Официальный User Guide.
• REST-подход к сервисам:
• Что такое RESTful-сервисы?  (Информацию найти в интернете)
• В чём отличия, преимущества и недостатки относительно SOAP-сервисов (можно почитать здесь + ещё в интернете почитайте)? 
• Способы взаимодействия с RESTful-сервисами из Oracle SOA Suite (обязательно рассмотреть HTTP Adapter). 

Выполнить задание:

• Сенсоры и BAM:
• По книге Getting Started With Oracle SOA Suite 11gR1 изучить и выполнить задания по главе 16 (посвящённой Oracle BAM);
• Сделать композит (с BPEL-процессом), который будет вызывать внешний сервис (который нужно так же реализовать). Этот внешний сервис периодически возвращает ошибку (например такая логика: если минута в текущем времени четная, то вернуть ошибку). Нужно сделать отчёт средствами Oracle BAM содержащий информацию по общему кол-ву запущенных инстансов и сколько из них с ошибками
• REST:
• Сделать композит взаимодействующий с RESTful-сервисом (сам RESTful-сервис создайте его любым удобным средством).

Четвертая часть освоения SOA

Требуется изучить:

• Освоить MDS (MetaData Services). Для изучения этого вполне достаточно:
• (1/2) Using the MetaData Services (MDS) in a SOA environment;
• (2/2) Using the MetaData Services (MDS) in a SOA environment;
• Использование Oracle MDS для хранения общих объектов композитных приложений
• Освоить функционал Resequencing в Mediator, для этого используем раздел официальной документации

Выполнить задание:

• MDS: задеплоить в MDS артефакты (XSD, WSDL, fault policy file) и сделать простой композит использующий данные артефакты.
• Resequencing: сделать композит иллюстрирующий работу  всех вариантов Resequencing – Standard, FIFO, Best effort.
• EDN: 
  • Сделать композит с WS-интерфейсом, который генерирует событие (EDN), а другой композит слушает это событие и записывает информацию в БД. 
  • Сделать отдельный композит который слушает события от HumanTask (в качестве композита с HumanTask предлагаю взять таковой из tutorial) и записать информацию (как минимум: идентификатор задачи, кто сделал (логина достаточно), что сделал (действие) и когда сделал(время)) в БД

Третья часть освоение SOA

Выполнить задания:

• Задачка 1

Сделать композит, который периодически опрашивает (polling) таблицу БД на наличие строк со статусом READY и при их появлении пишет в файловую директорию cvs-файлы.

• Задачка 2

Сделать композит, который периодически опрашивает (polling) файловую директорию на наличие csv-файлов следующей структуры: First name,Last name,ID,E-mail John,Doe,01234567,john.doe@domain.com Alex,Smith,88888888,alex.smith@domain.com … Необходимо записать данные из csv-файлов в таблицу БД (сделать табличку с теми же полями и первичный ключ по всем полям).

• Задачка 3

Сделать композит, который «слушает» очереди JMS и AQ (т.е. две очереди; внутри XML-сообщения) и записывает данные сообщения в таблицу БД через вызов API-процедуры.

• Задачка 4

Добавить в существующий композит (см. задачку 2) дополнительную операцию (интерфейс WS), входная переменная которой получает полный путь к локальному csv-файлу (структура та же).  Необходимо записать данные из указанного файла в таблицу БД.

• Задачка 5

Добавить обработку ошибок в композите (см. задачку 2)  и в случае ошибки вставки в таблицу БД (ошибка по первичному ключу) переводить на администратора (humanIntervention), который может изменить значения полей и завершить выполнение композита

Вторая часть освоения SOA

Требуется изучить:

Выполнить tutorial. Есть следующие полезные книги:

• Getting Started With Oracle SOA Suite 11gR1 (главы 1-10,13-15,17)
• Oracle SOA Suite 11g R1 Developer’s Guide (главы 1-8,11,13-14,18-21)
• WS-BPEL 2.0 for SOA Composite Applications with Oracle SOA Suite 11g (главы 1-7 включительно)

Книги однотипные, главы связанные с BAM (Business Activity Monitorung) и OSB (Oracle Service Bus) пока не рассматриваем. Первые две книги содержат tutorial-ы. Пройдите от начала до конца одину из них (см. указанные главы). Обрати внимание, что оба tutorial-а по немного более старой версии SOA (например по 11.1.1.5), хотя на данный момент чаще всего используется версии 11.1.1.6 и 11.1.1.7 - поэтому скриншоты в книгах могут немного не совпадать.

После завершения tutorial просмотреть остальные книги на непроработанный/незатронутый функционал.

Выполнить задание:

1. Создать две JMS Queue в Weblogic;
2. Создать MDB, который перекладывает сообщения из одной очереди в другую;
3. Развернуть на сервере и протестировать.

Полезные ссылки:

1. Рекомендую использовать официальный developers guide по Oracle SOA, как справочник.
2. Хороший блог по Oracle SOA на русском языке
3. Блоги на английском:
• A-Team Chronicles
• Albin's Blog
• AMIS TECHNOLOGY BLOG
• Antony Reynolds' Blog
• Beyond SOA
• Harvinder Singh's Oracle AIA & SOA ...
• Java / Oracle SOA blog
• Managing Oracle SOA Environment [10g/11g]
• Middleware Magic [Weblogic]
• Middleware Snippets
• Neeraj Sehgal - Experimenting with SOA
• Oracle Middleware Blog
• Oracle SOA / Java blog
• Oracle SOA Best Practice And Troubleshooting
• Oracle SOA Essentials for an engineer
• Oracle SOA Suite - Team Blog
• Oracle Technologies Primer
• OracleFusionMiddleWare 10g,11g and AIA
• Sathyam's SOA Blog
• SOA / BPM on Oracle Fusion Middleware
• SOA Proactive Support
• SOA Thinker
• STEFAN'S SOA & AIA & ENTERPRISE ARCHITECTURE BLOG
• The Real Rach!!!
• The WebLogic Server Blog
• и многие другие

Первая часть освоения SOA

Требуется изучить:

• XML. Основные технологии: основы XML, XSD/XML Schema, XPath, XSL/XSLT, SOAP, WSDL. Полезная информация:
• Вкратце:
• Школа XML
• Школа XSL
• Школа XPath
• Школа XSD
• Школа SOAP
• Школа WSDL (в браузере выбрать кодировку cp1251)
• Видеокурсы от Яндекс:
• XML
• XPath
• XSLT

Книг по XML много, в том числе и на русском. Дополнительно полезно знать XQuery. Нужно понимание функциональности и возможностей XQuery по сравнению с XSL. Рекомендую книгу «W3C XML: Xquery от экспертов. Руководство по языку запросов» или в оригинале «XQuery from the Experts: A Guide to the W3C XML Query Language».

• Weblogic. Требуется разобраться:
• Как минимум, в следующих технологиях:
• JMS (Java Message Service)
• MDB (Message Driven Bean)
• JTA & JTS (Java Transaction API & Java Transaction Service)
• В основах администрирования.

Полезные ссылки:

• Oracle Learning Library
• Документацию по Oracle Fusion Middleware
• Google J

Освоение Oracle SOA

За основу данного набора статей взята моя переписка с начинающими разработчиками SOA, целью которой было вырастить разработчиков Oracle SOA Suite. Кроме переписки было обсуждение вопросов и задач через Skype. Формат следующий:

• Что нужно изучить с ссылками на материалы;
• Простейшие практические задачки;
• Полезные ссылки.

Обращаю внимание, что этот набор статей не охватывает весь функционал Oracle SOA Suite, а включает только наиболее часто используемый функционал. Так же смотрите на полезные ссылки в постах пройдя по которым можно изучить неохваченный функционал.

Этот пост подержит ссылки на все посты из данного набора:

• Первая часть
• Вторая часть
• Третья часть
• Четвертая часть
• Пятая часть

P.S. рекомендации приветствуются J

Список необходимых патчей для Oracle SOA & BPM Suite 11g PS6 (11.1.1.7)

Перечень патчей которые необходимо развернуть для Oracle SOA & BPM Suite 11g PS6 (11.1.1.7):

• Patch 17294404: XSDCOMPLEXTYPE.GETCHILDELEMENTS() IS NOT THREAD SAFE
• Patch 18325165: MERGE REQUEST ON TOP OF 11.1.1.7.0 FOR BUGS 16319620 16487002
• Patch 18609527: SOA BUNDLE PATCH 11.1.1.7.4
• Patch 18366461: NULLPOINTEREXCEPTION AT WEBSERVICEEXTERNALBINDINGCOMPONENT.GETINVOCATIONMETADATA

Скачать эти патчи можно c support.oracle.com.

P.S. список патчей будет дополняться (при необходимости).

P.P.S. рекомендации по патчам приветствуются :-)

ADF: Ошибка InvalidOwnerException JBO-25030 при одновременном создании master- и detail-записей

Ошибка:
При создании Master- и Detail-записи последовательно через ADF Data Binding, например как в следующем коде:

  public String createMasterDetail() {
  
   BindingContainer bindings = getBindings();  
   OperationBinding operationBinding =  
   bindings.getOperationBinding("CreateInsertMaster");  
   Object result = operationBinding.execute();  

   OperationBinding operationBinding1 =  
   bindings.getOperationBinding("CreateInsertDetail");  
   result = operationBinding1.execute();  

   return null;  
  }  

Причина:
При создании новой строки через ADF Data Binding её статус будет STATUS_INITIALIZED. А когда Detail-запись пытается найти Master-запись в кеше (у которой статус STATUS_INITIALIZED), то будет брошено исключение InvalidOwnerException.

Решение:

1. Установить флаг Сascade Update Key Attributes в ассоциации между Master- и Detail-сущностями;
2. Сгенерировать View Row Class (...ViewRowImpl) для Master-сущности и переопределить в нём следующий метод:

     @Override  
     public void setNewRowState(byte b) {  
      if (b!=Row.STATUS_INITIALIZED || getNewRowState()!=Row.STATUS_NEW){  
      super.setNewRowState(b);  
      }  
     }  
   

Пример простейшего ADF-приложения здесь.

SoapUI: подстановка вычисляемых значений с помощью вставок на Groovy

Целей функционального тестирования композитных приложений иногда используются заглушки и/или SoapUI,EM и прочие средства. Но как правило необходимо отправлять сообщения с отличающимися данными, например: документ на согласование с различными идентификатором и текущей датой отправки. Можно каждый раз перед отправкой менять значения вручную, но удобнее например для числовых идентификаторов использовать случайное число из определённого диапазона, а для даты подставлять например текущую дату. В SoapUI есть поддержка Groovy и подобное поведение делается очень легко (выделено красным):

Итак, в качестве значения поля для генерации:

• числового значения в диапазоне от 0 до 10000 нужно подставить:

   ${=(int)(Math.random()*10000)}  
  

• текущей даты нужно подставить:

   ${=new Date().format(‘yyyy-MM-dd’)}  
  

Планировщик заданий в Weblogic Server

Реализовать планировщик заданий можно, как средствами встроенных в операционную систему(ОС) планировщиков заданий так и встроенных СУБД, но при изменении ОС (например, с Windows на AIX) либо изменении СУБД (например, с Oracle на MySQL) потребуется переработка компонента планировщика. Рассмотрим реализацию планировщика заданий работающего внутри Weblogic Server, который не зависит от ОС и СУБД.
Данный планировщик представляет собой простейшее Web-приложение и будет выполнять задачу через каждые 5 секунд, а задача при выполнении будет писать в лог строку с временем выполнения (никто не запрещает сделать более сложную логику). А так же будет создан сервлет для управления заданием (действия - остановить выполнение и запустить выполнение). Более того при создании не будут использоваться внешние библиотеки, только те которые есть в Weblogic Server.

1. Открываем Oracle JDeveloper и создаём новое приложение (с именем SampleScheduler):
   
2. Затем добавляем в проект необходимые библиотеки.
   
3. Создаём новый класс для описания задания(с именем HelloWorldJob):

    package com.blogspot.stan1slav.sample.jobs;  
      
    import commonj.timers.CancelTimerListener;  
    import commonj.timers.Timer;  
    import commonj.timers.TimerListener;  
      
    import java.io.Serializable;  
      
    import java.util.Date;  
      
    public class HelloWorldJob implements Serializable, TimerListener,  
                       CancelTimerListener {  
      private Date timerDate = null;  
      
      public HelloWorldJob() {  
        super();  
      }  
      
      public void timerExpired(Timer timer) {  
        timerDate = new Date(timer.getScheduledExecutionTime());  
        System.out.println("HelloWorldJob timer expired called on " +  
                  timerDate);  
      }  
      
      public void timerCancel(Timer timer) {  
        timerDate = new Date(timer.getScheduledExecutionTime());  
        System.out.println("HelloWorldJob timer cancelled called on " +  
                  timerDate);  
      }  
    }  
   

   Следует обратить внимание на выделенное красным, это те классы которые должны быть имплементированы и методы которые должны быть реализованы (один при срабатывании задачи и другой для отмены/остановки задачи). Инициализацию задания можно вынести в конструктор.
4. Создаём сервлет для старта/остановки задания, а так же автозапуска:

    package com.blogspot.stan1slav.sample;  
      
    import com.blogspot.stan1slav.sample.jobs.HelloWorldJob;  
      
    import commonj.timers.Timer;  
    import commonj.timers.TimerManager;  
      
    import java.io.IOException;  
    import java.io.PrintWriter;  
      
    import java.util.Date;  
      
    import javax.naming.InitialContext;  
      
    import javax.servlet.ServletConfig;  
    import javax.servlet.ServletException;  
    import javax.servlet.http.HttpServlet;  
    import javax.servlet.http.HttpServletRequest;  
    import javax.servlet.http.HttpServletResponse;  
      
    public class JobsServlet extends HttpServlet {  
      private Timer helloWorldJobTimer = null;  
      private TimerManager tm = null;  
      
      public void init(ServletConfig config) throws ServletException {  
        super.init(config);  
        System.out.println("InitJobsServlet is initialized ");  
      
        try {  
          InitialContext ic = new InitialContext();  
          tm = (TimerManager)ic.lookup("java:comp/env/tm/TimerManager");  
          helloWorldJobTimer =  
              tm.schedule(new HelloWorldJob(), new Date(), 5000); //5 seconds  
        } catch (Exception ne) {  
          ne.printStackTrace();  
        }  
      }  
      
      public void service(HttpServletRequest req,  
                HttpServletResponse res) throws IOException {  
        res.setContentType("text/html");  
        PrintWriter out = res.getWriter();  
        out.println("<h4>JobsServlet is working!</h4>");  
        String cmd = req.getParameter("cmd");  
        if (cmd != null && cmd.equals("cancel") && helloWorldJobTimer != null) {  
          helloWorldJobTimer.cancel();  
          helloWorldJobTimer = null;  
        }  
        if (cmd != null && cmd.equals("start") && helloWorldJobTimer == null) {  
          helloWorldJobTimer =  
              tm.schedule(new HelloWorldJob(), new Date(), 5000);  
        }  
        if (helloWorldJobTimer != null) {  
          out.println("<h6>HelloWorldJob started</h6>");  
        } else {  
          out.println("<h6>HelloWorldJob calceled</h6>");  
        }  
      }  
    }  
   

5. В web.xml прописать ссылку на ресурс (т.е. на наш TimerManager):

    <?xml version = '1.0' encoding = 'UTF-8'?>  
    <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"  
         version="2.5" xmlns="http://java.sun.com/xml/ns/javaee">  
     <servlet>  
      <servlet-name>JobsServlet</servlet-name>  
      <servlet-class>com.blogspot.stan1slav.sample.JobsServlet</servlet-class>  
      <load-on-startup>100</load-on-startup>  
     </servlet>  
     <servlet-mapping>  
      <servlet-name>JobsServlet</servlet-name>  
      <url-pattern>/jobsservlet</url-pattern>  
     </servlet-mapping>  
     <resource-ref>  
      <res-ref-name>tm/TimerManager</res-ref-name>  
      <res-type>commonj.timers.TimerManager</res-type>  
      <res-auth>Container</res-auth>  
      <res-sharing-scope>Unshareable</res-sharing-scope>  
     </resource-ref>
    </web-app>  
   

6. Деплоим на сервер (как WAR-архив) и проверяем работоспособность (смотрим в out-лог сервера)
1. Задание выполняется после деплоя:
2. С использованием сервлета остановим выполнение задания (для этого при вызове добавляем ?cmd=cancel):
   
3. В логе появилась запись об остановке (отмене) задания:
   
4. С использованием сервлета стартуем снова задание (для этого при вызове добавляем ?cmd=start):
   
5. В логе появились записи о выполнении задания:
   

Полезная информация:

• JavaDoc-и;
• Timer and Work Manager API (CommonJ) Programmer's Guide for Oracle WebLogic Server;
• архив приложения описанного в данной статье.

Oracle SOA: управление композитами через WLST

Все команды выполняются из wlst.cmd или wlst.sh находящегося в SOA_HOME, у меня например это:

 C:\Apps\Oracle\Weblogic\10.3.6\Oracle_SOA1\common\bin\wlst.cmd  

• Просмотр развёрнутых композитов и их статусов:

  wls:/offline> 
   sca_listDeployedComposites('bpm-dev.mycompany.com',
                              '8001',
                              'weblogic',
                              'welcome1') 
  

  где weblogic - логин административного пользователя;
  welcome1 - пароль административного пользователя;
  bpm-dev.mycompany.com - хост SOA-сервера;
  8001 - порт SOA-сервера.
  
  Пример результата:

   Following 4 composites are currently deployed to the platform:  
   1. AsyncProc[1.0], partition=default, mode=active, state=on, isDefault=true, deployedTime=2013-07-25T11:26:03.309+04:00  
   2. SimpleApproval[1.0], partition=default, mode=active, state=on, isDefault=true, deployedTime=2012-10-17T18:55:11.333+04:00  
   3. SimpleHT[1.0], partition=default, mode=active, state=on, isDefault=true, deployedTime=2012-12-21T13:23:24.345+04:00  
   4. AgreementApproversService[1.0], partition=prod, mode=active, state=on, isDefault=true, deployedTime=2013-02-22T17:51:30.971+04:00  
  

• Старт композита:

  wls:/offline> 
   sca_startComposite('bpm-dev.mycompany.com',
                      '8001',
                      'weblogic',
                      'welcome1',
                      'AsyncProc',
                      '1.0',
                      partition='default') 
  

  где AsyncProc - имя композита;
  1.0 - версия композита;
  default - раздел.
  
  
• Стоп композита:

  wls:/offline> 
   sca_stopComposite('bpm-dev.mycompany.com',
                     '8001',
                     'weblogic',
                     'welcome1',
                     'AsyncProc',
                     '1.0',
                     partition='default') 
  

• Активация композита:

  wls:/offline> 
   sca_activateComposite('bpm-dev.mycompany.com',
                         '8001',
                         'weblogic',
                         'welcome1',
                         'AsyncProc',
                         '1.0',
                         partition='default') 
  

• Деактивация композита:

  wls:/offline> 
   sca_retireComposite('bpm-dev.mycompany.com',
                       '8001',
                       'weblogic',
                       'welcome1',
                       'AsyncProc',
                       '1.0',
                       partition='default') 
  

Формат полей типа Date в Oracle SQL Developer

Проблема:
При выборке и экспорте (в формате insert) данных формат колонки типа Date:

 15-NOV-11  

Вариант решения:

1. В SQL Developer перейти в меню "Tools"->"Preferences"
2. В окне Preferences выбрать "Database"->"NLS" в левой панеле
3. В списке NLS параметров найти "Date Format" и для него ввести следующее значение

   DD-MM-YYYY HH24:MI:SS

   
4. Нажать "OK" и пользоваться.

Кратко о архитектурной модели "4+1"

Достаточно важную роль в развитии подходов к описанию архитектуры предприятия сыграла модель "4+1" (точнее "The 4+1 View Model of Architecture"), которая была предложена Филиппом Кручтеном (Philippe Kruchten) из компании Rational еще в 1995 году. Данная методика позиционировалась, прежде всего, как способ описания архитектуры систем, основанных на активном использовании программного обеспечения, хотя идеи, заложенные в эту методику, могут использоваться и в более широком контексте архитектуры предприятия – что, собственно, и произошло на практике.

Модель предлагает простой и понятный способ описания архитектуры сложных систем, который состоит в использовании пяти различных категорий или представлений (views). Четырьмя основными представлениями в этой методике являются следующие:

• Логическое представление. Является объектной моделью проектирования (в том случае, если используется объектно-ориентированная модель проектирования).
• Процессное представление. Описывает вопросы параллельного исполнения и синхронизации процессов.
• Физическое представление. Описывает размещение программных компонент системы на аппаратных платформах и аспекты, связанные с физическим расположением системы.
• Представление уровня разработки. Описывает статическую организацию программной системы в среде разработки.

Описание архитектуры системы на основе этих четырех представлений иллюстрируется и проходит проверку путем использования еще одного представления, которое содержит некоторые отобранные сценарии использования (use cases). Архитектура системы во многом определяется этими сценариями. Каждое представление отражает специфические аспекты моделируемой системы.

Основной целью логического представления в данной методике является описание функциональных требований: что система должна выполнять в терминах конечных пользователей. Для этого представления используются различные абстрактные конструкции, такие как объекты и классы объектов. Для их иллюстрирования могут применяться диаграммы классов (в нотации языка UML) либо, например, диаграммы "сущность-связь", если в разработке приложения доминируют данные.

Процессное представление учитывает некоторые нефункциональные требования (NFR) к системе, включая производительность и доступность. С помощью этого представления рассматриваются такие аспекты, как одновременное выполнение и распределение процессов, интеграция системы, устойчивость к сбоям, а также то, как основные объекты абстракции, рассмотренные на уровне логического представления, соответствуют архитектуре процессов. Архитектура процессов может быть представлена на различных уровнях абстракции. На самом высоком уровне система рассматривается как набор независимо выполняемых сетей взаимодействующих между собой программ. На более низких уровнях рассматриваются процессы и задачи.

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

Физическое представление, в основном, рассматривает нефункциональные требования, такие как доступность, надежность, устойчивость, производительность, масштабируемость. Этот уровень описывает распределение различных элементов – сетей, процессов, задач и объектов – по различным узлам (элементам аппаратного обеспечения, объединенным в сеть).

Сценарии объединяют все представления вместе. Сценарии использования описываются как последовательность взаимодействия объектов и процессов. Они отражают наиболее важные требования, которым должна удовлетворять система. Это представление в каком-то смысле является избыточным и пересекается с четырьмя предыдущими, но оно важно по следующим причинам:

• Сценарии использования позволяют идентифицировать элементы архитектуры, которые требуются для эффективно работающей системы.
• С помощью сценариев можно выполнять проверку и иллюстрацию того, что архитектура является работоспособной и полной. Это также является основой для проведения тестирования архитектурного прототипа.

Ссылки для более подробного изучения данной модели здесь.

Источник: http://www.intuit.ru/department/itmngt/entarc/9/entarc_9.html

Oracle SOA Poster-BPEL Process 2.0

Коллеги из EAIESB опубликовали BPEL 2.0 Poster (оригинал здесь):

Кратко о методике RM-ODP

Архитектурная методика RM-ODP (Reference Model of Open Distributed Processing), на которую также ссылаются как на ISO/IEC 10746, была принята международной организацией стандартизации ISO в качестве стандартов в четырех частях X.901, X.902, X.903 и X.904.

В основе этой модели лежат принципы анализа систем в разрезе нескольких представлений и объектно-ориентированная парадигма создания систем. Заметим, что это методика – одна из наиболее полных с точки зрения набора различных представлений, которые могут применяться для описания архитектуры системы, и она используется, в частности, при описании архитектуры электронного правительства Германии.

Важными для этой модели понятиями являются представления, функции и средства обеспечения прозрачности распространения (distribution transparencies).

В целом модель определяет пять представлений (viewpoints):

• Корпоративное представление (enterprise viewpoint) описывает цели, масштабы (границы), процессы и политики, связанные с созданием прикладных систем.
• Информационное представление (information viewpoint) описывает характеристики и семантику обрабатываемых данных, т.е. модель данных.
• Вычислительное представление (computational viewpoint) описывает декомпозицию прикладной системы на функциональные модули и интерфейсы взаимодействия.
• Проектировочное представление (engineering viewpoint) определяет распределение отдельных элементов системы по физическим ресурсам и связи между ними.
• Технологическое представление (technology viewpoint) описывает технологии, используемые для создания прикладных систем.

Кроме представлений, RM-ODP содержит так называемые функции.

Всего выделено четыре функции:

• управление;
• координация; 
• репозиторий;
• безопасность.

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

Функция управления определяет то, как системой управляют, начиная с уровня узлов (серверов) и вплоть до объектов, выполняемых на этих узлах.

Функция координации детализирует вопросы взаимосвязи событий в системе.

Функция репозитория описывает, как информация организована и хранится.

RM-ODP выделяет восемь так называемых средств обеспечения прозрачности распространения: прозрачность доступа, сбоев, местоположения, миграции, сохранения, перераспределения, репликации и транзакций.

Ссылки для более подробного изучения данной методике здесь.

Источник: http://www.intuit.ru/department/itmngt/entarc/9/entarc_9.html