JSON-jogcímátalakítások

Cikk
01/11/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 egyelemes JSON-tö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	sztring	A kimeneti jogcímhez hozzáadandó jogcím.
OutputClaim	outputClaim	sztring	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 egy egyetlen JSON-tömböt hoz létre.

<ClaimsTransformation Id="createlJsonPayload" 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ést követő elérésiút-sztring jelzi, hogy hová szeretné beszúrni az adatokat egy JSON-sztringbe. A pontokkal való felosztás után a rendszer az egész számokat egy JSON-tömb indexeként értelmezi, a nem egész számokat pedig egy JSON-objektum indexeként.

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

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	Bármely sztring, amely a pont jelölését követi	sztring	Annak a JSON-nak a JsonPathja, amelybe a jogcímérték be lesz szúrva.
InputParameter	Bármely sztring, amely a pont jelölését követi	sztring	Annak a JSON-nak a JsonPathja, amelybe az állandó sztringérték be lesz szúrva.
OutputClaim	outputClaim	sztring	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 formátumát és a tömb indexé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 tartalmaz, színt, nyelvet, emblémát és hátteret.

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

<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 a bemeneti jogcímekben és a bemeneti paraméterekben is, a tömböt nullától N-ig kell elindítania az InputClaims elemben. Ezután az InputParameters elemben folytassa az indexet az utolsó indexből.

Az alábbi példa egy 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 első 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 (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 pont jelölésében szereplő azonosítók és az InputClaims TransformationClaimTypes tulajdonsága határozza meg. A pontjelezésben szereplő számok tömbökre utalnak. Az értékek az InputClaims értékeiből és az InputParameters "Value" 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 pont jelölésében szereplő azonosítók és az InputClaims TransformationClaimTypes tulajdonsága határozza meg. Az értékek az InputClaims értékeiből és az InputParameters "Value" 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 "01234567-89ab-cdef-0123-456789abcdef"
- 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":"01234567-89ab-cdef-0123-456789abcdef",
      "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, a sztring feloldva lesz. 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 az alábbi JSON-jogcímben látható módon fog kinézni:

Kimeneti jogcím:

requestBody:

{
   "customerEntity":{
      "email":"[\"someone@contoso.com\"]",
      "userObjectId":"01234567-89ab-cdef-0123-456789abcdef",
      "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	sztring	A jogcímátalakítás által az elem lekéréséhez használt jogcímek.
InputParameter	claimToExtract	sztring	a kinyerni kívánt JSON-elem neve.
OutputClaim	extractedClaim	sztring	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 GetClaimFromJson kifejezésre

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-mailAddress. A displayName lekérdezéséhez hozzon létre egy másik jogcímátalakítást. Például:

<ClaimsTransformation Id="GetDispalyNameClaimFromJson" 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 megadott elemek listájának lekérése JSON-adatokból. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	jsonSourceClaim	sztring	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	boolean	Megadja, hogy a rendszer hibát jelez-e, ha az egyik jogcím hiányzik.
InputParameter	includeEmptyClaims	sztring	Adja meg, hogy szerepeljenek-e üres jogcímek.
InputParameter	jsonSourceKeyName	sztring	Elemkulcs neve
InputParameter	jsonSourceValueName	sztring	Elemérték neve
OutputClaim	Gyűjtemény	string, int, boolean é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 a GetClaimsFromJsonArray kifejezésre

A következő példában a jogcímátalakítás a következő jogcímeket nyeri ki: e-mail (karakterlánc), displayName (karakterlánc), membershipNum (int), aktív (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űjteményi jogcím. Ezt a jogcímet használja a jogcímátalakítás a jogcímek lekéréséhez.
InputParameter	errorOnMissingClaims	boolean	Megadja, hogy a rendszer hibát jelez-e, ha az egyik jogcím hiányzik.
InputParameter	includeEmptyClaims	sztring	Adja meg, hogy üres jogcímeket is tartalmazzon-e.
InputParameter	jsonSourceKeyName	sztring	Elemkulcs neve
InputParameter	jsonSourceValueName	sztring	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

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), aktív (logikai) és birthDate (datetime) a JSON-adatokból.

<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] (a sztringgyűjtemény negyedik eleme):
```
  {
    "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

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

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	inputJson	sztring	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	sztring	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 claimToExtract bemeneti paraméterekben 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	sztring	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	sztring	A JSON első elemkulcsa.
OutputClaim	érték	sztring	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:
- key: givenName
- érték: Emilty

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	sztring	A JSON hasznos adattal rendelkező jogcím. A jogcímátalakítás ezt a jogcímet használja az érték JSON-tömbből való lekéréséhez.
OutputClaim	extractedClaim	sztring	A jogcímátalakítás meghívása után létrehozott jogcím, amely a JSON-tömb első eleme.

Példa a GetSingleValueFromJsonArray-ra

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 konvertálása JSON-formátumra. Tekintse meg a jogcímátalakítás élő bemutatóját .

Elem	TransformationClaimType	Adattípus	Jegyzetek
InputClaim	xml	sztring	Az XML hasznos adattal rendelkező jogcím. Ezt a jogcímet használja a jogcímátalakítás az adatok XML-ből JSON formátumba való konvertálásához.
OutputClaim	json	sztring	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="intpuXML" 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 a következő 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 a Azure AD B2C-közösség GitHub-adattárában

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

JSON-jogcímátalakítások

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 GetClaimFromJson kifejezésre

Egy másik példa a GetClaimFromJsonra

GetClaimsFromJsonArray

Példa a GetClaimsFromJsonArray kifejezésre

GetClaimsFromJsonArrayV2

Példa GetClaimsFromJsonArrayV2

GetNumericClaimFromJson

Példa a GetNumericClaimFromJsonra

GetSingleItemFromJson

Példa a GetSingleItemFromJsonra

GetSingleValueFromJsonArray

Példa a GetSingleValueFromJsonArray-ra

XmlStringToJsonString

Példa XmlStringToJsonStringre

Következő lépések

Visszajelzés

Visszajelzés

További források