P RO NTO Technical Paper
SOFTWARE
e
Pronto Connect
A technical overviewForeword
Audience
“This paper provides a technical overview ofthe Pronto
Connect web services architecture. I is written for technical
and development staff considering using Pronto Connect
{or integration
The evolution of web services
Internet technologies now allow standardised system to
system connectivity over the World Wide Web. Eficiencies|
in integration among business processes, applications,
‘enterprises, partners, custorners end so on are now possible for
businesses of all sizes
“The adoption of internet-based applications has created a
‘world of disorete business apolications, which co-exist without
interacting. Applicaton-to-application communication can
bbe enabled by service-oriented architectures, which alow
business applications to link with other organisations for
pplication integration and data sharing without the need for
‘manual intervention. Service criented architectures also enable
Interoperabilty between business applications and processes
within the enterprise.
‘The service-oriented architecture model uses platform-neutral
standards such as XML to expose undetiying application
‘components (or business logle) and make them available
to external applications or platforms, ether mobile, web
cor desktop.
“These widely adopted web-services technologies and
‘methodologies form the basis of Pronto Connect.Introduction to Pronto Connect
Meeting the needs of the growing business,
Expanding data and proiferating business applications push
sto seek better ways to connect and share information
between applications. Without connectivity, users have 10
switch between applications, re-enter data multiple times, share
{data with collesgues manually, and spend more time asking
‘questions and searching for key data, These business process
inefficiencies mean less productivity and mare mistakes, which
reduce staff and custarner satisfaction and reduce profitably
Pronto’s design approach to web services
Pronto Connect isthe architectural framework that supports
connectivity and data exchange between mobile, web or
desktop applications and the Pronto Xi Runtime.
Pronto Connect APIs (Application Programmable interfaces)
present information as eXtensible Markup Language (ML)
documents. XML is widely used in web technologies and is
‘appropriate for publishing APIs as itoffers a human-readable
‘scription ofthe functions availabe to external caling
applications. XML describes data in simple terms, such as
‘give me detaled information for that account” or update this
‘ccount’s contact details
Using document based APIs means more information can be
retrieved ina single cal. This provides faster and mote efficient
{ata retrieval than legacy API connectivity models, which call
information on a per field basis,
Pronto Xi Mobile GRM uses this methodology, For example,
‘when the user selects @ customer record in the mobile
pplication, al related customer details are collected at once
(eg. customer name, email, phone number and address),
meaning data retrievals quicker and the applications user
interface ts more responsive.
“The Pronto Connect architecture offers the following
capabilities
+ Realtime data transfer
+ Inbound web services calls using RESTIUL APIs
+ Certificate and LDAP (Active Directory) user authentication |
+ Secure data transfer using SSL
(Outbound HTTP calls can also be defined to retrieve data from
‘8 published web-service. should be noted that this capatality
does not require Pronto Connect.
Benefits of web services integration technologies
Pronto Connect web services architecture has many benefits
ver tractional lat file’ or fild-based connectvity approaches
(including Pronto Software's previous technology, PIE (Pronto,
Integration Engine). These include:
+ Real-time information exchange, meaning processes can be
completed using up-to-date information, not yesterday's data
+ Secure data exchange using enctypted Secure Socket Layer
(ss)
+ Adherence ta Pronto Xi user securty and authentication,
‘meaning only those who are entitled to view data can do so
+ No flat le tranefer mechanism maintenance, which saves
tume and money for administrators
+ Fewer upload of synchronisation errors thanks toa
reliable messaging system that ensures deta is delivered
as requested
+ Easier development - work with an intutive business layer,
removing nead for Pronto XI Rapid Application Development
(RAD) knowiedge and understanding of the Pronto Xt
Data DictionaryBenefits of the Application Programmable
Interface (API)
‘An APL speaities how software components should interact
with each other. When used in application development,
Pls specify the remote calls which are exposed to external
applications allowing them to source, populate and exchange
data for the end user.
[APIs also help system integrators create ways for applications
to exchange data freely and efficient, without human
Intervention. This reduces data double-henaling and human
certo, allowing for substantial increases in productivity and cost:
efficiency,
[APIs come ina variety of formats or protocols - the most
‘common being representational state transfer (REST) and
simple object access (SOAP). APIs that adhere to the REST
architecture ae called RESTTUl APIs
Why Pronto adopted REST
Pronto Software has chosen Representational State Transfer
(REST) API format, because It has gained widespread
acceptance across the Web as a simpler alternative to SOAP:
‘and Web Services Description Language (WSDL), Key evidence
Of this trends the adoption of REST by mainstream web
application providers—including Yahoo, Google, Microsoft
‘and Facebook
‘Some agpects of a RESTIul approach include,
+The format of web address, ea, hrtp:/yrwwipronto.netdcrm/
+ The media type (e.0. XML)
+ The communication protocols (HTTP) that both transfer and
manipulate the data.
Writing custom APIs with Pronto Connect APIs
‘A developer guide and standard Rapid Application
Development (RAD) tools ae available for proarammers to
define custom APIs for use with Pronto Connect.
Pronto Connect APis support manipulation of data in several
request types, (CRUD):
+ To read data from Pronto Xi using GET operation
+ To update data in Pronto Xi using UPDATE operation
+ To cteate data in Pronto Xi using INSERT operation
+ To delete data from Pronto Xi using DELETE operation
Using the Custorner Relationship Management (CRM)
APL as an example a request operation might look for the
following information
Rep Code code tep-masterrep-code
eg 182
RopName Rep Name rep mrasterep- description
2g, John sma
ReplocationCode Rep Location cod | rp rastorreo-location
2g PARS
‘These CRM fields, along with several others, are avalable for
efinition in the API request as well asthe details of what the
fields, and its database name. Field sizes can be found using
the Pronto Xi Dictionary section ofthe Pronto Xi Software
Development kit (SOK)Example code fora request:
|Aresponse would look tke the folowing