Merge pull request #105625 from yoelhor/patch-28

Update phone-number-claims-transformations.md

Author: Jak-MS

articles/active-directory-b2c/phone-number-claims-transformations.md

@@ -9,7 +9,7 @@ manager: celestedg
 ms.service: active-directory
 ms.workload: identity
 ms.topic: conceptual
-ms.date: 02/14/2020
+ms.date: 02/26/2020
 ms.author: marsma
 ms.subservice: B2C
 ---
@@ -22,9 +22,39 @@ This article provides reference and examples for using the phone number claims t
 
 [!INCLUDE [b2c-public-preview-feature](../../includes/active-directory-b2c-public-preview.md)]
 
+## ConvertPhoneNumberClaimToString
+
+Converts a `phoneNumber` data type into a `string` data type.
+
+| Item | TransformationClaimType | Data Type | Notes |
+| ---- | ----------------------- | --------- | ----- |
+| InputClaim | phoneNumber | phoneNumber |  The ClaimType to convert to a string. |
+| OutputClaim | phoneNumberString | string | The ClaimType that is produced after this claims transformation has been invoked. |
+
+In this example, the cellPhoneNumber claim with a value type of `phoneNumber` is converted to a cellPhone claim with a value type of `string`.
+
+```XML
+<ClaimsTransformation Id="PhoneNumberToString" TransformationMethod="ConvertPhoneNumberClaimToString">
+  <InputClaims>
+    <InputClaim ClaimTypeReferenceId="cellPhoneNumber" TransformationClaimType="phoneNumber" />
+  </InputClaims>
+  <OutputClaims>
+    <OutputClaim ClaimTypeReferenceId="cellPhone" TransformationClaimType="phoneNumberString" />
+  </OutputClaims>
+</ClaimsTransformation>
+```
+
+### Example
+
+- Input claims:
+  - **phoneNumber**: +11234567890 (phoneNumber)
+- Output claims:
+  - **phoneNumberString**: +11234567890 (string)
+
+
 ## ConvertStringToPhoneNumberClaim
 
-This claim validates the format of the phone number. If it is in a valid format, change it to a standard format used by Azure AD B2C. If the provided phone number is not in a valid format, an error message is returned.
+This claim transformation validates the format of the phone number. If it is in a valid format, change it to a standard format used by Azure AD B2C. If the provided phone number is not in a valid format, an error message is returned.
 
 | Item | TransformationClaimType | Data Type | Notes |
 | ---- | ----------------------- | --------- | ----- |
@@ -64,10 +94,10 @@ The self-asserted technical profile that calls the validation technical profile
 ### Example 1
 
 - Input claims:
-  - **phoneNumberString**: 045 456-7890
+  - **phoneNumberString**: 033 456-7890
   - **country**: DK
 - Output claims:
-  - **outputClaim**: +450546148120
+  - **outputClaim**: +450334567890
 
 ### Example 2
 
@@ -76,6 +106,7 @@ The self-asserted technical profile that calls the validation technical profile
 - Output claims: 
   - **outputClaim**: +11234567890
 
+
 ## GetNationalNumberAndCountryCodeFromPhoneNumberString
 
 This extracts the country code and the national number from the input claim, and optionally throws an exception if the supplied phone number is not valid.