Quick steps for the ALE Module
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 |
none |
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> |
Generating a business object in the ALE Module
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.
Editing the business object
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).
Preparing the ALE Module for testing
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.
Testing request processing for the ALE Module
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.
Testing event processing in the ALE Module
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.
