From 82b3dd922df20d72c73aa3a418647d4578753354 Mon Sep 17 00:00:00 2001 From: concur-docs-machine Date: Thu, 14 Sep 2023 18:56:40 +0000 Subject: [PATCH] [skip ci] Updates --- api-guides/request/deeplink-url-request.html | 139 +++++++++++++++---- feed.xml | 4 +- 2 files changed, 113 insertions(+), 30 deletions(-) diff --git a/api-guides/request/deeplink-url-request.html b/api-guides/request/deeplink-url-request.html index 01117a5b4..e60013aea 100644 --- a/api-guides/request/deeplink-url-request.html +++ b/api-guides/request/deeplink-url-request.html @@ -519,42 +519,125 @@ class="col-md-8 markdown-body"> -

Deeplink URL Integration

+

Deeplink URL Integration Concur Request

+ +
+

Important: This API is currently in pre-release status and is only available to approved early access participants. The API is under development and might change before being generally released. To become an early access participant, contact your SAP Concur Representative.

+
+

The Deeplink URL integration provides the ability for a user on a third-party website or portal to access the resource in Concur Request. This is useful when the user needs to navigate to the SAP Concur solutions website or the SAP Concur Mobile app to complete their operation on the resource, or requires more insights on the resource than that provided in the third-party website or portal.

+

Limitations

+

Users must purchase Concur Request in order to use this integration capability. This integration is only available to partners who have been granted access and to customers who either use username/password or SSO SAML2 implementation for authenticating. Access to this documentation does not provide access to the integration.

+

Prerequisites

+ + +

Process Flow for Deeplink URL for a Request

+ +

Integration Details

+ +

URI Template

+ +
https://www.concursolutions.com/goto/travel-request/{requestUuid}?companyUUID={companyUUID}&context={CONTEXT}
+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeFormatDescription
requestUuidstringpathRequired The 20-character unique identifier of the request that is being read.
companyUUIDstringqueryThe unique identifier of the company, in UUID format, to which the request belongs to.
contextstringqueryThe access level of the user, which determines the form fields they can view/modify. Supported values: TRAVELER, MANAGER, or PROCESSOR
+ +

Order of Precedence

+ +

The following order of precedence will be applied to determine the appropriate role to use in opening the report if the context is not defined in the URL, based on the applicable roles assigned to the user. Provision of context can narrow the roles considered in this evaluation to more accurately direct the UI to the appropriate role.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
 RoleContext
1Request User (Request owner)TRAVELER
2Delegate for Request ownerTRAVELER
3Request ApproverMANAGER
4Delegate for Request approverMANAGER
5Request Proxy for the Request owner’s groupTRAVELER
6Request Administrator for the Request owner’s groupPROCESSOR
+ +

When the deep link URL is generated without the company UUID, the user will be prompted with a sign in page to provide login ID in order to discover the company UUID. The user will be prompted with the identity provider (IdP) sign in page to provide the appropriate login ID, which is used for authentication purposes.

+ +

Example:

+ +
https://www.concursolutions.com/goto/travel-request/224AF3CDCC2A5244A37C72FA5770C6F2?companyUUID=ae4a796a-68da-4b80-b508-36022e2bacef
+
+ +

This deep link URL will support the feature to access SAP Concur solutions via SSO or username/password authentication when launched from third party applications. When clicked, this link will:

+ + diff --git a/feed.xml b/feed.xml index 1b0b8cdb0..e0c797b58 100644 --- a/feed.xml +++ b/feed.xml @@ -5,8 +5,8 @@ Concur docs provides comprehensive information on working with the Concur platform https://preview.developer.concur.com/ - Thu, 14 Sep 2023 18:25:52 +0000 - Thu, 14 Sep 2023 18:25:52 +0000 + Thu, 14 Sep 2023 18:55:11 +0000 + Thu, 14 Sep 2023 18:55:11 +0000 Jekyll v4.1.1