Udostępnij za pośrednictwem

Przekształcenia oświadczeń całkowitych

  • Artykuł

Ten artykuł zawiera przykłady użycia przekształceń oświadczeń całkowitych schematu struktury środowiska tożsamości w usłudze Azure Active Directory B2C (Azure AD B2C). Aby uzyskać więcej informacji, zobacz ClaimsTransformations.

Dopasuj numer

Zwiększa lub zmniejsza oświadczenie liczbowe i zwraca nowe oświadczenie. Zapoznaj się z pokazem live tej transformacji oświadczeń.

Element TransformationClaimType Typ danych Uwagi
InputClaim inputClaim int Typ oświadczenia, który zawiera liczbę do zwiększenia lub zmniejszenia. inputClaim Jeśli wartość oświadczenia ma wartość null, zostanie użyta wartość domyślna 0.
Inputparameter Operator ciąg Możliwe wartości: INCREMENT (wartość domyślna) lub DECREMENT.
OutputClaim outputClaim int Typ oświadczenia, który jest generowany po wywołaniu tej transformacji oświadczeń.

Przykład funkcji AdjustNumber

Użyj tej transformacji oświadczenia, aby zwiększyć lub zmniejszyć wartość oświadczenia liczbowego. Następująca transformacja oświadczenia zwiększa wartość oświadczenia liczbowego.

<ClaimsTransformation Id="UpdateSteps" TransformationMethod="AdjustNumber">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="steps" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="Operator" DataType="string" Value="INCREMENT" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="steps" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Oświadczenia wejściowe:
    • inputClaim: 1
  • Parametry wejściowe:
    • Operator: PRZYROST
  • Oświadczenia wyjściowe:
    • outputClaim: 2

Przykład funkcji AdjustNumber z wartością null

Jeśli oświadczenie wejściowe ma wartość null, oświadczenie wyjściowe będzie jedno.

  • Oświadczenia wejściowe:
    • inputClaim: NULL
  • Parametry wejściowe:
    • Operator: PRZYROST
  • Oświadczenia wyjściowe:
    • outputClaim: 1

AssertNumber

Określa, czy oświadczenie liczbowe jest większe, mniejsze, równe, czy nie równe liczbie. Zapoznaj się z pokazem live tej transformacji oświadczeń.

Element TransformationClaimType Typ danych Uwagi
InputClaim inputClaim int Pierwsze oświadczenie liczbowe do porównania, czy jest większe, mniejsze, równe, czy nie równe niż druga liczba. Wartość null zgłasza wyjątek.
Inputparameter CompareToValue int Druga liczba do porównania, czy jest większa, mniejsza, równa, czy nie równa się pierwszej liczbie.
Inputparameter Operator ciąg Możliwe wartości: LessThan, , GreaterThanOrEqualGreaterThan, LessThanOrEqual, Equal, NotEqual.
Inputparameter throwError boolean Określa, czy to twierdzenie powinno zgłaszać błąd, jeśli wynik porównania to true. Możliwe wartości: true (wartość domyślna) lub false.
 
Po ustawieniu wartości true (tryb asercji), a wynikiem porównania jest true, zostanie zgłoszony wyjątek. W przypadku ustawienia wartości false (tryb oceny) wynik jest nowym typem oświadczenia logicznego o wartości true, lub false.
OutputClaim outputClaim boolean Jeśli ThrowError ustawiono wartość false, to oświadczenie wyjściowe zawiera truewartość lub false zgodnie z wynikiem porównania.

Tryb asercji

Gdy throwError parametr wejściowy to true (wartość domyślna), transformacja oświadczeń AssertNumber jest zawsze wykonywana z profilu technicznego weryfikacji wywoływanego przez własny profil techniczny.

Metadane profilu technicznego assertNumberError sterują komunikatem o błędzie prezentowanym użytkownikowi przez profil techniczny. Komunikaty o błędach można lokalizować.

<TechnicalProfile Id="SelfAsserted-LocalAccountSignin-Email">
  <Metadata>
    <Item Key="AssertNumberError">You've reached the maximum logon attempts</Item>
  </Metadata>
  ...
</TechnicalProfile>

Aby uzyskać więcej informacji na temat wywoływania przekształcenia oświadczeń w trybie asercji, zobacz AssertStringClaimsAreEqual, AssertBooleanClaimIsEqualToValue i AssertDateTimeIsGreaterThan przekształcenia oświadczeń.

Przykład asertywnegonumbera

Poniższy przykład potwierdza, że liczba prób wynosi ponad pięć. Przekształcenie oświadczeń zgłasza błąd zgodnie z wynikiem porównania.

<ClaimsTransformation Id="isOverLimit" TransformationMethod="AssertNumber">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="attempts" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="Operator" DataType="string" Value="GreaterThan" />
    <InputParameter Id="CompareToValue" DataType="int" Value="5" />
    <InputParameter Id="throwError" DataType="boolean" Value="true" />
  </InputParameters>
</ClaimsTransformation>
  • Oświadczenia wejściowe:
    • inputClaim: 10
  • Parametry wejściowe:
    • Operator: GreaterThan
    • CompareToValue: 5
    • throwError: true
  • Wynik: zgłoszony błąd

Przykład trybu oceny AssertNumber

Poniższy przykład ocenia, czy liczba prób wynosi ponad pięć. Oświadczenie wyjściowe zawiera wartość logiczną zgodnie z wynikiem porównania. Przekształcenie oświadczeń nie zgłosi błędu.

<ClaimsTransformation Id="isOverLimit" TransformationMethod="AssertNumber">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="attempts" TransformationClaimType="inputClaim" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="Operator" DataType="string" Value="GreaterThan" />
    <InputParameter Id="CompareToValue" DataType="int" Value="5" />
    <InputParameter Id="throwError" DataType="boolean" Value="false" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="attemptsCountExceeded" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Oświadczenia wejściowe:
    • inputClaim: 10
  • Parametry wejściowe:
    • Operator: GreaterThan
    • CompareToValue: 5
    • throwError: false
  • Oświadczenia wyjściowe:
    • outputClaim: true

ConvertNumberToStringClaim

Konwertuje długi typ danych na typ danych ciągu. Zapoznaj się z pokazem na żywo tej transformacji oświadczeń.

Element TransformationClaimType Typ danych Uwagi
InputClaim inputClaim długi Typ oświadczenia do konwersji na ciąg.
OutputClaim outputClaim ciąg Typ oświadczenia, który jest generowany po wywołaniu tego przekształcenia oświadczeń.

Przykład funkcji ConvertNumberToStringClaim

W tym przykładzie numericUserId oświadczenie o typie wartości długiej jest konwertowane na UserId oświadczenie o typie wartości ciągu.

<ClaimsTransformation Id="CreateUserId" TransformationMethod="ConvertNumberToStringClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="numericUserId" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="UserId" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Oświadczenia wejściowe:
    • inputClaim: 12334 (długie)
  • Oświadczenia wyjściowe:
    • outputClaim: "12334" (ciąg)

Następne kroki