Summit 2007: Get Connected
W408 – Supply Chain Interface XML
Steve KraemerProduct Development
The world of e-commerce connectivity is changing rapidly. Once upon a time, real-time supply chain information came at the touch of a button -- actually, at the touch of about ten buttons originating on a touch-tone phone. Today's environment is dramatically different; real-time information can be accessed more easily and readily using the Prelude Supply Chain module. This module and the required hardware and software will be discussed in this session.
Pre-requisites: none
Wednesday, 1:15 p.m.
© 2007 Activant Solutions Inc. All Rights Reserved
2
Session Objectives
Increase efficiencies with SCI and XMLDescribe required hardware and softwareExplain how to use servletsExplain XML parsing and SCI Describe Prelude and SCI
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
3
Return on Investment Opportunity
This session will show you how using the Activant Prelude Supply Chain Interface can improve efficiency and profitability by giving you more time to provide valuable customer service
© 2007 Activant Solutions Inc. All Rights Reserved
4
Agenda
What is SCI and XMLHardware and SoftwareServletsXML Parsing and SCIPrelude and SCISCI Example
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
5
Agenda
What is SCI and XMLHardware and SoftwareServletsXML Parsing and SCIPrelude and SCISCI Example
© 2007 Activant Solutions Inc. All Rights Reserved
6
What is Supply Chain?
Allows you to exchange data with your business partners in real time as opposed to batch processingUses the internet for data transport (http)
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
7
What is Supply Chain?
Cuts cost of traditional methods such as EDI transaction costUses XML as the data structure for data exchangeTrue B2B data exchange with no middle man such as a VAN
© 2007 Activant Solutions Inc. All Rights Reserved
8
What is XML?
Short for Extensible Markup LanguageSimilar in syntax to HTMLAllows designers to create their own customized tags by enabling the definition, transmission, validation, and interpretation of data between applications and organizations
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
9
What is XML?
There are multiple standards of XML documents, not just one base set
OAG – Open Application GroupcXML – Commerce XMLxCBL – XML Common Business LibraryPIDX – Petroleum Industry Data ExchangeMany, many more
© 2007 Activant Solutions Inc. All Rights Reserved
10
Why XML?
If your business partners do not require you to exchange data via XML today, they probably will in the futureIt is one of the fastest growing ways to exchange data in the industryCommon data structure and layout is shared between computer systems and databases regardless of application environment or operating system
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
11
XML Example
Tag
Attribute
Element
© 2007 Activant Solutions Inc. All Rights Reserved
12Documents Currently Supported by the Supply Chain
IncomingPORequest for inventory availability and pricing
OutgoingOrder acknowledgementsASNInventory snapshotInvoice
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
13
Agenda
What is SCI and XMLHardware and SoftwareServletsXML Parsing and SCIPrelude and SCISCI Example
© 2007 Activant Solutions Inc. All Rights Reserved
14
Hardware Required
Web ServerCan use RS6000 and Uniobjects as an alternative
RS6000 running Prelude
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
15
Hardware Required for Web Server
Typical Small Web Server2.67 GHz processor1 GB MB memoryWindows 2000/2003UPSPCAnywhere or Remote DesktopBackup capabilityConnected to the internet and access to the Prelude database server
© 2007 Activant Solutions Inc. All Rights Reserved
16Software Required on Web Server
Web Server software (typically IIS)Java JDK 1.4 or aboveServlet Engine (typically Servlet Exec)Preludes Java based XML parsing libraryPreludes Java based Supply Chain ServletsPreludes Java based SCI document objects
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
17
Software Required On RS6000
Redback (more on this later)Apache Tomcat if running everything through RS6000 and Uniobjects
Prelude connection accountMoving to standard ADS accounts on new installs
Prelude SCI API programs
© 2007 Activant Solutions Inc. All Rights Reserved
18
Agenda
What is SCI and XMLHardware and SoftwareServletsXML Parsing and SCIPrelude and SCISCI Example
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
19
Servlets - What Are They?
Java program running on a specified URLServlet Engine handles HTTP request to the URL and forwards them to the servlet for processingRequest and response types of transactionsRequest is typically XML document or java objectResponse is also an XML document or java Object
© 2007 Activant Solutions Inc. All Rights Reserved
20ServletExec Servlet Example
Request and
Response
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
21
Agenda
What is SCI and XMLHardware and SoftwareServletsXML Parsing and SCIPrelude and SCISCI Example
© 2007 Activant Solutions Inc. All Rights Reserved
22
XML Document Parsing
XML documents are mapped into document specific configuration
Purchase Order, Invoice, Sales Order, etc
These XML document specific configurations are mapped back to a Prelude master configuration for standardization across different XML standards
Master data layout
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
23
XML Document Parsing
SAX – Simple API for XMLBased on two interfaces
XMLReader - ParserContentHandler – Data Listener
Data received by the content handler is translated according to the document specific configuration
© 2007 Activant Solutions Inc. All Rights Reserved
24
XML Document Parsing
Data is transformed into the appropriate Supply Chain java object according to the Prelude master configurationGenerated Supply Chain java object is used to finish processing the request
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
25
Document Specific Configuration - PO
Ship-to name mapped back to PSI Master Configuration
© 2007 Activant Solutions Inc. All Rights Reserved
26
PSI Master Configuration - POShip-to name In PSI Master Configuration
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
27
Supply Chain Java Object - POShip-to name In SCI Java Object
© 2007 Activant Solutions Inc. All Rights Reserved
28
XML Document Parsing
Generated Supply Chain object is passed to the appropriate Supply Chain servlet for processingSupply Chain servlet makes call to Prelude through Redback to generate the Sales OrderSuccess or failure of the transaction is returned to the Supply ChainSupply Chain responds with the appropriate XML response
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
29
Outgoing Documents
Request generated from within ADS (round robin concept)
Prelude makes a request to the web serverWeb server calls back to Prelude to get dataData is forwarded to the external business partner
Request generated from outside business partner
Business Partner request document thru SCIWeb server calls back to Prelude to get dataData is forwarded to the business partner
© 2007 Activant Solutions Inc. All Rights Reserved
30
Why the round robin concept?
To provide one single interface regardless of the originating system so that Prelude uses the same interface as another system
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
31
Agenda
What is SCI and XMLHardware and SoftwareServletsXML Parsing and SCIPrelude and SCISCI Example
© 2007 Activant Solutions Inc. All Rights Reserved
32
ADS Supply Chain Maintenances
ViaWeb PoliciesWeb User Maintenance
Flat File Interface ProcessingPartner MaintenanceDocument Processor
Redback
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
33
Web Policy Properties Settings
URL for main SCI
servlet
© 2007 Activant Solutions Inc. All Rights Reserved
34
Web User Maintenance
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
35
Interface Partner Maintenance
Used to setup business partners you will exchange documents withDefines document types you will exchange with the business partnerDefines where the documents for the business partner will be delivered
© 2007 Activant Solutions Inc. All Rights Reserved
36
Interface Partner Maintenance
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
37
Interface Partner Maintenance
© 2007 Activant Solutions Inc. All Rights Reserved
38
Interface Partner Maintenance
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
39
Interface Partner Maintenance
© 2007 Activant Solutions Inc. All Rights Reserved
40
Document Processor
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
41
Redback
Redback is the tool used to move data back and forth from the web server to ADS and from ADS to the web serverOn the web server, Redback uses a set of java API’s called RedBeans to access Redback on the RS6000Redback must be running at all times to allow communications between the web server and the RS6000
© 2007 Activant Solutions Inc. All Rights Reserved
42
Redback Maintenance
startrgwStarts the redback scheduler
stoprgwStops the redback scheduler
restartrgwStops and starts the redback scheduler
showrgwShows the current status of the redback scheduler
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
43
Redback Maintenance
© 2007 Activant Solutions Inc. All Rights Reserved
44
Uniobjects
Provides a means to pass data from servlets to Prelude database through calls to Unidata subroutinesAllows for direct file accessConnects from different environments such as Visuals Basic, Java, .Net
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
45
Agenda
What is SCI and XMLHardware and SoftwareServletsXML Parsing and SCIPrelude and SCISCI Example
© 2007 Activant Solutions Inc. All Rights Reserved
46
SCI Example Amazon.com
Transactions involvedInventory Snapshot
Nightly / Net Change
Incoming POOrder responseAdvance shipment noticeConsolidated invoice
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
47
Web User Maintenance
© 2007 Activant Solutions Inc. All Rights Reserved
48
Interface Partner Maintenance
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
49
Interface Partner Maintenance
© 2007 Activant Solutions Inc. All Rights Reserved
50
Web Policies Properties
SCI Servlet
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
51
Inventory Snapshot
© 2007 Activant Solutions Inc. All Rights Reserved
52
Inventory Snapshot
Inventory snapshot build routine is runRoutine selects all AMAZON qualified products and populates a snapshot ‘tickler file’Tickler file is selected during the execution of the scheduled document processorTickler file is processed and data sent to the SCI servlet defined in web policies properties
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
53
Inventory Snapshot
Servlet takes data from back-end and transforms it into an XML documentXML document is deposited into the AS2 XML outbound directoryAS2 software sends document to Amazon.com Copy of XML document is stored in the ARCHIVE folder on the web server
© 2007 Activant Solutions Inc. All Rights Reserved
54
AS2 Software
Uses S/MIME packaging and authentication with public key infrastructure for encryption of transmissionsUses MDN’s to prove that you received a message and that a message was sent
Message Disposition Notification
AS2 is EDI over HTTP in real timeSupports retransmission of data
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
55
Incoming PO
User shops on Amazon.com and submits an order that will be filled by the distributorXML version of the order is transmitted through AS2 software at Amazon’s end to the distributor’s web serverAS2 software on the distributor’s end sends the XML document to the distributor’s SCI servlet
RCVAmazonProcess
Copy of document is written out to the RCV folder on web server
© 2007 Activant Solutions Inc. All Rights Reserved
56
Incoming PO
RCVAmazonProcess parses the XML document according to the correct configuration fileDocument ends up as a Supply Chain Interface purchase order object after parsedParsed purchase order object is sent to back-end database and processed thru DOE processingDOE checks to see if the customer that the created order is for is associated with an interface partner in Prelude
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
57
Order Response
Document processor selects the tickler file for the order responseOrders are processed and if all items are pickable then a SUCCESS response is generatedIf items are backordered then the entire order is deleted and FAILURE response is generatedOrder Response is transmitted to the SCI servlet
© 2007 Activant Solutions Inc. All Rights Reserved
58
Order Response
SCI servlet transforms the response to an XML document and deposits it in AS2 software XML outbound directoryCopy of XML document is kept in the ARCHIVE folder on the web server
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
59
Advance Shipment Notice
/RCE checks to see if the customer is associated with an interface partner in Prelude and has an IOASN type of transaction set upIf so, then the release is written out to a tickler file for ASN processingDocument processor selects the tickler file for the ASNASN is processed and if all items were shipped then a SUCCESS response is generated
© 2007 Activant Solutions Inc. All Rights Reserved
60
Advanced Shipment Notice
If items could not be picked, then a FAILURE response is generatedASN response is transmitted to the SCI servletSCI servlet transforms the response to an XML document and deposits it in the AS2 software outbound directoryCopy of the XML document is kept in the ARCHIVE folder on the web server
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
61
Consolidated Invoice
Invoice processing occurs as normalCustomer maintenance is changed to use consolidated invoicing on a daily basisThe SCI consolidated invoice process is run to populate the appropriate tickler fileDocument processor selects the tickler file for consolidated invoices
© 2007 Activant Solutions Inc. All Rights Reserved
62
Consolidated Invoice
Consolidated invoices are processed and passed to the SCI servletSCI servlet transforms the response to an XML document and deposits it in a AS2 software XML outbound directoryCopy of XML document is kept in the ARCHIVE folder on the web server
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
63
Other Integrations
AribaAllows for punchout sites from the Ariba NetworkUses a combination of SCI module and VIAVIA is the presentation and shopping interface SCI is the user authentication and order submission interfaceOracle, OCI, and Aeroxchange punchout abilities also supported
© 2007 Activant Solutions Inc. All Rights Reserved
64
Other Integrations
ToroSpecific to TORO distributorsInventory availabilities
Real time Nightly snapshot
Incoming POsOrder acknowledgmentsRebatesWarranty claimsInvoices
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
65
Additional Resources
Contact [email protected] for further information or questions on SCI and XMLContact Jack Pilversack for licensing information
© 2007 Activant Solutions Inc. All Rights Reserved
66
Suggested Action Plan
Contact Jack Pilversack or VIA support to get started or to get further information on how you might be able to use the Supply Chain Interface
Summit 2007: Get Connected
© 2007 Activant Solutions Inc. All Rights Reserved
67
Summary
Increase efficiencies with SCI and XMLRequired hardware and softwareExplanation of servletsExplanation of XML parsing and SCI Description of Prelude and SCI
© 2007 Activant Solutions Inc. All Rights Reserved
68
Thank You for Attending
W408 – Supply Chain XMLSteve KraemerPlease submit the Session Feedback Form
To receive NASBA credits, please be sure to complete the Session Feedback Form and sign the class roster in the back of the room
Session Feedback Form Summit 2007 – Las Vegas, NV
Please take a moment to evaluate this session and offer feedback. Activant uses your input to understand your needs and to determine future Summit sessions.
Session Name: Session Number:
Presenter’s Name:
How important is this topic to your job/company? 1 2 3 4 5
Not Important Important
Please rate the educational value you received from this session. 1 2 3 4 5
Low Value High Value
1. What software are you currently using?
2. How long have you personally used this software?
3. Describe the effectiveness of your instructor.
4. What is your overall evaluation of this session?
5. What could have been done to improve this session?
6. What sessions would you like to see presented at future conferences?
7. What issues will be critical to your business in the next 12-24 months?
Check here if you would like CPE credits. To receive credits, be sure to sign your name at the bottom of this form and sign the roster in the session room.
Answering the following questions is OPTIONAL (but required for CPE Credits).
Yes No
Did this session meet your expectations, based on the description/objectives in the registration materials?
Were the pre-requisite requirements stated in the course description appropriate?
Did the session materials contribute to achieving the learning objectives?
Did the equipment (screen, microphone, projector, etc.) in the room enhance the instruction?
Was the time allotted for the session appropriate for the topic?
Name:__________________________________________________________________________________________________
Company:_____________________________________________________ E-mail:___________________________________