Udostępnij przez

Przekształcenia oświadczeń StringCollection

Ten artykuł zawiera przykłady użycia przekształceń oświadczeń kolekcji ciągów schematu struktury środowiska 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ń.

Składnik TransformationClaimType Typ danych Notatki
Oświadczenie wejściowe element ciąg Typ oświadczenia, który ma zostać dodany do oświadczenia wyjściowego.
Oświadczenie wejściowe kolekcja stringCollection (kolekcja ciągów) Kolekcja ciągów do dodania 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 (Roszczenie wyjściowe) kolekcja stringCollection (kolekcja ciągów) Typ oświadczenia utworzony po wywołaniu tej transformacji oświadczeń z wartością określoną w oświadczeniu wejściowym.

Użyj tego przekształcenia 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 innychMails ClaimType.

Przykład polecenia AddItemToStringCollection

Następujące przekształcenie oświadczeń dodaje typ oświadczenia wiadomości e-mail do innychMails 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]
    • element: "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ń.

Składnik TransformationClaimType Typ danych Notatki
Oświadczenie wejściowe kolekcja stringCollection (kolekcja ciągów) Kolekcja ciągów do dodania 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.
Parametr wejściowy element ciąg Wartość, która ma zostać dodana do oświadczenia wyjściowego.
OutputClaim (Roszczenie wyjściowe) kolekcja stringCollection (kolekcja ciągów) Typ oświadczenia, który jest generowany po wywołaniu tego przekształcenia oświadczeń, z wartością określoną w parametrze wejściowym.

Przykład polecenia AddParameterToStringCollection

W poniższym przykładzie dodano 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
    • element: "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ń.

Składnik TransformationClaimType Typ danych Notatki
Oświadczenie wejściowe kolekcja stringCollection (kolekcja ciągów) Typy oświadczeń używane przez przekształcenie oświadczeń w celu pobrania elementu.
OutputClaim (Roszczenie wyjściowe) extractedItem ciąg Typy oświadczeń, które są generowane po wywołaniu tego oświadczeniaTransformation. Pierwszy element w kolekcji.

Przykład 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ń.

Składnik TransformationClaimType Typ danych Notatki
Oświadczenie wejściowe inputClaim (Twierdzenie wejściowe) stringCollection (kolekcja ciągów) Oświadczenie do przeszukania.
Parametr wejściowy element ciąg Wartość do wyszukania.
Parametr wejściowy ignoreCase ciąg Określa, czy to porównanie powinno ignorować wielkość porównywanych ciągów.
OutputClaim (Roszczenie wyjściowe) outputClaim (roszczenie wyjściowe) typ logiczny (boolowski) Typ oświadczenia, który jest generowany po wywołaniu tego oświadczeniaTransformation. Wskaźnik logiczny, jeśli kolekcja zawiera taki ciąg

Przykład parametrów StringCollectionContains

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:
    • element: "Administrator"
    • 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ń.

Składnik TransformationClaimType Typ danych Notatki
Oświadczenie wejściowe kolekcja stringCollection (kolekcja ciągów) Oświadczenie do przeszukania.
Oświadczenie wejściowe element ciąg Typ oświadczenia, który zawiera wartość do wyszukania.
Parametr wejściowy ignoreCase ciąg Określa, czy to porównanie powinno ignorować wielkość porównywanych ciągów.
OutputClaim (Roszczenie wyjściowe) outputClaim (roszczenie wyjściowe) typ logiczny (boolowski) Typ oświadczenia, który jest generowany po wywołaniu tego oświadczeniaTransformation. Wskaźnik logiczny, jeśli kolekcja zawiera taki ciąg

Przykład elementu StringCollectionContainsClaim

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"]
    • element: "Administrator"
  • Parametry wejściowe:
    • ignoreCase: "true"
  • Oświadczenia wyjściowe:
    • outputClaim: "true"

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