ERP Integrator V2 - Online Help
ERP Integrator V2
Questions / Feedback?

SapABAPCode Component

Properties   Methods   Events   Configuration Settings   Errors  

The SapABAPCode provides an easy way to execute ABAP code on a remote R/3 (NetWeaver) system.

Syntax

nsoftware.InERP.Sapabapcode

Remarks

The purpose of this component is to make executing ABAP code on a SAP server extremely simple.

There are just a few steps you need to make before you can begin executing ABAP code: First you set your connection credentials and connect to the SAP system (see Setting Up a Connection with a SAP System for details).

Then simply add the CodeLines and then call ExecuteCode. Once ExecuteCode has successfully returned, the resulting lines will be populated in ResultLines.

The following example shows how to execute some simple ABAP code on the SAP server. First we provide login credentials and connect.

  SapClient1.SapConnection.ConnectionType = ConnectionTypes.ctNetWeaver;
  SapClient1.SapConnection.Client = "000";
  SapClient1.SapConnection.Destination = "";
  SapClient1.SapConnection.Host = "localhost";
  SapClient1.SapConnection.User = "BCUSER";
  SapClient1.SapConnection.Password = "minisap";
  SapClient1.SapConnection.SystemNumber = 0;
  SapClient1.OpenConnection();
Note that the credentials above are for connecting to a trial NetWeaver installation. You will need to provide your own credentials when connecting to your own SAP installation.

Now we will provide the lines of code we wish to execute and then execute them on the server.

  SapAbapCode1.CodeLines = "REPORT EXTRACT LINE-SIZE 255 NO STANDARD PAGE HEADING.\n"
      + "TABLES: USR02.\n"
      + "SELECT * FROM USR02.\n"
      + "  WRITE: / USR02-BNAME, USR02-BCODE.\n"
      + "ENDSELECT.";
  SapAbapCode1.ExecuteCode();
Note that the code lines must no more than 72 characters long and be terminated by either a CR, LF, or CRLF. To output the results, you can do this:
  Console.WriteLine(SapAbapCode1.ResultLines);
The above code should output something similar to this:
BCUSER       299A15CAA9831803
DDIC         F34FC4466D323C60
SAP*         F4CE7D330D91AAB6
SAPCPIC      7D806C248F03813D
TMSADM       942B9DC0F2394D85
Note that the result lines will always be less than 72 characters long and each line will be terminated by an LF.

Dependency Notes

If the component is not configured to use the SOAP interface, it will use the sapnwrfc.dll, librfc32.dll, librfc32u.dll, or the Java Connector (JCo) to connect to the SAP system. Although the Java Connector is only available when programming in Java on Windows.

The NetWeaver RFC SDK (sapnwrfc.dll) offers both a 32 bit and 64 bit version. Likewise, the SAP RFC SDK offers as 32 bit and 64 bit version of both a unicode (librfc32u.dll) and non-unicode (librfc32.dll) library.

The NetWeaver RFC SDK will be used if the ConnectionType is set to ctNetWeaver (0). The following libraries from the NetWeaver RFC SDK must be available at runtime:

  • sapnwrfc.dll
  • icudt30.dll
  • icuin30.dll
  • icuuc30.dll
  • libicudecnumber.dll
  • libsapucum.dll
Note that the dll names may be different depending on the version of the SAP RFC SDK installed. The examples above are for version 3.0.

The non-unicode library will be used if the ConnectionType is set to ctClassic (1). This simply requires that the librfc32.dll be placed in a location that is accessible at runtime. (0).

The unicode library will be used if the ConnectionType is set to ctClassicUnicode (2). The following libraries from the SAP RFC SDK must be available at runtime:

  • librfc32u.dll
  • icudt30.dll
  • icuin30.dll
  • icuuc30.dll
Note that the dll names may be different depending on the version of the SAP RFC SDK installed. The examples above are for version 3.0.

The Java Connector (JCo) will be used if the ConnectionType is set to ctJavaConnector (4). In order to use this, you must first add the sapjco3.jar file to your project.

The 32 bit and 64 bit versions do not require any special settings within the components. The only requirement is that your application target the same platform as the DLL.

Property List


The following is the full list of the properties of the component with short descriptions. Click on the links for further details.

CodeLinesThe lines of ABAP code.
ConnectedIndicates whether or not the component is connected to the SAP system.
ResultLinesThe results after executing the ABAP code.
SapAttributesDescribes the SAP R/3 system you're connected to.
SapConnectionThese properties are used to connect to the SAP system.
SSLAcceptServerCertInstructs the component to unconditionally accept the server certificate that matches the supplied certificate.
SSLCertThe certificate to be used during SSL negotiation.
SSLServerCertThe server certificate for the last established connection.
TimeoutLength of time in seconds the component waits for a response from the SAP system.

Method List


The following is the full list of the methods of the component with short descriptions. Click on the links for further details.

AbortConnectionUsed to terminate a connection to the SAP system.
CloseConnectionCloses a connection to the SAP system.
ConfigSets or retrieves a configuration setting .
DoEventsProcesses events from the internal message queue.
ExecuteCodeExecute ABAP Code.
GetAttributesRetrieves attributes about the SAP system you're currently connected to.
InterruptInterrupt the current method.
OpenConnectionOpens a connection to the SAP system.
ResetResets the component to its initial state.

Event List


The following is the full list of the events fired by the component with short descriptions. Click on the links for further details.

ErrorInformation about errors during data delivery.
SSLServerAuthenticationFired after the server presents its certificate to the client.
SSLStatusShows the progress of the secure connection.
StatusDetailed status messages for debugging purposes.

Configuration Settings


The following is a list of configuration settings for the component with short descriptions. Click on the links for further details.

ResultEOLDetermines the EOL for the result lines.
LogPerformanceDataLogs the performance information when a function is called.
LogRawDataLogs the raw data being sent and received.
ParseTablesIndicates whether to parse tables into rows and columns.
ResponseParamText[i]The value of the PARAMTEXT for the specified reponse parameter.
RequestParamText[i]The value of the PARAMTEXT for the specified request parameter.
GroupThe logon group.
MessageServerService name of load balancer service.
SncLibPathThe external security product's library.
SncModeThe SNC activation indicator.
SncNameThe Initiator's SNC name.
SncPartnerNameThe communication partner's SNC name.
SncQopThe quality of protection level.
SystemIDThe system ID of the SAP system.
LocalHostThe IP address of the local interface.
ProxyAutoDetectWhether or not to automatically detect and use proxy system settings, if available.
ProxyAuthorizationThe authorization string to be sent to the proxy server.
ProxyAuthSchemeThe authorization scheme to be used for the proxy.
ProxyPasswordA password if authentication is to be used for the proxy.
ProxyPortPort for the proxy server (default 80).
ProxyServerName or IP address of a proxy server (optional).
ProxyUserA user name if authentication is to be used for the proxy.
FirewallAutoDetectTells the component whether or not to automatically detect and use firewall system settings, if available.
FirewallHostName or IP address of firewall (optional).
FirewallPasswordPassword to be used if authentication is to be used when connecting through the firewall.
FirewallPortThe TCP port for the FirewallHost;.
FirewallUserA user name if authentication is to be used connecting through a firewall.
FirewallTypeDetermines the type of firewall to connect through.
CodePageThe system code page used for Unicode to Multibyte translations.

 
 
Copyright (c) 2017 /n software inc. - All rights reserved.
Build 2.0.6240.0