Docstoc

BeeSphere SOA Web Management Console User Guide

Document Sample
BeeSphere SOA Web Management Console User Guide Powered By Docstoc
					                               SOA Web Management Console-7.5.2-User Guide, 1.0




BeeSphere SOA Web Management Console


User Guide
BeeSphere
Jul 20-2010


Abstract
This document provides an introduction to BeeSphere SOA Web Management
Console’s features and how they can be used for developing and deploying Smart
Services. We will discover how to:
    •   Create integration services using configuration based tools.
    •   Create custom services using the web development environment and
        modeling tools.
    •   Deploy Smart Web Services.




BeeSphere, Inc.
http://www.beesphere.com                                     UG10401-1001
                                         1
                                                SOA Web Management Console-7.5.2-User Guide, 1.0




Content
Introduction .................................................................................................................... 4

Section 1: Working with Integration services ................................................................... 5
  1) Workspace Overview ............................................................................................... 5
  2) Creating Integration Services ................................................................................... 8
  3) Documenting Integration Services ........................................................................... 9
  4) Adding Service Resources ..................................................................................... 10
  5) Defining Service Inputs/Outputs ............................................................................. 11
     4.1 Defining Service Inputs and Outputs Data formats ........................................... 14
       4.1.1 CSV/Text Data format ................................................................................ 14
       4.1.2 Excel Settings............................................................................................ 17
       4.1.3 XML .......................................................................................................... 20
       4.1.4 EDI Standards (UN/Edifact, X12 and HL7) ................................................. 25
       4.1.5 Tables and Queries (BeeSphere Data Center) ........................................... 26
       4.1.6 JSON ........................................................................................................ 27
     4.2 Defining Service Inputs and Outputs Data Structure ......................................... 30
       4.2.1 Working with Schema Editor ...................................................................... 30
       4.2.2 Working with Map Editor ............................................................................ 35
     4.3 Defining Output Sending Protocols .................................................................. 38
       4.3.1 FTP Settings.............................................................................................. 38
       4.3.2 E-Mail Settings .......................................................................................... 40
       4.3.3 AS2 Settings.............................................................................................. 42
       4.3.4 Http Settings .............................................................................................. 46
  6) Defining Data Transformation Logic ....................................................................... 49
     5.1 MTM Environment ........................................................................................... 49
     5.2 Mapping Inputs to Outputs ............................................................................... 49
       5.2.1 Creating Iterations ..................................................................................... 50
       5.2.2 Mapping Inputs to Outputs ......................................................................... 51
       5.2.2 Setting a value for an Output Element ........................................................ 52
     5.3 Using Expression Editor ................................................................................... 52
     The expression editor allows creation of custom expressions based on XSL, XPath
       and XQuery standards........................................................................................ 52
     5.3 XSL View ......................................................................................................... 54
  7) Securing Services.................................................................................................. 55
  8) Publishing Services ............................................................................................... 58
  9) Testing Integration Services .................................................................................. 59
     8.1- Before Executing the Service .......................................................................... 61

BeeSphere, Inc.
http://www.beesphere.com                                                                       UG10401-1001
                                                                2
                                              SOA Web Management Console-7.5.2-User Guide, 1.0

     8.2- Before/After Processing an Input/Output ......................................................... 62

Chapter 2: Working with Custom services .................................................................... 64
 1) Section 1: Workspace Overview ............................................................................ 64
 2) Creating Projects ................................................................................................... 67
    2.1 Creating Packages .......................................................................................... 68
      2.2 Creating Classes .......................................................................................... 69
    2.3 Creating Web Service Clients .......................................................................... 70
    3.1 Creating Services defined by a service class.................................................... 73
    3.2 Modeling and Composing Service .................................................................... 74
    3.3 Modeler Components....................................................................................... 75
 3) Securing Custom Services ..................................................................................... 75
 4) Publishing Projects ................................................................................................ 76
 5) Testing Custom Services ....................................................................................... 77

Chapter 3: Deploying Services ..................................................................................... 78
 1) Working with Scheduling Triggers .......................................................................... 78
    1.1 Creating Scheduling Triggers ........................................................................... 78
    1.2 Managing Scheduling Triggers ......................................................................... 80
 2) Working with Pipelines........................................................................................... 81
    2.1) Creating Pipelines .......................................................................................... 81
      2.1.1 AS2 Pipeline Configuration ........................................................................ 82
      2.1.2 Ftp Pipeline Configuration .......................................................................... 84
      2.1.3 Https Pipeline Configuration....................................................................... 86
      2.1.4 Mail Pipeline Configuration ........................................................................ 87
      2.1.5 SOAP Sender Configuration ...................................................................... 88
    2.2 Managing Service Pipelines ............................................................................. 89




BeeSphere, Inc.
http://www.beesphere.com                                                                  UG10401-1001
                                                             3
                           SOA Web Management Console-7.5.2-User Guide, 1.0




Introduction
BeeSphere SOA Platform is the industry's first SOA Platform fully manageable
from the Web. BeeSphere SOA Web Management Console (Bs. SOA WMC)
makes it possible to securely build, deploy and manage service oriented solutions
from a web browser.

This user guide will help you discover how to use BeeSphere SOA Web
Management Console for:
    1. Designing, building, publishing, testing and making on-line:
         o Integration services providing multi-protocol secure connectivity,
             multi-format data translation and transformation to connect
             applications, data sources and partners’ systems;
         o Custom service providing advanced data processing capabilities for
             automating business logic to be used within applications and
             business processes.

    2. Orchestrating Integration and Custom services into Smart Web Services
       spanning applications, data sources, partners and business processes.

    3. Deploying Smart Web Services by scheduling their execution on a time
       basis (using scheduling triggers) or enabling real-time, secure and multi-
       protocols invocation of services (using pipelines).


For more information about services, see our document “SOA Platform-
Developing and Deploying Smart Services” downloadable at www.beesphere.com
SOA Platform documentation section.




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                          4
                           SOA Web Management Console-7.5.2-User Guide, 1.0


Section 1: Working with Integration
services

1) Workspace Overview
Bs. SOA WMC provides one single workspace for designing, configuring,
publishing and testing Integration Services.




The workspace is divided into four sections:




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                          5
                            SOA Web Management Console-7.5.2-User Guide, 1.0

• General Information Section
This section is used to describe the Integration Service and define an eventual
upstream service that feed it.




• Documentation
This section provides you with the features you need to link BeeSphere Web
Office Resources (documents and files) to the service in order to easy access and
share service documentation.




• Published Instance
This section provides you with the features you need to:

    •   Manage Published Instances of an Integration Service.
    •   Define, execute test cases and access reports on test execution (status
                                                 and metrics).




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                           6
                           SOA Web Management Console-7.5.2-User Guide, 1.0

• Working Area
This section provides you with the features you need to design configure and
publish Integration Services




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                          7
                            SOA Web Management Console-7.5.2-User Guide, 1.0


2) Creating Integration Services
To create an Integration Service, proceed as following:

      1. Click New Integration Service in the Enterprise Services Module.




      2. Provide a name and a description to the Integration Service then click
      Apply. The Integration Service Opens in the workspace under version 0.0.1.
      The version number will increment with every saved modification on your
      Integration Service. The version number help you know if your service needs
      to be republished after a modification:

            • A minor modification will impact the third digit of your version
            Number (0.0.x): You will not have to re-publish your service after a
            minor Modification.
            • A major modification will impact the second digit of your version
            Number (0.x.0): You will have to re-publish your service after a minor
            Modification.
            • The Publish action will impact the first digit of your version Number
            (x.0.0).




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                           8
                              SOA Web Management Console-7.5.2-User Guide, 1.0


3) Documenting Integration Services
Start by creating Service Documentation using Web Office Module:

    •    Use Office Explorer to upload and create files.
    •    Use Office Mind Lab to create documents structured in Mind Maps and
         Nodes.

In the Resources section of your service:

        1. Right-click the Available node to add a Mind Node/File.




        2. Navigate Mind Nodes/Folders, select a Mind Node/File then click Apply.
        Repeat until adding all Mind Nodes/Files constituting Service
        Documentation.




        3. The Service Documentation is now linked to the service and will be
        available for users working on it.




BeeSphere, Inc.
http://www.beesphere.com                                    UG10101-1001
                                             9
                            SOA Web Management Console-7.5.2-User Guide, 1.0

      4. Right click a resource to access it.




You can minimize open Mind Nodes/Files by clicking the Minimize button (at the
right of the title bar). You can quickly access them, while working on your service,
from "Gadgets" in the main toolbar of Bs. SOA WMC.


4) Adding Service Resources
You can add resources from the Web Office Explorer to your service, such as
libraries. These resources can be used by the service at execution.
        1. Add a resource as described in previous section.
        2. Drag the added resource to the “To Be Published” Node.



The resource is added to “To Be Published” node, and will be add during the
publish service action.

        3. Save.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          10
                           SOA Web Management Console-7.5.2-User Guide, 1.0


5) Defining Service Inputs/Outputs
Designing and configuring Service Inputs and Outputs is the first step to
implement an Integration Service.
To add a Service Data Input,
From the "Data format" Plug-in, click “Add” to add input Data formats to your
service including Text, Excel, XML, JSON, EDI and Data Center Tables and
queries. Next, you will be prompted to describe each input Data format (for more
information report to the section 4.1 Defining Service Inputs and Outputs Data
formats and section 4.1 Defining Service Inputs and Outputs Data formats).
Note that you can add you can add as much inputs data you need to feed
your integration service.




To add a Service Output:
     1. Click New Output from the Workspace Toolbar.



      2. Provide a name and a description to the service Data Output then click
      Apply.
      Note that you can add as much Service Outputs you need to feed
      multiple service consumers with different data formats and
      communication protocols.




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                         11
                            SOA Web Management Console-7.5.2-User Guide, 1.0




      3. From the "Data format" Plug-in, click “Add” to add output Data formats to
      your service including Text, Excel, XML, JSON, EDI and Data Center Tables.
      Next, you will be prompted to describe each Output’s Data format (for more
      information report to the section 4.1 Defining Service Inputs and Outputs
      Data formats and section 4.1 Defining Service Inputs and Outputs Data
      formats).
      Note that each Service Output can have multiple Data formats.




      4. From the "Sending Protocols" Plug-in, Click “Add” to add output data’
      sending protocols. Next, you will be prompted to describe each output’s
      sending protocol (for more information report to the section 4.3 Defining
      Service’ output Sending Protocols).
      Note that each Service Output can have multiple Sending Protocols.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          12
                             SOA Web Management Console-7.5.2-User Guide, 1.0




          You can customize the name and description of Inputs/Outputs to
          better describe your service

           1. Access Advanced Features right clicking Input/output Tabulation.
           2. Fill the name and description then click Apply.




BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           13
                               SOA Web Management Console-7.5.2-User Guide, 1.0


4.1 Defining Service Inputs and Outputs Data
formats
4.1.1 CSV/Text Data format
CSV (Comma Separated Values) is a common interchange format between
software packages supporting tabular data and are also easily produced manually
with a text editor or with end-user written scripts or programs.
CSV files are formatted as a table: they must include one line for each record and
can include a header, or first line, that defines fields.
Fixed-length files are the most used variations of CSV files. A fixed-length file has
fixed column widths and use tabs as separators rather than commas.

       4.1.1.1 CSV Delimited Line Settings
       1. Fill in the following settings to describe CSV Delimited Line Files:




                  - Has header?
                  Check this option if the CSV file has a header.
                  - Number of columns
                  Specify the number of columns of the CSV File.

BeeSphere, Inc.
http://www.beesphere.com                                     UG10101-1001
                                             14
                                SOA Web Management Console-7.5.2-User Guide, 1.0

                  - Field Encapsulator
                  Specify a field encapsulator, Quote (") or Apostroph (/'), for fields
                  containing commas, double-quotes, or line-breaks.
                  Examples:
                  1997,Ford,E350,"Super, luxurious truck"
                  1997,Ford,E350,"Super ""luxurious"" truck"
                  1997,Ford,E350,"""Super, luxurious truck"""
                  1997,Ford,E350,"Go get one now
                  they are going fast"
                  1997,Ford,E350," Super luxurious truck "
                  - Field delimiter
                  Specify the field delimiter used in the CSV file: Comma (,), Comma
                  Dot (;) or Tabulation.
                  - Comment Start
                  Specify the comment start characters which will be used to introduce
                  a comment.
                  - Escape Character
                  Specify an Escape Character which will be used to introduce a
                  double quote, or in place of it.
                  - Ignore Leading White Spaces
                  Check this option if Leading Whitespaces have to be ignored. In
                  some case, spaces are considered part of a field and should not be
                  ignored
                  Examples:
                  #same as
                  #1997,Ford,E350
                  1997, Ford, E350
                  - Ignore Trailing White Spaces
                  Check this option if Leading Whitespaces have to be ignored.
                  Examples:
                  #same as
                  #1997,Ford,E350
                  1997 ,Ford ,E350
                  - Interpret Unicode Escapes
                  Check this option if Unicode Escapes have to be interpreted
BeeSphere, Inc.
http://www.beesphere.com                                      UG10101-1001
                                              15
                             SOA Web Management Console-7.5.2-User Guide, 1.0

                Example: &#8364 for the euro sign €.
                - Ignore Empty Lines
                Check this option if Empty Lines have to be ignored.
                - Encoding
                Specify the Character Encoding Standard.
                - File Selector (for Inputs)
                Specify a simple regular expression for Input data filtering (i.e.
                PO_*.csv for file names starting with "PO_" or PO_??/??/??.csv for
                file names like PO_01/01/10.csv).
                Note that only attachment’s which name matches the regular
                expression are processed.
                - File Name and Extension (for Outputs)
                Specify the Output CSV File’s name. A set of parameters can be
                provided to make names more significant using parameters that are
                replaced at runtime:
                     • {year}: the year in yyyy format
                     • {month}: month in MM format
                     • {day}: day in dd format
                     • {hour} : hour in HH format
                     • {minute}: minutes in mm format
                     • {second} : seconds in ss format
                     • {date} : date in yyyyddMM format
                     • {time} : time in HH_mm_ss format
                     • {datetime} : date time in yyyyddMM
                     • _HH_mm_ss
                Example: ‘my file {month} {day} { hour}_{minute}_{second}.csv’ will
                output ‘myfile 01 24 13_54_48.csv’.
             2. Click Apply to save Settings.

       4.1.1.2 Fixed Length Settings
       1. Fill in the following settings to describe CSV Fixed Length Files:
                - Has header?
                Check this option if the CSV file has a header.
                - Lengths (comma separated)
                Specify Fields Lengths (example: 25,50,100).
                - Ignore Additional Fields
                Check this option if Additional Fields have to be ignored.
                - Handle Short Lines

BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           16
                              SOA Web Management Console-7.5.2-User Guide, 1.0

               Check this option if short lines have to be detected and handled.
               - Encoding
               Specify the Character Encoding Standard.
               - File Selector (for Inputs)
               Specify a simple regular expression for Input data filtering (i.e.
               PO_*.csv for file names starting with "PO_" or PO_??/??/??.csv for
               file names like PO_01/01/10.csv).
               Note that only attachment’s which name matches the regular
               expression are processed.
               - File Name and Extension (for Outputs)
               Specify the Output CSV File’s name. A set of parameters can be
               provided to make names more significant using parameters that are
               replaced at runtime:
                    • {year}: the year in yyyy format
                    • {month}: month in MM format
                    • {day}: day in dd format
                    • {hour} : hour in HH format
                    • {minute}: minutes in mm format
                    • {second} : seconds in ss format
                    • {date} : date in yyyyddMM format
                    • {time} : time in HH_mm_ss format
                    • {datetime} : date time in yyyyddMM
                    • _HH_mm_ss
               Example: ‘my file {month} {day} { hour}_{minute}_{second}.csv’ will
               output ‘myfile 01 24 13_54_48.csv’.
      2. Click Apply to save Settings.

4.1.2 Excel Settings
Excel format is a row/column (spreadsheet) based data representation format and
is extensively used for storing columnar data and for mathematical manipulation of
numerical data.

1. Fill in the following settings to describe Excel Files:

        - Has header?
        Check this option if the Excel file has a header.
        - Number of columns
        Specify the number of column.
        - Encoding
BeeSphere, Inc.
http://www.beesphere.com                                     UG10101-1001
                                            17
                             SOA Web Management Console-7.5.2-User Guide, 1.0

       Specify the Character Encoding Standard.
       - Ignore Empty Cells:
       Check this option to ignore Excel file’s empty cells.
       - File Selector (for Inputs)
       Specify a simple regular expression for Input data filtering (i.e. PO_*.xls for
       file names starting with "PO_" or PO_??/??/??.xls for file names like
       PO_01/01/10.xls).
       Note that only attachment’s which name matches the regular expression
       are processed.
       - File Name and Extension (for Outputs)
       Specify the Output Excel File’s name. A set of parameters can be provided
       to make names more significant using parameters that are replaced at
       runtime:
            • {year}: the year in yyyy format
            • {month}: month in MM format
            • {day}: day in dd format
            • {hour} : hour in HH format
            • {minute}: minutes in mm format
            • {second} : seconds in ss format
            • {date} : date in yyyyddMM format
            • {time} : time in HH_mm_ss format
            • {datetime} : date time in yyyyddMM
            • _HH_mm_ss
               Example: ‘my file {month} {day} { hour}_{minute}_{second}.xls’ will
               output ‘myfile 01 24 13_54_48.xls’.
2. Click Apply to save Settings.




BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           18
                           SOA Web Management Console-7.5.2-User Guide, 1.0

Input:




Output type:




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                         19
                                SOA Web Management Console-7.5.2-User Guide, 1.0

4.1.3 XML
XML (Extensible Markup Language) is a text-based standard that has been
defined by the W3C. The XML format is a syntax for defining computer languages,
which makes it possible to create languages adapted to different uses which may
however be processed by the same tools.
Several industries have created their own XML vocabularies like:

    •   Papinet the Global Electronic Business Standards in the paper and forest
        industry.
    •   CIDX the Global Electronic Business Standards in the chemical industry.
    •   PIDX the Global Electronic Business Standards in the oil and gas industry.

XML is inherently interoperable because it is software- and hardware-independent
tool for carrying information: It can be consumed and created by a wide variety of
tools already on the market today.


        4.1.3.1 XML Generic Settings
        XML Generic Inputs are to describe using XSD (XML Schema Definition)
        wish is a language for describing the structure and constraining the
        contents of XML documents.

        1. Fill in the following settings to describe XML Files:

                  - Upload XML Schema
                  Click "Upload XML Schema" to upload the XSD describing the XML
                  file for Office Explorer’s folder. You can upload the XSD file from
                  your desktop if not already done.
                  Note that XSD files associated to a service Input/output become
                  system files that can’t be deleted. You can use
                  - File Selector (for Inputs)
                  Specify a simple regular expression for Input data filtering (i.e.
                  PO_*.xml for file names starting with "PO_" or PO_??/??/??.xml for
                  file names like PO_01/01/10.xml).
                  Note that only attachment’s which name matches the regular
                  expression are processed.
                  - Xml namespace prefix (for Inputs)
                  Specify the xml name space prefix for Input xml data.
                  - File Name and Extension (for Outputs)


BeeSphere, Inc.
http://www.beesphere.com                                      UG10101-1001
                                              20
                                SOA Web Management Console-7.5.2-User Guide, 1.0

                  Specify the Output xml file’s name. A set of parameters can be
                  provided to make names more significant using parameters that are
                  replaced at runtime:
                     • {year}: the year in yyyy format
                     • {month}: month in MM format
                     • {day}: day in dd format
                     • {hour} : hour in HH format
                     • {minute}: minutes in mm format
                     • {second} : seconds in ss format
                     • {date} : date in yyyyddMM format
                     • {time} : time in HH_mm_ss format
                     • {datetime} : date time in yyyyddMM
                     • _HH_mm_ss
                  Example: ‘my file {month} {day} { hour}_{minute}_{second}.xml’ will
                  output ‘myfile 01 24 13_54_48.xml’.

                  - Format Xml (for Outputs)
                  Whether or not to format the result xml
                  - Add Xml Declaration(for Outputs)
                  Whether or not to add the xml declaration in the result xml

2. Click Apply to save Settings.




BeeSphere, Inc.
http://www.beesphere.com                                      UG10101-1001
                                              21
                           SOA Web Management Console-7.5.2-User Guide, 1.0



Input:




Output:




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                         22
                               SOA Web Management Console-7.5.2-User Guide, 1.0

1.3.1.4.2 XML Based Standards (Papinet, CIDX and PIDX)
       Selecting an XML Based Standard (Papinet, CIDX and PIDX) opens the
       Standard Library.




       1.Fill in the following settings to describe Papinet, CIDX or PIDX
       Documents:

                  - Standard Release
                  Double-click a Release to view Standard Documents associated to
                  the Release.
                  - Standard Document
                  Select the Standard Document associated to the Input/Output
                  Document.
                  - File Selector (for Inputs)
                  Specify the Output Document name and extension (Example:
                  PO_*.xml for document names starting with "PO_" or
                  PO_??/??/??.xml for document names like PO_01/01/10.xml).

                  - File Name and Extension (for Outputs)
                  Specify the Output Document name and extension.

BeeSphere, Inc.
http://www.beesphere.com                                     UG10101-1001
                                             23
                            SOA Web Management Console-7.5.2-User Guide, 1.0

       2. Click Apply to save Settings.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          24
                            SOA Web Management Console-7.5.2-User Guide, 1.0

4.1.4 EDI Standards (UN/Edifact, X12 and HL7)
EDI is considered to be a technical representation of a business conversation
between two entities, either internal or external.
Many associations have rigorously standardized format of electronic documents.
The most common EDI standards are:

    •   UN/ EDIFACT: EDI For Administration, Commerce, and Transport
        (EDIFACT) is the international standard for EDI. Developed by the United
        Nations, these standards work for international conventions for electronic
        data interchange.
    •   ANSI X12: A numbered set of commercial EDI transactions defined by the
        American National Standards Institute's Accredited Standards Committee
        X12. These uniform rules for the interchange of business documents are
        defined for cross industry EDI.
    •   HL7: An American National Standards Institute (ANSI) standards
        development organization (SDO) that focuses on clinical and administrative
        data in the healthcare delivery system of the United States.

Selecting an EDI Standard (UN/Edifact, X12 and HL7) opens the Standard Library.
1. Fill in the following settings to describe UN/Edifact, X12 and HL7 Documents:
         - Standard Release
         Double-click a Release to view Standard Documents associated to the
         Release organized by Industry/Domain.
         - Standard Industries/Domains
         Select the Industry/Domain associated to the Document.
         - Standard Documents
         Select the Standard Document associated to the Input/Output Document.
         - File Selector (for Inputs)
         Specify the Input Document name and extension (Example: PO_*.edi for
         document names starting with "PO_" or PO_??/??/??.edi for document
         names like PO_01/01/10.edi).
         - File Name and Extension (for Outputs)
         Specify the Output Document name and extension.
2. Click Apply to save Settings.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          25
                               SOA Web Management Console-7.5.2-User Guide, 1.0

4.1.5 Tables and Queries (BeeSphere Data Center)
BeeSphere Datacenter provides with a robust database management systems
providing data management capabilities including master, reference and
transactional data management including storage and use within services.

      1.3.1.5.1 Using BeeSphere’s Tables and Queries as Input for
Integration Services
      1. Fill in the following settings:
               - Select Table/Query
               Click the button to open the Database Structure. Navigate between
               Database Schemas to select a Table/Query then click Apply.
               - Add Default Columns? (for Tables)
               Check this option if the Integration Service uses Default Columns:

                        Created In (Date).
                           •
                        Created By (User).
                           •
                        Creator Pipe (Bs.wmc, Ftp, Smtp, Http or As2).
                           •
                        Last Updated (Date).
                           •
                        Updated By (User).
                           •
                      • Updater Pipe (Bs.wmc, Ftp, Smtp, Http or As2).
            3. Click Apply to save Settings.

        1.3.1.5.2 Using BeeSphere’s Tables as Output for Integration Services
        1. Fill in the following settings:
                 - Select Table
                 Click the button to open the Database Structure. Navigate between
                 Database Schemas to select a Table then click Apply.
                 - Append records?
                 Check this option if the Integration Service appends unique new
                 records to the table rather than update existing records.
        2. Click Apply to save Settings.




BeeSphere, Inc.
http://www.beesphere.com                                     UG10101-1001
                                             26
                               SOA Web Management Console-7.5.2-User Guide, 1.0

4.1.6 JSON
JSON (JavaScript Object Notation) is a lightweight text-based open standard
designed for human-readable data interchange.
It is language independent and its parsers are available for most programming
languages.

       4.1.6.1 JSON Settings
       JSON Inputs are to describe using XSD (XML Schema Definition).

       1. Fill in the following settings to describe XML Files:

                  - Upload XML Schema
                  Click "Upload XML Schema" to upload the XSD describing the XML
                  file for Office Explorer’s folder. You can upload the XSD file from
                  your desktop if not already done.
                  Note that XSD files associated to a service Input/output become
                  system files that can’t be deleted. You can use
                  - File Selector (for Inputs)
                  Specify a simple regular expression for Input data filtering (i.e.
                  PO_*.xml for file names starting with "PO_" or PO_??/??/??.xml for
                  file names like PO_01/01/10.xml).
                  Note that only attachment’s which name matches the regular
                  expression are processed.
                  - Xml namespace prefix (for Inputs and outputs)
                  Specify the xml name space prefix for Input xml data.
                  - File Name and Extension (for Outputs)
                  Specify the Output xml file’s name. A set of parameters can be
                  provided to make names more significant using parameters that are
                  replaced at runtime:
                       • {year}: the year in yyyy format
                       • {month}: month in MM format
                       • {day}: day in dd format
                       • {hour} : hour in HH format
                       • {minute}: minutes in mm format
                       • {second} : seconds in ss format
                       • {date} : date in yyyyddMM format
                       • {time} : time in HH_mm_ss format
                       • {datetime} : date time in yyyyddMM
                       • _HH_mm_ss


BeeSphere, Inc.
http://www.beesphere.com                                     UG10101-1001
                                             27
                                SOA Web Management Console-7.5.2-User Guide, 1.0

                  Example: ‘my file {month} {day} { hour}_{minute}_{second}.xml’ will
                  output ‘myfile 01 24 13_54_48.xml’.

              - Root Name
              The name for the xml root element, if not specified and more than 1
              object found, error is raised.
              - Arrays Suffix
              A string that will be used as suffix for tag Names when a Json Array
              is found.
              - Add an attribute to arrays?
              Specifies whether or not to add an xml attribute [isArr=”true”] for
              array objects. This id utile when parsing the produced xml.
              - Format Xml (for Outputs)
              Whether or not to format the result xml
2. Click Apply to save Settings.
Input:




Output:




BeeSphere, Inc.
http://www.beesphere.com                                      UG10101-1001
                                              28
                            SOA Web Management Console-7.5.2-User Guide, 1.0

        For more details on Inputs/Outputs settings please see the document “SOA
        Platform-Data Integration Services” available at our documentation section
        at www.beesphere.com




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          29
                                SOA Web Management Console-7.5.2-User Guide, 1.0


4.2 Defining Service Inputs and Outputs Data
Structure
4.2.1 Working with Schema Editor
The Schema Editor is a graphical editing tool enabling users use the annotation
capabilities of XSD to define Input and Output data structure. The Schema Editor
allows the document’s structure to be viewed graphically and edited with validation
support and other useful features.




The Schema Editor main window is split into three sections:
   • The right section provides a visual Schema Tree representation enabling
      users describe the schema associated to Input/output Data and define
      restrictions on Data.
   • The Left section enable users define complex Data formats to be used
      within the Schema.
   • The Bottom section enable users edit Schema Elements' attributes.


       4.2.1.1 Navigating the Schema Representation
       The schema elements are grouped into the following categories:

            •     A Schema that defines the root element of a schema
            •     Elements that can contain text of many different types. The most
                  common types are: string, decimal, integer, boolean, date and time.

BeeSphere, Inc.
http://www.beesphere.com                                      UG10101-1001
                                              30
                               SOA Web Management Console-7.5.2-User Guide, 1.0

            •     Sequences wish Specify that the child elements must appear in a
                  sequence.
            •     Restrictions that defines restrictions on a simple Type, simple
                  Content, or a complex Content.

       Users can double Click a schema element to show its childs and properties.
       They can also right click a Schema Element to access the contextual menu
       associated to it.




                - Enlarge view
                Displays an Enlarged View starting at the selected Schema Element.
                - Expand All/Collapse All
                Expand/collapse schema elements under the selected Schema
                Element.
                - Properties
                Display the properties of a Schema Element.
                - Convert To (for Sequences)
                All Specifies that the child elements can appear in any order. Each
                child element can occur 0 or 1 time (Constrains maxoccurs to 1).
                Choice: allows only one of the elements contained in the <choice>
                declaration to be present within the containing element (Possibely
                repeating).
                Sequence specifies that the child elements must appear in a
                sequence (Enforces order). Each child element can occur from 0 to
                any number of times.


BeeSphere, Inc.
http://www.beesphere.com                                     UG10101-1001
                                             31
                                SOA Web Management Console-7.5.2-User Guide, 1.0

       4.2.1.2 Editing Schema Element's properties
       To Edit a schema element:
       1- Double Click the element in the schema to display its properties:




       2. Fill the properties and Re-apply Changes.

       4.2.1.3 Defining Validation Rules
       Adding Restrictions on Data enables Input/output validation to ensure data
       quality and accuracy during all phases of processing.
       To Add a restriction, double-click on a Data Element then right-click
       Restrictions. A contextual menu is displayed with the fallowing options
       related to restrictions:




                  - Add:
                  Use this feature to define restrictions on data values (Numeric,
                  Alphanumeric and enumeration).
                  - Clear:
                  Use this feature to clear defined restrictions on values.
                  - Properties:
                  Use this feature to define the base type associated to a restriction.
                  4.2.1.3.1 Numeric Restrictions



BeeSphere, Inc.
http://www.beesphere.com                                      UG10101-1001
                                              32
                               SOA Web Management Console-7.5.2-User Guide, 1.0




                      - Max Exclusive:
                      Specifies the upper bounds for numeric values (the value must
                      be less than this value).
                      - Max Inclusive:
                      Specifies the upper bounds for numeric values (the value must
                      be less than or equal to this value).
                      - Min Exclusive:
                      Specifies the lower bounds for numeric values (the value must
                      be greater than this value).
                      - Min Inclusive:
                      Specifies the lower bounds for numeric values (the value must
                      be greater than or equal to this value).
                      - Fraction of Digits:
                      Specifies the maximum number of decimal places allowed.
                      Must be equal to or greater than zero.
                      - Total of Digits:
                      Specifies the exact number of digits allowed. Must be greater
                      than zero.
                  4.2.1.3.2 Alpha-Numeric Restrictions




BeeSphere, Inc.
http://www.beesphere.com                                     UG10101-1001
                                             33
                                  SOA Web Management Console-7.5.2-User Guide, 1.0



                      - Length::
                      Specifies the exact number of characters or list items allowed.
                      Must be equal to or greater than zero.
                      - MaxLength:
                      Specifies the maximum number of characters or list items
                      allowed. Must be equal to or greater than zero.
                      - MinLength:
                      Specifies the minimum number of characters or list items
                      allowed. Must be equal to or greater than zero.
                      - WhiteSpace:
                      Specifies how white space (line feeds, tabs, spaces, and
                      carriage returns) is handled.
                      - Expression:
                      Defines the exact sequence of characters that are acceptable
                      by introducing a regular


                  4.2.1.3.3 Enumerations (Values)




                           - Enumeration:
                           Defines a list of acceptable values.

       4.2.1.4 Defining Data formats
       1.In the "User's Defined Types" section, double click "Defined Types" to
       display the user defined types.




BeeSphere, Inc.
http://www.beesphere.com                                        UG10101-1001
                                                34
                            SOA Web Management Console-7.5.2-User Guide, 1.0




       2. Right-click "Defined Types" to Add a "Data format".
       3. Right-click a Data format to access a contextual menu with the following
       features:

              - Add:
              Use this feature to define restrictions on the Data format.
              - Delete:
              Use this feature to delete the Data format.
              - Clear:
              Use this feature to clear defined restrictions on values associated to
              the Data format.
              - Properties:
              Use this feature to define the base type associated to the Data
              format.
       You can associate a Data format to a schema element by filling its name in
       the Property "Type" of your chema element.

4.2.2 Working with Map Editor
BeeSphere Map Editor is a graphical editing tool enabling users define Standard
based Input and Output documents (UN/Edifact, X12, HL7, PIDX, CIDX, Papinet)
by allowing the structure and semantic of documents to be viewed graphically and
edited with validation support and other useful features.
The Map Editor main window is split into three sections:
BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          35
                             SOA Web Management Console-7.5.2-User Guide, 1.0

        •   The right section provides a visual Schema Tree representation of
            standards based documents enabling users customize the map
            associated to standards based documents.
        •   The Left section enable users edit Data formats to be used within a
            Map.
        •   The Bottom section enable users edit Map Elements's properties.

       4.2.2.1 Navigating/Editing a Standard based document's Map
       The Map editor provide you for a unique interface to customize Maps
       describing expected Input/Output document for standards based integration
       scenarios.

       Users can double Click a Map element to show its childs and properties.
       They can also right click a Map Element to access the contextual menu
       associated to it:
             - Enable/Disable Element:
             Include/Exclude an element in the Map to customize a standard
             based document.
             - Enlarge view
             Displays an Enlarged View starting at the selected Schema Element.
             - Expand All/Collapse All
             Expand/collapse schema elements under the selected Schema
             Element.
             - Properties
             Display the properties of a Schema Element.
             - Conver To (for Sequences)
             All Specifies that the child elements can appear in any order. Each
             child element can occur 0 or 1 time (Constrains maxoccurs to 1).
             Choice: allows only one of the elements contained in the <choice>
             declaration to be present within the containing element (Possibely
             repeating).
             Sequence specifies that the child elements must appear in a
             sequence (Enforces order). Each child element can occur from 0 to
             any number of times.




BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           36
                            SOA Web Management Console-7.5.2-User Guide, 1.0

       4.2.2.2 Navigating/Editing Standards bases Data formats
       In the "Defined Types" section, double click "Defined Types" to display the
       standard's defined types. Users can double click a Data format to display
       restrictions on values associated to the Data format and properties.
       Right-click a Data format to access a contextual menu with the following
       features:
               - Add:
               Use this feature to add restrictions to the standard's Data formats.
               - Delete:
               Use this feature to delete a standard's Data format.
               - Clear:
               Use this feature to clear defined restrictions on values associated to
               the standard's Data format.
               - Properties:
               Use this feature to define the base type associated to the standard's
               Data format.
       Double-click a restriction associated to a standard's Data formats to edit its
       value.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          37
                            SOA Web Management Console-7.5.2-User Guide, 1.0


4.3 Defining Output Sending Protocols
4.3.1 FTP Settings
Selecting Ftp, Ftps, Tftp, Sftp or Scp as Sending Protocol will open the FTP
Settings window.




        - Remote Server
        Specify the parameters requested to open a connection with a remote
        server are:
        - Server Name;
         - Port Number.

        Click to browse "Default Partner Servers" schema and tables (double
        clicking schemas and tables from the Database Explorer), select an FTP
        server then click Apply.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          38
                             SOA Web Management Console-7.5.2-User Guide, 1.0




        - Backup Folder
        Specify the location of a folder to backup data (has to be already created
        on BeeSphere Data Center\ Disk Management Module).
        Click to browse "Backup Folders" (double clicking folders from the
        Backup folder Explorer), select a Folder then click Apply.




        - Send Strategy
        The strategy that will be applied when sending (send and backup, backup
        only or send only).

BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           39
                             SOA Web Management Console-7.5.2-User Guide, 1.0

4.3.2 E-Mail Settings
Selecting Email as Sender Protocol will open the Email Settings window.




        - Subject
        Specify the subject of the E-mail.
        - To/Cc/Bcc
        Specify the recipients List of the E-mail (Many e-mail clients will mark e-
        mail in recipient's inbox differently depending on whether he is in the To, Cc
        or Bcc list.)
        Click to browse "Default Identities" schema and tables (double clicking
        schemas and tables from the Database Explorer), select a Contact then
        click Apply.




BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           40
                             SOA Web Management Console-7.5.2-User Guide, 1.0




        - Content
        Specify the Content of the e-mail.

        Click to browse "Default Identities" schema and tables (double clicking
        schemas and tables from the Database Explorer), select a Mailing then
        click Apply.




BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           41
                             SOA Web Management Console-7.5.2-User Guide, 1.0




        - Backup Folder
        Specify the location of a folder to backup data (has to be already created
        on BeeSphere Data Center\ Disk Management Module).
        Click to browse "Backup Folders" (double clicking folders from the
        Backup folder Explorer), select a Folder then click Apply.




        - Send Strategy
        The strategy that will be applied when sending (send and backup, backup
        only or send only).

4.3.3 AS2 Settings
Selecting AS2 as Sender Protocol will open the AS2 Settings window.




BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           42
                             SOA Web Management Console-7.5.2-User Guide, 1.0




        - AS2 Partnership
        Specify the parameters describing AS2 Partnerships:
            - From Party: the name of the partner delivering the transaction.
            - To Party: the name of the partner receiving the transaction.
            - Subject: the subject of the messages
            - Message disposition notification (MDN): MDN return" options:

                   •  "Sync" if AS2 MDNs are to be returned to AS2 message sender
                   clients over the same HTTP connection they used to send the
                   original message.
                   • "ASync" if AS2 MDNs are to be returned to the AS2 message
                   sender's server later over a different HTTP connection.
                   • "Email" if AS2 MDNs are to be returned to AS2 message
                   senders via email rather than HTTP.
                   • "No" if no AS2 MDN to return to the AS2 message sender.

            - Compression Required: set this parameter to true if compression is to
            be done before signing.
            - Signature Required: set this parameter to true if signature is required
            on delivery.
            - Sign Algorithm: enter the name of the algorithm used to sign the
            message (sha1 or MD5).
            - Encryption Required: set this parameter to true if encryption is to be
            done before signing.
BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           43
                               SOA Web Management Console-7.5.2-User Guide, 1.0

            - Encrypt Algorithm: enter the name of the algorithm used to encrypt the
            message (3DES, RC2-40, RC2-64, RC2-128, RC2-196, RC2-64, RC4-
            40, RC4-56, RC4-128, AES-128, AES-192, AES-256).
            - SSL Delivery: set this parameter to true if Https is used for sending
            the message.
            - Receipt Required: set this parameter to true if non-repudiation of
            receipt is recquired (a digital signature and signing credential will be
            necessary).
            - Recipient Address: The URL where the message will be posted
            - Receipt Signature Required: set this parameter to true if verification of
            the signature on the MDN is recquired
            - Sync Reply: set this parameter to true if synchronous reply from the
            recipient is to be allowed.
            - Partner Certificate: Specifies the Partner's certificate to be used for
            verifying signed messages (the Partner's certificate had to be uploaded
            in BeeSphere Office Explorer).
            - Mic Algorithm: specify the algorithm used to check the message
            integrity (sha1 or MD5).
            - Sign Key (PKCS-12): Specifies a valid certificate to be used for
            signing the messages (the Partner's certificate had to be uploaded in
            BeeSphere Office Explorer).
            - Sender Key Alias : a certificate alias to be used to identify the sender's
            certificate in the Keystore
            - Sender Key Password: a password to be used to access the private
            key from the Keystore and decrypt the message.
            - Maximum Retries:The maximum number of retry to attempt when
            delivering the message.
            - Retry Interval: The interval in millesecond between consecutive retry
            in delivery.
            - Receipt Url: The URL for receiving receipts.

                  Click to browse "Default Identities" schema and tables (double
                  clicking schemas and tables from the Database Explorer), select an
                  AS2 Partnership then click Apply.




BeeSphere, Inc.
http://www.beesphere.com                                     UG10101-1001
                                             44
                            SOA Web Management Console-7.5.2-User Guide, 1.0




     - Backup Folder
     Specify the location of a folder to backup data (has to be already created on
     BeeSphere Data Center\ Disk Management Module).

     Click to browse "Backup Folders" (double clicking folders from the Backup
     folder Explorer), select a Folder then click Apply.




        - Send Strategy
        The strategy that will be applied when sending (send and backup, backup
        only or send only).


BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          45
                            SOA Web Management Console-7.5.2-User Guide, 1.0

4.3.4 Http Settings
Selecting Http as Sender Protocol will open the Http Settings window.




    - Server
    Specify the parameters requested to open a connection with an Http server
    are:

        •   Server Name;
        •   Port Number;
        •   Authentication Port Number;
        •   Ping Url;
        •   Athentication Url;
        •   Athentication Domain ;
        •   Principal Parameter;
        •   Password Parameter.

    Click to browse "Default Partner Servers" schema and tables (double
    clicking schemas and tables from the Database Explorer), select an Http
    server configuration then click Apply.
BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          46
                             SOA Web Management Console-7.5.2-User Guide, 1.0

    - User Account
    Specify the parameters requested to access the remote server:

        •   Login;
        •   Password;
        •   Authentication Policy;
        •   Authentication Realm;
        •   Secure (SSL).

    Click to browse "Default Identities" schema and tables (double clicking
    schemas and tables from the Database Explorer), select an FTP User Account
    then click Apply.




        - Backup Folder
        Specify the location of a folder to backup data (has to be already created
        on BeeSphere Data Center\ Disk Management Module).

        Click to browse "Backup Folders" (double clicking folders from the
        Backup folder Explorer), select a Folder then click Apply.




BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           47
                                                             User Guide
                            SOA Web Management Console-7.5.2-User Guide, 1.0




        - Send Strategy
        The strategy that will be applied when sending (send and backup, backup
        only or send only).
        For more details on Senders settings please see the document “SOA
             Data
    Platform-Data Integration Services” available at our documentation section at
    www.beesphere.com




BeeSphere, Inc.
http://www.beesphere.com                                       01-1001
                                                          UG10101
                                          48
                            SOA Web Management Console-7.5.2-User Guide, 1.0


6) Defining Data Transformation Logic
5.1 MTM Environment
There are three important functional sections on the MTM window:

- Inputs/Outputs
This section provides user with a comprehensive visual view of Inputs/Outputs
schemas represented as trees. A variety of Icons are used to represent Complex
type Elements, Sequences and Simple Type Elements.
When working with multiple Inputs/Outputs, each input/output schema will be
displayed in a tab.

- Data Mapping
This section provides user with mapping lines defining the transformation logic
between Inputs and Outputs.

- Expressions Editor
This section is used to define advanced transformation logic that cannot be
represented by visual mappings. For these situations, you can create XSLT
templates, expressions, variables and runtime parameters handled by the service.


5.2 Mapping Inputs to Outputs
Service Inputs and Outputs Data Schemas are displayed in the Data Schemas
Section of the MTM. You can click the Tab associated to an Input/Output in order
to view its schema.

The name and Id of an Input/Output are displayed in the root element of
associated schema. Note that this ID is used when referring to schema nodes
using absolute paths.

Double click a schema node to view its child nodes. You can also right click a
schema node then click Enlarge view to display an enlarged view of its child
nodes.



BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          49
                              SOA Web Management Console-7.5.2-User Guide, 1.0

You can define transformation logic by dragging and dropping Input/Output Data
Elements to the Transformation Map.

To define Mappings between Inputs and Outputs:

    •   Click an element from the Input schema and drag.
    •   Move the mouse pointer near an element in the Output schema, and "drop"
        the element once the icon is displayed.

A mapping line is created in the Mapping section.



        5.2.1 Creating Iterations
Iterations are created to define a repeated data selection over a set of nodes in
the input.
Iterations can be created referring to an input element or a custom expression.
To create iteration over an input element:
1 - Drag and drop the input node to the mapping table.
A row is inserted in the mapping table as iteration. You can edit the iteration
expression to do additional filters over the elements or create a custom iteration
expression.
In the case of multiple Outputs, you will be asked to confirm if iteration concerns
multiple outputs.
Or
2 - Drag and drop the input node to an output type node. A mapping line is
inserted into the mapping table. So far the line is a data mapping line. Select the
line by clicking on it, and then drag the same input node to the line. The line is
updated by an iteration expression.

You can add filters to iteration in order to filter output data according to a criterion.
      - Click the iteration in the transformation map then click Edit Filter
      Expression.
      - Provide a name and the value of the filter Expression.

A Filter Expression is a predicate that is used to find a specific node or a node that
contains a specific value. Predicates are always embedded in square brackets.


BeeSphere, Inc.
http://www.beesphere.com                                    UG10101-1001
                                            50
                               SOA Web Management Console-7.5.2-User Guide, 1.0

We have listed some path expressions with predicates and the result of the
expressions:


                Expression                                   Result
/Catalog/Article[1]                    Selects the first Article element that is the
                                       child of the Catalog element.
/Catalog/Article[last()]               Selects the last article element that is the
                                       child of the Catalog element
/Catalog/Article[last()-1]             Selects the last but one Article element that
                                       is the child of the Catalog element
/Catalog/Article[position()<3]         Selects the first two Article elements that
                                       are children of the Catalog element
//Article[@Id]                         Selects all the Article elements that have an
                                       attribute named Id
//Article[@InPromotion='Yes']          Selects all the ArticleCatalog elements that
                                       have an attribute named InPromotion with a
                                       value of 'Yes'
/Catalog/Article[price>25.00]          Selects all the Article elements of the
                                       Catalog element that have a price element
                                       with a value greater than 25.00
/Catalog/Article[price>35.00]/Label Selects all the Label elements of the Article
                                    elements of the Catalog element that have
                                    a price element with a value greater than
                                    25.00



        5.2.2 Mapping Inputs to Outputs
       To copy Inputs and Outputs:

            •     Click an element from the Input schema and drag.
            •     Move the mouse pointer near an element in the Output schema, and
                  "drop" the element once the icon is displayed.

        A mapping line is added to the Transformation Map with an XPath
        expression locating Input/Output Elements in schema trees (Absolute
BeeSphere, Inc.
http://www.beesphere.com                                     UG10101-1001
                                             51
                               SOA Web Management Console-7.5.2-User Guide, 1.0

        Paths). You can Edit These Expression clicking the button Edit Expression
        the path expression related to the Input.

        Note that:
                Child elements under the iteration element will be located using
        relative Paths.
                The mapping lines order is important in the definition of
        transformation logic.



        5.2.2 Setting a value for an Output Element
       To set a constant value to an Output Element:

            •     Drag and drop the Output element to the Transformation Map. A
                  mapping line is added to the Transformation Map with an empty
                  expression.
            •     Select the Mapping Line then click Edit Expression.
            •     Provide a name to the expression and enter the constant value in
                  the field "Expression".
            •     Apply Changes.

       The Expression is added in the User Defined Expressions Section and the
       mapping line is updated with the name of the expression.



5.3 Using Expression Editor
 The expression editor allows creation of custom expressions based on XSL,
XPath and XQuery standards
Expressions and Functions are used to select input nodes for processing, test
conditions during conditional processing, and calculate values for insertion into the
result tree. You can use XQuery 1.0 & XPath 2.0 Functions & Operators to define
advanced transformation Logic.

To get introduced to XQuery 1.0 & XPath 2.0 Functions & Operators, refer to the
Appendix: XQuery 1.0 & XPath 2.0 Functions & Operators Quick Reference. You
can also refer to the W3C recommendation for more details and examples
(http://www.w3.org/TR/xpath-functions/).
BeeSphere, Inc.
http://www.beesphere.com                                     UG10101-1001
                                             52
                             SOA Web Management Console-7.5.2-User Guide, 1.0



You can create expression from the "User Defined Expressions" section:
- Right click "User Defined Expression" an click Add Expression.
- Provide the name and edit the expression.
- Click the Checkbox "As Variable?" if you choose to create a variable.
        This will create explicitly an xsl variable with the entered content. Variables
can be in global or local mode, when assigned to iteration, they are local and
printed within the iteration element. Otherwise, they are printed as global
variables.
        When Checkbox "As Variable?" is set to false, the expression is printed as
an xsl fragment that will be added to the xsl content at top level. However, if
assigned to a line, this expression will not be printed and its value is assigned to
the mapping line as a select value.In this case the expression must be a valid
value to avoid style sheet compilation errors.
- Apply changes.

The “as variable” checkbox is provided to define how to handle the created
variable. The difference is that when as variable is selected, an explicit variable is
created. Variables are created in global scope by default. You can define a local
scope by dropping the variable to iteration lines. You will be prompted, when a line
is selected to select either define the scope or, assign the value to the mapping
line. When a variable is dropped to an output node, it is assigned as value.

To associate the value of an expression to an Output Element, drag the
expression and drop it in the Output Element.

You can right click a User Defines Expression to access a contextual menu from
where you can Edit or Delete the expression.

You can edit expressions used in Mapping Lines from the Transformation Map
Section by clicking on "Edit Expression" or "Edit Filter Expression" (for iteration).

1.5.4 Using XSLT Instructions
Expressions can contain XSLT code that handles the transformation Logic
including:
- Top-Level Declarations
- Template Invocation Instructions
BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           53
                            SOA Web Management Console-7.5.2-User Guide, 1.0

- Conditional and Looping Instructions
- Node Constructing Instructions
- Value/Copy Instructions.
To get introduced to XSLT 2.0 Instructions, refer to the Appendix: XSLT 2.0
Instructions Quick Reference. You can also refer to the W3C recommendation for
more details and examples (http://www.w3.org/TR/xslt20/).




5.3 XSL View
You can view the generated xsl based on your configured mapping table and
expressions by clicking the ‘Save XSL into Explorer’.
This will create an xsl file in the Web Office Explorer, which content helps you get
a view of the generated xsl.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          54
                             SOA Web Management Console-7.5.2-User Guide, 1.0


7) Securing Services
Service security allows you to define how the service should be called and who
can do so.
You can use either predefined security or your custom implementations. Custom
implementation must be available to the service by adding them to the service
resources to be published.

        1. Click on Security Button, the security screen shows.




A default security call agreement is added by default based on owners. The
service owner is added by default to the access list. To add another owner, Double
click the access list cell. Users search screen appears:




BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           55
                            SOA Web Management Console-7.5.2-User Guide, 1.0




Enter criteria and apply for selected users.




     Only Users which profiles are shared in community are available in search
     form.
To delete user just click on the icon next to the user and confirm.
          2. To add an existing call agreements just drag and drop it to the Call
             Agreements table.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          56
                             SOA Web Management Console-7.5.2-User Guide, 1.0


            3. To create a new one, click the add button in the table header, and
               edit its fields.




            4. Save the service.




BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           57
                            SOA Web Management Console-7.5.2-User Guide, 1.0




8) Publishing Services
Once you define Service Inputs/ Outputs and Mappings, your service is ready for
publishing.

Click Publish from the Toolbar and select Create a new Version or Replace last
Version if you have already published your service.




BeeSphere creates a new version in the Published Instance Section.




Note that the Publish action has impacted the first digit of your version Number
(x.0.0).




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          58
                            SOA Web Management Console-7.5.2-User Guide, 1.0


9) Testing Integration Services
Once Service is published, you can define and execute test cases to perform
regular, reliable unit testing.
You can create Test Cases associated to the last version by clicking the button
Test in the Tool. You can also create test cases for a published version proceeding
as fallow:
Double click a service Instance, right click Functional Tests then click New Test.




Select the Tab More, provide a Name and a Description to the Test Case then
Save.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          59
                             SOA Web Management Console-7.5.2-User Guide, 1.0

Select the Tab Data Files to Add Data Files. BeeSphere opens a window where
you can navigate Office Explorer Folders/ Files, select Data Files or Upload Files
from your Desktop. Save the Test Case once you upload all data file




After uploading Inputs Test Files, click Execute to run the test.

You can view a Detailed Execution Report with the result and execution times
associated to each process. Errors are marked with a red flag , move the mouse
to the item to obtain error description.




BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           60
                           SOA Web Management Console-7.5.2-User Guide, 1.0


Orchestrating Services
An integration service can interact with other services to deliver greater value.
BeeSphere provides you with a framework to define choreography of interactions
at three stages:



8.1- Before Executing the Service
A service can be executed before starting the processing of data input. For
example, your service may need to use data provided by another service.
To define an interaction with an upstream service
1) Access the General Information Section.




2) Double click "Execute Before", Navigate Services/Projects to select an instance
then click Apply.




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                         61
                           SOA Web Management Console-7.5.2-User Guide, 1.0




The service is added in the “Execute Before” Area.




8.2- Before/After Processing an Input/Output
A service can be executed:
- Before processing an Input. For example, we can call a service to send a
notification on receipt to an employee.
- After processing an Input. For example, we can call a service to apply complex
operations on data before applying Data Transformation.
- Before processing an Output. For example, we can call a service to store data in
a database before executing data translation.
- After processing an Output. For example, we can call a service to convert a
purchase order into PDF Format.
To define an interaction:
1) Right click an Input/Output then click advanced.




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                         62
                            SOA Web Management Console-7.5.2-User Guide, 1.0




2) Double click Execute Before/ After to define an interaction with a service/
project.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          63
                            SOA Web Management Console-7.5.2-User Guide, 1.0




Chapter 2: Working with Custom
services

1) Section 1: Workspace Overview
Bs. SOA WMC provides one single workspace for designing, configuring,
publishing and testing Custom Services.




The workspace is divided into four sections:
   • Project Explorer
   This section is used to provide full features for designing, developing,
   publishing and testing of projects and custom services.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          64
                            SOA Web Management Console-7.5.2-User Guide, 1.0




    • Development Area
    This section provides a web based environment for developing software assets
    to use with a project of custom services.




    • Service Definition Area
    This section provides a single interface to define custom services.
BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          65
                           SOA Web Management Console-7.5.2-User Guide, 1.0




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                         66
                            SOA Web Management Console-7.5.2-User Guide, 1.0


2) Creating Projects
A project is a not a package or a related group of packages but a container of
software assets as a service. Software assets interact to deliver value in the
context of a Smart Web Service.

To create a project:
1) Click Enterprise Services then click Custom Services.
2) In the Project Explorer, Right click My Projects then click New Project.




3) Provide a Name and a Description to the project then click Save.




The project is created in the Project Explorer with the following sections:
      - Source Code:
      This section enables you organize, develop, export and publish Software
      Assets.
      - Services
      This section enables you create services from classes and existing
      services.
      - Resources
      This section enables you link resources (like Java Archives and Images) to
      use with your project.
      - Published Instances

BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          67
                             SOA Web Management Console-7.5.2-User Guide, 1.0

        This section enables you test and manage published instances.
        Right click a project to open the project menu from where you can edit,
        publish or delete the project.




2.1 Creating Packages
A Package is just a directory of Java classes which have been packaged. To
create packages under your project:
1) In the Project Explorer, Right click a Project then click New Package.




    From this contextual menu, you can access the following features:

    •   Clean Binary Folder: enables you remove all intermediate and final files
        created by the build process.
    •   Recompile Sources.
    •   Export Binary Jar File
    •   Refresh to get an actualized view of project items specially when working
        with peers.

2) Provide a Name and a Description to the package then click Save. Repeat
this action until creating all the packages structuring your project.

BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           68
                            SOA Web Management Console-7.5.2-User Guide, 1.0




3) Right click a project to open the Package Menu from where you can edit/
create/ delete packages, create entities/ web service clients or refresh/clear
Packages.




2.2 Creating Classes
You can create entities that you'll be able to use from within your custom services:
1) Right click a package point New Entity then click a class-like entity type.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          69
                            SOA Web Management Console-7.5.2-User Guide, 1.0



2) The entity is created under the package and you get an editor window, in the
Development Area, into which you can type your program.
3) As you type in your program, occasionally press CTRL+S to compile and save
your work. Line Number style changes if a compilation error/ warning are
detected. Move the mouse near the line to obtain the description of errors/
warnings.




2.3 Creating Web Service Clients
You can use a custom service to interact with a web service. For this, start by
creating a package.
1) Right click the package then click Create Web Service Client.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          70
                            SOA Web Management Console-7.5.2-User Guide, 1.0



2) Provide the location of the WSDL describing the web service then click Apply.
Proxy classes are generated from WSDL. You can build a class "Service" that
uses those proxy classes to access the SOAP based web service.

The wsdl location can be of two types:
   • A n http url providing the web service wsdl.
   • A BeeSphere Explorer file(wsdl), in this case provide the url in this format:
bsres://<resourceId> Where resourceId is the id of a file existing in the Web Office
Explorer.




The file must be added to the project resources (See next section 2.2.4).
2.2.4 Adding Resources
You can use Java applications or libraries with your project:
1) Right click Resources then click Create Add Resource.




2) Navigate Office Explorer Folders and Files to select resources to use with your
project then click Apply.
The resource is added under Resources Section.
BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          71
                           SOA Web Management Console-7.5.2-User Guide, 1.0




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                         72
                           SOA Web Management Console-7.5.2-User Guide, 1.0


Creating Custom Services
BeeSphere provides a design environment for modeling services.
It offers a process-based modeling approach with a drag-and-drop interface that
reduces development time.


3.1 Creating Services defined by a service class
BeeSphere provide unified environment combining both development and design
oriented approaches for creating services.
To create a service:
1) Right click Service then click New Service.




2) Provide a name and a description of your service.
3) Drag and Drop a class to the "Drag and Drop a valid Class" zone.




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                         73
                            SOA Web Management Console-7.5.2-User Guide, 1.0




4) Add characteristics you might use with your service providing its name, type
and value.
5) Click Save.


3.2 Modeling and Composing Service
The Service Modeler provides you with a visual environment for designing,
composing and orchestrate services.
The Service Modeler is divided in two sections:
      1) Components Gallery:
      Components are organized into Tabs for the following categories: Readers,
      Writers, Transformers, Senders, Utilities, Generic and Connectors.

        2) Service Design Area:
        This section enable you compose and orchestrate services using the
        Gallery Components.

The service Modeler enables users to compose services by adding and
connecting components.

To add a component to the service:
      - Click the appropriate components
      - drag the component to the Service Design Area.
      - The component is added to the service.

To connect two components:
      - Click the component "Connector" from the Tab "Connector" and drag it to
      the Service Design Area.
      - Click the source component, then click the target component to define a
      flow.

Add service components and connect them in the same manner until composing
the service flow.
BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          74
                           SOA Web Management Console-7.5.2-User Guide, 1.0


3.3 Modeler Components
BeeSphere provides you with several components for designing Smart Web
Services:
Readers:
These components validate data quality against a schema defined by the user and
read documents in a variety of formats (Text, Excel, XML, Edifact, X12, HL7,
CIDX, PIDX, PAPINET, Table and Query). The output of this component is an and
XML file.
Writers
These components validates data quality against a schema defined by the user
then writes documents in a variety of formats (Text, Excel, XML, Edifact, X12,
HL7, CIDX, PIDX, PAPINET and Table ). The input of this component is an XML
file.
Transformers
The XML Adapter applies XSL transformations from multiple XML Files to multiple
XML Files.
Senders
These components send data to service consumers using multiple communication
protocols (Email, Ftp, Ftps, Tftp, Sftp, Scp, AS2 and Http).
Utilities
These components apply common functions on data flow like filtering data or
assembling messages.
Generic
These components are used to embed or proxy services.
Connectors
This component connects service components in chain logic.


3) Securing Custom Services
The security for custom services is managed same as the integration services.
To access security window, click the security button in service form bottom:




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                         75
                                    SOA Web Management Console-7.5.2-User Guide, 1.0

Follow instructions of the section “7) Securing services” to configure service
security. And save.


4) Publishing Projects
After defining custom services, you can publish your project.
1) Right click a package point Publish Project then click “Create a new Version” or
“Replace last version”.




2) An instance is created under Published Instances Section.




You can Unpublish a Project Instance               from the contextual menu available by
right click.

You can Edit/Stop          /Start    from the contextual menu available by right click.
BeeSphere, Inc.
http://www.beesphere.com                                          UG10101-1001
                                                  76
                            SOA Web Management Console-7.5.2-User Guide, 1.0


5) Testing Custom Services
Once your project is published, you can define and execute test cases to perform
regular, reliable unit testing.

You can create test cases for a published version proceeding as fallow:

1) Double click a service Instance, right click Functional Tests then click New Test.

2) Select the Tab “More” and provide a Name and a Description to the Test Case
then “Save”.

3) Add characteristic's name and value for each characteristic expected by your
service

Click Execute to run the test.

You can view a Detailed Execution Report with the result and execution times
associated to each process. Errors are marked with a red flag , move the mouse
to the item to obtain error description




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          77
                              SOA Web Management Console-7.5.2-User Guide, 1.0


Chapter 3: Deploying Services

1) Working with Scheduling Triggers
1.1 Creating Scheduling Triggers
To create a scheduling trigger:

1) Click    from the Scheduling Triggers Manager Section.




2) Provide a name and a description to the scheduling trigger.
3) Select a Service Instance.
4) Provide a valid Time expression (see Appendix: Time Expressions)




Here are some full examples:
Expression             Meaning
0 0 12 * * ?           Fire at 12pm (noon) every day
BeeSphere, Inc.
http://www.beesphere.com                                    UG10101-1001
                                            78
                              SOA Web Management Console-7.5.2-User Guide, 1.0

Expression             Meaning

0 15 10 ? * *          Fire at 10:15am every day

0 15 10 * * ?          Fire at 10:15am every day

0 15 10 * * ? *        Fire at 10:15am every day

0 15 10 * * ? 2005 Fire at 10:15am every day during the year 2005

0 * 14 * * ?           Fire every minute starting at 2pm and ending at 2:59pm, every
                       day
0 0/5 14 * * ?
                       Fire every 5 minutes starting at 2pm and ending at 2:55pm,
0 0/5 14,18 * * ?      every day

                       Fire every 5 minutes starting at 2pm and ending at 2:55pm,
0 0-5 14 * * ?         AND fire every 5 minutes starting at 6pm and ending at
                       6:55pm, every day
0 10,44 14 ? 3
WED                    Fire every minute starting at 2pm and ending at 2:05pm, every
                       day
0 15 10 ? * MON-
FRI                    Fire at 2:10pm and at 2:44pm every Wednesday in the month
                       of March.
0 15 10 15 * ?
                       Fire at 10:15am every Monday, Tuesday, Wednesday,
0 15 10 L * ?          Thursday and Friday

0 15 10 ? * 6L         Fire at 10:15am on the 15th day of every month

0 15 10 ? * 6L         Fire at 10:15am on the last day of every month

0 15 10 ? * 6L         Fire at 10:15am on the last Friday of every month
2002-2005
                       Fire at 10:15am on the last Friday of every month
0 15 10 ? * 6#3
                       Fire at 10:15am on every last friday of every month during the
0 0 12 1/5 * ?         years 2002, 2003, 2004 and 2005

                       Fire at 10:15am on the third Friday of every month

BeeSphere, Inc.
http://www.beesphere.com                                    UG10101-1001
                                            79
                              SOA Web Management Console-7.5.2-User Guide, 1.0

Expression             Meaning
0 11 11 11 11 ?
                       Fire at 12pm (noon) every 5 days every month, starting on the
                       first day of the month.

                       0 11 11 11 11 ?    Fire every November 11th at 11:11am.


1.2 Managing Scheduling Triggers
You can manage scheduling trigger from the Scheduling Trigger Manager:
1) Click to add a scheduling trigger.
2) Click / to Start/ Stop a scheduling trigger.
3) Click  to delete a scheduling trigger.




BeeSphere, Inc.
http://www.beesphere.com                                    UG10101-1001
                                            80
                           SOA Web Management Console-7.5.2-User Guide, 1.0


2) Working with Pipelines
2.1) Creating Pipelines
A Service Bus enables multi-protocol invocation of BeeSphere Smart Web
Services (E-mail, FTP, Http, AS2 and SOAP).
BeeSphere Provides a simple approach for creating and managing Service Buses.
Service Bus Module is available under Smart Web Services Menu.
To create a service bus:
1) Right Click Service Buses then click




2) Provide a name and a description to the service bus.
3) Select a Service Instance.
4) Right click a Pipeline to add an AS2, Ftps, Https, Mail or SOAP sender
configuration that will be used to invocate the service then save.




Your service bus is created in the Service Buses Manager with the status New.




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                         81
                                SOA Web Management Console-7.5.2-User Guide, 1.0



When adding a sender configuration, a window is opened to select your configured partners. If not
yet in the datacenter, you can create. Following is the description of each pipeline parameters.


2.1.1 AS2 Pipeline Configuration
Adding AS2 sender configuration will open the AS2 Pipeline window.




        - AS2 Partnership
        Specify the parameters describing AS2 Partnerships:
        - From Party: the name of the partner delivering the transaction.
        - To Party: the name of the partner receiving the transaction.
        - Subject: the subject of the messages
        - message disposition notification (MDN): MDN return" options:

        •   "Sync" if AS2 MDNs are to be returned to AS2 message sender clients
            over the same HTTP connection they used to send the original
            message.
        •   "ASync" if AS2 MDNs are to be returned to the AS2 message sender's
            server later over a different HTTP connection.
        •   "Email" if AS2 MDNs are to be returned to AS2 message senders via
            email rather than HTTP.
        •   "No" if no AS2 MDN to return to the AS2 message sender.

        - Compression Required: set this parameter to true if compression is to be
        done before signing.
        - Signature Required: set this parameter to true if signature is required on
        delivery.

BeeSphere, Inc.
http://www.beesphere.com                                        UG10101-1001
                                               82
                             SOA Web Management Console-7.5.2-User Guide, 1.0

        - Sign Algorithm: enter the name of the algorithm used to sign the message
        (sha1 or MD5).
        - Encryption Required: set this parameter to true if encryption is to be done
        before signing.
        - Encrypt Algorithm: enter the name of the algorithm used to encrypt the
        message (3DES, RC2-40, RC2-64, RC2-128, RC2-196, RC2-64, RC4-40,
        RC4-56, RC4-128, AES-128, AES-192, AES-256).
        - SSL Delivery: set this parameter to true if Https is used for sending the
        message.
        - Receipt Required: set this parameter to true if non-repudiation of receipt is
        required (a digital signature and signing credential will be necessary).
        - Recipient Address: The URL where the message will be posted
        - Receipt Signature Required: set this parameter to true if verification of the
        signature on the MDN is required
        - Sync Reply: set this parameter to true if synchronous reply from the
        recipient is to be allowed.
        - Partner Certificate: Specifies the Partner's certificate to be used for
        verifying signed messages (the Partner's certificate had to be uploaded in
        BeeSphere Office Explorer).
        - Mic Algorithm: specify the algorithm used to check the message integrity
        (sha1 or MD5).
        - Sign Key (PKCS-12): Specifies a valid certificate to be used for signing
        the messages (the Partner's certificate had to be uploaded in BeeSphere
        Office Explorer).
        - Sender Key Alias : a certificate alias to be used to identify the sender's
        certificate in the Keystore
        - Sender Key Password: a password to be used to access the private key
        from the Keystore and decrypt the message.
        - Maximum Retries:The maximum number of retry to attempt when
        delivering the message.
        - Retry Interval: The interval in milliseconds between consecutive retry in
        delivery.
        - Receipt Url: The URL for receiving receipts.

        Click to browse "Default Identities" schema and tables (double clicking
        schemas and tables from the Database Explorer), select an AS2
        Partnership then click Apply.

BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           83
                            SOA Web Management Console-7.5.2-User Guide, 1.0




       Senders will be able to access the AS2 Pipeline using the following
configuration



2.1.2 Ftp Pipeline Configuration
Adding FTPs sender configuration will open the FTPs Pipline window.




        - Ftp Secure Identity

BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          84
                             SOA Web Management Console-7.5.2-User Guide, 1.0

        Specify the parameters requested to enable sender access the remote
        server:
        - Login;
         - Password;
        - Active Mode (if required to connect the server);
         - Transfer Mode: ASCII or binary mode.
         - Implicit SSL if required by the remote server to secure communications.

Click to browse "Default Identities" schema and tables (double clicking schemas
and tables from the Database Explorer), select an FTP User Account then click
Apply.




Senders will be able to access the Ftps Pipeline using the following configuration:
- Login: [User Login].[ServiceBusName] (Example: MyLogin.ExchPO).
- Password: Password configured.




BeeSphere, Inc.
http://www.beesphere.com                                   UG10101-1001
                                           85
                                SOA Web Management Console-7.5.2-User Guide, 1.0

2.1.3 Https Pipeline Configuration
Adding Https sender configuration will open the Https Pipeline window.




        - Http Secure Identity
        Specify the parameters requested to access the remote server:

            •     Login;
            •     Password;
            •     Authentication Policy;
            •     Authentication Realm;
            •     Secure (SSL).

Click to browse "Default Identities" schema and tables (double clicking schemas
and tables from the Database Explorer), select an Http User Account then click
Apply.




BeeSphere, Inc.
http://www.beesphere.com                                      UG10101-1001
                                              86
                            SOA Web Management Console-7.5.2-User Guide, 1.0

Senders will be able to access the Https Pipeline sending an Http <Post> request
with two mandatory parameters:
       - bsuser: [User Login].[ServiceBusName] (Example: MyLogin.ExchPO).
       - Password: Password configured as Http Secure Identity.

2.1.4 Mail Pipeline Configuration
Adding Mail sender configuration will open the Mail Pipline window.




        - From E-mail Address
        Click to browse "Default Identities" schema and tables (double clicking
        schemas and tables from the Database Explorer), select a Contact then
        click Apply.




BeeSphere, Inc.
http://www.beesphere.com                                  UG10101-1001
                                          87
                              SOA Web Management Console-7.5.2-User Guide, 1.0




        Senders will be able to access the Mail Pipeline sending an E-mail to the
        following address: [ServiceBusName]@[BeeSphereDomain] (Example:
        ExchPO@beesphere.net).




2.1.5 SOAP Sender Configuration
Adding SOAP Sender Configuration will open the SOAP Pipeline window.




        - Soap Secure Identity
        Specify the parameters requested to access the remote server:

            •     Login;
            •     Password.

        Click to browse "Default Identities" schema and tables (double clicking
        schemas and tables from the Database Explorer), select an FTP User
        Account then click Apply.




BeeSphere, Inc.
http://www.beesphere.com                                    UG10101-1001
                                            88
                               SOA Web Management Console-7.5.2-User Guide, 1.0




        Senders will be able to access the SOAP Pipeline calling the web service
        described by the WSDL available from:
        https://www.beesphere.net/soa/pipes/soap?wsdl.
        The web Service must be called within your client on two steps:

        1) Identification(verifyIdentity):send an authetication request including:

            •     login in the format [User Login].[ServiceBusName]
            •     password

        2) Send (send): Must include the ticket from the authentication response.
        - bsuser: [User Login].[ServiceBusName] (Example: MyLogin.ExchPO).
        - Password: Password configured as Http Secure Identity.


2.2 Managing Service Pipelines
You can manage service buses from the Service Buses Manager.
1) Right a click a service Bus to show its contextual Menu




BeeSphere, Inc.
http://www.beesphere.com                                     UG10101-1001
                                             89
                           SOA Web Management Console-7.5.2-User Guide, 1.0




From this contextual menu you can Edit, Publish/Unpublish or delete a service
bus.




BeeSphere, Inc.
http://www.beesphere.com                                 UG10101-1001
                                         90

				
DOCUMENT INFO
Shared By:
Categories:
Tags:
Stats:
views:13
posted:7/30/2011
language:English
pages:90