Ansicht
Dokumentation

CRM_WEBREQ_EXTERN_CREATE_DOC - Anlegen eines Web-Antrags mit Anlagen - offline

General Data in Customer Master CPI1466 during Backup
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. Außerdem können Sie Dateien mitgeben, die als Anlagen am angelegten CRM-Vorgang gesichert werden.

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 (beinhaltet die Steuerdaten des Antrags) und auf der Datenbank im Knowledge Provider (KPro) von SAP CRM als KPro-Dokument in den Dokumentenbereich CRM_WEBREQ gesichert (analog zu den online erfassten Formularen). Zwischen diesem Objekt und dem CRM-Vorgang wird eine Verknüpfung angelegt, so dass das Formular vom Vorgang aus zur Anzeige gebracht bzw. geändert werden kann. Die als Anlagen hinterlegten Dokumente eines Web-Antrags werden als KPro-Dokumente im Dokumentenbereich CRM-Dokumente gesichert.

Folgende Voraussetzungen sind für das Anlegen von offline-Web-Anträgen mit Anlagen notwendig:

Der Antragstyp muss mit der zugehörigen Antragsdatenstruktur und der Vorgangsart im CRM-System vorhanden sein. Ansonsten wird die Verarbeitung 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. D.h., die verwendeten XML-Tags müssen in der Definition der Antragsdatenstruktur vorkommen.

Werden Geschäftspartner für den Anleger und den Antragsteller mitgegeben, dann müssen diese im CRM-System bereits existieren. Ansonsten wird die Verarbeitung mit einer Fehlermeldung abgebrochen.

Folgendes ist zu beachten, wenn Sie Dokumente als Anlagen mitgeben:

Die folgenden Parameter gehören jeweils zusammen, d.h. es müssen immer beide oder keiner von beiden gefüllt sein:

IS_CONT_DOC1 / IS_PROP_DOC1

IS_CONT_DOC2 / IS_PROP_DOC2

IT_CONT_DOC / IT_PROP_DOC

Die Parameter IS_CONT_DOC1 / IS_PROP_DOC1 sowie IS_CONT_DOC2 / IS_PROP_DOC2 sind für komprimierte Dateien (z.B. *.jpg oder *.zip) vorgesehen.

Die Tabellenparameter IT_CONT_DOC / IT_PROP_DOC sind für unkomprimierte Dateien (z.B. *.xml, *.txt, *.doc, *.pdf , *.ppt, *.xds) vorgesehen. In beiden Tabellen wird über die Dokumentnummer der Bezug zwischen dem Inhalt (IT_CONT_DOC) und den Eigenschaften (IT_PROP_DOC) einer bestimmten Anlage hergestellt.

Die Eigenschaften sollten möglichst korrekt gefüllt werden, damit die Anlage korrekt abgespeichert werden kann (Datei-Größe und HTML-Contenttyp) und die wichtigen Informationen im CRM-System bereithält (z.B. Dateiname).

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,

ls_cont_doc1 type xstring,

ls_prop_doc1 type crmt_doc_prop,

lt_cont_doc type crmt_doc_contt,

lt_prop_doc type crmt_doc_propt,

lt_message type bapirettab,

lt_webreq_message type bapirettab.

call function 'CRM_WEBREQ_EXTERN_CREATE_DOC'

exporting

iv_reqtype = preqtype

iv_bupa_creator = pcreator

iv_bupa_requester = prequest

iv_xml = lv_xml

iv_category = pcateg

is_cont_doc1 = ls_cont_doc1

is_prop_doc1 = ls_prop_doc1

importing

ev_order_guid = lv_order_guid

tables

it_cont_doc = lt_cont_doc

it_prop_doc = lt_prop_doc

et_message = lt_message

et_webreq_message = lt_webreq_message.

Hinweise

Wenn Sie mehr als zwei komprimierte Dateien übergeben, dann können diese auch in den Tabellen IT_CONT_DOC / IT_PROP_DOC übergeben werden. D.h., das Vorhandensein von nur zwei entsprechenden Parameterpaaren ist keine Einschränkung. Der Nachteil dieses Vorgehens ist lediglich ein geringer Performance-Verlust.

Das Sichern eines CRM-Vorgangs wird auch bei Fehlern im Antrag, Fehlern im Vorgang oder Fehlern bezüglich der Anlagen durchgeführt. Die aufgezeichneten Fehlermeldungen werden in den Tabellen ET_MESSAGE (allgemeine Fehler) und ET_WEBREQ_MESSAGE (Fehler im Antrag) zurückgegeben. Lediglich bei schwerwiegenden Parameterfehlern oder Inkonsistenzen in den Customizing-Einstellungen wird das Anlegen eines Vorgangs abgebrochen.

Die Information über das Anlegen eines Vorgangs mit verknüpftem Antrag ist dem Parameter EV_ORDER_GUID zu entnehmen. Wird in diesem Parameter eine GUID zurückgeliefert, dann ist auch ein Vorgang angelegt worden. Trotzdem sollten Sie die aufgezeichneten Fehlermeldungen in Tabelle ET_MESSAGE beachten. Fehler im Antrag werden dem Sachbearbeiter bei der Bearbeitung des Antrags angezeigt und er kann sie korrigieren.

Weiterführende Informationen

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

Parameter

ET_MESSAGE
ET_WEBREQ_MESSAGE
EV_ORDER_GUID
IS_CONT_DOC1
IS_CONT_DOC2
IS_PROP_DOC1
IS_PROP_DOC2
IT_CONT_DOC
IT_PROP_DOC
IV_BUPA_CREATOR
IV_BUPA_REQUESTER
IV_CATEGORY
IV_COMMIT_FLAG
IV_PARAMETER
IV_REQTYPE
IV_XML

Ausnahmen

Funktionsgruppe

CRM_WEBREQ_EXTERN

General Material Data SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 10145 Date: 20240523 Time: 135733 sap01-206 ( 126 ms )

Ansicht Dokumentation