Przekształcenia oświadczeń całkowitych

Artykuł
01/11/2024

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 `true`wartość 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

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

Share via