Integrating the Automation Engine in SAP Closing Cockpit with FCC 2.0 Add-on

The SAP Financial Closing CockpitVisualisiert Werte und Zustände der Automation Engine oder von den überwachten und gesteuerten Systemen. Auch ein eigener Objekttyp in der Automation Engine. can be used to schedule several tasks that should be executed in a particular order and at a particular point in time. Through the integration of AE, you can activate objects of an AE system via Closing Cockpit tasks.

You may use an alternative integration method from SAP. You may find the respective SAP website pages at: Creating External Jobs

As of version 11, SAP Closing Cockpit may also be used with the FCC 2.0 Add-on. Below you find the installationnull steps for SAP Closing Cockpit with this Add-on.

Requirements:

Installation

	1.	Decoding the supplied file

• Use the program UCYBCRYP.EXE for decrypting the file SAP_CloCo.zip.ucc. It is stored in the folder IMAGE:\TOOLS\ENCRYPT of the AE CD. Now call the program via the command line using the following parameters:
  
  UCYBCRYP.EXE -d -f SAP_CloCo.zip.ucc -lLicense file
  
  The license file was supplied by our support team  (customer number.TXT).
• The result is the packed file SAP_CloCo.ZIP.
• Unpack the file SAP_CloCo.ZIP.

	2.	Loading SAP transports

Specific ABAP programs are required for the integration process. Load them to the SAP system by means of an import. The archive SAP_CloCo.ZIP includes two corresponding files.

• KNNNNNN.SID - Information file
• KNNNNNN.SID - Data file
• Copy these files to the transport directory of SAP (e.g.: /usr/sap/trans/). Copy the K file to the subfolder "cofiles" and the R file to "data".
• Log on to the SAP system and import the relevant request using the transaction STMS. Select the import option "Ignore Invalid Component Version".

The transport request is based on SAP Closing Cockpit 7.00. Therefore the component would not match, as the FCC 2.0 Add-on might run on 7.40.

• Open and check the request's transport protocol after the import process: all steps have to show the return code 0 (successfully ended) or 4 (ended with warning).

	3.	Configuring the HTTP RFC connection

Call the transaction SM59 and select "HTTP connections to the external server". Now create a new connection.

Enter a name for the RFC destination (e.g.: AE_WEBSERVICE) and a description.

Tab: Technical settings:
In the field Target host, enter the host name of the application server where the AE Internal Webservice runs. Enter the port number in the field Service number.

Tab: Logon and Security:
Select the option Basic authentication. Specify the data for accessing the AE system: in the field User, enter the AE client, user name and the department (separated by a slash). Now enter the password and store the RFC connection.

	4.	Defining the logical port

Start the transaction SOAMANAGER

1. Select the link "Web Service Configuration" ("Service Administration" tab)
2. Search for the object type "Consumer ProxyEigenes Produkt von Automic, das als zusätzliches Dienstprogramm mit der Automation Engine verwendet werden kann.Dienst der Zusammenfassung und Umleitung von CP-Verbindungen." which is named /UC4/CO_UC4PORT_TYPE and select it.
   
   
3. After selecting the object, the following window will open. Click on "Create - Manual Configuration":
   
   
4. In the following dialog, enter "UC4" as "Logical Port Name" and activate the "Logical port is Default" checkbox:
   
   
   Click "Next" to continue.
5. Select "User ID / Password" in the authentication settings.
   Enter a user name using the format <AE Client>/<USER>/<DEPARTMENT>
   Enter the password for this AE user and click "Next" to continue.
6. Enter "/uc4ws/uc4ws" in the "URL Access Path" field.
   Enter the host name where the web service is deployed and its port in the fields "Computer Name of Access URL" and "Port Number of Access URL" as shown below:
   
   
   
   Click "Next" to continue.
7. Select "Suppress ID Transfer" in the Message ID (Synchronous) section:
   
   
   
   Click "Next" to continue.
8. Activate "Suppress sending of IBC Identifier" and click "Finish":
   
   

	5.	Registering the ABAP report for the FCC 2.0 Add-on

1. Execute the program RDDKOR54
2. Enter SCMAPROGRAMS as table name and select "Execute" (F8).
3. Click on the "Create Reservation" (F5) button.
4. Enter "/UC4/*" as namespace and save the changes. The result will look as follows:
   
   
5. Call transaction sm30 and enter the table name SCMAPROGRAMS.
6. Add a new entry with the program /UC4/CC_REPORT and application CUSTOMER
7. Save this entry.

	6.	Testing the connection

Start the program UC4/CC_REPORT via the transaction SE38 to test the connection from ABAP to the AE system.

Add customer exits in /UC4/CC_REPORT program

Business Add Ins (BAdI) are special extensions for SAP. Detailed information is available on the SAP website.
Below you find a description how to use a BAdI with the /UC4/CC_REPORT program.

A BAdI will be added to the /UC4/CC_REPORT program. The default implementation does nothing and the program continues.
You may create another implementation which performs some checks based on the Automic object name and user (SY-UNAME)

>Create a BAdI implementation

The enhancement spot is called /UC4/AUTH_CHECK:

• Select "Create BAdI Implementation" from the context menu.
• The implementation class must implement the /UC4/IF_CC_START_ALLOWED interface.
• This interface has one method called "CHECK" and a parameter UC4OBJECT.

Example

This BAdI can be used to implement a permission check based on a table with user names and job names.

If the user is 'ANG' and the object name is JOBP.TEST1, the program will show a message box with user and object name and exit.

See also:

SAP - Custom Solutions