Advanced Integration Web Services by 3TGsB50a

VIEWS: 76 PAGES: 25

									      Advanced Integration
         Web Services
              Track:Development
               Category:Integration


David Loo      Jacob Andersen         Christen Mitchell
Developer      Senior Consultant      Developer
Service-now    Service-now            Service-now
● Architecture
● Web Service Import Sets

● Web Service Consumer

● Integration patterns

● Case studies
                 Architecture
                                          SOAP/HTTPS

              SOAP/HTTPS




          Web Service Consumer

                       Web Service Provider

        Target Table       ECC Q     Web Service Import Set

               Business Rule             Transform Map

                                   Target Table

Service-now Platform
Provider vs. Consumer

     Service            Request                   Service
    Consumer                                      Provider
                        Response




● Service-now is both a provider and consumer of web services
● SOAP request and response encrypted in HTTPS

● WSDL dynamically generated
Direct Web Service Recap
  ● Works on all tables
  ● Dynamic WSDL generation

     • Fields
     • SOAP Endpoint
  ● Security

     • ACL
     • Basic Authorization
  ● ECC Queue

     • Bespoke XML Payload
     • Batched Processing
Web Service Import Set
Direct web service (SOAP insert only) on import set tables.
Synchronous import set mode triggers immediate transform of
source data into target table


SOAP
Insert    Import Set Table                        Target Table
            (Notification,      Transform          (Incident,
           Computer etc)                         Computer etc)




System Web Services application let's you
modify existing standard import set tables,
as well as create new web service import
set tables
    Synchronous Transform
Import Set “Mode” and “State” designates how the import set table should be transformed.
Changing this import set to a mode of Asynchronous and a state of Loading has the effect of
not transforming the incoming data as it is inserted, but rather "loading" the import set and
deferring the data transformation later, either manually, or with a scheduled script job




Default
Asynchronous Import Set Transformer
Synchronous Import Set Completer
Creating New Web Service
   …simply, by creating a new import set table
 Web Service Consumer
                            Asynchronous

    SOAPEnvelope
  ● Fields                       ECC Q
  ● Namespaces

                                                             Web
                                                            Service
 SOAPRequest
 • Endpoint
 • Authentication             Synchronous
 •Sync/Async




Web service consumer is a set of script includes SOAPEnvelope and SOAPRequest

• Business rules
• Scheduled script job
• Listener
SOAPEnvelope
SOAPRequest
                      MID Server
The MID server communicates using web services to the instance's ECC queue
table. It receives commands from the instance, executes it and responds with
an XML document in the “payload” field of an ECC queue input record.




        Instance             Request
                    ECC                       MID Server

                            Respond



  • Probes / Sensors                                       ● JDBC
  • JDBC Data Source                                       ● Files

                                                           ● Command line API

                                                           ● Java API
Some Integration Patterns
Event Management
Collecting event based information and turning them into human inter-
actable ITIL service management objects. Many events become few
service objects. When updates occur, changes are fed back to event
originator. Patterns:
     – Event Consumption
     – Event Notification


Entity Management
Management of ITIL service documents that have a direct relationship
with objects in other external systems. Includes creating/provisioning
objects, mirroring, and synchronizing updates. Patterns:
     – Import
     – Export
     – Event Notification
             Event Consumption
 Source event data is collected and transformed into target data. Data
 coalescing helps filter many source records into one target record. The
 source of the transformation is from an inbound web service invocation,
 the target is a Service-now ITIL service object.


•Network Manager                                                Target Table
                    SOAP    Notification
•Element Manager                            Transform       (Incident, Problem,
                             (WSIS)
•Other Help Desks                                               Change etc)


Event                      Event
Generator                  Consumer

              • SOAP insert only
              • Web Service Import Set - Notification
              • Synchronous transform
              • Responds with target record detail
             Event Notification
Observe updates performed on an existing ITIL service object or
creation of new object and send notification to the external service,
identified by a common key


                                   Direct SOAP HTTPS
                 Business
    Object
                   Rule                                   • Network Manager
   Updated                  E                             • Element Manager
    (Incident,                                    MID
                            C                                   • CMDB
    Problem,                    Via MID Server   Server
                            C                             • Identity Manager
 Change, CMDB,                                             • Other Help Desk
    User etc)    Listener

                                Direct SOAP HTTPS
     Event                                                 Event
     Generator                                             Consumer

   • Unique Identifier across both domains
   • Business rule or Listener sends SOAP
       – SOAPEnvelope
       – SOAPRequest
   • Business rule or Listener queues work for MID server
       – MID server executes CLI, Java API or JDBC
                                  Import
Mass copy of source data into target records. Runs frequently to update
objects in a scheduled and batched fashion. Data transformation is
performed to coalesce into existing matching target records.




                                              Data Source
Target Table                                  •JDBC              MID Server
•CMDB                                         •FTP                             Source
•Incident                Import Set           •HTTP                            •JDBC
•Users         Transform   Table      Loads
               s                              •CSV                             •File
•Locations                                    •Excel                           •API
                                                            FTP / HTTP / SCP
                                    Export
Mass copy of source data into target records. Runs frequently to update objects in a scheduled
and batched fashion.

Pull Mode
External client is responsible for connecting into Service-now to extract data.

Push Mode
Service-now extracts data and transmits to external target.




                    E                                   MID Server      JDBC / File / API
                    C                                    Pushes
   Target Table
   •CMDB            C
   •Incident
                                                                                            Target
   •Users
   •Locations
                        HTTPS CSV / Excel / XML          Client Pulls
               Case Study #1
                 Tivoli TEC

     Service-now      W                                    Tivoli TEC
                      S    SOAP / HTTPS
            Transform I                             troubleti
                      S                              cket.sh
                                                      (perl)

                                                                    TEC
Incidents
                                                                   Events
                       E                           TEC
            Listener                    postzmsg
                       C   MID Server              Rules
                                        CLI
                       C
                            Case Study #2
              Microsoft System Center
             Operations Manager (SCOM)



            Service-now                                           MS SCOM



                               W                        Service-now
                                     SOAP / HTTPS
                               S
                                                          SCOM
                     Transform I
                               S                         Connector
                                                                        SCOM
                                                                        Alarms
Incidents                                                  update_
                                                MID
                                 E             Server      alert.exe
                      Listener   C
                                 C
   Case Study #3
Microsoft SMS / SCCM

       Service-now



                     W
                             E
                     S                               SMS
           Transform         C        MID Server
                     I                             SQLServer
CMDB                         C
                     S




JDBC Data Source scheduled import
(Load and Transform) via MID Server
             Case Study #4
             Salesforce.com

     Service-now                                  Salesforce.com
                   Scripted
                     WS       SOAP / HTTPS
                                             M


Incidents                                                 Issues

            Listener   E                     WS
                              SOAP / HTTPS
                       C
                       C
         Additional Resources
• http://wiki.service-now.com/index.php?title=Web_Services
• http://wiki.service-now.com/index.php?title=Web_Service_Import_Sets
• http://wiki.service-now.com/index.php?title=Web_Service_Consumer_Plugin
• http://community.service-now.com/forum/support/development-integration

								
To top