Create Appointment Activity
To create an appointment activity.
Technical Data
Entity Type |
Service Operation |
Software Component Version |
SAP CRM ABAP 7.02 |
released |
|
AppointmentActivityCRMCreateRequestConfirmation_In |
|
http://sap.com/xi/CRM/SE |
|
CRM-BTX-ACT |
|
Web Service Definition (Back End) |
AppointmentActivityCRMCreateRe |
A2X |
|
inbound |
|
synchronous |
|
yes |
|
not applicable |
|
true |
Business Context and Use
The
Create Appointment Activity
inbound service operation creates an appointment activity.
Further business context is provided in the documentation for the Appointment Activity business object.
Related Operations
The Read Appointment Activity inbound service operation retrieves a specified appointment activity.
The Change Appointment Activity inbound service operation changes a specified appointment activity.
The Find Activity Basic Data by Elements inbound service operation returns the basic data of all activities that match the specified search criteria.
Features
The
Create Appointment Activity
inbound service operation creates appointment activities. The term “Appointment Activity” means a projection of the Business Object “Activity Template” which comprises the data of the SAP Business Activity in the CRM back-end system.
For this service operation the following elements are mandatory:
Activity type (ProcessTypeCode element) and
A code for the group (GroupCode element)
Some of the code fields of the message may have corresponding tags for name fields. With a request, only a code value should be given. Any content in the corresponding name field is ignored.
Some of the code fields of the message may have corresponding tags for name fields. With a request, only a code value should be given. Any content in the corresponding name field is ignored.
To create an appointment activity with item information, the ActivityJournalUUID must be specified. This uniquely identifies the activity journals maintained in the CRM back-end system. Ensure the selected activity journal is relevant for the activity and has the status Released.
This service operation processes the AppointmentActivityCRMCreateConfirmation_sync message data type.
The response uses the AppointmentActivityCRMCreateRequest_sync message data type and comprises the ID and ProcessTypeCode elements. These can be used later by the following service operation.
Read Appointment Activity to retrieve the data supplied during create and/or
Change Appointment Activity to change the data supplied during create
Processing
Reuse components
Note that this is a level 1 service. For more information about the behavior of level 1 services, see Common Functions of Level 1 Services .
Error Handling
Any errors from validation, mapping and API Adaptor phases are sent to the GDT Log . This is returned as part of the response message.
In case of a message of the type E(rror), A(bort) or X (EXception), the appointment activity record is not created in the CRM back-end system.
Message Types
AppointmentActivityCRMCreateConfirmation_sync
AppointmentActivityCRMCreateRequest_sync
Constraints
The
Create Appointment Activity
service operation does not support the following attributes of an appointment activity: survey (questionnaire) and attachment.
Notes on SAP Implementation
Enhancements
The BAdI Def:CRM_SE_APPTACTCRTRC Business Add-In (BAdI) is available for this inbound service operation.
Code Example
The following example is an excerpt of an XML message for the
Create Appointment Activity
inbound service operation.Note: The example contains sample data that applies to a specific configuration and master data scenario.
<n0:AppointmentActivityCRMCreateRequest_sync xmlns:n0="" http://sap.com/xi/CRM/SE ""> <MessageHeader> <ID></ID> <UUID></UUID> <ReferenceID></ReferenceID> <ReferenceUUID></ReferenceUUID> </MessageHeader> <AppointmentActivity> <ProcessingTypeCode>0000</ProcessingTypeCode> <AppointmentActivityAdministrationHeader> <ProcessingTypeCode>0000</ProcessingTypeCode> <Description>pram sample appointment create for eSOA</Description> <AppointmentActivityHeaderDates> <AppointmentActivityHeaderPlannedDate> <AppointmentTypeCode>ORDERPLANNED</AppointmentTypeCode> <DurationIndicator>false</DurationIndicator> <StartDateTime timeZoneCode="""">2008-06-08T11:40:00Z</StartDateTime> <EndDateTime timeZoneCode="""">2008-06-08T12:40:00Z</EndDateTime> </AppointmentActivityHeaderPlannedDate> </AppointmentActivityHeaderDates> <AppointmentActivityHeaderReferences> <AppointmentActivityHeaderPredecessorReferences> <RelationshipTypeCode>VONA</RelationshipTypeCode> <PredecessorReferenceID>4843E926D635056CE10000000A421845</PredecessorReferenceID> <PredecessorReferenceTypeCode>BUS2000126</PredecessorReferenceTypeCode> </AppointmentActivityHeaderPredecessorReferences> <AppointmentActivityHeaderAssignedReferences> <RelationshipTypeCode>ASGN</RelationshipTypeCode> <SuccessorReferenceID>46B9F21640FE6584E10000000A421474</SuccessorReferenceID> <SuccessorReferenceTypeCode>BUS1278</SuccessorReferenceTypeCode> </AppointmentActivityHeaderAssignedReferences> </AppointmentActivityHeaderReferences> <AppointmentActivityHeaderPartiesInvolved> <AppointmentActivityHeaderAllPartiesInvolved> <PartyUUID>4843ea37-d635-056c-e100-00000a421845</PartyUUID> <RefPartyNoDisplayTypeCode>BP</RefPartyNoDisplayTypeCode> <RefPartyNoTypeCode>BP</RefPartyNoTypeCode> <PartyID>3272</PartyID> <PartyRoleCode>00000009</PartyRoleCode> <MainPartyIndicator>false</MainPartyIndicator> </AppointmentActivityHeaderAllPartiesInvolved> <AppointmentActivityHeaderAllPartiesInvolved> <PartyUUID>4843e977-d635-056c-e100-00000a421845</PartyUUID> <RefPartyNoDisplayTypeCode>BP</RefPartyNoDisplayTypeCode> <RefPartyNoTypeCode>BP</RefPartyNoTypeCode> <PartyID>416220</PartyID> <PartyRoleCode>00000012</PartyRoleCode> <MainPartyIndicator>false</MainPartyIndicator> </AppointmentActivityHeaderAllPartiesInvolved> <AppointmentActivityHeaderAllPartiesInvolved> <PartyUUID>4843eb52-d635-056c-e100-00000a421845</PartyUUID> <RefPartyNoDisplayTypeCode>BP</RefPartyNoDisplayTypeCode> <RefPartyNoTypeCode>BP</RefPartyNoTypeCode> <PartyID>401021</PartyID> <PartyRoleCode>00000015</PartyRoleCode> <MainPartyIndicator>false</MainPartyIndicator> </AppointmentActivityHeaderAllPartiesInvolved> <AppointmentActivityHeaderAllPartiesInvolved> <PartyUUID>4843e96f-d635-056c-e100-00000a421845</PartyUUID> <RefPartyNoDisplayTypeCode>BP</RefPartyNoDisplayTypeCode> <RefPartyNoTypeCode>BP</RefPartyNoTypeCode> <PartyID>416220</PartyID> <PartyRoleCode>00000022</PartyRoleCode> <MainPartyIndicator>false</MainPartyIndicator> </AppointmentActivityHeaderAllPartiesInvolved> <AppointmentActivityHeaderAllPartiesInvolved> <PartyUUID>48440110-b252-5bf3-e100-00000a421846</PartyUUID> <RefPartyNoDisplayTypeCode>BP</RefPartyNoDisplayTypeCode> <RefPartyNoTypeCode>BP</RefPartyNoTypeCode> <PartyID>418362</PartyID> <PartyRoleCode>00000032</PartyRoleCode> <MainPartyIndicator>false</MainPartyIndicator> </AppointmentActivityHeaderAllPartiesInvolved> </AppointmentActivityHeaderPartiesInvolved> <AppointmentActivityHeaderTexts> <AppointmentActivityHeaderFirstChangeableText> <Text>first_changeable_note_create</Text> </AppointmentActivityHeaderFirstChangeableText> </AppointmentActivityHeaderTexts> <AppointmentActivityHeader> <AppointmentActivityLocationName>SLI</AppointmentActivityLocationName> <GroupCode>301</GroupCode> <PriorityCode>5</PriorityCode> <PrivateIndicator>false</PrivateIndicator> </AppointmentActivityHeader> </AppointmentActivityAdministrationHeader> </AppointmentActivity></n0:AppointmentActivityCRMCreateRequest_sync>