Skip to content

Commit a15f23a

Browse files
authored
Update string-transformations.md
fixes https://github.com/MicrosoftDocs/azure-docs/issues/48366
1 parent 0db76fd commit a15f23a

File tree

1 file changed

+39
-2
lines changed

1 file changed

+39
-2
lines changed

articles/active-directory-b2c/string-transformations.md

Lines changed: 39 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ manager: celestedg
99
ms.service: active-directory
1010
ms.workload: identity
1111
ms.topic: reference
12-
ms.date: 02/05/2020
12+
ms.date: 02/20/2020
1313
ms.author: marsma
1414
ms.subservice: B2C
1515
---
@@ -30,7 +30,8 @@ Compare two claims, and throw an exception if they are not equal according to th
3030
| InputClaim | inputClaim2 | string | Second claim's type, which is to be compared. |
3131
| InputParameter | stringComparison | string | string comparison, one of the values: Ordinal, OrdinalIgnoreCase. |
3232

33-
The **AssertStringClaimsAreEqual** claims transformation is always executed from a [validation technical profile](validation-technical-profile.md) that is called by a [self-asserted technical profile](self-asserted-technical-profile.md). The **UserMessageIfClaimsTransformationStringsAreNotEqual** self-asserted technical profile metadata controls the error message that is presented to the user.
33+
The **AssertStringClaimsAreEqual** claims transformation is always executed from a [validation technical profile](validation-technical-profile.md) that is called by a [self-asserted technical profile](self-asserted-technical-profile.md), or a [DisplayConrtol](display-controls.md). The `UserMessageIfClaimsTransformationStringsAreNotEqual` metadata of a self-asserted technical profile controls the error message that is presented to the user.
34+
3435

3536
![AssertStringClaimsAreEqual execution](./media/string-transformations/assert-execution.png)
3637

@@ -513,6 +514,42 @@ The following example looks up the domain name in one of the inputParameters col
513514
- Output claims:
514515
- **outputClaim**: c7026f88-4299-4cdb-965d-3f166464b8a9
515516

517+
When `errorOnFailedLookup` input parameter is set to `true`, the **LookupValue** claims transformation is always executed from a [validation technical profile](validation-technical-profile.md) that is called by a [self-asserted technical profile](self-asserted-technical-profile.md), or a [DisplayConrtol](display-controls.md). The `LookupNotFound` metadata of a self-asserted technical profile controls the error message that is presented to the user.
518+
519+
![AssertStringClaimsAreEqual execution](./media/string-transformations/assert-execution.png)
520+
521+
The following example looks up the domain name in one of the inputParameters collections. The claims transformation looks up the domain name in the identifier and returns its value (an application ID), or raises an error message.
522+
523+
```XML
524+
<ClaimsTransformation Id="DomainToClientId" TransformationMethod="LookupValue">
525+
<InputClaims>
526+
<InputClaim ClaimTypeReferenceId="domainName" TransformationClaimType="inputParameterId" />
527+
</InputClaims>
528+
<InputParameters>
529+
<InputParameter Id="contoso.com" DataType="string" Value="13c15f79-8fb1-4e29-a6c9-be0d36ff19f1" />
530+
<InputParameter Id="microsoft.com" DataType="string" Value="0213308f-17cb-4398-b97e-01da7bd4804e" />
531+
<InputParameter Id="test.com" DataType="string" Value="c7026f88-4299-4cdb-965d-3f166464b8a9" />
532+
<InputParameter Id="errorOnFailedLookup" DataType="boolean" Value="true" />
533+
</InputParameters>
534+
<OutputClaims>
535+
<OutputClaim ClaimTypeReferenceId="domainAppId" TransformationClaimType="outputClaim" />
536+
</OutputClaims>
537+
</ClaimsTransformation>
538+
```
539+
540+
### Example
541+
542+
- Input claims:
543+
- **inputParameterId**: live.com
544+
- Input parameters:
545+
- **contoso.com**: 13c15f79-8fb1-4e29-a6c9-be0d36ff19f1
546+
- **microsoft.com**: 0213308f-17cb-4398-b97e-01da7bd4804e
547+
- **test.com**: c7026f88-4299-4cdb-965d-3f166464b8a9
548+
- **errorOnFailedLookup**: false
549+
- Error:
550+
- No match found for the input claim value in the list of input parameter ids and errorOnFailedLookup is true.
551+
552+
516553
## NullClaim
517554

518555
Clean the value of a given claim.

0 commit comments

Comments
 (0)