Udostępnij za pośrednictwem

Przekształcenia oświadczeń StringCollection

  • Artykuł

Ten artykuł zawiera przykłady użycia przekształceń oświadczeń kolekcji ciągów schematu struktury obsługi tożsamości w usłudze Azure Active Directory B2C (Azure AD B2C). Aby uzyskać więcej informacji, zobacz przekształcenia oświadczeń.

AddItemToStringCollection

Dodaje oświadczenie ciągu do nowego unikatowego oświadczenia stringCollection. Zapoznaj się z pokazem live tej transformacji oświadczeń.

Element TransformationClaimType Typ danych Uwagi
InputClaim Element ciąg Typ oświadczenia, który ma zostać dodany do oświadczenia wyjściowego.
InputClaim — kolekcja Stringcollection Kolekcja ciągów, która ma zostać dodana do oświadczenia wyjściowego. Jeśli kolekcja zawiera elementy, przekształcenie oświadczeń kopiuje elementy i dodaje element na końcu oświadczenia kolekcji wyjściowej.
OutputClaim — kolekcja Stringcollection Typ oświadczenia wygenerowany po wywołaniu tej transformacji oświadczeń z wartością określoną w oświadczeniu wejściowym.

Użyj tej transformacji oświadczeń, aby dodać ciąg do nowego lub istniejącego ciąguCollection. Jest on często używany w profilu technicznym AAD-UserWriteUsingAlternativeSecurityId . Przed utworzeniem nowego konta społecznościowego przekształcenie createOtherMailsFromEmail oświadczenia odczytuje wartość ClaimType i dodaje wartość do innegoMails ClaimType.

Przykład polecenia AddItemToStringCollection

Następujące przekształcenie oświadczeń dodaje typ oświadczenia wiadomości e-mail do innegoMails ClaimType.

<ClaimsTransformation Id="CreateOtherMailsFromEmail" TransformationMethod="AddItemToStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" TransformationClaimType="item" />
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </OutputClaims>
</ClaimsTransformation>
  • Oświadczenia wejściowe:
    • kolekcja: [""someone@outlook.com]
    • item: "admin@contoso.com"
  • Oświadczenia wyjściowe:
    • kolekcja: [""someone@outlook.com, "admin@contoso.com"]

AddParameterToStringCollection

Dodaje parametr ciągu do nowego unikatowego oświadczenia stringCollection. Zapoznaj się z pokazem live tej transformacji oświadczeń.

Element TransformationClaimType Typ danych Uwagi
InputClaim — kolekcja Stringcollection Kolekcja ciągów, która ma zostać dodana do oświadczenia wyjściowego. Jeśli kolekcja zawiera elementy, przekształcenie oświadczeń kopiuje elementy i dodaje element na końcu oświadczenia kolekcji wyjściowej.
Inputparameter Element ciąg Wartość, która ma zostać dodana do oświadczenia wyjściowego.
OutputClaim — kolekcja Stringcollection Typ oświadczenia wygenerowany po wywołaniu tej transformacji oświadczeń z wartością określoną w parametrze wejściowym.

Przykład polecenia AddParameterToStringCollection

Poniższy przykład dodaje stały adres e-mail (admin@contoso.com) do oświadczenia otherMails .

<ClaimsTransformation Id="SetCompanyEmail" TransformationMethod="AddParameterToStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="item" DataType="string" Value="admin@contoso.com" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </OutputClaims>
</ClaimsTransformation>
  • Oświadczenia wejściowe:
    • kolekcja: [""someone@outlook.com]
  • Parametry wejściowe
    • item: "admin@contoso.com"
  • Oświadczenia wyjściowe:
    • kolekcja: [""someone@outlook.com, "admin@contoso.com"]

GetSingleItemFromStringCollection

Pobiera pierwszy element z podanej kolekcji ciągów. Zapoznaj się z pokazem live tej transformacji oświadczeń.

Element TransformationClaimType Typ danych Uwagi
InputClaim — kolekcja Stringcollection Typy oświadczeń używane przez przekształcenie oświadczeń w celu pobrania elementu.
OutputClaim extractedItem ciąg Typy oświadczeń, które są generowane po wywołaniu tej funkcji ClaimsTransformation. Pierwszy element w kolekcji.

Przykład polecenia GetSingleItemFromStringCollection

Poniższy przykład odczytuje oświadczenie otherMails i zwraca pierwszy element do oświadczenia e-mail .

<ClaimsTransformation Id="CreateEmailFromOtherMails" TransformationMethod="GetSingleItemFromStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" TransformationClaimType="extractedItem" />
  </OutputClaims>
</ClaimsTransformation>
  • Oświadczenia wejściowe:
    • kolekcja: [""someone@outlook.com, "someone@contoso.com"]
  • Oświadczenia wyjściowe:
    • extractedItem: "someone@outlook.com"

StringCollectionContains

Sprawdza, czy typ oświadczenia StringCollection zawiera element. Zapoznaj się z pokazem live tej transformacji oświadczeń.

Element TransformationClaimType Typ danych Uwagi
InputClaim inputClaim Stringcollection Przeszukane oświadczenie.
Inputparameter element ciąg Wartość do wyszukania.
Inputparameter Ignorecase ciąg Określa, czy to porównanie powinno ignorować przypadek porównywanych ciągów.
OutputClaim outputClaim boolean Typ oświadczenia, który jest generowany po wywołaniu tego elementu ClaimsTransformation. Wskaźnik logiczny, jeśli kolekcja zawiera taki ciąg

Przykład ciąguCollectionContains

Poniższy przykład sprawdza, czy roles typ oświadczenia stringCollection zawiera wartość administratora.

<ClaimsTransformation Id="IsAdmin" TransformationMethod="StringCollectionContains">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="roles" TransformationClaimType="inputClaim"/>
  </InputClaims>
  <InputParameters>
    <InputParameter  Id="item" DataType="string" Value="Admin"/>
    <InputParameter  Id="ignoreCase" DataType="string" Value="true"/>
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="isAdmin" TransformationClaimType="outputClaim"/>
  </OutputClaims>
</ClaimsTransformation>
  • Oświadczenia wejściowe:
    • inputClaim: ["reader", "author", "admin"]
  • Parametry wejściowe:
    • item: "Administracja"
    • ignoreCase: "true"
  • Oświadczenia wyjściowe:
    • outputClaim: "true"

StringCollectionContainsClaim

Sprawdza, czy typ oświadczenia StringCollection zawiera wartość oświadczenia. Zapoznaj się z pokazem live tej transformacji oświadczeń.

Element TransformationClaimType Typ danych Uwagi
InputClaim — kolekcja Stringcollection Przeszukane oświadczenie.
InputClaim element ciąg Typ oświadczenia, który zawiera wartość do wyszukania.
Inputparameter Ignorecase ciąg Określa, czy to porównanie powinno ignorować przypadek porównywanych ciągów.
OutputClaim outputClaim boolean Typ oświadczenia, który jest generowany po wywołaniu tego elementu ClaimsTransformation. Wskaźnik logiczny, jeśli kolekcja zawiera taki ciąg

Przykład ciąguCollectionContainsClaim

Poniższy przykład sprawdza, czy roles typ oświadczenia stringCollection zawiera wartość role typu oświadczenia.

<ClaimsTransformation Id="HasRequiredRole" TransformationMethod="StringCollectionContainsClaim">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="roles" TransformationClaimType="collection" />
    <InputClaim ClaimTypeReferenceId="role" TransformationClaimType="item" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="ignoreCase" DataType="string" Value="true" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="hasAccess" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>
  • Oświadczenia wejściowe:
    • kolekcja: ["reader", "author", "admin"]
    • item: "Administracja"
  • Parametry wejściowe:
    • ignoreCase: "true"
  • Oświadczenia wyjściowe:
    • outputClaim: "true"

Następne kroki