Vacation Service on the Internet

Use

Your customers can use this Internet Application Component (IAC) in Media Sales and Distribution (IS-M/SD) to make the following order changes on the Internet:

Suspension
Redirection
Charitable transfer
Gift transfer

You can design the application in such a way that all these changes can be made using the same change form. You can also design a separate variant of the component for order changes.

You can have the system execute the order changes directly or store them initially in temporary tables, depending on the Customizing settings.

Type of IAC

Consumer to Business

Implementing the IAC Vacation Service on your website has the following advantages for you and your customers:

Your customers can enter order changes on the Internet conveniently, easily and at any time of the day or night. This can be done without the need for telephone calls, letters or faxes.
Your customers gain a clearer picture because they can view their subscription and the existing change items.
Customers enter their own order change items, which reduces your employees' workload – particularly during the vacation season – by eliminating a large number of tasks involving telephone calls and correspondence.
You can design the layout of the application yourself, providing your customers with a simple and user-friendly way of recording their order changes. For example, existing customers can be provided with a simple selection list of the divert addresses they have recorded previously. This allows you to offer your customers a service that exceeds the standard normally offered on the Internet.
Further environment functions for the IAC Vacation Service (postediting of changes stored temporarily, logging of changes) allow you to retain an overview of activities from the Internet.

Prerequisites

Authorizations/Security

Authorization checks can be divided into two categories:

Identification and checking of the customer who wants to make changes to their orders on the Internet:

To prevent unauthorized logon, the customer must log on to the system using a procedure that you define. For this purpose, you define in Customizing where logon is to take place and which data is to be used. A variety of data is available to you for this purpose, including the customer number, password, order number, address data, bank data, and credit card data.

If the check is to be performed using a password, an Internet user must be created for the customer. You can do this in various ways:
- You can create the Internet user when the user orders a subscription using the IAC Subscription Sales .
- Existing customers can create their own Internet user on the Internet using the IAC Create Internet User .
- The publisher can create an Internet user for its customers in transaction SU01.
  
  If you choose a logon scenario that does not require a password, you do not need to create an Internet user. In this case, the customer can log on directly using existing data (for example, customer number, order number, address, e-mail address, and telephone number).
Authorization checks in the SAP system

Logon to the IAC Vacation Service via the Internet Transaction Server (ITS) in the SAP system takes place using an SAP user, which is usually defined in the service file for this IAC. This user must be assigned the authorizations required in order to execute the application. In the IAC Vacation Service , the authorization object required is that for the Publishing Sales Order (J_JKAK).

Standard Default Values

You must make a variety of settings in Customizing for the IAC Vacation Service . For further information, see Start of the navigation path Media Sales and Distribution Next navigation step Periodical Sales andDistribution (Subscriptions) Sales Order InternetApplication Components (IACs) IACVacation Servicein the Implementation Guide forSAPMedia End of the navigation path .

Access

You access the IAC using the URL http://.../sap/bc/gui/sap/its/media/jkwww03?key_vacation=<key>&~okcode=strt .

<key> stands for a key defined in Customizing that references all the data for a variant of the IAC Vacation Service .

Features

The IAC Vacation Service can be used to make changes to existing orders.

Different Variants of Vacation Service

You can design the application in such a way that it displays all existing orders for a customer including the existing order items, so that the customer can then choose the orders they want to change. If you hide this selection, the change is made for all orders.

In addition to the existing order changes, the customer can also display and delete reserved order changes.

You can also have the application list the customer’s previous divert or gift recipient addresses so that they can select one. They can either select one of these addresses or enter a new one.

The system checks whether the new change items being created overlap with existing ones. A delivery viability check takes place for redirections and gift transfers. If delivery is not viable for the publication at the specified time, the application does not create a redirection or gift transfer, and the customer is informed that this is the case. This avoids problems with redirections and gift transfers entered shortly before they come into effect.

You can also use separate variants of this application for individual order changes. You can control this by means of the key assigned to the URL, for example by referencing the item type required. If you only want to define one application for the order changes, this is taken as the default setting. In this case, you must also define radio buttons on the form so that the customer can choose the desired item and change type.

Logon for an Existing Customer

Logon takes place according to the scenario described above, either on a separate logon screen or on the change form. The process flow for the latter is as follows: The customer specifies logon data on the change form as well as the data on their redirection or suspension. When they save, this data is used to identify and check the customer, and the system reads their orders to ensure that the changes are possible. If this is the case, the changes are made immediately. This process flow means the customer does not have the impression that they have had to log on.

Control Options

You specify in Customizing whether order changes are created directly or whether the data is stored temporarily first. If errors are identified, you can also choose between storing the data temporarily and reporting the error to the customer, for example requesting that they clarify the change by telephone.

You also specify the item and change types that are to be created in a variant in Customizing. If you design the application in such a way that the order changes can be created on the same form, you must define a Customizing record for each of these item types and assign the key of this record to the radio button on the change form.

In the case of redirections or gift transfers, you can specify whether the edition is to be copied from the basic order item or determined using delivery viability determination.

Field List for Application

The field list contains fields for logon, for the customer’s address, orders, and divert addresses, for creating a new divert address or a gift transfer, and other fields required for order changes.

Possible Adjustments

You can modify the application by designing the HTML templates according to your requirements. You can show and hide fields as you require and change the layout of the application. Transaction JKWWW03 ( Vacation Service ), on which the IAC Vacation Service is based, contains a list of fields that you can use.

If you require further fields, add these on the customer subscreens provided for this purpose and include them in the templates. The following customer enhancements are available in this IAC:

Customer Enhancement	Components	Meaning
JKWWW234	Function enhancements: EXIT_SAPLJGWWW_001EXIT_SAPLJGWWW_002 Screen areas: SAPLXJKWWW 0100SAPLXJKWWW 0200	Enhancement of identification and checking of customers on the logon screen and/or on the change form
JKWWW032	Function enhancements: EXIT_SAPMJKWWW03_008EXIT_SAPMJKWWW03_009 Screen areas: SAPLXJKWWW 3200	Enhance change form.
JKWWW033	Function enhancements: EXIT_SAPMJKWWW03_010 Screen areas: SAPLXJKWWW 3300	Enhancement of confirmation screen/form

The enhancement JKWWW234 is also used by the other IACs for subscription service, since identification and checking of business partners always takes place (technically) in the same way.

SAPDevelopment Objects

On the SAP side, data exchange with the Internet takes place using transactions and function modules. The Internet Application Component is based on a transaction that is started when the service is called up by its URL. The following development objects are required for the IAC Vacation Service :

Short Name	Development Object
Development class	JSD
Transaction	JKWWW03
Module pool	SAPMJKWWW03
Function group	JGWWW JKSI
Function modules	ISM_SALES_ITEM_SUSPEND ISM_SALES_ITEM_REDIRECT ISM_SALES_ITEM_ GIFT _TRANSFER ISM_SALES_ITEM_ CHAR _TRANSFER

Every change made to the SAP development objects used for the IAC Vacation Service constitutes a modification. You should on no account make changes to the development objects from the standard system.

Data Output via the ITS

Data output and exchange between the Internet and the SAP system takes place using the ITS. The system extracts the data entered in the HTML forms and transfers it to the SAP application; the field names on the HTML form must correspond to those on the relevant screen. In the other direction, the data determined in the SAP system is combined with the HTML templates and made available to the Internet in HTML format.

Service Name

The service name of the IAC Vacation Service is JKWWW03 . The following (output) forms, which are termed HTML templates, are used:

Form	Meaning
SAPMJKWWW03_0100	Logon screen
SAPMJKWWW03_0200	Change form
SAPMJKWWW03_0300	Confirmation screen

The numbers in the form names correspond to the SAP screen numbers.