Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WDESIGNER and version 23.1.1
Div
Classe2e-refDiv

Otp
Floatingfalse

Rp

Children Display
depth1
pageSAP Adapter

Stereotype Attributes

SAPAliasSAP Alias

Multiexcerpt
MultiExcerptNamesap_taggedalias_valuesattributes
Supply the connection protocolSupply the SAP logon clientSupply the maximum system number of parallel connections to the SAP system.

The pool size can be defined per connection string. If you have multiple aliases with the same connection string, the highest value will be used.
The same applies, if you set the values in the SAP adapter settings in the Administration.
If all connections from the SAP connection pool are in use, warnings will be logged to the transaction log each second a service is waiting for connection.

2015-12-08 16:47:24 +0100 0000000182469dcd0001612899fea700e3d869aa 3 SAPConnectionPool 0 OK SAPRFC IO_ENTER PoolExhausted
2015-12-08 16:47:25 +0100 0000000182469dcd0001612899fea700e3d869aa 3 SAPConnectionPool 1000 OK SAPRFC IO_EXIT PoolExhausted

In this case, increase the pool size to solve the problem.

sapTrace
AttributeDescriptionMandatory / OptionalAllowed Valuesprotocol
Name
Specify a name for the alias.mandatoryrfcto use the RFC protocol
trfcto use the tRFC protocol
hostSupply the gateway host name (optional).mandatorya valid SAP host
localhost (default)
any string
Standard
userSupply user and password.mandatorypattern "<user>/<password>"
optionsA blank separated list of name value pairs: name1="value1" name2="value2", and so forth. The possible name value pairs can be found further below.optional
hostSupply the gateway host name (optional)client.mandatorya valid SAP client
userSupply user and password.mandatorypattern "<user>/<password>"
host
localhost (default)
languageSupply the SAP logon language.optional1-byte SAP language like E for English, D for German
2-byte ISO language like EN for English, DE for German
clientSupply the SAP logon client.mandatorya valid SAP clientsystemNumberSupply the system number of the SAP system.optionaldefault = "00"
routerStringThe router string is an additional routing information used by SAP RFC backend clients.
SAP RFC clients prepend the DNS hostname with this string to get an application server name that is resolvable by the RFC library.
optional
systemNumberpoolSize
Multiexcerpt
MultiExcerptNamepool_size
optionaldefault = 10
languageSupply the SAP logon language.optional1-byte SAP language like E for English, D for German
2-byte ISO language like EN for English, DE for German

The effect of this flag being true is two fold:

  1. The SAP RFC libraries will write trace file information (.trc) into the directory the service has been deployed to.

  2. By using the SAP transaction *SMGW (SAP gateway monitor), you can monitor the dataflow from and to the gateway the server is registered on.

The SAP trace level has to be defined in attribute connectionString. See Client Connection Options for a list of the allowed trace level values.

optionaltrueSwitch SAP trace on.
falseSwitch SAP trace off.
optionsA blank separated list of name value pairs: name1="value1" name2="value2", and so forth. The possible name value pairs can be found further below.optional

SAPModuleInterface

This stereotype has no attributes.

SAPRPCOperation

...

MultiExcerptNameSAPRPCOperation
shouldDisplayInlineCommentsInIncludesfalse

...

optional

...

any valid string
default: <soap port type name>_<operation name>_Response

Code Block
<wsdl:message name="myReponseName">
      <wsdl:part name="output" type="stns1:OutputClass"/>

...

optional

...

any valid namespace string
default: urn:<containment tree path>.<port name>

Code Block
<wsdl:input>
    <soap:body [...] namespace="myInputNamespace"/>

...

optional

...

any valid namespace string
default: urn:<containment tree path>.<port name>
Code Block
<wsdl:output>
    <soap:body [...] namespace="myOutputNamespace"/>

SAPParameters

This stereotype has no attributes.

SAPStructure

This stereotype has no attributes.

SAPIDocAttribute

...

MultiExcerptNameSAPRPCOperation
shouldDisplayInlineCommentsInIncludesfalse

...

optionaldefault = "00"
sapTrace

The effect of this flag being true is two fold:

  1. The SAP RFC libraries will write trace file information (.trc) into the directory the service has been deployed to.

  2. By using the SAP transaction *SMGW (SAP gateway monitor), you can monitor the dataflow from and to the gateway the server is registered on.

The SAP trace level has to be defined in attribute connectionString. See Client Connection Options for a list of the allowed trace level values.

optionaltrueSwitch SAP trace on.
falseSwitch SAP trace off.
protocolSupply the connection protocolmandatoryrfcto use the RFC protocol
trfcto use the tRFC protocol
poolSize
Multiexcerpt
MultiExcerptNamepool_size

Supply the maximum number of parallel connections to the SAP system.

The pool size can be defined per connection string. If you have multiple aliases with the same connection string, the highest value will be used.
The same applies, if you set the values in the SAP adapter settings in the Administration.
If all connections from the SAP connection pool are in use, warnings will be logged to the transaction log each second a service is waiting for connection.

2015-12-08 16:47:24 +0100 0000000182469dcd0001612899fea700e3d869aa 3 SAPConnectionPool 0 OK SAPRFC IO_ENTER PoolExhausted
2015-12-08 16:47:25 +0100 0000000182469dcd0001612899fea700e3d869aa 3 SAPConnectionPool 1000 OK SAPRFC IO_EXIT PoolExhausted

In this case, increase the pool size to solve the problem.

optionaldefault = 10

SAP Adapters

Applicable for the follwong SAP adapters: SAP RFC, SAP TRFC, SAP TRFC Confirm Transaction, SAP TRFC Create Transaction.

AttributeDescriptionAllowed Values / Examples
aliasSpecify the SAP alias the adapter should use to establish the connection.any valid SAP alias

SAP Module Interface

This stereotype has no attributes.

SAP RPC Operation

Multiexcerpt
MultiExcerptNameSAPRPCOperation
shouldDisplayInlineCommentsInIncludesfalse
AttributeDescriptionMandatory / OptionalAllowed Values / Example
rpcResponseNameUse to overwrite the RPC response message name in the WSDL.

optional

any valid string
default: <soap port type name>_<operation name>_Response

Code Block
<wsdl:message name="myReponseName">
      <wsdl:part name="output" type="stns1:OutputClass"/>
soapInputNamespaceUse to overwrite the SOAP input namespace in the WSDL.

optional

any valid namespace string
default: urn:<containment tree path>.<port name>

Code Block
<wsdl:input>
    <soap:body [...] namespace="myInputNamespace"/>
soapOutputNamespaceUse to overwrite the SOAP output namespace in the WSDL.

optional

any valid namespace string
default: urn:<containment tree path>.<port name>
Code Block
<wsdl:output>
    <soap:body [...] namespace="myOutputNamespace"/>

SAP IDoc (Class) 
Anchor
sap_idoc
sap_idoc

The stereotype SAP IDoc is used on a class to mark it as SAP IDoc class. This stereotype has no attributes.

SAP IDoc Attribute (Class & Property)

Multiexcerpt
MultiExcerptNameSAP_iDocAttribute
shouldDisplayInlineCommentsInIncludesfalse
AttributeDescriptionMandatory / OptionalAllowed Values
decimalsSpecify the number of decimals for native type DEC.mandatory for native type DECan integer value
offset
Specify the offset of the attribute data within the serialized IDoc segment.mandatoryany integer value
externalLengthSpecify the parameter length as given in the ABAP dictionary (except for FLT, INT, DATS, TIMS).mandatoryan integer value
nativeType
Specify the native ABAP type. For allowed types and valid internal/native type combinations see Native SAP - ABAP - xUML Base Type Mappings.mandatorya valid ABAP native type as listed on Native SAP - ABAP - xUML Base Type Mappings 

SAP Parameters (Class) 
Anchor
sap_parameters
sap_parameters

The stereotype SAP Parameters is used on a class to mark it as SAP parameter class. This stereotype has no attributes.

SAP Structure (Class) 
Anchor
sap_structure
sap_structure

The stereotype SAP Structure is used on a class to mark it as SAP structure class. This stereotype has no attributes.

SAP Tables (Class) 
Anchor
sap_tables
sap_tables

The stereotype SAP Tables is used on a class to mark it as SAP tables class. This stereotype has no attributes.

SAP Adapter Operations

SAPTRFCCreateTransaction Operation

  • SAPTRFCCreateTransaction ( connectionString : String, transactionID : String )
NameTypeDirectionDescription
connectionStringStringinSupplies the connection string (optional).
transactionIDStringout

Returns the transaction ID of the newly created transaction.
The transaction ID is logged as correlation ID to the transaction log (see Administration Guide > Contents of the Transaction Log).

SAPTRFCConfirmTransaction Operation

  • SAPTRFCConfirmTransaction ( connectionString : String, transactionID : String )
NameTypeDirectionDescription
connectionStringStringinSupplies the connection string (optional).
transactionIDStringin

Supplies the transaction ID of the transaction to be confirmed.

The transaction ID is logged as correlation ID to the transaction log (seeAdministration Guide > Contents of the Transaction Log).

SAPIDocComposer Operation

  • SAPIDocComposer ( anyObjectFlow : Any, idocString : String )
NameTypeDirectionDescription
anyObjectFlowAnyin
Multiexcerpt
MultiExcerptNameanyObjectFlow
Parsed IDoc object(s)
The class specifying the type of this parameter must have stereotype SAPIDoc.
idocStringStringout
Multiexcerpt
MultiExcerptNameidocString

String containing IDoc data (e.g. the content of an IDoc file).

SAPIDocRecordComposer Operation

  • SAPIDocRecordComposer ( anyObjectFlow : Any, EDI_DC40 : EDI_DC40[], EDI_DD40 : EDI_DD40[] )
NameTypeDirectionDescription
anyObjectFlowAnyin

Multiexcerpt include
MultiExcerptNameanyObjectFlow
PageWithExcerptSAP

EDI_DC40Array of EDI_DC40outArray of IDoc structured control records.
EDI_DD40Array of EDI_DD40out

Array of IDoc structured data records.

SAPXMLIDocComposer Operation

  • SAPXMLIDocComposer ( anyObjectFlow : Any, idocBlob : Blob )
NameTypeDirectionDescription
anyObjectFlowAnyin
Multiexcerpt
MultiExcerptNameanyObjectFlowXML

Parsed IDoc object(s)
The class specifying the type of this parameter must have stereotype SAPIDoc and XML.

Info

The input object must be named exactly after the root element of the IDoc, e.g. TXTRAW01. If not, the model will throw an exception at runtime.

idocBlob
Blobout
Multiexcerpt
MultiExcerptNameidocBlob

Blob containing IDoc data (e.g. the content of an IDoc file).

SAPIDocParser Operation

  • SAPIDocParser ( anyObjectFlow : Any, idocBlob : Blob )
NameTypeDirectionDescription
idocStringStringin

Multiexcerpt include
MultiExcerptNameidocString
PageWithExcerptSAP

anyObjectFlowAnyout

Multiexcerpt include
MultiExcerptNameanyObjectFlow
PageWithExcerptSAP

SAPIDocRecordParser Operation

  • SAPIDocRecordParser ( EDI_DC40 : EDI_DC40[], EDI_DD40 : EDI_DD40[], anyObjectFlow : Any )
NameTypeDirectionDescription
EDI_DC40Array of EDI_DC40inArray of IDoc control record strings
EDI_DD40Array of EDI_DD40in

Array of IDoc data records strings

anyObjectFlowAnyout

Multiexcerpt include
MultiExcerptNameanyObjectFlow
PageWithExcerptSAP

SAPXMLIDocParser Operation

  • SAPXMLIDocParser ( idocBlob : Blob, anyObjectFlow : Any )
NameTypeDirectionDescription
idocBlob
Blobin

Multiexcerpt include
MultiExcerptNameidocBlob
PageWithExcerptSAP

anyObjectFlowAnyout

Multiexcerpt include
MultiExcerptNameanyObjectFlowXML
PageWithExcerptSAP

SAP Adapter Parameter Types

EDI_DC40

Tip

For a detailed description on the structure of ECI_DC40 and EDI_DD40 see SAP documentation.

EDI_DD40

Tip

For a detailed description on the structure of ECI_DC40 and EDI_DD40 see SAP documentation.

Parameters

SAP RFC Adapter

Parameters

SAPRFCAdapter

Multiexcerpt
MultiExcerptNameparameters_saprfcadapter
NameTypeDirectionDescription
connectionStringStringinSupplies the connection string (optional).
import

Any

inThe class specifying the type of this parameter must have stereotype SAPParameters SAP Parameters. 
The attributes and associations of this class correspond to the parameters given by the import section of the ABAP function declaration.
exportAnyoutThe class specifying the type of this parameter must have stereotype SAPParameters SAP Parameters. 
The attributes and associations of this class correspond to the parameters given by the export section of the ABAP function declaration (see the export parameters in SAP).
changingAnyin/outThe class specifying the type of this parameter must have stereotype SAPParameters SAP Parameters.
The attributes and associations of this class correspond to the parameters given by the changing section of the ABAP function declaration
tablesAnyin/outThe class specifying the type of this parameter must have the SAPTablesstereotype SAP Tables.
The attributes and associations of this class correspond to the parameters given the tables section of the ABAP function declaration.

...