О начале обучения |
Реализация. Создание процесса Request External Reports
Корреляция AssessorID и AssessorURL в системе работы c процессом
Мы используем стандартный шаблон данных для интеграции процессов, поэтому нам нужно восстановить связь с assessorURL выбранного оценщика, применяя значение assessorID, которое возвращает система бизнес-правил. Выполните следующие действия:
- Добавьте Java-фрагмент, называющийся AssessorURL.
- Вставьте фрагмент AssessorURL в поток RequestExternalReports, как показано на рис. 10.29.
- Создайте глобальную переменную с именем SelectedAssessor.
- Создайте WSDL-сообщение SelectedAssessor, состоящее из двух частей:
- AssessorID,
- AssessorURL.
Выполните приведенные ниже инструкции, чтобы добавить AssessorID и AssessorURL в файл RequestExternalReportsInterface.wsdl (можно также создать новый WSDL-файл).
- Откройте файл RequestExternalReportsInterface.wsdl в графическом WSDL-редакторе.
- В области Messages (Сообщения) щелкните правой кнопкой мыши и выберите пункт меню Add Child (Добавить потомок) Message (Сообщение). Введите имя SelectedAssessor.
- Щелкните правой кнопкой мыши по SelectedAssessor и выберите пункт меню Add Child (Добавить потомок) Part (Часть). Укажите имя AssessorID и введите xsd:int.
- Аналогичным образом добавьте часть AssessorURL с содержимым xsd:String.
- Импортирование сообщения SelectedAssessor в службу TransformerRequestAssessment и установление связи от SelectedAssessor.assessorURL к actionAssessmentRequest. assessor.assessorURL.
- Написание кода Java-фрагмента AssessorURL.
(Задачи пп. 5, 6 описываются в последующих разделах более подробно.)
Добавление сообщения SelectedAssessor в службу TransformerRequestAssessment
Теперь, когда у нас есть assessorURL для выбранного оценщика, нам нужно связать его с полем assessorURL в сообщении-запросе, посылаемом в операцию RequestAssessment. Нам нужно создать трансформирующую агрегирующую службу, подобную ToRequestAvailability.
- Назовите службу ToRequestAssessment.
- В переменной Response укажите RequestAssessmentInputCriterionVariable.
- В поле имени файла введите AggregateRequestAssessment.
- Агрегируемые входные переменные следующие:
- InputCriterionVariable,
- SelectAssessorOutputCriterionVariable,
- SelectedAssessor.
Вам нужно создать эти входные переменные и указать тип, соответствующий сообщению SelectedAssessor, созданному на предыдущем шаге.
- В качестве имени файла трансформирующей службы укажите TransformRequestAssessment. Выполните описанные ранее шаги по заданию имени для партнерской ссылки, действия и т. п.
- Приведите в порядок схему потока, когда закончите выполнения указанных шагов, чтобы она выглядела так, как показано на рис. 10.30.
На этом создание связей должно быть завершено. Теперь вам нужно задать значение AssessorURL в Java-фрагменте.
Создание Java-фрагмента AssessorURL
В этом фрагменте Java нам нужно получить список подходящих оценщиков, проверенных системой бизнес-правил, и идентифицировать оценщика, которого выбрала система правил. В этом списке оценщики представлены структурой данных, в которую входит assessorURL. Обнаружив выбранного оценщика, мы создаем глобальную переменную SelectAssessor для передачи assessorURL этого оценщика в трансформирующую службу ToRequestAssessor, которая вводит assessorURL в сообщение actionAssessment Request. Готовый фрагмент Java показан в примере 10.4. Мы рассмотрим этапы создания этого фрагмента с помощью функции автозаполнения в WebSphere Studio Application Development Integration Edition.
- Выберите только что созданный фрагмент Java (Java Snippet) с именем AssessorURL и откройте закладку Implementation (Реализация) редактора свойств.
- Вставьте инструкцию, которая объявляет, что мы будем обновлять ту часть глобальной переменной SelectedAssessor, которая относится к assessorURL.
Щелкните правой кнопкой мыши и выберите пункт меню Update Variable (Обновить переменную) Part (Часть) и выберите assessorURL в сообщении SelectedAssessor (пример 10.1).
SelectedAssessorMessage SelectedAssessor = getSelectedAssessor(true); java.lang.String assessorURL = SelectedAssessor.getAssessorURL(); <focus> SelectedAssessor.setAssessorURL(assessorURL);
Пример 10.1. Java-фрагмент AssessorURL, строки из мастера Update Variable (Обновление переменной) - В области focus объявите локальную переменную Assessor assessorList [], в которой
будет храниться список оценщиков из сообщения - ответа операции IdentifyAssessors.
Заполните объявление, получив список потенциальных оценщиков из переменной IdentifyAssessorsOutputCriteriaVariable:
- щелкните правой кнопкой мыши и выберите пункт меню Get variable (Получить переменную) Part... (Часть) и выберите IdentifyAssessorsOutputCriteriaVariable ;
- используйте автозаполнение строки, нажав CTRL_Пробел getParameters и т. д.
Assessor assessorList [] = getIdentifyAssessorsOutputCriteriaVariable().getParameters(). getRequestListAssessorsReturn().getAssessors();
Пример 10.2. Java-фрагмент AssessorURL, строки из мастера Get Variable (Получение переменной)Совет. Если вы начнете вводить Assess… и используете автозаполнение для ввода класса Assessor, будет ли это работать? Если нет, значит, в файле исходного кода Java, содержащем данный фрагмент, отсутствует инструкция импорта itso.lgi.assessormgmt. Itso.lgi.assessormgmt представляет собой целевое пространство имен для WSDL-сообщений AssessorManagement. WebSphere Studio Application Development Integration Edition создает Java- пакет с именем, совпадающим с названием этого пространства имен, в который помещаются все Java-классы, реализующие функции get и set для частей сообщения. Поищите в Service Navigator этот пакет и входящие в него классы. Если вы найдете их и они будут находиться в проекте ITSOLGI, то вам нужно заставить WebSphere Studio Application Development Integration Edition включить в код инструкцию импорта для этого пакета. Если первый метод не работает, попробуйте такие варианты:- Щелкните правой кнопкой мыши и выберите пункт меню Source (Исходный код) Add Import (Добавить импорт) и выберите itso.lgi.assessormgmt.
- Введите объявление старым способом, нажмите Save (Сохранить), щелкните правой кнопкой мыши, выберите пункт меню Source (Исходный код) > Organize Imports (Организовать инструкции импорта) > Save (Сохранить). (Этот вариант применяется, если не сработает первый вариант).
- Добавьте строку кода, которая получит идентификатор выбранного оценщика из
выходной переменной системы бизнес-правил – selectedAssessorOutputCriteriaVariable.
Для хранения этого значения нам потребуется создать новую локальную переменную:а затем нужно инициализировать ее, используя автозаполнение:
Integer selectedAssessorID
= getSelectAssessorOutputCriteriaVariable().getParameters() .getSelectAssessorReturn().getAssessorID();
- Создайте цикл для поиска выбранного оценщика и сохранения assessorURL в глобальной
переменной. Мы использовали для создания этого цикла мастер шаблонов кода:
- Введите for и нажмите CTRL_Пробел без пробела.
- Выберите пункт for – iterate over an array with temporary variable (перебор значений массива с использованием временной переменной). Будет сгенерирован код, показанный в примере 10.3.
for (int i = 0; i < assessorList.length; i++) { Assessor assessor = assessorList[i]; <focus> }
Пример 10.3. Генерация цикла for с временной переменной
- В области focus мы вставляем инструкцию if для проверки совпадения assessorID:
- Введите if и используйте автозаполнение для создания простого шаблона инструкции if:
if (условие) { }
- С помощью автозаполнения замените условие следующим выражением:
assessor.getAssessorID() == selectedAssessorID
- Введите if и используйте автозаполнение для создания простого шаблона инструкции if:
- В инструкции if остановите сохранение assessorURL в глобальной переменной:
- с помощью автозаполнения создайте локальное выражение присваивания:
assessorURL = assessor.getAssessorURL();
- щелкните правой кнопкой мыши, выберите пункт меню Set Variable (Задать
переменную) Part (Часть), выберите AssessorURL из сообщения
SelectedAssessor, чтобы сгенерировать такой код:
getSelectedAssessor(true).setAssessorURL(<focus>);
- замените focus на локальную переменную assessorURL.
- с помощью автозаполнения создайте локальное выражение присваивания:
Готовый фрагмент Java должен сохраниться без ошибок. Полный исходный код показан в примере 10.4.
// мы будем обновлять глобальную переменную SelectedAssessor assessorURL SelectedAssessorMessage SelectedAssessor = getSelectedAssessor(true); java.lang.String assessorURL = SelectedAssessor.getAssessorURL(); // Получить список оценщиков, согласившихся на выполнение оценки Assessor assessorList[] = getIdentifyAssessorsOutputCriteriaVariable() .getParameters() .getRequestListAssessorsReturn() .getAssessors(); // Получить assessorID выбранного оценщика Integer selectedAssessorID = getSelectAssessorOutputCriteriaVariable() .getParameters() .getSelectAssessorReturn() .getAssessorID(); // Перебор списка согласившихся оценщиков, чтобы найти выбранного for (int i = 0; i < assessorList.length; i++) { SelectedAssessor.setAssessorURL(assessorList[i].getAssessorURL()); SelectedAssessor.setAssessorID((assessorList[i].getAssessorID()).intValue()); if (assessorList[i].getAssessorID() == selectedAssessorID) { break; // выйти из цикла на нужном оценщике или на последнем в списке }/ / Обновить сообщение SelectedAssessor в глобальном контейнере setSelectedAssessor(SelectedAssessor);Пример 10.4. Полный фрагмент Java AssessorURL
Добавление SelectedAssessor в RequestAssessmentTransformer
Теперь, когда у нас есть assessorURL для выбранного оценщика, нам нужно связать его с полем assessorURL в сообщении-запросе, посылаемом в операцию RequestAssessment.
- Откройте файл RequestAssessmentTransformer.wsdl в редакторе трансформаций.
Это можно сделать несколькими способами. Вот один из них:
- в Services Explorer щелкните правой кнопкой мыши по проекту ITSOLGI и выберите пункт меню Claim.TOBE.RequestExternalReports RequestAvailabilityTransformer.wsdl ;
- Open With (Открыть с помощью) Transformer Editor (Редактор трансформаций).
- Добавьте новое сообщение SelectAssessors в число входящих сообщений:
- при открытом в редакторе трансформаций файле RequestAssessmentTransformer.wsdl, выберите пункт Transformer Editor (Редактор трансформаций) в главном меню, выберите пункт Add Input Message (Добавить входящее сообщение), укажите файл ProcessMessages.wsdl в директории ITSOLGI\Services\ITSOLGI Architecture;
- укажите сообщение Selected Assessor.
- Свяжите часть Selected Assessor сообщения SelectedAssessor с полем assessorURL сообщения actionAssessorRequest.
Чтобы пока завершить создание связей, свяжите поле makeOfCar с полями makeOfCar и registration, чтобы все поля были с чем-то связаны.
Связывание операции StoreReport
Для данной связи мы не можем использовать простую операцию назначения, поскольку форматы входящего и исходящего сообщений не совпадают полностью. Более простым механизмом связывания является использование трансформирующей службы.
- Добавьте новую трансформирующую службу с именем StoreReportTransform:
- укажите в поле Operation Name (Имя действия) значение toStoreReport;
- в поле входного сообщения укажите сообщение receiveAssessorReportRequest из файла AssessorReport(9).wsdl;
- в поле выходного сообщения укажите сообщение StoreAssessorReportURLRequest из файла StoreAssessorReport(10).wsdl;
- свяжите поля и сохраните службу StoreReportTransform.
- Перетащите службу StoreReportTransform в поток, свяжите ее с потоком и назовите так, как показано на рис. 10.31.
RequestExternalReport Reply
Выполните следующие шаги:
- Мы используем еще одну трансформирующую службу для выполнения агрегации полей из следующих сообщений-ответов:
- PolicyID из RequestExternalReportsRequest;
- assCompDate из StoreAssessorReportURLRequest;
- claimID и reportLocation из StoreAssessorReportURL Response.
- Назовите новую агрегацию AggregateRequestExternalReportsReply, трансформирующую службу – TransformRequestExternalReportsReply, действие – ToRequestExternalReportReply.
- Создайте агрегирующую трансформирующую службу, как описывалось выше (рис. 10.32).
Заключение
Это была большая задача, но мы установили базовые связи данных между службами и задачами. Нужно еще провести тонкую настройку управляющих структур и выполняемых вручную задач, но пока, прежде чем обращаться к управляющим структурам, мы вернемся к интеграции других аспектов служб с потоком.
10.4.7 Конфигурирование потока для ожидания ответа от оценщиков
Существует три задачи, которые ожидают ответа от оценщиков. Нам нужно настроить процесс на ожидание этих сообщений6В общем дизайне взаимодействий предусмотрены множество последовательно запускаемых процессов, которые, как мы предполагаем, ведут взаимодействие способом, определенным бизнес-аналитиком. Это допущение является критическим для работоспособности нашей системы. Если сообщения для экземпляра процесса могли бы приходить в ином порядке, нам пришлось бы иметь дело с непоследовательными сообщениями. При такой реализации, вероятно, более подходящей была бы BPEL-операция Pick, а не Receive., и обеспечить прием сообщений, посылаемых в Automated Assessor, нужным экземпляром процесса.
В Business Process Choreographer есть механизм сохранения идентификационной информации в так называемом корреляционном наборе (correlation set). В корреляционных наборах хранятся псевдонимы, необходимые для связывания полей из разных сообщений с переменными, используемыми для корреляции. Этот механизм более гибок, чем тот, который требует, чтобы все сообщения имели одинаковое поле ключа. Последний вариант непрактичен, если представить, что формат сообщений может определять бизнес-партнер в другой организации или что есть сообщения, форматы которых определяются множеством различных стандартов.
Если работа длительно функционирующего экземпляра процесса приостанавливается, то Process Choreographer сохраняет данные о состоянии этого экземпляра в долговременном хранилище. Когда от WebSphere BI Message Broker приходит сообщение-ответ, Process Choreographer проверяет корреляционные наборы и снова запускает нужный экземпляр процесса.
Для добавления корреляционных наборов выполните следующие шаги:
- Нажмите на значок + на панели Correlation Sets (Корреляционные наборы) ( рис. 10.33), чтобы добавить новый корреляционный набор. Назовите новый корреляционный набор Claims.
- Выделите набор Claims и перейдите на закладку Properties (Свойства) окна Detail (Подробно). Нажмите кнопку New (Новое). Откроется окно Create message property (Создание свойства сообщения).
- Введите в поле имени свойства значение claimID, а в раскрывающемся списке выберите тип xsd:int.
- Нажмите кнопку New (Новый) в верхней части списка псевдонимов. Нажмите кнопку Browse (Обзор) в окне Create property alias (Создание псевдонима свойства) и выберите элемент ITSOLGI services (службы) ITSOLGI Architecture WSDL Proxy(1).wsdl. Выберите сообщение RequestExternalReports_requestAssessorMessage, нажмите OK. Раскройте элемент Part: Container: MessageContainer: requestAssessor claimID : Int OK.
- Повторяйте шаг 4, чтобы добавить псевдонимы, приведенные в табл. 10.4.
- Щелкните по операции RequestExternalReports Receive в редакторе BPEL и перейдите на закладку Correlation (корреляция) в окне Detail (Подробно).
- Нажмите кнопку Add (Добавить) и измените значение в поле Initiation (Инициация) на Yes ( рис. 10.34).
Повторите шаги с 1 по 7, чтобы присвоить корреляционные наборы принимающим операциям, указанным в табл. 10.5.