Before you configure the ALE module, create the following
persistent WebSphere MQ queues:
- SAPtid_Queue
- SAPtid_QueueManager
- SAPALE_Event_Queue
- SAPALE_Wip_Queue
- SAPALE_Archive_Queue
- SAPALE_UnSubscribed_Queue
- SAPALE_Error_Queue
Refer to the MQ Series documentation for information on creating
MQ Queues.
Next, configure the following connector-specific properties:
Property
Name |
Default
Value |
Value
Needed |
Modules |
Extension |
Ale |
AleEventDir |
none |
%CROSSWORLDS%\connectors\SAP\ale |
SAPtid_QueueManager |
none |
<Queue
Manager name> |
SAPtid_Queue |
none |
<Queue
name> |
SAPALE_Event_Queue |
none |
<Event
Queue name> |
SAPALE_Wip_Queue |
none |
<WIP
Queue name> |
SAPALE_Archive_Queue |
none |
<Archive Queue name> |
SAPALE_UnSubscribed_Queue |
none |
<UnSubscribed Queue name> |
SAPALE_Error_Queue |
none |
<Error
Queue name> |
RfcProgramId |
none |
<Program ID name defined in SAP Transaction sm59> |
NumberOfListeners |
1 |
1
(for single-threaded) |
For remote WebSphere Queues, also configure the following
properties:
Property
Name |
Default
Value |
Value
Needed |
SAPtid_QueueManagerLogin |
none |
<Queue
Manager login> |
SAPtid_QueueManagerPassword |
none |
<Queue
Manager password> |
SAPtid_QueueManagerHost |
none |
<Queue
Manager host> |
SAPtid_MQPort |
none |
<MQ
port> |
SAPtid_MQChannel |
none |
<MQ
channel> |
To generate a business object in the ALE module:
- Start the SAP ODA.
- Start the business object designer.
- In the business object designer, choose File > New. The
wizard starts.
- Select Configure Discovery:
- Enter the host address for the machine where Discovery is
running.
- Choose Add Host.
- Choose OK.
- In Step 3 of the wizard, expand IDoc Types.
- Expand Generate From System.
- Expand Basic IDoc Types.
- Right-click Select by Name...
- Select Search for Items...
- Type orders03. Choose OK.
- Highlight ORDERS03. Choose Next.
- Choose Next.
- Choose OK. The business object generates.
- Select "Save a copy of business object definitions to a
separate file" and select "Open new business object definition to a
separate window". Choose Finish.
To edit the business object:
- Choose the General tab.
- Change Create Application-specific information message type to
MsgType = ORDERS.
- Open %CROSSWORLDS\repository\SAP\BO_SAPIDocControl.txt
and save it to the Repository directory.
- Add the parent object name to the Supported Business Objects
section of the configuration file.
- Register the RFC Server Module with the SAP Gateway, using SAP
transaction SM59.
- Ensure the following:
- That the logical systems are defined and assigned for the SAP
system and external system (SALE).
- That the distribution model has been maintained and that the
required message types have been added to the model (transaction
code BD64).
- That there are partner profiles for the logical systems or
distribution model (transaction code WE20).
- That there are ports defined for the logical systems or
distribution model (transaction code WE21).
To set up the ALE module for testing, use Port Connector:
- Copy the SAP configuration file. Rename the copied file
portconnector.cfg.
- Open portconnector.cfg in Connector Configurator.
- Change the following properties in the Standard tab:
- ApplicationName to PortConnector
- DELIVERYQUEUE to REQUESTQUEUE
- REQUESTQUEUE to RESPONSEQUEUE
- Save changes. Close portconnector.cfg.
- Open sapconnector.cfg.
- Save the change. Start mySAP.com.
To test the ALE module:
- Open Test Connector.
- Choose File > Create/Select Profile.
- Choose File > New Profile.
- Select Browse.
- Choose Open.
- For Connector Name, enter PortConnector.
- For Broker Type, enter WMQI.
- Choose OK.
- Highlight PortConnector. Choose OK.
- Choose File > Connect.
- Create a business object instance:
- For BO Type, select sap_order03.
- Choose Create.
- In Enter Name, type new object. Choose OK.
- Change the verb to Create.
- Right-click Control Record. Choose Add Instance.
- Expand Control Record. Populate these fields:
- IDoc_number
- Sender_port
- Partner_number_of_sender
- Receiver_port
- Partner_number_of_recipient
- Client
- SAP_Release
- Start the connector.
- In Test Connector, choose Request > Send. Check the log for
a success message.
To test event processing in the ALE module:
- Go to transaction we19, Test Tool for IDoc processing.
- Populate the field with an existing IDoc. Choose IDoc >
Create.
- Choose StandardOutboundProcessing to send an IDoc to the test
connector.
- In the pop-up window, choose the check mark.
- To verify that the IDoc was sent from SAP, check the mySAP.com
connector log file for a success message. If the event exists in
transaction sm58, then it was not sent correctly.
- View the message that was sent to the
SAPALE_Archive_Queue to verify that the ProcessingStatus
was successful. If you do not see a success message, check the
SAPALE_Error_Queue to see if a failure occurred.
