Processing an Order in a Purchase Order System

Create the POService BPEL Process

The next step in the Purchase Order sample project is to Create the POService BPEL Process.

The POService.bpel, creates the purchase order response. The BPEL Designer's Design view and the BPEL Mapper are used to create the BPEL process.

ProcedureTo create the POService BPEL process

  1. From the Project window, right-click the HTTP-SOAP-PO-BPEL project and select New -> BPEL Process from the pop-up menu.

  2. From the New BPEL Process wizard, enter POService for the File Name.

  3. Click Finish.

    The POService.bpel file is added to the Projects window, and the BPEL Designer opens containing the new BPEL process.

ProcedureTo Create the POService business process using the BPEL Designer

  1. From the Project window, right-click the HTTP-SOAP-PO-BPEL project and select New -> BPEL Process from the pop-up menu.

  2. From the New BPEL Process wizard, enter POService for the File Name.

  3. Click Finish.

    The POService.bpel file is added to the Projects window, and the BPEL Designer opens containing the new BPEL process.

  4. Create a new Partner Link by dragging the POService.wsdl file from the Projects window to the left side of BPEL Designer canvas.

    The IDE provides clues to show where to place the POService.wsdl file.

    By placing the file on the left side, you create the partnerlink with the roll assigned as “My Role.” This can be verified from the Partnerlink1 Properties Editor.

  5. Create another Partner Link, in “Partner Role”, by dragging the InventoryService.wsdl file from the Projects window to the right side of the BPEL Designer canvas.

    By placing this file on the right side of the BPEL Designer canvas, you create a partnerlink with the roll assigned as “Partner Roll.” This can be verified from the Partnerlink2 Properties Editor.

    Click OK to close the PartnerLink2 Property Editor. The PartnerLink2 partner link is added to the right side of the BPEL Designer canvas.

    Graphic displays the Inventory Service process flow as
it is being assembled in the BPEL Designer. Described in context.
  6. Add a Receive element to the process flow. To do this, drag-and-drop the Receive element from the BPEL Designer Palette to the link between the Process Start and Process End in the designer's process flow. The Receive element is added to the process flow.

  7. Add a Reply element to the process flow between the Receive1 element and the Process End. The Reply1 web service is added to the process flow.

  8. Add an Invoke element to the process flow between the Receive1 element and the Reply1 element. The Invoke1 web service is added to the process flow.

  9. Add an Assign element to the process flow between the Receive1 element and the Invoke1 element. The Assign1 web service is added to the process flow.

  10. Add an If element to the process flow between the Invoke1 element and the Reply1 element. The If1 web service is added to the process flow.

    Graphic displays the Inventory Service process flow as
it is being assembled in the BPEL Designer. Described in context.
  11. Set the Receive1 element Partner Link to PartnerLink1 as follows:

    1. From the BPEL Designer's Design view, select the Receive1 element and click the Receive1 Edit button. The Receive1 [Receive] - Property Editor appears.

    2. From the property editor, select PartnerLink1 as the Partner Link value.

    3. Click the Input Variable field's Create button. The New Input Variable dialog box appears. Click OK to create the new input variable.

    4. Click OK to close the property editor. A partner link is now displayed from the PartnerLink1 and the Receive1 element in the Design view.

  12. Set the Reply1 element Partner Link to PartnerLink1 as follows:

    1. From the BPEL Designer's Design view, select the Reply1 element and click the Reply1 Edit button. The Reply1 [Reply] - Property Editor appears.

    2. From the property editor, select PartnerLink1 as the Partner Link value.

    3. Click the Output Variable field's Create button. The New Output Variable dialog box appears. Click OK to create the new output variable.

    4. Click OK. A partner link is now displayed between the PartnerLink1 and the Reply1 element in the Design view.

  13. Set the Invoke1 element Partner Link to PartnerLink2 as follows:

    1. From the BPEL Designer's Design view, select the Invoke1 element and click the Invoke1 Edit button. The Invoke1 [Invoke] - Property Editor appears.

    2. From the property editor, select PartnerLink2 as the Partner Link value.

    3. Click the Input Variable field's Create button. The New Input Variable dialog box appears. Click OK to create the new input variable.

    4. From the property editor, click the Output Variable field's Create button. The New Output Variable dialog box appears. Click OK to create the new output variable.

    5. Click OK. A partner link is now displayed between the PartnerLink2 and the Invoke1 element in the Design view.

      Graphic displays the Inventory Service process flow as
it is being assembled in the BPEL Designer. Described in context.

ProcedureTo specify the business logic for the POService business process

  1. Specify the business logic for the Assign1 element from the BPEL Mapper as follows:

    1. Select the Assign1 element in the BPEL Designer's Design view, and click the Designer's Mapper button to open the BPEL Mapper.

      The Assign1 activity is displayed in the BPEL Mapper window.

    2. From the BPEL Mapper, expand the HandlePurchaseOrderIn node in the Output pane, and the IsInventoryAvailableIn nodes in the Input pane.

    3. Map purchaseOrder, under Variables -> HandlePurchaseOrderIn in the Output pane of the BPEL Mapper, to purchaseOrder, under Variables -> IsInventoryAvailableIn in the Input pane of the BPEL Mapper.

      Graphic shows the BPEL Mapper as described in context.
  2. Specify the business logic for the If1 element from the BPEL Mapper as follows:

    1. Select the If1 element in the BPEL Designer's Design view, and click the Designer's Mapper button to open the BPEL Mapper.

      The If1 activity is displayed in the BPEL Mapper window.

    2. Map InventoryStatus, under Variables -> IsInventoryAvailableOut -> InventoryStatus in the Output pane of the BPEL Mapper, to Boolean Condition under If1 in the Input pane of the BPEL Mapper.

      Graphic shows the BPEL Mapper as described in context.
  3. Add an Assign element to the If1 element in the process flow. To do this, drag-and-drop the Assign activity from the BPEL Designer Palette to the link between the beginning and ending node of the If1 element. The Assign2 element is added to the InventoryService process flow.

  4. Specify the business logic for the Assign2 element from the BPEL Mapper as follows:

    1. Select the Assign2 element in the BPEL Designer's Design view, and click the Designer's Mapper button to open the BPEL Mapper.

      The Assign2 activity is displayed in the BPEL Mapper window.

    2. Map orderId, under Variables -> HandlePurchaseOrderIn -> purchaseOrder in the Output pane of the BPEL Mapper, to orderId, under Variables -> HandlePurchaseOrderOut -> receipt in the Input pane of the BPEL Mapper.

    3. Map customerId, under Variables -> HandlePurchaseOrderIn -> purchaseOrder in the Output pane of the BPEL Mapper, to customerId, under Variables -> HandlePurchaseOrderOut -> receipt in the Input pane of the BPEL Mapper.

    4. Map orderDescription, under Variables -> HandlePurchaseOrderIn -> purchaseOrder in the Output pane of the BPEL Mapper, to orderDescription, under Variables -> HandlePurchaseOrderOut -> receipt in the Input pane of the BPEL Mapper.

    5. From the BPEL Mapper toolbar's Number menu, select Number Literal and drag Number Literal to the center pane of the Mapper. A Number Literal function box appears in the Mapping pane. Enter 44.59 as the Number Literal value.

    6. Map the outbound 44.59 node of the Number Literal function box, to price, under Variables -> HandlePurchaseOrderOut -> receipt in the right pane of the BPEL Mapper.

      Graphic shows the BPEL Mapper as described in context.
  5. Add an Assign element to the Else of the If1 element in the process flow. To do this, drag-and-drop the Assign activity from the BPEL Designer Palette to the center of the Else branch of the If1 element.

    The Assign3 element is added to the InventoryService process flow.

    Graphic shows the BPEL Designer as described in context.
  6. Specify the business logic for the Assign3 element from the BPEL Mapper as follows:

    1. Select the Assign3 element in the BPEL Designer's Design view, and click the Designer's Mapper button to open the BPEL Mapper.

      The Assign3 activity is displayed in the BPEL Mapper window.

    2. Map orderId, under Variables -> HandlePurchaseOrderIn -> purchaseOrder in the Output pane of the BPEL Mapper, to orderId, under Variables -> HandlePurchaseOrderOut -> receipt in the Input pane of the BPEL Mapper.

    3. Map customerId, under Variables -> HandlePurchaseOrderIn -> purchaseOrder in the Output pane of the BPEL Mapper, to customerId, under Variables -> HandlePurchaseOrderOut -> receipt in the Input pane of the BPEL Mapper.

    4. Map inventoryStatusMessage, under Variables -> IsInventoryAvailableOut -> inventoryStatus in the Output pane of the BPEL Mapper, to orderDescription, under Variables -> HandlePurchaseOrderOut -> receipt in the Input pane of the BPEL Mapper.

      Graphic shows the BPEL Mapper as described in context.
  7. Validate your new BPEL process as follows:

    1. From the BPEL Designer's toolbar, click the Validate XML button. Validation of the BPEL process is performed. The results of the validation are displayed in the NetBeans IDE Output window.

    2. If the validation process finds any errors, the Output window lists each error with a link to the point of error in the BPEL Designer. Double-click the hyperlink and refer to the error message for information on how to resolve the error.

    3. Once you have resolved any errors, run validation again to ensure that there are no remaining errors or warnings.

  8. Click Save All to save your changes.