Delen via

Transformaties van StringCollection-claims

Dit artikel bevat voorbeelden voor het gebruik van de transformaties van tekenreeksverzamelingsclaims van het Identity Experience Framework-schema in Azure Active Directory B2C (Azure AD B2C). Zie claimtransformaties voor meer informatie.

AddItemToStringCollection

Hiermee voegt u een tekenreeksclaim toe aan een nieuwe unieke waarden stringCollection-claim. Bekijk de livedemo van deze claimtransformatie.

Onderdeel TransformatieClaimType Gegevenssoort Opmerkingen
Invoer claimen artikel touw Het ClaimType dat moet worden toegevoegd aan de uitvoerclaim.
Invoer claimen collectie StringCollection De tekenreeksverzameling die moet worden toegevoegd aan de uitvoerclaim. Als de verzameling items bevat, kopieert de claimtransformatie de items en voegt het item toe aan het einde van de uitvoerverzamelingsclaim.
Uitvoer claimen collectie StringCollection Het ClaimType dat wordt geproduceerd nadat deze claimtransformatie is aangeroepen, met de waarde die is opgegeven in de invoerclaim.

Gebruik deze claimtransformatie om een tekenreeks toe te voegen aan een nieuwe of bestaande stringCollection. Dit wordt vaak gebruikt in een technisch profiel van AAD-UserWriteUsingAlternativeSecurityId . Voordat een nieuw sociaal account wordt gemaakt, leest createOtherMailsFromEmail claims transformation het ClaimType en voegt de waarde toe aan het otherMails ClaimType.

Voorbeeld van AddItemToStringCollection

Met de volgende claimtransformatie wordt het e-mailclaimtype toegevoegd aan otherMails 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>
  • Invoerclaims:
    • verzameling: ["someone@outlook.com"]
    • item: "admin@contoso.com"
  • Uitvoerclaims:
    • verzameling: ["someone@outlook.com", "admin@contoso.com"]

AddParameterToStringCollection

Voegt een tekenreeksparameter toe aan een nieuwe unieke waarden stringCollection-claim. Bekijk de livedemo van deze claimtransformatie.

Onderdeel TransformatieClaimType Gegevenssoort Opmerkingen
Invoer claimen collectie StringCollection De tekenreeksverzameling die moet worden toegevoegd aan de uitvoerclaim. Als de verzameling items bevat, kopieert de claimtransformatie de items en voegt het item toe aan het einde van de uitvoerverzamelingsclaim.
Invoerparameter artikel touw De waarde die moet worden toegevoegd aan de uitvoerclaim.
Uitvoer claimen collectie StringCollection Het ClaimType dat wordt geproduceerd nadat deze claimtransformatie is aangeroepen, met de waarde die is opgegeven in de invoerparameter.

Voorbeeld van AddParameterToStringCollection

In het volgende voorbeeld wordt een constant e-mailadres (admin@contoso.com) toegevoegd aan de claim 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>
  • Invoerclaims:
    • verzameling: ["someone@outlook.com"]
  • Invoerparameters
    • item: "admin@contoso.com"
  • Uitvoerclaims:
    • verzameling: ["someone@outlook.com", "admin@contoso.com"]

GetSingleItemFromStringCollection

Hiermee haalt u het eerste item op uit de opgegeven tekenreeksverzameling. Bekijk de livedemo van deze claimtransformatie.

Onderdeel TransformatieClaimType Gegevenssoort Opmerkingen
Invoer claimen collectie StringCollection De ClaimTypes die door de claimtransformatie worden gebruikt om het item op te halen.
Uitvoer claimen extractedItem touw De ClaimTypes die worden geproduceerd nadat deze ClaimTransformation is aangeroepen. Het eerste item in de verzameling.

Voorbeeld van GetSingleItemFromStringCollection

In het volgende voorbeeld wordt de claim otherMails gelezen en wordt het eerste item in de e-mailclaim geretourneerd.

<ClaimsTransformation Id="CreateEmailFromOtherMails" TransformationMethod="GetSingleItemFromStringCollection">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="otherMails" TransformationClaimType="collection" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" TransformationClaimType="extractedItem" />
  </OutputClaims>
</ClaimsTransformation>
  • Invoerclaims:
    • verzameling: ["someone@outlook.com", "someone@contoso.com"]
  • Uitvoerclaims:
    • extractItem: "someone@outlook.com"

StringCollectionContains

Hiermee wordt gecontroleerd of een StringCollection-claimtype een element bevat. Bekijk de livedemo van deze claimtransformatie.

Onderdeel TransformatieClaimType Gegevenssoort Opmerkingen
Invoer claimen invoerClaim StringCollection De claim die moet worden doorzocht.
Invoerparameter artikel touw De te zoeken waarde.
Invoerparameter ignoreCase touw Hiermee geeft u op of deze vergelijking het gebruik van hoofdletters of kleine letters moet negeren voor de tekenreeksen die worden vergeleken.
Uitvoer claimen outputClaim booleaan Het ClaimType dat wordt geproduceerd nadat deze ClaimTransformation is aangeroepen. Een booleaanse indicator als de verzameling een dergelijke tekenreeks bevat

Voorbeeld van StringCollectionContains

In het volgende voorbeeld wordt gecontroleerd of het roles claimtype stringCollection de waarde van de beheerder bevat.

<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>
  • Invoerclaims:
    • inputClaim: ["reader", "author", "admin"]
  • Invoerparameters:
    • item: "Admin"
    • ignoreCase: 'true'
  • Uitvoerclaims:
    • outputClaim: "true"

StringCollectionContainsClaim

Controleert of een StringCollection-claimtype een claimwaarde bevat. Bekijk de livedemo van deze claimtransformatie.

Onderdeel TransformatieClaimType Gegevenssoort Opmerkingen
Invoer claimen collectie StringCollection De claim die moet worden doorzocht.
Invoer claimen artikel touw Het claimtype dat de waarde bevat die moet worden gezocht.
Invoerparameter ignoreCase touw Hiermee geeft u op of deze vergelijking het gebruik van hoofdletters of kleine letters moet negeren voor de tekenreeksen die worden vergeleken.
Uitvoer claimen outputClaim booleaan Het ClaimType dat wordt geproduceerd nadat deze ClaimTransformation is aangeroepen. Een booleaanse indicator als de verzameling een dergelijke tekenreeks bevat

Voorbeeld van StringCollectionContainsClaim

In het volgende voorbeeld wordt gecontroleerd of het roles claimtype stringCollection de waarde van het role claimtype bevat.

<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>
  • Invoerclaims:
    • verzameling: ["reader", "author", "admin"]
    • item: "Admin"
  • Invoerparameters:
    • ignoreCase: 'true'
  • Uitvoerclaims:
    • outputClaim: "true"

Volgende stappen

  • Last updated on