IntegrationsConfigure SAP ERP for BC-XOM Communication

If you intend to support SAP BC-XOM integrations, then you must configure SAP ERP to permit integration of the full BC-XOM interface with Loftware Enterprise SP. More than one integration may point to the same SAP Application Server, but each SAP BC-XOM integration must be configured to refer to a different Output Management System (OMS).

Note: These steps are required only if you intend to support SAP BC-XOM integrations.

These procedures should be performed within the SAP Application Server by a system administrator. You must use an SAP user account with administrative access to the SAP Spool Administration (SPAD) and related transactions.

Before You Begin: You must perform configuration and installation tasks to prepare for Integration for use with SAP® Applications. For more information, see Preparing for Integration for Use with SAP® Applications.

The following procedures begin from the SPAD transaction with either Extended or Full Administration Mode enabled at the transaction.

Configure the Real Output Management System (ROMS)

You must configure the Real Output Management System (ROMS) so that SAP ERP can initialize the OMS component of Loftware Enterprise SP.

  1. From the main SPAD screen, click Full administration.
  2. Click the Output management systems tab, and then next to Real Output Management Systems click Display. The list of ROMS is displayed.
  3. Click Edit to edit the list of ROMS.
  4. Click to create a new ROMS.
  5. In the OMS Description section, enter a name and a description.
  6. In the OMS Attributes section:
    1. In the Tasking subsection, select Command line.
    2. In the Job Status subsection, select Callback.

  7. Save the ROMS.

Configure the Logical Output Management System (LOMS)

You must configure the Logical Output Management System (LOMS). This is what SAP ERP uses to submit jobs to Loftware Enterprise SP.

  1. From the main SPAD screen, click Full administration.
  2. Click the Output management systems tab, and then next to Logical Output Management Systems click Display. The list of LOMS is displayed.
  3. Click Edit to edit the list of LOMS.
  4. Click to create a new LOMS.
  5. Assign a Name and Description for the LOMS.
  6. On the SAP configuration tab:
    1. Select the ROMS that your created in the previous section.
    2. Select the same instance from the previous section as the Target for callback.

    SAP Spool Administration LOMS Screen

  7. Save the LOMS.

Configure LOMS Commands

You must specify the command to be issued when the LOMS is invoked.

  1. From the LOMS display screen, enter the Commands screen by clicking the cascading paper icon.
  2. Select the Operating System under which SAP ERP is running.

    SAP Spool Administration Operating System Commands Screen

  3. In the Command path section, set the working directory where the Loftware Integration Command Line Interpreter (CLI) for SAP Applications is installed on the SAP Application Server.

    Important! The path entered must end with a slash or backslash as appropriate to the operating system.

    Note: This path was determined by the administrator who installed it. For information about Loftware Integration Command Line Interpreter (CLI) for SAP Applications, see Getting Started with Loftware Integration Command Line Interpreter (CLI) for SAP® Applications.

  1. In the OMS commands section, for the Submit command enter the command to run the Loftware Integration CLI for SAP Applications. The syntax for the command is as follows. For the last parameter FileType, enter RDI, XSF, XML, or XFP as appropriate.

    runcli.cmd https://<LoftwareServerIPAddress>:<port>/spectrum-server/int/sbpj "n=<IntegrationName>" "&EI" "&EG" "&P" "&F" "&ES" <FileType>

    Example

    runcli.cmd https://example.com:8443/spectrum-server/int/sbpj "n=bcxom1" "&EI" "&EG" "&P" "&F" "&ES" RDI

    ParameterDescription

    LoftwareServerIPAddress

    The IP address of the Loftware Application Server. Due to the character limit for commands, it is recommended that you use a numeric IP address rather than a name.

    IntegrationName

    The name that you will give to an SAP BC-XOM integration in Loftware Enterprise SP.

    Important! When you create the integration in Loftware Enterprise SP, you must use the same integration name that you used in the Submit command.

    FileType

    The type of file — RDI, XSF, XML, or XFP.

    Important! The length of the Submit command is restricted by the 132 character limit on the length of commands. You must ensure that the integration name is short enough to avoid exceeding the limit. To minimize the length of the command, you can use the numeric IP address for the Loftware Application Server.

    Note: Avoid using spaces within the path if possible.

  1. Save the command and return to the SPAD screen.

Configure an Output Device

To finish connecting SAP ERP to the Loftware Integration Command Line Interpreter (CLI) for SAP Applications, you must configure an SAP Output Device and associate it with the LOMS.

  1. Click the Devices / servers tab, and next to Output Devices click Display. The list of Output Devices is displayed.
  2. Click Edit to edit the list of Output Devices.
  3. Click to create a new Output Device.
  4. On the DeviceAttributes tab, for the Device Type select the appropriate device type:
    • RDI: UTF-8 PLAIN
    • XSF: SAP Smart Forms
    • XFP: XFP

    If you do not have an appropriate device type in your SAP ERP environment, contact your SAP Basis Administrator to request that an appropriate device type be created for use with Loftware Enterprise SP.

  5. On the Access Method tab:
    1. Set the Host Spool Access Method to E: External output management system.
    2. Set the Host printer name.
    3. Set the Logical OMS to the one that you created.
    4. Save the Output Device.

Important! For each SAP Output Device to be used with Loftware Enterprise SP, you must configure a corresponding device in Loftware Enterprise SP.

If you are going to use XML for Smart Forms (XSF) files, continue to Configure SAP ERP for Smart Forms. Otherwise, proceed to Integrate with SAP BC-XOM to configure an SAP BC-XOM integration in Loftware Enterprise SP.