Udostępnij przez

Przekształcenia oświadczeń całkowitych

Ważne

Od 1 maja 2025 r. usługa Azure AD B2C nie będzie już dostępna do zakupu dla nowych klientów. Dowiedz się więcej w naszych często zadawanych pytaniach.

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.

Dostosuj numer

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

Składnik TransformationClaimType Typ danych Notatki
Oświadczenie wejściowe inputClaim (Twierdzenie wejściowe) int (integer) 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.
Parametr wejściowy Obsługujący sznurek Możliwe wartości: INCREMENT (wartość domyślna) lub DECREMENT.
OutputClaim (Roszczenie wyjściowe) outputClaim (roszczenie wyjściowe) int (integer) Typ oświadczenia, który jest generowany po wywołaniu tego przekształcenia oświadczeń.

Przykład kolumny AdjustNumber

Użyj tego przekształcenia oświadczenia, aby zwiększyć lub zmniejszyć wartość oświadczenia liczbowego. Następujące przekształcenie 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 polecenia 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 (Liczba_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ń.

Składnik TransformationClaimType Typ danych Notatki
Oświadczenie wejściowe inputClaim (Twierdzenie wejściowe) int (integer) 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.
Parametr wejściowy Porównaj z wartością int (integer) Druga liczba do porównania, czy jest większa, mniejsza, równa, czy nie równa się pierwszej liczbie.
Parametr wejściowy Obsługujący sznurek Możliwe wartości: LessThan, GreaterThan, GreaterThanOrEqual, LessThanOrEqual, Equal, NotEqual.
Parametr wejściowy throwError (błąd rzutu) typ logiczny (boolowski) Określa, czy to potwierdzenie powinno zgłosić błąd, jeśli wynik porównania to true. Możliwe wartości: true (wartość domyślna) lub false.
 
Po ustawieniu true wartości (tryb asercji) wynik porównania to 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 (Roszczenie wyjściowe) outputClaim (roszczenie wyjściowe) typ logiczny (boolowski) 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 , który jest wywoływany przez własny profil techniczny.

Metadane własnego profilu technicznego AssertNumberError kontrolują komunikat o błędzie wyświetlany użytkownikowi przez profil techniczny. Komunikaty o błędach mogą być zlokalizowane.

<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 wartości AssertNumber

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
    • Porównaj z wartością: 5
    • throwError: prawda
  • 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
    • Porównaj z wartością: 5
    • throwError: fałsz
  • Oświadczenia wyjściowe:
    • outputClaim: prawda

KonwertujNumberToStringClaim

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

Składnik TransformationClaimType Typ danych Notatki
Oświadczenie wejściowe inputClaim (Twierdzenie wejściowe) długi Typ oświadczenia, który ma być konwertowany na ciąg.
OutputClaim (Roszczenie wyjściowe) outputClaim (roszczenie wyjściowe) sznurek 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ługi)
  • Oświadczenia wyjściowe:
    • outputClaim: "12334" (ciąg)

Dalsze kroki

  • Znajdź więcej przykładów przekształcania oświadczeń w repozytorium GitHub społeczności usługi Azure AD B2C
  • Last updated on