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.
- Select the 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.
