Megosztás a következőn keresztül:

Telefonszám jogcímátalakításainak definiálása Azure AD B2C-ben

  • Cikk

Ez a cikk referencia- és példákat tartalmaz a telefonszámjogcímek átalakításának használatára az Azure Active Directory B2C (Azure AD B2C) egyéni szabályzatában. A jogcímátalakításokról általában a ClaimsTransformations (Jogcímátalakítások) című témakörben talál további információt.

Megjegyzés

Ez a funkció nyilvános előzetes verzióban érhető el.

ConvertPhoneNumberClaimToString

phoneNumber Adattípust adattípussá string alakít át. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem TransformationClaimType Adattípus Jegyzetek
InputClaim phoneNumber phoneNumber A sztringgé konvertálandó jogcím.
OutputClaim phoneNumberString sztring A jogcímátalakítás meghívása után létrehozott jogcím.

Példa a ConvertPhoneNumberClaimToString elemre

Ebben a példában az érték típusú phoneNumber cellPhoneNumber jogcím cellPhone-jogcímké lesz konvertálva, amelynek értéktípusa string.

<ClaimsTransformation Id="PhoneNumberToString" TransformationMethod="ConvertPhoneNumberClaimToString">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="cellPhoneNumber" TransformationClaimType="phoneNumber" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="cellPhone" TransformationClaimType="phoneNumberString" />
  </OutputClaims>
</ClaimsTransformation>
  • Bemeneti jogcímek:
    • phoneNumber: +11234567890 (phoneNumber)
  • Kimeneti jogcímek:
    • phoneNumberString: +11234567890 (sztring)

ConvertStringToPhoneNumberClaim

Ellenőrzi a telefonszám formátumát. Ha érvényes, módosítsa a Azure AD B2C által használt szabványos formátumra. Ha a megadott telefonszám nem érvényes formátumban van, hibaüzenet jelenik meg. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem TransformationClaimType Adattípus Jegyzetek
InputClaim phoneNumberString sztring A telefonszám sztringjogcíme. A telefonszámnak nemzetközi formátumban kell lennie, egy kezdő "+" és ország-/régiókóddal kiegészítve. Ha a bemeneti jogcím country meg van adva, a telefonszám helyi formátumban van (az ország/régió kódja nélkül).
InputClaim ország sztring [Nem kötelező] A telefonszám ország-/régiókódjának sztringjogcíme ISO3166 formátumban (a kétbetűs ISO-3166 ország-/régiókód).
OutputClaim outputClaim phoneNumber A jogcímátalakítás eredménye.

A ConvertStringToPhoneNumberClaim jogcímátalakítás mindig egy érvényesítési műszaki profilból történik, amelyet egy önérvényesített technikai profil vagy megjelenítési vezérlő hív meg. A UserMessageIfClaimsTransformationInvalidPhoneNumber önaláért technikai profil metaadatai vezérli a felhasználónak megjelenő hibaüzenetet.

A hibaüzenet végrehajtási útvonalának ábrája

Példa: ConvertStringToPhoneNumberClaim

Az alábbi példa ellenőrzi, hogy a phoneString jogcím valóban érvényes telefonszám-e, majd a normál Azure AD B2C formátumban adja vissza a telefonszámot. Ellenkező esetben hibaüzenet jelenik meg.

<ClaimsTransformation Id="ConvertStringToPhoneNumber" TransformationMethod="ConvertStringToPhoneNumberClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="phoneString" TransformationClaimType="phoneNumberString" />
    <InputClaim ClaimTypeReferenceId="countryCode" TransformationClaimType="country" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="phoneNumber" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Bemeneti jogcímek:
    • phoneNumberString: 033 456-7890
    • ország: DK
  • Kimeneti jogcímek:
    • outputClaim: +450334567890

Példa: ConvertStringToPhoneNumberClaim országkód jogcím nélkül

Tekintse meg a jogcímátalakítás ezen módjának élő bemutatóját .

  • Bemeneti jogcímek:
    • phoneNumberString: +1 (123) 456-7890
  • Kimeneti jogcímek:
    • outputClaim: +11234567890

A ConvertStringToPhoneNumberClaim jogcímátalakítás meghívása

A jogcímátalakítást tartalmazó érvényesítési műszaki profilt meghívó önaláértelmezett technikai profil definiálhatja a hibaüzenetet.

<TechnicalProfile Id="SelfAsserted-LocalAccountSignUp-Phone">
  <Metadata>
    <Item Key="UserMessageIfClaimsTransformationInvalidPhoneNumber">Custom error message if the phone number is not valid.</Item>
  </Metadata>
  ...
</TechnicalProfile>

GetNationalNumberAndCountryCodeFromPhoneNumberString

Kinyeri az ország/régió kódját és az országos számot a bemeneti jogcímből, és opcionálisan kivételt jelez, ha a megadott telefonszám érvénytelen. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem TransformationClaimType Adattípus Jegyzetek
InputClaim phoneNumber sztring A telefonszám sztringjogcíme. A telefonszámnak nemzetközi formátumban kell lennie, egy kezdő "+" és ország-/régiókóddal kiegészítve.
InputParameter throwExceptionOnFailure boolean [Nem kötelező] Egy paraméter, amely azt jelzi, hogy a rendszer kivételt jelez-e, ha a telefonszám érvénytelen. Az alapértelmezett érték hamis.
InputParameter countryCodeType sztring [Nem kötelező] Egy paraméter, amely a kimeneti jogcím ország-/régiókódjának típusát jelzi. Az elérhető értékek a CallingCode (egy ország/régió nemzetközi híváskódja, például +1) vagy ISO3166 (a kétbetűs ISO-3166 ország-/régiókód).
OutputClaim nationalNumber sztring A telefonszám nemzeti számának sztringjogcíme.
OutputClaim countryCode sztring A telefonszám ország-/régiókódjának sztringjogcíme.

Ha a GetNationalNumberAndCountryCodeFromPhoneNumberString jogcímátalakítás egy önérvényesített műszaki profil vagy egy megjelenítésvezérlő művelet által meghívott érvényesítési műszaki profilból történik, akkor a UserMessageIfPhoneNumberParseFailure önérvényesített műszaki profil metaadatai szabályozzák a felhasználónak megjelenő hibaüzenetet.

A hibaüzenet végrehajtási útvonalának diagramja

Ezzel a jogcímátalakítással egy teljes telefonszámot feloszthat az ország/régió kódjára és az országos számra. Ha a megadott telefonszám érvénytelen, választhat, hogy hibaüzenetet küld.

Példa a GetNationalNumberAndCountryCodeFromPhoneNumberString elemre

Az alábbi példa megpróbálja felosztani a telefonszámot az országos számra és az ország/régió kódjára. Ha a telefonszám érvényes, a telefonszámot felülírja az országos szám. Ha a telefonszám érvénytelen, a rendszer nem ad ki kivételt, és a telefonszám eredeti értéke továbbra is megmarad.

<ClaimsTransformation Id="GetNationalNumberAndCountryCodeFromPhoneNumberString" TransformationMethod="GetNationalNumberAndCountryCodeFromPhoneNumberString">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="phoneNumber" TransformationClaimType="phoneNumber" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="throwExceptionOnFailure" DataType="boolean" Value="false" />
    <InputParameter Id="countryCodeType" DataType="string" Value="ISO3166" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="nationalNumber" TransformationClaimType="nationalNumber" />
    <OutputClaim ClaimTypeReferenceId="countryCode" TransformationClaimType="countryCode" />
  </OutputClaims>
</ClaimsTransformation>
  • Bemeneti jogcímek:
    • phoneNumber: +49 (123) 456-7890
  • Bemeneti paraméterek:
    • throwExceptionOnFailure: false
    • countryCodeType: ISO3166
  • Kimeneti jogcímek:
    • nationalNumber: 1234567890
    • countryCode: DE

Példa a GetNationalNumberAndCountryCodeFromPhoneNumberString és a CallingCode paraméterre

Az alábbi példa megpróbálja felosztani a telefonszámot nemzeti számra és országhívószámra.

<ClaimsTransformation Id="GetNationalNumberAndCountryCodeFromPhoneNumberString" TransformationMethod="GetNationalNumberAndCountryCodeFromPhoneNumberString">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="phoneNumber" TransformationClaimType="phoneNumber" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="throwExceptionOnFailure" DataType="boolean" Value="false" />
    <InputParameter Id="countryCodeType" DataType="string" Value="CallingCode" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="nationalNumber" TransformationClaimType="nationalNumber" />
    <OutputClaim ClaimTypeReferenceId="countryCode" TransformationClaimType="countryCode" />
  </OutputClaims>
</ClaimsTransformation>
  • Bemeneti jogcímek:
    • phoneNumber: +49 (123) 456-7890
  • Bemeneti paraméterek
    • throwExceptionOnFailure: false
    • countryCodeType: CallingCode
  • Kimeneti jogcímek:
    • nationalNumber: 1234567890
    • countryCode: +49

A GetNationalNumberAndCountryCodeFromPhoneNumberString jogcímátalakítás meghívása

A jogcímátalakítást tartalmazó érvényesítési műszaki profilt meghívó önérvényesített műszaki profil definiálhatja a hibaüzenetet.

<TechnicalProfile Id="SelfAsserted-LocalAccountSignup-Phone">
  <Metadata>
    <Item Key="UserMessageIfPhoneNumberParseFailure">Custom error message if the phone number is not valid.</Item>
  </Metadata>
  ...
</TechnicalProfile>

Következő lépések