Show TOC

Adding Record Types to an External Application (Manual)Locate this document in the navigation structure

You add record types (objects) to your new external application to enable the Share and Discuss features for these business objects in SAP Jam.

Context

In SAP Jam, each record type (object) added to an external application represents a business object type from the back-end system.

Example You need to create one record type (object) for individual accounts and another for corporate accounts if you are integrating the SAP Fiori for SAP CRM My Accounts app.

Procedure

  1. In your new external application in SAP Jam, choose Start of the navigation path Action Next navigation step Manage Record Types End of the navigation path.
  2. On the Manage Record Types screen, choose Add Record Types.
  3. In the Add Record Type dialog box, provide the following information for each object:
    Field Value
    Name Provide a meaningful description for the business object type. The name appears next to the object in a Feed entry.
    Example SAP CRM My Accounts
    External Type Provide a fully qualified URL to an entity set in the metadata of the OData service for your application as required. The entity set represents the collection of the entities for the business object type and is called the Collection in the OData Service Registry. For example, in the case of the SAP Fiori for SAP CRM My Accounts app, the entity set is AccountCollection for corporate accounts, and IndividualAccountCollection for individual accounts.

    Example for Share Feature, Corporate Accounts:

    If you wish to use the Share feature, you must specify the OData service document relative path. The format for the external type in this case is as follows:

    https://<external representation of your Gateway system><odata service document relative path>/$metadata#<entity set for the business object type>

    If your external representation is www.<some_location>.com, the OData service document relative path is /sap/opu/odata/sap/CRM_BUPA_ODATA, and the entity set for the business object type is AccountCollection, then the external type is as follows:

    https://www.<some_location>.com/sap/opu/odata/sap/CRM_BUPA_ODATA/$metadata#AccountCollection

    Example for Discuss Feature, Individual Accounts:

    If you wish to use the Discuss feature, you must enter the external OData service name that has been defined in the OData Service Registry. The format for the external type in this case is as follows:

    https://<external representation of your Gateway system><External OData Service Name>/$metadata#<Entity Set>

    Therefore, the external type for the Discuss feature using the business object type for individual accounts is as follows:

    https://www.<some_location>.com/sap/opu/odata/CRMSWI01/CRMSMI_SRV/$metadata#IndividualAccountCollection

    Annotation Provide a fully qualified URL to an annotation of the business object. This URL must include the annotation resource URL maintained in the OData Service Registry (see Mapping from Internal to External OData Services).
    Example

    https://www.<some_location>.com/sap/opu/odata/CRMSWI01/CRMSMI_SRV/AnnotationCollection('x')/Content/$value

  4. Choose Check Connection to test the connection.
  5. For each object you create, enable Feed History to display the discussion history in the Discuss dialog of the business object type.

Results

The SAP Jam configuration is now complete.