JSON-jogcímek átalakítása

Cikk
10/30/2024

Ez a cikk példákat tartalmaz az Identity Experience Framework-séma JSON-jogcímátalakításainak használatára az Azure Active Directory B2C-ben (Azure AD B2C). További információ: jogcímátalakítások.

CreateJsonArray

Hozzon létre egy JSON-elemtömböt egy jogcímértékből. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	inputClaim	húr	A kimeneti jogcímhez hozzáadandó jogcím.
OutputClaim	outputClaim	húr	A jogcímátalakítás meghívása után létrehozott JSON-sztring.

Példa a CreateJsonArray-ra

Az alábbi példa egyetlen JSON-tömböt hoz létre.

<ClaimsTransformation Id="CreateJsonPayload" TransformationMethod="CreateJsonArray">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="result" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

Bemeneti jogcímek:
- inputClaim: someone@example.com
Kimeneti jogcímek:
- outputClaim: ["someone@contoso.com"]

GenerateJson

JSON-sztring létrehozásához használjon jogcímértékeket vagy állandókat. A pont jelölését követő elérésiút-sztring jelzi, hogy hová szúrja be az adatokat egy JSON-sztringbe. A pontokkal való felosztás után a rendszer minden egész számot JSON-tömb indexeként értelmez, a nem egész számokat pedig egy JSON-objektum indexeként értelmezi a rendszer.

Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	Minden sztring, amely a pont jelölését követi	húr	Annak a JSON-nak a JsonPathja, amelybe a jogcímérték be lesz szúrva.
InputParameter	Minden sztring, amely a pont jelölését követi	húr	Annak a JSON-nak a JsonPathja, amelybe az állandó sztringérték be lesz szúrva.
OutputClaim	outputClaim	húr	A létrehozott JSON-sztring.

JSON-tömbök

Ha JSON-objektumokat szeretne hozzáadni egy JSON-tömbhöz, használja a tömb nevének és indexének formátumát. A tömb nulla alapú. Kezdje nulláról N-ra, szám kihagyása nélkül. A tömb elemei bármilyen objektumot tartalmazhatnak. Az első elem például két objektumot tartalmaz, az appot és az appId azonosítót. A második elem egyetlen objektumot, programot tartalmaz. A harmadik elem négy objektumot, színt, nyelvet, emblémát és hátteret tartalmaz.

Az alábbi példa bemutatja, hogyan konfigurálhat JSON-tömböket. Az e-mail-tömb dinamikus InputClaims értékeket használ. Az értékek tömbje statikus InputParameters értékeket használ.

<ClaimsTransformation Id="GenerateJsonPayload" TransformationMethod="GenerateJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="mailToName1" TransformationClaimType="emails.0.name" />
    <InputClaim ClaimTypeReferenceId="mailToAddress1" TransformationClaimType="emails.0.address" />
    <InputClaim ClaimTypeReferenceId="mailToName2" TransformationClaimType="emails.1.name" />
    <InputClaim ClaimTypeReferenceId="mailToAddress2" TransformationClaimType="emails.1.address" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="values.0.app" DataType="string" Value="Mobile app" />
    <InputParameter Id="values.0.appId" DataType="string" Value="123" />
    <InputParameter Id="values.1.program" DataType="string" Value="Holidays" />
    <InputParameter Id="values.2.color" DataType="string" Value="Yellow" />
    <InputParameter Id="values.2.language" DataType="string" Value="Spanish" />
    <InputParameter Id="values.2.logo" DataType="string" Value="contoso.png" />
    <InputParameter Id="values.2.background" DataType="string" Value="White" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="result" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

A jogcímátalakítás eredménye:

{
  "values": [
    {
      "app": "Mobile app",
      "appId": "123"
    },
    {
      "program": "Holidays"
    },
    {
      "color": "Yellow",
      "language": "Spanish",
      "logo": "contoso.png",
      "background": "White"
    }
  ],
  "emails": [
    {
      "name": "Joni",
      "address": "joni@contoso.com"
    },
    {
      "name": "Emily",
      "address": "emily@contoso.com"
    }
  ]
}

Ha JSON-tömböt szeretne megadni mind a bemeneti jogcímekben, mind a bemeneti paraméterekben, el kell indítania a tömböt az InputClaims elemben, nullától N-ig. Ezután az InputParameters elemben folytassa az indexet az utolsó indexből.

Az alábbi példa egy olyan tömböt mutat be, amely a bemeneti jogcímekben és a bemeneti paraméterekben is definiálva van. Az értéktömbvalues.0 első eleme a bemeneti jogcímekben van definiálva. A bemeneti paraméterek az egyes values.1 indextől a két indexig values.2folytatódnak.

<ClaimsTransformation Id="GenerateJsonPayload" TransformationMethod="GenerateJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="app" TransformationClaimType="values.0.app" />
    <InputClaim ClaimTypeReferenceId="appId" TransformationClaimType="values.0.appId"  />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="values.1.program" DataType="string" Value="Holidays" />
    <InputParameter Id="values.2.color" DataType="string" Value="Yellow" />
    <InputParameter Id="values.2.language" DataType="string" Value="Spanish" />
    <InputParameter Id="values.2.logo" DataType="string" Value="contoso.png" />
    <InputParameter Id="values.2.background" DataType="string" Value="White" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="result" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

Példa a GenerateJsonra

Az alábbi példa egy JSON-sztringet hoz létre az "e-mail" és az "OTP" jogcímérték és az állandó sztringek alapján.

<ClaimsTransformation Id="GenerateRequestBody" TransformationMethod="GenerateJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" TransformationClaimType="personalizations.0.to.0.email" />
    <InputClaim ClaimTypeReferenceId="otp" TransformationClaimType="personalizations.0.dynamic_template_data.otp" />
    <InputClaim ClaimTypeReferenceId="copiedEmail" TransformationClaimType="personalizations.0.dynamic_template_data.verify-email" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="template_id" DataType="string" Value="d-4c56ffb40fa648b1aa6822283df94f60"/>
    <InputParameter Id="from.email" DataType="string" Value="service@contoso.com"/>
    <InputParameter Id="personalizations.0.subject" DataType="string" Value="Contoso account email verification code"/>
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="requestBody" TransformationClaimType="outputClaim"/>
  </OutputClaims>
</ClaimsTransformation>

A következő jogcímátalakítás egy JSON-sztring-jogcímet ad ki, amely a SendGridnek (egy külső e-mail-szolgáltatónak) küldött kérés törzse lesz. A JSON-objektum struktúráját az InputParameters és az InputClaims TransformationClaimTypes pontjegyzetében szereplő azonosítók határozzák meg. A pont jelölésében szereplő számok tömbökre utalnak. Az értékek az InputClaims értékeiből és az InputParameters "Érték" tulajdonságaiból származnak.

Bemeneti jogcímek:
- e-mail, átalakítási jogcím típusa personalizations.0.to.0.email: "someone@example.com"
- copiedEmail, átalakítási jogcím típusa personalizations.0.dynamic_template_data.verify-email: "someone@example.com"
- otp, átalakítási jogcím típusa personalizations.0.dynamic_template_data.otp "346349"
Bemeneti paraméter:
- template_id: "d-4c56ffb40fa648b1aa6822283df94f60"
- from.email: "service@contoso.com"
- personalizations.0.subject "Contoso-fiók e-mail ellenőrző kódja"

Kimeneti jogcím:

outputClaim:

{
  "personalizations": [
    {
      "to": [
        {
          "email": "someone@example.com"
        }
      ],
      "dynamic_template_data": {
        "otp": "346349",
        "verify-email" : "someone@example.com"
      },
      "subject": "Contoso account email verification code"
    }
  ],
  "template_id": "d-989077fbba9746e89f3f6411f596fb96",
  "from": {
    "email": "service@contoso.com"
  }
}

Egy másik példa a GenerateJsonra

Az alábbi példa egy JSON-sztringet hoz létre a jogcímértékek és az állandó sztringek alapján.

<ClaimsTransformation Id="GenerateRequestBody" TransformationMethod="GenerateJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="email" TransformationClaimType="customerEntity.email" />
    <InputClaim ClaimTypeReferenceId="objectId" TransformationClaimType="customerEntity.userObjectId" />
    <InputClaim ClaimTypeReferenceId="givenName" TransformationClaimType="customerEntity.firstName" />
    <InputClaim ClaimTypeReferenceId="surname" TransformationClaimType="customerEntity.lastName" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="customerEntity.role.name" DataType="string" Value="Administrator"/>
    <InputParameter Id="customerEntity.role.id" DataType="long" Value="1"/>
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="requestBody" TransformationClaimType="outputClaim"/>
  </OutputClaims>
</ClaimsTransformation>

A következő jogcímátalakítás egy JSON-sztring jogcímet ad ki, amely a REST API-nak küldött kérés törzse lesz. A JSON-objektum struktúráját az InputParameters és az InputClaims TransformationClaimTypes pontjegyzetében szereplő azonosítók határozzák meg. Az értékek az InputClaims értékeiből és az InputParameters "Érték" tulajdonságaiból származnak.

Bemeneti jogcímek:
- e-mail, átalakítási jogcím típusa customerEntity.email: "john.s@contoso.com"
- objectId, transformation claim type customerEntity.userObjectId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"
- givenName, átalakítási jogcím típusa customerEntity.firstName "John"
- vezetéknév, átalakítási jogcím típusa customerEntity.lastName "Smith"
Bemeneti paraméter:
- customerEntity.role.name: "Rendszergazda"
- customerEntity.role.id 1

Kimeneti jogcím:

requestBody:

{
   "customerEntity":{
      "email":"john.s@contoso.com",
      "userObjectId":"aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "firstName":"John",
      "lastName":"Smith",
      "role":{
         "name":"Administrator",
         "id": 1
      }
   }
}

A GenerateJson jogcímátalakítás egyszerű sztringeket fogad el. Ha egy bemeneti jogcím JSON-sztringet tartalmaz, az a sztringet elkerüli. A következő példában, ha a fenti CreateJsonArray e-mail kimenetét használja, azaz [""someone@contoso.com], bemeneti paraméterként az e-mail a következő JSON-jogcímben látható módon fog kinézni:

Kimeneti jogcím:

requestBody:

{
   "customerEntity":{
      "email":"[\"someone@contoso.com\"]",
      "userObjectId":"aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "firstName":"John",
      "lastName":"Smith",
      "role":{
         "name":"Administrator",
         "id": 1
      }
   }
}

GetClaimFromJson

Adott elem lekérése JSON-adatokból. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	inputJson	húr	A jogcímátalakítás által az elem lekéréséhez használt jogcímek.
InputParameter	claimToExtract	húr	a kinyerni kívánt JSON-elem neve.
OutputClaim	extractedClaim	húr	A jogcímátalakítás meghívása után létrehozott jogcím, a claimToExtract bemeneti paraméterben megadott elemérték.

Példa a GetClaimFromJsonra

A következő példában a jogcímátalakítás kinyerte az emailAddress elemet a JSON-adatokból: {"emailAddress": "someone@example.com", "displayName": "Someone"}

<ClaimsTransformation Id="GetEmailClaimFromJson" TransformationMethod="GetClaimFromJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="customUserData" TransformationClaimType="inputJson" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="claimToExtract" DataType="string" Value="emailAddress" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="extractedEmail" TransformationClaimType="extractedClaim" />
  </OutputClaims>
</ClaimsTransformation>

Bemeneti jogcímek:
- inputJson: {"emailAddress": "someone@example.com", "displayName": "Valaki"}
Bemeneti paraméter:
- claimToExtract: emailAddress
Kimeneti jogcímek:
- extractedClaim: someone@example.com

Egy másik példa a GetClaimFromJsonra

A GetClaimFromJson jogcímátalakítás egyetlen elemet kap egy JSON-adatból. Az előző példában az e-mailCím. A displayName lekéréséhez hozzon létre egy másik jogcímátalakítást. Példa:

<ClaimsTransformation Id="GetDisplayNameClaimFromJson" TransformationMethod="GetClaimFromJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="customUserData" TransformationClaimType="inputJson" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="claimToExtract" DataType="string" Value="displayName" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="displayName" TransformationClaimType="extractedClaim" />
  </OutputClaims>
</ClaimsTransformation>

Bemeneti jogcímek:
- inputJson: {"emailAddress": "someone@example.com", "displayName": "Valaki"}
Bemeneti paraméter:
- claimToExtract: displayName
Kimeneti jogcímek:
- extractedClaim: Valaki

GetClaimsFromJsonArray

A Json-adatokból lekérheti a megadott elemek listáját. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	jsonSourceClaim	húr	A JSON hasznos adattal rendelkező jogcím. Ezt a jogcímet használja a jogcímátalakítás a jogcímek lekéréséhez.
InputParameter	errorOnMissingClaims	Logikai	Megadja, hogy hibát jelez-e, ha valamelyik jogcím hiányzik.
InputParameter	includeEmptyClaims	húr	Adja meg, hogy szerepeljenek-e üres jogcímek.
InputParameter	jsonSourceKeyName	húr	Elemkulcs neve
InputParameter	jsonSourceValueName	húr	Elemérték neve
OutputClaim	Gyűjtemény	sztring, int, logikai és datetime	A kinyerni kívánt jogcímek listája. A jogcím nevének meg kell egyeznie a jsonSourceClaim bemeneti jogcímben megadott névvel.

Példa GetClaimsFromJsonArray

A következő példában a jogcímátalakítás a következő jogcímeket nyeri ki: e-mail (sztring), displayName (sztring), membershipNum (int), active (logikai) és birthDate (datetime) a JSON-adatokból.

<ClaimsTransformation Id="GetClaimsFromJson" TransformationMethod="GetClaimsFromJsonArray">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="jsonSourceClaim" TransformationClaimType="jsonSource" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="errorOnMissingClaims" DataType="boolean" Value="false" />
    <InputParameter Id="includeEmptyClaims" DataType="boolean" Value="false" />
    <InputParameter Id="jsonSourceKeyName" DataType="string" Value="key" />
    <InputParameter Id="jsonSourceValueName" DataType="string" Value="value" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" />
    <OutputClaim ClaimTypeReferenceId="displayName" />
    <OutputClaim ClaimTypeReferenceId="membershipID" />
    <OutputClaim ClaimTypeReferenceId="active" />
    <OutputClaim ClaimTypeReferenceId="birthDate" />
  </OutputClaims>
</ClaimsTransformation>

Bemeneti jogcímek:

jsonSourceClaim:

[
  {
    "key": "email",
    "value": "someone@example.com"
  },
  {
    "key": "displayName",
    "value": "Someone"
  },
  {
    "key": "membershipID",
    "value": 6353399
  },
  {
    "key": "active",
    "value": true
  },
  {
    "key": "birthDate",
    "value": "2005-09-23T00:00:00Z"
  }
]

Bemeneti paraméterek:
- errorOnMissingClaims: false
- includeEmptyClaims: false
- jsonSourceKeyName: kulcs
- jsonSourceValueName: érték
Kimeneti jogcímek:
- e-mail: "someone@example.com"
- displayName: "Valaki"
- membershipID: 6353399
- aktív: igaz
- birthDate: 2005-09-23T00:00:00Z

GetClaimsFromJsonArrayV2

A megadott elemek listájának lekérése egy sztringgyűjtemény JSON-elemeiből. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	jsonSourceClaim	stringCollection	A JSON hasznos adataival rendelkező sztringgyűjtési jogcím. Ezt a jogcímet használja a jogcímátalakítás a jogcímek lekéréséhez.
InputParameter	errorOnMissingClaims	Logikai	Megadja, hogy hibát jelez-e, ha valamelyik jogcím hiányzik.
InputParameter	includeEmptyClaims	húr	Adja meg, hogy szerepeljenek-e üres jogcímek.
InputParameter	jsonSourceKeyName	húr	Elemkulcs neve
InputParameter	jsonSourceValueName	húr	Elemérték neve
OutputClaim	Gyűjtemény	sztring, int, logikai és datetime	A kinyerni kívánt jogcímek listája. A jogcím nevének meg kell egyeznie a jsonSourceClaim bemeneti jogcímben megadott névvel.

Példa GetClaimsFromJsonArrayV2

<ClaimsTransformation Id="GetClaimsFromJson" TransformationMethod="GetClaimsFromJsonArrayV2">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="jsonSourceClaim" TransformationClaimType="jsonSource" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="errorOnMissingClaims" DataType="boolean" Value="false" />
    <InputParameter Id="includeEmptyClaims" DataType="boolean" Value="false" />
    <InputParameter Id="jsonSourceKeyName" DataType="string" Value="key" />
    <InputParameter Id="jsonSourceValueName" DataType="string" Value="value" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" />
    <OutputClaim ClaimTypeReferenceId="displayName" />
    <OutputClaim ClaimTypeReferenceId="membershipID" />
    <OutputClaim ClaimTypeReferenceId="active" />
    <OutputClaim ClaimTypeReferenceId="birthDate" />
  </OutputClaims>
</ClaimsTransformation>

Bemeneti jogcímek:

jsonSourceClaim[0] (sztringgyűjtemény első eleme):

  {
    "key": "email",
    "value": "someone@example.com"
  }

jsonSourceClaim[1] (sztringgyűjtemény második eleme):

  {
    "key": "displayName",
    "value": "Someone"
  }

jsonSourceClaim[2] (karakterláncgyűjtemény harmadik eleme):
```
  {
    "key": "membershipID",
    "value": 6353399
  }
```
jsonSourceClaim[3] (negyedik sztringgyűjteményi elem):
```
  {
    "key": "active",
    "value": true
  }
```

jsonSourceClaim[4] (sztringgyűjtemény ötödik eleme):

  {
    "key": "birthDate",
    "value": "2005-09-23T00:00:00Z"
  }

Bemeneti paraméterek:
- errorOnMissingClaims: false
- includeEmptyClaims: false
- jsonSourceKeyName: kulcs
- jsonSourceValueName: érték
Kimeneti jogcímek:
- e-mail: "someone@example.com"
- displayName: "Valaki"
- membershipID: 6353399
- aktív: igaz
- birthDate: 2005-09-23T00:00:00Z

GetNumericClaimFromJson

Lekéri a megadott numerikus (hosszú) elemet egy JSON-adatokból. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	inputJson	húr	A JSON hasznos adattal rendelkező jogcím. Ezt a jogcímet használja a jogcímátalakítás a numerikus jogcím lekéréséhez.
InputParameter	claimToExtract	húr	A kinyerni kívánt JSON-elem neve.
OutputClaim	extractedClaim	hosszú	A jogcímátalakítás meghívása után létrehozott jogcím, a jogcímToExtract bemeneti paramétereiben megadott elem értéke.

Példa a GetNumericClaimFromJsonra

A következő példában a jogcímátalakítás kinyeri az id elemet a JSON-adatokból.

<ClaimsTransformation Id="GetIdFromResponse" TransformationMethod="GetNumericClaimFromJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="exampleInputClaim" TransformationClaimType="inputJson" />
  </InputClaims>
  <InputParameters>
    <InputParameter Id="claimToExtract" DataType="string" Value="id" />
  </InputParameters>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="membershipId" TransformationClaimType="extractedClaim" />
  </OutputClaims>
</ClaimsTransformation>

Bemeneti jogcímek:

inputJson:

{
  "emailAddress": "someone@example.com",
  "displayName": "Someone",
  "id": 6353399
}

Bemeneti paraméterek
- claimToExtract: id
Kimeneti jogcímek:
- extractedClaim: 6353399

GetSingleItemFromJson

Lekéri az első elemet egy JSON-adatból. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	inputJson	húr	A JSON hasznos adattal rendelkező jogcím. Ezt a jogcímet használja a jogcímátalakítás az elem JSON-adatokból való lekéréséhez.
OutputClaim	kulcs	húr	A JSON első elemkulcsa.
OutputClaim	Érték	húr	A JSON első elemértéke.

Példa a GetSingleItemFromJsonra

A következő példában a jogcímátalakítás kinyeri az első elemet (utónevet) a JSON-adatokból.

<ClaimsTransformation Id="GetGivenNameFromResponse" TransformationMethod="GetSingleItemFromJson">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="json" TransformationClaimType="inputJson" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="givenNameKey" TransformationClaimType="key" />
    <OutputClaim ClaimTypeReferenceId="givenName" TransformationClaimType="value" />
  </OutputClaims>
</ClaimsTransformation>

Bemeneti jogcímek:

inputJson:

{
  "givenName": "Emily",
  "lastName": "Smith"
}

Kimeneti jogcímek:
- kulcs: givenName
- érték: Emily

GetSingleValueFromJsonArray

Lekéri az első elemet egy JSON-adattömbből. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	inputJsonClaim	húr	A JSON hasznos adattal rendelkező jogcím. Ezt a jogcímet a jogcímátalakítás használja az érték JSON-tömbből való lekéréséhez.
OutputClaim	extractedClaim	húr	A jogcímátalakítás meghívása után létrehozott jogcím, a JSON-tömb első eleme.

Példa GetSingleValueFromJsonArray

A következő példában a jogcímátalakítás kinyeri az első elemet (e-mail-címet) a JSON-tömbből ["someone@example.com", "Someone", 6353399].

<ClaimsTransformation Id="GetEmailFromJson" TransformationMethod="GetSingleValueFromJsonArray">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="userData" TransformationClaimType="inputJsonClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="email" TransformationClaimType="extractedClaim" />
  </OutputClaims>
</ClaimsTransformation>

Bemeneti jogcímek:
- inputJsonClaim: [""someone@example.com, "Valaki", 6353399]
Kimeneti jogcímek:
- extractedClaim: someone@example.com

XmlStringToJsonString

XML-adatok átalakítása JSON-formátumba. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	xml	húr	Az XML hasznos adattal rendelkező jogcím. Ezt a jogcímet a jogcímátalakítás használja az adatok XML-ből JSON formátumba való konvertálásához.
OutputClaim	json	húr	A jogcímátalakítás meghívása után létrehozott jogcím, az adatok JSON formátumban.

<ClaimsTransformation Id="ConvertXmlToJson" TransformationMethod="XmlStringToJsonString">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="inputXML" TransformationClaimType="xml" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="outputJson" TransformationClaimType="json" />
  </OutputClaims>
</ClaimsTransformation>

Példa XmlStringToJsonStringre

A következő példában a jogcímátalakítás az alábbi XML-adatokat JSON-formátummá alakítja.

Bemeneti jogcím:

<user>
  <name>Someone</name>
  <email>someone@example.com</email>
</user>

Kimeneti jogcím:

{
  "user": {
    "name":"Someone",
    "email":"someone@example.com"
  }
}

Következő lépések

További jogcímátalakítási minták keresése az Azure AD B2C-közösség GitHub-adattárában

Megosztás a következőn keresztül:

JSON-jogcímek átalakítása

CreateJsonArray

Példa a CreateJsonArray-ra

GenerateJson

JSON-tömbök

Példa a GenerateJsonra

Egy másik példa a GenerateJsonra

GetClaimFromJson

Példa a GetClaimFromJsonra

Egy másik példa a GetClaimFromJsonra

GetClaimsFromJsonArray

Példa GetClaimsFromJsonArray

GetClaimsFromJsonArrayV2

Példa GetClaimsFromJsonArrayV2

GetNumericClaimFromJson

Példa a GetNumericClaimFromJsonra

GetSingleItemFromJson

Példa a GetSingleItemFromJsonra

GetSingleValueFromJsonArray

Példa GetSingleValueFromJsonArray

XmlStringToJsonString

Példa XmlStringToJsonStringre

Következő lépések

Visszajelzés

További források