Ansicht
Dokumentation

CRM_WEBREQ_EXTERN_CREATE - Anlegen eines Web-Antrags - offline

ABAP Short Reference ABAP Short Reference
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Funktionsbaustein ermöglicht es, einen Web-Antrag über eine externe Schnittstelle offline anzulegen.

D.h., es wird ein CRM-Vorgang mit der Vorgangsart angelegt, die dem Antragstyp zugeordnet ist. Der Antragsteller wird als Geschäftspartner in der Rolle Auftraggeber in der Partnerliste eingetragen, wenn er an der Schnittstelle übergeben wird, oder in der Business Add-In-Methode (BAdI-Methode) FORM_ON_CREATION in den 'Envelope' (Kopfinformationen der XML-Datei) gestellt wird. Ist dem Antragstyp ein Produkt zugeordnet, wird auch das Produkt im CRM-Vorgang angelegt.

Der XML-Strom (Dateninformationen im Tag 'body') repräsentiert das Formular. Das XML-Dokument wird mit dem 'Envelope' versehen, in dem Steuerdaten dokumentiert werden, und auf der Datenbank im Knowledger Provider (Kpro) von SAP CRM als KPro-Dokument in den Dokumentenbereich CRM_WEBREQ abgespeichert (analog zu den online erfassten Formularen). Zwischen diesem Objekt und dem CRM-Vorgang wird eine Verknüpfung angelegt, so dass das Formular vom CRM-Vorgang aus zur Anzeige gebracht bzw. geändert werden kann.

Dazu sind folgende Voraussetzungen notwendig:

Der Antragstyp muss mit zugehöriger Antragsdatenstruktur und Vorgangsart im CRM-System vorhanden sein. Ansonsten wird die Schnittstelle mit einer Fehlermeldung abgebrochen. Der Parameter für den Antragstyp ist ein Mussfeld.

Eine zum Antragstyp "passende" XML-Datei muss als XML-Strom mitgegeben werden. Das bedeutet, die verwendeten XML-Tags müssen auch in der Definition der Antragsdatenstruktur vorkommen.

Wenn Geschäftspartner für den Anleger und den Antragsteller mitgegeben werden, dann müssen diese im CRM-System existieren. Ist dies nicht erfüllt, wird die Verarbeitung mit einer Fehlermeldung abgebrochen.

Beispiel

parameters:
       preqtype  type  crmt_req_type,
       pcreator  type  bu_partner,
       prequest  type  bu_partner,
       pcateg    type  crmt_act_category.
data:
       lv_xml           type string,
       lv_order_guid    type crmt_object_guid,
       ls_message       type bapiret2.

call function 'CRM_WEBREQ_EXTERN_CREATE'

     exporting
               iv_reqtype        = preqtype
              iv_bupa_creator   = pcreator
               iv_bupa_requester = prequest
               iv_xml            = lv_xml
               iv_category       = pcateg

     importing
               ev_order_guid     = lv_order_guid
               es_message        = ls_message.

Hinweise

Hinweise zu den Parametern:

Werden Parameter für den Anleger und den Antragsteller übergeben, dann werden sie vor dem BAdI-Aufruf in die entsprechenden Envelope-Felder CREATED_BY_BUPA und REQUESTED_BY_BUPA gestellt. Außerdem sind sie in der Servicetabelle mit dem Namen WFF_CREATED_BY_BUPA und WFF_REQUESTED_BY_BUPA zugänglich.
Die Kategorie ist zur Unterscheidung der technischen Herkunft (Kanal) des Antrags gedacht. Die Kategorie wird ebenfalls in den BAdI-Methoden in der Servicetabelle mit dem Namen WFF_CATEGORY bereitgestellt. Damit kann in den BAdI-Methoden darauf programmiert werden.
Es ist auch möglich, im Customizing des CRM eigene Kategorien anzulegen über Customer Relationship Management -> Vorgänge -> Einstellungen für Aktivitäten -> Kategorien , Ziele und Prioritäten definieren -> Kategorien pflegen.Damit ist es möglich, mit dem neuen Verarbeitungskonzept in der BAdI-Methode FORM_ON_CREATION den CRM-Vorgang anzulegen und diesem bereits die Kategorie zuzuweisen. So ist sie später im CRM-Vorgang sichtbar.
Der Parameter IV_PARAMETER ist ein freier Parameter, dessen Verwendung in Absprache zwischen dem Aufrufer und dem Empfänger festgelegt werden kann. Er wird ebenfalls in den BAdI-Methoden in der Servicetabelle mit dem Namen WFF_PARAMETER bereitgestellt, so dass darauf programmiert werden kann.

Gerufene BAdI-Methoden des BAdIs CRM_SERVICE_WEBREQ:

FORM_ON_CREATION:
Zum Zeitpunkt des Anlegens des Formulars. Hier kann abhängig von den unten nochmals beschriebenen Parametern der Servicetabelle bereits der CRM-Vorgang mit bestimmten Werten angelegt werden (zum Beispiel mit dem Anleger als Geschäftspartner in der Partnerliste und der Kategorie) oder es können Formulardaten ausgelesen bzw. geändert werden.

DETERMINE_CODES:
Zum Zeitpunkt der Ermittlung des Aktivitätsgrunds für den CRM-Vorgang. Es kann entweder der zugeordnete Aktivitätsgrund übersteuert oder ein Aktivitätsgrund gesetzt werden. Voraussetzung ist, dass der Vorgangsart ein entsprechendes Sachverhaltsprofil zugeordnet ist.

Zusammenstellung aller im Offline-Fall verwendeten Parameternamen der Servicetabelle:

WFF_OFFLINE	zeigt Offline-Verarbeitung an, wenn gesetzt
WFF_CREATED_BY_BUPA	Anleger
WFF_REQUESTED_BY_BUPA	Antragsteller
WFF_CATEGORY	Kategorie
WFF_PARAMETER	freier Parameter

Hinweis zur Benutzung der Servicetabelle:

Mit den statischen Methoden der Klasse CL_CRM_WEBREQ_SRV_PARM kann auf die einzelnen Parameter zugegriffen werden.

Beispiel:
class cl_crm_webreq_srv_parm definition load.
if not cl_crm_webreq_srv_parm=>offline( it_srv_parm = it_service_parameter ) is
initial.
......
endif.

Weiterführende Informationen

Sie können die Funktionen dieses Bausteins mit dem Musterprogamm CRM_WEBREQ_EXTERN_WITH_UPLOAD testen.

Parameter

ES_MESSAGE
ET_WEBREQ_MESSAGE
EV_ORDER_GUID
IV_BUPA_CREATOR
IV_BUPA_REQUESTER
IV_CATEGORY
IV_COMMIT_FLAG
IV_PARAMETER
IV_REQTYPE
IV_XML

Ausnahmen

Funktionsgruppe

CRM_WEBREQ_EXTERN

BAL Application Log Documentation RFUMSV00 - Advance Return for Tax on Sales/Purchases
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 9354 Date: 20240523 Time: 144310 sap01-206 ( 117 ms )

Ansicht Dokumentation