xa system-link a powerful development tool denise luther [email protected]
TRANSCRIPT
2-2
What is System-Link?
Bridge between XA and other systems Inquiry Maintenance
XML – Standard interface Other ERP systems Other platforms
Part of Power Architecture CSM, PM, OBPM, EPDM, MM… CO’s, PO’s, MO’s, Engineering…
Why use System-Link
2-3
Replacement for offline loadAccess any object available in Power-Link Only certain files are available for offline loadSecondary objects can be accessedExtra fields defined by userNon-XA Primary objects can be accessedAdd, Change and Delete are supportedPower-Link edits are enforcedIncluding user defined edits
Why use System-Link
2-4
System-Link handles:Database files and fieldsLogical fieldsBusiness rulesEditingUser ExitsSecurity
You also get Release TransparencyNo worries about release upgrades
2-5
Methods to connect
System-Link Simulator Use for testing/troubleshooting
Directly to System-Link via LPI RPG/CL programs
To web server via XML Web pages – Java/HTML
Web Services Anything Microsoft-enabled Requires Enterprise Integrator
IBM’s WebSphere MQ Global enterprises Requires IBM products
2-6
System-Link References
System-Link User Guide – Release 7.7 Download from Infor website
Documentation Product Manuals
Miscellaneous SYSL
System-Link Installation Instructions R7
Configuring WAS 5.0 Express on W2K for System-Link R7 (SH14777) Servlet
information
2-7
Managing System-Link
Use Link Manager to manage System-Link processes
By environmentBy machine
Distribute server load across resources
2-8
Managing System-Link
System-Link processes must be started Autostart System-Link
Options at environment level
2-9
Managing System-Link
Link Manager Green circle means started Right click to start/stop/restart/Move
2-10
Managing System-Link
2-11
System-Link Simulator
URL points to your host server Make a desktop shortcut or
bookmark
2-12
Using System-Link Simulator
Display PO’s for vendor 100 – Restricted List, navigate from Vendor object
Navigation/System-Link request Not required to create System-Link
requests but it makes the job easy
2-13
System-Link REQUEST
2-14
Paste from clipboard
2-15
Variables
2-16
Check the response
2-17
2-18
Make adjustments
Deleted e
2-19
Request has errors – Check the response
Update System-Link Command
Requesting System-Link from Card File
Copying a Create System-Link Command
2-23
System-Link sessions
ODBCJOBR7/WRKODBCJOB command will allow you to manage System-Link jobs.
2-24
System-Link sessions
IP address of auxiliary server will be System-Linksessions
View job log (Option 10) for troubleshooting
Errors from associated Integrator user exits will be in QSYSOPR message queue
2-25
Local Program Interface
RPG program you call from anywhere PSVPSR1R in AMALIBx
Parameters for the XML to send and receive Inquiry – Request rows (view) or details
(cards) – Receive the results or error
Maintenance – Create records, Update an attribute
– Receive confirmation or error
2-26
LPI Parameters
Parm Description Use Size Type
P#XREQ XML Request I 65,535 A
P#XRSP XML Response O 65,535 A
P#MRQR More records? *YES if more records to return
O 8 A
P#ERFD Internal Errors*YES if response contains errors
O 8 A
P#MSID External ErrorsPSX0122 – System-Link not startedPSX0130 – Response > 65K
O 7 A
2-27
LPI sample
Available as a download SH14873
Illustrate one way of using System-Link with your RPG programs Send a request - Send XML request to LPI Parse the response - Receive and parse XML
response from LPI Create a report of PO’s for a vendor Only change required – Supply data for login
substitutions
2-28
Writing your programs
Sample parsing program USRLPI1R is written generically Can be used for just about any object (use it
for yours) V5R4 New XML functions for parsing
%XML, XML-INTO, %HANDLER, XML-SAX
Sample print program calls the parser field-by-field You can use this technique in your programs There are other techniques
2-29
<Response_sessionHandle='1a5f739:fc75bbe92b:_7aef‘_workHan
<QueryListResponse_name='queryList_PurchaseOrderGeneral‘_r
<DomainEntity_domainClass='com.mapics.pm.PurchaseOrder'
<Key><Property_path='order'>
<Value><![CDATA[P000349]]></Value></Property>
</Key><Property_path_='order'>
<Value><![CDATA[P000349]]></Value></Property><Property_path='vendor'>
<Value><![CDATA[100]]></Value></Property><Property_path='vendorName'>
<Value><![CDATA[Hi_Tech_Corp]]></Value></Property><Property_path='orderStatus'>
<Value><![CDATA[20]]></Value>
Starts a new record
Field values
2-30
FetchNext
Don’t ask for too many records at once. You set the limit with MaxReturned
LPI tells you if there are more. ‘FetchNext’ is the way to get more.
Our sample programs shows you how. Create loop that processes until P#MRQR
= *NO
Supplier Portal - Web application
2-31
Login information used to construct Login tag System-Link request to retrieve P.O. linesAuto content security determines what rows
System-Link request returns rows
2-32
Transactions
User actions on the web page are used to construct a System-Link request to create records in a custom transaction file.
Custom transaction file is a business object with Integrator user exits.
User exits are used to perform work on the host (update flags, dates, create attachments)
Integrator user exits execute if object is being maintained via PowerLink, System-Link or NetLink.
2-33
Custom Forecast Object
Custom objects can be used with System-Link
2-34
