Claims transformations improvements

Author: yoelhor

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

@@ -9,15 +9,13 @@ manager: CelesteDG
 ms.service: active-directory
 ms.workload: identity
 ms.topic: reference
-ms.date: 06/06/2020
+ms.date: 01/16/2022
 ms.author: kengaderdus
 ms.subservice: B2C
 ---
 
 # Boolean claims transformations
 
-[!INCLUDE [active-directory-b2c-advanced-audience-warning](../../includes/active-directory-b2c-advanced-audience-warning.md)]
-
 This article provides examples for using the boolean claims transformations of the Identity Experience Framework schema in Azure Active Directory B2C (Azure AD B2C). For more information, see [ClaimsTransformations](claimstransformations.md).
 
 ## AndClaims
@@ -30,6 +28,9 @@ Performs an And operation of two boolean inputClaims and sets the outputClaim wi
 | InputClaim | inputClaim2  | boolean | The second ClaimType to evaluate. |
 |OutputClaim | outputClaim | boolean | The ClaimTypes that will be produced after this claims transformation has been invoked (true or false). |
 
+
+### Example of AndClaims
+
 The following claims transformation demonstrates how to And two boolean ClaimTypes: `isEmailNotExist`, and `isSocialAccount`. The output claim `presentEmailSelfAsserted` is set to `true` if the value of both input claims are `true`. In an orchestration step, you can use a precondition to preset a self-asserted page, only if a social account email is empty.
 
 ```xml
@@ -44,13 +45,11 @@ The following claims transformation demonstrates how to And two boolean ClaimTyp
 </ClaimsTransformation>
 ```
 
-### Example of AndClaims
-
 - Input claims:
-    - **inputClaim1**: true
-    - **inputClaim2**: false
+  - **inputClaim1**: true
+  - **inputClaim2**: false
 - Output claims:
-    - **outputClaim**: false
+  - **outputClaim**: false
 
 
 ## AssertBooleanClaimIsEqualToValue
@@ -66,6 +65,8 @@ The **AssertBooleanClaimIsEqualToValue** claims transformation is always execute
 
 ![AssertStringClaimsAreEqual execution](./media/boolean-transformations/assert-execution.png)
 
+### Example of AssertBooleanClaimIsEqualToValue
+
 The following claims transformation demonstrates how to check the value of a boolean ClaimType with a `true` value. If the value of the `accountEnabled` ClaimType is false, an error message is thrown.
 
 ```xml
@@ -79,38 +80,46 @@ The following claims transformation demonstrates how to check the value of a boo
 </ClaimsTransformation>
 ```
 
+- Input claims:
+  - **inputClaim**: false
+  - **valueToCompareTo**: true
+- Result: Error thrown
+
+### Calling the AssertBooleanClaimIsEqualToValue claims transformation
 
-The `login-NonInteractive` validation technical profile calls the `AssertAccountEnabledIsTrue` claims transformation.
+The following `Example-AssertBoolean` validation technical profile calls the `AssertAccountEnabledIsTrue` claims transformation.
 
 ```xml
-<TechnicalProfile Id="login-NonInteractive">
-  ...
+<TechnicalProfile Id="Example-AssertBoolean">
+  <DisplayName>Unit test</DisplayName>
+  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.ClaimsTransformationProtocolProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
+  <OutputClaims>
+    <OutputClaim ClaimTypeReferenceId="ComparisonResult" DefaultValue="false" />
+  </OutputClaims>
   <OutputClaimsTransformations>
     <OutputClaimsTransformation ReferenceId="AssertAccountEnabledIsTrue" />
   </OutputClaimsTransformations>
+  <UseTechnicalProfileForSessionManagement ReferenceId="SM-Noop" />
 </TechnicalProfile>
 ```
 
-The self-asserted technical profile calls the validation **login-NonInteractive** technical profile.
+The self-asserted technical profile calls the validation `Example-AssertBoolean` technical profile.
 
 ```xml
-<TechnicalProfile Id="SelfAsserted-LocalAccountSignin-Email">
+<TechnicalProfile Id="SelfAsserted-AssertDateTimeIsGreaterThan">
+  <DisplayName>Example</DisplayName>
+  <Protocol Name="Proprietary" Handler="Web.TPEngine.Providers.SelfAssertedAttributeProvider, Web.TPEngine, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
   <Metadata>
+    <Item Key="ContentDefinitionReferenceId">api.selfasserted</Item>
     <Item Key="UserMessageIfClaimsTransformationBooleanValueIsNotEqual">Custom error message if account is disabled.</Item>
   </Metadata>
+  ...
   <ValidationTechnicalProfiles>
-    <ValidationTechnicalProfile ReferenceId="login-NonInteractive" />
+    <ValidationTechnicalProfile ReferenceId="Example-AssertBoolean" />
   </ValidationTechnicalProfiles>
 </TechnicalProfile>
 ```
 
-### Example of AssertBooleanClaimIsEqualToValue
-
-- Input claims:
-    - **inputClaim**: false
-    - **valueToCompareTo**: true
-- Result: Error thrown
-
 ## CompareBooleanClaimToValue
 
 Checks that boolean value of a claim is equal to `true` or `false`, and return the result of the compression.
@@ -121,6 +130,8 @@ Checks that boolean value of a claim is equal to `true` or `false`, and return t
 | InputParameter |valueToCompareTo | boolean | The value to compare (true or false). |
 | OutputClaim | compareResult | boolean | The ClaimType that is produced after this ClaimsTransformation has been invoked. |
 
+### Example of CompareBooleanClaimToValue
+
 The following claims transformation demonstrates how to check the value of a boolean ClaimType with a `true` value. If the value of the `IsAgeOver21Years` ClaimType is equal to `true`, the claims transformation returns `true`, otherwise `false`.
 
 ```xml
@@ -137,14 +148,12 @@ The following claims transformation demonstrates how to check the value of a boo
 </ClaimsTransformation>
 ```
 
-### Example of CompareBooleanClaimToValue
-
 - Input claims:
-    - **inputClaim**: false
+  - **inputClaim**: false
 - Input parameters:
-    - **valueToCompareTo**: true
+  - **valueToCompareTo**: true
 - Output claims:
-    - **compareResult**: false
+  - **compareResult**: false
 
 ## NotClaims
 
@@ -155,7 +164,9 @@ Performs a Not operation of the boolean inputClaim and sets the outputClaim with
 | InputClaim | inputClaim | boolean | The claim to be operated. |
 | OutputClaim | outputClaim | boolean | The ClaimTypes that are produced after this ClaimsTransformation has been invoked (true or false). |
 
-Use this claim transformation to perform logical negation on a claim.
+### Example of NotClaims
+
+The following claim transformation demonstrates how to perform logical negation on a claim.
 
 ```xml
 <ClaimsTransformation Id="CheckWhetherEmailBePresented" TransformationMethod="NotClaims">
@@ -168,12 +179,10 @@ Use this claim transformation to perform logical negation on a claim.
 </ClaimsTransformation>
 ```
 
-### Example of NotClaims
-
 - Input claims:
-    - **inputClaim**: false
+  - **inputClaim**: false
 - Output claims:
-    - **outputClaim**: true
+  - **outputClaim**: true
 
 ## OrClaims
 
@@ -185,6 +194,8 @@ Computes an Or of two boolean inputClaims and sets the outputClaim with result o
 | InputClaim | inputClaim2 | boolean | The second ClaimType to evaluate. |
 | OutputClaim | outputClaim | boolean | The ClaimTypes that will be produced after this ClaimsTransformation has been invoked (true or false). |
 
+### Example of OrClaims
+
 The following claims transformation demonstrates how to `Or` two boolean ClaimTypes. In the orchestration step, you can use a precondition to preset a self-asserted page, if the value of one of the claims is `true`.
 
 ```xml
@@ -199,10 +210,12 @@ The following claims transformation demonstrates how to `Or` two boolean ClaimTy
 </ClaimsTransformation>
 ```
 
-### Example of OrClaims
-
 - Input claims:
-    - **inputClaim1**: true
-    - **inputClaim2**: false
+  - **inputClaim1**: true
+  - **inputClaim2**: false
 - Output claims:
-    - **outputClaim**: true
+  - **outputClaim**: true
+
+## Next steps
+
+- Find more [claims transformation samples](https://github.com/azure-ad-b2c/unit-tests/tree/main/claims-transformation) on the Azure AD B2C community GitHub repo

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

@@ -8,7 +8,7 @@ manager: CelesteDG
 ms.service: active-directory
 ms.workload: identity
 ms.topic: reference
-ms.date: 1/14/2022
+ms.date: 1/16/2022
 ms.author: kengaderdus
 ms.subservice: B2C
 ms.custom: "b2c-support"
@@ -34,7 +34,7 @@ The **AssertDateTimeIsGreaterThan** claims transformation is always executed fro
 
 ![AssertStringClaimsAreEqual execution](./media/date-transformations/assert-execution.png)
 
-### AssertDateTimeIsGreaterThan example
+### Example of AssertDateTimeIsGreaterThan
 
 The following example compares the `currentDateTime` claim with the `approvedDateTime` claim. An error is thrown if `currentDateTime` is later than `approvedDateTime`. The transformation treats values as equal if they are within 5 minutes (30000 milliseconds) difference. It won't throw an error if the values are equal because `AssertIfEqualTo` is set to `false`.
 
@@ -57,12 +57,12 @@ The following example compares the `currentDateTime` claim with the `approvedDat
 >
 
 - Input claims:
-    - **leftOperand**: 2022-01-01T15:00:00
-    - **rightOperand**: 2022-01-22T15:00:00
+  - **leftOperand**: 2022-01-01T15:00:00
+  - **rightOperand**: 2022-01-22T15:00:00
 - Input parameters:
-    - **AssertIfEqualTo**: false
-    - **AssertIfRightOperandIsNotPresent**: true
-    - **TreatAsEqualIfWithinMillseconds**: 300000 (30 seconds)
+  - **AssertIfEqualTo**: false
+  - **AssertIfRightOperandIsNotPresent**: true
+  - **TreatAsEqualIfWithinMillseconds**: 300000 (30 seconds)
 - Result: Error thrown
 
 ### Call the claims transformation
@@ -100,35 +100,6 @@ The self-asserted technical profile calls the validation `Example-AssertDates` t
 </TechnicalProfile>
 ```
 
-## ConvertDateToDateTimeClaim
-
-Converts a `Date` claim type to a `DateTime` claim type. The claims transformation converts the time format and adds 12:00:00 AM to the date.
-
-| Item | TransformationClaimType | Data Type | Notes |
-| ---- | ----------------------- | --------- | ----- |
-| InputClaim | inputClaim | date | The claim type to be converted. |
-| OutputClaim | outputClaim | dateTime | The claim type that is produced after this claims transformation has been invoked. |
-
-### ConvertDateToDateTimeClaim example
-
-The following example demonstrates the conversion of the claim `dateOfBirth` (date data type) to another claim `dateOfBirthWithTime` (dateTime data type).
-
-```xml
-  <ClaimsTransformation Id="ConvertToDateTime" TransformationMethod="ConvertDateToDateTimeClaim">
-    <InputClaims>
-      <InputClaim ClaimTypeReferenceId="dateOfBirth" TransformationClaimType="inputClaim" />
-    </InputClaims>
-    <OutputClaims>
-      <OutputClaim ClaimTypeReferenceId="dateOfBirthWithTime" TransformationClaimType="outputClaim" />
-    </OutputClaims>
-  </ClaimsTransformation>
-```
-
-- Input claims:
-    - **inputClaim**: 2022-01-03
-- Output claims:
-    - **outputClaim**: 2022-01-03T00:00:00.0000000Z
-
 ## ConvertDateTimeToDateClaim
 
 Converts a `DateTime` claim type to a `Date` claim type. The claims transformation removes the time format from the date.
@@ -138,7 +109,7 @@ Converts a `DateTime` claim type to a `Date` claim type. The claims transformati
 | InputClaim | inputClaim | dateTime | The claim type to be converted. |
 | OutputClaim | outputClaim | date | The claim type that is produced after this claims transformation has been invoked. |
 
-### ConvertDateTimeToDateClaim example
+### Example of ConvertDateTimeToDateClaim
 
 The following example demonstrates the conversion of the claim `systemDateTime` (dateTime data type) to another claim `systemDate` (date data type).
 
@@ -158,6 +129,35 @@ The following example demonstrates the conversion of the claim `systemDateTime`
 - Output claims:
   - **outputClaim**: 2022-01-03
 
+## ConvertDateToDateTimeClaim
+
+Converts a `Date` claim type to a `DateTime` claim type. The claims transformation converts the time format and adds 12:00:00 AM to the date.
+
+| Item | TransformationClaimType | Data Type | Notes |
+| ---- | ----------------------- | --------- | ----- |
+| InputClaim | inputClaim | date | The claim type to be converted. |
+| OutputClaim | outputClaim | dateTime | The claim type that is produced after this claims transformation has been invoked. |
+
+### Example of ConvertDateToDateTimeClaim
+
+The following example demonstrates the conversion of the claim `dateOfBirth` (date data type) to another claim `dateOfBirthWithTime` (dateTime data type).
+
+```xml
+  <ClaimsTransformation Id="ConvertToDateTime" TransformationMethod="ConvertDateToDateTimeClaim">
+    <InputClaims>
+      <InputClaim ClaimTypeReferenceId="dateOfBirth" TransformationClaimType="inputClaim" />
+    </InputClaims>
+    <OutputClaims>
+      <OutputClaim ClaimTypeReferenceId="dateOfBirthWithTime" TransformationClaimType="outputClaim" />
+    </OutputClaims>
+  </ClaimsTransformation>
+```
+
+- Input claims:
+  - **inputClaim**: 2022-01-03
+- Output claims:
+  - **outputClaim**: 2022-01-03T00:00:00.0000000Z
+
 ## DateTimeComparison
 
 Compares two dates and determines whether the first date is later, earlier, or equal to another. The result is a new Boolean claim with a value of `true` or `false`.
@@ -173,7 +173,7 @@ Compares two dates and determines whether the first date is later, earlier, or e
 Use this claims transformation to determine if first date plus the timespan parameter is later, earlier, or equal to another. For example, you may store the last time a user accepted your terms of services (TOS). After three months, you can ask the user to access the TOS again.
 To run the claim transformation, you first need to get the current date and also the last time user accepts the TOS.
 
-### DateTimeComparison example
+### Example of DateTimeComparison
 
 The following example shows that the first date (2022-01-01T00:00:00) plus 90 days is later than the second date (2022-03-16T00:00:00).
 
@@ -194,13 +194,13 @@ The following example shows that the first date (2022-01-01T00:00:00) plus 90 da
 ```
 
 - Input claims:
-    - **firstDateTime**: 2022-01-01T00:00:00.100000Z
-    - **secondDateTime**: 2022-03-16T00:00:00.100000Z
+  - **firstDateTime**: 2022-01-01T00:00:00.100000Z
+  - **secondDateTime**: 2022-03-16T00:00:00.100000Z
 - Input parameters:
-    - **operator**: later than
-    - **timeSpanInSeconds**: 7776000 (90 days)
+  - **operator**: later than
+  - **timeSpanInSeconds**: 7776000 (90 days)
 - Output claims:
-    - **result**: true
+  - **result**: true
 
 ## GetCurrentDateTime
 
@@ -210,7 +210,7 @@ Get the current UTC date and time and add the value to a claim type.
 | ---- | ----------------------- | --------- | ----- |
 | OutputClaim | currentDateTime | dateTime | The claim type that is produced after this claims transformation has been invoked. |
 
-### GetCurrentDateTime example
+### Example of GetCurrentDateTime
 
 The following example shows how to get the current data and time:
 
@@ -222,8 +222,8 @@ The following example shows how to get the current data and time:
 </ClaimsTransformation>
 ```
 
-* Output claims:
-    * **currentDateTime**: 2022-01-14T11:40:35.0000000Z
+- Output claims:
+  - **currentDateTime**: 2022-01-14T11:40:35.0000000Z
 
 ## Next steps