1. Implementation Reference
  2. Use Web Services to Populate Location Attributes for the Around Me Feature

Use Web Services to Populate Location Attributes for the Around Me Feature

Use this procedure to populate location attributes using Web services for the Around Me feature in countries that aren't supported by the eLocation service. The Around Me feature enables you to quickly locate information about your surroundings.

This feature uses your current location to run a proximity search on objects with location information, such as contacts, opportunities, and customers.

Create an Address with the Location Attributes Using the LocationService Web Service

Perform the following steps to create an address with location attributes, such as latitude and longitude, using the createLocation operation.

  1. Extract the Web Services URL

    1. Sign in to the Oracle Enterprise Manager Applications Control using the WebLogic Server credentials.

    2. Select Oracle Fusion Customer Relationship Management from the navigation tree, and then select Fusion Applications.

    3. From the tree, select CrmCommonApp, and then select CrmCommonApp (CRMCommonServer_1).

    4. In the Web Services pane, click Test for the LocationServiceSoapHttpPort port.

    5. In the Test Web Service pane, copy the URL of a WSDL that appears in the WSDL field until "?wsdl", and then paste to a notepad.

  2. Derive the Payload

    1. Launch the WSDL URL in a Web browser to open the LocationService endpoint page.

    2. In the LocationServiceSoapHttpPort pane, select createLocation from the Operation list.

    3. In the Location pane, complete the fields, as shown in the following table.

      Field

      Value

      Country

      CN

      Address1

      Chaoyang District

      City

      Shanghai

      Postal Code

      200233

      State

      China

      CreatedByModule

      AMS

      Latitude

      20.36789

      Longitude

      -39.34444
      Note: Deselect all the other parameters in this Location pane. Also, deselect LocationProfile, OriginalSystemReference, and LocationInformation options.

    4. Click the XML Source option.

      Note: This option appears next to the Operation list.

    5. Copy the XML source and paste to a notepad.

  3. Call the Web Service

    1. Open the Oracle Fusion Service Tester page.

    2. In the WebService URL field, paste the WSDL URL that you derived from Step 5 of the Extracting the Web Services URL section.

    3. Enter the user name and password credentials.

    4. In the Payload pane, paste the XML source that you derived from Step 5 of the Deriving the Payload section.

    5. Click Invoke. The Output Payload pane displays the output payload.

  4. Test the Web Service

    1. Sign in to the Oracle Fusion Applications Home Page.

    2. Navigate to the Customer Center work area.

    3. Search the address that you added.

    4. Click the Addresses section.

    5. From the Actions list, select the View Geography Information option.

    6. Verify the latitude and longitude details.

Update the Location Attributes of an Address Using the LocationService Web Service

Perform the following steps to update the location attributes of an address, such as latitude and longitude, using the updateLocation operation.

  1. Extract the Web Services URL

    1. Sign in to the Oracle Enterprise Manager Applications Control using the WebLogic Server credentials.

    2. Select Oracle Fusion Customer Relationship Management from the navigation tree, and then select Oracle Fusion Applications.

    3. From the tree, select CrmCommonApp, and then select CrmCommonApp (CRMCommonServer_1)

    4. In the Web Services pane, click Test for the LocationServiceSoapHttpPort port.

    5. In the Test Web Service pane, copy the URL of a WSDL that appears in the WSDL field until "?wsdl", and then paste to a notepad.

  2. Derive the Payload

    1. Launch the WSDL URL in a Web browser to open the LocationService endpoint page.

    2. In the LocationServiceSoapHttpPort pane, select updateLocation from the Operation list.

    3. In the Location pane, complete the fields, as shown in the following table.

      Field

      Value

      LocationId

      300100078489616

      Note: Enter the location ID that was generated in Step 1 of the Testing the Results section.

      Latitude

      30.36789

      Longitude

      -40.34444
      Note: Deselect all the other parameters in this Location pane. Also, deselect LocationProfile, OriginalSystemReference, and LocationInformation options.

    4. Click the XML Source option.

      Note: This option appears next to the Operation list.

    5. Copy the XML source and paste to a notepad.

  3. Call the Web Service

    1. Open the Oracle Fusion Service Tester page.

    2. In the WebService URL field, paste the WSDL URL that you derived from Step 5 of the Extracting the Web Services URL section.

    3. Enter the user name and password credentials.

    4. In the Payload pane, paste the XML source that you derived from Step 5 of the Deriving the Payload section.

    5. Click Invoke. The Output Payload pane displays the output payload.

  4. Test the Web Service

    1. Sign in to the Oracle Fusion Applications Home Page.

    2. Navigate to the Customer Center work area.

    3. Search the address that you updated.

    4. Click the Addresses section.

    5. From the Actions list, select the View Geography Information option.

    6. Verify the latitude and longitude details.