Technical details

Objects

Next to report described in the usage section, the core functionality is located in class /APPS/CL_ONE. It contains the following methods and attributes:
 

Method Name

Description

CONSTRUCTOR

Initiates an object and reads values from customizing which are needed for data evaluation

DETERMINE_ITEMS

Determines the set of relevant work items to be processed

CREATE_TIME_STAMP

Returns a time stamp

PROCESS_ITEMS

Processes all items, there is no import parameter for items as they are stored local by DETERMINE_ITEMS

SEND_MAIL

Sends a mail, data is defined by import parameters

SET_RUN_INFORMATION

Sets runtime information about the current instance to table /APPS/ONE_RUN; needs to be called for every instance

GET_WI_ITEMS

Returns information about the processed items; can be used for protocol purposes

GET_RUN_INFO

Returns runtime information about the current instance

SET_ELEMENT

Adds information to the local element table, this table is used to build the XML

PROCESS_ITEM

Process a single work item and returns basic runtime data

GET_WI_DETAILS

Returns detail data for a work item

GET_RECEIVERS

Returns the receivers and their user details for a work item

GET_CREATOR

Returns the creator and its user details for a work item

GET_USER_DETAILS

Returns user details for a user

GET_TEXTS

Returns text related to a work item (decision information and work item description text)

SET_DATA

Sets the determined detail data to a local table

SET_PROCESS_INFORMATION

Set information about processed work items to database table /APPS/ONE_WI

GET_DEFAULT_LANGUAGE

Returns system default language

GET_INSTALLED_LANGUAGE

Returns list of languages installed in the current system

 

In general the public methods DETERMINE_ITEMS and PROCESS_ITEMS are covering all needed information. SET_RUN_INFORMATION and SET_PROCESS_INFORMATION should be used too to ensure proper data evaluation. GET_WI_ITEMS and GET_RUN_INFO can be used to get information about each single item and general execution information. See report /APPS/ONE_RUN for example.

There are several other objects and setting which will be described high level below. There may be dependent elements not described here:
 

Name

Type

Description

/APPS/CL_ONE

Class

Main class

/APPS/CX_ONE

Class

Exception class

/APPS/ONE_CL_BADI_FB

Class

Fallback class for badi implementation

/APPS/ONE_CL_SEND_BADI_FB

Class

Fallback class for badi implementation

/APPS/ONE

Package

Package for development

/APPS/DTONE_SBAL_TEXT_01

Documentation

Text used in exception classe

/APPS/ONE_DO_CON_TYPE

Domain

Connection type

/APPS/ONE_DO_DECISION_TYPE

Domain

Decistion type

/APPS/ONE_DO_MAX_RETRY

Domain

Max retry count

/APPS/ONE_DO_SEQNR

Domain

Sequence number

/APPS/ONE_DO_WI_DESCRIPTION

Domain

Work item description text

/APPS/ONE_DO_WI_STATUS

Domain

Work item status

/APPS/SU_DO_DECISION_NUMBER

Domain

Decision ID

/APPS/ONE_DS_ATT_NAME

Data Element

Attachment name of data attachment

/APPS/ONE_DS_ATT_TYPE

Data Element

Attachment type of data attachment

/APPS/ONE_DT_ACTIVE

Data Element

Active flag

/APPS/ONE_DT_CON_SUBJECT

Data Element

Subject of mail

/APPS/ONE_DT_CON_TYPE

Data Element

Type of connection

/APPS/ONE_DT_DECISION_NUMBER

Data Element

Decision ID

/APPS/ONE_DT_DECISION_TEXT

Data Element

Decision text

/APPS/ONE_DT_DECISION_TYPE

Data Element

Decision Type

/APPS/ONE_DT_DESCR_FLAG

Data Element

Description flag

/APPS/ONE_DT_INCL_SUBST

Data Element

Substitutes flag

/APPS/ONE_DT_INSTANCE_NAME

Data Element

Instance name

/APPS/ONE_DT_MAX_RETRY

Data Element

Max retry count

/APPS/ONE_DT_NEW_ONLY

Data Element

Only new items flag

/APPS/ONE_DT_OVERWRITE

Data Element

Overwrite flag

/APPS/ONE_DT_SEQNR

Data Element

Sequence number

/APPS/ONE_DT_WI_DESCRIPTION

Data Element

Work item description text

/APPS/ONE_DT_WI_STATUS

Data Element

Work item status

/APPS/ONE_DT_WORKFLOW_ID

Data Element

Workflow ID

/APPS/ONE_DT_WORKITEM_DESC

Data Element

Work item description

/APPS/ONE_DT_START_DATE

Data Element

Start date

/APPS/ONE_DT_START_TIME

Data Element

Start time

/APPS/ONE_DT_END_DATE

Data Element

End date

/APPS/ONE_DT_END_TIME

Data Element

End time

/APPS/ONE_ENH_SEND_SPOT

Enhancement Spot

Enhancement spot for badi

/APPS/ONE_ENH_SPOT

Enhancement Spot

Enhancement spot for badi

/APPS/ONE

Function Group

Function group for table maintenance

/APPS/ONE_CON

Function Group

Function group for table maintenance

/APPS/ONE_DEC

Function Group

Function group for table maintenance

/APPS/IF_ONE_CONSTANTS

Interface

Interface for constants used in SIAT/CL_ONE

/APPS/ONE

Message Class

Message class

/APPS/RUN_ONE

Program

Main program for ONE

/APPS/ONE_CLEAN_UP

Program

Clean up report, mainly for testing purposes

/APPS/ONE

Table

Leading customizing table

/APPS/ONE_CON

Table

Customizing table defining the connection for instances

/APPS/ONE_DEC

Table

Decision types

/APPS/ONE_DECT

Table

Text table for decision types

/APPS/ONE_DS_ATTACHMENT

Structure

 

/APPS/ONE_DS_DATA

Structure

 

/APPS/ONE_DS_XML

Structure

 

/APPS/ONE_DT_XML

Table

 

/APPS/ONE_RUN

Table

 

/APPS/ONE_TASK

Table

 

/APPS/ONE_USER

Table

 

/APPS/ONE_WI

Table

 

/APPS/ONE_TT_ATTACHMENT

Table Type

 

/APPS/ONE_TT_DATA

Table Type

 

/APPS/ONE_TT_TASK

Table Type

 

/APPS/ONE_TT_WI

Table Type

 

/APPS/ONE_TT_XML

Table Type

 

/APPS/ONE_DATA

Transformation

 

/APPS/ONE_CL_WS_BADI_FB

Class

BAdi Implementation for sending information by WebService

Standard Data Determination

The following data will set in standard to a sent decision XML document:
 

Name

Description

ActionType

Create, Delete

CompanyId

Sitrion ONE company id

CompanyPassword

Sitrion ONE company password

EnvironmentName

Sitrion ONE environment

MessageType

Identifier for the type of message for ONE

IndicatorAccept

Identifier to send an “accept”

IndicatorDecline

Identifier to send a “reject/decline”

Indicator…

Further Identifiers

@GENERICTEXT#

Each line of the task description becomes @GENERICTEXT#001, @GENERICTEXT#002, …

WorkflowId

Id of the SAP workitem

Subject

Subject of the workitem

EMailAddresses

Approvers e-mail addresses

Username

Approvers SAP user names

UserLanguage

Approvers SAP user languages

Tables - Data

The collector contains data tables used to store information about history of runs and items. This information is needed as it is related to future executions.

/APPS/ONE_RUN - information about run

This table contains information about each run per instance.

Column

Description

MANDT

Client of SAP System

INSTANCE_NAME

Name of instance the entry is related to

TIMESTAMP

Timestamp of data evaluation for this run

HAS_ERROR

Indicates if one or more items had errors

/APPS/ONE_WI

This table contains information about each work item/notification send or to be sent, there can be more than one entry per work item. There will be one entry per Instance work item and run. The retry value will be increased for every run of related instance. If the max value is reached this item will no longer evaluated by method DETERMINE_ITEMS.
 

Column

Description

MANDT

Client of SAP System

INSTANCE_NAME

Name of instance the entry is related to

WI_ID

ID of related work item from SWWWIHEAD

USERNAME

User the work item is related to (receiver)

DET_TIMESTAMP

Timestamp of evaluation of data

SEND_TIMESTAMP

Timestamp of sending this item (or at least the try to)

RETRY

Number of try since initial run

STATUS

Result of run ERR-erroneous SUC-successful

DESCRIPTION

Description of issues occurred

Tables - Customizing

The collector uses several customizing tables described in the following chapters. All relevant tables do have a maintenance view with the same name as the table itself.

/APPS/ONE

This is the main customizing table to define the different instances. Technically an instance is just an identifier used to customize values, task and user used during runtime. Each active instance will be considered during a run. Some of the values contained in customizing are not considered in base implementation e.g. start & end. It’s up to the implementation of the enhancements to use these.
 

Name

Description

MANDT

Client of SAP System

INSTANCE_NAME

Name of instance

CON_TYPE

Defines the type the data is send

TEMPLATE_ID

Type this is an ID used to identify the related process in Sitrion One an part of the notification message

INCL_SUBST

Flag if substitutes should be considered as receiver

ACTIVE

Flag if this instance is active

OVERWRITE

Indicates that the start and end of the appointment (if there are these dates) should be overwritten by the defaults defined in start/end date/time column of this table

MAX_RETRY

Defines the max number of retries

WITH_DESCRIPTION

Defines if the description of the work item is to be included in data

/APPS/ONE_CON_TY

This table defines the connection types. A connection type is the starting point to define a new way for sending the data. Mail and Web Service are defined in standard.
 

Name

Description

MANDT

Client of SAP System

CON_TYPE

ID of connection type

/APPS/ONE_CON_TT

This table defines language dependent texts for connection types.
 

Name

Description

MANDT

Client of SAP System

LANGU

Language key

CON_TYPE

ID of connection type

CON_TEXT

Description of the connection type

/APPS/ONE_CON_F

This table defines the available fields per connection type. Each field defines a property which is used by a connection type.
 

Name

Description

MANDT

Client of SAP System

FIELD

ID of field

/APPS/ONE_CON_FT

This table defines the language dependent field description. 
 

Name

Description

MANDT

Client of SAP System

LANGU

Language key

FIELD

ID of field

/APPS/ONE_CON_FV

This table defines the language dependent field description. 
 

Name

Description

MANDT

Client of SAP System

CON_TYPE

Connection type

FIELD

ID of field

FIELD_VALUE

Value for field ID

/APPS/ONE_DEC

This customizing table defines the decision alternatives for the possible decisions ACCEPT, REJECT and OTHER. It is related to a task ID. In case no task ID is defined this entry is used as fallback. This table has a related text table /APPS/ONE_DECT for language dependent text of decision.
 

Name

Description

MANDT

Client of SAP System

TASKID

ID of the related task

DECISION_TYPE

Type of decision ACCEPT; REJECT, OTHER

DECISION_NUMBER

Number of decision

/APPS/ONE_TASK

This table is used to define which task should be used for data evaluation for related instance. If this table is left blank for an instance all tasks will considered.
 

Column

Description

MANDT

Client of SAP System

INSTANCE_NAME

Name of instance the entry is related to

TASK

Workflow Task ID to be considered for instance defined by instance_name

WORKFLOW

Can be used to define the workflow containing the task (not used at the moment)

NEW_ONLY

Flag if only new entries should be used for data determination new = status “READY” (not used at the moment)

WI_DESCRIPTION

Description field

/APPS/ONE_USER

This table contains Users or ranges of users to be excluded from the result. It is built like a selection structure to be able to define ranges.
 

Column

Description

MANDT

Client of SAP System

INSTANCE_NAME

Name of instance the entry is related to

SEQ_NR

Sequence number

SEL_SIGN

Selection sign - refer to SAP standard help for more details

SEL_OPTION

Selection option - refer to SAP standard help for more details

SEL_LOW

Low value - refer to SAP standard help for more details

SEL_HIGH

High value - refer to SAP standard help for more details

Exception handling

For this program the exception handling is used to handle and report errors and issues. The exception class /APPS/CX_ONE was implemented for this. Errors can be found in application log (TA SLG1) and in history tables mentioned above. For application log a new object /APPS/ONE_LOG was created. To get information about run and item information the methods GET_RUN_INFO and GET_WI_ITEMS of class /APPS/CL_ONE can be used after execution.

Share this page
X
Tell your colleagues and friends about Sitrion. Choose a social channel below to share this page.