Communication MANTIS <> OCI

Version 2.1
Communication MANTIS <> MaComu
Version 2.1

Inhalt
1 Introduction .................................................................................................................... 3

2 Application information................................................................................................... 3

3 Requirements ................................................................................................................ 3

4 Configuring the communication ..................................................................................... 4

4.1 Starting "MANTIS Configuration" ....................................................................................................... 4

4.2 Selecting the "OCI" connection .......................................................................................................... 4

4.3 Settings for the "OCI" connection ...................................................................................................... 4

5 Procedure ...................................................................................................................... 5

6 Function overview .......................................................................................................... 7

6.1 Request order form or OCI order ....................................................................................................... 7

Page 2
Communication MANTIS <> MaComu
Version 2.1

1 Introduction
This document describes how MANTIS can exchange data with a web application via the Open Catalogue
Interface (OCI) .

2 Application information
• The dot indicates individual steps.

> The arrow indicates important information.

Menu itemsubmenu item indicates a specific selection in the menu.

Cancel button indicates a button in the program. In this instance the Cancel button.

Selection window indicates a window. In this instance the selection window.

CTRL key indicates a key on the keyboard. In this instance the CTRL key.

3 Requirements
• OCI release 3.0 or higher
• MANTIS version 5.9 or higher
• Microsoft Internet Explorer 8.0 ® or higher

Page 3
Communication MANTIS <> MaComu
Version 2.1

4 Configuring the communication

All settings are made in the "MANTIS Configuration" programme.
> This is either automatically called up when MANTIS is installed for the first time, or you can start the
programme in MANTIS.

4.1 Starting "MANTIS Configuration"

Proceed as follows to start the "MANTIS Configuration" programme:
• Start MANTIS.
• Select the ProgramConfiguration path in the menu bar.
The MANTIS Configuration window is displayed.

4.2 Selecting the "OCI" connection

• Select COMMUNICATION Connections Current connection.
• Click the currently selected connection on the right in the Current connection line, or click into the blank
line.
• Choose OCI in the selection.

4.3 Settings for the "OCI" connection

• Make the required settings for the connection you want.

UTF-8
• Choose "UTF-8" if the data is to be transmitted UTF-8 encoded.
Create order form automatically
• Choose "Create order form automatically" if a new order form should be automatically created in MANTIS
when an order is taken in.
Currency
• Change the value for "Currency". See Function overview <Price Currency="EUR">.
Partner ID
• Change the value for "Partner ID". See Function overview <PartnerID>MAN-9999</PartnerID>.
Product type
• Change the value for "Product type". See Function overview <Product ProductType="Teil">.
ISO-639-1 language code
• Change the "ISO-639-1language code". If this is blank, the code for the language currently selected in
MANTIS will be used.
Server port
• Change the "Server port". This should match the URL in the web application.

• Click the SAVE button.

Or
• Click the FINISH button. If any modifications have been made, the system will ask you whether you want
to save the modified configuration.
• Click the Yes button to save the modified configuration.
• Click the No button to discard the modified configuration and close the programme.
• Click the Cancel button to return to MANTIS Configuration.
Modifications will not be saved.

MANTIS Configuration will be closed and MANTIS restarted if you saved modifications.

Page 4
Communication MANTIS <> MaComu
Version 2.1

5 Procedure
The web application initiates a request to MANTIS in order to transmit data from MANTIS to the web
application.
MANTIS intercepts this request and then sends the contents of the order form (XML data) back to the web
application.

MANTIS Web Application

2 Receive call Http Request Call up URL by HOOK_URL 1

Order form is created or an existing

3
one is selected

4 Fill items in order form

5 Send order form back as XML Http Response Process order form data (XML) 6

7 End of transaction in MANTIS

No. Description
1 The following URL is called up in the web application:
http://localhost:<portnr>?action=login&username=mantis&password=mantis&HOOK_URL=<hookurl>

portnr can be configured (default 1024), see Configuring the communication.

hookurl the answer is sent to this URL. See SAP document (OCI_Release3_0.pdf)

2 MANTIS must be started so that the call can be intercepted. The parameters are verified and the
hookurl read out.

3 If "Create order form automatically” was selected, the New window is displayed.

A temporary order number is automatically used as the order form name.

• Click into the "Name of orderform" field to change this.
Or
• Click the OK button to create the order form.
Or
• Click the Abort button if you do not want to create this order form and instead want to select another
order form.

The temporary order number is also displayed in MANTIS.

Page 5
Communication MANTIS <> MaComu
Version 2.1

4 The order form can now be populated with the desired items.

5 The order form is transmitted to the web application by clicking the right mouse button in the selected
order form. Select Transfer all in the context menu.

Answer the request for confirmation by clicking the Yes button.

The order form can now be deleted.

6 Items can then be processed in the web application.

7 The temporary order number is removed in MANTIS once the operation is complete.

Page 6
Communication MANTIS <> MaComu
Version 2.1

6 Function overview
MANTIS provides the following functions for the selected connection:

Web application > MANTIS (server)

No. Function Description
103 Request order form or OCI order Order form from MANTIS is requested by a web application

6.1 Request order form or OCI order

Client/server Web application/MANTIS
Function 103
Description Requests order form or OCI order
Structure <BusinessDocument>
<CatalogHeader/>
<Catalog>
<Product ProductType="Teil"> For each item number <Product> tag,
<ParentCategoryID>28010300</ParentCategoryID> product type
<ProductID Code="Other">81.19220-0422</ProductID> Material group number
<Description Language="DE">Covering</Description> Item number
<ShoppingBasketItem> Language code and designation
<Quantity UoM="C62">1</Quantity>
<NetPrice> C62=piece, quantity
<Price Currency="EUR">0.0</Price>
<PriceUnit>1</PriceUnit> Currency and Price
</NetPrice> Price unit
<LeadTime>99</LeadTime>
</ShoppingBasketItem> Delivery time
<VendorDescription>
<PartnerID Code="Other">MAN-9999</PartnerID>
</VendorDescription> Supplier code and Partner ID
</Product>
</Catalog>
</BusinessDocument>
Colour coding:
Constant values
Values/item from MANTIS
MANTIS Configuration Communication/Connection/Current connection/OCI

Page 7
Communication MANTIS<>OCI | englisch | 04.2014
© 2011 - 2014 LexCom Informationssysteme GmbH, D-80686 München.
Text and illustrations not binding.
Subject to change through technical progress.
Printed in Germany.

MAN Truck & Bus AG

Postfach 500620
D-80976 München

www.mantruckandbus.com

MAN Truck & Bus – A Member of the MAN Group